การย้ายข้อมูลสำหรับ Android

คู่มือนี้จะอธิบายวิธีย้ายข้อมูลออกจาก ML Kit for Firebase สำหรับ Android

อัปเดตการนำเข้า Gradle

SDK ของ ML Kit ต้องการทรัพยากร Dependency เพียงรายการเดียวสำหรับ ML Kit API แต่ละรายการ คุณไม่จำเป็นต้องระบุไลบรารีที่ใช้กันทั่วไป เช่น firebase-ml-vision หรือ firebase-ml-natural-language ML Kit ใช้เนมสเปซ com.google.android.gms สำหรับไลบรารีที่ขึ้นอยู่กับบริการ Google Play

Vision API

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

อัปเดตทรัพยากร Dependency สำหรับไลบรารี ML Kit สำหรับ Android ในไฟล์ Gradle ของโมดูล (ระดับแอป) (โดยมากจะเป็นไฟล์ app/build.gradle.kts) ตามตารางต่อไปนี้

โมเดลที่รวมกลุ่มไว้

โมเดลแบบบาง

AutoMLVision Edge

Natural Language API

ระบบจะนำส่งโมเดลที่รวมกลุ่มไว้เป็นส่วนหนึ่งของแอปพลิเคชัน ส่วนโมเดลแบบบางจะต้องดาวน์โหลด ดังนี้

อัปเดตทรัพยากร Dependency สำหรับไลบรารี ML Kit สำหรับ Android ในไฟล์ Gradle ของโมดูล (ระดับแอป) (โดยมากจะเป็นไฟล์ app/build.gradle.kts) ตามตารางต่อไปนี้

โมเดลที่รวมกลุ่มไว้

โมเดลแบบบาง

อัปเดตชื่อชั้นเรียน

หากชั้นเรียนของคุณปรากฏในตารางนี้ ให้ทำการเปลี่ยนแปลงตามที่ระบุ

สำหรับคลาสอื่นๆ ให้ทำตามกฎต่อไปนี้

• นำคำนำหน้า FirebaseVision ออกจากชื่อคลาส
• นำคำนำหน้าอื่นๆ ที่ขึ้นต้นด้วยคำนำหน้า Firebase ออกจากชื่อคลาส

นอกจากนี้ ในชื่อแพ็กเกจ ให้แทนที่คำนำหน้า com.google.firebase.ml ด้วย com.google.mlkit

อัปเดตชื่อเมธอด

มีการเปลี่ยนแปลงโค้ดเพียงเล็กน้อย ดังนี้

• การสร้างอินสแตนซ์ของตัวตรวจจับ/สแกนเนอร์/ตัวติดป้ายกำกับ/ตัวแปล... มีการเปลี่ยนแปลง ตอนนี้แต่ละฟีเจอร์มีจุดเริ่มต้นของตัวเอง เช่น BarcodeScanning, TextRecognition, ImageLabeling, Translation... การเรียกใช้ getInstance() ของบริการ Firebase จะถูกแทนที่ด้วยการเรียกใช้เมธอด getClient() ของจุดเริ่มต้นของฟีเจอร์
• การสร้างอินสแตนซ์เริ่มต้นสำหรับ TextRecognizer ถูกนำออกแล้ว เนื่องจากเราได้เปิดตัวไลบรารีเพิ่มเติมสำหรับการจดจำสคริปต์อื่นๆ เช่น ภาษาจีนและภาษาเกาหลี หากต้องการใช้ตัวเลือกเริ่มต้นกับโมเดลการจดจำข้อความสคริปต์ละติน ให้ประกาศทรัพยากร Dependency ใน com.google.android.gms:play-services-mlkit-text-recognition และใช้ TextRecognition.getClient(TextRecognizerOptions.DEFAULT_OPTIONS)
• การสร้างอินสแตนซ์เริ่มต้นสำหรับ ImageLabeler และ ObjectDetector ถูกนำออกแล้ว เนื่องจากเราได้เปิดตัวการรองรับโมเดลที่กำหนดเองสำหรับ 2 ฟีเจอร์นี้ เช่น หากต้องการใช้ตัวเลือกเริ่มต้นกับโมเดลพื้นฐานใน ImageLabeling, ให้ประกาศทรัพยากร Dependency ใน com.google.mlkit:image-labeling และใช้ ImageLabeling.getClient(ImageLabelerOptions.DEFAULT_OPTIONS) ใน Java
• แฮนเดิลทั้งหมด (ตัวตรวจจับ/สแกนเนอร์/ตัวติดป้ายกำกับ/ตัวแปล...) ปิดได้ ตรวจสอบว่าได้เรียกใช้เมธอด close() เมื่อจะไม่ใช้ออบเจ็กต์เหล่านั้นอีกต่อไป หากคุณใช้ออบเจ็กต์เหล่านั้นใน Fragment หรือ AppCompatActivity วิธีหนึ่งในการทำเช่นนั้นคือการเรียกใช้ LifecycleOwner.getLifecycle() ใน Fragment หรือ AppCompatActivity แล้วเรียกใช้ Lifecycle.addObserver
• processImage() และ detectInImage() ใน Vision API ได้รับการเปลี่ยนชื่อเป็น process() เพื่อให้สอดคล้องกัน
• ตอนนี้ Natural Language API ใช้คำว่า "แท็กภาษา" (ตามที่กำหนดโดย มาตรฐาน BCP 47) แทน "รหัสภาษา"
• เมธอด Getter ในคลาส xxxOptions ถูกนำออกแล้ว
• ระบบไม่รองรับเมธอด getBitmap() ในคลาส InputImage (แทนที่ FirebaseVisionImage) อีกต่อไปเนื่องจากเป็นส่วนหนึ่งของอินเทอร์เฟซสาธารณะ โปรดดู BitmapUtils.java ใน ตัวอย่างการเริ่มต้นใช้งานอย่างรวดเร็วของ ML Kit เพื่อรับบิตแมปที่แปลง จากอินพุตต่างๆ
• FirebaseVisionImageMetadata ถูกนำออกแล้ว คุณเพียงแค่ส่งข้อมูลเมตาของรูปภาพ เช่น width, height, rotationDegrees, format ไปยังเมธอดการสร้างของ InputImage

ตัวอย่างเมธอด Kotlin เก่าและใหม่มีดังนี้

// Construct image labeler with base model and default options.
val imageLabeler = FirebaseVision.getInstance().onDeviceImageLabeler

// Construct object detector with base model and default options.
val objectDetector = FirebaseVision.getInstance().onDeviceObjectDetector

// Construct face detector with given options
val faceDetector = FirebaseVision.getInstance().getVisionFaceDetector(options)

// Construct image labeler with local AutoML model
val localModel =
    FirebaseAutoMLLocalModel.Builder()
      .setAssetFilePath("automl/manifest.json")
      .build()
val autoMLImageLabeler =
    FirebaseVision.getInstance()
      .getOnDeviceAutoMLImageLabeler(
          FirebaseVisionOnDeviceAutoMLImageLabelerOptions.Builder(localModel)
            .setConfidenceThreshold(0.3F)
            .build()
    )

// Construct image labeler with base model and default options.
val imageLabeler = ImageLabeling.getClient(ImageLabelerOptions.DEFAULT_OPTIONS)
// Optional: add lifecycle observer
lifecycle.addObserver(imageLabeler)

// Construct object detector with base model and default options.
val objectDetector = ObjectDetection.getClient(
    ObjectDetectorOptions.DEFAULT_OPTIONS
)

// Construct face detector with given options
val faceDetector = FaceDetection.getClient(options)

// Construct image labeler with local AutoML model
val localModel =
  LocalModel.Builder()
    .setAssetManifestFilePath("automl/manifest.json")
    .build()
val autoMLImageLabeler =
  ImageLabeling.getClient(
    CustomImageLabelerOptions.Builder(localModel)
    .setConfidenceThreshold(0.3F).build())
  

ตัวอย่างเมธอด Java เก่าและใหม่มีดังนี้

// Construct image labeler with base model and default options.
FirebaseVisionImageLabeler imagelLabeler =
     FirebaseVision.getInstance().getOnDeviceImageLabeler();

// Construct object detector with base model and default options.
FirebaseVisionObjectDetector objectDetector =
     FirebaseVision.getInstance().getOnDeviceObjectDetector();

// Construct face detector with given options
FirebaseVisionFaceDetector faceDetector =
     FirebaseVision.getInstance().getVisionFaceDetector(options);

// Construct image labeler with local AutoML model
FirebaseAutoMLLocalModel localModel =
    new FirebaseAutoMLLocalModel.Builder()
      .setAssetFilePath("automl/manifest.json")
      .build();
FirebaseVisionImageLabeler autoMLImageLabeler =
    FirebaseVision.getInstance()
      .getOnDeviceAutoMLImageLabeler(
          FirebaseVisionOnDeviceAutoMLImageLabelerOptions.Builder(localModel)
            .setConfidenceThreshold(0.3F)
            .build());

// Construct image labeler with base model and default options.
ImageLabeler imageLabeler = ImageLabeling.getClient(
    ImageLabelerOptions.DEFAULT_OPTIONS
);
// Optional: add lifecycle observer
getLifecycle().addObserver(imageLabeler);

// Construct object detector with base model and default options.
ObjectDetector objectDetector = ObjectDetection.getClient(
    ObjectDetectorOptions.DEFAULT_OPTIONS
);

// Construct face detector with given options
FaceDetector faceDetector = FaceDetection.getClient(options);

// Construct image labeler with local AutoML model
LocalModel localModel =
  new LocalModel.Builder()
    .setAssetManifestFilePath("automl/manifest.json")
    .build();
ImageLabeler autoMLImageLabeler =
  ImageLabeling.getClient(
    new CustomImageLabelerOptions.Builder(localModel)
    .setConfidenceThreshold(0.3F).build());
  

การเปลี่ยนแปลงเฉพาะ API

การสแกนบาร์โค้ด

สำหรับ Barcode Scanning API ตอนนี้มี 2 วิธีในการนำส่งโมเดล ดังนี้

• ผ่านบริการ Google Play หรือที่เรียกว่า "แบบบาง" (แนะนำ) - วิธีนี้จะลดขนาดแอปและแชร์โมเดลระหว่างแอปพลิเคชัน อย่างไรก็ตาม นักพัฒนาแอปจะต้องตรวจสอบว่าได้ดาวน์โหลดโมเดลก่อนที่จะใช้เป็นครั้งแรก
• พร้อม APK ของแอป หรือ "รวมกลุ่มไว้" - วิธีนี้จะเพิ่มขนาดแอป แต่ หมายความว่าโมเดลจะพร้อมใช้งานทันที

การติดตั้งใช้งานทั้ง 2 แบบจะแตกต่างกันเล็กน้อย โดยเวอร์ชัน "รวมกลุ่มไว้" จะมีการปรับปรุงหลายอย่างมากกว่าเวอร์ชัน "แบบบาง" ดูรายละเอียดเกี่ยวกับความแตกต่างเหล่านี้ได้ในหลักเกณฑ์ Barcode Scanning API

การตรวจจับใบหน้า

สำหรับ Face Detection API ตอนนี้มี 2 วิธีในการนำส่งโมเดล ดังนี้

• ผ่านบริการ Google Play หรือที่เรียกว่า "แบบบาง" (แนะนำ) - วิธีนี้จะลดขนาดแอปและแชร์โมเดลระหว่างแอปพลิเคชัน อย่างไรก็ตาม นักพัฒนาแอปจะต้องตรวจสอบว่าได้ดาวน์โหลดโมเดลก่อนที่จะใช้เป็นครั้งแรก
• พร้อม APK ของแอป หรือ "รวมกลุ่มไว้" - วิธีนี้จะเพิ่มขนาดการดาวน์โหลดแอป แต่หมายความว่าโมเดลจะพร้อมใช้งานทันที

ลักษณะการทำงานของการติดตั้งใช้งานจะเหมือนกัน

การแปล

• TranslateLanguage ตอนนี้ใช้ชื่อที่อ่านได้สำหรับค่าคงที่ (เช่น ENGLISH) แทนแท็กภาษา (EN) นอกจากนี้ ตอนนี้ยังเป็น @StringDef, แทน @IntDef และค่าของค่าคงที่จะเป็นแท็กภาษา BCP 47 ที่ตรงกัน

การติดป้ายกำกับรูปภาพ AutoML (เลิกใช้งานแล้ว)

การดาวน์โหลดโมเดลที่กำหนดเองสำหรับการติดป้ายกำกับรูปภาพโดยใช้ AutoML เลิกใช้งานแล้วและจะยกเลิกในวันที่ 15 มิถุนายน 2027 คุณควรใช้ Cloud Storage เพื่อโฮสต์โมเดลและเพิ่มตรรกะการดาวน์โหลดลงในแอปเพื่อดาวน์โหลดโมเดลแทน ดูรายละเอียดได้ที่ คู่มือการย้ายข้อมูลจาก Firebase ML ไปยัง Cloud Storage

การตรวจจับและติดตามวัตถุ

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

ระบบจะแสดงหมวดหมู่การแยกประเภทเป็นอินสแตนซ์ของ DetectedObject.Label แทนที่จะเป็นจำนวนเต็ม หมวดหมู่ที่เป็นไปได้ทั้งหมดสำหรับตัวแยกประเภทแบบหยาบจะรวมอยู่ในคลาส PredefinedCategory

ตัวอย่างโค้ด Kotlin เก่าและใหม่มีดังนี้

if (object.classificationCategory == FirebaseVisionObject.CATEGORY_FOOD) {
    ...
}

if (!object.labels.isEmpty() &&
    object.labels[0].text == PredefinedCategory.FOOD) {
    ...
}
// or
if (!object.labels.isEmpty() &&
    object.labels[0].index == PredefinedCategory.FOOD_INDEX) {
    ...
}

ตัวอย่างโค้ด Java เก่าและใหม่มีดังนี้

if (object.getClassificationCategory() == FirebaseVisionObject.CATEGORY_FOOD) {
    ...
}

if (!object.getLabels().isEmpty()
    && object.getLabels().get(0).getText().equals(PredefinedCategory.FOOD)) {
    ...
}
// or
if (!object.getLabels().isEmpty()
    && object.getLabels().get(0).getIndex() == PredefinedCategory.FOOD_INDEX) {
    ...
}

หมวดหมู่ "ไม่ระบุ" ถูกนำออกแล้ว เมื่อความเชื่อมั่นในการแยกประเภทของวัตถุต่ำ เราจะไม่แสดงป้ายกำกับใดๆ

นำทรัพยากร Dependency ของ Firebase ออก

นำทรัพยากร Dependency ของ Firebase ออกหลังจากการย้ายข้อมูล โดยทำตามขั้นตอนต่อไปนี้

• นำไฟล์กำหนดค่า Firebase ออกโดยลบไฟล์กำหนดค่า google-services.json ในไดเรกทอรีโมดูล (ระดับแอป) ของแอป
• แทนที่ปลั๊กอิน Google Services Gradle ในไฟล์ Gradle ของโมดูล (ระดับแอป) (โดยมากจะเป็นไฟล์ app/build.gradle.kts) ด้วยปลั๊กอิน Strict Version Matcher ดังนี้

plugins {
  id("com.android.application")
  id("com.google.gms.google-services")
}

android {
  // …
}

plugins {
  id("com.android.application")
  id("com.google.android.gms.strict-version-matcher-plugin")
}

android {
  // …
}

• แทนที่ classpath ของปลั๊กอิน Google Services Gradle ในไฟล์ Gradle ระดับโปรเจ็กต์ (build.gradle.kts) ด้วย classpath ของปลั๊กอิน Strict Version Matcher ดังนี้

buildscript {
  dependencies {
    // ...

    classpath("com.google.gms:google-services:4.3.3")
  }
}

buildscript {
  dependencies {
    // ...
    classpath("com.google.android.gms:strict-version-matcher-plugin:1.2.1")
  }
}

ลบแอป Firebase ในคอนโซล Firebase ตาม วิธีการในเว็บไซต์สนับสนุนของ Firebase

ขอความช่วยเหลือ

หากพบปัญหา โปรดดูหน้าชุมชน ของเรา ซึ่งเราได้ระบุช่องทางต่างๆ ที่คุณสามารถติดต่อเราได้