Tăng sức mạnh cho trò chơi Unity của bạn với SDK Unity Firebase của chúng tôi.
Để cho thấy việc kết nối Firebase vào dự án Unity của bạn dễ dàng như thế nào, 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 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 App Store hoặc cửa hàng Google Play .
Tìm hiểu thêm thông tin về cách tăng sức mạnh cho trò chơi của bạn bằng Firebase tại trang trò chơi Firebase của chúng tôi.
Bạn đã thêm Firebase vào dự án Unity của mình chưa? Đả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. Hỗ trợ cho Unity 2019.1 được coi là không được dùng nữa và sẽ không còn được hỗ trợ tích cực sau bản phát hành chính tiếp theo.
(Chỉ dành cho nền tảng của Apple) Cài đặt như sau:
- Xcode 13.3.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:
- Dành cho iOS - nhắm mục tiêu iOS 11 trở lên
- Dành cho tvOS - nhắm mục tiêu tvOS 12 trở lên
- Dành cho Android - nhắm mục tiêu API cấp 19 (KitKat) trở lê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.
Đối với nền tảng Apple — Thiết lập thiết bị vật lý hoặc sử dụng trình mô phỏng iOS hoặc tvOS.
Đối với Nhắn tin qua đám mây trên iOS hoặc tvOS, đây là những điều kiện tiên quyết:
- Thiết lập một thiết bị vật lý .
- Nhận Khóa xác thực thông báo đẩy của Apple cho tài khoản Nhà phát triển Apple của bạn.
- Bật Thông báo đẩy trong XCode trong Ứng dụng > Khả năng .
Đối với Android — Trình giả lập phải sử dụng hình ảnh trình mô phỏng với Google Play.
- Đăng nhập vào Firebase bằng tài khoản Google của bạn.
Nếu bạn chưa có dự án Unity và chỉ muốn dùng thử sản phẩm Firebase, 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 của mình, bạn cần tạo dự án Firebase để kết nối với dự án Unity của mình. Truy cập Tìm hiểu 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.
Chuyển đến bảng điều khiển Firebase .
Ở giữa trang tổng quan dự án, hãy nhấp vào biểu tượng Unity (
) để khởi chạy quy trình thiết lập.Nếu bạn đã thêm ứng dụng vào dự án Firebase của mình, hãy nhấp vào Thêm ứng dụng để hiển thị các tùy chọn nền tảng.
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.
Nhập (các) ID dành riêng cho nền tảng của dự án Unity của bạn.
Đối với iOS - Nhập ID iOS của dự án Unity của bạn vào trường ID gói iOS .
Đối với Android - Nhập ID Android của dự án Unity của bạn vào trường tên gói Android .
Thuật ngữ tên gói và ID ứng dụng thường được sử dụng thay thế cho nhau.
Mở dự án Unity của bạn trong Unity IDE, sau đó điều hướng đến phần cài đặt cho từng nền tảng:
Đối với iOS - Điều hướng đến Cài đặt bản dựng > iOS .
Đối với Android — Điều hướng đến Android > Cài đặt trình phát > Cài đặt khác .
ID dự án Unity của bạn là giá trị Mã nhận dạng gói (ID ví dụ:
com.yourcompany.yourproject
).(Tùy chọn) Nhập (các) biệt hiệu dành riêng cho nền tảng của dự án Unity của bạn.
Những biệt hiệu này là giá trị nhận dạng nội bộ, thuận tiện và chỉ hiển thị với bạn trong bảng điều khiển Firebase.Nhấn vào Đăng ký ứng dụng .
Bước 3 : Thêm file cấu hình Firebase
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.
Đối với iOS — Nhấp vào Tải xuống GoogleService-Info.plist .
Đối với Android — Nhấp vào Tải xuống google-services.json .
Tệp cấu hình Firebase chứa số nhận dạng duy nhất nhưng không bí mật cho dự án của bạn. Để tìm hiểu thêm về tệp cấu hình này, hãy truy cập Tìm hiểu dự án Firebase .
Bạn có thể tải xuống lại tệp cấu hình Firebase của mình bất kỳ lúc nào.
Đảm bảo tên tệp cấu hình không được thêm các ký tự bổ sung, như
(2)
.
Mở cửa sổ Project của dự án Unity của bạn, sau đó di chuyển (các) tệp cấu hình của bạn vào thư mục
Assets
.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 Unity Firebase
Trong bảng điều khiển Firebase, nhấp vào Tải xuống Firebase Unity SDK , sau đó giải nén SDK ở nơi nào đó thuận tiện.
Bạn có thể tải xuống lại Firebase Unity SDK bất cứ lúc nào.
SDK Unity Firebase không dành riêng cho nền tảng.
Trong dự án Unity đang mở của bạn, hãy điều hướng đến Tài sản > Gói nhập > Gói tùy chỉnh .
Từ 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 phân tích
- 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 mình. Ví dụ: để sử dụng Xác thực Firebase và Cơ sở dữ liệu thời gian thực Firebase:
FirebaseAuth.unitypackage
vàFirebaseDatabase.unitypackage
Phân tích chưa được bật
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ụ: để sử dụng Xác thực Firebase và Cơ sở dữ liệu thời gian thực Firebase:
FirebaseAuth.unitypackage
vàFirebaseDatabase.unitypackage
- Thêm gói Firebase cho Google Analytics:
Trong cửa sổ Nhập gói Unity , nhấp vào Nhập .
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 yêu cầu phiên bản dịch vụ Google Play
SDK Firebase Unity dành cho Android yêu cầu dịch vụ Google Play , dịch vụ này phải được cập nhật trước khi có thể sử dụng SDK.
Thêm mã sau vào đầu ứng dụng của bạn. Bạn có thể kiểm tra và tùy ý cập nhật dịch vụ Google Play lên phiên bản được SDK Unity Firebase 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 đã 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 Câu hỏi thường gặp & khắc phục sự cố của Unity .
Thiết lập quy trình làm việc trên máy tính để bàn ( beta )
Khi bạn tạo trò chơi, việc thử nghiệm 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 trước tiên thường dễ dàng hơn nhiều, sau đó triển khai và thử nghiệm trên thiết bị di động trong quá trình phát triển sau này. Để 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 Firebase có thể chạy trên Windows, macOS, Linux và từ bên trong trình chỉnh sửa Unity.
Thiết lập dự án Unity trên nền tảng máy tính để bàn bằng cách làm theo các 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).
Chạy dự án Unity của bạn trong Unity IDE hoặc chọn xây dựng dự án Unity cho máy tính để bàn .
(Tùy chọn) Chạy dự án Unity của bạn ở Chế độ chỉnh sửa.
SDK Unity Firebase cũng có thể chạy ở chế độ chỉnh sửa của Unity, cho phép sử dụng nó trong các plugin chỉnh sửa.
Khi bạn tạo
FirebaseApp
được trình chỉnh sửa sử dụng, đừng sử dụng phiên bản mặc định.Thay vào đó, hãy cung cấp một tên duy nhất cho lệnh gọi
FirebaseApp.Create()
.Điều này rất quan trọng để tránh xung đột về các tùy chọn giữa phiên bản được Unity IDE sử dụng và phiên bản được 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ề thư viện Unity Firebase trong tài liệu tham khảo .
Thư viện Firebase có sẵn cho thiết bị di động
SDK Firebase Unity hỗ trợ các sản phẩm Firebase sau trên Apple và Android :
sản phẩm căn cứ hỏa lực | Gói thống nhất |
---|---|
AdMob | Được phân phối riêng trong Plugin Unity AdMob |
phân tích | FirebaseAnalytics.unitypackage |
Kiểm tra ứng dụng | FirebaseAppCheck.unitypackage |
Xác thực | FirebaseAuth.unitypackage |
Cửa hàng đám mây | FirebaseFirestore.unitypackage |
Chức năng đám mây | FirebaseFunctions.unitypackage |
Nhắn tin qua đám mây | FirebaseMessaging.unitypackage (được khuyến nghị) FirebaseAnalytics.unitypackage |
Lưu trữ đám mây | FirebaseStorage.unitypackage |
Crashlytics | FirebaseCrashlytics.unitypackage (được khuyến nghị) FirebaseAnalytics.unitypackage |
Liên kết động | FirebaseDynamicLinks.unitypackage (được khuyến nghị) FirebaseAnalytics.unitypackage |
Cơ sở dữ liệu thời gian thực | FirebaseDatabase.unitypackage |
Cấu hình từ xa | FirebaseRemoteConfig.unitypackage (được khuyến nghị) FirebaseAnalytics.unitypackage |
Thư viện Firebase có sẵn cho máy tính để bàn
SDK Firebase Unity bao gồm hỗ trợ quy trình làm việc trên máy tính để bàn cho một tập hợp con 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 máy tính để bàn độc lập trên Windows, macOS và Linux.
Sản phẩm Firebase (máy tính để bàn) | Gói thống nhất |
---|---|
Kiểm tra ứng dụng | FirebaseAppCheck.unitypackage |
Xác thực | FirebaseAuth.unitypackage |
Chức năng đám mây | FirebaseFunctions.unitypackage |
Cửa hàng đám mây | 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 vào máy tính để bàn.
Bước tiếp theo
Khám phá các ứng dụng Firebase mẫu .
Chuẩn bị khởi chạy ứng dụng của bạn:
- Thiết lập cảnh báo ngân sách cho dự án của bạn trong Google Cloud Console.
- Theo dõi trang tổng quan Mức sử dụng và thanh toán trong bảng điều khiển Firebase để có được bức tranh tổng thể về việc sử dụng dự án của bạn trên nhiều dịch vụ Firebase.
- Xem lại danh sách kiểm tra khởi chạy Firebase .
Bạn gặp sự cố với Firebase và dự án Unity của mình? Truy cập phần Câu hỏi thường gặp và khắc phục sự cố của Unity .