เริ่มต้นใช้งาน Gemini API โดยใช้ Firebase AI Logic SDK

Swift

คู่มือนี้ถือว่าคุณคุ้นเคยกับการใช้ Xcode เพื่อพัฒนาแอปสำหรับแพลตฟอร์ม Apple (เช่น iOS)

ตรวจสอบว่าสภาพแวดล้อมในการพัฒนาซอฟต์แวร์และแอปแพลตฟอร์ม Apple เป็นไปตามข้อกำหนดต่อไปนี้

• Xcode 26.2 ขึ้นไป
• แอปของคุณกำหนดเป้าหมายเป็น iOS 15 ขึ้นไป หรือ macOS 12 ขึ้นไป

Kotlin

คู่มือนี้ถือว่าคุณคุ้นเคยกับการใช้ Android Studio เพื่อพัฒนาแอปสำหรับ Android

ตรวจสอบว่าสภาพแวดล้อมในการพัฒนาซอฟต์แวร์และแอป Android เป็นไปตามข้อกำหนดต่อไปนี้

• Android Studio (เวอร์ชันล่าสุด)
• แอปของคุณกำหนดเป้าหมายเป็น API ระดับ 24 (Nougat) ขึ้นไป

Java

คู่มือนี้ถือว่าคุณคุ้นเคยกับการใช้ Android Studio เพื่อพัฒนาแอปสำหรับ Android

ตรวจสอบว่าสภาพแวดล้อมในการพัฒนาซอฟต์แวร์และแอป Android เป็นไปตามข้อกำหนดต่อไปนี้

• Android Studio (เวอร์ชันล่าสุด)
• แอปของคุณกำหนดเป้าหมายเป็น API ระดับ 24 (Nougat) ขึ้นไป

Web

คู่มือนี้ถือว่าคุณคุ้นเคยกับการใช้ JavaScript เพื่อพัฒนาเว็บแอป คู่มือนี้ไม่ขึ้นอยู่กับเฟรมเวิร์ก

ตรวจสอบว่าสภาพแวดล้อมในการพัฒนาซอฟต์แวร์และเว็บแอปเป็นไปตามข้อกำหนดต่อไปนี้

• (ไม่บังคับ) Node.js
• เว็บเบราว์เซอร์ที่ทันสมัย

Dart

คู่มือนี้จะถือว่าคุณคุ้นเคยกับการพัฒนาแอปด้วย Flutter แล้ว

ตรวจสอบว่าสภาพแวดล้อมในการพัฒนาซอฟต์แวร์และแอป Flutter เป็นไปตามข้อกำหนดต่อไปนี้

• Dart 3.2.0 ขึ้นไป

Unity

คู่มือนี้ถือว่าคุณคุ้นเคยกับการพัฒนาเกมด้วย Unity แล้ว

ตรวจสอบว่าสภาพแวดล้อมในการพัฒนาซอฟต์แวร์และเกม Unity เป็นไปตามข้อกำหนดต่อไปนี้

• Unity Editor 2022 LTS (2022.3) ขึ้นไป

Swift

ลองใช้แอปเริ่มต้นใช้งานด่วน

ใช้แอป Quickstart เพื่อลองใช้ SDK อย่างรวดเร็วและดูการใช้งาน Use Case ต่างๆ อย่างสมบูรณ์ หรือใช้แอป Quickstart หากคุณไม่มีแอปแพลตฟอร์ม Apple ของตัวเอง หากต้องการใช้แอป Quickstart คุณจะต้องเชื่อมต่อแอปกับโปรเจ็กต์ Firebase

ไปที่แอป Quick Start

ดูวิดีโอแนะนำ

วิดีโอนี้สาธิตวิธีเริ่มต้นใช้งาน Firebase AI Logic โดยการสร้างแอปวางแผนมื้ออาหารที่ทำงานด้วยระบบ AI ในชีวิตจริง ซึ่งจะสร้างสูตรอาหารจากพรอมต์ข้อความ

นอกจากนี้ คุณยังดาวน์โหลดและสำรวจฐานของโค้ดสำหรับแอปในวิดีโอได้ด้วย

ดูฐานของโค้ดสำหรับแอปวิดีโอ

Kotlin

ลองใช้แอปเริ่มต้นใช้งานด่วน

ใช้แอป Quickstart เพื่อลองใช้ SDK อย่างรวดเร็วและดูการใช้งาน Use Case ต่างๆ อย่างสมบูรณ์ หรือใช้แอป Quickstart หากคุณไม่มีแอป Android ของตัวเอง หากต้องการใช้แอป Quickstart คุณจะต้องเชื่อมต่อแอปกับโปรเจ็กต์ Firebase

ไปที่แอป Quick Start

ดูวิดีโอแนะนำ

วิดีโอนี้สาธิตวิธีเริ่มต้นใช้งาน Firebase AI Logic โดยการสร้างแอปวางแผนมื้ออาหารที่ทำงานด้วยระบบ AI ในชีวิตจริง ซึ่งจะสร้างสูตรอาหารจากพรอมต์ข้อความ

นอกจากนี้ คุณยังดาวน์โหลดและสำรวจฐานของโค้ดสำหรับแอปในวิดีโอได้ด้วย

ดูฐานของโค้ดสำหรับแอปวิดีโอ

Java

ลองใช้แอปเริ่มต้นใช้งานด่วน

ใช้แอป Quickstart เพื่อลองใช้ SDK อย่างรวดเร็วและดูการใช้งาน Use Case ต่างๆ อย่างสมบูรณ์ หรือใช้แอป Quickstart หากคุณไม่มีแอป Android ของตัวเอง หากต้องการใช้แอป Quickstart คุณจะต้องเชื่อมต่อแอปกับโปรเจ็กต์ Firebase

ไปที่แอป Quick Start

ดูวิดีโอแนะนำ

วิดีโอนี้สาธิตวิธีเริ่มต้นใช้งาน Firebase AI Logic โดยการสร้างแอปวางแผนมื้ออาหารที่ทำงานด้วยระบบ AI ในชีวิตจริง ซึ่งจะสร้างสูตรอาหารจากพรอมต์ข้อความ^*

นอกจากนี้ คุณยังดาวน์โหลดและสำรวจฐานของโค้ดสำหรับแอปในวิดีโอได้ด้วย

ดูฐานของโค้ดสำหรับแอปวิดีโอ

^{* วิดีโอนี้และแอปในวิดีโอเป็นภาษา Kotlin แต่ก็ยังช่วยให้นักพัฒนาซอฟต์แวร์ Java เข้าใจพื้นฐานเกี่ยวกับวิธีเริ่มต้นใช้งาน Firebase AI Logic ได้}

Web

ลองใช้แอปเริ่มต้นใช้งานด่วน

ใช้แอป Quickstart เพื่อลองใช้ SDK อย่างรวดเร็วและดูการใช้งาน Use Case ต่างๆ อย่างสมบูรณ์ หรือใช้แอป Quickstart หากคุณไม่มีเว็บแอปเป็นของตัวเอง หากต้องการใช้แอป Quickstart คุณจะต้องเชื่อมต่อแอปกับโปรเจ็กต์ Firebase

ไปที่แอป Quick Start

Dart

ลองใช้แอปเริ่มต้นใช้งานด่วน

ใช้แอป Quickstart เพื่อลองใช้ SDK อย่างรวดเร็วและดูการใช้งาน Use Case ต่างๆ อย่างสมบูรณ์ หรือใช้แอป Quickstart หากคุณไม่มีแอป Flutter ของตัวเอง หากต้องการใช้แอป Quickstart คุณจะต้องเชื่อมต่อแอปกับโปรเจ็กต์ Firebase

ไปที่แอป Quick Start

ดูวิดีโอแนะนำ

วิดีโอนี้สาธิตวิธีเริ่มต้นใช้งาน Firebase AI Logic โดยการสร้างแอปวางแผนมื้ออาหารที่ทำงานด้วยระบบ AI ในชีวิตจริง ซึ่งจะสร้างสูตรอาหารจากพรอมต์ข้อความ

นอกจากนี้ คุณยังดาวน์โหลดและสำรวจฐานของโค้ดสำหรับแอปในวิดีโอได้ด้วย

ดูฐานของโค้ดสำหรับแอปวิดีโอ

Unity

ลองใช้แอปเริ่มต้นใช้งานด่วน

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

ไปที่แอป Quick Start

Swift

ใช้ Swift Package Manager เพื่อติดตั้งและจัดการทรัพยากร Dependency ของ Firebase ดูข้อมูลเกี่ยวกับตัวเลือกการติดตั้งอื่นๆ หากจำเป็น

ไลบรารี Firebase AI Logic ให้สิทธิ์เข้าถึง API สำหรับการโต้ตอบกับโมเดล Gemini ไลบรารีนี้รวมอยู่ใน SDK ของ Firebase สำหรับแพลตฟอร์ม Apple (firebase-ios-sdk)

หากคุณใช้ Firebase อยู่แล้ว ให้ตรวจสอบว่าแพ็กเกจ Firebase เป็นเวอร์ชัน 12.5.0 ขึ้นไป

1. ใน Xcode ขณะที่โปรเจ็กต์แอปเปิดอยู่ ให้ไปที่ไฟล์ > เพิ่มทรัพยากร Dependency ของแพ็กเกจ

2. เมื่อได้รับข้อความแจ้ง ให้เพิ่มที่เก็บ SDK ของ Firebase สำหรับแพลตฟอร์ม Apple ดังนี้

   https://github.com/firebase/firebase-ios-sdk
   

3. เลือก SDK เวอร์ชันล่าสุด

4. เลือกคลัง FirebaseAILogic และคลัง FirebaseAppCheck

เมื่อเสร็จแล้ว Xcode จะเริ่มแก้ไขและดาวน์โหลดทรัพยากร Dependency ในเบื้องหลังโดยอัตโนมัติ

Kotlin

Firebase AI Logic SDK สำหรับ Android (firebase-ai) ให้สิทธิ์เข้าถึง API สำหรับการโต้ตอบกับโมเดล Gemini

ในไฟล์ Gradle ของโมดูล (ระดับแอป) (เช่น <project>/<app-module>/build.gradle.kts) ให้เพิ่มทรัพยากร Dependency สำหรับคลัง Firebase AI Logic และ App Check สำหรับ Android เราขอแนะนำให้ใช้ Firebase Android BoM เพื่อควบคุมการกำหนดเวอร์ชันของไลบรารี

dependencies {
  // ... other androidx dependencies

  // Import the BoM for the Firebase platform
  implementation(platform("com.google.firebase:firebase-bom:35.0.2"))

  // Add the dependencies for the Firebase AI Logic and App Check libraries
  // When using the BoM, you don't specify versions in Firebase library dependencies
  implementation("com.google.firebase:firebase-ai")
  implementation("com.google.firebase:firebase-appcheck-debug")
}

การใช้ Firebase Android BoM จะทำให้แอปใช้ไลบรารี Firebase Android เวอร์ชันที่เข้ากันได้อยู่เสมอ

dependencies {
  // Add the dependencies for the Firebase AI Logic and App Check libraries
  // When NOT using the BoM, you must specify versions in Firebase library dependencies
  implementation("com.google.firebase:firebase-ai:18.0.0")
  implementation("com.google.firebase:firebase-appcheck-debug:20.0.0")
}

Java

Firebase AI Logic SDK สำหรับ Android (firebase-ai) ให้สิทธิ์เข้าถึง API สำหรับการโต้ตอบกับโมเดล Gemini

ในไฟล์ Gradle ของโมดูล (ระดับแอป) (เช่น <project>/<app-module>/build.gradle.kts) ให้เพิ่มทรัพยากร Dependency สำหรับคลัง Firebase AI Logic และ App Check สำหรับ Android เราขอแนะนำให้ใช้ Firebase Android BoM เพื่อควบคุมการกำหนดเวอร์ชันของไลบรารี

สำหรับ Java คุณต้องเพิ่มไลบรารีอีก 2 รายการ

dependencies {
  // ... other androidx dependencies

  // Import the BoM for the Firebase platform
  implementation(platform("com.google.firebase:firebase-bom:35.0.2"))

  // Add the dependencies for the Firebase AI Logic and App Check libraries
  // When using the BoM, you don't specify versions in Firebase library dependencies
  implementation("com.google.firebase:firebase-ai")
  implementation("com.google.firebase:firebase-appcheck-debug")

  // Required for one-shot operations (to use `ListenableFuture` from Guava Android)
  implementation("com.google.guava:guava:31.0.1-android")

  // Required for streaming operations (to use `Publisher` from Reactive Streams)
  implementation("org.reactivestreams:reactive-streams:1.0.4")
}

การใช้ Firebase Android BoM จะทำให้แอปใช้ไลบรารี Firebase Android เวอร์ชันที่เข้ากันได้อยู่เสมอ

dependencies {
  // Add the dependencies for the Firebase AI Logic and App Check libraries
  // When NOT using the BoM, you must specify versions in Firebase library dependencies
  implementation("com.google.firebase:firebase-ai:18.0.0")
  implementation("com.google.firebase:firebase-appcheck-debug:20.0.0")
}

Web

ไลบรารี Firebase AI Logic ให้สิทธิ์เข้าถึง API สำหรับการโต้ตอบกับโมเดล Gemini ไลบรารีนี้รวมอยู่ใน Firebase JavaScript SDK สำหรับเว็บ

1. ติดตั้ง Firebase JS SDK สำหรับเว็บโดยใช้ npm:

   npm install firebase
   

2. เริ่มต้น Firebase ในแอปโดยทำดังนี้

   import { initializeApp } from "firebase/app";
   import { initializeAppCheck, DebugProvider } from "firebase/app-check";
   
   // TODO(developer) Replace the following with your app's Firebase configuration
   // See: https://firebase.google.com/docs/web/learn-more#config-object
   const firebaseConfig = {
     // ...
   };
   
   // Initialize FirebaseApp
   const firebaseApp = initializeApp(firebaseConfig);
   

Dart

ปลั๊กอิน Firebase AI Logic สำหรับ Flutter (firebase_ai) ให้สิทธิ์เข้าถึง API สำหรับการโต้ตอบกับโมเดล Gemini

1. จากไดเรกทอรีโปรเจ็กต์ Flutter ให้เรียกใช้คำสั่งต่อไปนี้เพื่อติดตั้งปลั๊กอิน Firebase AI Logic และ App Check

   flutter pub add firebase_ai firebase_app_check
   

2. ในไฟล์ lib/main.dart ให้นำเข้าปลั๊กอิน Firebase AI Logic และ App Check ดังนี้

   import 'package:firebase_core/firebase_core.dart';
   import 'package:firebase_ai/firebase_ai.dart';
   import 'package:firebase_app_check/firebase_app_check.dart';
   import 'firebase_options.dart';
   

3. นอกจากนี้ ในไฟล์ lib/main.dart ให้ตรวจสอบว่าคุณได้เริ่มต้น Firebase โดยใช้ออบเจ็กต์ DefaultFirebaseOptions ที่ส่งออกโดยไฟล์การกำหนดค่า ดังนี้

   await Firebase.initializeApp(
     options: DefaultFirebaseOptions.currentPlatform,
   );
   

4. สร้างแอปพลิเคชัน Flutter ใหม่โดยทำดังนี้

   flutter run
   

Unity

1. ดาวน์โหลด Firebase Unity SDK แล้วแตกไฟล์ SDK ไว้ในตำแหน่งที่สะดวก

   SDK ของ Firebase Unity ไม่ได้เจาะจงแพลตฟอร์ม

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

3. จาก SDK ที่แตกไฟล์แล้ว ให้เลือกแพ็กเกจ FirebaseAI และ FirebaseAppCheck

4. คลิกนำเข้า ในหน้าต่างนำเข้าแพ็กเกจ Unity

Swift

วิธีใช้ผู้ให้บริการแก้ไขข้อบกพร่องขณะเรียกใช้แอปในเครื่องจำลองแบบอินเทอร์แอกทีฟ (เช่น ระหว่างการพัฒนาในเครื่อง) มีดังนี้

1. ในโปรเจ็กต์ Xcode ให้นําเข้า FirebaseAppCheck และเริ่มต้น App Check ด้วยโรงงานผู้ให้บริการแก้ไขข้อบกพร่องก่อนกําหนดค่า Firebase

   import SwiftUI
   import FirebaseCore
   import FirebaseAppCheck
   
   @main
   struct YourApp: App {
     init() {
       let providerFactory = AppCheckDebugProviderFactory()
       AppCheck.setAppCheckProviderFactory(providerFactory)
       FirebaseApp.configure()
     }
   
     var body: some Scene {
       WindowGroup {
         NavigationView {
           ContentView()
         }
       }
     }
   }
   

2. รับโทเค็นการแก้ไขข้อบกพร่องโดยทำดังนี้

   1. เปิดแอปในเครื่องจำลองหรือในอุปกรณ์ทดสอบ

   2. เปิดคอนโซล Xcode แล้วมองหาโทเค็นการแก้ไขข้อบกพร่อง App Check เช่น

      <Warning> [AppCheckCore][I-GAC004001] App Check debug token: '123a4567-b89c-12d3-e456-789012345678'.
      

   3. คัดลอกโทเค็น (เช่น 123a4567-b89c-12d3-e456-789012345678)

3. ลงทะเบียนโทเค็นการแก้ไขข้อบกพร่องกับ App Check โดยทำดังนี้

   1. ในคอนโซล Firebase ให้ไปที่แท็บความปลอดภัย > App Check > แอป

   2. ค้นหาแอปของคุณ คลิกเมนูรายการเพิ่มเติม (more_vert) แล้วเลือกจัดการโทเค็นการแก้ไขข้อบกพร่อง

   3. ทำตามวิธีการบนหน้าจอเพื่อลงทะเบียนโทเค็นการแก้ไขข้อบกพร่อง

ดูรายละเอียดเกี่ยวกับผู้ให้บริการแก้ไขข้อบกพร่อง (รวมถึงวิธีรับโทเค็นการแก้ไขข้อบกพร่องใหม่) ได้ที่เอกสารประกอบอย่างเป็นทางการของ App Check

Kotlin

วิธีใช้ผู้ให้บริการแก้ไขข้อบกพร่องขณะเรียกใช้แอปในโปรแกรมจำลองแบบอินเทอร์แอกทีฟ (เช่น ระหว่างการพัฒนาในเครื่อง) มีดังนี้

1. ในบิลด์การแก้ไขข้อบกพร่อง ให้กำหนดค่า App Check เพื่อใช้โรงงานผู้ให้บริการแก้ไขข้อบกพร่อง ดังนี้

   Firebase.initialize(context = this)
   Firebase.appCheck.installAppCheckProviderFactory(
       DebugAppCheckProviderFactory.getInstance(),
   )
   MainActivity.kt

2. รับโทเค็นการแก้ไขข้อบกพร่องโดยทำดังนี้

   1. เรียกใช้แอปในโปรแกรมจำลองหรือในอุปกรณ์ทดสอบ

   2. มองหาโทเค็นการแก้ไขข้อบกพร่อง App Check ในบันทึก เช่น

      D DebugAppCheckProvider: Enter this debug secret into the allow list
      in the Firebase Console for your project: 123a4567-b89c-12d3-e456-789012345678
      

   3. คัดลอกโทเค็น (เช่น 123a4567-b89c-12d3-e456-789012345678)

3. ลงทะเบียนโทเค็นการแก้ไขข้อบกพร่องกับ App Check โดยทำดังนี้

   1. ในคอนโซล Firebase ให้ไปที่แท็บความปลอดภัย > App Check > แอป

   2. ค้นหาแอปของคุณ คลิกเมนูรายการเพิ่มเติม (more_vert) แล้วเลือกจัดการโทเค็นการแก้ไขข้อบกพร่อง

   3. ทำตามวิธีการบนหน้าจอเพื่อลงทะเบียนโทเค็นการแก้ไขข้อบกพร่อง

ดูรายละเอียดเกี่ยวกับผู้ให้บริการแก้ไขข้อบกพร่อง (รวมถึงวิธีรับโทเค็นการแก้ไขข้อบกพร่องใหม่) ได้ที่เอกสารประกอบอย่างเป็นทางการของ App Check

Java

วิธีใช้ผู้ให้บริการแก้ไขข้อบกพร่องขณะเรียกใช้แอปในโปรแกรมจำลองแบบอินเทอร์แอกทีฟ (เช่น ระหว่างการพัฒนาในเครื่อง) มีดังนี้

1. ในบิลด์การแก้ไขข้อบกพร่อง ให้กำหนดค่า App Check เพื่อใช้โรงงานผู้ให้บริการแก้ไขข้อบกพร่อง ดังนี้

   FirebaseApp.initializeApp(/*context=*/ this);
   FirebaseAppCheck firebaseAppCheck = FirebaseAppCheck.getInstance();
   firebaseAppCheck.installAppCheckProviderFactory(
           DebugAppCheckProviderFactory.getInstance());
   MainActivity.java

2. รับโทเค็นการแก้ไขข้อบกพร่องโดยทำดังนี้

   1. เรียกใช้แอปในโปรแกรมจำลองหรือในอุปกรณ์ทดสอบ

   2. มองหาโทเค็นการแก้ไขข้อบกพร่อง App Check ในบันทึก เช่น

      D DebugAppCheckProvider: Enter this debug secret into the allow list
      in the Firebase Console for your project: 123a4567-b89c-12d3-e456-789012345678
      

   3. คัดลอกโทเค็น (เช่น 123a4567-b89c-12d3-e456-789012345678)

3. ลงทะเบียนโทเค็นการแก้ไขข้อบกพร่องกับ App Check โดยทำดังนี้

   1. ในคอนโซล Firebase ให้ไปที่แท็บความปลอดภัย > App Check > แอป

   2. ค้นหาแอปของคุณ คลิกเมนูรายการเพิ่มเติม (more_vert) แล้วเลือกจัดการโทเค็นการแก้ไขข้อบกพร่อง

   3. ทำตามวิธีการบนหน้าจอเพื่อลงทะเบียนโทเค็นการแก้ไขข้อบกพร่อง

ดูรายละเอียดเกี่ยวกับผู้ให้บริการแก้ไขข้อบกพร่อง (รวมถึงวิธีรับโทเค็นการแก้ไขข้อบกพร่องใหม่) ได้ที่เอกสารประกอบอย่างเป็นทางการของ App Check

Web

วิธีใช้ผู้ให้บริการแก้ไขข้อบกพร่องขณะเรียกใช้แอปจาก localhost แบบอินเทอร์แอกทีฟ (เช่น ระหว่างการพัฒนาในเครื่อง) มีดังนี้

1. ในบิลด์การแก้ไขข้อบกพร่อง ให้เปิดใช้โหมดแก้ไขข้อบกพร่องโดยตั้งค่า self.FIREBASE_APPCHECK_DEBUG_TOKEN เป็น true ก่อนเริ่มต้น App Check เช่น

   self.FIREBASE_APPCHECK_DEBUG_TOKEN = true;
   initializeAppCheck(app, { /* App Check options */ });
   

2. ไปที่เว็บแอปในเครื่องและเปิดเครื่องมือสำหรับนักพัฒนาซอฟต์แวร์ของเบราว์เซอร์ ในคอนโซลดีบัก คุณจะเห็นโทเค็นดีบักดังนี้

   AppCheck debug token: "123a4567-b89c-12d3-e456-789012345678".
   You will need to safelist it in the Firebase console for it to work.
   

3. ลงทะเบียนโทเค็นการแก้ไขข้อบกพร่องกับ App Check โดยทำดังนี้

   1. ในคอนโซล Firebase ให้ไปที่แท็บความปลอดภัย > App Check > แอป

   2. ค้นหาแอปของคุณ คลิกเมนูรายการเพิ่มเติม (more_vert) แล้วเลือกจัดการโทเค็นการแก้ไขข้อบกพร่อง

   3. ทำตามวิธีการบนหน้าจอเพื่อลงทะเบียนโทเค็นการแก้ไขข้อบกพร่อง

ดูรายละเอียดเกี่ยวกับผู้ให้บริการแก้ไขข้อบกพร่อง (รวมถึงวิธีรับโทเค็นการแก้ไขข้อบกพร่องใหม่) ได้ที่เอกสารประกอบอย่างเป็นทางการของ App Check

Dart

ดูรายละเอียดเกี่ยวกับผู้ให้บริการแก้ไขข้อบกพร่อง (รวมถึงวิธีรับโทเค็นการแก้ไขข้อบกพร่องใหม่) ได้ที่เอกสารประกอบอย่างเป็นทางการของ App Check

Unity

วิธีใช้ผู้ให้บริการแก้ไขข้อบกพร่องขณะเรียกใช้แอปในโปรแกรมจำลองแบบอินเทอร์แอกทีฟ (เช่น ระหว่างการพัฒนาในเครื่อง) มีดังนี้

1. สร้างโทเค็นการแก้ไขข้อบกพร่องในคอนโซล Firebase โดยทำดังนี้

   1. ในคอนโซล Firebase ให้ไปที่ความปลอดภัย > App Check > แท็บแอป

   2. ค้นหาแอปของคุณ คลิกเมนูรายการเพิ่มเติม (more_vert) แล้วเลือกจัดการโทเค็นการแก้ไขข้อบกพร่อง

   3. ทำตามวิธีการบนหน้าจอเพื่อสร้างโทเค็นการแก้ไขข้อบกพร่องใหม่

2. เพิ่มโค้ดต่อไปนี้ในโค้ดการเริ่มต้นของแอป

   using Firebase.AppCheck;
   
   void InitializeFirebase() {
     // Configure the Debug Provider factory with your debug token.
     DebugAppCheckProviderFactory.Instance.SetDebugToken("YOUR_DEBUG_TOKEN");
   
     // Set App Check to use the debug provider factory
     FirebaseAppCheck.SetAppCheckProviderFactory(
       DebugAppCheckProviderFactory.Instance);
   
     // Proceed to initialize Firebase as normal
   }
   

ดูรายละเอียดเกี่ยวกับผู้ให้บริการแก้ไขข้อบกพร่อง (รวมถึงวิธีรับโทเค็นการแก้ไขข้อบกพร่องใหม่) ได้ที่เอกสารประกอบอย่างเป็นทางการของ App Check

Swift

import FirebaseAILogic

// Initialize the Gemini Developer API backend service
let ai = FirebaseAI.firebaseAI(backend: .googleAI())

// Create a `GenerativeModel` instance with a model that supports your use case
let model = ai.generativeModel(modelName: "gemini-3.8-flash")

Kotlin

// Initialize the Gemini Developer API backend service.
// Create a `GenerativeModel` instance with a model that supports your use case.
val model = Firebase.ai(backend = GenerativeBackend.googleAI())
                        .generativeModel("gemini-3.8-flash")

Java

// Initialize the Gemini Developer API backend service.
// Create a `GenerativeModel` instance with a model that supports your use case.
GenerativeModel ai = FirebaseAI.getInstance(GenerativeBackend.googleAI())
        .generativeModel("gemini-3.8-flash");

// Use the GenerativeModelFutures Java compatibility layer which offers
// support for ListenableFuture and Publisher APIs
GenerativeModelFutures model = GenerativeModelFutures.from(ai);

Web

import { initializeApp } from "firebase/app";
import { getAI, getGenerativeModel, GoogleAIBackend } from "firebase/ai";

// TODO(developer): Replace the following with your app's Firebase configuration
// See: https://firebase.google.com/docs/web/learn-more#config-object
const firebaseConfig = {
  // ...
};

// Initialize FirebaseApp
const firebaseApp = initializeApp(firebaseConfig);

// Initialize the Gemini Developer API backend service.
const ai = getAI(firebaseApp, { backend: new GoogleAIBackend() });

// Create a `GenerativeModel` instance with a model that supports your use case.
const model = getGenerativeModel(ai, { model: "gemini-3.8-flash" });

Dart

import 'package:firebase_ai/firebase_ai.dart';
import 'package:firebase_core/firebase_core.dart';
import 'firebase_options.dart';

// Initialize FirebaseApp
await Firebase.initializeApp(
  options: DefaultFirebaseOptions.currentPlatform,
);

// Initialize the Gemini Developer API backend service
// Create a `GenerativeModel` instance with a model that supports your use case
final model =
      FirebaseAI.googleAI().generativeModel(model: 'gemini-3.8-flash');

Unity

using Firebase;
using Firebase.AI;

// Initialize the Gemini Developer API backend service.
var ai = FirebaseAI.GetInstance(FirebaseAI.Backend.GoogleAI());

// Create a `GenerativeModel` instance with a model that supports your use case.
var model = ai.GetGenerativeModel(modelName: "gemini-3.8-flash");

Swift

import FirebaseAILogic

// Initialize the Gemini Developer API backend service
let ai = FirebaseAI.firebaseAI(backend: .googleAI())

// Create a `GenerativeModel` instance with a model that supports your use case
let model = ai.generativeModel(modelName: "gemini-3.8-flash")

// Provide a prompt that contains text
let prompt = "Write a story about a magic backpack."

// To generate text output, call generateContent with the text input
let response = try await model.generateContent(prompt)
print(response.text ?? "No text in response.")

Kotlin

// Initialize the Gemini Developer API backend service.
// Create a `GenerativeModel` instance with a model that supports your use case.
val model = Firebase.ai(backend = GenerativeBackend.googleAI())
                        .generativeModel("gemini-3.8-flash")

// Provide a prompt that contains text
val prompt = "Write a story about a magic backpack."

// To generate text output, call generateContent with the text input
val response = model.generateContent(prompt)
print(response.text)

Java

// Initialize the Gemini Developer API backend service.
// Create a `GenerativeModel` instance with a model that supports your use case.
GenerativeModel ai = FirebaseAI.getInstance(GenerativeBackend.googleAI())
        .generativeModel("gemini-3.8-flash");

// Use the GenerativeModelFutures Java compatibility layer which offers
// support for ListenableFuture and Publisher APIs
GenerativeModelFutures model = GenerativeModelFutures.from(ai);

// Provide a prompt that contains text
Content prompt = new Content.Builder()
    .addText("Write a story about a magic backpack.")
    .build();

// To generate text output, call generateContent with the text input
ListenableFuture<GenerateContentResponse> response = model.generateContent(prompt);
Futures.addCallback(response, new FutureCallback<GenerateContentResponse>() {
    @Override
    public void onSuccess(GenerateContentResponse result) {
        String resultText = result.getText();
        System.out.println(resultText);
    }

    @Override
    public void onFailure(Throwable t) {
        t.printStackTrace();
    }
}, executor);

Web

import { initializeApp } from "firebase/app";
import { getAI, getGenerativeModel, GoogleAIBackend } from "firebase/ai";

// TODO(developer): Replace the following with your app's Firebase configuration
// See: https://firebase.google.com/docs/web/learn-more#config-object
const firebaseConfig = {
  // ...
};

// Initialize FirebaseApp
const firebaseApp = initializeApp(firebaseConfig);

// Initialize the Gemini Developer API backend service.
const ai = getAI(firebaseApp, { backend: new GoogleAIBackend() });

// Create a `GenerativeModel` instance with a model that supports your use case.
const model = getGenerativeModel(ai, { model: "gemini-3.8-flash" });

// Wrap in an async function so you can use await
async function run() {
  // Provide a prompt that contains text
  const prompt = "Write a story about a magic backpack."

  // To generate text output, call generateContent with the text input
  const result = await model.generateContent(prompt);

  const response = result.response;
  const text = response.text();
  console.log(text);
}

run();

Dart

import 'package:firebase_ai/firebase_ai.dart';
import 'package:firebase_core/firebase_core.dart';
import 'firebase_options.dart';

// Initialize FirebaseApp
await Firebase.initializeApp(
  options: DefaultFirebaseOptions.currentPlatform,
);

// Initialize the Gemini Developer API backend service
// Create a `GenerativeModel` instance with a model that supports your use case
final model =
      FirebaseAI.googleAI().generativeModel(model: 'gemini-3.8-flash');

// Provide a prompt that contains text
final prompt = [Content.text('Write a story about a magic backpack.')];

// To generate text output, call generateContent with the text input
final response = await model.generateContent(prompt);
print(response.text);

Unity

using Firebase;
using Firebase.AI;

// Initialize the Gemini Developer API backend service.
var ai = FirebaseAI.GetInstance(FirebaseAI.Backend.GoogleAI());

// Create a `GenerativeModel` instance with a model that supports your use case.
var model = ai.GetGenerativeModel(modelName: "gemini-3.8-flash");

// Provide a prompt that contains text
var prompt = "Write a story about a magic backpack.";

// To generate text output, call GenerateContentAsync with the text input
var response = await model.GenerateContentAsync(prompt);
UnityEngine.Debug.Log(response.Text ?? "No text in response.");