เพิ่มประสิทธิภาพเกม Unity ของคุณด้วย Firebase Unity SDK ของเรา
เพื่อแสดงให้เห็นว่าการเสียบ Firebase เข้ากับโปรเจ็กต์ Unity นั้นง่ายดายเพียงใด เราได้สร้างเกมตัวอย่าง MechaHamster หากคุณต้องการลองเพิ่ม Firebase ลงในเกม ให้ใช้เวอร์ชันเริ่มต้นที่อยู่บน GitHub หากคุณต้องการเวอร์ชันที่สมบูรณ์ โปรดดูเวอร์ชันใน App Store หรือ Google Play Store
ค้นหาข้อมูลเพิ่มเติมเกี่ยวกับการเพิ่มประสิทธิภาพเกมของคุณด้วย Firebase ได้ที่ หน้าเกม Firebase ของเรา
เพิ่ม Firebase ในโครงการ Unity ของคุณแล้วหรือยัง? ตรวจสอบให้แน่ใจว่าคุณใช้ Firebase Unity SDK เวอร์ชันล่าสุด
ข้อกำหนดเบื้องต้น
ติดตั้ง Unity 2019.1 หรือใหม่กว่า เวอร์ชันก่อนหน้าอาจเข้ากันได้ แต่จะไม่ได้รับการสนับสนุนอย่างแข็งขัน การสนับสนุน Unity 2019.1 ถือว่าเลิกใช้แล้ว และจะไม่ได้รับการสนับสนุนอีกต่อไปหลังจากการเปิดตัวรุ่นหลักครั้งต่อไป
(แพลตฟอร์ม Apple เท่านั้น) ติดตั้งสิ่งต่อไปนี้:
- Xcode 13.3.1 หรือสูงกว่า
- CocoaPods 1.10.0 หรือสูงกว่า
ตรวจสอบให้แน่ใจว่าโครงการ Unity ของคุณตรงตามข้อกำหนดเหล่านี้:
- สำหรับ iOS — กำหนดเป้าหมายเป็น iOS 11 หรือสูงกว่า
- สำหรับ tvOS - กำหนดเป้าหมาย tvOS 12 หรือสูงกว่า
- สำหรับ Android — กำหนดเป้าหมาย API ระดับ 19 (KitKat) หรือสูงกว่า
ตั้งค่าอุปกรณ์ทางกายภาพหรือใช้โปรแกรมจำลองเพื่อเรียกใช้แอปของคุณ
สำหรับแพลตฟอร์ม Apple — ตั้งค่าอุปกรณ์จริงหรือใช้ iOS หรือเครื่องจำลอง tvOS
สำหรับ Cloud Messaging บน iOS หรือ tvOS ข้อกำหนดเบื้องต้นมีดังนี้:
- ตั้งค่า อุปกรณ์ทางกายภาพ
- รับคีย์การรับรองความถูกต้องการแจ้งเตือน Apple Push สำหรับ บัญชี Apple Developer ของคุณ
- เปิดใช้งานการแจ้งเตือนแบบพุชใน 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 ที่คุณต้องการลงทะเบียน หรือคุณสามารถเลือกที่จะลงทะเบียนทั้งสองเป้าหมายทันทีพร้อมกันได้
ป้อนรหัสเฉพาะแพลตฟอร์มของโปรเจ็กต์ Unity
สำหรับ iOS — ป้อนรหัส iOS ของโปรเจ็กต์ Unity ในช่อง รหัสชุด iOS
สำหรับ Android — ป้อนรหัส Android ของโปรเจ็กต์ Unity ในช่อง ชื่อแพ็คเกจ Android
ชื่อแพ็กเกจ ข้อกำหนดและ รหัสแอปพลิเค ชันมักใช้แทนกันได้
เปิดโปรเจ็กต์ Unity ของคุณใน Unity IDE จากนั้นไปที่ส่วนการตั้งค่าสำหรับแต่ละแพลตฟอร์ม:
สำหรับ iOS — ไปที่ การตั้งค่าบิลด์ > 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 SDK
ในคอนโซล Firebase คลิก ดาวน์โหลด Firebase Unity SDK จากนั้นแตกไฟล์ SDK ในที่ที่สะดวก
คุณสามารถดาวน์โหลด Firebase Unity SDK อีกครั้งได้ทุกเมื่อ
Firebase Unity SDK ไม่ใช่เฉพาะแพลตฟอร์ม
ในโปรเจ็กต์ Unity ที่เปิดอยู่ ให้ไปที่ Assets > Import Package > Custom Package
จาก 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:
ในหน้าต่าง นำเข้า Unity Package คลิก นำเข้า
ย้อนกลับไปในคอนโซล 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 Editor และบนแพลตฟอร์มเดสก์ท็อปก่อน จากนั้นจึงปรับใช้และทดสอบบนอุปกรณ์มือถือในภายหลังในการพัฒนา เพื่อรองรับเวิร์กโฟลว์นี้ เราได้จัดเตรียม ชุดย่อยของ 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 ที่พร้อมใช้งานสำหรับอุปกรณ์เคลื่อนที่
Firebase Unity SDK รองรับผลิตภัณฑ์ Firebase ต่อไปนี้บน Apple และ Android :
ผลิตภัณฑ์ Firebase | แพ็คเกจความสามัคคี |
---|---|
แอดโมบ | เผยแพร่แยกต่างหากในปลั๊กอิน AdMob Unity |
การวิเคราะห์ | FirebaseAnalytics.unitypackage |
ตรวจสอบแอป | FirebaseAppCheck.unitypackage |
การรับรองความถูกต้อง | FirebaseAuth.unitypackage |
คลาวด์ไฟร์สโตร์ | 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 (เดสก์ท็อป) | แพ็คเกจความสามัคคี |
---|---|
ตรวจสอบแอป | FirebaseAppCheck.unitypackage |
การรับรองความถูกต้อง | FirebaseAuth.unitypackage |
ฟังก์ชั่นคลาวด์ | FirebaseFunctions.unitypackage |
คลาวด์ไฟร์สโตร์ | FirebaseFirestore.unitypackage |
การจัดเก็บเมฆ | FirebaseStorage.unitypackage |
ฐานข้อมูลเรียลไทม์ | FirebaseDatabase.unitypackage |
การกำหนดค่าระยะไกล | FirebaseRemoteConfig.unitypackage |
Firebase จัดเตรียมไลบรารีเดสก์ท็อปที่เหลือเป็นการใช้งาน Stub (ไม่ทำงาน) เพื่อความสะดวกเมื่อสร้างสำหรับ Windows, macOS และ Linux ดังนั้นคุณไม่จำเป็นต้องคอมไพล์โค้ดแบบมีเงื่อนไขเพื่อกำหนดเป้าหมายเดสก์ท็อป
ขั้นตอนถัดไป
สำรวจ แอป Firebase ตัวอย่าง
เตรียมเปิดตัวแอปของคุณ:
- ตั้งค่า การแจ้งเตือนงบประมาณ สำหรับโครงการของคุณใน Google Cloud Console
- ตรวจสอบ แดชบอร์ด การใช้งานและการเรียกเก็บเงิน ในคอนโซล Firebase เพื่อดูภาพรวมการใช้งานโปรเจ็กต์ของคุณในบริการ Firebase ต่างๆ
- ตรวจสอบ รายการตรวจสอบการเปิดตัว Firebase
มีปัญหากับ Firebase และโปรเจ็กต์ Unity ของคุณใช่ไหม เยี่ยมชม การแก้ไขปัญหาและคำถามที่พบบ่อยของ Unity