เส้นทางการติดตั้งโมเดล ML Kit บน Android

ฟีเจอร์ ML Kit ทั้งหมดจะใช้ประโยชน์จากโมเดลแมชชีนเลิร์นนิงที่ Google ฝึก (หรือที่เรียกว่าโมเดลฐาน) โดยค่าเริ่มต้น คู่มือนี้ใช้ได้กับโมเดลฐานเท่านั้น ดูคำแนะนำเกี่ยวกับรูปแบบที่กำหนดเองได้ที่นี่

โมเดลใน ML Kit API สามารถติดตั้งได้ 3 วิธีดังนี้

  1. ไม่ได้จัดกลุ่ม: โมเดลจะดาวน์โหลดและจัดการผ่านบริการ Google Play
  2. รวมกลุ่มแล้ว: โมเดลจะลิงก์กับแอปของคุณแบบคงที่ ณ เวลาบิลด์
  3. ดาวน์โหลดแบบไดนามิก: ระบบจะดาวน์โหลดโมเดลตามคำขอ

เส้นทางการติดตั้งที่รองรับสําหรับ API แต่ละรายการ

ตารางด้านล่างแสดงเส้นทางการติดตั้งโมเดลที่ฟีเจอร์ ML Kit แต่ละรายการรองรับ

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

คำแนะนำเฉพาะ API จะแสดงตัวเลือกการติดตั้งที่พร้อมใช้งานสำหรับ API ที่ระบุ

ความแตกต่างสำคัญระหว่างตัวเลือกการติดตั้ง

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

วิธีเลือกระหว่างแพ็กเกจและไม่ได้รวมกลุ่ม

ถ้า API สนับสนุนตัวเลือกการติดตั้งทั้งแบบรวมและเลิกรวมกลุ่ม:

  • ใช้ตัวเลือกแพ็กเกจหากคุณจัดลำดับความสำคัญดังนี้

    • ใช้ฟังก์ชันของฟีเจอร์ให้เสร็จทันทีหลังจากติดตั้งแอป
    • ฟังก์ชันการทำงานของฟีเจอร์โดยไม่ต้องเชื่อมต่อเครือข่ายหลังจากติดตั้งแอป

  • ใช้ตัวเลือกเลิกรวมกลุ่มหากคุณจัดลำดับความสำคัญดังนี้

    • แอปมีขนาดเล็กลง
    • การอัปเดตโมเดลอัตโนมัติโดยบริการ Google Play

วิธีดาวน์โหลดโมเดล

เมื่อใช้ตัวเลือกโมเดลที่ไม่ได้รวมกลุ่ม คุณจะระบุวิธีดาวน์โหลดโมเดลลงในอุปกรณ์ได้ ดังนี้

  • คุณเปิดใช้การดาวน์โหลดโมเดลเวลาติดตั้งได้โดยการเพิ่มการประกาศลงในไฟล์ AndroidManifest.xml ของแอป ตัวอย่างเช่น ข้อมูลโค้ดด้านล่างแสดงวิธีกำหนดค่าแอปให้ดาวน์โหลดโมเดลบาร์โค้ดโดยอัตโนมัติหลังจากที่ติดตั้งแอปจาก Play Store แล้ว

    <application ...>
      ...
      <meta-data
          android:name="com.google.mlkit.vision.DEPENDENCIES"
          android:value="barcode" >
      <!-- To use multiple models: android:value="barcode,model2,model3" -->
</application>

  • คุณขอการดาวน์โหลดอย่างชัดแจ้งได้ผ่าน ModuleInstallClient API ของบริการ Google Play

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

วิธีอัปเดตโมเดล

วิธีอัปเดตโมเดลเมื่อใช้โมเดลแบบกลุ่มหรือตัวเลือกโมเดลที่ดาวน์โหลดแบบไดนามิก

  1. อัปเดตไฟล์ Gradle ของแอปเพื่อใช้ไลบรารีของไคลเอ็นต์ฟีเจอร์ ML Kit เวอร์ชันล่าสุด

    dependencies {
  implementation 'com.google.mlkit:barcode-scanning: 17.2.0' // The latest version number of the API
}

  2. สร้างแอปอีกครั้ง

เหตุใด API บางรายการจึงมีโมเดลที่ดาวน์โหลดแบบไดนามิก

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