অফলাইন ক্ষমতা চালু করা হচ্ছে

আপনার অ্যাপ সাময়িকভাবে নেটওয়ার্ক কানেকশন হারিয়ে ফেললেও Firebase অ্যাপ্লিকেশন কাজ করে। এছাড়াও, Firebase স্থানীয়ভাবে ডেটা সেভ করা, উপস্থিতি ম্যানেজ করা এবং লেটেন্সি ম্যানেজ করার জন্য টুল প্রদান করে।

ডিস্ক পারসিসটেন্স

Firebase অ্যাপ সাময়িক নেটওয়ার্ক বিঘ্নিত হওয়ার সমস্যা অটোমেটিক ম্যানেজ করে। অফলাইন থাকাকালীন ক্যাশে করা ডেটা উপলভ্য থাকে এবং নেটওয়ার্ক কানেক্টিভিটি রিস্টোর করা হলে Firebase যেকোনও রাইট আবার পাঠায়।

আপনি ডিস্ক পারসিস্টেন্স চালু করলে, আপনার অ্যাপ ডিভাইসে লোকালভাবে ডেটা লেখে যাতে ব্যবহারকারী বা অপারেটিং সিস্টেম অ্যাপ রিস্টার্ট করলেও, আপনার অ্যাপ অফলাইনে স্টেট বজায় রাখতে পারে।

আপনি মাত্র এক লাইন কোড লিখে ডিস্ক পারসিস্টেন্স চালু করতে পারবেন।

FirebaseDatabase.instance.setPersistenceEnabled(true);

অবিরাম আচরণ

পারসিস্টেন্স চালু করার মাধ্যমে, Firebase রিয়েলটাইম ডেটাবেস ক্লায়েন্ট অনলাইন থাকাকালীন সিঙ্ক করা যেকোনও ডেটা ডিস্কে থেকে যায় এবং অফলাইনে উপলভ্য হয়, এমনকি ব্যবহারকারী বা অপারেটিং সিস্টেম অ্যাপটি রিস্টার্ট করলেও। এর অর্থ হল, আপনার অ্যাপটি ক্যাশে স্টোর করা লোকাল ডেটা ব্যবহার করে অনলাইনে যেভাবে কাজ করে সেভাবেই কাজ করে। লোকাল আপডেটের জন্য লিসেনার কলব্যাক ফায়ার করা চালিয়ে যাবে।

আপনার অ্যাপ অফলাইন থাকাকালীন করা সমস্ত লেখার অপারেশনের একটি সারি Firebase রিয়েলটাইম ডেটাবেস ক্লায়েন্ট অটোমেটিক রাখে। পারসিস্টেন্স চালু করা থাকলে, এই সারি ডিস্কে পারসিস্ট করা হয় যাতে ব্যবহারকারী বা অপারেটিং সিস্টেম অ্যাপ রিস্টার্ট করলে আপনার সব রাইট উপলভ্য থাকে। অ্যাপ আবার কানেক্ট হলে, সব অপারেশন Firebase রিয়েলটাইম ডেটাবেস সার্ভারে পাঠানো হয়।

আপনার অ্যাপ Firebase Authentication ব্যবহার করলে, Firebase Realtime Database ক্লায়েন্ট অ্যাপ রিস্টার্ট করার সময় ব্যবহারকারীর যাচাইকরণ টোকেন বজায় রাখে। আপনার অ্যাপ অফলাইন থাকাকালীন অথেন্টিকেশন টোকেনের মেয়াদ শেষ হয়ে গেলে, আপনার অ্যাপ ব্যবহারকারীকে আবার যাচাই না করা পর্যন্ত ক্লায়েন্ট লেখার অপারেশন পজ করে দেয়, অন্যথায় নিরাপত্তা সংক্রান্ত নিয়মের কারণে লেখার অপারেশন হয়ত কাজ করবে না।

ডেটা ফ্রেশ রাখা

Firebase রিয়েলটাইম ডেটাবেস সিঙ্ক করে এবং অ্যাক্টিভ শ্রোতাদের জন্য ডেটার একটি স্থানীয় কপি স্টোর করে। এছাড়াও, আপনি নির্দিষ্ট লোকেশন সিঙ্ক করে রাখতে পারবেন।

final scoresRef = FirebaseDatabase.instance.ref("scores");
scoresRef.keepSynced(true);

Firebase রিয়েলটাইম ডেটাবেস ক্লায়েন্ট অটোমেটিক এইসব লোকেশনে ডেটা ডাউনলোড করে এবং রেফারেন্সে কোনও অ্যাক্টিভ লিসেনার না থাকলেও এটি সিঙ্ক করে রাখে। আপনি নিম্নলিখিত কোডের লাইন ব্যবহার করে সিঙ্ক্রোনাইজেশন বন্ধ করতে পারবেন।

scoresRef.keepSynced(false);

ডিফল্ট হিসেবে, আগে সিঙ্ক করা ডেটার ১০ এমবি ক্যাশে করা হয়। বেশিরভাগ অ্যাপ্লিকেশনের জন্য এটি যথেষ্ট। ক্যাশে তার কনফিগার করা সাইজের থেকে বড় হয়ে গেলে, Firebase রিয়েলটাইম ডেটাবেস সেই ডেটা মুছে দেয় যা সম্প্রতি সবচেয়ে কম ব্যবহার করা হয়েছে। সিঙ্ক করে রাখা ডেটা ক্যাশে থেকে মুছে ফেলা হয় না।

অফলাইনে ডেটা কোয়েরি করা

Firebase রিয়েলটাইম ডেটাবেস অফলাইনে থাকার সময় ব্যবহারের জন্য কোয়েরি থেকে পাওয়া ডেটা স্টোর করে। অফলাইনে থাকাকালীন তৈরি করা কোয়েরির জন্য, Firebase রিয়েলটাইম ডেটাবেস আগে থেকে লোড করা ডেটার জন্য কাজ করা চালিয়ে যায়। অনুরোধ করা ডেটা লোড না হলে, Firebase রিয়েলটাইম ডেটাবেস স্থানীয় ক্যাশে থেকে ডেটা লোড করে। নেটওয়ার্ক কানেক্টিভিটি আবার উপলভ্য হলে, ডেটা লোড হয় এবং কোয়েরি দেখায়।

যেমন, এই কোড স্কোরের ডেটাবেসে শেষ চারটি আইটেমের জন্য কোয়েরি করে:

final scoresRef = FirebaseDatabase.instance.ref("scores");
scoresRef.orderByValue().limitToLast(4).onChildAdded.listen((event) {
  debugPrint("The ${event.snapshot.key} dinosaur's score is ${event.snapshot.value}.");
});

ধরে নিন যে ব্যবহারকারীর কানেকশন চলে গেছে, তিনি অফলাইন হয়ে গেছেন এবং অ্যাপ রিস্টার্ট করেছেন। অফলাইন থাকাকালীন, অ্যাপটি একই লোকেশন থেকে শেষ দুটি আইটেমের জন্য কোয়েরি করে। এই কোয়েরি শেষ দুটি আইটেম ফিরিয়ে আনবে কারণ উপরের কোয়েরিতে অ্যাপটি চারটি আইটেমই লোড করেছে।

scoresRef.orderByValue().limitToLast(2).onChildAdded.listen((event) {
  debugPrint("The ${event.snapshot.key} dinosaur's score is ${event.snapshot.value}.");
});

আগের উদাহরণে, Firebase রিয়েলটাইম ডেটাবেস ক্লায়েন্ট পারসিস্টেড ক্যাশে ব্যবহার করে, সর্বোচ্চ স্কোর করা দুটি ডাইনোসরের জন্য 'চাইল্ড যোগ করা হয়েছে' ইভেন্ট রেজ করে। কিন্তু এটি 'ভ্যালু' ইভেন্ট তৈরি করবে না, কারণ অ্যাপটি অনলাইনে থাকাকালীন কখনই সেই কোয়েরি এক্সিকিউট করেনি।

অফলাইনে থাকাকালীন অ্যাপটি শেষ ছয়টি আইটেমের জন্য অনুরোধ করলে, এটি সরাসরি চারটি ক্যাশে করা আইটেমের জন্য 'চাইল্ড যোগ করা হয়েছে' ইভেন্ট পাবে। ডিভাইসটি আবার অনলাইন হলে, Firebase Realtime Database ক্লায়েন্ট সার্ভারের সাথে সিঙ্ক করে এবং অ্যাপের জন্য শেষ দুটি 'চাইল্ড যোগ করা হয়েছে' এবং 'ভ্যালু' ইভেন্ট পায়।

অফলাইনে ট্রানজ্যাকশন ম্যানেজ করা

অ্যাপ অফলাইন থাকাকালীন কোনও ট্রানজ্যাকশন করা হলে, তা সারিতে রাখা হয়। অ্যাপটি নেটওয়ার্ক কানেক্টিভিটি ফিরে পেলে, ট্রানজ্যাকশনগুলি রিয়েলটাইম ডেটাবেস সার্ভারে পাঠানো হয়।

Firebase Realtime Database-এ অফলাইন পরিস্থিতি ও নেটওয়ার্ক কানেক্টিভিটি সংক্রান্ত সমস্যা সমাধান করার জন্য অনেক ফিচার আছে। এই গাইডের বাকি অংশ আপনার অ্যাপের ক্ষেত্রে প্রযোজ্য, আপনার পারসিস্টেন্স চালু থাকুক বা না থাকুক।

উপস্থিতি ম্যানেজ করা

রিয়েল-টাইম অ্যাপ্লিকেশনে ক্লায়েন্ট কখন কানেক্ট ও ডিসকানেক্ট করছে তা শনাক্ত করা প্রায়ই কাজে লাগে। যেমন, আপনি হয়ত কোনও ব্যবহারকারীর ক্লায়েন্ট ডিসকানেক্ট হয়ে গেলে তাকে 'অফলাইন' হিসেবে চিহ্নিত করতে চান।

Firebase ডেটাবেস ক্লায়েন্ট সহজ প্রিমিটিভ প্রদান করে যা আপনি Firebase ডেটাবেস সার্ভার থেকে ক্লায়েন্ট ডিসকানেক্ট হয়ে গেলে ডেটাবেসে লেখার জন্য ব্যবহার করতে পারেন। ক্লায়েন্ট ঠিকভাবে ডিসকানেক্ট করুক বা না করুক, এই আপডেটগুলি হয়, তাই কানেকশন ড্রপ হলে বা ক্লায়েন্ট ক্র্যাশ করলেও, ডেটা মুছে ফেলার জন্য আপনি এগুলির উপর নির্ভর করতে পারেন। ডিসকানেক্ট করার পরে, সেট করা, আপডেট করা ও সরিয়ে দেওয়া সহ সব রাইট অপারেশন করা যাবে।

onDisconnect প্রিমিটিভ ব্যবহার করে ডিসকানেক্ট হওয়ার পরে ডেটা লেখার একটি সহজ উদাহরণ এখানে দেওয়া হল:

final presenceRef = FirebaseDatabase.instance.ref("disconnectmessage");
// Write a string when this client loses connection
presenceRef.onDisconnect().set("I disconnected!");

onDisconnect কীভাবে কাজ করে

আপনি কোনও onDisconnect() অপারেশন সেট-আপ করলে, অপারেশনটি Firebase Realtime Database সার্ভারে থাকে। ব্যবহারকারী অনুরোধ করা রাইট ইভেন্টটি সম্পাদন করতে পারে কিনা তা নিশ্চিত করতে সার্ভার নিরাপত্তা পরীক্ষা করে এবং এটি অবৈধ হলে আপনার অ্যাপকে জানায়। তারপর সার্ভার কানেকশন মনিটর করে। কোনও সময় কানেকশন টাইম-আউট হয়ে গেলে বা রিয়েল-টাইম ডেটাবেস ক্লায়েন্ট দ্বারা অ্যাক্টিভভাবে বন্ধ করে দেওয়া হলে, সার্ভার দ্বিতীয়বার নিরাপত্তা চেক করে (অপারেশন এখনও বৈধ কিনা তা নিশ্চিত করতে) এবং তারপরে ইভেন্টটি চালু করে।

try {
    await presenceRef.onDisconnect().remove();
} catch (error) {
    debugPrint("Could not establish onDisconnect event: $error");
}

.cancel() কল করে onDisconnect ইভেন্ট বাতিল করা যেতে পারে:

final onDisconnectRef = presenceRef.onDisconnect();
onDisconnectRef.set("I disconnected");
// ...
// some time later when we change our minds
// ...
onDisconnectRef.cancel();

কানেকশন স্ট্যাটাস শনাক্ত করা হচ্ছে

উপস্থিতি-সম্পর্কিত অনেক ফিচারের জন্য, আপনার অ্যাপ কখন অনলাইন বা অফলাইন থাকে তা জানা উপযোগী। Firebase Realtime Database /.info/connected-এ একটি বিশেষ লোকেশন প্রদান করে যা Firebase Realtime Database ক্লায়েন্টের কানেকশন স্ট্যাটাস পরিবর্তন হওয়ার সাথে সাথে আপডেট হয়। এখানে একটি উদাহরণ দেওয়া হল:

final connectedRef = FirebaseDatabase.instance.ref(".info/connected");
connectedRef.onValue.listen((event) {
  final connected = event.snapshot.value as bool? ?? false;
  if (connected) {
    debugPrint("Connected.");
  } else {
    debugPrint("Not connected.");
  }
});

/.info/connected হল একটি বুলিয়ান ভ্যালু যা Realtime Database ক্লায়েন্টের মধ্যে সিঙ্ক করা হয় না কারণ ভ্যালুটি ক্লায়েন্টের স্ট্যাটাসের উপর নির্ভর করে। অন্যভাবে বলতে গেলে, একটি ক্লায়েন্ট /.info/connected-কে মিথ্যা হিসেবে রিড করলে, অন্য ক্লায়েন্টও যে মিথ্যা হিসেবে রিড করবে তার কোনও গ্যারেন্টি নেই।

লেটেন্সি ম্যানেজ করা

সার্ভার টাইমস্ট্যাম্প

Firebase রিয়েলটাইম ডেটাবেস সার্ভার, ডেটা হিসেবে সার্ভারে তৈরি করা টাইমস্ট্যাম্প যোগ করার একটি মেকানিজম প্রদান করে। এই ফিচার, onDisconnect-এর সাথে যুক্ত হয়ে, রিয়েল-টাইম ডেটাবেস ক্লায়েন্ট ডিসকানেক্ট হওয়ার সময় নির্ভরযোগ্যভাবে নোট করার সহজ উপায় প্রদান করে:

final userLastOnlineRef =
    FirebaseDatabase.instance.ref("users/joe/lastOnline");
userLastOnlineRef.onDisconnect().set(ServerValue.timestamp);

ক্লক স্কিউ

যদিও ServerValue.timestamp অনেক বেশি সঠিক এবং বেশিরভাগ রিড/রাইট অপারেশনের জন্য পছন্দসই, এটি মাঝে মাঝে Firebase Realtime Database-এর সার্ভারের সাপেক্ষে ক্লায়েন্টের ক্লক স্কিউ অনুমান করতে উপযোগী হতে পারে। সার্ভারের সময় অনুমান করতে, Firebase Realtime Database ক্লায়েন্টরা লোকাল রিপোর্টেড সময়ে (মিলিসেকেন্ডে epoch সময়) যে ভ্যালু যোগ করে, তা মিলিসেকেন্ডে পেতে, আপনি লোকেশন /.info/serverTimeOffset-এ কলব্যাক অ্যাটাচ করতে পারেন। মনে রাখবেন যে এই অফসেটের নির্ভুলতা নেটওয়ার্কিং লেটেন্সির দ্বারা প্রভাবিত হতে পারে এবং তাই এটি প্রাথমিকভাবে ঘড়ির সময়ে বড় (> ১ সেকেন্ড) পার্থক্য খুঁজে বের করার জন্য উপযোগী।

final offsetRef = FirebaseDatabase.instance.ref(".info/serverTimeOffset");
offsetRef.onValue.listen((event) {
  final offset = event.snapshot.value as num? ?? 0.0;
  final estimatedServerTimeMs =
      DateTime.now().millisecondsSinceEpoch + offset;
});

Sample Presence অ্যাপ

কানেকশন স্টেট মনিটর করা ও সার্ভার টাইমস্ট্যাম্পের সাথে ডিসকানেক্ট অপারেশন একত্রিত করে, আপনি ব্যবহারকারীর উপস্থিতি সংক্রান্ত সিস্টেম তৈরি করতে পারবেন। এই সিস্টেমে, প্রতিটি ব্যবহারকারী ডেটাবেসের লোকেশনে ডেটা স্টোর করে যাতে বোঝা যায় যে Realtime Database ক্লায়েন্ট অনলাইন আছে কিনা। ক্লায়েন্টরা অনলাইনে এলে এই লোকেশনকে সত্য হিসেবে সেট করে এবং ডিসকানেক্ট করলে একটি টাইমস্ট্যাম্প সেট করে। এই টাইমস্ট্যাম্প ব্যবহারকারী শেষবার কখন অনলাইন ছিলেন তা দেখায়।

মনে রাখবেন, কোনও ব্যবহারকারীকে অনলাইন হিসেবে চিহ্নিত করার আগে আপনার অ্যাপের ডিসকানেক্ট অপারেশনগুলি সারিবদ্ধ করা উচিত, যাতে ক্লায়েন্টের নেটওয়ার্ক কানেকশন সার্ভারে দুটি কমান্ড পাঠানোর আগেই হারিয়ে যাওয়ার মতো কোনও রেস কন্ডিশন এড়ানো যায়।

// Since I can connect from multiple devices, we store each connection
// instance separately any time that connectionsRef's value is null (i.e.
// has no children) I am offline.
final myConnectionsRef =
    FirebaseDatabase.instance.ref("users/joe/connections");

// Stores the timestamp of my last disconnect (the last time I was seen online)
final lastOnlineRef =
    FirebaseDatabase.instance.ref("/users/joe/lastOnline");

final connectedRef = FirebaseDatabase.instance.ref(".info/connected");
connectedRef.onValue.listen((event) {
  final connected = event.snapshot.value as bool? ?? false;
  if (connected) {
    final con = myConnectionsRef.push();

    // When this device disconnects, remove it.
    con.onDisconnect().remove();

    // When I disconnect, update the last time I was seen online.
    lastOnlineRef.onDisconnect().set(ServerValue.timestamp);

    // Add this device to my connections list.
    // This value could contain info about the device or a timestamp too.
    con.set(true);
  }
});