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

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

วิธีอัปเดตรูปแบบ

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

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

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

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

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