একটি ডিভাইসের অবস্থার উপর নির্ভর করে, আগত বার্তাগুলি ভিন্নভাবে পরিচালনা করা হয়। এই পরিস্থিতিগুলি বুঝতে এবং কীভাবে আপনার নিজের অ্যাপ্লিকেশনে এফসিএমকে একীভূত করতে হয়, ডিভাইসটি যে বিভিন্ন রাজ্যে থাকতে পারে তা স্থাপন করা প্রথমে গুরুত্বপূর্ণ:
রাজ্য | বর্ণনা |
---|---|
ফোরগ্রাউন্ড | যখন অ্যাপ্লিকেশন খোলা থাকে, দৃশ্যে এবং ব্যবহারে। |
পটভূমি | যখন অ্যাপ্লিকেশনটি খোলা থাকে তবে পটভূমিতে (মিনিমাইজড)। এটি সাধারণত ঘটে যখন ব্যবহারকারী ডিভাইসে "হোম" বোতাম টিপে, অ্যাপ সুইচার ব্যবহার করে অন্য অ্যাপে স্যুইচ করে, বা একটি ভিন্ন ট্যাবে (ওয়েব) অ্যাপ্লিকেশন খোলা থাকে। |
সমাপ্ত | যখন ডিভাইসটি লক থাকে বা অ্যাপ্লিকেশনটি চলছে না। |
FCM এর মাধ্যমে অ্যাপ্লিকেশনটি বার্তা পেলোড গ্রহণ করার আগে কয়েকটি পূর্বশর্ত পূরণ করতে হবে:
- অ্যাপ্লিকেশনটি অন্তত একবার খোলা থাকতে হবে (FCM-এর সাথে নিবন্ধনের অনুমতি দেওয়ার জন্য)।
- iOS-এ, ব্যবহারকারী অ্যাপ সুইচার থেকে অ্যাপ্লিকেশনটি সোয়াইপ করলে, আবার কাজ শুরু করার জন্য ব্যাকগ্রাউন্ড বার্তাগুলির জন্য এটিকে ম্যানুয়ালি পুনরায় খুলতে হবে।
- অ্যান্ড্রয়েডে, ব্যবহারকারী যদি ডিভাইস সেটিংস থেকে অ্যাপটিকে জোর করে ছেড়ে দেয়, তাহলে বার্তাগুলি কাজ শুরু করার জন্য এটি ম্যানুয়ালি পুনরায় খুলতে হবে।
- ওয়েবে, আপনি অবশ্যই আপনার ওয়েব পুশ সার্টিফিকেট সহ একটি টোকেন (
getToken()
ব্যবহার করে) অনুরোধ করেছেন৷
বার্তা গ্রহণ করার অনুমতির জন্য অনুরোধ করুন
iOS, macOS, ওয়েব এবং Android 13 (বা নতুন) এ, আপনার ডিভাইসে FCM পেলোড গ্রহণ করার আগে, আপনাকে প্রথমে ব্যবহারকারীর অনুমতি চাইতে হবে।
firebase_messaging
প্যাকেজ requestPermission
পদ্ধতির মাধ্যমে অনুমতির অনুরোধ করার জন্য একটি সহজ API প্রদান করে। এই API অনেকগুলি নামযুক্ত আর্গুমেন্ট গ্রহণ করে যা আপনি যে ধরনের অনুমতির অনুরোধ করতে চান তা সংজ্ঞায়িত করে, যেমন নোটিফিকেশন পেলোড ধারণকারী মেসেজিং একটি শব্দ ট্রিগার করতে পারে বা Siri এর মাধ্যমে বার্তা পড়তে পারে কিনা। ডিফল্টরূপে, পদ্ধতিটি বুদ্ধিমান ডিফল্ট অনুমতির অনুরোধ করে। প্রতিটি অনুমতি কিসের জন্য রেফারেন্স API সম্পূর্ণ ডকুমেন্টেশন প্রদান করে।
শুরু করতে, আপনার অ্যাপ্লিকেশন থেকে পদ্ধতিটি কল করুন (iOS-এ একটি নেটিভ মডেল প্রদর্শিত হবে, ওয়েবে ব্রাউজারের নেটিভ API ফ্লো ট্রিগার হবে):
FirebaseMessaging messaging = FirebaseMessaging.instance;
NotificationSettings settings = await messaging.requestPermission(
alert: true,
announcement: false,
badge: true,
carPlay: false,
criticalAlert: false,
provisional: false,
sound: true,
);
print('User granted permission: ${settings.authorizationStatus}');
অনুরোধ থেকে ফিরে আসা NotificationSettings
অবজেক্টের authorizationStatus
বৈশিষ্ট্য ব্যবহারকারীর সামগ্রিক সিদ্ধান্ত নির্ধারণ করতে ব্যবহার করা যেতে পারে:
-
authorized
: ব্যবহারকারী অনুমতি দিয়েছেন। -
denied
: ব্যবহারকারী অনুমতি অস্বীকার করেছেন। -
notDetermined
: ব্যবহারকারী এখনও অনুমতি দিতে হবে কিনা তা বেছে নেননি। -
provisional
: ব্যবহারকারী অস্থায়ী অনুমতি দিয়েছেন
NotificationSettings
সেটিংসের অন্যান্য বৈশিষ্ট্যগুলি বর্তমান ডিভাইসে একটি নির্দিষ্ট অনুমতি সক্ষম, অক্ষম বা সমর্থিত কিনা তা ফেরত দেয়।
একবার অনুমতি দেওয়া হয়ে গেলে এবং বিভিন্ন ধরনের ডিভাইসের অবস্থা বোঝা হয়ে গেলে, আপনার অ্যাপ্লিকেশন এখন আগত FCM পেলোডগুলি পরিচালনা করা শুরু করতে পারে।
বার্তা পরিচালনা
আপনার অ্যাপ্লিকেশানের বর্তমান অবস্থার উপর ভিত্তি করে, বিভিন্ন ধরনের বার্তার ইনকামিং পেলোডগুলিকে পরিচালনা করার জন্য বিভিন্ন বাস্তবায়নের প্রয়োজন হয়:
ফোরগ্রাউন্ড বার্তা
আপনার অ্যাপ্লিকেশনটি অগ্রভাগে থাকাকালীন বার্তাগুলি পরিচালনা করতে, onMessage
স্ট্রীমটি শুনুন৷
FirebaseMessaging.onMessage.listen((RemoteMessage message) {
print('Got a message whilst in the foreground!');
print('Message data: ${message.data}');
if (message.notification != null) {
print('Message also contained a notification: ${message.notification}');
}
});
স্ট্রীমটিতে একটি RemoteMessage
রয়েছে, পেলোড সম্পর্কে বিভিন্ন তথ্যের বিশদ বিবরণ, যেমন এটি কোথা থেকে এসেছে, অনন্য আইডি, পাঠানোর সময়, এটিতে একটি বিজ্ঞপ্তি রয়েছে কিনা এবং আরও অনেক কিছু। যেহেতু আপনার অ্যাপ্লিকেশনটি ফোরগ্রাউন্ডে থাকাকালীন বার্তাটি পুনরুদ্ধার করা হয়েছিল, আপনি সরাসরি আপনার ফ্লাটার অ্যাপ্লিকেশনটির অবস্থা এবং প্রসঙ্গ অ্যাক্সেস করতে পারেন।
ফোরগ্রাউন্ড এবং বিজ্ঞপ্তি বার্তা
অ্যাপ্লিকেশানটি অগ্রভাগে থাকাকালীন যে বিজ্ঞপ্তি বার্তাগুলি আসে সেগুলি Android এবং iOS উভয় ক্ষেত্রেই ডিফল্টরূপে একটি দৃশ্যমান বিজ্ঞপ্তি প্রদর্শন করবে না৷ যাইহোক, এই আচরণটি ওভাররাইড করা সম্ভব:
- অ্যান্ড্রয়েডে, আপনাকে অবশ্যই একটি "উচ্চ অগ্রাধিকার" বিজ্ঞপ্তি চ্যানেল তৈরি করতে হবে৷
- iOS-এ, আপনি অ্যাপ্লিকেশনের জন্য উপস্থাপনা বিকল্পগুলি আপডেট করতে পারেন।
পটভূমি বার্তা
নেটিভ (অ্যান্ড্রয়েড এবং অ্যাপল) এবং ওয়েব ভিত্তিক প্ল্যাটফর্মে ব্যাকগ্রাউন্ড মেসেজ পরিচালনার প্রক্রিয়া ভিন্ন।
অ্যাপল প্ল্যাটফর্ম এবং অ্যান্ড্রয়েড
একটি onBackgroundMessage
হ্যান্ডলার নিবন্ধন করে পটভূমি বার্তাগুলি পরিচালনা করুন৷ যখন বার্তাগুলি প্রাপ্ত হয়, তখন একটি বিচ্ছিন্নতা তৈরি হয় (শুধুমাত্র Android, iOS/macOS-এর জন্য আলাদা আলাদা করার প্রয়োজন হয় না) আপনার অ্যাপ্লিকেশনটি চলমান না থাকলেও আপনাকে বার্তাগুলি পরিচালনা করতে দেয়৷
আপনার ব্যাকগ্রাউন্ড মেসেজ হ্যান্ডলার সম্পর্কে কিছু জিনিস মাথায় রাখতে হবে:
- এটি একটি বেনামী ফাংশন হতে হবে না.
- এটি অবশ্যই একটি শীর্ষ-স্তরের ফাংশন হতে হবে (যেমন একটি ক্লাস পদ্ধতি নয় যার জন্য আরম্ভ করার প্রয়োজন হয়)।
- Flutter সংস্করণ 3.3.0 বা উচ্চতর ব্যবহার করার সময়, বার্তা হ্যান্ডলারকে অবশ্যই ফাংশন ঘোষণার ঠিক উপরে
@pragma('vm:entry-point')
দিয়ে টীকা দিতে হবে (অন্যথায় এটি রিলিজ মোডের জন্য ট্রি কাঁপানোর সময় সরানো হতে পারে)।
@pragma('vm:entry-point')
Future<void> _firebaseMessagingBackgroundHandler(RemoteMessage message) async {
// If you're going to use other Firebase services in the background, such as Firestore,
// make sure you call `initializeApp` before using other Firebase services.
await Firebase.initializeApp();
print("Handling a background message: ${message.messageId}");
}
void main() {
FirebaseMessaging.onBackgroundMessage(_firebaseMessagingBackgroundHandler);
runApp(MyApp());
}
যেহেতু হ্যান্ডলারটি আপনার অ্যাপ্লিকেশনের প্রেক্ষাপটের বাইরে তার নিজস্ব বিচ্ছিন্নভাবে চলে, তাই অ্যাপ্লিকেশনের অবস্থা আপডেট করা বা কোনো UI প্রভাবিত যুক্তি কার্যকর করা সম্ভব নয়। যাইহোক, আপনি HTTP অনুরোধের মতো যুক্তি সম্পাদন করতে পারেন, IO ক্রিয়াকলাপ সম্পাদন করতে পারেন (যেমন স্থানীয় স্টোরেজ আপডেট করা), অন্যান্য প্লাগইনগুলির সাথে যোগাযোগ করা ইত্যাদি।
যত তাড়াতাড়ি সম্ভব আপনার যুক্তি সম্পূর্ণ করার সুপারিশ করা হয়। দীর্ঘ, নিবিড় কাজগুলি চালানো ডিভাইসের কার্যকারিতাকে প্রভাবিত করে এবং OS প্রক্রিয়াটি বন্ধ করতে পারে। যদি কাজগুলি 30 সেকেন্ডের বেশি সময় ধরে চলতে থাকে, তাহলে ডিভাইসটি স্বয়ংক্রিয়ভাবে প্রক্রিয়াটিকে মেরে ফেলতে পারে।
ওয়েব
ওয়েবে, একটি জাভাস্ক্রিপ্ট পরিষেবা কর্মী লিখুন যা ব্যাকগ্রাউন্ডে চলে। ব্যাকগ্রাউন্ড বার্তা পরিচালনা করতে পরিষেবা কর্মী ব্যবহার করুন।
শুরু করতে, আপনার web
ডিরেক্টরিতে একটি নতুন ফাইল তৈরি করুন এবং এটিকে firebase-messaging-sw.js
বলুন :
// Please see this file for the latest firebase-js-sdk version:
// https://github.com/firebase/flutterfire/blob/master/packages/firebase_core/firebase_core_web/lib/src/firebase_sdk_version.dart
importScripts("https://www.gstatic.com/firebasejs/10.7.0/firebase-app-compat.js");
importScripts("https://www.gstatic.com/firebasejs/10.7.0/firebase-messaging-compat.js");
firebase.initializeApp({
apiKey: "...",
authDomain: "...",
databaseURL: "...",
projectId: "...",
storageBucket: "...",
messagingSenderId: "...",
appId: "...",
});
const messaging = firebase.messaging();
// Optional:
messaging.onBackgroundMessage((message) => {
console.log("onBackgroundMessage", message);
});
ফাইলটিকে অবশ্যই অ্যাপ এবং মেসেজিং SDK উভয়ই আমদানি করতে হবে, Firebase শুরু করতে হবে এবং messaging
ভেরিয়েবলটি প্রকাশ করতে হবে।
পরবর্তী, কর্মী নিবন্ধিত করা আবশ্যক. index.html
ফাইলের মধ্যে, <script>
ট্যাগ পরিবর্তন করে কর্মী নিবন্ধন করুন যা বুটস্ট্র্যাপ ফ্লাটার:
<script src="flutter_bootstrap.js" async>
if ('serviceWorker' in navigator) {
window.addEventListener('load', function () {
navigator.serviceWorker.register('firebase-messaging-sw.js', {
scope: '/firebase-cloud-messaging-push-scope',
});
});
}
</script>
আপনি যদি এখনও পুরানো টেমপ্লেটিং সিস্টেম ব্যবহার করে থাকেন, তাহলে আপনি <script>
ট্যাগ পরিবর্তন করে কর্মীকে নিবন্ধন করতে পারেন যা বুটস্ট্র্যাপ ফ্লটারকে নিম্নরূপ:
<html>
<body>
<script>
var serviceWorkerVersion = null;
var scriptLoaded = false;
function loadMainDartJs() {
if (scriptLoaded) {
return;
}
scriptLoaded = true;
var scriptTag = document.createElement('script');
scriptTag.src = 'main.dart.js';
scriptTag.type = 'application/javascript';
document.body.append(scriptTag);
}
if ('serviceWorker' in navigator) {
// Service workers are supported. Use them.
window.addEventListener('load', function () {
// Register Firebase Messaging service worker.
navigator.serviceWorker.register('firebase-messaging-sw.js', {
scope: '/firebase-cloud-messaging-push-scope',
});
// Wait for registration to finish before dropping the <script> tag.
// Otherwise, the browser will load the script multiple times,
// potentially different versions.
var serviceWorkerUrl =
'flutter_service_worker.js?v=' + serviceWorkerVersion;
navigator.serviceWorker.register(serviceWorkerUrl).then((reg) => {
function waitForActivation(serviceWorker) {
serviceWorker.addEventListener('statechange', () => {
if (serviceWorker.state == 'activated') {
console.log('Installed new service worker.');
loadMainDartJs();
}
});
}
if (!reg.active && (reg.installing || reg.waiting)) {
// No active web worker and we have installed or are installing
// one for the first time. Simply wait for it to activate.
waitForActivation(reg.installing ?? reg.waiting);
} else if (!reg.active.scriptURL.endsWith(serviceWorkerVersion)) {
// When the app updates the serviceWorkerVersion changes, so we
// need to ask the service worker to update.
console.log('New service worker available.');
reg.update();
waitForActivation(reg.installing);
} else {
// Existing service worker is still good.
console.log('Loading app from service worker.');
loadMainDartJs();
}
});
// If service worker doesn't succeed in a reasonable amount of time,
// fallback to plaint <script> tag.
setTimeout(() => {
if (!scriptLoaded) {
console.warn(
'Failed to load app from service worker. Falling back to plain <script> tag.'
);
loadMainDartJs();
}
}, 4000);
});
} else {
// Service workers not supported. Just drop the <script> tag.
loadMainDartJs();
}
</script>
</body>
এরপর আপনার ফ্লটার অ্যাপ্লিকেশন পুনরায় চালু করুন। কর্মী নিবন্ধিত হবে এবং যেকোন ব্যাকগ্রাউন্ড বার্তা এই ফাইলের মাধ্যমে পরিচালনা করা হবে।
হ্যান্ডলিং ইন্টারঅ্যাকশন
যেহেতু বিজ্ঞপ্তিগুলি একটি দৃশ্যমান সংকেত, তাই ব্যবহারকারীদের জন্য তাদের সাথে যোগাযোগ করা (টিপে) সাধারণ। অ্যান্ড্রয়েড এবং আইওএস উভয় ক্ষেত্রেই ডিফল্ট আচরণ হল অ্যাপ্লিকেশনটি খুলতে। আবেদন বাতিল হলে তা শুরু করা হবে; যদি এটি ব্যাকগ্রাউন্ডে থাকে তবে এটি অগ্রভাগে আনা হবে।
একটি বিজ্ঞপ্তির বিষয়বস্তুর উপর নির্ভর করে, অ্যাপ্লিকেশনটি খোলার সময় আপনি ব্যবহারকারীর মিথস্ক্রিয়া পরিচালনা করতে চাইতে পারেন। উদাহরণস্বরূপ, যদি একটি নতুন চ্যাট বার্তা একটি বিজ্ঞপ্তির মাধ্যমে পাঠানো হয় এবং ব্যবহারকারী এটি চাপেন, আপনি অ্যাপ্লিকেশনটি খোলার সময় নির্দিষ্ট কথোপকথনটি খুলতে চাইতে পারেন।
firebase-messaging
প্যাকেজ এই মিথস্ক্রিয়া পরিচালনা করার দুটি উপায় প্রদান করে:
-
getInitialMessage()
: যদি একটি সমাপ্ত অবস্থা থেকে অ্যাপ্লিকেশনটি খোলা হয় তাহলে একটিRemoteMessage
সম্বলিত একটিFuture
ফেরত দেওয়া হবে। একবার সেবন করলে,RemoteMessage
সরানো হবে। -
onMessageOpenedApp
: একটিStream
যা একটিRemoteMessage
পোস্ট করে যখন অ্যাপ্লিকেশনটি একটি ব্যাকগ্রাউন্ড অবস্থা থেকে খোলা হয়।
আপনার ব্যবহারকারীদের জন্য একটি মসৃণ UX নিশ্চিত করতে উভয় পরিস্থিতিতেই পরিচালনা করা বাঞ্ছনীয়। নীচের কোডের উদাহরণটি কীভাবে এটি অর্জন করা যেতে পারে তা রূপরেখা দেয়:
class Application extends StatefulWidget {
@override
State<StatefulWidget> createState() => _Application();
}
class _Application extends State<Application> {
// It is assumed that all messages contain a data field with the key 'type'
Future<void> setupInteractedMessage() async {
// Get any messages which caused the application to open from
// a terminated state.
RemoteMessage? initialMessage =
await FirebaseMessaging.instance.getInitialMessage();
// If the message also contains a data property with a "type" of "chat",
// navigate to a chat screen
if (initialMessage != null) {
_handleMessage(initialMessage);
}
// Also handle any interaction when the app is in the background via a
// Stream listener
FirebaseMessaging.onMessageOpenedApp.listen(_handleMessage);
}
void _handleMessage(RemoteMessage message) {
if (message.data['type'] == 'chat') {
Navigator.pushNamed(context, '/chat',
arguments: ChatArguments(message),
);
}
}
@override
void initState() {
super.initState();
// Run code required to handle interacted messages in an async function
// as initState() must not be async
setupInteractedMessage();
}
@override
Widget build(BuildContext context) {
return Text("...");
}
}
আপনি কীভাবে মিথস্ক্রিয়া পরিচালনা করবেন তা আপনার অ্যাপ্লিকেশন সেটআপের উপর নির্ভর করে। উপরের উদাহরণটি একটি StatefulWidget ব্যবহার করে একটি মৌলিক চিত্র দেখায়।
বার্তা স্থানীয়করণ
আপনি দুটি ভিন্ন উপায়ে স্থানীয় স্ট্রিং পাঠাতে পারেন:
- আপনার সার্ভারে আপনার প্রতিটি ব্যবহারকারীর পছন্দের ভাষা সংরক্ষণ করুন এবং প্রতিটি ভাষার জন্য কাস্টমাইজড বিজ্ঞপ্তি পাঠান
- আপনার অ্যাপে স্থানীয়কৃত স্ট্রিং এম্বেড করুন এবং অপারেটিং সিস্টেমের স্থানীয় লোকেল সেটিংস ব্যবহার করুন
দ্বিতীয় পদ্ধতিটি কীভাবে ব্যবহার করবেন তা এখানে:
অ্যান্ড্রয়েড
resources/values/strings.xml
এ আপনার ডিফল্ট-ভাষা বার্তা নির্দিষ্ট করুন:<string name="notification_title">Hello world</string> <string name="notification_message">This is a message</string>
values- language
ডিরেক্টরিতে অনুবাদিত বার্তাগুলি নির্দিষ্ট করুন। উদাহরণস্বরূপ,resources/values-fr/strings.xml
এ ফরাসি বার্তা নির্দিষ্ট করুন:<string name="notification_title">Bonjour le monde</string> <string name="notification_message">C'est un message</string>
সার্ভার পেলোডে,
title
,message
, এবংbody
কীগুলি ব্যবহার করার পরিবর্তে, আপনার স্থানীয় বার্তার জন্যtitle_loc_key
এবংbody_loc_key
ব্যবহার করুন এবং আপনি যে বার্তাটি প্রদর্শন করতে চান তারname
বৈশিষ্ট্যে সেগুলি সেট করুন৷বার্তা পেলোড এই মত দেখাবে:
{ "data": { "title_loc_key": "notification_title", "body_loc_key": "notification_message" } }
iOS
Base.lproj/Localizable.strings
এ আপনার ডিফল্ট-ভাষা বার্তা নির্দিষ্ট করুন:"NOTIFICATION_TITLE" = "Hello World"; "NOTIFICATION_MESSAGE" = "This is a message";
language .lproj
ডিরেক্টরিতে অনুবাদিত বার্তাগুলি নির্দিষ্ট করুন। উদাহরণস্বরূপ,fr.lproj/Localizable.strings
এ ফরাসি বার্তা উল্লেখ করুন:"NOTIFICATION_TITLE" = "Bonjour le monde"; "NOTIFICATION_MESSAGE" = "C'est un message";
বার্তা পেলোড এই মত দেখাবে:
{ "data": { "title_loc_key": "NOTIFICATION_TITLE", "body_loc_key": "NOTIFICATION_MESSAGE" } }
বার্তা বিতরণ ডেটা রপ্তানি সক্ষম করুন৷
আপনি আরও বিশ্লেষণের জন্য আপনার মেসেজ ডেটা BigQuery-এ এক্সপোর্ট করতে পারেন। BigQuery আপনাকে BigQuery SQL ব্যবহার করে ডেটা বিশ্লেষণ করতে, অন্য ক্লাউড প্রদানকারীর কাছে রপ্তানি করতে বা আপনার কাস্টম ML মডেলের জন্য ডেটা ব্যবহার করতে দেয়। BigQuery-এ রপ্তানি করা বার্তাগুলির জন্য সমস্ত উপলব্ধ ডেটা অন্তর্ভুক্ত করে, বার্তার ধরন নির্বিশেষে বা বার্তাটি API বা বিজ্ঞপ্তি কম্পোজারের মাধ্যমে পাঠানো হয়েছে কিনা।
রপ্তানি সক্ষম করতে, প্রথমে এখানে বর্ণিত পদক্ষেপগুলি অনুসরণ করুন, তারপর এই নির্দেশাবলী অনুসরণ করুন:
অ্যান্ড্রয়েড
আপনি নিম্নলিখিত কোড ব্যবহার করতে পারেন:
await FirebaseMessaging.instance.setDeliveryMetricsExportToBigQuery(true);
iOS
iOS এর জন্য, আপনাকে নিম্নলিখিত বিষয়বস্তু সহ AppDelegate.m
পরিবর্তন করতে হবে।
#import "AppDelegate.h"
#import "GeneratedPluginRegistrant.h"
#import <Firebase/Firebase.h>
@implementation AppDelegate
- (BOOL)application:(UIApplication *)application
didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
[GeneratedPluginRegistrant registerWithRegistry:self];
// Override point for customization after application launch.
return [super application:application didFinishLaunchingWithOptions:launchOptions];
}
- (void)application:(UIApplication *)application
didReceiveRemoteNotification:(NSDictionary *)userInfo
fetchCompletionHandler:(void (^)(UIBackgroundFetchResult))completionHandler {
[[FIRMessaging extensionHelper] exportDeliveryMetricsToBigQueryWithMessageInfo:userInfo];
}
@end
ওয়েব
ওয়েবের জন্য, SDK-এর v9 সংস্করণ ব্যবহার করার জন্য আপনাকে আপনার পরিষেবা কর্মী পরিবর্তন করতে হবে। v9 সংস্করণটি বান্ডিল করা দরকার, তাই পরিষেবা কর্মীকে কাজ করার জন্য আপনাকে esbuild
মতো একটি বান্ডলার ব্যবহার করতে হবে। এটি কীভাবে অর্জন করা যায় তা দেখতে উদাহরণ অ্যাপটি দেখুন।
একবার আপনি v9 SDK-এ স্থানান্তরিত হয়ে গেলে, আপনি নিম্নলিখিত কোডটি ব্যবহার করতে পারেন:
import {
experimentalSetDeliveryMetricsExportedToBigQueryEnabled,
getMessaging,
} from 'firebase/messaging/sw';
...
const messaging = getMessaging(app);
experimentalSetDeliveryMetricsExportedToBigQueryEnabled(messaging, true);
web
ফোল্ডারে আপনার পরিষেবা কর্মীর নতুন সংস্করণ রপ্তানি করার জন্য yarn build
চালাতে ভুলবেন না।
iOS-এ বিজ্ঞপ্তিতে ছবি প্রদর্শন করুন
Apple ডিভাইসগুলিতে, FCM পেলোড থেকে ছবিগুলি প্রদর্শন করার জন্য ইনকামিং FCM বিজ্ঞপ্তিগুলির জন্য, আপনাকে অবশ্যই একটি অতিরিক্ত বিজ্ঞপ্তি পরিষেবা এক্সটেনশন যোগ করতে হবে এবং এটি ব্যবহার করার জন্য আপনার অ্যাপটি কনফিগার করতে হবে৷
আপনি যদি Firebase ফোন প্রমাণীকরণ ব্যবহার করেন, তাহলে আপনাকে অবশ্যই আপনার Podfile-এ Firebase Auth পড যোগ করতে হবে।
ধাপ 1 - একটি বিজ্ঞপ্তি পরিষেবা এক্সটেনশন যোগ করুন
- এক্সকোডে, ফাইল > নতুন > টার্গেটে ক্লিক করুন...
- একটি মডেল সম্ভাব্য লক্ষ্যগুলির একটি তালিকা উপস্থাপন করবে; নোটিফিকেশন সার্ভিস এক্সটেনশন নির্বাচন করতে নিচে স্ক্রোল করুন বা ফিল্টার ব্যবহার করুন। পরবর্তী ক্লিক করুন.
- একটি পণ্যের নাম যোগ করুন (এই টিউটোরিয়ালটি অনুসরণ করতে "ইমেজনোটিফিকেশন" ব্যবহার করুন), ভাষাকে উদ্দেশ্য-সি-তে সেট করুন এবং শেষ ক্লিক করুন।
- সক্রিয় করুন ক্লিক করে স্কিমটি সক্ষম করুন।
ধাপ 2 - পডফাইলে লক্ষ্য যোগ করুন
আপনার নতুন এক্সটেনশনের Firebase/Messaging
পডের অ্যাক্সেস আছে কিনা তা পডফাইলে যোগ করে নিশ্চিত করুন:
নেভিগেটর থেকে, Podfile খুলুন: Pods > Podfile
ফাইলের নীচে স্ক্রোল করুন এবং যোগ করুন:
target 'ImageNotification' do use_frameworks! pod 'Firebase/Auth' # Add this line if you are using FirebaseAuth phone authentication pod 'Firebase/Messaging' end
ios
বাmacos
ডিরেক্টরি থেকেpod install
ব্যবহার করে আপনার পড ইনস্টল বা আপডেট করুন।
ধাপ 3 - এক্সটেনশন হেল্পার ব্যবহার করুন
এই মুহুর্তে, সবকিছু এখনও স্বাভাবিকভাবে চলতে হবে। চূড়ান্ত ধাপ হল এক্সটেনশন হেল্পারকে ডাকা।
নেভিগেটর থেকে, আপনার ImageNotification এক্সটেনশন নির্বাচন করুন
NotificationService.m
ফাইলটি খুলুন।ফাইলের শীর্ষে, নীচে দেখানো হিসাবে
NotificationService.h
ঠিক পরেFirebaseMessaging.h
আমদানি করুন।NotificationService.m
এর বিষয়বস্তু এর সাথে প্রতিস্থাপন করুন:#import "NotificationService.h" #import "FirebaseMessaging.h" #import "FirebaseAuth.h" // Add this line if you are using FirebaseAuth phone authentication #import <UIKit/UIKit.h> // Add this line if you are using FirebaseAuth phone authentication @interface NotificationService () @property (nonatomic, strong) void (^contentHandler)(UNNotificationContent *contentToDeliver); @property (nonatomic, strong) UNMutableNotificationContent *bestAttemptContent; @end @implementation NotificationService /* Uncomment this if you are using Firebase Auth - (BOOL)application:(UIApplication *)app openURL:(NSURL *)url options:(NSDictionary<UIApplicationOpenURLOptionsKey, id> *)options { if ([[FIRAuth auth] canHandleURL:url]) { return YES; } return NO; } - (void)scene:(UIScene *)scene openURLContexts:(NSSet<UIOpenURLContext *> *)URLContexts { for (UIOpenURLContext *urlContext in URLContexts) { [FIRAuth.auth canHandleURL:urlContext.URL]; } } */ - (void)didReceiveNotificationRequest:(UNNotificationRequest *)request withContentHandler:(void (^)(UNNotificationContent * _Nonnull))contentHandler { self.contentHandler = contentHandler; self.bestAttemptContent = [request.content mutableCopy]; // Modify the notification content here... [[FIRMessaging extensionHelper] populateNotificationContent:self.bestAttemptContent withContentHandler:contentHandler]; } - (void)serviceExtensionTimeWillExpire { // Called just before the extension will be terminated by the system. // Use this as an opportunity to deliver your "best attempt" at modified content, otherwise the original push payload will be used. self.contentHandler(self.bestAttemptContent); } @end
ধাপ 4 - পেলোডে ইমেজ যোগ করুন
আপনার বিজ্ঞপ্তি পেলোডে, আপনি এখন একটি ছবি যোগ করতে পারেন। কিভাবে একটি প্রেরণ অনুরোধ তৈরি করতে iOS ডকুমেন্টেশন দেখুন. মনে রাখবেন যে একটি 300KB সর্বাধিক চিত্রের আকার ডিভাইস দ্বারা প্রয়োগ করা হয়েছে৷
,একটি ডিভাইসের অবস্থার উপর নির্ভর করে, আগত বার্তাগুলি ভিন্নভাবে পরিচালনা করা হয়। এই পরিস্থিতিগুলি বুঝতে এবং কীভাবে আপনার নিজের অ্যাপ্লিকেশনে এফসিএমকে একীভূত করতে হয়, ডিভাইসটি যে বিভিন্ন রাজ্যে থাকতে পারে তা স্থাপন করা প্রথমে গুরুত্বপূর্ণ:
রাজ্য | বর্ণনা |
---|---|
ফোরগ্রাউন্ড | যখন অ্যাপ্লিকেশন খোলা থাকে, দৃশ্যে এবং ব্যবহারে। |
পটভূমি | যখন অ্যাপ্লিকেশনটি খোলা থাকে তবে পটভূমিতে (মিনিমাইজড)। এটি সাধারণত ঘটে যখন ব্যবহারকারী ডিভাইসে "হোম" বোতাম টিপে, অ্যাপ সুইচার ব্যবহার করে অন্য অ্যাপে স্যুইচ করে, বা একটি ভিন্ন ট্যাবে (ওয়েব) অ্যাপ্লিকেশন খোলা থাকে। |
সমাপ্ত | যখন ডিভাইসটি লক থাকে বা অ্যাপ্লিকেশনটি চলছে না। |
FCM এর মাধ্যমে অ্যাপ্লিকেশনটি বার্তা পেলোড গ্রহণ করার আগে কয়েকটি পূর্বশর্ত পূরণ করতে হবে:
- অ্যাপ্লিকেশনটি অন্তত একবার খোলা থাকতে হবে (FCM-এর সাথে নিবন্ধনের অনুমতি দেওয়ার জন্য)।
- iOS-এ, ব্যবহারকারী অ্যাপ সুইচার থেকে অ্যাপ্লিকেশনটি সোয়াইপ করলে, আবার কাজ শুরু করার জন্য ব্যাকগ্রাউন্ড বার্তাগুলির জন্য এটিকে ম্যানুয়ালি পুনরায় খুলতে হবে।
- অ্যান্ড্রয়েডে, ব্যবহারকারী যদি ডিভাইস সেটিংস থেকে অ্যাপটিকে জোর করে ছেড়ে দেয়, তাহলে বার্তাগুলি কাজ শুরু করার জন্য এটি ম্যানুয়ালি পুনরায় খুলতে হবে।
- ওয়েবে, আপনি অবশ্যই আপনার ওয়েব পুশ সার্টিফিকেট সহ একটি টোকেন (
getToken()
ব্যবহার করে) অনুরোধ করেছেন৷
বার্তা গ্রহণ করার অনুমতির জন্য অনুরোধ করুন
iOS, macOS, ওয়েব এবং Android 13 (বা নতুন) এ, আপনার ডিভাইসে FCM পেলোড গ্রহণ করার আগে, আপনাকে প্রথমে ব্যবহারকারীর অনুমতি চাইতে হবে।
firebase_messaging
প্যাকেজ requestPermission
পদ্ধতির মাধ্যমে অনুমতির অনুরোধ করার জন্য একটি সহজ API প্রদান করে। এই API অনেকগুলি নামযুক্ত আর্গুমেন্ট গ্রহণ করে যা আপনি যে ধরনের অনুমতির অনুরোধ করতে চান তা সংজ্ঞায়িত করে, যেমন নোটিফিকেশন পেলোড ধারণকারী মেসেজিং একটি শব্দ ট্রিগার করতে পারে বা Siri এর মাধ্যমে বার্তা পড়তে পারে কিনা। ডিফল্টরূপে, পদ্ধতিটি বুদ্ধিমান ডিফল্ট অনুমতির অনুরোধ করে। প্রতিটি অনুমতি কিসের জন্য রেফারেন্স API সম্পূর্ণ ডকুমেন্টেশন প্রদান করে।
শুরু করতে, আপনার অ্যাপ্লিকেশন থেকে পদ্ধতিটি কল করুন (iOS-এ একটি নেটিভ মডেল প্রদর্শিত হবে, ওয়েবে ব্রাউজারের নেটিভ API ফ্লো ট্রিগার হবে):
FirebaseMessaging messaging = FirebaseMessaging.instance;
NotificationSettings settings = await messaging.requestPermission(
alert: true,
announcement: false,
badge: true,
carPlay: false,
criticalAlert: false,
provisional: false,
sound: true,
);
print('User granted permission: ${settings.authorizationStatus}');
অনুরোধ থেকে ফিরে আসা NotificationSettings
অবজেক্টের authorizationStatus
বৈশিষ্ট্য ব্যবহারকারীর সামগ্রিক সিদ্ধান্ত নির্ধারণ করতে ব্যবহার করা যেতে পারে:
-
authorized
: ব্যবহারকারী অনুমতি দিয়েছেন। -
denied
: ব্যবহারকারী অনুমতি অস্বীকার করেছেন। -
notDetermined
: ব্যবহারকারী এখনও অনুমতি দিতে হবে কিনা তা বেছে নেননি। -
provisional
: ব্যবহারকারী অস্থায়ী অনুমতি দিয়েছেন
NotificationSettings
সেটিংসের অন্যান্য বৈশিষ্ট্যগুলি বর্তমান ডিভাইসে একটি নির্দিষ্ট অনুমতি সক্ষম, অক্ষম বা সমর্থিত কিনা তা ফেরত দেয়।
একবার অনুমতি দেওয়া হয়ে গেলে এবং বিভিন্ন ধরনের ডিভাইসের অবস্থা বোঝা হয়ে গেলে, আপনার অ্যাপ্লিকেশন এখন আগত FCM পেলোডগুলি পরিচালনা করা শুরু করতে পারে।
বার্তা পরিচালনা
আপনার অ্যাপ্লিকেশানের বর্তমান অবস্থার উপর ভিত্তি করে, বিভিন্ন ধরনের বার্তার ইনকামিং পেলোডগুলিকে পরিচালনা করার জন্য বিভিন্ন বাস্তবায়নের প্রয়োজন হয়:
ফোরগ্রাউন্ড বার্তা
আপনার অ্যাপ্লিকেশনটি অগ্রভাগে থাকাকালীন বার্তাগুলি পরিচালনা করতে, onMessage
স্ট্রীমটি শুনুন৷
FirebaseMessaging.onMessage.listen((RemoteMessage message) {
print('Got a message whilst in the foreground!');
print('Message data: ${message.data}');
if (message.notification != null) {
print('Message also contained a notification: ${message.notification}');
}
});
স্ট্রীমটিতে একটি RemoteMessage
রয়েছে, পেলোড সম্পর্কে বিভিন্ন তথ্যের বিশদ বিবরণ, যেমন এটি কোথা থেকে এসেছে, অনন্য আইডি, পাঠানোর সময়, এটিতে একটি বিজ্ঞপ্তি রয়েছে কিনা এবং আরও অনেক কিছু। যেহেতু আপনার অ্যাপ্লিকেশনটি ফোরগ্রাউন্ডে থাকাকালীন বার্তাটি পুনরুদ্ধার করা হয়েছিল, আপনি সরাসরি আপনার ফ্লাটার অ্যাপ্লিকেশনটির অবস্থা এবং প্রসঙ্গ অ্যাক্সেস করতে পারেন।
ফোরগ্রাউন্ড এবং বিজ্ঞপ্তি বার্তা
অ্যাপ্লিকেশানটি অগ্রভাগে থাকাকালীন যে বিজ্ঞপ্তি বার্তাগুলি আসে সেগুলি Android এবং iOS উভয় ক্ষেত্রেই ডিফল্টরূপে একটি দৃশ্যমান বিজ্ঞপ্তি প্রদর্শন করবে না৷ যাইহোক, এই আচরণটি ওভাররাইড করা সম্ভব:
- অ্যান্ড্রয়েডে, আপনাকে অবশ্যই একটি "উচ্চ অগ্রাধিকার" বিজ্ঞপ্তি চ্যানেল তৈরি করতে হবে৷
- iOS-এ, আপনি অ্যাপ্লিকেশনের জন্য উপস্থাপনা বিকল্পগুলি আপডেট করতে পারেন।
পটভূমি বার্তা
নেটিভ (অ্যান্ড্রয়েড এবং অ্যাপল) এবং ওয়েব ভিত্তিক প্ল্যাটফর্মে ব্যাকগ্রাউন্ড মেসেজ পরিচালনার প্রক্রিয়া ভিন্ন।
অ্যাপল প্ল্যাটফর্ম এবং অ্যান্ড্রয়েড
একটি onBackgroundMessage
হ্যান্ডলার নিবন্ধন করে পটভূমি বার্তাগুলি পরিচালনা করুন৷ যখন বার্তাগুলি প্রাপ্ত হয়, তখন একটি বিচ্ছিন্নতা তৈরি হয় (শুধুমাত্র Android, iOS/macOS-এর জন্য আলাদা আলাদা করার প্রয়োজন হয় না) আপনার অ্যাপ্লিকেশনটি চলমান না থাকলেও আপনাকে বার্তাগুলি পরিচালনা করতে দেয়৷
আপনার ব্যাকগ্রাউন্ড মেসেজ হ্যান্ডলার সম্পর্কে কিছু জিনিস মাথায় রাখতে হবে:
- এটি একটি বেনামী ফাংশন হতে হবে না.
- এটি অবশ্যই একটি শীর্ষ-স্তরের ফাংশন হতে হবে (যেমন একটি ক্লাস পদ্ধতি নয় যার জন্য আরম্ভ করার প্রয়োজন হয়)।
- Flutter সংস্করণ 3.3.0 বা উচ্চতর ব্যবহার করার সময়, বার্তা হ্যান্ডলারকে অবশ্যই ফাংশন ঘোষণার ঠিক উপরে
@pragma('vm:entry-point')
দিয়ে টীকা দিতে হবে (অন্যথায় এটি রিলিজ মোডের জন্য ট্রি কাঁপানোর সময় সরানো হতে পারে)।
@pragma('vm:entry-point')
Future<void> _firebaseMessagingBackgroundHandler(RemoteMessage message) async {
// If you're going to use other Firebase services in the background, such as Firestore,
// make sure you call `initializeApp` before using other Firebase services.
await Firebase.initializeApp();
print("Handling a background message: ${message.messageId}");
}
void main() {
FirebaseMessaging.onBackgroundMessage(_firebaseMessagingBackgroundHandler);
runApp(MyApp());
}
যেহেতু হ্যান্ডলারটি আপনার অ্যাপ্লিকেশনের প্রেক্ষাপটের বাইরে তার নিজস্ব বিচ্ছিন্নভাবে চলে, তাই অ্যাপ্লিকেশনের অবস্থা আপডেট করা বা কোনো UI প্রভাবিত যুক্তি কার্যকর করা সম্ভব নয়। যাইহোক, আপনি HTTP অনুরোধের মতো যুক্তি সম্পাদন করতে পারেন, IO ক্রিয়াকলাপ সম্পাদন করতে পারেন (যেমন স্থানীয় স্টোরেজ আপডেট করা), অন্যান্য প্লাগইনগুলির সাথে যোগাযোগ করা ইত্যাদি।
যত তাড়াতাড়ি সম্ভব আপনার যুক্তি সম্পূর্ণ করার সুপারিশ করা হয়। দীর্ঘ, নিবিড় কাজগুলি চালানো ডিভাইসের কার্যকারিতাকে প্রভাবিত করে এবং OS প্রক্রিয়াটি বন্ধ করতে পারে। যদি কাজগুলি 30 সেকেন্ডের বেশি সময় ধরে চলতে থাকে, তাহলে ডিভাইসটি স্বয়ংক্রিয়ভাবে প্রক্রিয়াটিকে মেরে ফেলতে পারে।
ওয়েব
ওয়েবে, একটি জাভাস্ক্রিপ্ট পরিষেবা কর্মী লিখুন যা ব্যাকগ্রাউন্ডে চলে। ব্যাকগ্রাউন্ড বার্তা পরিচালনা করতে পরিষেবা কর্মী ব্যবহার করুন।
শুরু করতে, আপনার web
ডিরেক্টরিতে একটি নতুন ফাইল তৈরি করুন এবং এটিকে firebase-messaging-sw.js
বলুন :
// Please see this file for the latest firebase-js-sdk version:
// https://github.com/firebase/flutterfire/blob/master/packages/firebase_core/firebase_core_web/lib/src/firebase_sdk_version.dart
importScripts("https://www.gstatic.com/firebasejs/10.7.0/firebase-app-compat.js");
importScripts("https://www.gstatic.com/firebasejs/10.7.0/firebase-messaging-compat.js");
firebase.initializeApp({
apiKey: "...",
authDomain: "...",
databaseURL: "...",
projectId: "...",
storageBucket: "...",
messagingSenderId: "...",
appId: "...",
});
const messaging = firebase.messaging();
// Optional:
messaging.onBackgroundMessage((message) => {
console.log("onBackgroundMessage", message);
});
ফাইলটিকে অবশ্যই অ্যাপ এবং মেসেজিং SDK উভয়ই আমদানি করতে হবে, Firebase শুরু করতে হবে এবং messaging
ভেরিয়েবলটি প্রকাশ করতে হবে।
পরবর্তী, কর্মী নিবন্ধিত করা আবশ্যক. index.html
ফাইলের মধ্যে, <script>
ট্যাগ পরিবর্তন করে কর্মী নিবন্ধন করুন যা বুটস্ট্র্যাপ ফ্লাটার:
<script src="flutter_bootstrap.js" async>
if ('serviceWorker' in navigator) {
window.addEventListener('load', function () {
navigator.serviceWorker.register('firebase-messaging-sw.js', {
scope: '/firebase-cloud-messaging-push-scope',
});
});
}
</script>
আপনি যদি এখনও পুরানো টেমপ্লেটিং সিস্টেম ব্যবহার করে থাকেন, তাহলে আপনি <script>
ট্যাগ পরিবর্তন করে কর্মীকে নিবন্ধন করতে পারেন যা বুটস্ট্র্যাপ ফ্লটারকে নিম্নরূপ:
<html>
<body>
<script>
var serviceWorkerVersion = null;
var scriptLoaded = false;
function loadMainDartJs() {
if (scriptLoaded) {
return;
}
scriptLoaded = true;
var scriptTag = document.createElement('script');
scriptTag.src = 'main.dart.js';
scriptTag.type = 'application/javascript';
document.body.append(scriptTag);
}
if ('serviceWorker' in navigator) {
// Service workers are supported. Use them.
window.addEventListener('load', function () {
// Register Firebase Messaging service worker.
navigator.serviceWorker.register('firebase-messaging-sw.js', {
scope: '/firebase-cloud-messaging-push-scope',
});
// Wait for registration to finish before dropping the <script> tag.
// Otherwise, the browser will load the script multiple times,
// potentially different versions.
var serviceWorkerUrl =
'flutter_service_worker.js?v=' + serviceWorkerVersion;
navigator.serviceWorker.register(serviceWorkerUrl).then((reg) => {
function waitForActivation(serviceWorker) {
serviceWorker.addEventListener('statechange', () => {
if (serviceWorker.state == 'activated') {
console.log('Installed new service worker.');
loadMainDartJs();
}
});
}
if (!reg.active && (reg.installing || reg.waiting)) {
// No active web worker and we have installed or are installing
// one for the first time. Simply wait for it to activate.
waitForActivation(reg.installing ?? reg.waiting);
} else if (!reg.active.scriptURL.endsWith(serviceWorkerVersion)) {
// When the app updates the serviceWorkerVersion changes, so we
// need to ask the service worker to update.
console.log('New service worker available.');
reg.update();
waitForActivation(reg.installing);
} else {
// Existing service worker is still good.
console.log('Loading app from service worker.');
loadMainDartJs();
}
});
// If service worker doesn't succeed in a reasonable amount of time,
// fallback to plaint <script> tag.
setTimeout(() => {
if (!scriptLoaded) {
console.warn(
'Failed to load app from service worker. Falling back to plain <script> tag.'
);
loadMainDartJs();
}
}, 4000);
});
} else {
// Service workers not supported. Just drop the <script> tag.
loadMainDartJs();
}
</script>
</body>
এরপর আপনার ফ্লটার অ্যাপ্লিকেশন পুনরায় চালু করুন। কর্মী নিবন্ধিত হবে এবং যেকোন ব্যাকগ্রাউন্ড বার্তা এই ফাইলের মাধ্যমে পরিচালনা করা হবে।
হ্যান্ডলিং ইন্টারঅ্যাকশন
যেহেতু বিজ্ঞপ্তিগুলি একটি দৃশ্যমান সংকেত, তাই ব্যবহারকারীদের জন্য তাদের সাথে যোগাযোগ করা (টিপে) সাধারণ। অ্যান্ড্রয়েড এবং আইওএস উভয় ক্ষেত্রেই ডিফল্ট আচরণ হল অ্যাপ্লিকেশনটি খুলতে। আবেদন বাতিল হলে তা শুরু করা হবে; যদি এটি ব্যাকগ্রাউন্ডে থাকে তবে এটি অগ্রভাগে আনা হবে।
একটি বিজ্ঞপ্তির বিষয়বস্তুর উপর নির্ভর করে, অ্যাপ্লিকেশনটি খোলার সময় আপনি ব্যবহারকারীর মিথস্ক্রিয়া পরিচালনা করতে চাইতে পারেন। উদাহরণস্বরূপ, যদি একটি নতুন চ্যাট বার্তা একটি বিজ্ঞপ্তির মাধ্যমে পাঠানো হয় এবং ব্যবহারকারী এটি চাপেন, আপনি অ্যাপ্লিকেশনটি খোলার সময় নির্দিষ্ট কথোপকথনটি খুলতে চাইতে পারেন।
firebase-messaging
প্যাকেজ এই মিথস্ক্রিয়া পরিচালনা করার দুটি উপায় প্রদান করে:
-
getInitialMessage()
: যদি একটি সমাপ্ত অবস্থা থেকে অ্যাপ্লিকেশনটি খোলা হয় তাহলে একটিRemoteMessage
সম্বলিত একটিFuture
ফেরত দেওয়া হবে। একবার সেবন করলে,RemoteMessage
সরানো হবে। -
onMessageOpenedApp
: একটিStream
যা একটিRemoteMessage
পোস্ট করে যখন অ্যাপ্লিকেশনটি একটি ব্যাকগ্রাউন্ড অবস্থা থেকে খোলা হয়।
আপনার ব্যবহারকারীদের জন্য একটি মসৃণ UX নিশ্চিত করতে উভয় পরিস্থিতিতেই পরিচালনা করা বাঞ্ছনীয়। নীচের কোডের উদাহরণটি কীভাবে এটি অর্জন করা যেতে পারে তা রূপরেখা দেয়:
class Application extends StatefulWidget {
@override
State<StatefulWidget> createState() => _Application();
}
class _Application extends State<Application> {
// It is assumed that all messages contain a data field with the key 'type'
Future<void> setupInteractedMessage() async {
// Get any messages which caused the application to open from
// a terminated state.
RemoteMessage? initialMessage =
await FirebaseMessaging.instance.getInitialMessage();
// If the message also contains a data property with a "type" of "chat",
// navigate to a chat screen
if (initialMessage != null) {
_handleMessage(initialMessage);
}
// Also handle any interaction when the app is in the background via a
// Stream listener
FirebaseMessaging.onMessageOpenedApp.listen(_handleMessage);
}
void _handleMessage(RemoteMessage message) {
if (message.data['type'] == 'chat') {
Navigator.pushNamed(context, '/chat',
arguments: ChatArguments(message),
);
}
}
@override
void initState() {
super.initState();
// Run code required to handle interacted messages in an async function
// as initState() must not be async
setupInteractedMessage();
}
@override
Widget build(BuildContext context) {
return Text("...");
}
}
আপনি কীভাবে মিথস্ক্রিয়া পরিচালনা করবেন তা আপনার অ্যাপ্লিকেশন সেটআপের উপর নির্ভর করে। উপরের উদাহরণটি একটি StatefulWidget ব্যবহার করে একটি মৌলিক চিত্র দেখায়।
বার্তা স্থানীয়করণ
আপনি দুটি ভিন্ন উপায়ে স্থানীয় স্ট্রিং পাঠাতে পারেন:
- আপনার সার্ভারে আপনার প্রতিটি ব্যবহারকারীর পছন্দের ভাষা সংরক্ষণ করুন এবং প্রতিটি ভাষার জন্য কাস্টমাইজড বিজ্ঞপ্তি পাঠান
- আপনার অ্যাপে স্থানীয়কৃত স্ট্রিং এম্বেড করুন এবং অপারেটিং সিস্টেমের স্থানীয় লোকেল সেটিংস ব্যবহার করুন
দ্বিতীয় পদ্ধতিটি কীভাবে ব্যবহার করবেন তা এখানে:
অ্যান্ড্রয়েড
resources/values/strings.xml
এ আপনার ডিফল্ট-ভাষা বার্তা নির্দিষ্ট করুন:<string name="notification_title">Hello world</string> <string name="notification_message">This is a message</string>
values- language
ডিরেক্টরিতে অনুবাদিত বার্তাগুলি নির্দিষ্ট করুন। উদাহরণস্বরূপ,resources/values-fr/strings.xml
এ ফরাসি বার্তা নির্দিষ্ট করুন:<string name="notification_title">Bonjour le monde</string> <string name="notification_message">C'est un message</string>
সার্ভার পেলোডে,
title
,message
, এবংbody
কীগুলি ব্যবহার করার পরিবর্তে, আপনার স্থানীয় বার্তার জন্যtitle_loc_key
এবংbody_loc_key
ব্যবহার করুন এবং আপনি যে বার্তাটি প্রদর্শন করতে চান তারname
বৈশিষ্ট্যে সেগুলি সেট করুন৷বার্তা পেলোড এই মত দেখাবে:
{ "data": { "title_loc_key": "notification_title", "body_loc_key": "notification_message" } }
iOS
Base.lproj/Localizable.strings
এ আপনার ডিফল্ট-ভাষা বার্তা নির্দিষ্ট করুন:"NOTIFICATION_TITLE" = "Hello World"; "NOTIFICATION_MESSAGE" = "This is a message";
language .lproj
ডিরেক্টরিতে অনুবাদিত বার্তাগুলি নির্দিষ্ট করুন। উদাহরণস্বরূপ,fr.lproj/Localizable.strings
এ ফরাসি বার্তা উল্লেখ করুন:"NOTIFICATION_TITLE" = "Bonjour le monde"; "NOTIFICATION_MESSAGE" = "C'est un message";
বার্তা পেলোড এই মত দেখাবে:
{ "data": { "title_loc_key": "NOTIFICATION_TITLE", "body_loc_key": "NOTIFICATION_MESSAGE" } }
বার্তা বিতরণ ডেটা রপ্তানি সক্ষম করুন৷
আপনি আরও বিশ্লেষণের জন্য আপনার মেসেজ ডেটা BigQuery-এ এক্সপোর্ট করতে পারেন। BigQuery আপনাকে BigQuery SQL ব্যবহার করে ডেটা বিশ্লেষণ করতে, অন্য ক্লাউড প্রদানকারীর কাছে রপ্তানি করতে বা আপনার কাস্টম ML মডেলের জন্য ডেটা ব্যবহার করতে দেয়। BigQuery-এ রপ্তানি করা বার্তাগুলির জন্য সমস্ত উপলব্ধ ডেটা অন্তর্ভুক্ত করে, বার্তার ধরন নির্বিশেষে বা বার্তাটি API বা বিজ্ঞপ্তি কম্পোজারের মাধ্যমে পাঠানো হয়েছে কিনা।
রপ্তানি সক্ষম করতে, প্রথমে এখানে বর্ণিত পদক্ষেপগুলি অনুসরণ করুন, তারপর এই নির্দেশাবলী অনুসরণ করুন:
অ্যান্ড্রয়েড
আপনি নিম্নলিখিত কোড ব্যবহার করতে পারেন:
await FirebaseMessaging.instance.setDeliveryMetricsExportToBigQuery(true);
iOS
iOS এর জন্য, আপনাকে নিম্নলিখিত বিষয়বস্তু সহ AppDelegate.m
পরিবর্তন করতে হবে।
#import "AppDelegate.h"
#import "GeneratedPluginRegistrant.h"
#import <Firebase/Firebase.h>
@implementation AppDelegate
- (BOOL)application:(UIApplication *)application
didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
[GeneratedPluginRegistrant registerWithRegistry:self];
// Override point for customization after application launch.
return [super application:application didFinishLaunchingWithOptions:launchOptions];
}
- (void)application:(UIApplication *)application
didReceiveRemoteNotification:(NSDictionary *)userInfo
fetchCompletionHandler:(void (^)(UIBackgroundFetchResult))completionHandler {
[[FIRMessaging extensionHelper] exportDeliveryMetricsToBigQueryWithMessageInfo:userInfo];
}
@end
ওয়েব
ওয়েবের জন্য, SDK-এর v9 সংস্করণ ব্যবহার করার জন্য আপনাকে আপনার পরিষেবা কর্মী পরিবর্তন করতে হবে। v9 সংস্করণটি বান্ডিল করা দরকার, তাই পরিষেবা কর্মীকে কাজ করার জন্য আপনাকে esbuild
মতো একটি বান্ডলার ব্যবহার করতে হবে। এটি কীভাবে অর্জন করা যায় তা দেখতে উদাহরণ অ্যাপটি দেখুন।
একবার আপনি v9 SDK-এ স্থানান্তরিত হয়ে গেলে, আপনি নিম্নলিখিত কোডটি ব্যবহার করতে পারেন:
import {
experimentalSetDeliveryMetricsExportedToBigQueryEnabled,
getMessaging,
} from 'firebase/messaging/sw';
...
const messaging = getMessaging(app);
experimentalSetDeliveryMetricsExportedToBigQueryEnabled(messaging, true);
web
ফোল্ডারে আপনার পরিষেবা কর্মীর নতুন সংস্করণ রপ্তানি করার জন্য yarn build
চালাতে ভুলবেন না।
iOS-এ বিজ্ঞপ্তিতে ছবি প্রদর্শন করুন
Apple ডিভাইসগুলিতে, FCM পেলোড থেকে ছবিগুলি প্রদর্শন করার জন্য ইনকামিং FCM বিজ্ঞপ্তিগুলির জন্য, আপনাকে অবশ্যই একটি অতিরিক্ত বিজ্ঞপ্তি পরিষেবা এক্সটেনশন যোগ করতে হবে এবং এটি ব্যবহার করার জন্য আপনার অ্যাপটি কনফিগার করতে হবে৷
আপনি যদি Firebase ফোন প্রমাণীকরণ ব্যবহার করেন, তাহলে আপনাকে অবশ্যই আপনার Podfile-এ Firebase Auth পড যোগ করতে হবে।
ধাপ 1 - একটি বিজ্ঞপ্তি পরিষেবা এক্সটেনশন যোগ করুন
- এক্সকোডে, ফাইল > নতুন > টার্গেটে ক্লিক করুন...
- একটি মডেল সম্ভাব্য লক্ষ্যগুলির একটি তালিকা উপস্থাপন করবে; নোটিফিকেশন সার্ভিস এক্সটেনশন নির্বাচন করতে নিচে স্ক্রোল করুন বা ফিল্টার ব্যবহার করুন। পরবর্তী ক্লিক করুন.
- একটি পণ্যের নাম যোগ করুন (এই টিউটোরিয়ালটি অনুসরণ করতে "ইমেজনোটিফিকেশন" ব্যবহার করুন), ভাষাকে উদ্দেশ্য-সি-তে সেট করুন এবং শেষ ক্লিক করুন।
- সক্রিয় করুন ক্লিক করে স্কিমটি সক্ষম করুন।
ধাপ 2 - পডফাইলে লক্ষ্য যোগ করুন
আপনার নতুন এক্সটেনশনের Firebase/Messaging
পডের অ্যাক্সেস আছে কিনা তা পডফাইলে যোগ করে নিশ্চিত করুন:
নেভিগেটর থেকে, Podfile খুলুন: Pods > Podfile
ফাইলের নীচে স্ক্রোল করুন এবং যোগ করুন:
target 'ImageNotification' do use_frameworks! pod 'Firebase/Auth' # Add this line if you are using FirebaseAuth phone authentication pod 'Firebase/Messaging' end
ios
বাmacos
ডিরেক্টরি থেকেpod install
ব্যবহার করে আপনার পড ইনস্টল বা আপডেট করুন।
ধাপ 3 - এক্সটেনশন হেল্পার ব্যবহার করুন
এই মুহুর্তে, সবকিছু এখনও স্বাভাবিকভাবে চলতে হবে। চূড়ান্ত ধাপ হল এক্সটেনশন হেল্পারকে ডাকা।
নেভিগেটর থেকে, আপনার ImageNotification এক্সটেনশন নির্বাচন করুন
NotificationService.m
ফাইলটি খুলুন।ফাইলের শীর্ষে, নীচে দেখানো হিসাবে
NotificationService.h
ঠিক পরেFirebaseMessaging.h
আমদানি করুন।NotificationService.m
এর বিষয়বস্তু এর সাথে প্রতিস্থাপন করুন:#import "NotificationService.h" #import "FirebaseMessaging.h" #import "FirebaseAuth.h" // Add this line if you are using FirebaseAuth phone authentication #import <UIKit/UIKit.h> // Add this line if you are using FirebaseAuth phone authentication @interface NotificationService () @property (nonatomic, strong) void (^contentHandler)(UNNotificationContent *contentToDeliver); @property (nonatomic, strong) UNMutableNotificationContent *bestAttemptContent; @end @implementation NotificationService /* Uncomment this if you are using Firebase Auth - (BOOL)application:(UIApplication *)app openURL:(NSURL *)url options:(NSDictionary<UIApplicationOpenURLOptionsKey, id> *)options { if ([[FIRAuth auth] canHandleURL:url]) { return YES; } return NO; } - (void)scene:(UIScene *)scene openURLContexts:(NSSet<UIOpenURLContext *> *)URLContexts { for (UIOpenURLContext *urlContext in URLContexts) { [FIRAuth.auth canHandleURL:urlContext.URL]; } } */ - (void)didReceiveNotificationRequest:(UNNotificationRequest *)request withContentHandler:(void (^)(UNNotificationContent * _Nonnull))contentHandler { self.contentHandler = contentHandler; self.bestAttemptContent = [request.content mutableCopy]; // Modify the notification content here... [[FIRMessaging extensionHelper] populateNotificationContent:self.bestAttemptContent withContentHandler:contentHandler]; } - (void)serviceExtensionTimeWillExpire { // Called just before the extension will be terminated by the system. // Use this as an opportunity to deliver your "best attempt" at modified content, otherwise the original push payload will be used. self.contentHandler(self.bestAttemptContent); } @end
ধাপ 4 - পেলোডে ইমেজ যোগ করুন
আপনার বিজ্ঞপ্তি পেলোডে, আপনি এখন একটি ছবি যোগ করতে পারেন। কিভাবে একটি প্রেরণ অনুরোধ তৈরি করতে iOS ডকুমেন্টেশন দেখুন. মনে রাখবেন যে একটি 300KB সর্বাধিক চিত্রের আকার ডিভাইস দ্বারা প্রয়োগ করা হয়েছে৷
,একটি ডিভাইসের অবস্থার উপর নির্ভর করে, আগত বার্তাগুলি ভিন্নভাবে পরিচালনা করা হয়। এই পরিস্থিতিগুলি বুঝতে এবং কীভাবে আপনার নিজের অ্যাপ্লিকেশনে এফসিএমকে একীভূত করতে হয়, ডিভাইসটি যে বিভিন্ন রাজ্যে থাকতে পারে তা স্থাপন করা প্রথমে গুরুত্বপূর্ণ:
রাজ্য | বর্ণনা |
---|---|
ফোরগ্রাউন্ড | যখন অ্যাপ্লিকেশন খোলা থাকে, দৃশ্যে এবং ব্যবহারে। |
পটভূমি | যখন অ্যাপ্লিকেশনটি খোলা থাকে তবে পটভূমিতে (মিনিমাইজড)। এটি সাধারণত ঘটে যখন ব্যবহারকারী ডিভাইসে "হোম" বোতাম টিপে, অ্যাপ সুইচার ব্যবহার করে অন্য অ্যাপে স্যুইচ করে, বা একটি ভিন্ন ট্যাবে (ওয়েব) অ্যাপ্লিকেশন খোলা থাকে। |
সমাপ্ত | যখন ডিভাইসটি লক থাকে বা অ্যাপ্লিকেশনটি চলছে না। |
FCM এর মাধ্যমে অ্যাপ্লিকেশনটি বার্তা পেলোড গ্রহণ করার আগে কয়েকটি পূর্বশর্ত পূরণ করতে হবে:
- অ্যাপ্লিকেশনটি অন্তত একবার খোলা থাকতে হবে (FCM-এর সাথে নিবন্ধনের অনুমতি দেওয়ার জন্য)।
- iOS-এ, ব্যবহারকারী অ্যাপ সুইচার থেকে অ্যাপ্লিকেশনটি সোয়াইপ করলে, আবার কাজ শুরু করার জন্য ব্যাকগ্রাউন্ড বার্তাগুলির জন্য এটিকে ম্যানুয়ালি পুনরায় খুলতে হবে।
- অ্যান্ড্রয়েডে, ব্যবহারকারী যদি ডিভাইস সেটিংস থেকে অ্যাপটিকে জোর করে ছেড়ে দেয়, তাহলে বার্তাগুলি কাজ শুরু করার জন্য এটি ম্যানুয়ালি পুনরায় খুলতে হবে।
- ওয়েবে, আপনি অবশ্যই আপনার ওয়েব পুশ সার্টিফিকেট সহ একটি টোকেন (
getToken()
ব্যবহার করে) অনুরোধ করেছেন৷
বার্তা গ্রহণ করার অনুমতির জন্য অনুরোধ করুন
iOS, macOS, ওয়েব এবং Android 13 (বা নতুন) এ, আপনার ডিভাইসে FCM পেলোড গ্রহণ করার আগে, আপনাকে প্রথমে ব্যবহারকারীর অনুমতি চাইতে হবে।
firebase_messaging
প্যাকেজ requestPermission
পদ্ধতির মাধ্যমে অনুমতির অনুরোধ করার জন্য একটি সহজ API প্রদান করে। এই API অনেকগুলি নামযুক্ত আর্গুমেন্ট গ্রহণ করে যা আপনি যে ধরনের অনুমতির অনুরোধ করতে চান তা সংজ্ঞায়িত করে, যেমন নোটিফিকেশন পেলোড ধারণকারী মেসেজিং একটি শব্দ ট্রিগার করতে পারে বা Siri এর মাধ্যমে বার্তা পড়তে পারে কিনা। ডিফল্টরূপে, পদ্ধতিটি বুদ্ধিমান ডিফল্ট অনুমতির অনুরোধ করে। প্রতিটি অনুমতি কিসের জন্য রেফারেন্স API সম্পূর্ণ ডকুমেন্টেশন প্রদান করে।
শুরু করতে, আপনার অ্যাপ্লিকেশন থেকে পদ্ধতিটি কল করুন (iOS-এ একটি নেটিভ মডেল প্রদর্শিত হবে, ওয়েবে ব্রাউজারের নেটিভ API ফ্লো ট্রিগার হবে):
FirebaseMessaging messaging = FirebaseMessaging.instance;
NotificationSettings settings = await messaging.requestPermission(
alert: true,
announcement: false,
badge: true,
carPlay: false,
criticalAlert: false,
provisional: false,
sound: true,
);
print('User granted permission: ${settings.authorizationStatus}');
অনুরোধ থেকে ফিরে আসা NotificationSettings
অবজেক্টের authorizationStatus
বৈশিষ্ট্য ব্যবহারকারীর সামগ্রিক সিদ্ধান্ত নির্ধারণ করতে ব্যবহার করা যেতে পারে:
-
authorized
: ব্যবহারকারী অনুমতি দিয়েছেন। -
denied
: ব্যবহারকারী অনুমতি অস্বীকার করেছেন। -
notDetermined
: ব্যবহারকারী এখনও অনুমতি দিতে হবে কিনা তা বেছে নেননি। -
provisional
: ব্যবহারকারী অস্থায়ী অনুমতি দিয়েছেন
NotificationSettings
সেটিংসের অন্যান্য বৈশিষ্ট্যগুলি বর্তমান ডিভাইসে একটি নির্দিষ্ট অনুমতি সক্ষম, অক্ষম বা সমর্থিত কিনা তা ফেরত দেয়।
একবার অনুমতি দেওয়া হয়ে গেলে এবং বিভিন্ন ধরনের ডিভাইসের অবস্থা বোঝা হয়ে গেলে, আপনার অ্যাপ্লিকেশন এখন আগত FCM পেলোডগুলি পরিচালনা করা শুরু করতে পারে।
বার্তা পরিচালনা
আপনার অ্যাপ্লিকেশানের বর্তমান অবস্থার উপর ভিত্তি করে, বিভিন্ন ধরনের বার্তার ইনকামিং পেলোডগুলিকে পরিচালনা করার জন্য বিভিন্ন বাস্তবায়নের প্রয়োজন হয়:
ফোরগ্রাউন্ড বার্তা
আপনার অ্যাপ্লিকেশনটি অগ্রভাগে থাকাকালীন বার্তাগুলি পরিচালনা করতে, onMessage
স্ট্রীমটি শুনুন৷
FirebaseMessaging.onMessage.listen((RemoteMessage message) {
print('Got a message whilst in the foreground!');
print('Message data: ${message.data}');
if (message.notification != null) {
print('Message also contained a notification: ${message.notification}');
}
});
স্ট্রীমটিতে একটি RemoteMessage
রয়েছে, পেলোড সম্পর্কে বিভিন্ন তথ্যের বিশদ বিবরণ, যেমন এটি কোথা থেকে এসেছে, অনন্য আইডি, পাঠানোর সময়, এটিতে একটি বিজ্ঞপ্তি রয়েছে কিনা এবং আরও অনেক কিছু। যেহেতু আপনার অ্যাপ্লিকেশনটি ফোরগ্রাউন্ডে থাকাকালীন বার্তাটি পুনরুদ্ধার করা হয়েছিল, আপনি সরাসরি আপনার ফ্লাটার অ্যাপ্লিকেশনটির অবস্থা এবং প্রসঙ্গ অ্যাক্সেস করতে পারেন।
ফোরগ্রাউন্ড এবং বিজ্ঞপ্তি বার্তা
অ্যাপ্লিকেশানটি অগ্রভাগে থাকাকালীন যে বিজ্ঞপ্তি বার্তাগুলি আসে সেগুলি Android এবং iOS উভয় ক্ষেত্রেই ডিফল্টরূপে একটি দৃশ্যমান বিজ্ঞপ্তি প্রদর্শন করবে না৷ যাইহোক, এই আচরণটি ওভাররাইড করা সম্ভব:
- অ্যান্ড্রয়েডে, আপনাকে অবশ্যই একটি "উচ্চ অগ্রাধিকার" বিজ্ঞপ্তি চ্যানেল তৈরি করতে হবে৷
- iOS-এ, আপনি অ্যাপ্লিকেশনের জন্য উপস্থাপনা বিকল্পগুলি আপডেট করতে পারেন।
পটভূমি বার্তা
নেটিভ (অ্যান্ড্রয়েড এবং অ্যাপল) এবং ওয়েব ভিত্তিক প্ল্যাটফর্মে ব্যাকগ্রাউন্ড মেসেজ পরিচালনার প্রক্রিয়া ভিন্ন।
অ্যাপল প্ল্যাটফর্ম এবং অ্যান্ড্রয়েড
একটি onBackgroundMessage
হ্যান্ডলার নিবন্ধন করে পটভূমি বার্তাগুলি পরিচালনা করুন৷ যখন বার্তাগুলি প্রাপ্ত হয়, তখন একটি বিচ্ছিন্নতা তৈরি হয় (শুধুমাত্র Android, iOS/macOS-এর জন্য আলাদা আলাদা করার প্রয়োজন হয় না) আপনার অ্যাপ্লিকেশনটি চলমান না থাকলেও আপনাকে বার্তাগুলি পরিচালনা করতে দেয়৷
আপনার ব্যাকগ্রাউন্ড মেসেজ হ্যান্ডলার সম্পর্কে কিছু জিনিস মাথায় রাখতে হবে:
- এটি একটি বেনামী ফাংশন হতে হবে না.
- এটি অবশ্যই একটি শীর্ষ-স্তরের ফাংশন হতে হবে (যেমন একটি ক্লাস পদ্ধতি নয় যার জন্য আরম্ভ করার প্রয়োজন হয়)।
- Flutter সংস্করণ 3.3.0 বা উচ্চতর ব্যবহার করার সময়, বার্তা হ্যান্ডলারকে অবশ্যই ফাংশন ঘোষণার ঠিক উপরে
@pragma('vm:entry-point')
দিয়ে টীকা দিতে হবে (অন্যথায় এটি রিলিজ মোডের জন্য ট্রি কাঁপানোর সময় সরানো হতে পারে)।
@pragma('vm:entry-point')
Future<void> _firebaseMessagingBackgroundHandler(RemoteMessage message) async {
// If you're going to use other Firebase services in the background, such as Firestore,
// make sure you call `initializeApp` before using other Firebase services.
await Firebase.initializeApp();
print("Handling a background message: ${message.messageId}");
}
void main() {
FirebaseMessaging.onBackgroundMessage(_firebaseMessagingBackgroundHandler);
runApp(MyApp());
}
যেহেতু হ্যান্ডলারটি আপনার অ্যাপ্লিকেশনের প্রেক্ষাপটের বাইরে তার নিজস্ব বিচ্ছিন্নভাবে চলে, তাই অ্যাপ্লিকেশনের অবস্থা আপডেট করা বা কোনো UI প্রভাবিত যুক্তি কার্যকর করা সম্ভব নয়। যাইহোক, আপনি HTTP অনুরোধের মতো যুক্তি সম্পাদন করতে পারেন, IO ক্রিয়াকলাপ সম্পাদন করতে পারেন (যেমন স্থানীয় স্টোরেজ আপডেট করা), অন্যান্য প্লাগইনগুলির সাথে যোগাযোগ করা ইত্যাদি।
যত তাড়াতাড়ি সম্ভব আপনার যুক্তি সম্পূর্ণ করার সুপারিশ করা হয়। দীর্ঘ, নিবিড় কাজগুলি চালানো ডিভাইসের কার্যকারিতাকে প্রভাবিত করে এবং OS প্রক্রিয়াটি বন্ধ করতে পারে। যদি কাজগুলি 30 সেকেন্ডের বেশি সময় ধরে চলতে থাকে, তাহলে ডিভাইসটি স্বয়ংক্রিয়ভাবে প্রক্রিয়াটিকে মেরে ফেলতে পারে।
ওয়েব
ওয়েবে, একটি জাভাস্ক্রিপ্ট পরিষেবা কর্মী লিখুন যা ব্যাকগ্রাউন্ডে চলে। ব্যাকগ্রাউন্ড বার্তা পরিচালনা করতে পরিষেবা কর্মী ব্যবহার করুন।
শুরু করতে, আপনার web
ডিরেক্টরিতে একটি নতুন ফাইল তৈরি করুন এবং এটিকে firebase-messaging-sw.js
বলুন :
// Please see this file for the latest firebase-js-sdk version:
// https://github.com/firebase/flutterfire/blob/master/packages/firebase_core/firebase_core_web/lib/src/firebase_sdk_version.dart
importScripts("https://www.gstatic.com/firebasejs/10.7.0/firebase-app-compat.js");
importScripts("https://www.gstatic.com/firebasejs/10.7.0/firebase-messaging-compat.js");
firebase.initializeApp({
apiKey: "...",
authDomain: "...",
databaseURL: "...",
projectId: "...",
storageBucket: "...",
messagingSenderId: "...",
appId: "...",
});
const messaging = firebase.messaging();
// Optional:
messaging.onBackgroundMessage((message) => {
console.log("onBackgroundMessage", message);
});
ফাইলটিকে অবশ্যই অ্যাপ এবং মেসেজিং SDK উভয়ই আমদানি করতে হবে, Firebase শুরু করতে হবে এবং messaging
ভেরিয়েবলটি প্রকাশ করতে হবে।
পরবর্তী, কর্মী নিবন্ধিত করা আবশ্যক. index.html
ফাইলের মধ্যে, <script>
ট্যাগ পরিবর্তন করে কর্মী নিবন্ধন করুন যা বুটস্ট্র্যাপ ফ্লাটার:
<script src="flutter_bootstrap.js" async>
if ('serviceWorker' in navigator) {
window.addEventListener('load', function () {
navigator.serviceWorker.register('firebase-messaging-sw.js', {
scope: '/firebase-cloud-messaging-push-scope',
});
});
}
</script>
আপনি যদি এখনও পুরানো টেমপ্লেটিং সিস্টেম ব্যবহার করে থাকেন, তাহলে আপনি <script>
ট্যাগ পরিবর্তন করে কর্মীকে নিবন্ধন করতে পারেন যা বুটস্ট্র্যাপ ফ্লটারকে নিম্নরূপ:
<html>
<body>
<script>
var serviceWorkerVersion = null;
var scriptLoaded = false;
function loadMainDartJs() {
if (scriptLoaded) {
return;
}
scriptLoaded = true;
var scriptTag = document.createElement('script');
scriptTag.src = 'main.dart.js';
scriptTag.type = 'application/javascript';
document.body.append(scriptTag);
}
if ('serviceWorker' in navigator) {
// Service workers are supported. Use them.
window.addEventListener('load', function () {
// Register Firebase Messaging service worker.
navigator.serviceWorker.register('firebase-messaging-sw.js', {
scope: '/firebase-cloud-messaging-push-scope',
});
// Wait for registration to finish before dropping the <script> tag.
// Otherwise, the browser will load the script multiple times,
// potentially different versions.
var serviceWorkerUrl =
'flutter_service_worker.js?v=' + serviceWorkerVersion;
navigator.serviceWorker.register(serviceWorkerUrl).then((reg) => {
function waitForActivation(serviceWorker) {
serviceWorker.addEventListener('statechange', () => {
if (serviceWorker.state == 'activated') {
console.log('Installed new service worker.');
loadMainDartJs();
}
});
}
if (!reg.active && (reg.installing || reg.waiting)) {
// No active web worker and we have installed or are installing
// one for the first time. Simply wait for it to activate.
waitForActivation(reg.installing ?? reg.waiting);
} else if (!reg.active.scriptURL.endsWith(serviceWorkerVersion)) {
// When the app updates the serviceWorkerVersion changes, so we
// need to ask the service worker to update.
console.log('New service worker available.');
reg.update();
waitForActivation(reg.installing);
} else {
// Existing service worker is still good.
console.log('Loading app from service worker.');
loadMainDartJs();
}
});
// If service worker doesn't succeed in a reasonable amount of time,
// fallback to plaint <script> tag.
setTimeout(() => {
if (!scriptLoaded) {
console.warn(
'Failed to load app from service worker. Falling back to plain <script> tag.'
);
loadMainDartJs();
}
}, 4000);
});
} else {
// Service workers not supported. Just drop the <script> tag.
loadMainDartJs();
}
</script>
</body>
এরপর আপনার ফ্লটার অ্যাপ্লিকেশন পুনরায় চালু করুন। কর্মী নিবন্ধিত হবে এবং যেকোন ব্যাকগ্রাউন্ড বার্তা এই ফাইলের মাধ্যমে পরিচালনা করা হবে।
হ্যান্ডলিং ইন্টারঅ্যাকশন
যেহেতু বিজ্ঞপ্তিগুলি একটি দৃশ্যমান সংকেত, তাই ব্যবহারকারীদের জন্য তাদের সাথে যোগাযোগ করা (টিপে) সাধারণ। অ্যান্ড্রয়েড এবং আইওএস উভয় ক্ষেত্রেই ডিফল্ট আচরণ হল অ্যাপ্লিকেশনটি খুলতে। আবেদন বাতিল হলে তা শুরু করা হবে; যদি এটি ব্যাকগ্রাউন্ডে থাকে তবে এটি অগ্রভাগে আনা হবে।
একটি বিজ্ঞপ্তির বিষয়বস্তুর উপর নির্ভর করে, অ্যাপ্লিকেশনটি খোলার সময় আপনি ব্যবহারকারীর মিথস্ক্রিয়া পরিচালনা করতে চাইতে পারেন। উদাহরণস্বরূপ, যদি একটি নতুন চ্যাট বার্তা একটি বিজ্ঞপ্তির মাধ্যমে পাঠানো হয় এবং ব্যবহারকারী এটি চাপেন, আপনি অ্যাপ্লিকেশনটি খোলার সময় নির্দিষ্ট কথোপকথনটি খুলতে চাইতে পারেন।
firebase-messaging
প্যাকেজ এই মিথস্ক্রিয়া পরিচালনা করার দুটি উপায় প্রদান করে:
-
getInitialMessage()
: যদি একটি সমাপ্ত অবস্থা থেকে অ্যাপ্লিকেশনটি খোলা হয় তাহলে একটিRemoteMessage
সম্বলিত একটিFuture
ফেরত দেওয়া হবে। একবার সেবন করলে,RemoteMessage
সরানো হবে। -
onMessageOpenedApp
: একটিStream
যা একটিRemoteMessage
পোস্ট করে যখন অ্যাপ্লিকেশনটি একটি ব্যাকগ্রাউন্ড অবস্থা থেকে খোলা হয়।
আপনার ব্যবহারকারীদের জন্য একটি মসৃণ UX নিশ্চিত করতে উভয় পরিস্থিতিতেই পরিচালনা করা বাঞ্ছনীয়। নীচের কোডের উদাহরণটি কীভাবে এটি অর্জন করা যেতে পারে তা রূপরেখা দেয়:
class Application extends StatefulWidget {
@override
State<StatefulWidget> createState() => _Application();
}
class _Application extends State<Application> {
// It is assumed that all messages contain a data field with the key 'type'
Future<void> setupInteractedMessage() async {
// Get any messages which caused the application to open from
// a terminated state.
RemoteMessage? initialMessage =
await FirebaseMessaging.instance.getInitialMessage();
// If the message also contains a data property with a "type" of "chat",
// navigate to a chat screen
if (initialMessage != null) {
_handleMessage(initialMessage);
}
// Also handle any interaction when the app is in the background via a
// Stream listener
FirebaseMessaging.onMessageOpenedApp.listen(_handleMessage);
}
void _handleMessage(RemoteMessage message) {
if (message.data['type'] == 'chat') {
Navigator.pushNamed(context, '/chat',
arguments: ChatArguments(message),
);
}
}
@override
void initState() {
super.initState();
// Run code required to handle interacted messages in an async function
// as initState() must not be async
setupInteractedMessage();
}
@override
Widget build(BuildContext context) {
return Text("...");
}
}
আপনি কীভাবে মিথস্ক্রিয়া পরিচালনা করবেন তা আপনার অ্যাপ্লিকেশন সেটআপের উপর নির্ভর করে। উপরের উদাহরণটি একটি StatefulWidget ব্যবহার করে একটি মৌলিক চিত্র দেখায়।
বার্তা স্থানীয়করণ
আপনি দুটি ভিন্ন উপায়ে স্থানীয় স্ট্রিং পাঠাতে পারেন:
- আপনার সার্ভারে আপনার প্রতিটি ব্যবহারকারীর পছন্দের ভাষা সংরক্ষণ করুন এবং প্রতিটি ভাষার জন্য কাস্টমাইজড বিজ্ঞপ্তি পাঠান
- আপনার অ্যাপে স্থানীয়কৃত স্ট্রিং এম্বেড করুন এবং অপারেটিং সিস্টেমের স্থানীয় লোকেল সেটিংস ব্যবহার করুন
দ্বিতীয় পদ্ধতিটি কীভাবে ব্যবহার করবেন তা এখানে:
অ্যান্ড্রয়েড
resources/values/strings.xml
এ আপনার ডিফল্ট-ভাষা বার্তা নির্দিষ্ট করুন:<string name="notification_title">Hello world</string> <string name="notification_message">This is a message</string>
values- language
ডিরেক্টরিতে অনুবাদিত বার্তাগুলি নির্দিষ্ট করুন। উদাহরণস্বরূপ,resources/values-fr/strings.xml
এ ফরাসি বার্তা নির্দিষ্ট করুন:<string name="notification_title">Bonjour le monde</string> <string name="notification_message">C'est un message</string>
সার্ভার পেলোডে,
title
,message
, এবংbody
কীগুলি ব্যবহার করার পরিবর্তে, আপনার স্থানীয় বার্তার জন্যtitle_loc_key
এবংbody_loc_key
ব্যবহার করুন এবং আপনি যে বার্তাটি প্রদর্শন করতে চান তারname
বৈশিষ্ট্যে সেগুলি সেট করুন৷বার্তা পেলোড এই মত দেখাবে:
{ "data": { "title_loc_key": "notification_title", "body_loc_key": "notification_message" } }
iOS
Base.lproj/Localizable.strings
এ আপনার ডিফল্ট-ভাষা বার্তা নির্দিষ্ট করুন:"NOTIFICATION_TITLE" = "Hello World"; "NOTIFICATION_MESSAGE" = "This is a message";
language .lproj
ডিরেক্টরিতে অনুবাদিত বার্তাগুলি নির্দিষ্ট করুন। উদাহরণস্বরূপ,fr.lproj/Localizable.strings
এ ফরাসি বার্তা উল্লেখ করুন:"NOTIFICATION_TITLE" = "Bonjour le monde"; "NOTIFICATION_MESSAGE" = "C'est un message";
বার্তা পেলোড এই মত দেখাবে:
{ "data": { "title_loc_key": "NOTIFICATION_TITLE", "body_loc_key": "NOTIFICATION_MESSAGE" } }
বার্তা বিতরণ ডেটা রপ্তানি সক্ষম করুন৷
আপনি আরও বিশ্লেষণের জন্য আপনার মেসেজ ডেটা BigQuery-এ এক্সপোর্ট করতে পারেন। BigQuery আপনাকে BigQuery SQL ব্যবহার করে ডেটা বিশ্লেষণ করতে, অন্য ক্লাউড প্রদানকারীর কাছে রপ্তানি করতে বা আপনার কাস্টম ML মডেলের জন্য ডেটা ব্যবহার করতে দেয়। BigQuery-এ রপ্তানি করা বার্তাগুলির জন্য সমস্ত উপলব্ধ ডেটা অন্তর্ভুক্ত করে, বার্তার ধরন নির্বিশেষে বা বার্তাটি API বা বিজ্ঞপ্তি কম্পোজারের মাধ্যমে পাঠানো হয়েছে কিনা।
রপ্তানি সক্ষম করতে, প্রথমে এখানে বর্ণিত পদক্ষেপগুলি অনুসরণ করুন, তারপর এই নির্দেশাবলী অনুসরণ করুন:
অ্যান্ড্রয়েড
আপনি নিম্নলিখিত কোড ব্যবহার করতে পারেন:
await FirebaseMessaging.instance.setDeliveryMetricsExportToBigQuery(true);
iOS
iOS এর জন্য, আপনাকে নিম্নলিখিত বিষয়বস্তু সহ AppDelegate.m
পরিবর্তন করতে হবে।
#import "AppDelegate.h"
#import "GeneratedPluginRegistrant.h"
#import <Firebase/Firebase.h>
@implementation AppDelegate
- (BOOL)application:(UIApplication *)application
didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
[GeneratedPluginRegistrant registerWithRegistry:self];
// Override point for customization after application launch.
return [super application:application didFinishLaunchingWithOptions:launchOptions];
}
- (void)application:(UIApplication *)application
didReceiveRemoteNotification:(NSDictionary *)userInfo
fetchCompletionHandler:(void (^)(UIBackgroundFetchResult))completionHandler {
[[FIRMessaging extensionHelper] exportDeliveryMetricsToBigQueryWithMessageInfo:userInfo];
}
@end
ওয়েব
ওয়েবের জন্য, SDK-এর v9 সংস্করণ ব্যবহার করার জন্য আপনাকে আপনার পরিষেবা কর্মী পরিবর্তন করতে হবে। v9 সংস্করণটি বান্ডিল করা দরকার, তাই পরিষেবা কর্মীকে কাজ করার জন্য আপনাকে esbuild
মতো একটি বান্ডলার ব্যবহার করতে হবে। এটি কীভাবে অর্জন করা যায় তা দেখতে উদাহরণ অ্যাপটি দেখুন।
একবার আপনি v9 SDK-এ স্থানান্তরিত হয়ে গেলে, আপনি নিম্নলিখিত কোডটি ব্যবহার করতে পারেন:
import {
experimentalSetDeliveryMetricsExportedToBigQueryEnabled,
getMessaging,
} from 'firebase/messaging/sw';
...
const messaging = getMessaging(app);
experimentalSetDeliveryMetricsExportedToBigQueryEnabled(messaging, true);
web
ফোল্ডারে আপনার পরিষেবা কর্মীর নতুন সংস্করণ রপ্তানি করার জন্য yarn build
চালাতে ভুলবেন না।
iOS-এ বিজ্ঞপ্তিতে ছবি প্রদর্শন করুন
Apple ডিভাইসগুলিতে, FCM পেলোড থেকে ছবিগুলি প্রদর্শন করার জন্য ইনকামিং FCM বিজ্ঞপ্তিগুলির জন্য, আপনাকে অবশ্যই একটি অতিরিক্ত বিজ্ঞপ্তি পরিষেবা এক্সটেনশন যোগ করতে হবে এবং এটি ব্যবহার করার জন্য আপনার অ্যাপটি কনফিগার করতে হবে৷
আপনি যদি Firebase ফোন প্রমাণীকরণ ব্যবহার করেন, তাহলে আপনাকে অবশ্যই আপনার Podfile-এ Firebase Auth পড যোগ করতে হবে।
ধাপ 1 - একটি বিজ্ঞপ্তি পরিষেবা এক্সটেনশন যোগ করুন
- এক্সকোডে, ফাইল > নতুন > টার্গেটে ক্লিক করুন...
- একটি মডেল সম্ভাব্য লক্ষ্যগুলির একটি তালিকা উপস্থাপন করবে; নোটিফিকেশন সার্ভিস এক্সটেনশন নির্বাচন করতে নিচে স্ক্রোল করুন বা ফিল্টার ব্যবহার করুন। পরবর্তী ক্লিক করুন.
- একটি পণ্যের নাম যোগ করুন (এই টিউটোরিয়ালটি অনুসরণ করতে "ইমেজনোটিফিকেশন" ব্যবহার করুন), ভাষাকে উদ্দেশ্য-সি-তে সেট করুন এবং শেষ ক্লিক করুন।
- সক্রিয় করুন ক্লিক করে স্কিমটি সক্ষম করুন।
ধাপ 2 - পডফাইলে লক্ষ্য যোগ করুন
আপনার নতুন এক্সটেনশনের Firebase/Messaging
পডের অ্যাক্সেস আছে কিনা তা পডফাইলে যোগ করে নিশ্চিত করুন:
নেভিগেটর থেকে, Podfile খুলুন: Pods > Podfile
ফাইলের নীচে স্ক্রোল করুন এবং যোগ করুন:
target 'ImageNotification' do use_frameworks! pod 'Firebase/Auth' # Add this line if you are using FirebaseAuth phone authentication pod 'Firebase/Messaging' end
ios
বাmacos
ডিরেক্টরি থেকেpod install
ব্যবহার করে আপনার পড ইনস্টল বা আপডেট করুন।
ধাপ 3 - এক্সটেনশন হেল্পার ব্যবহার করুন
এই মুহুর্তে, সবকিছু এখনও স্বাভাবিকভাবে চলতে হবে। চূড়ান্ত ধাপ হল এক্সটেনশন হেল্পারকে ডাকা।
নেভিগেটর থেকে, আপনার ImageNotification এক্সটেনশন নির্বাচন করুন
NotificationService.m
ফাইলটি খুলুন।ফাইলের শীর্ষে, নীচে দেখানো হিসাবে
NotificationService.h
ঠিক পরেFirebaseMessaging.h
আমদানি করুন।NotificationService.m
এর বিষয়বস্তু এর সাথে প্রতিস্থাপন করুন:#import "NotificationService.h" #import "FirebaseMessaging.h" #import "FirebaseAuth.h" // Add this line if you are using FirebaseAuth phone authentication #import <UIKit/UIKit.h> // Add this line if you are using FirebaseAuth phone authentication @interface NotificationService () @property (nonatomic, strong) void (^contentHandler)(UNNotificationContent *contentToDeliver); @property (nonatomic, strong) UNMutableNotificationContent *bestAttemptContent; @end @implementation NotificationService /* Uncomment this if you are using Firebase Auth - (BOOL)application:(UIApplication *)app openURL:(NSURL *)url options:(NSDictionary<UIApplicationOpenURLOptionsKey, id> *)options { if ([[FIRAuth auth] canHandleURL:url]) { return YES; } return NO; } - (void)scene:(UIScene *)scene openURLContexts:(NSSet<UIOpenURLContext *> *)URLContexts { for (UIOpenURLContext *urlContext in URLContexts) { [FIRAuth.auth canHandleURL:urlContext.URL]; } } */ - (void)didReceiveNotificationRequest:(UNNotificationRequest *)request withContentHandler:(void (^)(UNNotificationContent * _Nonnull))contentHandler { self.contentHandler = contentHandler; self.bestAttemptContent = [request.content mutableCopy]; // Modify the notification content here... [[FIRMessaging extensionHelper] populateNotificationContent:self.bestAttemptContent withContentHandler:contentHandler]; } - (void)serviceExtensionTimeWillExpire { // Called just before the extension will be terminated by the system. // Use this as an opportunity to deliver your "best attempt" at modified content, otherwise the original push payload will be used. self.contentHandler(self.bestAttemptContent); } @end
ধাপ 4 - পেলোডে ইমেজ যোগ করুন
আপনার বিজ্ঞপ্তি পেলোডে, আপনি এখন একটি ছবি যোগ করতে পারেন। কিভাবে একটি প্রেরণ অনুরোধ তৈরি করতে iOS ডকুমেন্টেশন দেখুন. মনে রাখবেন যে একটি 300KB সর্বাধিক চিত্রের আকার ডিভাইস দ্বারা প্রয়োগ করা হয়েছে৷