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

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

คุณติดตั้งโมเดลใน API ของ ML Kit ได้ด้วย 3 วิธีต่อไปนี้

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

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

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

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

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

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

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

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

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