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

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

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

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

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

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

Kotlin+KTX

Firebase.database.setPersistenceEnabled(true)
OfflineActivity.kt

Java

FirebaseDatabase.getInstance().setPersistenceEnabled(true);
OfflineActivity.java

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

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

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

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

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

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

Kotlin+KTX

val scoresRef = Firebase.database.getReference("scores")
scoresRef.keepSynced(true)
OfflineActivity.kt

Java

DatabaseReference scoresRef = FirebaseDatabase.getInstance().getReference("scores");
scoresRef.keepSynced(true);
OfflineActivity.java

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

Kotlin+KTX

scoresRef.keepSynced(false)
OfflineActivity.kt

Java

scoresRef.keepSynced(false);
OfflineActivity.java

डिफ़ॉल्ट रूप से, पहले से सिंक किया गया 10 एमबी डेटा कैश मेमोरी में सेव किया जाता है. इसे ऐसा होना चाहिए के लिए काफ़ी है. अगर कैश मेमोरी में सेव किए गए साइज़ की सीमा बढ़ जाती है, तो Firebase Realtime Database उस डेटा को पूरी तरह मिटाता है जिसका इस्तेमाल हाल ही में किया गया है. सिंक में रखा गया डेटा, कैश मेमोरी से पूरी तरह नहीं मिटाया जाता.

ऑफ़लाइन होने पर डेटा की क्वेरी की जा रही है

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

उदाहरण के लिए, यह कोड पिछले इवेंट के लिए क्वेरी करता है स्कोर के Firebase Realtime Database में चार आइटम

Kotlin+KTX

val scoresRef = Firebase.database.getReference("scores")
scoresRef.orderByValue().limitToLast(4).addChildEventListener(object : ChildEventListener {
    override fun onChildAdded(snapshot: DataSnapshot, previousChild: String?) {
        Log.d(TAG, "The ${snapshot.key} dinosaur's score is ${snapshot.value}")
    }

    // ...
})
OfflineActivity.kt

Java

DatabaseReference scoresRef = FirebaseDatabase.getInstance().getReference("scores");
scoresRef.orderByValue().limitToLast(4).addChildEventListener(new ChildEventListener() {
    @Override
    public void onChildAdded(@NonNull DataSnapshot snapshot, String previousChild) {
        Log.d(TAG, "The " + snapshot.getKey() + " dinosaur's score is " + snapshot.getValue());
    }

    // ...
});
OfflineActivity.java

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

Kotlin+KTX

scoresRef.orderByValue().limitToLast(2).addChildEventListener(object : ChildEventListener {
    override fun onChildAdded(snapshot: DataSnapshot, previousChild: String?) {
        Log.d(TAG, "The ${snapshot.key} dinosaur's score is ${snapshot.value}")
    }

    // ...
})
OfflineActivity.kt

Java

scoresRef.orderByValue().limitToLast(2).addChildEventListener(new ChildEventListener() {
    @Override
    public void onChildAdded(@NonNull DataSnapshot snapshot, String previousChild) {
        Log.d(TAG, "The " + snapshot.getKey() + " dinosaur's score is " + snapshot.getValue());
    }

    // ...
});
OfflineActivity.java

ऊपर दिए गए उदाहरण में, Firebase Realtime Database क्लाइंट पैसे बढ़ाता है 'बच्चे को जोड़ा गया' सबसे ज़्यादा स्कोर करने वाले दो डायनासोर की संख्या को बढ़ाने के लिए, सेव की गई कैश मेमोरी. लेकिन इससे कोई 'वैल्यू' नहीं बढ़ेगी इवेंट होना चाहिए, क्योंकि ऐप्लिकेशन में ने ऑनलाइन होने पर उस क्वेरी को कभी एक्ज़ीक्यूट नहीं किया.

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

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

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

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

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

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

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

Kotlin+KTX

val presenceRef = Firebase.database.getReference("disconnectmessage")
// Write a string when this client loses connection
presenceRef.onDisconnect().setValue("I disconnected!")
OfflineActivity.kt

Java

DatabaseReference presenceRef = FirebaseDatabase.getInstance().getReference("disconnectmessage");
// Write a string when this client loses connection
presenceRef.onDisconnect().setValue("I disconnected!");
OfflineActivity.java

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

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

लिखने की कार्रवाई पर आपका ऐप्लिकेशन कॉलबैक का इस्तेमाल कर सकता है यह पक्का करने के लिए कि onDisconnect सही तरीके से अटैच किया गया था:

Kotlin+KTX

presenceRef.onDisconnect().removeValue { error, reference ->
    error?.let {
        Log.d(TAG, "could not establish onDisconnect event: ${error.message}")
    }
}
OfflineActivity.kt

Java

presenceRef.onDisconnect().removeValue(new DatabaseReference.CompletionListener() {
    @Override
    public void onComplete(DatabaseError error, @NonNull DatabaseReference reference) {
        if (error != null) {
            Log.d(TAG, "could not establish onDisconnect event:" + error.getMessage());
        }
    }
});
OfflineActivity.java

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

Kotlin+KTX

val onDisconnectRef = presenceRef.onDisconnect()
onDisconnectRef.setValue("I disconnected")
// ...
// some time later when we change our minds
// ...
onDisconnectRef.cancel()
OfflineActivity.kt

Java

OnDisconnect onDisconnectRef = presenceRef.onDisconnect();
onDisconnectRef.setValue("I disconnected");
// ...
// some time later when we change our minds
// ...
onDisconnectRef.cancel();
OfflineActivity.java

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

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

Kotlin+KTX

val connectedRef = Firebase.database.getReference(".info/connected")
connectedRef.addValueEventListener(object : ValueEventListener {
    override fun onDataChange(snapshot: DataSnapshot) {
        val connected = snapshot.getValue(Boolean::class.java) ?: false
        if (connected) {
            Log.d(TAG, "connected")
        } else {
            Log.d(TAG, "not connected")
        }
    }

    override fun onCancelled(error: DatabaseError) {
        Log.w(TAG, "Listener was cancelled")
    }
})
OfflineActivity.kt

Java

DatabaseReference connectedRef = FirebaseDatabase.getInstance().getReference(".info/connected");
connectedRef.addValueEventListener(new ValueEventListener() {
    @Override
    public void onDataChange(@NonNull DataSnapshot snapshot) {
        boolean connected = snapshot.getValue(Boolean.class);
        if (connected) {
            Log.d(TAG, "connected");
        } else {
            Log.d(TAG, "not connected");
        }
    }

    @Override
    public void onCancelled(@NonNull DatabaseError error) {
        Log.w(TAG, "Listener was cancelled");
    }
});
OfflineActivity.java

/.info/connected एक बूलियन वैल्यू है, जो Realtime Database क्लाइंट के बीच सिंक किया गया, क्योंकि वैल्यू यह क्लाइंट की स्थिति पर निर्भर करता है. दूसरे शब्दों में, अगर एक क्लाइंट /.info/connected को 'गलत' के तौर पर पढ़ता है, यह नहीं है इस बात की गारंटी देता है कि कोई दूसरा क्लाइंट भी गलत मैसेज पढ़ेगा.

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

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

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

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

Kotlin+KTX

val userLastOnlineRef = Firebase.database.getReference("users/joe/lastOnline")
userLastOnlineRef.onDisconnect().setValue(ServerValue.TIMESTAMP)
OfflineActivity.kt

Java

DatabaseReference userLastOnlineRef = FirebaseDatabase.getInstance().getReference("users/joe/lastOnline");
userLastOnlineRef.onDisconnect().setValue(ServerValue.TIMESTAMP);
OfflineActivity.java

क्लॉक स्क्यू

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

Kotlin+KTX

val offsetRef = Firebase.database.getReference(".info/serverTimeOffset")
offsetRef.addValueEventListener(object : ValueEventListener {
    override fun onDataChange(snapshot: DataSnapshot) {
        val offset = snapshot.getValue(Double::class.java) ?: 0.0
        val estimatedServerTimeMs = System.currentTimeMillis() + offset
    }

    override fun onCancelled(error: DatabaseError) {
        Log.w(TAG, "Listener was cancelled")
    }
})
OfflineActivity.kt

Java

DatabaseReference offsetRef = FirebaseDatabase.getInstance().getReference(".info/serverTimeOffset");
offsetRef.addValueEventListener(new ValueEventListener() {
    @Override
    public void onDataChange(@NonNull DataSnapshot snapshot) {
        double offset = snapshot.getValue(Double.class);
        double estimatedServerTimeMs = System.currentTimeMillis() + offset;
    }

    @Override
    public void onCancelled(@NonNull DatabaseError error) {
        Log.w(TAG, "Listener was cancelled");
    }
});
OfflineActivity.java

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

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

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

यहां उपयोगकर्ता की मौजूदगी का एक सामान्य सिस्टम दिया गया है:

Kotlin+KTX

// 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
val database = Firebase.database
val myConnectionsRef = database.getReference("users/joe/connections")

// Stores the timestamp of my last disconnect (the last time I was seen online)
val lastOnlineRef = database.getReference("/users/joe/lastOnline")

val connectedRef = database.getReference(".info/connected")
connectedRef.addValueEventListener(object : ValueEventListener {
    override fun onDataChange(snapshot: DataSnapshot) {
        val connected = snapshot.getValue<Boolean>() ?: false
        if (connected) {
            val con = myConnectionsRef.push()

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

            // When I disconnect, update the last time I was seen online
            lastOnlineRef.onDisconnect().setValue(ServerValue.TIMESTAMP)

            // Add this device to my connections list
            // this value could contain info about the device or a timestamp too
            con.setValue(java.lang.Boolean.TRUE)
        }
    }

    override fun onCancelled(error: DatabaseError) {
        Log.w(TAG, "Listener was cancelled at .info/connected")
    }
})
OfflineActivity.kt

Java

// 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 FirebaseDatabase database = FirebaseDatabase.getInstance();
final DatabaseReference myConnectionsRef = database.getReference("users/joe/connections");

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

final DatabaseReference connectedRef = database.getReference(".info/connected");
connectedRef.addValueEventListener(new ValueEventListener() {
    @Override
    public void onDataChange(@NonNull DataSnapshot snapshot) {
        boolean connected = snapshot.getValue(Boolean.class);
        if (connected) {
            DatabaseReference con = myConnectionsRef.push();

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

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

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

    @Override
    public void onCancelled(@NonNull DatabaseError error) {
        Log.w(TAG, "Listener was cancelled at .info/connected");
    }
});
OfflineActivity.java