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

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

Để minh hoạ việc dễ dàng tích hợp Firebase vào dự án Unity, chúng tôi đã tạo một trò chơi mẫu có tên là MechaHamster. Nếu bạn muốn thử thêm Firebase vào một trò chơi, hãy sử dụng phiên bản khởi đầu trên GitHub. Nếu bạn muốn có phiên bản hoàn chỉnh, hãy xem các phiên bản trong cửa hàng ứng dụng hoặc Google Play Store.

MechaHamster (GitHub)

MechaHamster (App Store)

MechaHamster (Cửa hàng Play)


Tìm hiểu thêm thông tin về cách tăng cường trò chơi bằng Firebase trên trang trò chơi Firebase của chúng tôi.

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

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

  • Cài đặt Unity 2021 LTS trở lên. Các phiên bản cũ hơn cũng có thể tương thích nhưng sẽ không được hỗ trợ tích cực.

  • (Chỉ dành cho nền tảng của Apple) Cài đặt những thành phần sau:

    • Xcode 26.2 trở lên
    • CocoaPods 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 đến iOS 15 trở lên
    • Đối với tvOS – nhắm đến tvOS 15 trở lên
    • Đối với Android – nhắm đến cấp độ API mục tiêu 24 (Nougat) trở lên

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

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

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

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

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 dự án Firebase để kết nối với dự án Unity. Hãy truy cập vào bài viết Tìm hiểu về các dự án Firebase để tìm hiểu thêm về các 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 dự án Firebase của mình.

  1. Chuyển đến bảng điều khiển Firebase.

  2. Ở giữa trang tổng quan về dự án, hãy nhấp vào biểu tượng Unity () để chạy 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 lựa chọn về 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 cùng một 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 mã nhận dạng iOS của dự án Unity vào trường Mã nhận dạng gói iOS.

    • Đối với Android – Nhập mã nhận dạng Android của dự án Unity vào trường Tên gói Android.
      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à giá trị nhận dạng nội bộ, thuận tiện và chỉ bạn mới có thể nhìn thấy trong bảng điều khiển Firebase.

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

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

  1. Lấy(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 Firebase.

    • Đối với iOS – Nhấp vào Download GoogleService-Info.plist (Tải GoogleService-Info.plist xuống).

    • Đố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ác) tệp cấu hình vào thư mục Assets.

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

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

  1. Trong bảng điều khiển Firebase, hãy nhấp vào Tải SDK Firebase Unity xuống, sau đó giải nén SDK ở một vị trí thuận tiện.

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

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

  2. Trong dự án Unity đang mở, hãy chuyển đến Assets (Tài sản) > Import Package (Nhập gói) > Custom Package (Gói tuỳ chỉnh).

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

    Đã bật Analytics

    • Thêm gói Firebase cho Google Analytics: FirebaseAnalytics.unitypackage
    • Thêm các gói cho mọi sản phẩm Firebase khác mà bạn muốn sử dụng trong ứng dụng. Ví dụ: để sử dụng Firebase Authentication và Firebase Realtime Database:
      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. Ví dụ: để sử dụng Firebase Authentication và Firebase Realtime Database:
    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 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 Dịch vụ Google Play

Một số sản phẩm trong SDK Firebase Unity cho Android yêu cầu Google Play services. Tìm hiểu xem sản phẩm nào có mối phụ thuộc này. Bạn phải cập nhật Google Play services thì mới có thể sử dụng các sản phẩm đó.

Thêm câu lệnh using và mã khởi chạy sau đây vào đầu ứng dụng của bạn. Bạn có thể kiểm tra và cập nhật Google Play services lên phiên bản bắt buộc (không bắt buộc) trước khi gọi bất kỳ phương thức 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 phần Câu hỏi thường gặp và cách khắc phục sự cố trong Unity.

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

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

  1. Thiết lập dự án Unity trên nền tảng máy tính bằng cách làm theo hướng dẫn tương tự như đối với 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 dự án Unity cho máy tính.

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

    Bạn cũng có thể chạy SDK Firebase Unity ở chế độ chỉnh sửa của Unity, cho phép sử dụng SDK này trong các trình bổ trợ của 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 dùng thực thể mặc định.

    2. Thay vào đó, hãy cung cấp một 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 về các tuỳ chọn giữa phiên bản mà Unity IDE sử dụng và phiên bản mà dự án Unity của bạn sử dụng.

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

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

Các thư viện Firebase hiện có cho thiết bị di động

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

Sản phẩm Firebase Gói Unity
AdMob Được phân phối riêng trong AdMob Trình bổ trợ Unity
Firebase AI Logic FirebaseAI.unitypackage
Analytics FirebaseAnalytics.unitypackage
App Check FirebaseAppCheck.unitypackage
Authentication FirebaseAuth.unitypackage
Cloud Firestore FirebaseFirestore.unitypackage
Cloud Functions FirebaseFunctions.unitypackage
Cloud Messaging FirebaseMessaging.unitypackage
(nên dùng) FirebaseAnalytics.unitypackage
Cloud Storage FirebaseStorage.unitypackage
Crashlytics FirebaseCrashlytics.unitypackage
(nên dùng) FirebaseAnalytics.unitypackage
Realtime Database FirebaseDatabase.unitypackage
Remote Config FirebaseRemoteConfig.unitypackage
(nên dùng) FirebaseAnalytics.unitypackage
THƯ VIỆN KHÔNG ĐƯỢC HỖ TRỢ HOẶC KHÔNG CÒN SỬ DỤNG
Dynamic Links FirebaseDynamicLinks.unitypackage
(nên dùng) FirebaseAnalytics.unitypackage

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

SDK Firebase Unity bao gồm hỗ trợ quy trình làm việc trên máy tính cho một nhóm nhỏ 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à trong các bản dựng độc lập trên máy tính chạy Windows, macOS và Linux.

Sản phẩm Firebase (máy tính) Gói Unity
Firebase AI Logic FirebaseAI.unitypackage
App Check FirebaseAppCheck.unitypackage
Authentication FirebaseAuth.unitypackage
Cloud Functions FirebaseFunctions.unitypackage
Cloud Firestore FirebaseFirestore.unitypackage
Cloud Storage FirebaseStorage.unitypackage
Realtime Database FirebaseDatabase.unitypackage
Remote Config FirebaseRemoteConfig.unitypackage

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

Các bước tiếp theo