Join us for Firebase Summit on November 10, 2021. Tune in to learn how Firebase can help you accelerate app development, release with confidence, and scale with ease. Register

Thêm Firebase vào dự án Unity của bạn

Sức mạnh lên của bạn Unity trò chơi với căn cứ hỏa lực Unity SDK của chúng tôi.

Để hiển thị cách dễ dàng là để cắm căn cứ hỏa lực vào dự án Unity của bạn, chúng tôi thực hiện một trò chơi mẫu, MechaHamster, mà bạn có thể tải về từ GitHub, App Store,Cửa hàng Google Play.

MechaHamster (GitHub)

MechaHamster (App Store)

MechaHamster (Cửa hàng Play)


Tìm hiểu thêm thông tin về powering lên trò chơi của bạn với căn cứ hỏa lực tại của chúng tôi trang trò chơi căn cứ hỏa lực .

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

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

  • Cài đặt Unity 2017.4 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.

  • (iOS chỉ) Cài đặt như sau:

    • Xcode 9.4.1 trở lên
    • CocoaPods 1.10.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:

    • For iOS - nhắm vào iOS 10 hoặc cao hơn
    • Đối với Android - mục tiêu cấp API 16 (Jelly Bean) hoặc cao hơn

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

    • For iOS - Thiết lập một thiết bị iOS vật lý hoặc sử dụng các mô phỏng iOS.

    • Đối với Android - Emulators phải sử dụng một hình ảnh giả lập với Google Play.

Nếu bạn chưa có một dự án Unity và chỉ muốn thử ra một sản phẩm căn cứ hỏa lực, bạn có thể tải về một trong chúng tôi mẫu QuickStart .

Bước 1: Tạo một dự án căn cứ hỏa lực

Trước khi có thể thêm Firebase vào dự án Unity của mình, bạn cần tạo một dự án Firebase để kết nối với dự án Unity của mình. Thăm Hiểu căn cứ hỏa lực dự án để tìm hiểu thêm về các dự án căn cứ hỏa lực.

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

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. Tới các căn cứ hỏa lực console .

  2. Ở trung tâm của trang tổng quan về dự án, nhấp vào biểu tượng Unity ( ) để khởi động công việc cài đặt.

    Nếu bạn đã thêm vào một ứng dụng cho dự án căn cứ hỏa lực của bạn, nhấp vào Thêm ứng dụng để hiển thị các tùy chọn nền tảng.

  3. Chọn mục tiêu xây 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 một lúc.

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

    • For iOS - Nhập iOS ID dự án Unity của bạn trong bó ID iOS lĩnh vực.

    • Đối với Android - Nhập Android ID dự án Unity của bạn trong tên gói Android lĩnh vực.
      Tên ngữ góiID ứng dụng thường được sử dụng thay thế cho nhau.

  5. (Tùy chọn) Nhập nickname nền tảng cụ thể dự án Unity của bạn (s).
    Những biệt hiệu này là số nhận dạng nội bộ, tiện lợi và chỉ hiển thị với bạn trong bảng điều khiển Firebase.

  6. Bấm vào Đăng ký ứng dụng.

Bước 3: Thêm file cấu hình căn cứ hỏa lực

  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 Firebase.

    • For iOS - Nhấp vào Tải xuống GoogleService-Info.plist.

    • Đối với Android - Bấm Tải google-services.json.

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

  3. Trở lại trong căn cứ hỏa lực điều khiển, trong công việc cài đặt, nhấn Next.

Bước 4: Thêm căn cứ hỏa lực Unity SDK

  1. Trong căn cứ hỏa lực điều khiển, bấm Tải về căn cứ hỏa lực Unity SDK, sau đó giải nén SDK ở đâu đó thuận tiện.

  2. Trong dự án của bạn mở Unity, điều hướng đến Tài sản> Import Package> Custom Package.

  3. Từ SDK đã được giải nén, chọn sản phẩm căn cứ hỏa lực hỗ trợ mà bạn muốn sử dụng trong ứng dụng của bạn.

    Đã bật phân tích

    • Thêm gói căn cứ hỏa lực 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 mình. Ví dụ: để sử dụng Xác thực Firebase và Cơ sở dữ liệu thời gian thực của Firebase:
      FirebaseAuth.unitypackageFirebaseDatabase.unitypackage

    Phân tích không được bật

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

  4. Trong cửa sổ Import Unity Package, bấm Import.

  5. Trở lại trong căn cứ hỏa lực điều khiển, trong công việc cài đặt, nhấn Next.

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

Các căn cứ hỏa lực Unity SDK cho Android đòi hỏi các dịch vụ Google Play , mà phải được up-to-date trước khi SDK có thể được sử dụng.

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

Firebase.FirebaseApp.CheckAndFixDependenciesAsync().ContinueWith(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 đã sẵn sàng! Dự án Unity của bạn đã được đăng ký và định cấu hình để sử dụng Firebase.

Nếu bạn đang gặp rắc rối việc thiết lập, mặc dù, hãy truy cập xử lý sự cố Unity & FAQ .

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

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

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

  2. Khởi động dự án Unity của bạn trong Unity IDE hoặc chọn để xây dựng dự án Unity của bạn cho máy tính để bàn.

  3. (Không bắt buộc) Khởi động dự án Unity của bạn trong Edit Mode.

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

    1. Khi bạn tạo một FirebaseApp sử dụng bởi các biên tập viên, không sử dụng các trường hợp mặc định.

    2. Thay vào đó, cung cấp một tên duy nhất cho các FirebaseApp.Create() gọi.

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

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

Tìm hiểu thêm về các thư viện Unity căn cứ hỏa lực trong tài liệu tham khảo .

Các căn cứ hỏa lực Unity SDK hỗ trợ các sản phẩm căn cứ hỏa lực sau trên iOSAndroid:

Sản phẩm Firebase Gói Unity
AdMob Được phân phối riêng trong Plugin AdMob Unity
phân tích FirebaseAnalytics.unitypackage
Xác thực FirebaseAuth.unitypackage
Đám mây FireStore (beta) FirebaseFirestore.unitypackage
Chức năng đám mây FirebaseFunctions.unitypackage
Nhắn tin qua đám mây FirebaseMessaging.unitypackage
(recommended) FirebaseAnalytics.unitypackage
Lưu trữ đám mây FirebaseStorage.unitypackage
Crashlytics FirebaseCrashlytics.unitypackage
(recommended) FirebaseAnalytics.unitypackage
Liên kết động FirebaseDynamicLinks.unitypackage
(recommended) FirebaseAnalytics.unitypackage
Cơ sở dữ liệu thời gian thực FirebaseDatabase.unitypackage
Cấu hình từ xa FirebaseRemoteConfig.unitypackage
(recommended) FirebaseAnalytics.unitypackage

Các sản phẩm Firebase được hỗ trợ (máy tính để bàn)

Các căn cứ hỏa lực Unity SDK bao gồm hỗ trợ công việc máy tính để bàn cho một tập hợp con của sản phẩm, tạo điều kiện cho một số phần của căn cứ hỏa lực sẽ được sử dụng trong trình soạn thảo Unity và trong máy tính để bàn độc lập được xây dựng trên Windows, MacOS và Linux.

Sản phẩm Firebase (máy tính để bàn) Gói Unity
Xác thực FirebaseAuth.unitypackage
Chức năng đám mây FirebaseFunctions.unitypackage
Cloud Firestore FirebaseFirestore.unitypackage
Lưu trữ đám mây FirebaseStorage.unitypackage
Cơ sở dữ liệu 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 để bàn còn lại dưới dạng triển khai sơ khai (không có chức năng) để thuận tiện khi xây dựng cho Windows, macOS và Linux. Do đó, bạn không cần phải biên dịch mã có điều kiện để nhắm mục tiêu đến máy tính để bàn.

Bước tiếp theo