Bật các chức năng ngoại tuyến trên Android

Hành vi liên tục

Bằng cách bật tính năng ổn định, mọi dữ liệu mà ứng dụng Firebase Realtime Database sẽ đồng bộ hoá khi trực tuyến sẽ được lưu vào ổ đĩa và có sẵn khi không có mạng, ngay cả khi người dùng hoặc hệ điều hành khởi động lại ứng dụng. Điều này có nghĩa là ứng dụng của bạn hoạt động như khi trực tuyến bằng cách sử dụng dữ liệu cục bộ được lưu trữ trong bộ nhớ đệm. Lệnh gọi lại trình nghe sẽ tiếp tục kích hoạt cho các bản cập nhật cục bộ.

Ứng dụng Firebase Realtime Database tự động giữ một hàng đợi gồm tất cả các thao tác ghi được thực hiện khi ứng dụng của bạn không có kết nối mạng. Khi bạn bật chế độ liên tục, hàng đợi này cũng được lưu vào ổ đĩa để tất cả các hoạt động ghi của bạn đều có sẵn khi người dùng hoặc hệ điều hành khởi động lại ứng dụng. Khi ứng dụng khôi phục kết nối, tất cả các thao tác sẽ được gửi đến máy chủ Firebase Realtime Database.

Nếu ứng dụng của bạn sử dụng Xác thực Firebase, thì ứng dụng Firebase Realtime Database sẽ duy trì mã thông báo xác thực của người dùng trong quá trình khởi động lại ứng dụng. Nếu mã thông báo xác thực hết hạn trong khi ứng dụng của bạn không có mạng, thì ứng dụng sẽ tạm dừng các thao tác ghi cho đến khi xác thực lại người dùng, nếu không, các thao tác ghi có thể không thành công do các quy tắc bảo mật.

Giữ dữ liệu mới

Firebase Realtime Database đồng bộ hoá và lưu trữ bản sao cục bộ của dữ liệu cho trình nghe đang hoạt động. Ngoài ra, bạn có thể đồng bộ hoá các vị trí cụ thể.

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

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

Ứng dụng Firebase Realtime Database tự động tải dữ liệu xuống tại các vị trí này và đồng bộ hoá dữ liệu ngay cả khi tệp tham chiếu không có trình nghe nào đang hoạt động. Bạn có thể tắt tính năng đồng bộ hoá bằng dòng mã sau.

scoresRef.keepSynced(false)
OfflineActivity.kt

scoresRef.keepSynced(false);
OfflineActivity.java

Theo mặc định, 10 MB dữ liệu đã đồng bộ hoá trước đó sẽ được lưu vào bộ nhớ đệm. Điều này là đủ cho hầu hết các ứng dụng. Nếu bộ nhớ đệm vượt quá kích thước đã định cấu hình, Firebase Realtime Database sẽ xoá dữ liệu được sử dụng ít nhất gần đây. Dữ liệu được đồng bộ hoá sẽ không bị xoá khỏi bộ nhớ đệm.

Truy vấn dữ liệu ngoại tuyến

Firebase Realtime Database lưu trữ dữ liệu được trả về từ một truy vấn để sử dụng khi không có mạng. Đối với các truy vấn được tạo khi không có mạng, Firebase Realtime Database sẽ tiếp tục hoạt động cho dữ liệu đã tải trước đó. Nếu dữ liệu đã yêu cầu chưa được tải, Firebase Realtime Database sẽ tải dữ liệu từ bộ nhớ đệm cục bộ. Khi có kết nối mạng trở lại, dữ liệu sẽ tải và phản ánh truy vấn.

Ví dụ: mã này truy vấn bốn mục gần đây nhất trong Firebase Realtime Database điểm số

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

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

Giả sử người dùng mất kết nối, chuyển sang chế độ ngoại tuyến và khởi động lại ứng dụng. Mặc dù vẫn ở chế độ ngoại tuyến, nhưng ứng dụng sẽ truy vấn hai mục gần đây nhất từ cùng một vị trí. Truy vấn này sẽ trả về thành công hai mục cuối cùng vì ứng dụng đã tải tất cả 4 mục trong truy vấn ở trên.

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

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

Trong ví dụ trước, ứng dụng Firebase Realtime Database sẽ tạo sự kiện "thêm con" cho hai con khủng long có điểm số cao nhất bằng cách sử dụng bộ nhớ đệm ổn định. Tuy nhiên, ứng dụng sẽ không tạo sự kiện "value" (giá trị) vì ứng dụng chưa bao giờ thực thi truy vấn đó khi có kết nối mạng.

Nếu yêu cầu 6 mục gần đây nhất khi không có mạng, ứng dụng sẽ nhận được các sự kiện "thêm phần tử con" cho 4 mục được lưu vào bộ nhớ đệm ngay lập tức. Khi thiết bị kết nối lại mạng, ứng dụng khách Firebase Realtime Database sẽ đồng bộ hoá với máy chủ và nhận được hai sự kiện "thêm thành phần con" và "giá trị" cuối cùng cho ứng dụng.

Xử lý giao dịch ngoại tuyến

Mọi giao dịch được thực hiện khi ứng dụng không có mạng đều được đưa vào hàng đợi. Sau khi ứng dụng khôi phục kết nối mạng, các giao dịch sẽ được gửi đến máy chủ Realtime Database.

Cách hoạt động của onDisconnect

Khi bạn thiết lập một thao tác onDisconnect(), thao tác đó sẽ nằm trên máy chủ Firebase Realtime Database. Máy chủ kiểm tra bảo mật để đảm bảo người dùng có thể thực hiện sự kiện ghi đã yêu cầu và thông báo cho ứng dụng của bạn nếu sự kiện đó không hợp lệ. Sau đó, máy chủ sẽ giám sát kết nối. Nếu tại bất kỳ thời điểm nào, kết nối hết thời gian chờ hoặc bị ứng dụng Realtime Database chủ động đóng, thì máy chủ sẽ kiểm tra bảo mật lần thứ hai (để đảm bảo thao tác vẫn hợp lệ) rồi gọi sự kiện.

Ứng dụng của bạn có thể sử dụng lệnh gọi lại trên thao tác ghi để đảm bảo onDisconnect được đính kèm chính xác:

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

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

Bạn cũng có thể huỷ sự kiện onDisconnect bằng cách gọi .cancel():

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

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

Dấu thời gian của máy chủ

Máy chủ Firebase Realtime Database cung cấp cơ chế chèn dấu thời gian được tạo trên máy chủ dưới dạng dữ liệu. Tính năng này, kết hợp với onDisconnect, cung cấp một cách dễ dàng để ghi lại đáng tin cậy thời điểm ứng dụng Realtime Database bị ngắt kết nối:

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

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

Độ lệch xung nhịp

Mặc dù firebase.database.ServerValue.TIMESTAMP chính xác hơn nhiều và được ưu tiên cho hầu hết các thao tác đọc/ghi, nhưng đôi khi bạn có thể sử dụng để ước tính độ lệch đồng hồ của ứng dụng so với máy chủ của Firebase Realtime Database. Bạn có thể đính kèm một lệnh gọi lại vào vị trí /.info/serverTimeOffset để lấy giá trị (tính bằng mili giây) mà ứng dụng Firebase Realtime Database thêm vào thời gian được báo cáo cục bộ (thời gian bắt đầu của hệ thống tính bằng mili giây) để ước tính thời gian máy chủ. Xin lưu ý rằng độ chính xác của độ lệch này có thể chịu ảnh hưởng của độ trễ mạng, vì vậy, độ lệch này chủ yếu hữu ích để phát hiện sự chênh lệch lớn (> 1 giây) về thời gian đồng hồ.

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

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