Firestore Enterprise edition with MongoDB compatibility is now available! Learn more.

Trang này được dịch bởi Cloud Translation API.

Xây dựng sự hiện diện trong Cloud Firestore

Tuỳ thuộc vào loại ứng dụng mà bạn đang tạo, bạn có thể thấy việc phát hiện người dùng hoặc thiết bị nào đang hoạt động trực tuyến là hữu ích (còn được gọi là phát hiện "trạng thái hiện diện").

Ví dụ: nếu đang tạo một ứng dụng như mạng xã hội hoặc triển khai một nhóm thiết bị IoT, bạn có thể dùng thông tin này để hiển thị danh sách bạn bè đang trực tuyến và có thể trò chuyện, hoặc sắp xếp các thiết bị IoT theo "lần truy cập gần đây nhất".

Cloud Firestore không hỗ trợ trạng thái hiện diện một cách tự nhiên, nhưng bạn có thể tận dụng các sản phẩm khác của Firebase để xây dựng một hệ thống trạng thái hiện diện.

Giải pháp: Cloud Functions với Cơ sở dữ liệu theo thời gian thực

Để kết nối Cloud Firestore với tính năng hiện diện gốc của Cơ sở dữ liệu theo thời gian thực của Firebase, hãy dùng Cloud Functions.

Sử dụng Realtime Database để báo cáo trạng thái kết nối, sau đó dùng Cloud Functions để phản chiếu dữ liệu đó vào Cloud Firestore.

Sử dụng tính năng nhận biết sự có mặt trong Cơ sở dữ liệu theo thời gian thực

Trước tiên, hãy xem xét cách hoạt động của một hệ thống trạng thái hoạt động truyền thống trong Realtime Database.

Web

// Fetch the current user's ID from Firebase Authentication.
var uid = firebase.auth().currentUser.uid;

// Create a reference to this user's specific status node.
// This is where we will store data about being online/offline.
var userStatusDatabaseRef = firebase.database().ref('/status/' + uid);

// We'll create two constants which we will write to 
// the Realtime database when this device is offline
// or online.
var isOfflineForDatabase = {
    state: 'offline',
    last_changed: firebase.database.ServerValue.TIMESTAMP,
};

var isOnlineForDatabase = {
    state: 'online',
    last_changed: firebase.database.ServerValue.TIMESTAMP,
};

// Create a reference to the special '.info/connected' path in 
// Realtime Database. This path returns `true` when connected
// and `false` when disconnected.
firebase.database().ref('.info/connected').on('value', function(snapshot) {
    // If we're not currently connected, don't do anything.
    if (snapshot.val() == false) {
        return;
    };

    // If we are currently connected, then use the 'onDisconnect()' 
    // method to add a set which will only trigger once this 
    // client has disconnected by closing the app, 
    // losing internet, or any other means.
    userStatusDatabaseRef.onDisconnect().set(isOfflineForDatabase).then(function() {
        // The promise returned from .onDisconnect().set() will
        // resolve as soon as the server acknowledges the onDisconnect() 
        // request, NOT once we've actually disconnected:
        // https://firebase.google.com/docs/reference/js/firebase.database.OnDisconnect

        // We can now safely set ourselves as 'online' knowing that the
        // server will mark us as offline once we lose connection.
        userStatusDatabaseRef.set(isOnlineForDatabase);
    });
});index.js

Ví dụ này là một hệ thống trạng thái hoàn chỉnh của Cơ sở dữ liệu theo thời gian thực. Nó xử lý nhiều trường hợp ngắt kết nối, sự cố, v.v.

Đang kết nối với Cloud Firestore

Để triển khai một giải pháp tương tự trong Cloud Firestore, hãy sử dụng cùng một mã Cơ sở dữ liệu theo thời gian thực, sau đó sử dụng Cloud Functions để giữ cho Cơ sở dữ liệu theo thời gian thực và Cloud Firestore luôn đồng bộ hoá.

Nếu bạn chưa thực hiện, hãy thêm Realtime Database vào dự án của bạn và thêm giải pháp hiện diện ở trên.

Tiếp theo, bạn sẽ đồng bộ hoá trạng thái hiện diện với Cloud Firestore thông qua các phương thức sau:

Cục bộ, vào bộ nhớ đệm Cloud Firestore của thiết bị không kết nối mạng để ứng dụng biết rằng thiết bị không kết nối mạng.
Trên toàn cầu, sử dụng một Cloud Function để tất cả các thiết bị khác truy cập vào Cloud Firestore đều biết thiết bị cụ thể này đang ở trạng thái ngoại tuyến.

Đang cập nhật bộ nhớ đệm cục bộ của Cloud Firestore

Hãy xem những thay đổi cần thiết để giải quyết vấn đề đầu tiên – cập nhật bộ nhớ đệm cục bộ của Cloud Firestore.

Web

// ...
var userStatusFirestoreRef = firebase.firestore().doc('/status/' + uid);

// Firestore uses a different server timestamp value, so we'll 
// create two more constants for Firestore state.
var isOfflineForFirestore = {
    state: 'offline',
    last_changed: firebase.firestore.FieldValue.serverTimestamp(),
};

var isOnlineForFirestore = {
    state: 'online',
    last_changed: firebase.firestore.FieldValue.serverTimestamp(),
};

firebase.database().ref('.info/connected').on('value', function(snapshot) {
    if (snapshot.val() == false) {
        // Instead of simply returning, we'll also set Firestore's state
        // to 'offline'. This ensures that our Firestore cache is aware
        // of the switch to 'offline.'
        userStatusFirestoreRef.set(isOfflineForFirestore);
        return;
    };

    userStatusDatabaseRef.onDisconnect().set(isOfflineForDatabase).then(function() {
        userStatusDatabaseRef.set(isOnlineForDatabase);

        // We'll also add Firestore set here for when we come online.
        userStatusFirestoreRef.set(isOnlineForFirestore);
    });
});index.js

Với những thay đổi này, giờ đây chúng tôi đã đảm bảo rằng trạng thái local Cloud Firestore sẽ luôn phản ánh trạng thái trực tuyến/ngoại tuyến của thiết bị. Điều này có nghĩa là bạn có thể theo dõi tài liệu /status/{uid} và sử dụng dữ liệu để thay đổi giao diện người dùng nhằm phản ánh trạng thái kết nối.

Web

userStatusFirestoreRef.onSnapshot(function(doc) {
    var isOnline = doc.data().state == 'online';
    // ... use isOnline
});index.js

Đang cập nhật Cloud Firestore trên toàn cầu

Mặc dù ứng dụng của chúng tôi báo cáo chính xác trạng thái hiện diện trực tuyến cho chính ứng dụng, nhưng trạng thái này sẽ không chính xác trong các ứng dụng Cloud Firestore khác vì trạng thái "ngoại tuyến" của chúng tôi chỉ được ghi cục bộ và sẽ không được đồng bộ hoá khi kết nối được khôi phục. Để khắc phục vấn đề này, chúng ta sẽ sử dụng một Cloud Function theo dõi đường dẫn status/{uid} trong Cơ sở dữ liệu theo thời gian thực. Khi giá trị Realtime Database thay đổi, giá trị này sẽ đồng bộ hoá với Cloud Firestore để tất cả trạng thái của người dùng đều chính xác.

Node.js

firebase.firestore().collection('status')
    .where('state', '==', 'online')
    .onSnapshot(function(snapshot) {
        snapshot.docChanges().forEach(function(change) {
            if (change.type === 'added') {
                var msg = 'User ' + change.doc.id + ' is online.';
                console.log(msg);
                // ...
            }
            if (change.type === 'removed') {
                var msg = 'User ' + change.doc.id + ' is offline.';
                console.log(msg);
                // ...
            }
        });
    });index.js

Sau khi triển khai hàm này, bạn sẽ có một hệ thống hiện diện hoàn chỉnh đang chạy với Cloud Firestore. Dưới đây là ví dụ về việc giám sát mọi người dùng truy cập hoặc rời mạng bằng cách sử dụng truy vấn where().

Web

firebase.firestore().collection('status')
    .where('state', '==', 'online')
    .onSnapshot(function(snapshot) {
        snapshot.docChanges().forEach(function(change) {
            if (change.type === 'added') {
                var msg = 'User ' + change.doc.id + ' is online.';
                console.log(msg);
                // ...
            }
            if (change.type === 'removed') {
                var msg = 'User ' + change.doc.id + ' is offline.';
                console.log(msg);
                // ...
            }
        });
    });index.js

Các điểm hạn chế

Việc sử dụng Cơ sở dữ liệu theo thời gian thực để thêm trạng thái hiện diện vào ứng dụng Cloud Firestore của bạn có thể mở rộng và hiệu quả nhưng có một số hạn chế:

Chống rung – khi lắng nghe các thay đổi theo thời gian thực trong Cloud Firestore, giải pháp này có thể kích hoạt nhiều thay đổi. Nếu những thay đổi này kích hoạt nhiều sự kiện hơn bạn muốn, hãy loại bỏ các sự kiện Cloud Firestore trùng lặp theo cách thủ công.
Khả năng kết nối – chế độ triển khai này đo lường khả năng kết nối với Realtime Database, chứ không phải với Cloud Firestore. Nếu trạng thái kết nối với từng cơ sở dữ liệu không giống nhau, thì giải pháp này có thể báo cáo trạng thái hiện diện không chính xác.
Android – trên Android, Cơ sở dữ liệu theo thời gian thực sẽ ngắt kết nối với phần phụ trợ sau 60 giây không hoạt động. Không hoạt động có nghĩa là không có trình nghe đang mở hoặc các thao tác đang chờ xử lý. Để duy trì kết nối, bạn nên thêm một trình nghe sự kiện giá trị vào một đường dẫn ngoài .info/connected. Ví dụ: bạn có thể thực hiện FirebaseDatabase.getInstance().getReference((new Date()).toString()).keepSynced() khi bắt đầu mỗi phiên. Để biết thêm thông tin, hãy xem phần Phát hiện trạng thái kết nối.