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 を使用して 分類器 タスクを実行します。

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

  1. ターミナルを開き、MediaPipe Examples リポジトリのクローンを作成して TextClassifier.xcodeproj と Podfile を含むディレクトリ。

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

  2. CocoaPods を使用して MediaPipe Tasks をインストールします。

    pod install

    このコマンドにより、この例では TextClassifier.xcworkspace ファイルが作成されます。 ディレクトリにあります。

  3. TextClassifier.xcworkspace ファイルをダブルクリックして、プロジェクトを開きます。 Xcode。TextClassifier.xcodeproj ファイルがすでに開いている場合は閉じます。 この TextClassifier.xcworkspace ファイルを開く必要があります。

  4. TextClassifier スキームを選択し、実機の iOS デバイスまたは シミュレーターを選択します。物理的な iOS デバイスを使用している場合 Mac に接続されていることを確認します。

  5. プロジェクトのツールバーにある Run ボタンをクリックします。

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

MediaPipe Tasks の依存関係

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

<ph type="x-smartling-placeholder">

生成 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 サイト ドキュメントをご覧ください。