Đường dẫn cài đặt mô hình Bộ công cụ học máy trên Android

Theo mặc định, tất cả các tính năng của ML Kit đều sử dụng các mô hình học máy do Google huấn luyện (được gọi là mô hình cơ sở). Hướng dẫn này chỉ áp dụng cho các mô hình cơ sở. Xem hướng dẫn về các mô hình tuỳ chỉnh tại đây.

Bạn có thể cài đặt các mô hình trong API Bộ công cụ học máy theo một trong 3 cách sau:

  1. Không đi kèm: Các mô hình được tải xuống và quản lý thông qua Dịch vụ Google Play.
  2. Đi kèm: Các mô hình được liên kết tĩnh với ứng dụng của bạn tại thời gian xây dựng.
  3. Tải xuống linh động: Các mô hình được tải xuống theo yêu cầu.

Các đường dẫn cài đặt được hỗ trợ cho từng API

Bảng bên dưới cho biết những đường dẫn cài đặt mô hình được hỗ trợ bởi từng tính năng của ML Kit:

Không đi kèm Đi kèm Tải xuống linh động
Nhận dạng văn bản phiên bản 2 ✅ ✅
Phát hiện khuôn mặt ✅ ✅
Phát hiện lưới khuôn mặt ✅
Phát hiện tư thế ✅
Phân đoạn ảnh selfie ✅
Quét mã vạch ✅ ✅
Gắn nhãn hình ảnh ✅ ✅
Phát hiện và theo dõi vật thể ✅
Nhận dạng mực kỹ thuật số ✅
Trình quét tài liệu ✅
Phân đoạn đối tượng ✅
Trình quét mã của Google ✅
Xác định ngôn ngữ ✅ ✅
Dịch ✅
Trả lời thông minh ✅ ✅
Trích xuất thực thể ✅

Các hướng dẫn dành riêng cho API cho biết những lựa chọn cài đặt có sẵn cho API đã cho.

Những điểm khác biệt chính giữa các lựa chọn cài đặt

Không đi kèm Đi kèm Tải xuống linh động
Các mô hình được lưu trữ ở đâu? Nằm trong Dịch vụ Google Play và không được tính vào bộ nhớ mà ứng dụng này sử dụng Được lưu trong bộ nhớ dành riêng cho ứng dụng sau khi cài đặt Được lưu trong bộ nhớ dành riêng cho ứng dụng sau khi tải mô hình xuống
Kích thước mô hình ảnh hưởng đến kích thước ứng dụng như thế nào? Không đóng góp vào kích thước ứng dụng Đóng góp trực tiếp vào kích thước ứng dụng Không đóng góp vào kích thước ứng dụng nhưng làm tăng bộ nhớ dành riêng cho ứng dụng
Các mô hình được cập nhật khi nào? Tự động cập nhật khi phiên bản mới hơn được phát hành Cần cập nhật ứng dụng để cập nhật mô hình Cần cập nhật ứng dụng để cập nhật mô hình
Các mô hình được tải xuống khi nào? Bạn phải tải các mô hình xuống trước khi sử dụng Tất cả các mô hình và tính năng đều được đưa vào khi ứng dụng được cài đặt, vì vậy bạn có thể sử dụng ngay Bạn phải quản lý việc tải xuống, cập nhật và xoá mô hình theo cách thủ công bằng cách sử dụng RemoteModelManager API
Các mô hình bị xoá khỏi thiết bị khi nào? Dịch vụ Google Play sẽ chỉ xoá mô hình khỏi bộ nhớ nếu bạn gỡ cài đặt tất cả các ứng dụng phụ thuộc vào mô hình đó Các mô hình bị xoá khỏi bộ nhớ dành riêng cho ứng dụng khi bạn gỡ cài đặt ứng dụng Các mô hình đã tải xuống bị xoá khỏi bộ nhớ dành riêng cho ứng dụng khi bạn gỡ cài đặt ứng dụng

Cách chọn giữa mô hình đi kèm và không đi kèm

Nếu một API hỗ trợ cả lựa chọn cài đặt đi kèm và không đi kèm:

  • Hãy sử dụng lựa chọn đi kèm nếu bạn ưu tiên:

    • Chức năng đầy đủ của tính năng ngay sau khi cài đặt ứng dụng
    • Chức năng của tính năng mà không cần kết nối mạng sau khi cài đặt ứng dụng

  • Hãy sử dụng lựa chọn không đi kèm nếu bạn ưu tiên:

    • Kích thước ứng dụng nhỏ hơn
    • Dịch vụ Google Play tự động cập nhật mô hình

Cách tải mô hình xuống

Khi sử dụng lựa chọn mô hình không đi kèm, bạn có thể chỉ định cách tải các mô hình xuống thiết bị:

  • Bạn có thể bật tính năng tải mô hình xuống tại thời điểm cài đặt bằng cách thêm một phần khai báo vào tệp AndroidManifest.xml của ứng dụng. Ví dụ: đoạn mã dưới đây cho biết cách định cấu hình ứng dụng để tự động tải mô hình Quét mã vạch xuống sau khi ứng dụng của bạn được cài đặt từ Cửa hàng Play:

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

  • Bạn có thể yêu cầu tải xuống rõ ràng thông qua Dịch vụ Google Play ModuleInstallClient API.

  • Nếu bạn không bật tính năng tải mô hình xuống tại thời điểm cài đặt hoặc yêu cầu tải xuống rõ ràng, thì mô hình sẽ được tải xuống vào lần đầu tiên bạn chạy tính năng này. Cho đến khi quá trình tải xuống hoàn tất, các yêu cầu suy luận sẽ không thành công.

Cách cập nhật mô hình

Cách cập nhật mô hình khi sử dụng mô hình đi kèm hoặc lựa chọn mô hình tải xuống linh động:

  1. Cập nhật tệp gradle của ứng dụng để sử dụng thư viện ứng dụng khách tính năng Bộ công cụ học máy mới nhất.

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

  2. Xây dựng lại ứng dụng.

Lý do một số API cung cấp các mô hình tải xuống linh động

Một số API Bộ công cụ học máy có quá nhiều lựa chọn mô hình để đi kèm. Ví dụ: tính năng Nhận dạng mực kỹ thuật số hỗ trợ hơn 300 ngôn ngữ và bạn không phải lúc nào cũng cần đưa mọi ngôn ngữ vào tính năng này trong quá trình cài đặt. Vì mục đích đó, chúng tôi cung cấp lựa chọn cài đặt thứ ba, trong đó các mô hình được tải xuống theo yêu cầu sau khi cài đặt. Hiện tại, chỉ có tính năng Nhận dạng mực kỹ thuật số, Dịch và Trích xuất thực thể có lựa chọn này.