เพิ่ม Firebase ให้กับโครงการ Unity ของคุณ

เพิ่มพลังให้กับเกม Unity ของคุณด้วย Firebase Unity SDK

เพื่อแสดงให้เห็นว่าการเสียบ Firebase เข้ากับโปรเจ็กต์ Unity ของคุณนั้นง่ายเพียงใด เราจึงได้สร้างตัวอย่างเกม MechaHamster ที่คุณสามารถดาวน์โหลดได้จาก GitHub , App Store และ Google Play Store

เมชาแฮมสเตอร์ (GitHub)

เมชาแฮมสเตอร์ (App Store)

เมชาแฮมสเตอร์ (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

    • สำหรับ Android — อีมู เลเตอร์ต้องใช้อิมเมจอีมูเลเตอร์กับ Google Play

หากคุณยังไม่มีโปรเจ็กต์ Unity และต้องการลองใช้ผลิตภัณฑ์ Firebase คุณสามารถดาวน์โหลดหนึ่งใน ตัวอย่าง การเริ่มต้นอย่างรวดเร็วของเรา

ขั้นตอนที่ 1 : สร้างโปรเจ็กต์ Firebase

ก่อนที่คุณจะเพิ่ม Firebase ลงในโปรเจ็กต์ Unity ได้ คุณต้องสร้างโปรเจ็กต์ Firebase เพื่อเชื่อมต่อกับโปรเจ็กต์ Unity ไปที่ ทำความเข้าใจโปรเจ็กต์ Firebase เพื่อเรียนรู้เพิ่มเติมเกี่ยวกับโปรเจ็กต์ Firebase

ขั้นตอนที่ 2 : ลงทะเบียนแอปของคุณด้วย Firebase

คุณลงทะเบียนแอปหรือเกมได้ตั้งแต่ 1 รายการขึ้นไปเพื่อเชื่อมต่อกับโปรเจ็กต์ Firebase

  1. ไปที่ คอนโซล Firebase

  2. ตรงกลางหน้าภาพรวมโครงการ ให้คลิกไอคอน Unity ( ) เพื่อเริ่มเวิร์กโฟลว์การตั้งค่า

    หากคุณได้เพิ่มแอปลงในโปรเจ็กต์ Firebase แล้ว ให้คลิก เพิ่มแอป เพื่อแสดงตัวเลือกแพลตฟอร์ม

  3. เลือกเป้าหมายการสร้างของโปรเจ็กต์ Unity ของคุณที่คุณต้องการลงทะเบียน หรือคุณสามารถเลือกลงทะเบียนทั้งสองเป้าหมายได้พร้อมกัน

  4. ป้อน ID เฉพาะแพลตฟอร์มของโปรเจ็กต์ Unity

    • สำหรับ iOS — ป้อนรหัส iOS ของโปรเจ็กต์ Unity ของคุณในฟิลด์ ID บันเดิล iOS

    • สำหรับ Android — ป้อนรหัส Android ของโครงการ Unity ของคุณในช่อง ชื่อแพ็คเกจ Android
      เงื่อนไข ชื่อแพ็คเกจ และ รหัสแอปพลิเคชัน มักใช้สลับกันได้

  5. (ไม่บังคับ) ป้อนชื่อเล่นเฉพาะแพลตฟอร์มของโปรเจ็กต์ Unity
    ชื่อเล่นเหล่านี้เป็นตัวระบุความสะดวกภายใน และมีเพียงคุณเท่านั้นที่เห็นในคอนโซล Firebase

  6. คลิก ลงทะเบียนแอป

ขั้นตอนที่ 3 : เพิ่มไฟล์การกำหนดค่า Firebase

  1. รับไฟล์การกำหนดค่า Firebase เฉพาะแพลตฟอร์มในเวิร์กโฟลว์การตั้งค่าคอนโซล Firebase

    • สำหรับ iOS — คลิก ดาวน์โหลด GoogleService-Info.plist

    • สำหรับ Android — คลิก ดาวน์โหลด google-services.json

  2. เปิดหน้าต่าง โปรเจ็ กต์ของโปรเจ็กต์ Unity ของคุณ จากนั้นย้ายไฟล์ปรับแต่งของคุณไปที่โฟลเดอร์ Assets

  3. กลับไปที่คอนโซล Firebase ในเวิร์กโฟลว์การตั้งค่า คลิก ถัดไป

ขั้นตอนที่ 4 : เพิ่ม Firebase Unity SDKs

  1. ในคอนโซล Firebase คลิก ดาวน์โหลด Firebase Unity SDK จากนั้นคลายซิป SDK ในตำแหน่งที่สะดวก

    • คุณดาวน์โหลด Firebase Unity SDK อีกครั้งได้ทุกเมื่อ

    • Firebase Unity SDK ไม่ใช่เฉพาะแพลตฟอร์ม

  2. ในโครงการ Unity ที่เปิดอยู่ ให้ไปที่ เนื้อหา > นำเข้าแพ็คเกจ > แพ็คเกจที่กำหนดเอง

  3. จาก 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

  4. ในหน้าต่าง Import Unity Package ให้คลิก Import

  5. กลับไปที่คอนโซล 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

  1. ตั้งค่าโปรเจ็กต์ Unity แพลตฟอร์มเดสก์ท็อปโดยทำตามคำแนะนำเดียวกันกับแพลตฟอร์มมือถือ (เริ่มต้นด้วยขั้นตอนการ ลงทะเบียนแอปของคุณด้วย Firebase ด้านบน)

  2. เรียกใช้โครงการ Unity ของคุณใน Unity IDE หรือเลือกสร้างโครงการ Unity สำหรับ เดสก์ท็อป

  3. (ไม่บังคับ) เรียกใช้โครงการ Unity ของคุณในโหมดแก้ไข

    นอกจากนี้ยังเรียกใช้ Firebase Unity SDK ในโหมดแก้ไขของ Unity ได้อีกด้วย ซึ่งอนุญาตให้ใช้ในปลั๊กอินตัวแก้ไข

    1. เมื่อคุณสร้าง FirebaseApp ที่ใช้โดยตัวแก้ไข อย่าใช้อินสแตนซ์เริ่มต้น

    2. ให้ระบุชื่อที่ไม่ซ้ำกับการเรียก 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 ดังนั้น คุณไม่จำเป็นต้องคอมไพล์โค้ดแบบมีเงื่อนไขเพื่อกำหนดเป้าหมายเดสก์ท็อป

ขั้นตอนถัดไป