ข้อกำหนดเบื้องต้น
ก่อนที่จะเริ่มย้ายข้อมูลโค้ด โปรดตรวจสอบว่าคุณมีคุณสมบัติตรงตามข้อกำหนดต่อไปนี้
- ML Kit รองรับ Xcode 13.2.1 หรือใหม่กว่า
- ML Kit รองรับ iOS เวอร์ชัน 10 หรือใหม่กว่า
- ML Kit ไม่รองรับสถาปัตยกรรม 32 บิต (i386 และ armv7) ML Kit รองรับสถาปัตยกรรม 64 บิต (x86_64 และ arm64)
- คลัง ML Kit ให้บริการเป็น CocoaPod เท่านั้น คุณไม่สามารถรวมเฟรมเวิร์กและ CocoaPods เข้าด้วยกัน ดังนั้นคุณต้องย้ายข้อมูลเพื่อใช้ CocoaPod ก่อนจึงจะใช้ไลบรารีนี้ได้
อัปเดต CocoaPods
อัปเดตทรัพยากร Dependency สำหรับ CocoaPods ของ ML Kit บน iOS ใน Podfile ของแอป โดยทำดังนี้
API | ชื่อพ็อดเก่า | ชื่อพ็อดใหม่ |
---|---|---|
การสแกนบาร์โค้ด | Firebase/MLVision Firebase/MLVisionBarcodeModel |
GoogleMLKit/BarcodeScanning |
การตรวจจับใบหน้า | Firebase/MLVision Firebase/MLVisionFaceModel |
GoogleMLKit/FaceDetection |
การติดป้ายกำกับรูปภาพ | Firebase/MLVision Firebase/MLVisionLabelModel |
GoogleMLKit/ImageLabeling |
การตรวจจับและติดตามวัตถุ | Firebase/MLVisionObjectDetection | GoogleMLKit/ObjectDetection |
การรู้จำข้อความ | Firebase/MLVision Firebase/MLVisionTextModel |
GoogleMLKit/การรู้จำข้อความ |
การติดป้ายกำกับรูปภาพ AutoML (โมเดลแบบกลุ่ม) | Firebase/MLVisionAutoML | GoogleMLKit/ImageLabelingCustom |
การติดป้ายกำกับรูปภาพ AutoML (การดาวน์โหลดโมเดลจาก Firebase) | Firebase/MLVisionAutoML | GoogleMLKit/ImageLabelingCustom GoogleMLKit/LinkFirebase |
รหัสภาษา | Firebase/MLNaturalLanguage รหัสภาษา Firebase/MLNL |
GoogleMLKit/LanguageID |
ฟีเจอร์ช่วยตอบ | Firebase/MLNaturalLanguage Firebase/MLNLSmartAnswer |
GoogleMLKit/SmartReply |
แปล | Firebase/MLNaturalLanguage Firebase/MLNLTranslate |
GoogleMLKit/แปลภาษา |
อัปเดตชื่อของคลาส ค่าแจกแจง และประเภท
โดยทั่วไป คลาส , enum และ ประเภท จำเป็นต้องเปลี่ยนชื่อดังนี้:
- Swift: นำคำนำหน้า
Vision
ออกจากชื่อคลาสและ enum - Objective-C: แทนที่ทั้งชื่อคลาสและคํานําหน้า enum ของ
FIRVision
และFIR
โดยMLK
กฎทั่วไปนี้จะไม่ใช้กับชื่อคลาสและประเภทบางรายการ
Swift
ชั้นเรียนหรือประเภทเดิม | ชั้นเรียนหรือประเภทใหม่ |
---|---|
AutoMLLocalModel | LocalModel |
AutoMLRemoteModel | CustomRemoteModel |
VisionBarcodeDetectionCallback | BarcodeScanningCallback |
VisionBarcodeDetector | BarcodeScanner |
VisionBarcodeDetectorOptions | BarcodeScannerOptions |
VisionImage | VisionImage (ไม่มีการเปลี่ยนแปลง) |
VisionPoint | VisionPoint (ไม่มีการเปลี่ยนแปลง) |
VisionOnDeviceAutoMLImageLabelerOptions | CustomImageLabelerOptions |
VisionOnDeviceImageLabelerOptions | ImageLabelerOptions |
Objective-C
ชั้นเรียนหรือประเภทเดิม | ชั้นเรียนหรือประเภทใหม่ |
---|---|
FIRAutoMLLocalModel | MLKLocalModel |
FIRAutoMLRemoteModel | MLKCustomRemoteModel |
FIRVisionBarcodeDetectionCallback | MLKBarcodeScanningCallback |
FIRVisionBarcodeDetector | MLKBarcodeScanner |
FIRVisionBarcodeDetectorOptions | MLKBarcodeScannerOptions |
FIRVisionImage | MLKVisionImage |
FIRVisionOnDeviceAutoMLImageLabelerOptions | MLKCustomImageLabelerOptions |
FIRVisionOnDeviceImageLabelerOptions | MLKImageLabelerOptions |
FIRVisionPoint | MLKVisionPoint |
Objective-C
อัปเดตชื่อวิธีการ
อัปเดตชื่อวิธีการตามกฎเหล่านี้
ไม่มีคลาสจุดแรกเข้าของโดเมน (
Vision
,NaturalLanguage
) แล้ว โฆษณาเหล่านี้ ถูกแทนที่ด้วยชั้นเรียนเฉพาะงาน แทนที่การเรียกใช้วิธีการต่างๆ จากโรงงานเพื่อรับตัวตรวจจับด้วย โอนสายไปยังเมธอดจากโรงงานของตัวตรวจจับแต่ละรายการโดยตรงนำชั้นเรียน
VisionImageMetadata
ออกพร้อมกับ enumVisionDetectorImageOrientation
ใช้พร็อพเพอร์ตี้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 ออก (ไม่บังคับ)
ขั้นตอนนี้จะใช้เมื่อตรงกับเงื่อนไขเหล่านี้เท่านั้น
- Firebase ML Kit เป็นคอมโพเนนต์ Firebase เพียงอย่างเดียวที่คุณใช้
- คุณใช้ API ในอุปกรณ์เท่านั้น
- คุณไม่ได้ใช้การแสดงโมเดล
หากเป็นกรณีนี้ คุณสามารถนำทรัพยากร Dependency ของ Firebase ออกหลังการย้ายข้อมูลได้ โปรดทำตามขั้นตอนต่อไปนี้
- นำไฟล์การกำหนดค่า Firebase ออกโดยลบ GoogleService-Info.plist จากไดเรกทอรีของแอปและโปรเจ็กต์ Xcode ของคุณ
- นำ CocoaPod ของ Firebase เช่น
pod 'Firebase/Analytics'
ออกจาก Podfile - นำการเริ่มต้น FirebaseApp เช่น
FirebaseApp.configure()
ออกจากโค้ด - ลบแอป Firebase ในคอนโซล Firebase ที่สอดคล้องกับ วิธีการในเว็บไซต์การสนับสนุนของ Firebase
ขอความช่วยเหลือ
หากพบปัญหา โปรดไปที่หน้าชุมชนซึ่งเราสรุปไว้ ช่องทางที่พร้อมให้บริการสำหรับติดต่อเรา