针对 iOS 进行迁移

更新方法名称

根据以下规则更新方法名称：

• 网域入口点类（Vision、NaturalLanguage）不再存在。他们 已替换为特定于任务的类。 将对用于获取检测器的各种工厂方法的调用替换为 直接调用每个检测器的出厂方法。

• 移除了 VisionImageMetadata 类，以及 VisionDetectorImageOrientation 枚举。使用 orientation 属性： VisionImage：用于指定图片的显示方向。

• 用于获取新 TextRecognizer 实例的 onDeviceTextRecognizer 方法 已重命名为 textRecognizer。

• 已从文本中移除置信度属性 包括 TextElement、TextLine 和 TextBlock。

• onDeviceImageLabeler 和 onDeviceImageLabeler(options:) 方法，用于获取 新的ImageLabeler实例已合并并重命名为 imageLabeler(options:)。

• 移除了用于获取新 ObjectDetector 实例的 objectDetector 方法。 请改用 objectDetector(options:)。

• type 属性已从 ImageLabeler 和 从图片标签结果类 ImageLabel 中移除了 entityID 属性。

• 条形码扫描 API detect(in _:, completion:) 已重命名为 process(_:, completion:)，以便与其他 Vision API 保持一致。

• Natural Language API 现在使用术语“语言标记”（由 BCP-47 标准），而不是“语言代码”。

• 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 机器学习套件是您唯一使用的 Firebase 组件
• 您仅使用设备端 API
• 您未使用模型部署

如果是这种情况，您可以在迁移后移除 Firebase 依赖项。 请按照以下步骤操作：

• 通过删除 GoogleService-Info.plist 来移除 Firebase 配置文件 文件。
• 从 Podfile 中移除任何 Firebase cocoapod，例如 pod 'Firebase/Analytics'。
• 从代码中移除任何 FirebaseApp 初始化，例如 FirebaseApp.configure()。
• 在 Firebase 控制台中删除您的 Firebase 应用 请参阅 Firebase 支持网站上的说明。

获取帮助

如果您遇到任何问题，请访问我们的社区页面，其中概述了 与我们联系的途径。