Google AI Edge Portal のご紹介: エッジ AI を大規模にベンチマークします。限定公開プレビュー中にアクセスをリクエストするには、登録してください。

このページは Cloud Translation API によって翻訳されました。

iOS の設定ガイド

このページでは、MediaPipe を使用する開発環境の設定方法について説明します。 iOS アプリの ToDo リスト。

サポートされているデバイスとプラットフォーム

MediaPipe Tasks で iOS アプリを作成するには、開発環境で次のものが必要です。

macOS Mojave 10.14.3 以降。
Xcode 10.3 以降。
iOS 12.0 以降を搭載したデバイス別の方法として、iOS シミュレータによってデバイスのカメラを必要としないアプリを処理します。

で確認できます。

開発環境のセットアップ

iOS アプリで MediaPipe タスクを実行する前に、プロジェクトを作成するか、ローカルマシンで新しいプロジェクトを作成します。

MediaPipe Tasks は CocoaPods を使用してのみインストールできます。始める前に、CocoaPods 1.12.1 以降をインストールする必要があります。対象 macOS に CocoaPods をインストールする手順については、CocoaPods のインストールページをご覧ください。ガイドをご覧ください。

コードの設定例

MediaPipe 例リポジトリには、MediaPipe タスク用の iOS アプリケーションのサンプルが含まれています。

サンプルコードからプロジェクトを作成し、プロジェクトをビルドしてタスクを実行します。次の手順では、Text-to-Text API を使用して分類器タスクを実行します。

サンプルコードプロジェクトをインポートしてビルドするには:

ターミナルを開き、MediaPipe Examples リポジトリのクローンを作成して TextClassifier.xcodeproj と Podfile を含むディレクトリ。
```
git clone https://github.com/google-ai-edge/mediapipe-samples
cd mediapipe-samples/examples/text_classification/ios
```
CocoaPods を使用して MediaPipe Tasks をインストールします。
```
pod install
```
このコマンドにより、この例では TextClassifier.xcworkspace ファイルが作成されます。ディレクトリにあります。
TextClassifier.xcworkspace ファイルをダブルクリックして、プロジェクトを開きます。 Xcode。TextClassifier.xcodeproj ファイルがすでに開いている場合は閉じます。この TextClassifier.xcworkspace ファイルを開く必要があります。
TextClassifier スキームを選択し、実機の iOS デバイスまたはシミュレーターを選択します。物理的な iOS デバイスを使用している場合 Mac に接続されていることを確認します。
プロジェクトのツールバーにある Run ボタンをクリックします。

Xcode でアプリを実行する手順について詳しくは、ビルドと実行アプリ。

MediaPipe Tasks の依存関係

MediaPipe Tasks には、ビジョンとテキスト用の 2 つのビルド済みライブラリが用意されています。「 .tflite モデルファイルは、次の iOS アプリケーションのバンドルに配置する必要があります。モデルを使用します。MediaPipe の Tas に応じて、Vision または Text を CocoaPods Podfile 内の Pod のリストに追加します。手順については、アプリに必要な Pod を含む Podfile を作成する方法については、 CocoaPods。

生成 AI のタスク

MediaPipe Tasks の生成 AI ライブラリには、画像やテキストを処理するタスクが説明します。MediaPipe Tasks の生成 AI ライブラリをインストールするには、 MediaPipeTasksGenAI Pod と MediaPipeTasksGenAIC Pod をアプリのターゲットに Podfile。

LLM 推論 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 を追加する main app ターゲット内に作成します。

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 に関連する技術的な質問については、こちらのディスカッション group または Stack オーバーフロー: できます。バグの報告や機能リクエストを行うには、 GitHub

iOS 開発環境の設定については、Apple Developer サイトドキュメントをご覧ください。