Trang này được dịch bởi Cloud Translation API.

Đườ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ả 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ở). Hướng dẫn này chỉ áp dụng cho các mô hình cơ sở. Xem hướng dẫn về 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:

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.
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.
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 từng API

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

	Không phân nhóm	Theo gói	Tự động tải xuố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 khuôn mặt dạng lưới		✅
Phát hiện tư thế		✅
Phân đoạn ảnh chân dung 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 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 sẽ cho biết những tuỳ chọn cài đặt có sẵn cho API nhất định.

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

	Không nhóm	Theo gói	Tự động tải xuố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 dung lượng lưu trữ mà ứng dụng này 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 đó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
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 kiểu máy	Cần cập nhật ứng dụng để cập nhật kiểu máy
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 cài đặt ứng dụng nên có thể sử dụng ngay lập tức	Bạn phải quản lý các thao tác tải xuống, cập nhật và xoá mô hình theo cách thủ công bằng API RemoteModelManager
Khi nào các mẫu máy bị xoá khỏi thiết bị?	Dịch vụ Google Play sẽ chỉ xoá mô hình đó khỏi bộ nhớ nếu bạn gỡ cài đặt mọi ứ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 ứng dụng bị gỡ cài đặt	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 các gói và không theo nhóm

Nếu API hỗ trợ cả tuỳ chọn cài đặt theo gói và không 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 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 theo nhóm nếu bạn ưu tiên:
- Kích thước ứng dụng nhỏ hơn
- Dịch vụ Google Play cập nhật mô hình tự động

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

Khi sử dụng tuỳ chọn mô hình chưa theo gói, bạn có thể chỉ định cách bạn muốn 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 theo thời gian cài đặt xuống 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ô 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" >
      
</application>
```
Bạn có thể yêu cầu tải xuống rõ ràng thông qua ModuleInstallClient API của Dịch vụ Google Play.
Nếu bạn không cho phép tải mô hình xuống khi cài đặt hoặc yêu cầu tải mô hình xuống một cách rõ ràng, thì 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. Cho đến khi quá trình tải xuống hoàn tất, yêu cầu dự đoá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 tuỳ chọn mô hình được tải xuống linh động:

Hãy cập nhật tệp gradle của ứng dụng để sử dụng thư viện ứng dụng có tính năng mới nhất của Bộ công cụ học máy.
```
dependencies {
  implementation 'com.google.mlkit:barcode-scanning: 17.2.0' // The latest version number of the API
}
```
Xây dựng lại ứng dụng.

Tại sao một số API cung cấp 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ụ: tính năng Nhận dạng mực kỹ thuật số hỗ trợ hơn 300 ngôn ngữ và không phải lúc nào cũng cần phải đặt mọi ngôn ngữ vào bên trong tính năng trong quá trình cài đặt. Vì mục đích đó, chúng tôi cung cấp tuỳ 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ỉ tính năng Nhận dạng mực kỹ thuật số, Dịch và Trích xuất thực thể mới có tuỳ chọn này.