คู่มือการตั้งค่าสําหรับ iOS

หน้านี้แสดงวิธีตั้งค่าสภาพแวดล้อมการพัฒนาเพื่อใช้ MediaPipe Tasks ในแอปพลิเคชัน iOS

อุปกรณ์และแพลตฟอร์มที่รองรับ

ในการสร้างแอปพลิเคชัน iOS ด้วย MediaPipe Tasks สภาพแวดล้อมในการพัฒนาซอฟต์แวร์ของคุณ ต้องการสิ่งต่อไปนี้

  • macOS Mojave 10.14.3 หรือใหม่กว่า

  • Xcode 10.3 ขึ้นไป

  • อุปกรณ์ iOS ที่ใช้ iOS 12.0 ขึ้นไป อีกวิธีหนึ่งคือ เครื่องมือจำลอง iOS สามารถ จัดการแอปพลิเคชันที่ไม่ต้องใช้กล้องของอุปกรณ์

การตั้งค่าสภาพแวดล้อมสำหรับนักพัฒนาแอป

ก่อนที่จะเรียกใช้งาน MediaPipe ในแอปพลิเคชัน iOS คุณต้องมี โปรเจ็กต์ Xcode ที่มีอยู่หรือสร้างโปรเจ็กต์ใหม่ในเครื่องของคุณ

MediaPipe Tasks จะติดตั้งได้โดยใช้ CocoaPods เท่านั้น คุณต้องติดตั้ง CocoaPods 1.12.1 ขึ้นไปก่อนเริ่มต้นใช้งาน สำหรับ วิธีการติดตั้ง CocoaPods ใน macOS โปรดดูที่การติดตั้ง CocoaPods

ตัวอย่างการตั้งค่าโค้ด

MediaPipe ตัวอย่าง ที่เก็บมีตัวอย่างแอปพลิเคชัน iOS สำหรับงาน MediaPipe

คุณสามารถสร้างโปรเจ็กต์จากโค้ดตัวอย่าง สร้างโปรเจ็กต์ และเรียกใช้ งาน ขั้นตอนต่อไปนี้จะสร้างฟังก์ชัน Text ตัวแยกประเภท งาน

วิธีนำเข้าและสร้างโปรเจ็กต์โค้ดตัวอย่าง

  1. เปิดเทอร์มินัล โคลนที่เก็บ MediaPipe Example และไปยัง ไดเรกทอรีที่มี TextClassifier.xcodeproj และ Podfile

    git clone https://github.com/google-ai-edge/mediapipe-samples
cd mediapipe/examples/text_classification/ios

  2. ติดตั้ง MediaPipe Tasks โดยใช้ CocoaPods:

    pod install

    คำสั่งนี้จะสร้างไฟล์ TextClassifier.xcworkspace ในตัวอย่าง ไดเรกทอรีโปรเจ็กต์

  3. ดับเบิลคลิกไฟล์ TextClassifier.xcworkspace เพื่อเปิดโปรเจ็กต์ใน Xcode ปิดไฟล์ TextClassifier.xcodeproj ที่เปิดอยู่แล้ว ก่อนเปิดไฟล์ TextClassifier.xcworkspace

  4. เลือกชุดรูปแบบ TextClassifier แล้วเลือกอุปกรณ์ iOS ที่จับต้องได้หรือ เครื่องจำลองจากแถบเครื่องมือของหน้าต่างโปรเจ็กต์ เมื่อใช้อุปกรณ์ iOS จริง ตรวจสอบให้แน่ใจว่าเชื่อมต่อกับเครื่อง Mac แล้ว

  5. คลิกปุ่ม Run ในแถบเครื่องมือของโปรเจ็กต์

สำหรับคำแนะนำเพิ่มเติมเกี่ยวกับการเรียกใช้แอปใน Xcode โปรดดูการสร้างและการเรียกใช้ CANNOT TRANSLATE แอป

ทรัพยากร Dependency ของ MediaPipe Tasks

MediaPipe Tasks มีไลบรารีที่สร้างไว้ล่วงหน้า 2 รายการสำหรับการมองเห็นและข้อความ ไฟล์โมเดล .tflite ต้องอยู่ในแพ็กเกจของแอปพลิเคชัน iOS ที่ ใช้โมเดล ให้เพิ่มวิสัยทัศน์หรือข้อความโดยขึ้นอยู่กับ MediaPipe Tas คลังรายการพ็อดภายใน CocoaPods Podfile สำหรับคำแนะนำใน สร้าง Podfile ด้วยพ็อดที่จำเป็นสำหรับแอปของคุณ โปรดดูการใช้ CocoaPods

งานของ Generative AI

ไลบรารี MediaPipe Tasks Generative AI มีงานที่จัดการรูปภาพหรือ การสร้างข้อความ หากต้องการติดตั้งไลบรารี MediaPipe Tasks Generative AI ให้เพิ่มลิงก์ MediaPipeTasksGenAI และพ็อด MediaPipeTasksGenAIC ไปยังเป้าหมายของแอปใน Podfile

API การอนุมานของ LLM

งาน MediaPipe LLM Inference อยู่ใน MediaPipeTasksGenAI และ MediaPipeTasksGenAIC พ็อด

target 'MyLlmInferenceApp' do
  use_frameworks!
  pod 'MediaPipeTasksGenAI'
  pod 'MediaPipeTasksGenAIC'
end

งานด้านการมองเห็น

ไลบรารีวิสัยทัศน์ของ MediaPipe Tasks มีงานที่จัดการรูปภาพหรือวิดีโอ อินพุต หากต้องการติดตั้งไลบรารีวิสัยทัศน์ของ MediaPipe Tasks ให้เพิ่มเมธอด MediaPipeTasksVision ไปยังเป้าหมายของแอปใน Podfile

target 'MyAppWithMediaPipeTasksVision' do
  use_frameworks!
  pod 'MediaPipeTasksVision'
end

งานด้านข้อความ

ไลบรารีข้อความ MediaPipe Tasks มีงานที่จัดการข้อมูลภาษาใน รูปแบบข้อความ หากต้องการติดตั้งไลบรารีข้อความ MediaPipe Tasks ให้เพิ่มเมธอด MediaPipeTasksText พ็อดไปยังเป้าหมายของแอปใน Podfile

target 'MyAppWithMediaPipeTasksText' do
  use_frameworks!
  pod 'MediaPipeTasksText'
end

กำหนดค่าเป้าหมายทดสอบ

หากแอปมีเป้าหมายทดสอบ ให้ตรวจสอบว่า Podfile เป็นไปตาม ดังต่อไปนี้เพื่อหลีกเลี่ยงพฤติกรรมที่ไม่พึงประสงค์เมื่อใช้ ไลบรารีงาน MediaPipe

วิธีการติดตั้งใช้งานที่ง่ายที่สุดคือการตรวจสอบเป้าหมายทดสอบไม่ได้ซ้อนกันอยู่ ภายในเป้าหมายแอปหลักที่เพิ่มพ็อดงาน MediaPipe

target 'MyAppWithMediaPipeTasks' do
  pod 'MediaPipeTasksVision'
end

target 'MyAppWithMediaPipeTasksTests' do

end

หากเป้าหมายทดสอบต้องฝังอยู่ภายในเป้าหมายแอปหลัก Podfile จะต้อง ให้สอดคล้องกับการติดตั้งใช้งานดังต่อไปนี้

target 'MyAppWithMediaPipeTasks' do
  pod 'MediaPipeTasksVision'

    target 'MyAppWithMediaPipeTasksTests' do
      inherit! :none

    end
end

การกำหนดค่า BaseOptions

BaseOptions ช่วยให้กำหนดค่าทั่วไปของ MediaPipe Task API ได้

ชื่อตัวเลือก คำอธิบาย ค่าที่ยอมรับ
modelAssetPath เส้นทางโมเดลไปยังไฟล์โมเดลใน Bundle แอปพลิเคชัน iOS เส้นทางเป็นสตริง

การเร่งฮาร์ดแวร์

MediaPipe Tasks ใน iOS รองรับเฉพาะโมเดลที่ใช้งานอยู่บนตัวประมวลผล CPU มาตรฐานเท่านั้น

การแก้ปัญหา

สำหรับความช่วยเหลือสำหรับคำถามด้านเทคนิคที่เกี่ยวข้องกับ MediaPipe โปรดไปที่การอภิปราย group หรือ Stack รายการเพิ่มเติมสำหรับการสนับสนุนจาก กับชุมชน หากต้องการรายงานข้อบกพร่องหรือส่งคำขอฟีเจอร์ ให้แจ้งปัญหาใน GitHub

หากต้องการความช่วยเหลือในการตั้งค่าสภาพแวดล้อมในการพัฒนาซอฟต์แวร์ iOS โปรดไปที่นักพัฒนาซอฟต์แวร์ของ Apple เอกสารประกอบ