คู่มือนี้จะแสดงวิธีเริ่มต้นการเรียกไปยัง Gemini API โดยตรงจากแอปโดยใช้ Firebase AI LogicSDK ของไคลเอ็นต์ สำหรับแพลตฟอร์มที่คุณเลือก
ข้อกำหนดเบื้องต้น
Swift
คู่มือนี้ถือว่าคุณคุ้นเคยกับการใช้ Xcode เพื่อพัฒนาแอปสำหรับ แพลตฟอร์มของ Apple (เช่น iOS)
ตรวจสอบว่าสภาพแวดล้อมในการพัฒนาและแอปแพลตฟอร์ม Apple เป็นไปตามข้อกำหนดต่อไปนี้
- Xcode 26.2 ขึ้นไป
- แอปของคุณกำหนดเป้าหมายเป็น iOS 15 ขึ้นไป หรือ macOS 12 ขึ้นไป
Kotlin
คู่มือนี้ถือว่าคุณคุ้นเคยกับการใช้ Android Studio เพื่อพัฒนา แอปสำหรับ Android
ตรวจสอบว่าสภาพแวดล้อมในการพัฒนาซอฟต์แวร์และแอป Android เป็นไปตามข้อกำหนดต่อไปนี้
- Android Studio (เวอร์ชันล่าสุด)
- แอปของคุณกำหนดเป้าหมายเป็น API ระดับ 21 ขึ้นไป
Java
คู่มือนี้ถือว่าคุณคุ้นเคยกับการใช้ Android Studio เพื่อพัฒนา แอปสำหรับ Android
ตรวจสอบว่าสภาพแวดล้อมในการพัฒนาซอฟต์แวร์และแอป Android เป็นไปตามข้อกำหนดต่อไปนี้
- Android Studio (เวอร์ชันล่าสุด)
- แอปของคุณกำหนดเป้าหมายเป็น API ระดับ 21 ขึ้นไป
Web
คู่มือนี้ถือว่าคุณคุ้นเคยกับการใช้ JavaScript เพื่อพัฒนา เว็บแอป คู่มือนี้ไม่ขึ้นอยู่กับเฟรมเวิร์ก
ตรวจสอบว่าสภาพแวดล้อมในการพัฒนาซอฟต์แวร์และเว็บแอปเป็นไปตามข้อกำหนดต่อไปนี้
- (ไม่บังคับ) Node.js
- เว็บเบราว์เซอร์ที่ทันสมัย
Dart
คู่มือนี้จะถือว่าคุณคุ้นเคยกับการพัฒนาแอปด้วย Flutter
ตรวจสอบว่าสภาพแวดล้อมในการพัฒนาและแอป Flutter เป็นไปตามข้อกำหนดต่อไปนี้
- Dart 3.2.0 ขึ้นไป
Unity
คู่มือนี้ถือว่าคุณคุ้นเคยกับการพัฒนาเกมด้วย Unity
ตรวจสอบว่าสภาพแวดล้อมในการพัฒนาซอฟต์แวร์และเกม Unity เป็นไปตามข้อกำหนดต่อไปนี้
- Unity Editor 2021 LTS ขึ้นไป
ดูแหล่งข้อมูลที่เป็นประโยชน์
Swift
ลองใช้แอปเริ่มต้นอย่างรวดเร็ว
ใช้แอปเริ่มต้นอย่างรวดเร็วเพื่อลองใช้ SDK อย่างรวดเร็วและดูการติดตั้งใช้งานที่สมบูรณ์ ของกรณีการใช้งานต่างๆ หรือใช้แอปเริ่มต้นอย่างรวดเร็วหากคุณไม่มีแอปแพลตฟอร์ม Apple ของตัวเอง หากต้องการใช้แอปเริ่มต้นอย่างรวดเร็ว คุณจะต้องเชื่อมต่อแอปกับโปรเจ็กต์ Firebase
ดูวิดีโอบทแนะนำ
วิดีโอนี้แสดงวิธีเริ่มต้นใช้งาน Firebase AI Logic โดย การสร้างแอปวางแผนมื้ออาหารที่ทำงานด้วยระบบ AI ในโลกแห่งความเป็นจริง ซึ่งสร้างสูตรอาหารจาก พรอมต์ข้อความ
นอกจากนี้ คุณยังดาวน์โหลดและสำรวจฐานของโค้ดของแอปในวิดีโอได้ด้วย
Kotlin
ลองใช้แอปเริ่มต้นอย่างรวดเร็ว
ใช้แอปเริ่มต้นอย่างรวดเร็วเพื่อลองใช้ SDK อย่างรวดเร็วและดูการติดตั้งใช้งานที่สมบูรณ์ ของกรณีการใช้งานต่างๆ หรือใช้แอปเริ่มต้นอย่างรวดเร็วหากคุณไม่มีแอป Android ของตัวเอง หากต้องการใช้แอปเริ่มต้นอย่างรวดเร็ว คุณจะต้องเชื่อมต่อแอปกับโปรเจ็กต์ Firebase
ดูวิดีโอบทแนะนำ
วิดีโอนี้แสดงวิธีเริ่มต้นใช้งาน Firebase AI Logic โดย การสร้างแอปวางแผนมื้ออาหารที่ทำงานด้วยระบบ AI ในโลกแห่งความเป็นจริง ซึ่งสร้างสูตรอาหารจาก พรอมต์ข้อความ
นอกจากนี้ คุณยังดาวน์โหลดและสำรวจฐานของโค้ดของแอปในวิดีโอได้ด้วย
Java
ลองใช้แอปเริ่มต้นอย่างรวดเร็ว
ใช้แอปเริ่มต้นอย่างรวดเร็วเพื่อลองใช้ SDK อย่างรวดเร็วและดูการติดตั้งใช้งานที่สมบูรณ์ ของกรณีการใช้งานต่างๆ หรือใช้แอปเริ่มต้นอย่างรวดเร็วหากคุณไม่มีแอป Android ของตัวเอง หากต้องการใช้แอปเริ่มต้นอย่างรวดเร็ว คุณจะต้องเชื่อมต่อแอปกับโปรเจ็กต์ Firebase
ดูวิดีโอบทแนะนำ
วิดีโอนี้แสดงวิธีเริ่มต้นใช้งาน Firebase AI Logic โดย การสร้างแอปวางแผนมื้ออาหารที่ทำงานด้วยระบบ AI ในโลกแห่งความเป็นจริง ซึ่งสร้างสูตรอาหารจาก พรอมต์ข้อความ*
นอกจากนี้ คุณยังดาวน์โหลดและสำรวจฐานของโค้ดของแอปในวิดีโอได้ด้วย
* วิดีโอและแอปนี้เขียนด้วย Kotlin แต่ก็ยังช่วยให้นักพัฒนาซอฟต์แวร์ Java เข้าใจพื้นฐานเกี่ยวกับวิธีเริ่มต้นใช้งานFirebase AI Logic ได้
Web
ลองใช้แอปเริ่มต้นอย่างรวดเร็ว
ใช้แอปเริ่มต้นอย่างรวดเร็วเพื่อลองใช้ SDK อย่างรวดเร็วและดูการติดตั้งใช้งานที่สมบูรณ์ ของกรณีการใช้งานต่างๆ หรือใช้แอปเริ่มต้นอย่างรวดเร็วหากคุณไม่มีเว็บแอปของตัวเอง หากต้องการใช้แอปเริ่มต้นอย่างรวดเร็ว คุณจะต้องเชื่อมต่อกับโปรเจ็กต์ Firebase
Dart
ลองใช้แอปเริ่มต้นอย่างรวดเร็ว
ใช้แอปเริ่มต้นอย่างรวดเร็วเพื่อลองใช้ SDK อย่างรวดเร็วและดูการติดตั้งใช้งานที่สมบูรณ์ ของกรณีการใช้งานต่างๆ หรือใช้แอปเริ่มต้นอย่างรวดเร็วหากคุณไม่มีแอป Flutter ของตัวเอง หากต้องการใช้แอปเริ่มต้นอย่างรวดเร็ว คุณจะต้องเชื่อมต่อแอปกับโปรเจ็กต์ Firebase
ดูวิดีโอบทแนะนำ
วิดีโอนี้แสดงวิธีเริ่มต้นใช้งาน Firebase AI Logic โดย การสร้างแอปวางแผนมื้ออาหารที่ทำงานด้วยระบบ AI ในโลกแห่งความเป็นจริง ซึ่งสร้างสูตรอาหารจาก พรอมต์ข้อความ
นอกจากนี้ คุณยังดาวน์โหลดและสำรวจฐานของโค้ดของแอปในวิดีโอได้ด้วย
Unity
ลองใช้แอปเริ่มต้นอย่างรวดเร็ว
ใช้แอปเริ่มต้นอย่างรวดเร็วเพื่อลองใช้ SDK อย่างรวดเร็วและดูการติดตั้งใช้งานที่สมบูรณ์ ของกรณีการใช้งานต่างๆ หรือใช้แอปเริ่มต้นอย่างรวดเร็วหากคุณไม่มีเกม Unity ของตัวเอง หากต้องการใช้แอป Quickstart คุณจะต้องเชื่อมต่อแอปกับโปรเจ็กต์ Firebase
ขั้นตอนที่ 1: ตั้งค่าโปรเจ็กต์ Firebase และเปิดใช้ API
ลงชื่อเข้าใช้คอนโซล Firebase แล้วเลือกโปรเจ็กต์ Firebase
ในFirebaseคอนโซล ให้ไปที่บริการ AI > ตรรกะ AI
คลิกเริ่มต้นใช้งานเพื่อเปิดตัวเวิร์กโฟลว์แบบมีคำแนะนำที่จะช่วยคุณตั้งค่า API ที่จำเป็น และทรัพยากรสำหรับโปรเจ็กต์
หากได้รับข้อความแจ้ง ให้ทำตามวิธีการบนหน้าจอเพื่อลงทะเบียนแอปและเพิ่ม การกำหนดค่า Firebase ลงในแอป
เมื่อระบบขอให้เลือก "ผู้ให้บริการ Gemini API" เราขอแนะนำให้เลือก Gemini Developer API ซึ่งช่วยให้คุณเริ่มต้นใช้งานได้อย่างรวดเร็วโดยไม่มีค่าใช้จ่าย
คุณสามารถตั้งค่า Vertex AI Gemini API (และข้อกำหนดสำหรับการเรียกเก็บเงิน) ได้ทุกเมื่อ
ทําตามขั้นตอนในเวิร์กโฟลว์เพื่อตั้งค่า API ที่จําเป็นและบริการที่เกี่ยวข้อง สําหรับ Firebase AI Logic
ตั้งแต่ต้นเดือนกรกฎาคม 2026 เป็นต้นไป ขั้นตอนนี้ของเวิร์กโฟลว์จะบังคับใช้ Firebase App Check สำหรับ AI Logic โดยอัตโนมัติ ซึ่งเป็นบริการที่สำคัญที่จะช่วยปกป้อง Gemini API เมื่อมีการเข้าถึงโดยตรงจากแอปของคุณ ในขั้นตอนการเริ่มต้นใช้งาน (ดูขั้นตอนในส่วนถัดไป ในคู่มือนี้) คุณจะต้องกำหนดค่าApp Check ผู้ให้บริการแก้ไขข้อบกพร่อง สำหรับการพัฒนาในเครื่องเมื่อมีการบังคับใช้ App Check
ไปยังขั้นตอนถัดไปในคู่มือนี้เพื่อเพิ่ม SDK ที่จำเป็นลงในแอป
ขั้นตอนที่ 2: เพิ่ม SDK ที่จำเป็น
เมื่อตั้งค่าโปรเจ็กต์ Firebase และเปิดใช้ API ที่จำเป็นแล้ว (ดูขั้นตอนก่อนหน้า) ตอนนี้คุณก็เพิ่ม SDK ที่จำเป็นลงในแอปได้แล้ว
Swift
ใช้ Swift Package Manager เพื่อติดตั้งและจัดการทรัพยากร Dependency ของ Firebase ดูข้อมูลเกี่ยวกับตัวเลือกการติดตั้งอื่นๆ หากจำเป็น
Firebase AI Logic ไลบรารีช่วยให้เข้าถึง API เพื่อโต้ตอบกับโมเดล Gemini ได้ ไลบรารีนี้รวมอยู่ใน
Firebase SDK สำหรับแพลตฟอร์ม Apple (firebase-ios-sdk)
หากใช้ Firebase อยู่แล้ว ให้ตรวจสอบว่าแพ็กเกจ Firebase เป็นเวอร์ชัน 12.5.0 ขึ้นไป
เปิดโปรเจ็กต์แอปใน Xcode แล้วไปที่ File > Add Package Dependencies
เมื่อได้รับข้อความแจ้ง ให้เพิ่มที่เก็บ Firebase Apple Platforms SDK ดังนี้
https://github.com/firebase/firebase-ios-sdkเลือก SDK เวอร์ชันล่าสุด
เลือกคลัง
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 สำหรับ Android
เราขอแนะนำให้ใช้
Firebase Android BoM
เพื่อควบคุมการกำหนดเวอร์ชันของไลบรารี
dependencies { // ... other androidx dependencies // Import the BoM for the Firebase platform implementation(platform("com.google.firebase:firebase-bom:34.15.0")) // 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 เวอร์ชันที่เข้ากันได้อยู่เสมอ
Java
Firebase AI Logic SDK สำหรับ Android (firebase-ai) ให้สิทธิ์เข้าถึง API สำหรับการโต้ตอบกับโมเดล Gemini
ในไฟล์ Gradle ของโมดูล (ระดับแอป)
(เช่น <project>/<app-module>/build.gradle.kts)
ให้เพิ่มทรัพยากร Dependency สำหรับคลัง Firebase AI Logic สำหรับ Android
เราขอแนะนำให้ใช้
Firebase Android BoM
เพื่อควบคุมการกำหนดเวอร์ชันของไลบรารี
สำหรับ Java คุณต้องเพิ่มไลบรารีอีก 2 รายการ
dependencies { // ... other androidx dependencies // Import the BoM for the Firebase platform implementation(platform("com.google.firebase:firebase-bom:34.15.0")) // 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 เวอร์ชันที่เข้ากันได้อยู่เสมอ
Web
Firebase AI Logic ไลบรารีช่วยให้เข้าถึง API เพื่อโต้ตอบกับโมเดล Gemini ได้ ไลบรารีนี้รวมอยู่ใน Firebase JavaScript SDK สำหรับเว็บ
ติดตั้ง Firebase JS SDK สำหรับเว็บโดยใช้ npm ดังนี้
npm install firebaseเริ่มต้น 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 ได้
จากไดเรกทอรีโปรเจ็กต์ Flutter ให้เรียกใช้คำสั่งต่อไปนี้เพื่อ ติดตั้งปลั๊กอินหลักและปลั๊กอิน Firebase AI Logic
flutter pub add firebase_ai firebase_app_checkในไฟล์
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';นอกจากนี้ ในไฟล์
lib/main.dartให้ตรวจสอบว่าคุณได้เริ่มต้น Firebase โดยใช้ออบเจ็กต์DefaultFirebaseOptionsที่ส่งออกจาก ไฟล์การกำหนดค่าแล้วawait Firebase.initializeApp( options: DefaultFirebaseOptions.currentPlatform, );สร้างแอปพลิเคชัน Flutter อีกครั้ง
flutter run
Unity
ดาวน์โหลด Firebase Unity SDK แล้วแตกไฟล์ SDK ในตำแหน่งที่สะดวก
Firebase Unity SDK ไม่ได้เจาะจงแพลตฟอร์ม
ในโปรเจ็กต์ Unity แบบเปิด ให้ไปที่ เนื้อหา > นำเข้าแพ็กเกจ > แพ็กเกจที่กำหนดเอง
จาก SDK ที่แยกออกมา ให้เลือกแพ็กเกจ
FirebaseAIและแพ็กเกจFirebaseAppCheckคลิกนำเข้า ในหน้าต่างนำเข้าแพ็กเกจ Unity
ขั้นตอนที่ 3: กําหนดค่าผู้ให้บริการแก้ไขข้อบกพร่อง App Check สําหรับการพัฒนาในเครื่อง
ตั้งแต่ต้นเดือนกรกฎาคม 2026 เป็นต้นไป ในขั้นตอนการตั้งค่าที่แนะนำสำหรับ AI Logic ในคอนโซล Firebase App Check จะมีผลบังคับใช้โดยอัตโนมัติเพื่อปกป้อง Gemini API สำหรับการพัฒนาในเครื่อง คุณต้องกำหนดค่าApp Check ผู้ให้บริการแก้ไขข้อบกพร่องเพื่อข้ามการรับรองในขณะที่ยังคงบังคับใช้App Check
Swift
วิธีใช้ผู้ให้บริการแก้ไขข้อบกพร่องขณะเรียกใช้แอปในโปรแกรมจำลอง แบบโต้ตอบ (เช่น ระหว่างการพัฒนาในเครื่อง) มีดังนี้
ในโปรเจ็กต์ Xcode ให้นำเข้า
FirebaseAppCheckและเริ่มต้น App Check ด้วยโรงงานผู้ให้บริการแก้ไขข้อบกพร่องก่อนกำหนดค่าFirebaseimport 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() } } } }รับโทเค็นการแก้ไขข้อบกพร่องโดยทำดังนี้
เปิดแอปในโปรแกรมจำลองหรือบนอุปกรณ์ทดสอบ
เปิดคอนโซล Xcode แล้วมองหาApp Checkโทเค็นการแก้ไขข้อบกพร่อง เช่น
<Warning> [AppCheckCore][I-GAC004001] App Check debug token: '123a4567-b89c-12d3-e456-789012345678'.คัดลอกโทเค็น (เช่น
123a4567-b89c-12d3-e456-789012345678)
ลงทะเบียนโทเค็นการแก้ไขข้อบกพร่องกับ App Check โดยทำดังนี้
ในFirebase คอนโซล ให้ไปที่ ความปลอดภัย > App Check > แท็บแอป
ค้นหาแอปของคุณ คลิกเมนูแบบล้น () แล้วเลือก จัดการโทเค็นการแก้ไขข้อบกพร่อง
ทำตามวิธีการบนหน้าจอเพื่อลงทะเบียนโทเค็นการแก้ไขข้อบกพร่อง
โปรดดูรายละเอียดเกี่ยวกับผู้ให้บริการแก้ไขข้อบกพร่อง (รวมถึงวิธีรับโทเค็นการแก้ไขข้อบกพร่องใหม่) ในเอกสารApp Checkอย่างเป็นทางการ
Kotlin
วิธีใช้ผู้ให้บริการแก้ไขข้อบกพร่องขณะเรียกใช้แอปในโปรแกรมจำลอง แบบโต้ตอบ (เช่น ระหว่างการพัฒนาในเครื่อง) มีดังนี้
ในการสร้างการแก้ไขข้อบกพร่อง ให้กำหนดค่า App Check เพื่อใช้โรงงานผู้ให้บริการแก้ไขข้อบกพร่อง ดังนี้
Firebase.initialize(context = this) Firebase.appCheck.installAppCheckProviderFactory( DebugAppCheckProviderFactory.getInstance(), )
รับโทเค็นการแก้ไขข้อบกพร่องโดยทำดังนี้
เรียกใช้แอปในโปรแกรมจำลองหรือบนอุปกรณ์ทดสอบ
มองหาApp Checkโทเค็นการแก้ไขข้อบกพร่องในบันทึก เช่น
D DebugAppCheckProvider: Enter this debug secret into the allow list in the Firebase Console for your project: 123a4567-b89c-12d3-e456-789012345678คัดลอกโทเค็น (เช่น
123a4567-b89c-12d3-e456-789012345678)
ลงทะเบียนโทเค็นการแก้ไขข้อบกพร่องกับ App Check โดยทำดังนี้
ในFirebase คอนโซล ให้ไปที่ ความปลอดภัย > App Check > แท็บแอป
ค้นหาแอปของคุณ คลิกเมนูแบบล้น () แล้วเลือก จัดการโทเค็นการแก้ไขข้อบกพร่อง
ทำตามวิธีการบนหน้าจอเพื่อลงทะเบียนโทเค็นการแก้ไขข้อบกพร่อง
โปรดดูรายละเอียดเกี่ยวกับผู้ให้บริการแก้ไขข้อบกพร่อง (รวมถึงวิธีรับโทเค็นการแก้ไขข้อบกพร่องใหม่) ในเอกสารApp Checkอย่างเป็นทางการ
Java
วิธีใช้ผู้ให้บริการแก้ไขข้อบกพร่องขณะเรียกใช้แอปในโปรแกรมจำลอง แบบโต้ตอบ (เช่น ระหว่างการพัฒนาในเครื่อง) มีดังนี้
ในการสร้างการแก้ไขข้อบกพร่อง ให้กำหนดค่า App Check เพื่อใช้โรงงานผู้ให้บริการแก้ไขข้อบกพร่อง ดังนี้
FirebaseApp.initializeApp(/*context=*/ this); FirebaseAppCheck firebaseAppCheck = FirebaseAppCheck.getInstance(); firebaseAppCheck.installAppCheckProviderFactory( DebugAppCheckProviderFactory.getInstance());
รับโทเค็นการแก้ไขข้อบกพร่องโดยทำดังนี้
เรียกใช้แอปในโปรแกรมจำลองหรือบนอุปกรณ์ทดสอบ
มองหาApp Checkโทเค็นการแก้ไขข้อบกพร่องในบันทึก เช่น
D DebugAppCheckProvider: Enter this debug secret into the allow list in the Firebase Console for your project: 123a4567-b89c-12d3-e456-789012345678คัดลอกโทเค็น (เช่น
123a4567-b89c-12d3-e456-789012345678)
ลงทะเบียนโทเค็นการแก้ไขข้อบกพร่องกับ App Check โดยทำดังนี้
ในFirebase คอนโซล ให้ไปที่ ความปลอดภัย > App Check > แท็บแอป
ค้นหาแอปของคุณ คลิกเมนูแบบล้น () แล้วเลือก จัดการโทเค็นการแก้ไขข้อบกพร่อง
ทำตามวิธีการบนหน้าจอเพื่อลงทะเบียนโทเค็นการแก้ไขข้อบกพร่อง
โปรดดูรายละเอียดเกี่ยวกับผู้ให้บริการแก้ไขข้อบกพร่อง (รวมถึงวิธีรับโทเค็นการแก้ไขข้อบกพร่องใหม่) ในเอกสารApp Checkอย่างเป็นทางการ
Web
วิธีใช้ผู้ให้บริการแก้ไขข้อบกพร่องขณะเรียกใช้แอปจาก localhost
แบบอินเทอร์แอกทีฟ (เช่น ระหว่างการพัฒนาในเครื่อง) มีดังนี้
ในบิลด์การแก้ไขข้อบกพร่อง ให้เปิดใช้โหมดแก้ไขข้อบกพร่องโดยตั้งค่า
self.FIREBASE_APPCHECK_DEBUG_TOKENเป็นtrueก่อนที่จะเริ่มต้น App Check เช่นself.FIREBASE_APPCHECK_DEBUG_TOKEN = true; initializeAppCheck(app, { /* App Check options */ });ไปที่เว็บแอปในเครื่องและเปิดเครื่องมือสำหรับนักพัฒนาซอฟต์แวร์ของเบราว์เซอร์ คุณจะเห็นโทเค็นการแก้ไขข้อบกพร่องใน คอนโซลการแก้ไขข้อบกพร่อง
AppCheck debug token: "123a4567-b89c-12d3-e456-789012345678". You will need to safelist it in the Firebase console for it to work.ลงทะเบียนโทเค็นการแก้ไขข้อบกพร่องกับ App Check โดยทำดังนี้
ในFirebase คอนโซล ให้ไปที่ ความปลอดภัย > App Check > แท็บแอป
ค้นหาแอปของคุณ คลิกเมนูแบบล้น () แล้วเลือก จัดการโทเค็นการแก้ไขข้อบกพร่อง
ทำตามวิธีการบนหน้าจอเพื่อลงทะเบียนโทเค็นการแก้ไขข้อบกพร่อง
โปรดดูรายละเอียดเกี่ยวกับผู้ให้บริการแก้ไขข้อบกพร่อง (รวมถึงวิธีรับโทเค็นการแก้ไขข้อบกพร่องใหม่) ในเอกสารApp Checkอย่างเป็นทางการ
Dart
iOS+
วิธีใช้ผู้ให้บริการแก้ไขข้อบกพร่องขณะเรียกใช้แอปในโปรแกรมจำลอง แบบโต้ตอบ (เช่น ระหว่างการพัฒนาในเครื่อง) มีดังนี้
เปิดใช้งาน App Check ด้วยผู้ให้บริการแก้ไขข้อบกพร่องทันทีหลังจากที่คุณ เริ่มต้นแอป Firebase แล้ว
import 'package:flutter/material.dart'; import 'package:firebase_core/firebase_core.dart'; // Import the firebase_app_check plugin import 'package:firebase_app_check/firebase_app_check.dart'; Future<void> main() async { WidgetsFlutterBinding.ensureInitialized(); await Firebase.initializeApp(); await FirebaseAppCheck.instance.activate( // Set appleProvider to `AppleProvider.debug` appleProvider: AppleProvider.debug, ); runApp(App()); }เปิดใช้การบันทึกการแก้ไขข้อบกพร่องในโปรเจ็กต์ Xcode โดยทำดังนี้
- เปิดผลิตภัณฑ์ > รูปแบบ > แก้ไขรูปแบบ
- เลือกเรียกใช้จากเมนูด้านซ้าย แล้วเลือกแท็บอาร์กิวเมนต์
- ในส่วนอาร์กิวเมนต์ที่ส่งเมื่อตอนเริ่ม ให้เพิ่ม
-FIRDebugEnabled
รับโทเค็นการแก้ไขข้อบกพร่องโดยทำดังนี้
เปิด
ios/Runner.xcworkspaceด้วย Xcode แล้วเรียกใช้แอปใน โปรแกรมจำลองหรือในอุปกรณ์ทดสอบเปิดคอนโซล Xcode แล้วมองหาApp Checkโทเค็นการแก้ไขข้อบกพร่อง เช่น
<Warning> [AppCheckCore][I-GAC004001] App Check debug token: '123a4567-b89c-12d3-e456-789012345678'.คัดลอกโทเค็น (เช่น
123a4567-b89c-12d3-e456-789012345678)
ลงทะเบียนโทเค็นการแก้ไขข้อบกพร่องกับ App Check โดยทำดังนี้
ในFirebase คอนโซล ให้ไปที่ ความปลอดภัย > App Check > แท็บแอป
ค้นหาแอปของคุณ คลิกเมนูแบบล้น () แล้วเลือก จัดการโทเค็นการแก้ไขข้อบกพร่อง
ทำตามวิธีการบนหน้าจอเพื่อลงทะเบียนโทเค็นการแก้ไขข้อบกพร่อง
Android
วิธีใช้ผู้ให้บริการแก้ไขข้อบกพร่องขณะเรียกใช้แอปในโปรแกรมจำลอง แบบโต้ตอบ (เช่น ระหว่างการพัฒนาในเครื่อง) มีดังนี้
เปิดใช้งาน App Check ด้วยผู้ให้บริการแก้ไขข้อบกพร่องทันทีหลังจากที่คุณ เริ่มต้นแอป Firebase แล้ว
import 'package:flutter/material.dart'; import 'package:firebase_core/firebase_core.dart'; // Import the firebase_app_check plugin import 'package:firebase_app_check/firebase_app_check.dart'; Future<void> main() async { WidgetsFlutterBinding.ensureInitialized(); await Firebase.initializeApp(); await FirebaseAppCheck.instance.activate( // Set androidProvider to `AndroidProvider.debug` androidProvider: AndroidProvider.debug, ); runApp(App()); }รับโทเค็นการแก้ไขข้อบกพร่องโดยทำดังนี้
เรียกใช้แอปในโปรแกรมจำลองหรือบนอุปกรณ์ทดสอบ
มองหาApp Checkโทเค็นการแก้ไขข้อบกพร่องในบันทึก เช่น
D DebugAppCheckProvider: Enter this debug secret into the allow list in the Firebase Console for your project: 123a4567-b89c-12d3-e456-789012345678คัดลอกโทเค็น (เช่น
123a4567-b89c-12d3-e456-789012345678)
ลงทะเบียนโทเค็นการแก้ไขข้อบกพร่องกับ App Check โดยทำดังนี้
ในFirebase คอนโซล ให้ไปที่ ความปลอดภัย > App Check > แท็บแอป
ค้นหาแอปของคุณ คลิกเมนูแบบล้น () แล้วเลือก จัดการโทเค็นการแก้ไขข้อบกพร่อง
ทำตามวิธีการบนหน้าจอเพื่อลงทะเบียนโทเค็นการแก้ไขข้อบกพร่อง
เว็บ
วิธีใช้ผู้ให้บริการแก้ไขข้อบกพร่องขณะเรียกใช้แอปจาก
localhostแบบอินเทอร์แอกทีฟ (เช่น ระหว่างการพัฒนาในเครื่อง) มีดังนี้
ในไฟล์
web/index.htmlให้เปิดใช้โหมดแก้ไขข้อบกพร่องโดยตั้งค่าself.FIREBASE_APPCHECK_DEBUG_TOKENเป็นtrueดังนี้<body> <script> self.FIREBASE_APPCHECK_DEBUG_TOKEN = true; </script> ... </body>เรียกใช้เว็บแอปในเครื่องและเปิดเครื่องมือสำหรับนักพัฒนาซอฟต์แวร์ของเบราว์เซอร์ คุณจะเห็นโทเค็นการแก้ไขข้อบกพร่องใน คอนโซลการแก้ไขข้อบกพร่อง
AppCheck debug token: "123a4567-b89c-12d3-e456-789012345678". You will need to safelist it in the Firebase console for it to work.โทเค็นนี้จะจัดเก็บไว้ในเบราว์เซอร์ของคุณภายในเครื่อง และจะใช้ทุกครั้งที่คุณใช้แอปในเบราว์เซอร์เดียวกันบนเครื่องเดียวกัน หากต้องการใช้โทเค็นในเบราว์เซอร์อื่นหรือในเครื่องอื่น ให้ตั้งค่า
self.FIREBASE_APPCHECK_DEBUG_TOKENเป็นสตริงโทเค็นแทนtrueลงทะเบียนโทเค็นการแก้ไขข้อบกพร่องกับ App Check โดยทำดังนี้
ในFirebase คอนโซล ให้ไปที่ ความปลอดภัย > App Check > แท็บแอป
ค้นหาแอปของคุณ คลิกเมนูแบบล้น () แล้วเลือก จัดการโทเค็นการแก้ไขข้อบกพร่อง
ทำตามวิธีการบนหน้าจอเพื่อลงทะเบียนโทเค็นการแก้ไขข้อบกพร่อง
โปรดดูรายละเอียดเกี่ยวกับผู้ให้บริการแก้ไขข้อบกพร่อง (รวมถึงวิธีรับโทเค็นการแก้ไขข้อบกพร่องใหม่) ในเอกสารApp Checkอย่างเป็นทางการ
Unity
วิธีใช้ผู้ให้บริการแก้ไขข้อบกพร่องขณะเรียกใช้แอปในโปรแกรมจำลอง แบบโต้ตอบ (เช่น ระหว่างการพัฒนาในเครื่อง) มีดังนี้
ในFirebaseคอนโซล ให้สร้างโทเค็นการแก้ไขข้อบกพร่องโดยทำดังนี้
ในFirebase คอนโซล ให้ไปที่ความปลอดภัย > App Check > แท็บแอป
ค้นหาแอปของคุณ คลิกเมนูแบบล้น () แล้วเลือก จัดการโทเค็นการแก้ไขข้อบกพร่อง
ทำตามวิธีการบนหน้าจอเพื่อสร้างโทเค็นการแก้ไขข้อบกพร่องใหม่
เพิ่มโค้ดต่อไปนี้ในโค้ดการเริ่มต้นของแอป
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อย่างเป็นทางการ
ขั้นตอนที่ 4: เริ่มต้นบริการและสร้างอินสแตนซ์โมเดล
|
คลิกผู้ให้บริการ Gemini API เพื่อดูเนื้อหาและโค้ดเฉพาะของผู้ให้บริการ ในหน้านี้ |
ก่อนส่งพรอมต์ไปยังโมเดล Gemini ให้
เริ่มต้นบริการสำหรับผู้ให้บริการ API ที่เลือกและสร้างอินสแตนซ์ GenerativeModel
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.5-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.5-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.5-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.5-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.5-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.5-flash");
โปรดทราบว่าคุณอาจสร้างอินสแตนซ์ GenerativeModel ไม่ได้เสมอไป ทั้งนี้ขึ้นอยู่กับความสามารถที่คุณใช้
หากต้องการ
สตรีมอินพุตและเอาต์พุตโดยใช้ Gemini Live API
ให้สร้างอินสแตนซ์ LiveModel
นอกจากนี้ หลังจากอ่านคู่มือการเริ่มต้นใช้งานนี้จบแล้ว ให้ดูวิธีเลือกโมเดลสำหรับกรณีการใช้งานและแอปของคุณ
ขั้นตอนที่ 5: ส่งคำขอไปยังโมเดล
ตอนนี้คุณพร้อมที่จะส่งคำขอไปยังโมเดล Gemini แล้ว
คุณใช้ generateContent() เพื่อสร้างข้อความจากพรอมต์ที่มีข้อความได้โดยทำดังนี้
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.5-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
สำหรับ Kotlin เมธอดใน SDK นี้เป็นฟังก์ชันระงับและต้องเรียกใช้ จากขอบเขต Coroutine
// 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.5-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
สำหรับ Java เมธอดใน SDK นี้จะแสดงผลเป็นListenableFuture
// 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.5-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.5-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.5-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.5-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.");
คุณทำอะไรได้อีกบ้าง
ดูข้อมูลเพิ่มเติมเกี่ยวกับโมเดลที่รองรับ
ดูข้อมูลเกี่ยวกับ โมเดลที่พร้อมใช้งานสำหรับกรณีการใช้งานต่างๆ รวมถึง โควต้าและ ราคา
ลองใช้ความสามารถอื่นๆ
- ดูข้อมูลเพิ่มเติมเกี่ยวกับการสร้างข้อความจากพรอมต์ที่เป็นข้อความเท่านั้น รวมถึงวิธีสตรีมคำตอบ
- สร้างข้อความโดยการป้อนพรอมต์ด้วยไฟล์ประเภทต่างๆ เช่น รูปภาพ PDF วิดีโอ และ เสียง
- สร้างการสนทนาแบบหลายรอบ (แชท)
- สร้างเอาต์พุตที่มีโครงสร้าง (เช่น JSON) จากทั้งข้อความและพรอมต์มัลติโมดัล
- สร้างและแก้ไขรูปภาพ จากทั้งพรอมต์ข้อความและพรอมต์หลายรูปแบบ
- สตรีมอินพุตและเอาต์พุต (รวมถึงเสียง) โดยใช้ Gemini Live API
- ใช้เครื่องมือ (เช่น การเรียกใช้ฟังก์ชัน และการอ้างอิงจาก Google Search) เพื่อเชื่อมต่อโมเดล Gemini กับส่วนอื่นๆ ของแอปและระบบ และข้อมูลภายนอก
ดูวิธีควบคุมการสร้างเนื้อหา
- ทำความเข้าใจการออกแบบพรอมต์ รวมถึง แนวทางปฏิบัติแนะนำ กลยุทธ์ และพรอมต์ตัวอย่าง
- กำหนดค่าพารามิเตอร์โมเดล เช่น โทเค็นเอาต์พุตสูงสุด ความน่าจะเป็นของโทเค็นเอาต์พุตที่ซ้ำกัน ฯลฯ
- ใช้การตั้งค่าความปลอดภัยเพื่อปรับ ความเป็นไปได้ที่จะได้รับคำตอบที่อาจถือว่าเป็นอันตราย
แสดงความคิดเห็น เกี่ยวกับประสบการณ์การใช้งาน Firebase AI Logic