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

Di chuyển cho iOS

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

Trước khi bắt đầu di chuyển mã, hãy đảm bảo rằng bạn đáp ứng các yêu cầu sau:

Bộ công cụ học máy hỗ trợ Xcode 13.2.1 trở lên.
Bộ công cụ học máy hỗ trợ iOS phiên bản 10 trở lên.
Bộ công cụ học máy không hỗ trợ kiến trúc 32 bit (i386 và armv7). Bộ công cụ học máy hỗ trợ kiến trúc 64 bit (x86_64 và arm64).
Thư viện Bộ công cụ học máy chỉ được cung cấp dưới dạng cocoapod. Bạn không thể kết hợp khung và cocoapod, vì vậy, để sử dụng thư viện này, trước tiên bạn cần di chuyển để sử dụng cocoapod.

Cập nhật CocoaPods

Cập nhật các phần phụ thuộc cho cocoaPods dành cho iOS của Bộ công cụ học máy trong Podfile của ứng dụng:

API	(Các) tên nhóm cũ	(Các) tên nhóm mới
Quét mã vạch	Firebase/MLVision Firebase/MLVisionBarcodeModel	GoogleMLKit/Quét mã vạch
Phát hiện khuôn mặt	Firebase/MLVision Firebase/MLVisionFaceModel	GoogleMLKit/FaceDetection
Gắn nhãn hình ảnh	Firebase/MLVision Firebase/MLVisionLabelModel	GoogleMLKit/Gắn nhãn hình ảnh
Phát hiện và theo dõi đối tượng	Firebase/MLVisionObjectDetection	GoogleMLKit/ObjectDetection
Nhận dạng văn bản	Firebase/MLVision Firebase/MLVisionTextModel	GoogleMLKit/Nhận dạng văn bản
Gắn nhãn hình ảnh AutoML (mô hình theo gói)	Firebase/MLVisionAutoML	GoogleMLKit/ImageLabelingCustom
Gắn nhãn hình ảnh AutoML (tải mô hình xuống từ Firebase)	Firebase/MLVisionAutoML	GoogleMLKit/ImageLabelingCustom GoogleMLKit/LinkFirebase
Mã ngôn ngữ	Firebase/MLNaturalLanguage Firebase/MLNLLanguageID	GoogleMLKit/LanguageID
Trả lời thông minh	Firebase/MLNaturalLanguage Firebase/MLNLSmartAnswer	GoogleMLKit/Trả lời thông minh
Dịch chuyển	Firebase/MLNaturalLanguage Firebase/MLNLTranslate	GoogleMLKit/Dịch

Cập nhật tên lớp, enum và kiểu

Nói chung, bạn cần đổi tên các lớp , enum và loại như sau:

Swift: Xoá tiền tố Vision khỏi tên lớp và enum
Objective-C: Thay thế cả tên lớp FIRVision và FIR cũng như tiền tố enum bằng MLK

Đối với một số loại và tên lớp, quy tắc chung này không áp dụng:

Swift

Lớp hoặc kiểu cũ	Lớp hoặc kiểu mới
AutoMLLocalModel	LocalModel
AutoMLRemoteModel	CustomRemoteModel
VisionBarcodeDetectionCallback	BarcodeScanningCallback
VisionBarcodeDetector	BarcodeScanner
VisionBarcodeDetectorOptions	BarcodeScannerOptions
VisionImage	VisionImage (không thay đổi)
VisionPoint	VisionPoint (không có thay đổi)
VisionOnDeviceAutoMLImageLabelerOptions	CustomImageLabelerOptions
VisionOnDeviceImageLabelerOptions	ImageLabelerOptions

Objective-C

Lớp hoặc kiểu cũ	Lớp hoặc kiểu mới
FIRAutoMLLocalModel	MLKLocalModel
FIRAutoMLRemoteModel	MLKCustomRemoteModel
FIRVisionBarcodeDetectionCallback	MLKBarcodeScanningCallback
FIRVisionBarcodeDetector	MLKBarcodeScanner
FIRVisionBarcodeDetectorOptions	MLKBarcodeScannerOptions
FIRVisionImage	MLKVisionImage
FIRVisionOnDeviceAutoMLImageLabelerOptions	MLKCustomImageLabelerOptions
FIRVisionOnDeviceImageLabelerOptions	MLKImageLabelerOptions
FIRVisionPoint	MLKVisionPoint

Objective-C

Cập nhật tên phương thức

Cập nhật tên phương thức theo các quy tắc sau:

Các lớp điểm truy cập miền (Vision, NaturalLanguage) không còn tồn tại nữa. Chúng đã được thay thế bằng các lớp tác vụ cụ thể. Thay thế các lệnh gọi đến phương thức nhà máy của từng trình phát hiện để nhận lệnh gọi trực tiếp đến phương thức ban đầu của từng trình phát hiện.
Xoá lớp VisionImageMetadata, cùng với lớp enum VisionDetectorImageOrientation. Sử dụng thuộc tính orientation của VisionImage để chỉ định hướng hiển thị của hình ảnh.
Phương thức onDeviceTextRecognizer nhận một thực thể TextRecognizer mới đã được đổi tên thành textRecognizer.
Thuộc tính tin cậy đã bị xoá khỏi các lớp kết quả nhận dạng văn bản, bao gồm cả TextElement, TextLine và TextBlock.
Các phương thức onDeviceImageLabeler và onDeviceImageLabeler(options:) để tải một thực thể ImageLabeler mới đã được hợp nhất và đổi tên thành imageLabeler(options:).
Phương thức objectDetector để tải một thực thể ObjectDetector mới đã bị xoá. Thay vào đó, hãy sử dụng objectDetector(options:).
Thuộc tính type đã bị xoá khỏi ImageLabeler và thuộc tính entityID cũng bị xoá khỏi lớp kết quả gắn nhãn hình ảnh, ImageLabel.
API quét mã vạch detect(in _:, completion:) đã được đổi tên thành process(_:, completion:) để nhất quán với các API tầm nhìn khác.
API Ngôn ngữ tự nhiên hiện sử dụng thuật ngữ "thẻ ngôn ngữ" (theo định nghĩa trong tiêu chuẩn BCP-47) thay vì "mã ngôn ngữ".
Giờ đây, TranslateLanguage sử dụng tên có thể đọc được (như .english) cho các hằng số thay vì thẻ ngôn ngữ ( như .en).

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

Cũ

let options = VisionOnDeviceImageLabelerOptions()
options.confidenceThreshold = 0.75
let labeler = Vision.vision().onDeviceImageLabeler(options: options)

let detector = Vision.vision().faceDetector(options: options)

let localModel = AutoMLLocalModel(manifestPath: "automl/manifest.json")
let options = VisionOnDeviceAutoMLImageLabelerOptions(localModel: localModel)
options.confidenceThreshold = 0.75
let labeler = vision.onDeviceAutoMLImageLabeler(options: options)

let detector = Vision.vision().objectDetector()

Mới

let options = ImageLabelerOptions()
options.confidenceThreshold = NSNumber(value:0.75)
let labeler = ImageLabeler.imageLabeler(options: options)

let detector = FaceDetector.faceDetector(options: options)

let localModel = LocalModel(manifestPath: "automl/manifest.json")
let options = CustomImageLabelerOptions(localModel: localModel)
options.confidenceThreshold = NSNumber(value:0.75)
let labeler = ImageLabeler.imageLabeler(options: options)

let detector = ObjectDetector.objectDetector(options: ObjectDetectorOptions())

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

Cũ

FIRVisionOnDeviceImageLabelerOptions *options = 
    [[FIRVisionOnDeviceImageLabelerOptions alloc] init];
options.confidenceThreshold = 0.75;
FIRVisionImageLabeler *labeler = 
    [[FIRVision vision] onDeviceImageLabelerWithOptions:options];

FIRVisionFaceDetector *detector =
    [[FIRVision vision] faceDetectorWithOptions: options];

FIRAutoMLLocalModel *localModel =
    [[FIRAutoMLLocalModel alloc] initWithManifestPath:@"automl/manifest.json"];
FIRVisionOnDeviceAutoMLImageLabelerOptions *options =
    [[FIRVisionOnDeviceAutoMLImageLabelerOptions alloc]
        initWithLocalModel: localModel];
options.confidenceThreshold = 0.75
FIRVisionImageLabeler *labeler =
    [[FIRVision vision] onDeviceAutoMLImageLabelerWithOptions:options];

FIRVisionObjectDetector *detector =
    [[FIRVision vision] objectDetector];

Mới

MLKImageLabelerOptions *options =
    [[MLKImageLabelerOptions alloc] init];
options.confidenceThreshold = @(0.75);
MLKImageLabeler *labeler =
    [MLKImageLabeler imageLabelerWithOptions:options];

MLKFaceDetector *detector =
    [MLKFaceDetector faceDetectorWithOptions:options];

MLKLocalModel *localModel =
    [[MLKLocalModel alloc]
        initWithManifestPath:@"automl/manifest.json"];
MLKCustomImageLabelerOptions *options =
    [[MLKCustomImageLabelerOptions alloc] initWithLocalModel:localModel];
options.confidenceThreshold = @(0.75)
MLKImageLabeler *labeler =
    [MLKImageLabeler imageLabelerWithOptions:options];

MLKObjectDetectorOptions *options = [[MLKObjectDetectorOptions alloc] init];
MLKObjectDetector *detector = [MLKObjectDetector objectDetectorWithOptions:options];

Các thay đổi dành riêng cho API

Phát hiện và theo dõi đối tượng

Nếu ứng dụng của bạn sử dụng tính năng phân loại đối tượng, hãy lưu ý rằng SDK mới đã thay đổi cách trả về danh mục phân loại cho các đối tượng đã phát hiện.

VisionObjectCategory trong VisionObject được trả về dưới dạng text trong đối tượng ObjectLabel, thay vì một số nguyên. Tất cả các danh mục chuỗi có thể có đều được đưa vào enum DetectedObjectLabel.

Xin lưu ý rằng danh mục .unknown đã bị xoá. Khi không tự tin phân loại một đối tượng, thuật toán phân loại sẽ không trả về nhãn nào.

Sau đây là ví dụ về mã Swift cũ và mới:

Cũ

if (object.classificationCategory == .food) {
    ...
}

Mới

if let label = object.labels.first {
  if (label.text == DetectedObjectLabel.food.rawValue) {
    ...
  }
}
// or
if let label = object.labels.first {
  if (label.index == DetectedObjectLabelIndex.food.rawValue) {
    ...
  }
}

Dưới đây là ví dụ về mã Objective-C cũ và mới:

Cũ

if (object.classificationCategory == FIRVisionObjectCategoryFood) {
    ...
}

Mới

if ([object.labels[0].text isEqualToString:MLKDetectedObjectLabelFood]) {
  ...
}
// or
if ([object.labels[0].index == MLKDetectedObjectLabelIndexFood]) {
  ...
}

Xoá các phần phụ thuộc Firebase (Không bắt buộc)

Bước này chỉ áp dụng khi các điều kiện sau được đáp ứng:

Bộ công cụ học máy của Firebase là thành phần Firebase duy nhất mà bạn sử dụng
Bạn chỉ sử dụng các API trên thiết bị
Bạn không sử dụng mô hình phân phát

Trong trường hợp này, bạn có thể xoá các phần phụ thuộc Firebase sau khi di chuyển. Hãy làm theo các bước sau:

Xóa tệp cấu hình Firebase bằng cách xóa tệp GoogleService-Info.plist khỏi thư mục ứng dụng và dự án Xcode của bạn.
Xoá mọi cocoapod của Firebase, chẳng hạn như pod 'Firebase/Analytics', khỏi Podfile của bạn.
Xoá mọi hoạt động khởi tạo FirebaseApp, chẳng hạn như FirebaseApp.configure() khỏi mã của bạn.
Xoá ứng dụng Firebase của bạn tại bảng điều khiển của Firebase theo instructions trên trang web hỗ trợ của Firebase.

Nhận trợ giúp

Nếu bạn gặp bất kỳ vấn đề nào, vui lòng xem trang Cộng đồng của chúng tôi. Tại đây, chúng tôi liệt kê những kênh hiện có để bạn liên hệ.