iOS 設定指南

本頁面說明如何設定使用 MediaPipe 的開發環境 iOS 應用程式中的工作。

支援的裝置和平台

如要使用 MediaPipe Tasks 建立 iOS 應用程式，您的開發環境要求下列項目：

macOS Mojave 10.14.3 以上版本。
Xcode 10.3 以上版本。
搭載 iOS 12.0 以上版本的裝置。iOS 模擬器也可以處理不需裝置相機的應用程式。

，瞭解如何調查及移除這項存取權。

開發人員環境設定

在 iOS 應用程式上執行 MediaPipe 工作之前，必須或在本機電腦上建立新的 Xcode 專案。

MediaPipe 工作只能使用 CocoaPods 安裝。你必須先安裝 CocoaPods 1.12.1 以上版本，才能開始使用。適用對象如要在 macOS 上安裝 CocoaPods，請參閱 CocoaPods 安裝說明指南。

程式碼範例設定

MediaPipe 示例存放區包含適用於 MediaPipe 工作的 iOS 應用程式範例。

您可以利用程式碼範例建立專案、建構專案，以及執行工作。下列步驟會建立文字分類器工作。

如要匯入及建構程式碼範例專案：

開啟終端機，複製 MediaPipe Example 存放區，然後前往包含 TextClassifier.xcodeproj 和 Podfile 的目錄。
```
git clone https://github.com/google-ai-edge/mediapipe-samples
cd mediapipe/examples/text_classification/ios
```
使用 CocoaPods 安裝 MediaPipe 工作：
```
pod install
```
這個指令會在範例中建立 TextClassifier.xcworkspace 檔案專案目錄
按兩下 TextClassifier.xcworkspace 檔案，即可開啟專案 Xcode如果 TextClassifier.xcodeproj 檔案已開啟，請將其關閉再開啟 TextClassifier.xcworkspace 檔案。
選取 TextClassifier 配置，並選擇實體 iOS 裝置或。使用實體 iOS 時並確認該裝置已連接到 Mac。
按一下專案工具列中的 Run 按鈕。

如要進一步瞭解如何在 Xcode 上執行應用程式，請參閱建構及執行應用程式換 app。

MediaPipe 工作依附元件

MediaPipe Tasks 提供兩個預建程式庫，適用於視覺和文字。「.tflite」模型檔案必須位於以下 iOS 應用程式的套件中：模型根據 MediaPipe Tas 的內容，程式庫更新為 CocoaPods Podfile 中的 Pod 清單。如需使用應用程式所需的 Pod 建立 Podfile，請參閱使用 CocoaPods

生成式 AI 工作

MediaPipe Tasks 生成式 AI 程式庫包含處理圖片像是生成文字、圖片、文字如要安裝 MediaPipe Tasks 生成式 AI 程式庫，請新增將 MediaPipeTasksGenAI 和 MediaPipeTasksGenAIC 個 Pod 指派給您的應用程式目標： Podfile。

大型語言模型推論 API

MediaPipe LLM 推論工作位於 MediaPipeTasksGenAI 和 MediaPipeTasksGenAIC 個 Pod

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

視覺任務

MediaPipe Tasks 視覺程式庫包含處理圖片或影片的工作輸入內容如要安裝 MediaPipe Tasks 視覺程式庫，請將 MediaPipeTasksVision 個 Pod 對應到 Podfile 中應用程式的目標。

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

文字工作

MediaPipe Tasks 文字庫包含處理中語言資料的工作文字格式。如要安裝 MediaPipe Tasks 文字庫，請將 MediaPipeTasksText 個 Pod 對應到 Podfile 中應用程式的目標

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

設定測試目標

如果您的應用程式含有測試目標，請確保 Podfile 遵循以下的實作方式，避免在使用 MediaPipe 工作程式庫。

最簡單的導入方式，就是確保測試目標非巢狀加入 MediaPipe 工作 Pod 的主要應用程式目標中。

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`	iOS 應用程式套件中的模型檔案路徑。	字串形式的路徑。

硬體加速

在 iOS 上，MediaPipe Tasks 僅支援標準 CPU 處理器執行模型。

疑難排解

如需 MediaPipe 相關技術問題的說明，請前往討論區群組或 Stack 向支援團隊尋求協助社群如要回報錯誤或提出功能要求，請在 GitHub。

如需設定 iOS 開發環境的相關說明，請造訪 Apple Developer 說明文件。