遷移 iOS 裝置

更新方法名稱

根據下列規則更新方法名稱：

• 網域進入點類別 (Vision、NaturalLanguage) 已不存在。他們 已由工作專屬類別取代 將呼叫取代為取得偵測工具的各種工廠方法 直接呼叫每個偵測工具的工廠方法。

• 我們已移除 VisionImageMetadata 類別和 VisionDetectorImageOrientation 列舉。使用 orientation 屬性 VisionImage 可指定圖片的顯示方向。

• 取得新 TextRecognizer 執行個體的 onDeviceTextRecognizer 方法 已重新命名為 textRecognizer。

• 已從文字中移除 confence 屬性 辨識結果類別，包括 TextElement、TextLine 和 TextBlock。

• 可透過 onDeviceImageLabeler 和 onDeviceImageLabeler(options:) 方法取得 新的 ImageLabeler 執行個體已合併並重新命名為 imageLabeler(options:)。

• 已移除取得新 ObjectDetector 執行個體的 objectDetector 方法。 請改用 objectDetector(options:)。

• type 屬性已從 ImageLabeler 和 圖片標籤結果類別 ImageLabel 已移除 entityID 屬性。

• 條碼掃描 API detect(in _:, completion:) 已重新命名為 process(_:, completion:) 與其他視覺 API 一致。

• Natural Language API 現在使用「語言標記」一詞(根據 BCP-47 Standard)，而不是「語言代碼」。

• TranslateLanguage 現在使用可讀取的名稱 (例如「.english」) 做為常數 而非語言標記 ( 例如 .en)。

以下列舉幾種 Swift 方法：

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()
    

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())
    

以下提供一些新舊 Objective-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];
    

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];
    

API 專屬變更

偵測及追蹤物件

請注意，如果應用程式使用物件分類功能，新的 SDK 也有所變更 傳回偵測到物件的分類類別。

VisionObject 中的 VisionObjectCategory 在 ObjectLabel 中會以 text 傳回 物件，而不是整數。所有可能的字串類別都會包含在 DetectedObjectLabel 列舉。

請注意，.unknown 類別已移除。對分類作業的信心時 則分類器不會傳回任何標籤

以下是新舊款 Swift 代碼的範例：

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

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) {
    ...
  }
}

以下是新舊 Objective-C 程式碼的範例：

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

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

移除 Firebase 依附元件 (選用)

只有在符合下列條件時，才適用這個步驟：

• Firebase ML Kit 是您唯一會用到的 Firebase 元件
• 您只會使用裝置端 API
• 您並未使用模型提供功能

如果是這種情況，您可以在遷移後移除 Firebase 依附元件。 請按照下列步驟操作：

• 刪除 GoogleService-Info.plist 來移除 Firebase 設定檔 檔案從應用程式目錄和 Xcode 專案匯入
• 從 Podfile 中移除任何 Firebase Cocoapod，例如 pod 'Firebase/Analytics'。
• 移除程式碼中所有 FirebaseApp 初始化作業，例如 FirebaseApp.configure()。
• 前往下列 Firebase 控制台刪除 Firebase 應用程式： 參閱 Firebase 支援網站上的操作說明。

取得協助

如果遇到任何問題，請瀏覽我們的社群頁面，其中列出相關說明 與我們聯絡