Google is committed to advancing racial equity for Black communities. See how.
Trang này được dịch bởi Cloud Translation API.
Switch to English

Lấy dữ liệu

Tài liệu này bao gồm những điều cơ bản về truy xuất dữ liệu và cách đặt hàng và lọc dữ liệu Firebase.

Trước khi bắt đầu

Trước khi bạn có thể sử dụng Cơ sở dữ liệu thời gian thực , bạn cần phải:

  • Đăng ký dự án Unity của bạn và cấu hình nó để sử dụng Firebase.

    • Nếu dự án Unity của bạn đã sử dụng Firebase, thì nó đã được đăng ký và định cấu hình cho Firebase.

    • Nếu bạn không có dự án Unity, bạn có thể tải xuống một ứng dụng mẫu .

  • Thêm SDK Firebase Unity (cụ thể là FirebaseDatabase.unitypackage ) vào dự án Unity của bạn.

Lưu ý rằng việc thêm Firebase vào dự án Unity của bạn bao gồm các tác vụ cả trong bảng điều khiển Firebase và trong dự án Unity mở của bạn (ví dụ: bạn tải xuống tệp cấu hình Firebase từ bảng điều khiển, sau đó chuyển chúng vào dự án Unity của bạn).

Lấy dữ liệu

Dữ liệu Firebase được truy xuất bằng một cuộc gọi một lần đến GetValueAsync () hoặc đính kèm vào một sự kiện trên tham chiếu FirebaseDatabase . Trình nghe sự kiện được gọi một lần cho trạng thái ban đầu của dữ liệu và một lần nữa bất cứ khi nào dữ liệu thay đổi.

Nhận cơ sở dữ liệu

Để đọc dữ liệu từ cơ sở dữ liệu, bạn cần một phiên bản của DatabaseReference :

using Firebase;
using Firebase.Database;
using Firebase.Unity.Editor;

public class MyScript: MonoBehaviour {
  void Start() {
    // Set up the Editor before calling into the realtime database.
    FirebaseApp.DefaultInstance.SetEditorDatabaseUrl("https://YOUR-FIREBASE-APP.firebaseio.com/");

    // Get the root reference location of the database.
    DatabaseReference reference = FirebaseDatabase.DefaultInstance.RootReference;
  }
}

Đọc dữ liệu một lần

Bạn có thể sử dụng phương thức GetValueAsync để đọc ảnh chụp nhanh nội dung tại một đường dẫn cụ thể một lần. Kết quả tác vụ sẽ chứa một ảnh chụp nhanh chứa tất cả dữ liệu tại vị trí đó, bao gồm cả dữ liệu con. Nếu không có dữ liệu, ảnh chụp nhanh được trả về là null .

    FirebaseDatabase.DefaultInstance
      .GetReference("Leaders")
      .GetValueAsync().ContinueWith(task => {
        if (task.IsFaulted) {
          // Handle the error...
        }
        else if (task.IsCompleted) {
          DataSnapshot snapshot = task.Result;
          // Do something with snapshot...
        }
      });

Nghe sự kiện

Bạn có thể thêm người nghe sự kiện để đăng ký thay đổi dữ liệu:

Biến cố Sử dụng điển hình
ValueChanged Đọc và lắng nghe những thay đổi đối với toàn bộ nội dung của một đường dẫn.
ChildAdded Truy xuất danh sách các mặt hàng hoặc lắng nghe bổ sung vào danh sách các mặt hàng. Đề xuất sử dụng với ChildChangedChildRemoved để theo dõi các thay đổi đối với danh sách.
ChildChanged Lắng nghe những thay đổi cho các mục trong một danh sách. Sử dụng với ChildAddedChildRemoved để theo dõi các thay đổi đối với danh sách.
ChildRemoved Nghe các mục bị xóa khỏi danh sách. Sử dụng với ChildAddedChildChanged để theo dõi các thay đổi đối với danh sách.
ChildMoved Lắng nghe những thay đổi về thứ tự của các mục trong một danh sách được sắp xếp. ChildMoved sự kiện ChildMoved luôn theo dõi sự kiện ChildChanged khiến thứ tự của mặt hàng thay đổi (dựa trên phương thức đặt hàng hiện tại của bạn).

Sự kiện ValueChanged

Bạn có thể sử dụng sự kiện ValueChanged để đăng ký thay đổi nội dung tại một đường dẫn cụ thể. Sự kiện này được kích hoạt một lần khi người nghe được đính kèm và một lần nữa mỗi khi dữ liệu, bao gồm cả trẻ em, thay đổi. Cuộc gọi lại sự kiện được thông qua một ảnh chụp nhanh chứa tất cả dữ liệu tại vị trí đó, bao gồm cả dữ liệu con. Nếu không có dữ liệu, ảnh chụp nhanh được trả về là null .

Ví dụ sau đây cho thấy một trò chơi lấy điểm của bảng xếp hạng từ cơ sở dữ liệu:

      FirebaseDatabase.DefaultInstance
        .GetReference("Leaders")
        .ValueChanged += HandleValueChanged;
    }

    void HandleValueChanged(object sender, ValueChangedEventArgs args) {
      if (args.DatabaseError != null) {
        Debug.LogError(args.DatabaseError.Message);
        return;
      }
      // Do something with the data in args.Snapshot
    }

ValueChangedEventArgs chứa DataSnapshot chứa dữ liệu tại vị trí đã chỉ định trong cơ sở dữ liệu tại thời điểm xảy ra sự kiện. Gọi Value trên một ảnh chụp nhanh trả về một Dictionary<string, object> đại diện cho dữ liệu. Nếu không có dữ liệu tồn tại tại vị trí, việc gọi Value sẽ trả về null .

Trong ví dụ này, args.DatabaseError cũng được kiểm tra để xem nếu đọc bị hủy. Ví dụ, một lần đọc có thể bị hủy nếu khách hàng không có quyền đọc từ vị trí cơ sở dữ liệu Firebase. DatabaseError sẽ chỉ ra lý do tại sao sự cố xảy ra.

Sau này, bạn có thể hủy đăng ký khỏi sự kiện bằng cách sử dụng bất kỳ DatabaseReference nào có cùng đường dẫn. DatabaseReference trường hợp DatabaseReference là phù du và có thể được coi là một cách để truy cập bất kỳ đường dẫn và truy vấn nào.

      FirebaseDatabase.DefaultInstance
        .GetReference("Leaders")
        .ValueChanged -= HandleValueChanged; // unsubscribe from ValueChanged.
    }

Sự kiện trẻ em

Các sự kiện con được kích hoạt để đáp ứng với các hoạt động cụ thể xảy ra với con của một nút từ một hoạt động như một đứa trẻ mới được thêm vào thông qua phương thức Push() hoặc một đứa trẻ được cập nhật thông qua phương thức UpdateChildrenAsync() . Mỗi cái này cùng nhau có thể hữu ích cho việc lắng nghe các thay đổi đối với một nút cụ thể trong cơ sở dữ liệu. Ví dụ: một trò chơi có thể sử dụng các phương pháp này cùng nhau để theo dõi hoạt động trong các nhận xét của phiên trò chơi, như được hiển thị bên dưới:

      var ref = FirebaseDatabase.DefaultInstance
      .GetReference("GameSessionComments");

      ref.ChildAdded += HandleChildAdded;
      ref.ChildChanged += HandleChildChanged;
      ref.ChildRemoved += HandleChildRemoved;
      ref.ChildMoved += HandleChildMoved;
    }

    void HandleChildAdded(object sender, ChildChangedEventArgs args) {
      if (args.DatabaseError != null) {
        Debug.LogError(args.DatabaseError.Message);
        return;
      }
      // Do something with the data in args.Snapshot
    }

    void HandleChildChanged(object sender, ChildChangedEventArgs args) {
      if (args.DatabaseError != null) {
        Debug.LogError(args.DatabaseError.Message);
        return;
      }
      // Do something with the data in args.Snapshot
    }

    void HandleChildRemoved(object sender, ChildChangedEventArgs args) {
      if (args.DatabaseError != null) {
        Debug.LogError(args.DatabaseError.Message);
        return;
      }
      // Do something with the data in args.Snapshot
    }

    void HandleChildMoved(object sender, ChildChangedEventArgs args) {
      if (args.DatabaseError != null) {
        Debug.LogError(args.DatabaseError.Message);
        return;
      }
      // Do something with the data in args.Snapshot
    }

Sự kiện ChildAdded thường được sử dụng để truy xuất danh sách các mục trong cơ sở dữ liệu Firebase. Sự kiện ChildAdded được đưa ra một lần cho mỗi đứa trẻ hiện có và sau đó mỗi lần một đứa trẻ mới được thêm vào đường dẫn đã chỉ định. Người nghe được thông qua một ảnh chụp nhanh có chứa dữ liệu của đứa trẻ mới.

Sự kiện ChildChanged được đưa ra bất cứ khi nào một nút con được sửa đổi. Điều này bao gồm bất kỳ sửa đổi nào đối với hậu duệ của nút con. Nó thường được sử dụng kết hợp với các ChildAddedChildRemoved sự kiện để đáp ứng với những thay đổi vào một danh sách các mặt hàng. Ảnh chụp nhanh được chuyển đến trình nghe sự kiện chứa dữ liệu cập nhật cho trẻ.

Sự kiện ChildRemoved được kích hoạt khi một đứa trẻ ngay lập tức bị xóa. Nó thường được sử dụng kết hợp với các ChildAddedChildChanged callbacks. Ảnh chụp nhanh được chuyển đến cuộc gọi lại sự kiện chứa dữ liệu cho đứa trẻ bị xóa.

Sự kiện ChildMoved được kích hoạt bất cứ khi nào sự kiện ChildChanged được đưa ra bởi một bản cập nhật gây ra sự sắp xếp lại của đứa trẻ. Nó được sử dụng với dữ liệu được đặt hàng với OrderByChild hoặc OrderByValue .

Sắp xếp và lọc dữ liệu

Bạn có thể sử dụng lớp Query cơ sở dữ liệu thời gian thực để truy xuất dữ liệu được sắp xếp theo khóa, theo giá trị hoặc theo giá trị của một đứa trẻ. Bạn cũng có thể lọc kết quả được sắp xếp theo một số kết quả cụ thể hoặc một loạt các khóa hoặc giá trị.

Sắp xếp dữ liệu

Để lấy dữ liệu đã sắp xếp, hãy bắt đầu bằng cách chỉ định một trong các phương thức theo thứ tự để xác định cách kết quả được sắp xếp:

phương pháp Sử dụng
OrderByChild() Sắp xếp kết quả theo giá trị của khóa con được chỉ định.
OrderByKey() Đặt kết quả bằng các phím con.
OrderByValue() Kết quả thứ tự theo giá trị con.

Bạn chỉ có thể sử dụng một phương thức theo thứ tự tại một thời điểm. Gọi một phương thức theo thứ tự nhiều lần trong cùng một truy vấn sẽ gây ra lỗi.

Ví dụ sau đây cho thấy cách bạn có thể đăng ký trên bảng xếp hạng điểm được sắp xếp theo điểm số.

      FirebaseDatabase.DefaultInstance
        .GetReference("Leaders").OrderByChild("score")
        .ValueChanged += HandleValueChanged;
    }

    void HandleValueChanged(object sender, ValueChangedEventArgs args) {
      if (args.DatabaseError != null) {
        Debug.LogError(args.DatabaseError.Message);
        return;
      }
      // Do something with the data in args.Snapshot
    }

Điều này xác định một truy vấn mà khi kết hợp với trình lắng nghe sự kiện có giá trị sẽ đồng bộ hóa máy khách với bảng thành tích trong cơ sở dữ liệu, được sắp xếp theo số điểm của mỗi mục. Bạn có thể đọc thêm về cấu trúc dữ liệu của bạn một cách hiệu quả trong Cấu trúc cơ sở dữ liệu của bạn .

Cuộc gọi đến phương thức OrderByChild() chỉ định khóa con để sắp xếp kết quả theo. Trong trường hợp này, kết quả được sắp xếp theo giá trị của giá trị "score" ở mỗi đứa trẻ. Để biết thêm thông tin về cách các loại dữ liệu khác được sắp xếp, hãy xem Cách sắp xếp dữ liệu truy vấn .

Lọc dữ liệu

Để lọc dữ liệu, bạn có thể kết hợp bất kỳ phương thức giới hạn hoặc phạm vi nào với phương thức theo thứ tự khi xây dựng truy vấn.

phương pháp Sử dụng
LimitToFirst() Đặt số lượng mục tối đa sẽ trả về từ đầu danh sách kết quả được đặt hàng.
LimitToLast() Đặt số lượng mục tối đa để trả về từ cuối danh sách kết quả được đặt hàng.
StartAt() Trả về các mục lớn hơn hoặc bằng khóa hoặc giá trị được chỉ định tùy thuộc vào phương thức đặt hàng được chọn.
EndAt() Trả về các mục nhỏ hơn hoặc bằng khóa hoặc giá trị được chỉ định tùy thuộc vào phương thức đặt hàng đã chọn.
EqualTo() Trả về các mục bằng với khóa hoặc giá trị được chỉ định tùy thuộc vào phương thức đặt hàng đã chọn.

Không giống như các phương thức theo thứ tự, bạn có thể kết hợp nhiều hàm giới hạn hoặc phạm vi. Ví dụ: bạn có thể kết hợp các phương thức StartAt()EndAt() để giới hạn kết quả trong một phạm vi giá trị được chỉ định.

Ngay cả khi chỉ có một kết quả khớp duy nhất cho truy vấn, ảnh chụp nhanh vẫn là một danh sách; nó chỉ chứa một mục duy nhất

Giới hạn số lượng kết quả

Bạn có thể sử dụng các phương thức LimitToFirst()LimitToLast() để đặt số lượng trẻ em tối đa được đồng bộ hóa cho một cuộc gọi lại nhất định. Ví dụ: nếu bạn sử dụng LimitToFirst() để đặt giới hạn 100, ban đầu bạn chỉ nhận được tối đa 100 cuộc gọi lại ChildAdded . Nếu bạn có ít hơn 100 mục được lưu trữ trong cơ sở dữ liệu Firebase của bạn, một cuộc gọi lại ChildAdded kích hoạt cho mỗi mục.

Khi các mục thay đổi, bạn nhận được các cuộc gọi lại ChildAdded cho các mục nhập truy vấn và các cuộc gọi lại ChildRemoved cho các mục thoát khỏi nó để tổng số vẫn ở mức 100.

Ví dụ: mã bên dưới trả về điểm số cao nhất từ ​​bảng xếp hạng:

      FirebaseDatabase.DefaultInstance
        .GetReference("Leaders").OrderByChild("score").LimitToLast(1)
        .ValueChanged += HandleValueChanged;
    }

    void HandleValueChanged(object sender, ValueChangedEventArgs args) {
      if (args.DatabaseError != null) {
        Debug.LogError(args.DatabaseError.Message);
        return;
      }
      // Do something with the data in args.Snapshot
    }

Lọc theo khóa hoặc giá trị

Bạn có thể sử dụng StartAt() , EndAt()EqualTo() để chọn các điểm bắt đầu, kết thúc và điểm tương đương tùy ý cho các truy vấn. Điều này có thể hữu ích cho việc phân trang dữ liệu hoặc tìm các mục có con có giá trị cụ thể.

Cách dữ liệu truy vấn được sắp xếp

Phần này giải thích cách dữ liệu được sắp xếp theo từng phương thức theo thứ tự trong lớp Query .

OrderByChild

Khi sử dụng OrderByChild() , dữ liệu chứa khóa con được chỉ định sẽ được sắp xếp như sau:

  1. Trẻ em có null trị null cho khóa con được chỉ định đến trước.
  2. Trẻ em có giá trị false cho khóa con được chỉ định tiếp theo. Nếu nhiều con có giá trị false , chúng được sắp xếp theo từ vựng theo khóa.
  3. Trẻ em với giá trị true cho khóa con được chỉ định tiếp theo. Nếu nhiều con có giá trị true , chúng được sắp xếp theo từ vựng theo khóa.
  4. Trẻ em với một giá trị số tiếp theo, được sắp xếp theo thứ tự tăng dần. Nếu nhiều con có cùng giá trị số cho nút con được chỉ định, chúng được sắp xếp theo khóa.
  5. Các chuỗi đến sau các số và được sắp xếp theo từ vựng theo thứ tự tăng dần. Nếu nhiều con có cùng giá trị cho nút con được chỉ định, chúng được sắp xếp theo từ vựng theo khóa.
  6. Các đối tượng đến sau cùng và được sắp xếp theo từ vựng theo khóa theo thứ tự tăng dần.

OrderByKey

Khi sử dụng OrderByKey() để sắp xếp dữ liệu của bạn, dữ liệu được trả về theo thứ tự tăng dần theo khóa.

  1. Trẻ em có khóa có thể được phân tích cú pháp dưới dạng số nguyên 32 bit trước, được sắp xếp theo thứ tự tăng dần.
  2. Trẻ em với giá trị chuỗi là khóa tiếp theo, được sắp xếp theo từ vựng theo thứ tự tăng dần.

OrderByValue

Khi sử dụng OrderByValue() , trẻ em được sắp xếp theo giá trị của chúng. Các tiêu chí đặt hàng giống như trong OrderByChild() , ngoại trừ giá trị của nút được sử dụng thay vì giá trị của khóa con được chỉ định.