Hướng dẫn di chuyển Bộ công cụ học máy AutoML Vision Edge

Bạn có thể truyền một mô hình phân loại hình ảnh được huấn luyện bằng AutoML đến các API mô hình tuỳ chỉnh. Bạn có thể tiếp tục kết hợp mô hình này trong ứng dụng hoặc lưu trữ mô hình đó trên Bảng điều khiển của Firebase dưới dạng một mô hình tuỳ chỉnh. API gắn nhãn hình ảnh AutoML đã bị xoá khỏi ML Kit vì được thay thế hoàn toàn bằng API gắn nhãn hình ảnh mô hình tuỳ chỉnh.

Nếu bạn hiện là người dùng Bộ công cụ học máy và đang sử dụng AutoML Vision Edge API, vui lòng làm theo hướng dẫn di chuyển cho Android và iOS.

Câu hỏi thường gặp

Tại sao lại có sự thay đổi này?

Thay đổi này giúp đơn giản hoá các API của Bộ công cụ học máy và giúp bạn dễ dàng tích hợp Bộ công cụ học máy vào ứng dụng của mình. Nhờ đó, bạn có thể sử dụng mô hình được huấn luyện bằng AutoML theo cách hoàn toàn giống như một mô hình tuỳ chỉnh. Ngoài ra, bạn cũng có thể sử dụng các mô hình được huấn luyện bằng AutoML cho tính năng Phát hiện và theo dõi đối tượng, bên cạnh tính năng Gắn nhãn hình ảnh mà chúng tôi hiện hỗ trợ. Ngoài ra, API mô hình tuỳ chỉnh hỗ trợ cả mô hình có bản đồ nhãn được nhúng trong siêu dữ liệu và mô hình có tệp kê khai và tệp nhãn riêng biệt.

Tôi nhận được những lợi ích gì khi di chuyển sang SDK mới?

• Tính năng mới: Có thể sử dụng các mô hình được AutoML huấn luyện cho cả tính năng Gắn nhãn hình ảnh và tính năng Phát hiện và theo dõi đối tượng, đồng thời có thể sử dụng các mô hình có bản đồ nhãn được nhúng trong siêu dữ liệu của mô hình.

Hướng dẫn di chuyển cho Android

Bước 1: Cập nhật dữ liệu nhập Gradle

Cập nhật các phần phụ thuộc cho thư viện ML Kit Android trong tệp Gradle (ở cấp ứng dụng) của mô-đun (thường là app/build.gradle) theo bảng sau:

Bước 2: Cập nhật tên lớp

Nếu lớp của bạn xuất hiện trong bảng này, hãy thực hiện thay đổi được chỉ ra:

Bước 3: Cập nhật tên phương thức

Có rất ít thay đổi về mã:

• Giờ đây, bạn có thể khởi tạo LocalModel bằng đường dẫn tệp mô hình (nếu mô hình có siêu dữ liệu chứa bản đồ nhãn) hoặc đường dẫn tệp kê khai mô hình (nếu tệp kê khai, mô hình và nhãn nằm trong các tệp riêng biệt).
• Bạn có thể lưu trữ một mô hình tuỳ chỉnh từ xa thông qua Bảng điều khiển của Firebase và khởi chạy một CustomRemoteModel bằng một FirebaseModelSource.

Dưới đây là một số ví dụ về các phương thức Kotlin cũ và mới:

val localModel = AutoMLImageLabelerLocalModel.Builder()
    .setAssetFilePath("automl/manifest.json")
    // or .setAbsoluteFilePath(absolute file path to manifest file)
    .build()

val optionsWithLocalModel = AutoMLImageLabelerOptions.Builder(localModel)
    .setConfidenceThreshold(0.5f)
    .build()

val remoteModel = AutoMLImageLabelerRemoteModel.Builder("automl_remote_model")
    .build()

val optionsWithRemoteModel = AutoMLImageLabelerOptions.Builder(remoteModel)
    .build()

val localModel = LocalModel.Builder()
    .setAssetManifestFilePath("automl/manifest.json")
    // or .setAbsoluteManifestFilePath(absolute file path to manifest file)
    .build()

val optionsWithLocalModel = CustomImageLabelerOptions.Builder(localModel)
    .setConfidenceThreshold(0.5f)
    .build()

val firebaseModelSource = FirebaseModelSource.Builder("automl_remote_model")
    .build()
val remoteModel = CustomRemoteModel.Builder(firebaseModelSource).build()
val optionsWithRemoteModel = CustomImageLabelerOptions.Builder(remoteModel)
    .build()

Sau đây là một số ví dụ về các phương thức Java cũ và mới:

AutoMLImageLabelerLocalModel localModel =
    new AutoMLImageLabelerLocalModel.Builder()
        .setAssetFilePath("automl/manifest.json")
        // or .setAbsoluteFilePath(absolute file path to manifest file)
        .build();
AutoMLImageLabelerOptions optionsWithLocalModel =
    new AutoMLImageLabelerOptions.Builder(localModel)
        .setConfidenceThreshold(0.5f)
        .build();
AutoMLImageLabelerRemoteModel remoteModel =
    new AutoMLImageLabelerRemoteModel.Builder("automl_remote_model").build();
AutoMLImageLabelerOptions optionsWithRemoteModel =
    new AutoMLImageLabelerOptions.Builder(remoteModel)
        .build();

LocalModel localModel =
    new LocalModel.Builder()
        .setAssetManifestFilePath("automl/manifest.json")
        // or .setAbsoluteManifestFilePath(absolute file path to manifest file)
        .build()
CustomImageLabelerOptions optionsWithLocalModel =
    new CustomImageLabelerOptions.Builder(localModel)
        .setConfidenceThreshold(0.5f)
        .build();
FirebaseModelSource firebaseModelSource =
    new FirebaseModelSource.Builder("automl_remote_model").build();
CustomRemoteModel remoteModel =
    new CustomRemoteModel.Builder(firebaseModelSource).build();
CustomImageLabelerOptions optionsWithRemoteModel =
    new CustomImageLabelerOptions.Builder(remoteModel).build();

Hướng dẫn di chuyển cho iOS

Điều kiện tiên quyết

• Bạn phải dùng Xcode 13.2.1 trở lên.

Bước 1: Cập nhật Cocoapods

Cập nhật các phần phụ thuộc cho cocoapods ML Kit iOS trong Podfile của ứng dụng:

Bước 2: Cập nhật tên lớp

Nếu lớp của bạn xuất hiện trong bảng này, hãy thực hiện thay đổi được chỉ ra:

let localModel =
    AutoMLImageLabelerLocalModel(manifestPath: "automl/manifest.json")
let optionsWithLocalModel = AutoMLImageLabelerOptions(localModel: localModel)
let remoteModel = AutoMLImageLabelerRemoteModel(name: "automl_remote_model")
let optionsWithRemoteModel = AutoMLImageLabelerOptions(remoteModel: remoteModel)

guard let localModel = LocalModel(manifestPath: "automl/manifest.json") else { return }
let optionsWithLocalModel = CustomImageLabelerOptions(localModel: localModel)
let firebaseModelSource = FirebaseModelSource(name: "automl_remote_model")
let remoteModel = CustomRemoteModel(remoteModelSource: firebaseModelSource)
let optionsWithRemoteModel = CustomImageLabelerOptions(remoteModel: remoteModel)

MLKAutoMLImageLabelerLocalModel *localModel =
    [[MLKAutoMLImageLabelerLocalModel alloc]
        initWithManifestPath:"automl/manifest.json"];
MLKAutoMLImageLabelerOptions *optionsWithLocalModel =
    [[MLKAutoMLImageLabelerOptions alloc] initWithLocalModel:localModel];
MLKAutoMLImageLabelerRemoteModel *remoteModel =
    [[MLKAutoMLImageLabelerRemoteModel alloc]
        initWithManifestPath:"automl/manifest.json"];
MLKAutoMLImageLabelerOptions *optionsWithRemoteModel =
    [[MLKAutoMLImageLabelerOptions alloc] initWithRemoteModel:remoteModel];

MLKLocalModel *localModel =
    [[MLKLocalModel alloc] initWithManifestPath:"automl/manifest.json"];
MLKCustomImageLabelerOptions *optionsWithLocalModel =
    [[MLKCustomImageLabelerOptions alloc] initWithLocalModel:localModel];
MLKFirebaseModelSource *firebaseModelSource =
    [[MLKFirebaseModelSource alloc] initWithName:@"automl_remote_model"];
MLKCustomRemoteModel *remoteModel =
    [[MLKCustomRemoteModel alloc] initWithRemoteModelSource:firebaseModelSource];
MLKCustomImageLabelerOptions *optionsWithRemoteModel =
    [[MLKCustomImageLabelerOptions alloc] initWithRemoteModel:remoteModel];