เพิ่ม Firebase ในโครงการ Unity ของคุณ

เพิ่มประสิทธิภาพเกม Unity ของคุณด้วย Firebase Unity SDK ของเรา

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

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

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

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


ค้นหาข้อมูลเพิ่มเติมเกี่ยวกับการเพิ่มประสิทธิภาพเกมของคุณด้วย Firebase ได้ที่ หน้าเกม Firebase ของเรา

เพิ่ม Firebase ในโครงการ Unity ของคุณแล้วหรือยัง? ตรวจสอบให้แน่ใจว่าคุณใช้ Firebase Unity SDK เวอร์ชันล่าสุด

ข้อกำหนดเบื้องต้น

  • ติดตั้ง Unity 2019.1 หรือใหม่กว่า เวอร์ชันก่อนหน้าอาจเข้ากันได้ แต่จะไม่ได้รับการสนับสนุนอย่างแข็งขัน การสนับสนุน Unity 2019.1 ถือว่าเลิกใช้แล้ว และจะไม่ได้รับการสนับสนุนอีกต่อไปหลังจากการเปิดตัวรุ่นหลักครั้งต่อไป

  • (แพลตฟอร์ม Apple เท่านั้น) ติดตั้งสิ่งต่อไปนี้:

    • Xcode 13.3.1 หรือสูงกว่า
    • CocoaPods 1.12.0 หรือสูงกว่า
  • ตรวจสอบให้แน่ใจว่าโครงการ Unity ของคุณตรงตามข้อกำหนดเหล่านี้:

    • สำหรับ iOS — กำหนดเป้าหมายเป็น iOS 11 หรือสูงกว่า
    • สำหรับ tvOS - กำหนดเป้าหมาย tvOS 12 หรือสูงกว่า
    • สำหรับ Android — กำหนดเป้าหมาย API ระดับ 19 (KitKat) หรือสูงกว่า
  • ตั้งค่าอุปกรณ์ทางกายภาพหรือใช้โปรแกรมจำลองเพื่อเรียกใช้แอปของคุณ

    • สำหรับแพลตฟอร์ม Apple — ตั้งค่าอุปกรณ์จริงหรือใช้ iOS หรือเครื่องจำลอง tvOS

    • สำหรับ 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. ป้อนรหัสเฉพาะแพลตฟอร์มของโปรเจ็กต์ Unity

    • สำหรับ iOS — ป้อนรหัส iOS ของโปรเจ็กต์ Unity ในช่อง รหัสชุด 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 SDK

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

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

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

  2. ในโปรเจ็กต์ Unity ที่เปิดอยู่ ให้ไปที่ Assets > Import Package > Custom Package

  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. ในหน้าต่าง นำเข้า Unity Package คลิก นำเข้า

  5. ย้อนกลับไปในคอนโซล Firebase ในขั้นตอนการตั้งค่า ให้คลิก ถัดไป

ขั้นตอนที่ 5 : ยืนยันข้อกำหนดเวอร์ชันบริการ Google Play

Firebase Unity SDK สำหรับ Android ต้องใช้ บริการ Google Play ซึ่งต้องเป็นเวอร์ชันล่าสุดก่อนจึงจะสามารถใช้ SDK ได้

เพิ่มคำสั่งต่อไปนี้ using คำสั่งและรหัสการเริ่มต้นที่จุดเริ่มต้นของแอปพลิเคชันของคุณ คุณสามารถตรวจสอบและเลือกที่จะอัปเดตบริการ Google Play เป็นเวอร์ชันที่ Firebase Unity SDK กำหนดก่อนที่จะเรียกใช้วิธีอื่นใน 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.
  }
});

คุณทุกชุด! โปรเจ็กต์ Unity ของคุณลงทะเบียนและกำหนดค่าให้ใช้ Firebase แล้ว

หากคุณมีปัญหาในการตั้งค่า โปรดไปที่ การแก้ไขปัญหาและคำถามที่พบบ่อยของ Unity

ตั้งค่าเวิร์กโฟลว์เดสก์ท็อป ( เบต้า )

เมื่อคุณสร้างเกม มักจะง่ายกว่ามากในการทดสอบเกมของคุณใน Unity Editor และบนแพลตฟอร์มเดสก์ท็อปก่อน จากนั้นจึงปรับใช้และทดสอบบนอุปกรณ์มือถือในภายหลังในการพัฒนา เพื่อรองรับเวิร์กโฟลว์นี้ เราได้จัดเตรียม ชุดย่อยของ 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 ที่พร้อมใช้งานสำหรับอุปกรณ์เคลื่อนที่

Firebase Unity SDK รองรับผลิตภัณฑ์ Firebase ต่อไปนี้บน Apple และ Android :

ผลิตภัณฑ์ไฟร์เบส แพ็คเกจความสามัคคี
แอดโมบ เผยแพร่แยกต่างหากในปลั๊กอิน 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 ดังนั้นคุณไม่จำเป็นต้องคอมไพล์โค้ดแบบมีเงื่อนไขเพื่อกำหนดเป้าหมายเดสก์ท็อป

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