ऑफ़लाइन क्षमताएं चालू करना

Firebase ऐप्लिकेशन तब भी काम करते हैं, जब आपका ऐप्लिकेशन कुछ समय के लिए अपना नेटवर्क खो देता हो कनेक्शन. इसके अलावा, Firebase डेटा को स्थानीय तौर पर सेव रखने के लिए टूल भी उपलब्ध कराता है. और इंतज़ार के समय को मैनेज करना.

डिस्क परसिस्टेंस

Firebase ऐप्लिकेशन, नेटवर्क में आने वाली अस्थायी रुकावटों को अपने-आप हैंडल करते हैं. कैश मेमोरी में सेव किया गया डेटा, ऑफ़लाइन रहने पर भी उपलब्ध होता है. Firebase से कोई बदलाव फिर से भेजा जाता है जब नेटवर्क कनेक्टिविटी पुनर्स्थापित हो जाती है.

जब डिस्क में सेव रहने की सुविधा चालू की जाती है, तो आपका ऐप्लिकेशन, डेटा को स्थानीय तौर पर इससे ऑफ़लाइन होने पर भी आपके ऐप्लिकेशन की स्थिति बरकरार रहेगी. भले ही, या ऑपरेटिंग सिस्टम ऐप्लिकेशन को रीस्टार्ट करता है.

कोड की सिर्फ़ एक लाइन से, डिस्क का स्थायी तौर पर रखरखाव किया जा सकता है.

FirebaseDatabase.instance.setPersistenceEnabled(true);

स्थायी व्यवहार

परसिस्टेंस चालू करने से, Firebase रीयल टाइम डेटाबेस क्लाइंट के किसी भी डेटा को जब ऑनलाइन डिस्क पर सेव रहेगा और ऑफ़लाइन उपलब्ध रहेगा, तब ही सिंक हो जाएगा, भले ही उपयोगकर्ता या ऑपरेटिंग सिस्टम ऐप्लिकेशन को रीस्टार्ट करे. इसका मतलब है कि कैश मेमोरी में सेव किए गए लोकल डेटा का इस्तेमाल करके, ऐप्लिकेशन ठीक वैसे ही काम करता है जैसे यह ऑनलाइन होता. लोकल अपडेट के लिए, लिसनर कॉलबैक ट्रिगर होते रहेंगे.

Firebase रीयल टाइम डेटाबेस क्लाइंट, अपने-आप सभी आपके ऐप्लिकेशन के ऑफ़लाइन रहने पर किए जाने वाले ऑपरेशन लिखें. परसिस्टेंस चालू होने पर, सूची में मौजूद सभी फ़ाइलों की सूची, डिस्क में भी सेव रहती है आपके लेख तब उपलब्ध होते हैं, जब किसी उपयोगकर्ता या ऑपरेटिंग सिस्टम को ऐप्लिकेशन को रीस्टार्ट करता है. ऐप्लिकेशन के फिर से इंटरनेट से कनेक्ट होने पर, ये कार्रवाइयां, Firebase रीयल टाइम डेटाबेस सर्वर को भेजी जाती हैं.

अगर आपका ऐप्लिकेशन Firebase से पुष्टि करने की सुविधा का इस्तेमाल करता है, Firebase रीयल टाइम डेटाबेस क्लाइंट, उपयोगकर्ता की पुष्टि करने की प्रोसेस को जारी रखता है सभी ऐप के लिए टोकन रीस्टार्ट होता है. अगर ऐप्लिकेशन के ऑफ़लाइन होने पर पुष्टि करने वाले टोकन की समयसीमा खत्म हो जाती है, तो क्लाइंट रुक जाता है जब तक आपका ऐप्लिकेशन उपयोगकर्ता की फिर से पुष्टि नहीं करता, तब तक कार्रवाइयां लिखें, नहीं तो सुरक्षा नियमों की वजह से हो सकता है कि राइट ऑपरेशन न हो.

डेटा को नया बनाए रखना

Firebase रीयलटाइम डेटाबेस, सक्रिय लिसनर का डेटा. इसके अलावा, आपके पास खास जगहों की जानकारी को सिंक हो सकता है.

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

Firebase रीयलटाइम डेटाबेस क्लाइंट, इन जगहों को ढूंढता है और उसे सिंक करके रखता है, भले ही संदर्भ में कोई ऐक्टिव लिसनर. आप सिंक करने की सुविधा को डालें.

scoresRef.keepSynced(false);

डिफ़ॉल्ट रूप से, पहले से सिंक किया गया 10 एमबी डेटा कैश मेमोरी में सेव किया जाता है. यह ऐसा होना चाहिए के लिए काफ़ी है. अगर कैश मेमोरी में सेव किए गए साइज़ की सीमा बढ़ जाती है, तो 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 रीयल टाइम डेटाबेस क्लाइंट सिंक होता है और दो 'बच्चे' को जोड़ देता है. और 'वैल्यू' ऐप के इवेंट हैं.

लेन-देन को ऑफ़लाइन मैनेज करना

ऐप्लिकेशन के ऑफ़लाइन होने पर किए जाने वाले सभी लेन-देन, सूची में जोड़ दिए जाते हैं. ऐप्लिकेशन के फिर से इंटरनेट से कनेक्ट होने के बाद, लेन-देन इस ईमेल पते पर भेज दिए जाते हैं रीयलटाइम डेटाबेस सर्वर.

ध्यान दें: ऐप्लिकेशन रीस्टार्ट होने पर भी लेन-देन की कोई कोशिश नहीं होती. परसिस्टेंस चालू होने पर भी, लेन-देन पूरे नहीं होते ऐप रीस्टार्ट हो जाता है. इसलिए, ऑफ़लाइन लेन-देन पर भरोसा नहीं किया जा सकता तय करें. आपको बेहतरीन अनुभव देने के लिए उपयोगकर्ता अनुभव हो, तो आपके ऐप्लिकेशन में दिखाया जाना चाहिए कि लेन-देन को अब तक आपके Firebase रीयलटाइम डेटाबेस में सेव किया है या पक्का करें कि ऐप्लिकेशन उन्हें मैन्युअल रूप से याद रखता है और ऐप्लिकेशन के बाद उन्हें फिर से लागू करता है रीस्टार्ट करने का विकल्प दिया गया है.

Firebase रीयल टाइम डेटाबेस में, ऑफ़लाइन काम करने के लिए कई सुविधाएं हैं और नेटवर्क कनेक्टिविटी की जानकारी मिलेगी. इस गाइड का बाकी हिस्सा इन पर लागू होता है इससे कोई फ़र्क़ नहीं पड़ता कि आपने परसिस्टेंस चालू किया है या नहीं.

मौजूदगी मैनेज करना

रीयलटाइम ऐप्लिकेशन में, यह पता लगाना अक्सर मददगार होता है कि क्लाइंट कब कनेक्ट और डिसकनेक्ट करने में मदद करता है. उदाहरण के लिए, आप किसी उपयोगकर्ता को 'ऑफ़लाइन' के तौर पर मार्क करना है जब उसका क्लाइंट डिसकनेक्ट हो जाता है.

Firebase डेटाबेस क्लाइंट आसान प्रिमिटिव देते हैं, जिनका इस्तेमाल इन कामों के लिए किया जा सकता है जब कोई क्लाइंट Firebase डेटाबेस से डिसकनेक्ट करता है, तो डेटाबेस में लिखें सर्वर. ये अपडेट होते हैं, चाहे क्लाइंट बिना अनुमति के डिसकनेक्ट हो जाए या नहीं, इससे कनेक्शन टूट जाने पर भी डेटा मिटाने के लिए, इन पर भरोसा किया जा सकता है या क्लाइंट क्रैश हो जाता है. लिखने से जुड़ी सभी कार्रवाइयां, जिनमें सेटिंग शामिल है, डिसकनेक्ट होने पर, उसे अपडेट किया जा सकता है और हटाया जा सकता है.

डिस्कनेक्ट होने पर डेटा लिखने का एक आसान उदाहरण यहां दिया गया है. onDisconnect प्रिमिटिव:

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

डिसकनेक्ट करने का तरीका

जब आप onDisconnect() कार्रवाई करते हैं, तो कार्रवाई Firebase रीयल टाइम डेटाबेस सर्वर पर मौजूद होती है. सर्वर, इन कामों के लिए सुरक्षा की जांच करता है: पक्का करें कि उपयोगकर्ता, अनुरोध किए गए इवेंट में बदलाव कर सकता हो. साथ ही, यह भी बताता हो कि अगर आपका ऐप्लिकेशन अमान्य है, तो उसे सही तरीके से सेव किया जा सकता है. इसके बाद सर्वर कनेक्शन की निगरानी करता है. अगर किसी भी समय कनेक्शन का समय खत्म हो जाता है या रीयलटाइम डेटाबेस क्लाइंट द्वारा सक्रिय रूप से बंद किया जाता है, तो सर्वर दूसरी बार (यह पक्का करने के लिए कि कार्रवाई अब भी मान्य है) और फिर शुरू करती है इवेंट.

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

.cancel() पर कॉल करके भी डिसकनेक्ट इवेंट को रद्द किया जा सकता है:

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

कनेक्शन की स्थिति का पता लगाया जा रहा है

मौजूदगी से जुड़ी कई सुविधाओं के लिए, यह आपके ऐप्लिकेशन के लिए उपयोगी है यह जानने के लिए कि यह कब ऑनलाइन है या ऑफ़लाइन. Firebase रीयलटाइम डेटाबेस /.info/connected पर एक विशेष स्थान देता है जो हर बार Firebase रीयल टाइम डेटाबेस क्लाइंट के कनेक्शन की स्थिति को अपडेट करने पर बदलाव. यहां एक उदाहरण दिया गया है:

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 एक बूलियन वैल्यू है, जो रीयलटाइम डेटाबेस क्लाइंट के बीच सिंक किया गया, क्योंकि वैल्यू यह है यह क्लाइंट की स्थिति पर निर्भर करता है. दूसरे शब्दों में, अगर एक क्लाइंट /.info/connected को 'गलत' के तौर पर पढ़ता है, यह नहीं है इस बात की गारंटी देता है कि कोई दूसरा क्लाइंट भी गलत मैसेज पढ़ेगा.

हैंडलिंग में लगने वाले समय का अंतर

सर्वर टाइमस्टैंप

Firebase रीयल टाइम डेटाबेस सर्वर, रिपोर्ट इंसर्ट करने का तरीका उपलब्ध कराते हैं टाइमस्टैंप की मदद से सर्वर पर डेटा के तौर पर जनरेट किया जाता है. इस सुविधा को, onDisconnect, भरोसेमंद तरीके से नोट करने का आसान तरीका देता है रीयल टाइम डेटाबेस क्लाइंट के डिसकनेक्ट होने का समय:

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

क्लॉक स्क्यू

हालांकि, ServerValue.timestamp का मतलब है कि सटीक और ज़्यादातर रीड/राइट ऑपरेशन के लिए बेहतर होता है, कभी-कभी क्लाइंट के क्लॉक स्क्यू का अनुमान लगाना मददगार हो सकता है. के हिसाब से कार्रवाई करते हैं. आपने लोगों तक पहुंचाया मुफ़्त में /.info/serverTimeOffset जगह के लिए कॉलबैक अटैच कर सकते हैं मिलीसेकंड में, Firebase रीयल टाइम डेटाबेस क्लाइंट की वैल्यू पाने के लिए अनुमान लगाने के लिए, रिपोर्ट किए गए स्थानीय समय (मिलीसेकंड में Epoch समय) में जोड़ें सर्वर समय. ध्यान दें कि इस ऑफ़सेट की सटीक जानकारी पर इन चीज़ों से असर पड़ सकता है नेटवर्किंग इंतज़ार का समय. इसलिए, खास तौर पर यह पता लगाने में मददगार होता है कि घड़ी के समय में (1 सेकंड से ज़्यादा) का अंतर हो सकता है.

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;
});

मौजूदगी ऐप्लिकेशन का नमूना

डिस्कनेक्ट करने की कार्रवाइयों को कनेक्शन की स्थिति पर नज़र रखने की सुविधा के साथ जोड़कर और सर्वर टाइमस्टैंप के साथ, आप उपयोगकर्ता की मौजूदगी का सिस्टम बना सकते हैं. इस सिस्टम में, हर उपयोगकर्ता, डेटाबेस की लोकेशन पर डेटा सेव करता है. इससे यह पता चलता है कि रीयलटाइम डेटाबेस क्लाइंट ऑनलाइन है. क्लाइंट इस जगह को 'सही' पर तब सेट करते हैं, जब वे ऑनलाइन आते हैं और उनके डिसकनेक्ट होने पर टाइमस्टैंप भी दिखता है. यह टाइमस्टैंप बताता है कि दिया गया उपयोगकर्ता पिछली बार कब ऑनलाइन हुआ था.

ध्यान दें कि आपके ऐप को उपयोगकर्ता के को ऑनलाइन मार्क किया गया हो, ताकि क्लाइंट के पैदा होने की स्थिति में होने वाली किसी भी रेस से बचने के लिए दोनों निर्देश सर्वर को भेजे जाने से पहले, इंटरनेट बंद हो जाता है.

// 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);
  }
});