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

พลังของ ความสามัคคี เกมกับเรา Firebase สามัคคี SDKs

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

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

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

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


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

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

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

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

  • (iOS เท่านั้น) ติดตั้งต่อไปนี้:

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

    • สำหรับ iOS - เป้าหมาย iOS ของคุณ 10 หรือสูงกว่า
    • สำหรับ Android - เป้าหมาย API ระดับ 16 (Jelly Bean) หรือสูงกว่า

  • ตั้งค่าอุปกรณ์จริงหรือใช้โปรแกรมจำลองเพื่อเรียกใช้แอปของคุณ

    • สำหรับ iOS - ตั้งค่าอุปกรณ์ iOS ทางกายภาพหรือใช้จำลอง iOS

    • สำหรับ Android - อีมูเลเตอร์ จะต้องใช้ภาพจำลองกับ Google Play

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

ขั้นตอนที่ 1: สร้างโครงการ Firebase

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

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

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

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

  2. ในใจกลางของหน้าภาพรวมโครงการคลิกไอคอนสามัคคี ( ) ที่จะเปิดตัวเวิร์กโฟลว์การติดตั้ง

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

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

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

    • สำหรับ iOS - ป้อนโครงการความสามัคคีของ iOS ID ใน รหัสชุด iOS ฟิลด์

    • สำหรับ Android - ป้อนโครงการความสามัคคีของ ID Android ใน Android ชื่อแพคเกจ ข้อมูล
      ชื่อแง่แพคเกจและบัตรประจำตัวแอพลิเคชันมักจะใช้สลับ

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

  6. คลิกแอปสมัครสมาชิก

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

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

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

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

  2. เปิดหน้าต่างโครงการของโครงการความสามัคคีของคุณแล้วย้ายไฟล์ config ของคุณ (s) ลงใน Assets โฟลเดอร์

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

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

  1. ในคอนโซล Firebase คลิกดาวน์โหลด Firebase สามัคคี SDK แล้วเปิดเครื่องรูด SDK สะดวกที่ไหนสักแห่ง

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

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

  2. ในโครงการของคุณเปิดสามัคคีนำทางไปยังสินทรัพย์> นำเข้าแพคเกจ> แพคเกจที่กำหนดเอง

  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. ในหน้าต่างนำเข้าสามัคคีแพคเกจคลิกนำเข้า

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

ขั้นตอนที่ 5: ยืนยันข้อกำหนดของ Google Play รุ่นบริการ

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

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

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

  3. (อุปกรณ์เสริม) เรียกใช้โครงการความสามัคคีของคุณในโหมดแก้ไข

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

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

    2. แต่ให้ชื่อที่ไม่ซ้ำกับ FirebaseApp.Create() โทร

      นี่เป็นสิ่งสำคัญที่จะหลีกเลี่ยงความขัดแย้งในตัวเลือกระหว่างอินสแตนซ์ที่ใช้โดย Unity IDE และอินสแตนซ์ที่ใช้โดยโปรเจ็กต์ Unity ของคุณ

ผลิตภัณฑ์ Firebase ที่รองรับ

เรียนรู้เพิ่มเติมเกี่ยวกับห้องสมุดสามัคคี Firebase ใน เอกสารอ้างอิง

Firebase สามัคคี SDK สนับสนุนผลิตภัณฑ์ Firebase ต่อไปนี้บน iOS และ Android:

ผลิตภัณฑ์ Firebase แพ็คเกจสามัคคี
AdMob เผยแพร่แยกต่างหากใน AdMob Unity Plugin
การวิเคราะห์ FirebaseAnalytics.unitypackage
การตรวจสอบสิทธิ์ FirebaseAuth.unitypackage
เมฆ 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 สามัคคี SDK รวมถึง การสนับสนุนเวิร์กโฟลว์เดสก์ทอป สำหรับกลุ่มย่อยของผลิตภัณฑ์ที่ช่วยให้บางส่วนของ Firebase จะใช้ในการแก้ไขและความสามัคคีในสก์ท็อปแบบสแตนด์อโลนสร้างบน Windows, MacOS และ Linux

ผลิตภัณฑ์ Firebase (เดสก์ท็อป) แพ็คเกจสามัคคี
การตรวจสอบสิทธิ์ FirebaseAuth.unitypackage
ฟังก์ชั่นคลาวด์ FirebaseFunctions.unitypackage
Cloud Firestore FirebaseFirestore.unitypackage
การจัดเก็บเมฆ FirebaseStorage.unitypackage
ฐานข้อมูลเรียลไทม์ FirebaseDatabase.unitypackage
การกำหนดค่าระยะไกล FirebaseRemoteConfig.unitypackage

Firebase จัดเตรียมไลบรารีเดสก์ท็อปที่เหลือเป็นการใช้งาน stub (ไม่ทำงาน) เพื่อความสะดวกในการสร้างสำหรับ Windows, macOS และ Linux ดังนั้น คุณไม่จำเป็นต้องคอมไพล์โค้ดแบบมีเงื่อนไขเพื่อกำหนดเป้าหมายเดสก์ท็อป

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