เพิ่มพลังให้กับเกม Unity ของคุณด้วย Firebase Unity SDK
เพื่อแสดงให้เห็นว่าการเสียบ Firebase เข้ากับโปรเจ็กต์ Unity ของคุณนั้นง่ายเพียงใด เราจึงได้สร้างตัวอย่างเกม MechaHamster ที่คุณสามารถดาวน์โหลดได้จาก GitHub , App Store และ Google Play Store
ค้นหาข้อมูลเพิ่มเติมเกี่ยวกับการเพิ่มพลังให้เกมของคุณด้วย Firebase ที่ หน้าเกม Firebase ของเรา
เพิ่ม Firebase ในโครงการ Unity แล้วหรือยัง ตรวจสอบให้แน่ใจว่าคุณใช้ Firebase Unity SDK เวอร์ชัน ล่าสุด
ข้อกำหนดเบื้องต้น
ติดตั้ง Unity 2018.4 หรือใหม่กว่า เวอร์ชันก่อนหน้าอาจใช้งานร่วมกันได้ แต่จะไม่ได้รับการสนับสนุนอย่างแข็งขัน การสนับสนุนสำหรับ Unity 2018.4 ถือว่าเลิกใช้แล้ว และจะไม่ได้รับการสนับสนุนอย่างแข็งขันอีกต่อไปหลังจากการเปิดตัวครั้งใหญ่ครั้งถัดไป
(iOS เท่านั้น) ติดตั้งสิ่งต่อไปนี้:
- Xcode 13.3.1 หรือสูงกว่า
- CocoaPods 1.10.0 หรือสูงกว่า
ตรวจสอบให้แน่ใจว่าโครงการ Unity ของคุณตรงตามข้อกำหนดเหล่านี้:
- สำหรับ iOS — กำหนดเป้าหมายเป็น iOS 10 หรือสูงกว่า
สำหรับ Android — กำหนดเป้าหมายเป็น API ระดับ 19 (KitKat) หรือสูงกว่า
ตั้งค่าอุปกรณ์จริงหรือใช้โปรแกรมจำลองเพื่อเรียกใช้แอปของคุณ
สำหรับ iOS — ตั้งค่าอุปกรณ์ iOS จริงหรือใช้เครื่องจำลอง iOS
สำหรับ Cloud Messaging บน iOS มีข้อกำหนดเบื้องต้นดังต่อไปนี้:
- ตั้งค่า อุปกรณ์ iOS จริง
- รับ Apple Push Notification Authentication Key สำหรับ บัญชีนักพัฒนา Apple ของคุณ
- เปิดใช้งาน Push Notifications ใน XCode ภายใต้ App > Capabilities
สำหรับ Android — อีมู เลเตอร์ต้องใช้อิมเมจอีมูเลเตอร์กับ Google Play
- ลงชื่อเข้าใช้ Firebase โดยใช้บัญชี Google ของคุณ
หากคุณยังไม่มีโปรเจ็กต์ Unity และต้องการลองใช้ผลิตภัณฑ์ Firebase คุณสามารถดาวน์โหลดหนึ่งใน ตัวอย่าง การเริ่มต้นอย่างรวดเร็วของเรา
ขั้นตอนที่ 1 : สร้างโปรเจ็กต์ Firebase
ก่อนที่คุณจะเพิ่ม Firebase ลงในโปรเจ็กต์ Unity ได้ คุณต้องสร้างโปรเจ็กต์ Firebase เพื่อเชื่อมต่อกับโปรเจ็กต์ Unity ไปที่ ทำความเข้าใจโปรเจ็กต์ Firebase เพื่อเรียนรู้เพิ่มเติมเกี่ยวกับโปรเจ็กต์ Firebase
ขั้นตอนที่ 2 : ลงทะเบียนแอปของคุณด้วย Firebase
คุณลงทะเบียนแอปหรือเกมได้ตั้งแต่ 1 รายการขึ้นไปเพื่อเชื่อมต่อกับโปรเจ็กต์ Firebase
ไปที่ คอนโซล Firebase
ตรงกลางหน้าภาพรวมโครงการ ให้คลิกไอคอน Unity (
) เพื่อเริ่มเวิร์กโฟลว์การตั้งค่าหากคุณได้เพิ่มแอปลงในโปรเจ็กต์ Firebase แล้ว ให้คลิก เพิ่มแอป เพื่อแสดงตัวเลือกแพลตฟอร์ม
เลือกเป้าหมายการสร้างของโปรเจ็กต์ Unity ของคุณที่คุณต้องการลงทะเบียน หรือคุณสามารถเลือกลงทะเบียนทั้งสองเป้าหมายได้พร้อมกัน
ป้อน ID เฉพาะแพลตฟอร์มของโปรเจ็กต์ Unity
สำหรับ iOS — ป้อนรหัส iOS ของโปรเจ็กต์ Unity ของคุณในฟิลด์ ID บันเดิล iOS
สำหรับ Android — ป้อนรหัส Android ของโครงการ Unity ของคุณในช่อง ชื่อแพ็คเกจ Android
เงื่อนไข ชื่อแพ็คเกจ และ รหัสแอปพลิเคชัน มักใช้สลับกันได้
เปิดโปรเจ็กต์ Unity ของคุณใน Unity IDE จากนั้นไปที่ส่วนการตั้งค่าสำหรับแต่ละแพลตฟอร์ม:
สำหรับ iOS — ไปที่ Build Settings > iOS
สำหรับ Android — ไปที่ Android > การตั้งค่าผู้เล่น > การตั้งค่าอื่นๆ
ID โปรเจ็กต์ Unity ของคุณคือค่า Bundle Identifier (รหัสตัวอย่าง:
com.yourcompany.yourproject
)(ไม่บังคับ) ป้อนชื่อเล่นเฉพาะแพลตฟอร์มของโปรเจ็กต์ Unity
ชื่อเล่นเหล่านี้เป็นตัวระบุความสะดวกภายใน และมีเพียงคุณเท่านั้นที่เห็นในคอนโซล Firebaseคลิก ลงทะเบียนแอป
ขั้นตอนที่ 3 : เพิ่มไฟล์การกำหนดค่า Firebase
รับไฟล์การกำหนดค่า Firebase เฉพาะแพลตฟอร์มในเวิร์กโฟลว์การตั้งค่าคอนโซล Firebase
สำหรับ iOS — คลิก ดาวน์โหลด GoogleService-Info.plist
สำหรับ Android — คลิก ดาวน์โหลด google-services.json
ไฟล์กำหนดค่า Firebase มีตัวระบุที่ไม่ซ้ำแต่ไม่เป็นความลับสำหรับโปรเจ็กต์ของคุณ หากต้องการเรียนรู้เพิ่มเติมเกี่ยวกับไฟล์กำหนดค่านี้ โปรดไปที่ ทำความเข้าใจโปรเจ็กต์ Firebase
คุณดาวน์โหลด ไฟล์กำหนดค่า Firebase อีกครั้งได้ทุกเมื่อ
ตรวจสอบให้แน่ใจว่าชื่อไฟล์ปรับแต่งไม่ได้ต่อท้ายด้วยอักขระเพิ่มเติม เช่น
(2)
เปิดหน้าต่าง โปรเจ็ กต์ของโปรเจ็กต์ Unity ของคุณ จากนั้นย้ายไฟล์ปรับแต่งของคุณไปที่โฟลเดอร์
Assets
กลับไปที่คอนโซล Firebase ในเวิร์กโฟลว์การตั้งค่า คลิก ถัดไป
ขั้นตอนที่ 4 : เพิ่ม Firebase Unity SDKs
ในคอนโซล Firebase คลิก ดาวน์โหลด Firebase Unity SDK จากนั้นคลายซิป SDK ในตำแหน่งที่สะดวก
คุณดาวน์โหลด Firebase Unity SDK อีกครั้งได้ทุกเมื่อ
Firebase Unity SDK ไม่ใช่เฉพาะแพลตฟอร์ม
ในโครงการ Unity ที่เปิดอยู่ ให้ไปที่ เนื้อหา > นำเข้าแพ็คเกจ > แพ็คเกจที่กำหนดเอง
จาก SDK ที่คลายซิป ให้เลือก ผลิตภัณฑ์ Firebase ที่รองรับ ซึ่งคุณต้องการใช้ในแอปของคุณ
เปิดใช้งานการวิเคราะห์
- เพิ่มแพ็คเกจ Firebase สำหรับ Google Analytics:
FirebaseAnalytics.unitypackage
- เพิ่มแพ็คเกจสำหรับผลิตภัณฑ์ Firebase อื่นๆ ที่คุณต้องการใช้ในแอปของคุณ ตัวอย่างเช่น ในการใช้ Firebase Authentication และ Firebase Realtime Database:
FirebaseAuth.unitypackage
และFirebaseDatabase.unitypackage
ไม่ได้เปิดใช้งานการวิเคราะห์
เพิ่มแพ็คเกจสำหรับผลิตภัณฑ์ Firebase ที่คุณต้องการใช้ในแอปของคุณ ตัวอย่างเช่น ในการใช้ Firebase Authentication และ Firebase Realtime Database:
FirebaseAuth.unitypackage
และFirebaseDatabase.unitypackage
- เพิ่มแพ็คเกจ Firebase สำหรับ Google Analytics:
ในหน้าต่าง Import Unity Package ให้คลิก Import
กลับไปที่คอนโซล Firebase ในเวิร์กโฟลว์การตั้งค่า คลิก ถัดไป
ขั้นตอนที่ 5 : ยืนยันข้อกำหนดเวอร์ชันบริการ Google Play
Firebase Unity SDK สำหรับ Android ต้องการ บริการ Google Play ซึ่งต้องอัปเดตก่อนจึงจะสามารถใช้ SDK ได้
เพิ่มรหัสต่อไปนี้เมื่อเริ่มต้นแอปพลิเคชันของคุณ คุณตรวจสอบและเลือกที่จะอัปเดตบริการ Google Play เป็นเวอร์ชันที่ Firebase Unity SDK ต้องการได้ก่อนที่จะเรียกใช้วิธีอื่นๆ ใน 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. } });
คุณทุกชุด! โปรเจ็กต์ Unity ของคุณลงทะเบียนและกำหนดค่าให้ใช้ Firebase แล้ว
หากคุณประสบปัญหาในการตั้งค่า โปรดไปที่ การ แก้ไขปัญหา Unity & คำถามที่พบบ่อย
ตั้งค่าเวิร์กโฟลว์เดสก์ท็อป ( เบต้า )
เมื่อคุณสร้างเกม การทดสอบเกมของคุณในเครื่องมือแก้ไข Unity และบนแพลตฟอร์มเดสก์ท็อปก่อนนั้นมักจะง่ายกว่ามาก จากนั้นจึงปรับใช้และทดสอบบนอุปกรณ์เคลื่อนที่ในการพัฒนาในภายหลัง เพื่อสนับสนุนเวิร์กโฟลว์นี้ เราจัดเตรียม ชุดย่อยของ Firebase Unity SDK ที่สามารถทำงานบน Windows, macOS, Linux และจากภายในตัวแก้ไข Unity
ตั้งค่าโปรเจ็กต์ Unity แพลตฟอร์มเดสก์ท็อปโดยทำตามคำแนะนำเดียวกันกับแพลตฟอร์มมือถือ (เริ่มต้นด้วยขั้นตอนการ ลงทะเบียนแอปของคุณด้วย Firebase ด้านบน)
เรียกใช้โครงการ Unity ของคุณใน Unity IDE หรือเลือกสร้างโครงการ Unity สำหรับ เดสก์ท็อป
(ไม่บังคับ) เรียกใช้โครงการ Unity ของคุณในโหมดแก้ไข
นอกจากนี้ยังเรียกใช้ Firebase Unity SDK ในโหมดแก้ไขของ Unity ได้อีกด้วย ซึ่งอนุญาตให้ใช้ในปลั๊กอินตัวแก้ไข
เมื่อคุณสร้าง
FirebaseApp
ที่ใช้โดยตัวแก้ไข อย่าใช้อินสแตนซ์เริ่มต้นให้ระบุชื่อที่ไม่ซ้ำกับการเรียก
FirebaseApp.Create()
แทนนี่เป็นสิ่งสำคัญที่จะหลีกเลี่ยงความขัดแย้งในตัวเลือกระหว่างอินสแตนซ์ที่ใช้โดย Unity IDE และอินสแตนซ์ที่ใช้โดยโปรเจ็กต์ Unity ของคุณ
ผลิตภัณฑ์ Firebase ที่รองรับ
เรียนรู้เพิ่มเติมเกี่ยวกับไลบรารี Unity Firebase ใน เอกสารอ้างอิง
Firebase Unity SDK รองรับผลิตภัณฑ์ Firebase ต่อไปนี้บน iOS และ Android :
ผลิตภัณฑ์ Firebase | แพ็คเกจสามัคคี |
---|---|
AdMob | เผยแพร่แยกต่างหากใน AdMob Unity Plugin |
การวิเคราะห์ | FirebaseAnalytics.unitypackage |
การตรวจสอบสิทธิ์ | FirebaseAuth.unitypackage |
Cloud Firestore | FirebaseFirestore.unitypackage |
ฟังก์ชั่นคลาวด์ | FirebaseFunctions.unitypackage |
การส่งข้อความบนคลาวด์ | FirebaseMessaging.unitypackage (แนะนำ) FirebaseAnalytics.unitypackage |
การจัดเก็บเมฆ | FirebaseStorage.unitypackage |
Crashlytics | FirebaseCrashlytics.unitypackage (แนะนำ) FirebaseAnalytics.unitypackage |
ลิงก์แบบไดนามิก | FirebaseDynamicLinks.unitypackage (แนะนำ) FirebaseAnalytics.unitypackage |
ฐานข้อมูลเรียลไทม์ | FirebaseDatabase.unitypackage |
การกำหนดค่าระยะไกล | FirebaseRemoteConfig.unitypackage (แนะนำ) FirebaseAnalytics.unitypackage |
ผลิตภัณฑ์ Firebase ที่รองรับ (เดสก์ท็อป)
Firebase Unity SDK มี การรองรับเวิร์กโฟลว์เดสก์ท็อป สำหรับชุดย่อยของผลิตภัณฑ์ ทำให้สามารถใช้ Firebase บางส่วนในตัวแก้ไข Unity และในบิลด์เดสก์ท็อปแบบสแตนด์อโลนบน Windows, macOS และ Linux
ผลิตภัณฑ์ Firebase (เดสก์ท็อป) | แพ็คเกจสามัคคี |
---|---|
การตรวจสอบสิทธิ์ | FirebaseAuth.unitypackage |
ฟังก์ชั่นคลาวด์ | FirebaseFunctions.unitypackage |
Cloud Firestore | FirebaseFirestore.unitypackage |
การจัดเก็บเมฆ | FirebaseStorage.unitypackage |
ฐานข้อมูลเรียลไทม์ | FirebaseDatabase.unitypackage |
การกำหนดค่าระยะไกล | FirebaseRemoteConfig.unitypackage |
Firebase จัดเตรียมไลบรารีเดสก์ท็อปที่เหลือเป็นการใช้งาน stub (ไม่ทำงาน) เพื่อความสะดวกในการสร้างสำหรับ Windows, macOS และ Linux ดังนั้น คุณไม่จำเป็นต้องคอมไพล์โค้ดแบบมีเงื่อนไขเพื่อกำหนดเป้าหมายเดสก์ท็อป
ขั้นตอนถัดไป
สำรวจ ตัวอย่างแอป Firebase
เตรียมเปิดแอปของคุณ:
- ตั้งค่า การแจ้งเตือนงบประมาณ สำหรับโครงการของคุณใน Google Cloud Console
- ตรวจสอบ แดชบอร์ด การใช้งานและการเรียกเก็บเงิน ในคอนโซล Firebase เพื่อดูภาพรวมการใช้งานโปรเจ็กต์ของคุณในบริการ Firebase ที่หลากหลาย
- ตรวจ สอบรายการตรวจสอบการเปิดตัว Firebase
มีปัญหากับ Firebase และโครงการ Unity ของคุณหรือไม่ ไปที่การ แก้ไขปัญหา Unity & คำถามที่พบบ่อย