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

Tất cả tính năng của Bộ công cụ học máy đều sử dụng các mô hình học máy do Google đào tạo (còn gọi là mô hình cơ sở) theo mặc định. Hướng dẫn này chỉ áp dụng cho các mô hình cơ sở. Xem ở đây để được hướng dẫn về mô hình tuỳ chỉnh.

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:

  1. Chưa theo gói: Các mô hình được tải xuống và quản lý thông qua Dịch vụ Google Play.
  2. Theo gói: 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 điểm xây dựng.
  3. Tải xuống động: Các mô hình được tải xuống theo yêu cầu.

Đường dẫn cài đặt được hỗ trợ cho mỗi API

Bảng bên dưới cho biết những đường dẫn cài đặt mô hình mà từng công nghệ học máy hỗ trợ Tính năng của bộ công cụ:

Không theo nhóm Theo gói Được tải xuống độ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 ống nước
Phân đoạn bằng ảnh tự chụp
Quét mã vạch
Gắn nhãn hình ảnh
Phát hiện và theo dõi đối tượng
Nhận dạng mực kỹ thuật số
Trình quét tài liệu
Phân đoạn theo chủ đề
Trình quét mã của Google
Nhận dạng ngôn ngữ
Bản dịch
Trả lời thông minh
Trích xuất thực thể

Hướng dẫn dành riêng cho API cho biết những tuỳ chọn cài đặt nào dành cho API.

Những điểm khác biệt chính giữa các chế độ cài đặt

Không nhóm Theo gói Được tải xuống động
Các mẫu được lưu trữ ở đâu? Nằm trong Dịch vụ Google Play và không được tính vào dung lượng lưu trữ 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 như thế nào đến kích thước ứng dụng? Không ảnh hưởng đến 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
Khi nào các mô hình được cập nhật? 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
Khi nào các mô hình được tải xuống? Bạn phải tải mô hình xuống trước khi sử dụng Tất cả mô hình và tính năng đều được bao gồm khi ứng dụng được cài đặt, vì vậy có thể sử dụng ngay lập tức 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 RemoteModelManager API
Khi nào các mẫu điện thoại bị xoá khỏi thiết bị? Dịch vụ Google Play sẽ chỉ xoá mô hình đó khỏi bộ nhớ nếu tất cả ứng dụng phụ thuộc vào kiểu máy sẽ bị gỡ cài đặt Các mô hình sẽ 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 sẽ 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 đã nhóm và không nhóm

Nếu một API hỗ trợ cả tuỳ chọn cài đặt theo gói và tuỳ chọn theo gói:

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

    • Hoàn tất chức năng 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
  • Sử dụng lựa chọn không nhó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 về mô hình không theo nhóm, bạn có thể chỉ định cách bạn muốn các mô hình được đã tải 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 nội dung 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ã vạch xuống Mô hình quét sau khi ứng dụng của bạn được cài đặt qua 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 nội dung rõ ràng xuống thông qua Dịch vụ Google Play API Mô-đunInstallClient.

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

Cách cập nhật người mẫu

Để cập nhật các mô hình của bạn khi sử dụng mô hình theo gói hoặc mô hình được tải xuống động mô hình:

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

    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 của bạn.

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

Một số API Bộ công cụ học máy có quá nhiều lựa chọn về mô hình để gói. Ví dụ: Mực kỹ thuật số tính năng nhận dạng hỗ trợ hơn 300 ngôn ngữ và không phải là đặt mọi ngôn ngữ bên trong tính năng trong quá trình cài đặt. Để phục 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ỉ Mực kỹ thuật số nhận dạng, Bản dịchThực thể trích xuất có tuỳ chọn này.