การย้ายข้อมูลสำหรับ iOS

คู่มือนี้จะอธิบายวิธีย้ายข้อมูลออกจาก ML Kit สำหรับ Firebase สำหรับ iOS

ข้อกำหนดเบื้องต้น

โปรดตรวจสอบว่าคุณมีคุณสมบัติตรงตามข้อกำหนดต่อไปนี้ก่อนเริ่มย้ายข้อมูลโค้ด

• ML Kit รองรับ Xcode 13.2.1 ขึ้นไป
• ML Kit รองรับ iOS เวอร์ชัน 15.5 ขึ้นไป
• ML Kit ไม่รองรับสถาปัตยกรรม 32 บิต (i386 และ armv7) ML Kit รองรับสถาปัตยกรรม 64 บิต (x86_64 และ arm64)
• ไลบรารี ML Kit มีให้ใช้งานในรูปแบบ Cocoapods เท่านั้น คุณไม่สามารถใช้ทั้งเฟรมเวิร์กและ Cocoapods ร่วมกันได้ ดังนั้นหากต้องการใช้ไลบรารีนี้ คุณต้องย้ายข้อมูลไปใช้ Cocoapods ก่อน

อัปเดต Cocoapods

อัปเดตทรัพยากร Dependency สำหรับ Cocoapods ของ ML Kit iOS ใน Podfile ของแอป

อัปเดตชื่อคลาส, Enum และประเภท

โดยทั่วไปแล้ว คุณต้องเปลี่ยนชื่อคลาส, Enum และประเภทดังนี้

• Swift: นำคำนำหน้า Vision ออกจากชื่อคลาสและ Enum
• Objective-C: แทนที่คำนำหน้าชื่อคลาสและ Enum ทั้ง FIRVision และ FIR ด้วย MLK

กฎทั่วไปนี้ใช้ไม่ได้กับชื่อคลาสและประเภทบางรายการ

อัปเดตชื่อเมธอด

อัปเดตชื่อเมธอดตามกฎต่อไปนี้

• คลาสจุดเริ่มต้นของโดเมน (Vision, NaturalLanguage) ไม่มีอยู่อีกต่อไป โดยถูกแทนที่ด้วยคลาสเฉพาะงาน แทนที่การเรียกเมธอด Factory ต่างๆ เพื่อรับเครื่องมือตรวจจับด้วยการเรียกเมธอด Factory ของเครื่องมือตรวจจับแต่ละรายการโดยตรง

• คลาส VisionImageMetadata ถูกนำออกแล้ว รวมถึง Enum VisionDetectorImageOrientation ด้วย ใช้พร็อพเพอร์ตี้ orientation ของ VisionImage เพื่อระบุการวางแนวการแสดงผลของรูปภาพ

• เมธอด onDeviceTextRecognizer ที่รับอินสแตนซ์ TextRecognizer ใหม่ถูกเปลี่ยนชื่อเป็น textRecognizer

• พร็อพเพอร์ตี้ความเชื่อมั่นถูกนำออกจากคลาสผลลัพธ์การจดจำข้อความ ซึ่งรวมถึง TextElement, TextLine และ TextBlock

• เมธอด onDeviceImageLabeler และ onDeviceImageLabeler(options:) เพื่อ รับอินสแตนซ์ ImageLabeler ใหม่ถูกผสานและเปลี่ยนชื่อเป็น imageLabeler(options:)

• เมธอด objectDetector เพื่อรับอินสแตนซ์ ObjectDetector ใหม่ถูกนำออกแล้ว ให้ใช้ objectDetector(options:) แทน

• พร็อพเพอร์ตี้ type ถูกนำออกจาก ImageLabeler และพร็อพเพอร์ตี้ entityID ถูกนำออกจากคลาสผลลัพธ์การติดป้ายกำกับรูปภาพ ImageLabel

• 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 ใหม่ได้เปลี่ยนวิธีแสดงผลหมวดหมู่การจัดประเภทสำหรับวัตถุที่ตรวจพบ

VisionObjectCategory ใน VisionObject จะแสดงผลเป็น text ในออบเจ็กต์ ObjectLabel แทนที่จะเป็นจำนวนเต็ม หมวดหมู่สตริงที่เป็นไปได้ทั้งหมดจะรวมอยู่ใน Enum 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]) {
  ...
}

นำทรัพยากร Dependency ของ Firebase ออก

นำทรัพยากร Dependency ของ Firebase ออกหลังจากการย้ายข้อมูล โดยทำตามขั้นตอนต่อไปนี้

• นำไฟล์กำหนดค่า Firebase ออกโดยลบไฟล์ GoogleService-Info.plist ออกจากไดเรกทอรีของแอปและโปรเจ็กต์ Xcode
• นำ Cocoapods ของ Firebase เช่น pod 'Firebase/Analytics' ออกจาก Podfile
• นำการเริ่มต้น FirebaseApp เช่น FirebaseApp.configure() ออกจากโค้ด
• ลบแอป Firebase ในคอนโซล Firebase ตาม วิธีการในเว็บไซต์สนับสนุนของ Firebase

ขอความช่วยเหลือ

หากพบปัญหา โปรดดูหน้าชุมชน ของเรา ซึ่งเราได้ระบุช่องทางต่างๆ ที่คุณสามารถติดต่อเรา