本頁面由 Cloud Translation API 翻譯而成。

啟用離線功能

即使應用程式暫時遺失網路，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 MB。這應該是可滿足大多數應用程式的需求如果快取超過設定的大小 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 即時資料庫用戶端與伺服器通訊，並得到最後兩個「新增子項」和「value」事件。

離線處理交易

凡是在應用程式離線時執行的交易，都會排入佇列。應用程式重新連上網路後，系統就會將交易傳送至即時資料庫伺服器

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 為 false，這不會確保個別用戶端也會讀取 false。

處理延遲時間

伺服器時間戳記

Firebase 即時資料庫伺服器提供插入在伺服器上產生的資料時間戳記 (以資料形式呈現)。這項功能結合了 onDisconnect，可讓您輕鬆可靠地記錄即時資料庫用戶端中斷連線的時間：

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

時鐘偏差

ServerValue.timestamp 不僅止於此準確且適合大多數讀取/寫入作業這也有助於估算客戶的時鐘偏差對應至 Firebase 即時資料庫伺服器個人中心可將回呼附加至位置 /.info/serverTimeOffset 以便取得 Firebase 即時資料庫用戶端的值 (以毫秒為單位) 與當地回報時間相加 (以毫秒為單位)，進行估算伺服器時間請注意，位移的精確度會受到因此非常適合用於探索網路延遲時鐘時間出現明顯差異 (> 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;
});

範例在家狀態應用程式

結合連線作業與連線狀態監控您可以建構使用者連接系統。在這個系統中每位使用者將資料儲存在資料庫位置，指出即時資料庫用戶端已連線。用戶端在下列情況會將這個位置設為 true 以及連線中斷時的時間戳記。這個時間戳記表示特定使用者上次上線的時間。

請注意，應用程式應在使用者中斷連線前，將中斷作業排入佇列線上標記，以避免客戶的在能將兩個指令傳送至伺服器之前，網路連線中斷。

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