注釈

こんにちは、SunFounder Raspberry Pi & Arduino & ESP32 Enthusiast Community on Facebookへようこそ！他の愛好家と一緒に、Raspberry Pi、Arduino、ESP32の世界により深く入り込みましょう。

参加する理由

専門家サポート: 購入後の問題や技術的な課題を、コミュニティと私たちのチームの助けを借りて解決します。
学習と共有: ヒントやチュートリアルを交換して、スキルを向上させましょう。
限定プレビュー: 新製品の発表や先行プレビューに早期アクセスできます。
特別割引: 最新製品を特別割引でお楽しみいただけます。
季節限定キャンペーンとプレゼント: プレゼント企画やホリデーキャンペーンに参加しましょう。

👉 一緒に発見し、創造する準備はできましたか？ [こちら] をクリックして、今すぐ参加しましょう！

注釈

プリインストールされた「Raspberry Pi OS mit AI Fusion Lab Kit」イメージを使用する場合は、このセクションをスキップできます。このイメージには、本章で説明するすべてのソフトウェアインストール、環境設定、およびサンプルコードのデプロイが既に含まれています。

0. MediaPipe のセットアップ

OS バージョンについて

警告

推奨 OS: Raspberry Pi OS Bookworm（Debian 12、64-bit）

Raspberry Pi OS Trixie（Debian 13）は次の理由により推奨されません：

MediaPipe はまだ Python 3.13 をサポートしていません。
Picamera2 はシステムの Python でのみ動作します。

Trixie がサポートされた際には、このチュートリアルを更新する予定です。

MediaPipe の Python 3.13 対応をリクエストしたい場合は、以下のページからフィードバックを送ることができます：

GitHub Issue: https://github.com/google-ai-edge/mediapipe/issues/5708
Support Page: https://ai.google.dev/edge/mediapipe/support

開始前の準備

重要

作業を始める前に、次の項目を確認してください：

パンチルト機構が組み立てられている
Raspberry Pi のデスクトップ環境にアクセスできる
コードパッケージがインストールされている
Fusion HAT+ がインストールおよび設定済みである
OpenCV がインストールされている

詳しい手順については 0. OpenCV のセットアップを参照してください。

これらの準備を行うことで、Raspberry Pi 上で MediaPipe をカメラおよびグラフィカル機能とともに正常に実行できます。

インストール手順

MediaPipe をインストールする

pip を使用して MediaPipe をインストールします。 Raspberry Pi OS Bookworm（Debian 12、64-bit）では、pip が適切な wheel パッケージを自動的にダウンロードします。
```
sudo pip install mediapipe --break-system-packages
```
インストールの確認

次のコマンドを実行して、MediaPipe が正しくインストールされていることを確認します。
```
python3 - <<EOF
import mediapipe as mp
print("MediaPipe version:", mp.__version__)
EOF
```
期待される出力：
```
MediaPipe version: 0.10.18
```

よくある問題と解決方法

MediaPipe のインストールに失敗する

これは通常、サポートされていない OS バージョンを使用している場合に発生します。

解決方法：
- MediaPipe は現在、Raspberry Pi OS Bookworm（Debian 12、64-bit）のみで動作します。
- Raspberry Pi OS Trixie（Debian 13、Python 3.13）はサポートされていません。
MediaPipe または OpenCV でカメラが開けない

これは Raspberry Pi のカメラインターフェースが有効になっていない場合に発生することが多いです。

解決方法：
- raspi-config でカメラを有効にします： Interface Options → Camera → Enable
OpenCV の import エラー

pip でインストールした OpenCV の一部のバージョンは、Raspberry Pi OS のライブラリと互換性がない場合があります。

解決方法：
```
sudo apt install python3-opencv
```
インストール後に MediaPipe を import できない

pip、setuptools、または wheel が古い場合に発生することがあります。

解決方法：
```
sudo pip install --upgrade pip setuptools wheel
```

これで MediaPipe の準備は完了です。次のセクションでは、Raspberry Pi カメラを使用したリアルタイムの顔検出を実行します。