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, chúng tôi đã tạo một trò chơi mẫu 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 có trên GitHub. Nếu bạn muốn có một 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.
MechaHamster (Cửa hàng ứng dụng)
Tìm hiểu thêm thông tin về cách thiết lập trò chơi của bạn bằng Firebase tại trang trò chơi trong Firebase của chúng tôi.
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 SDK Unity của Firebase.
Đ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ợ. Chúng tôi không còn hỗ trợ Unity 2019.1 nữa và sẽ không còn được hỗ trợ 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
- 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 đến 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 trình mô phỏng iOS hoặc tvOS.
Đối với Android – Các trình mô phỏng 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 chưa có dự án Unity và chỉ muốn dùng thử sản phẩm của 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 dự án Firebase để kết nối với dự án Unity. Hãy xem 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.
Truy cập vào bảng điều khiển của Firebase.
Ở 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 Add app (Thêm ứng dụng) để hiển thị các lựa chọn về nền tảng.
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ờ.
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 Android package name (Tên gói Android).
Các thuật ngữ package name (tên gói) và application ID (mã ứng dụng) thường được dùng thay thế cho nhau.
(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.
Các 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 nhìn thấy trong bảng điều khiển của Firebase.Nhấp vào Đăng ký ứng dụng.
Bước 3: Thêm tệp cấu hình Firebase
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 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.
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
.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
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 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.
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).
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 Analytics
- Thêm gói Firebase cho Google Analytics:
FirebaseAnalytics.unitypackage
- Thêm gói cho mọi sản phẩm Firebase khác mà bạn muốn sử dụng trong ứng dụng của mình. Ví dụ: cách 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 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
- Thêm gói Firebase cho Google Analytics:
Trong cửa sổ Import Unity Package (Nhập gói Unity), hãy nhấp vào Import (Nhập).
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
Firebase Unity SDK dành cho Android yêu cầu Dịch vụ Google Play và dịch vụ này 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 ở đầu ứng dụng. 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ỳ 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 Khắc phục sự cố và câu hỏi thường gặp của Unity.
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, thường sẽ dễ dàng hơn nhiều nếu bạn kiểm thử trò chơi của mình 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à kiểm thử trên thiết bị di động trong quá trình phát triển sau này. Để hỗ trợ quy trình công 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 và trong trình chỉnh sửa Unity.
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ư dành cho nền tảng di động (bắt đầu bằng bước Đăng ký ứng dụng với Firebase ở trên).
Chạy dự án Unity trong IDE Unity hoặc chọn tạo dự án Unity cho máy tính.
(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 SDK trong trình bổ trợ trình chỉnh sửa.
Khi bạn tạo một
FirebaseApp
mà 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 tên riêng biệt cho lệnh gọi
FirebaseApp.Create()
.Điều này là rất quan trọng để tránh xung đột giữa các lựa chọn giữa thực thể mà IDE Unity sử dụng 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ề các 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 Firebase sau 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 hỗ trợ quy trình công việc trên máy tính cho một số sản phẩm, cho phép sử dụng một số phần của Firebase trong trình chỉnh sửa Unity và trong các bản dựng máy tính độc lập 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 các phương thức triển khai giả lập (không hoạt động) để 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
Khám phá ứng dụng Firebase mẫu.
Chuẩn bị phát hành ứng dụng:
- Thiết lập cảnh báo ngân sách cho dự án của bạn trong bảng điều khiển Google Cloud.
- Hãy theo dõi trang tổng quan về Mức sử dụng và thanh toán trong bảng điều khiển của Firebase để nắm được thông tin tổng thể về mức sử dụng dự án của bạn trên nhiều dịch vụ của Firebase.
- Xem danh sách kiểm tra khi phát hành Firebase.
Bạn gặp sự cố với Firebase và dự án Unity? Hãy truy cập vào bài viết Khắc phục sự cố và câu hỏi thường gặp về Unity.