Thêm Firebase vào dự án Unity

Tăng cường sức mạnh cho trò chơi Unity của bạn bằng Firebase Unity SDK của chúng tôi.

Để cho thấy rằng bạn có thể dễ dàng cắm Firebase vào dự án Unity của mình, chúng tôi đã tạo một trò chơi mẫu, MechaHamster. Nếu bạn muốn thử thêm Firebase vào trò chơi, hãy sử dụng phiên bản khởi đầu có trên GitHub. Nếu bạn muốn có một phiên bản hoàn chỉnh, hãy chọn các phiên bản trong App Store hoặc Cửa hàng Google Play.

MechaHamster (GitHub)

MechaHamster (Cửa hàng ứng dụng)

MechaHamster (Cửa hàng Play)


Tìm hiểu thêm thông tin về cách kích hoạt trò chơi của bạn bằng Firebase tại Trang trò chơi của Firebase.

Bạn đã thêm Firebase vào dự án Unity? Hãy đảm bảo rằng bạn đang sử dụng phiên bản mới nhất của Firebase Unity SDK.

Điều kiện tiên quyết

  • Cài đặt Unity 2019.1 trở lên. Các phiên bản trước đó cũng có thể tương thích nhưng sẽ không được hỗ trợ tích cực. Có cân nhắc hỗ trợ Unity 2019.1 không được dùng nữa và sẽ không còn được hỗ trợ tích cực sau sự kiện chính tiếp theo bản phát hành.

  • (chỉ dành cho nền tảng của Apple) Cài đặt như sau:

    • Xcode 13.3.1 trở lên
    • CacaoPods 1.12.0 trở lên

  • Đảm bảo rằng dự án Unity của bạn đáp ứng các yêu cầu sau:

    • Đối với iOS – nhắm mục tiêu iOS 11 trở lên
    • Đối với tvOS - nhắm mục tiêu tvOS 12 trở lên
    • Đối với Android – nhắm mục tiêu API cấp 19 (KitKat) trở lên

  • Thiết lập một thiết bị thực hoặc dùng trình mô phỏng để chạy ứng dụng.

    • Đối với các nền tảng của Apple — Thiết lập thiết bị thực hoặc sử dụng iOS hoặc tvOS trình mô phỏng.

    • Đối với Android – Trình mô phỏng phải sử dụng hình ảnh trình mô phỏng với Google Play.

Nếu bạn chưa có dự án Unity và chỉ muốn dùng thử Firebase sản phẩm, bạn có thể tải xuống một trong các mẫu bắt đầu nhanh của chúng tôi.

Bước 1: Tạo dự án Firebase

Trước khi có thể thêm Firebase vào dự án Unity, bạn cần tạo một Firebase dự án để kết nối với dự án Unity. Truy cập/ghé qua Tìm hiểu về các dự án Firebase để tìm hiểu thêm Dự án Firebase.

Bước 2: Đăng ký ứng dụng của bạn với Firebase

Bạn có thể đăng ký một hoặc nhiều ứng dụng hoặc trò chơi để kết nối với Firebase của mình dự án.

  1. Truy cập vào bảng điều khiển của Firebase.

  2. Ở giữa trang tổng quan về dự án, hãy nhấp vào biểu tượng Unity () để bắt đầu quy trình thiết lập.

    Nếu bạn đã thêm một ứng dụng vào dự án Firebase, hãy nhấp vào Thêm ứng dụng để hiển thị các tuỳ chọn nền tảng.

  3. Chọn mục tiêu bản dựng của dự án Unity mà bạn muốn đăng ký, hoặc thậm chí bạn có thể chọn đăng ký cả hai mục tiêu ngay bây giờ cùng lúc.

  4. Nhập(các) mã nhận dạng dành riêng cho nền tảng của dự án Unity.

    • Đối với iOS – Nhập ID iOS của dự án Unity vào Gói iOS Mã nhận dạng .

    • Đối với Android – Nhập mã Android của dự án Unity vào Gói Android name.
      Các thuật ngữ tên gói và mã ứng dụng thường được dùng thay thế cho nhau.

  5. (Không bắt buộc) Nhập(các) biệt hiệu dành riêng cho nền tảng của dự án Unity.
    Những biệt hiệu này là mã nhận dạng tiện lợi nội bộ và chỉ hiển thị cho bạn trong bảng điều khiển của Firebase.

  6. Nhấp vào Đăng ký ứng dụng.

Bước 3: Thêm tệp cấu hình Firebase

  1. Nhận(các) tệp cấu hình Firebase dành riêng cho nền tảng của bạn trong Quy trình thiết lập bảng điều khiển của Firebase.

    • Đối với iOS — Nhấp vào Download GoogleService-Info.plist.

    • Đối với Android — Nhấp vào Tải google-services.json xuống.

  2. Mở cửa sổ Project (Dự án) của dự án Unity, sau đó di chuyển cấu hình tệp vào thư mục Assets.

  3. Quay lại bảng điều khiển của Firebase, trong quy trình thiết lập, hãy nhấp vào Tiếp theo.

Bước 4: Thêm Firebase Unity SDK

  1. Trong bảng điều khiển của Firebase, hãy nhấp vào Tải Firebase Unity SDK xuống, sau đó giải nén SDK ở nơi nào đó thuận tiện.

    • Bạn có thể tải Firebase Unity SDK xuống lại bất cứ lúc nào.

    • Firebase Unity SDK không dành riêng cho từng nền tảng.

  2. Trong dự án Unity đang mở, hãy chuyển đến Thành phần > Nhập gói > Gói tuỳ chỉnh.

  3. Trong SDK đã giải nén, hãy chọn Firebase được hỗ trợ mà bạn muốn sử dụng ứng dụng của bạn.

    Đã bật Analytics

    • Thêm gói Firebase cho Google Analytics: FirebaseAnalytics.unitypackage
    • Thêm các gói cho bất kỳ sản phẩm Firebase nào khác mà bạn muốn sử dụng trong đó ứng dụng của bạn. Ví dụ: để sử dụng tính năng Xác thực Firebase và Cơ sở dữ liệu theo thời gian thực của Firebase:
      FirebaseAuth.unitypackage và FirebaseDatabase.unitypackage

    Chưa bật Analytics

    Thêm các gói cho sản phẩm Firebase mà bạn muốn sử dụng trong ứng dụng của mình. Ví dụ: cách sử dụng tính năng Xác thực Firebase và Cơ sở dữ liệu theo thời gian thực của Firebase:
    FirebaseAuth.unitypackage và FirebaseDatabase.unitypackage

  4. Trong cửa sổ Import Unity Package (Nhập gói Unity), hãy nhấp vào Import (Nhập).

  5. Quay lại bảng điều khiển của Firebase, trong quy trình thiết lập, hãy nhấp vào Tiếp theo.

Bước 5: Xác nhận các yêu cầu về phiên bản của Dịch vụ Google Play

SDK Unity của Firebase dành cho Android yêu cầu Dịch vụ Google Play. Dịch vụ này phải phải được cập nhật trước khi có thể sử dụng SDK.

Thêm câu lệnh using và mã khởi chạy sau đây vào đầu . Bạn có thể kiểm tra và tuỳ ý cập nhật Dịch vụ Google Play lên phiên bản mà SDK Unity của Firebase yêu cầu trước khi gọi bất kỳ phiên bản nào khác trong SDK.

using Firebase.Extensions;

Firebase.FirebaseApp.CheckAndFixDependenciesAsync().ContinueWithOnMainThread(task => {
  var dependencyStatus = task.Result;
  if (dependencyStatus == Firebase.DependencyStatus.Available) {
    // Create and hold a reference to your FirebaseApp,
    // where app is a Firebase.FirebaseApp property of your application class.
       app = Firebase.FirebaseApp.DefaultInstance;

    // Set a flag here to indicate whether Firebase is ready to use by your app.
  } else {
    UnityEngine.Debug.LogError(System.String.Format(
      "Could not resolve all Firebase dependencies: {0}", dependencyStatus));
    // Firebase Unity SDK is not safe to use here.
  }
});

Bạn đã hoàn tất! Dự án Unity của bạn đã được đăng ký và định cấu hình để sử dụng Firebase.

Tuy nhiên, nếu bạn gặp sự cố khi thiết lập, hãy truy cập vào Khắc phục sự cố Unity và Câu hỏi thường gặp.

Thiết lập quy trình làm việc trên máy tính để bàn (thử nghiệm)

Khi bạn đang tạo một trò chơi, việc thử nghiệm trò chơi trong Trình chỉnh sửa Unity và trên nền tảng máy tính trước tiên, sau đó triển khai và thử nghiệm trên thiết bị di động thiết bị sau này trong quá trình phát triển. Để hỗ trợ quy trình làm việc này, chúng tôi cung cấp một tập hợp con SDK Unity của Firebase có thể chạy trên Windows, macOS, Linux cũng như trong trình chỉnh sửa Unity.

  1. Thiết lập dự án Unity nền tảng máy tính bằng cách làm theo hướng dẫn tương tự như cho nền tảng di động (bắt đầu bằng Bước Đăng ký ứng dụng của bạn với Firebase ở trên).

  2. Chạy dự án Unity trong IDE Unity hoặc chọn để tạo Unity dự án dành cho máy tính.

  3. (Không bắt buộc) Chạy dự án Unity ở Chế độ chỉnh sửa.

    Firebase Unity SDK cũng có thể chạy được ở chế độ chỉnh sửa của Unity, cho phép sử dụng trong trình bổ trợ trình chỉnh sửa.

    1. Khi bạn tạo một FirebaseApp mà trình chỉnh sửa sử dụng, đừng sử dụng thực thể mặc định.

    2. Thay vào đó, hãy cung cấp tên riêng biệt cho lệnh gọi FirebaseApp.Create().

      Điều này rất quan trọng để tránh xung đột trong các lựa chọn giữa thực thể được sử dụng bằng IDE Unity và thực thể mà dự án Unity sử dụng.

Các sản phẩm được hỗ trợ của Firebase

Tìm hiểu thêm về thư viện Unity Firebase trong tài liệu tham khảo.

Các thư viện Firebase có sẵn dành cho thiết bị di động

Firebase Unity SDK hỗ trợ các sản phẩm sau của Firebase trên Apple và Android:

Sản phẩm Firebase Gói Unity
AdMob Được phân phối riêng trong Trình bổ trợ Unity của AdMob
Số liệu phân tích FirebaseAnalytics.unitypackage
Kiểm tra ứng dụng FirebaseAppCheck.unitypackage
Xác thực FirebaseAuth.unitypackage
Cloud Firestore FirebaseFirestore.unitypackage
Chức năng đám mây FirebaseFunctions.unitypackage
Giải pháp gửi thông báo qua đám mây FirebaseMessaging.unitypackage
(đề xuất) FirebaseAnalytics.unitypackage
Bộ nhớ trên đám mây FirebaseStorage.unitypackage
Crashlytics FirebaseCrashlytics.unitypackage
(đề xuất) FirebaseAnalytics.unitypackage
Đường liên kết động FirebaseDynamicLinks.unitypackage
(đề xuất) FirebaseAnalytics.unitypackage
Cơ sở dữ liệu theo thời gian thực FirebaseDatabase.unitypackage
Cấu hình từ xa FirebaseRemoteConfig.unitypackage
(đề xuất) FirebaseAnalytics.unitypackage

Các thư viện Firebase hiện có dành cho máy tính

Firebase Unity SDK bao gồm hỗ trợ quy trình làm việc trên máy tính để bàn cho một số sản phẩm, cho phép sử dụng một số phần nhất định của Firebase trong Trình chỉnh sửa Unity và các bản dựng độc lập dành cho máy tính trên Windows, macOS và Linux.

Sản phẩm Firebase (máy tính) Gói Unity
Kiểm tra ứng dụng FirebaseAppCheck.unitypackage
Xác thực FirebaseAuth.unitypackage
Chức năng đám mây FirebaseFunctions.unitypackage
Cloud Firestore FirebaseFirestore.unitypackage
Bộ nhớ trên đám mây FirebaseStorage.unitypackage
Cơ sở dữ liệu theo thời gian thực FirebaseDatabase.unitypackage
Cấu hình từ xa FirebaseRemoteConfig.unitypackage

Firebase cung cấp các thư viện máy tính còn lại dưới dạng mã giả lập (không hoạt động) Một số cách triển khai để thuận tiện khi xây dựng ứng dụng cho Windows, macOS và Linux. Do đó, bạn không cần biên dịch có điều kiện mã để nhắm mục tiêu máy tính.

Các bước tiếp theo