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

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

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

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

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

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

ไม่ได้จัดกลุ่ม แบบแพ็กเกจ ดาวน์โหลดแบบไดนามิก
การจดจำข้อความ 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>
    
  • คุณขอการดาวน์โหลดอย่างชัดแจ้งผ่านบริการ Google Play ได้ ModuleInstallClient API

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

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

หากต้องการอัปเดตโมเดลของคุณเมื่อใช้โมเดลแบบกลุ่มหรือดาวน์โหลดแบบไดนามิก ตัวเลือกรุ่น:

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

    dependencies {
      implementation 'com.google.mlkit:barcode-scanning: 17.3.0' // The latest version number of the API
    }
    
  2. สร้างแอปอีกครั้ง

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

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