スマートリテール音声AI

Seeedのスマートリテール音声AIソリューションを活用して、店舗内の顧客会話を捕捉・分析します。当社のエッジAI技術により、デバイス上での音声テキスト変換処理が可能になり、クラウドサービスに依存することなく音声データを実用的な洞察に変換します。小売環境に特化したオフラインAI搭載音声分析により、顧客体験を向上させ、店舗運営を最適化し、貴重なフィードバックを獲得できます。

スマートリテール音声AI
ソリューションバンドル 🖱️

スマートリテール音声AI

エッジデバイスとSenseCraft Voiceを使用して店舗内音声分析パイプラインを構築し、現場で会話を捕捉し、デバイス上で音声テキスト変換を実行し、顧客の声を構造化データに変換します。

• エッジでのデバイス上音声テキスト変換

  SenseCraft Voiceは店舗内のエッジデバイス上で直接動作し、音声活動検出と音声認識をローカルで処理します。すべての音声はエッジで処理されるため、リアルタイム転写生成におけるクラウド接続への依存を大幅に削減します。

• 遠距離、小売対応音声捕捉

  このソリューションは、騒音の多い小売環境での遠距離音声捕捉用に設計されています。マイクアレイ、ビームフォーミング、ノイズ抑制をサポートし、背景音楽や周囲の雑談があっても実際の顧客とスタッフの会話に焦点を当てます。

• プライバシー優先のエッジアーキテクチャ

  音声はエッジデバイス上でローカルに転写され、テキストとメタデータのみが上流に送信されるため、小売業者はプライバシーとコンプライアンスリスクをより適切に制御でき、クラウドコストとネットワーク要件を低く抑えることができます。

• 会話からデータ駆動型意思決定へ

  SenseCraft Voiceによって生成された転写は、構造化された分析可能なデータになります。小売業者はサービス品質を測定し、よくある質問や問題点を特定し、スクリプト、ポリシー、全体的な店舗体験を継続的に改善できます。

入門ガイド

このセクションでは、SeeedのreRouterとreSpeaker XVF3800マイクアレイを使用してスマートリテール音声AIソリューションをセットアップする手順をご案内します。

1. ハードウェア要件

このガイドでは、SeeedのreRouterとreSpeaker XVF3800マイクアレイを使用して、スマートリテール音声AIソリューションの構築方法を実演します。

reRouter（エッジコンピュート）	reSpeaker XVF3800（音声捕捉）
役割： 処理ユニット 技術仕様： CPU： クアッドコアプロセッサ RAM： 4GB（最小要件） ストレージ： 32GB eMMC OS： OpenWrt 24.10.3（ビルド r28872） *注：これらの仕様を下回る性能は検証されていません。	役割： 音声捕捉 技術仕様： モデル： XVF3800 4マイクアレイ ファームウェア： v2.0.5 構成： 1チャンネル（処理済み音声） 機能： ノイズ抑制、AEC、ビームフォーミング

ハードウェアセットアップ

---

1.1 reRouterファームウェアの取得

reRouter用のOpenWrtファームウェアには2つのバージョンがあります：
グローバルユーザー向けと、中国本土のユーザー向けに最適化されたものです。

現在のファームウェアは**OpenWrt 24.10.3（ビルド r28872）**をベースにしています。

グローバル

ファームウェアを取得🖱️

中国本土

中国本土🖱️

デバイスをフラッシュモードにするためにジャンパーキャップが必要な場合があります。

詳細な手順については、reRouterフラッシュガイドを参照してください。

1.2. ハードウェア接続

reRouterを以下のように接続してください：

• インターネットアクセス： ルーター/モデムからWANポートにイーサネットケーブルを接続します。
• ホスト接続： OpenWrt-XXXXという名前のWi-Fiホットスポットにワイヤレスで接続するか、イーサネット経由でコンピューターをLANポートに接続します。

• WANポート：インターネットに接続します。
• LANポート：設定用にホストコンピューターに接続します。

1.3. reSpeaker XVF3800セットアップ

reSpeaker XVF3800マイクアレイをUSB経由でホストデバイスに接続して設定します。

Linux/MacOS

1. リポジトリをクローンしてコントロールフォルダに移動：

デバイスに応じて、<YOUR_HOST_DIR>をシステムに対応するフォルダ（例：linux_x86_64、rpi_64bit、mac_arm64、またはjetson）に置き換えてください。

git clone https://github.com/respeaker/reSpeaker_XVF3800_USB_4MIC_ARRAY.git
cd reSpeaker_XVF3800_USB_4MIC_ARRAY/host_control/<YOUR_HOST_DIR>

2. 設定シーケンスを実行：

実行権限を付与し、以下の3つのコマンドを実行してデバイスを初期化します（Linuxでは必要に応じてsudoを使用）：

chmod +x ./xvf_host

# 1. Clear existing configuration
sudo ./xvf_host clear_configuration 1

# 2. Enable specific audio manager setting
sudo ./xvf_host audio_mgr_op_r 8 0

# 3. Save configuration
sudo ./xvf_host save_configuration 1

Windows

1. リポジトリをクローンしてコントロールフォルダに移動：

コマンドプロンプト（cmd）またはPowerShellを開いて実行：

git clone https://github.com/respeaker/reSpeaker_XVF3800_USB_4MIC_ARRAY.git
cd reSpeaker_XVF3800_USB_4MIC_ARRAY\host_control\win32

2. 設定シーケンスを実行：

以下の3つのコマンドを実行してデバイスを初期化します：

# 1. Clear existing configuration
.\xvf_host.exe clear_configuration 1

# 2. Enable specific audio manager setting
.\xvf_host.exe audio_mgr_op_r 8 0

# 3. Save configuration
.\xvf_host.exe save_configuration 1

2. ソフトウェアインストール

2.1. 前提条件

開始前に、以下の条件が満たされていることを確認してください：

• アクセス： SSH経由でOpenWrtデバイスへのルートアクセス（例：ssh [email protected]）。
• ネットワーク： OpenWrtデバイスが安定したインターネット接続を持っている。
• オーディオ： reSpeaker XVF3800がreRouterに接続されている。

2.2 デバイスへのアクセス

コンピュータがreRouter（LANまたはWi-Fi経由）に接続されると、以下のデフォルト設定を使用してシステムにアクセスできます：

• SSHアクセス：

ssh [email protected]

デフォルトでは、rootユーザーにパスワードは設定されていません。

注意

OpenWrtのWebインターフェースを使用して、reRouterをWi-FiやEthernetネットワークに接続してインターネットアクセスを含むネットワーク設定を構成することもできます。

• ブラウザを開いて次のURLにアクセス：http://192.168.49.1
• ユーザー名：root
• パスワード：（なし/デフォルトで空）

重要

以下のインストール手順に進む前に、reRouterがインターネットにアクセスできることを確認してください （例：SSHターミナルでping google.comまたはping openwrt.orgを実行）。

2.3 ステップバイステップインストール

OpenWrtデバイスへのSSH接続を確立した後、以下のコマンドを順次実行してください。

ステップ1：DockerとDependenciesのインストール

このステップでは、コンテナランタイム環境と必要なツール（ファイル検証用のSHA-256チェックサムユーティリティを含む）をインストールします。

# 1. Update the local package list
opkg update

# 2. Install Docker core components
# Note: On some systems, you might need to install these separately: dockerd, docker, containerd, runc
opkg install dockerd docker containerd runc

# 3. Install utility packages
opkg install wget-ssl unzip ca-certificates

# 4. Enable and start the Docker daemon service
/etc/init.d/dockerd enable
/etc/init.d/dockerd start

# 5. Wait for Docker to initialize (approx. 15-30 seconds)
echo "Waiting for Docker service to start..."
sleep 15 
docker ps # Verify the service is running

ステップ2.2：データディレクトリと設定の準備

SenseCraftコンテナに必要な永続ストレージディレクトリを作成し、デフォルト設定ファイルをダウンロードします。

# 1. Create required application data directories
mkdir -p /data-iot/respeaker/recordings \
         /data-iot/respeaker/models \
         /data-iot/respeaker/voiceprints \
         /data-iot/respeaker/logs

# 2. Navigate to the base directory
cd /data-iot/respeaker

# 3. Download the configuration file
wget -q -O config.yaml 'https://appstore.seeed-fleet.com/config.yaml'

ステップ2.3：モデルのダウンロードと展開

Seeed Studioサーバーから事前訓練されたASRモデルパッケージ（約480MB）を直接ダウンロードし、SHA-256を使用してその整合性を検証し、展開します。

ファイル	URL
models.zip	https://files.seeedstudio.com/wiki/solution/ai-sound/reRouter-firmware-backup/models.zip
期待されるSHA-256ハッシュ	7b9e7606a2ddcad56f3f72a77b16eb2c60437ae4bfc3f1423bd33db177385c9d

SSH経由でOpenWrtホストで以下のコマンドを実行してください：

# 1. Navigate to the base directory
cd /data-iot/respeaker

# 2. Define the Model URL
MODEL_URL="https://files.seeedstudio.com/wiki/solution/ai-sound/reRouter-firmware-backup/models.zip"

# 3. Download the large model package. 
# -c allows the download to resume if interrupted.
wget -O models.zip -c "$MODEL_URL"
echo "Model package download completed. Check file size is approximately 500MB."

# 4. Verify the file integrity using SHA-256 Checksum
# The result MUST match the expected hash above.
echo "Verifying file checksum..."
shasum -a 256 models.zip

# 5. Extract the model package into the 'models' directory
unzip -o models.zip

# 6. Clean up the temporary ZIP file
rm -f models.zip

# 7. Verify the model files are present
ls -l /data-iot/respeaker/models/

ステップ2.4：オーディオデバイス権限の設定

Voice Clientコンテナはオーディオデバイスへの特権アクセスが必要です。デバイスファイルに適切な権限があることを確認してください。

# 1. Check for audio devices
ls -l /dev/snd/

# 2. Set read/write permissions for all users on audio device nodes
chmod -R 666 /dev/snd/*

ステップ2.5：Dockerコンテナのデプロイ

イメージ変数を定義し、3つの必要なサービス（sensecraft-voice-client、sensecraft-asr-server、watchtower）を起動します。

# Define Image Variables
VOICE_CLIENT_IMAGE="sensecraft-missionpack.seeed.cn/respeaker/sensecraft-voice-client:v0.0.2"
ASR_SERVER_IMAGE="sensecraft-missionpack.seeed.cn/respeaker/sensecraft-asr-server:latest"
WATCHTOWER_IMAGE="sensecraft-missionpack.seeed.cn/respeaker/containrrr/watchtower:latest"

# 1. Pull Images
docker pull $VOICE_CLIENT_IMAGE
docker pull $ASR_SERVER_IMAGE
docker pull $WATCHTOWER_IMAGE

# 2. Stop and remove any containers with the same names
docker rm -f sensecraft-voice-client sensecraft-asr-server watchtower

# 3. Launch sensecraft-voice-client 
docker run -d --name sensecraft-voice-client \
    --restart=unless-stopped \
    --privileged \
    --device /dev/snd \
    --network host \
    --group-add audio \
    --group-add video \
    --cap-add SYS_ADMIN \
    --cap-add SYS_RAWIO \
    -e TZ=Asia/Shanghai \
    -e AUDIO_CARD_ID=1 \
    -e AUDIO_DEVICE_ID=0 \
    -v /etc/wpa_supplicant:/etc/wpa_supplicant \
    -v /etc/network:/etc/network \
    -v /var/run/dbus:/var/run/dbus \
    -v /dev:/dev \
    -v /run/udev:/run/udev:ro \
    -v /proc:/proc:ro \
    -v /sys:/sys:ro \
    -v /data-iot/respeaker/recordings:/app/recordings \
    -v /data-iot/respeaker/voiceprints:/app/voiceprints \
    -v /data-iot/respeaker/logs:/app/logs \
    -e WIFI_INTERFACE=wlan0 \
    -e WIFI_CONFIG_PATH=/etc/wpa_supplicant \
    $VOICE_CLIENT_IMAGE

# 4. Launch sensecraft-asr-server (model server)
docker run -d --network host \
    -v /data-iot/respeaker/models:/app/models \
    -v /data-iot/respeaker/voiceprints:/app/data \
    --restart=always \
    --name=sensecraft-asr-server \
    $ASR_SERVER_IMAGE

# 5. Launch watchtower (for continuous container monitoring and update)
docker run -d --name watchtower \
    --restart always \
    -v /var/run/docker.sock:/var/run/docker.sock \
    $WATCHTOWER_IMAGE \
    --cleanup -i 60 sensecraft-asr-server sensecraft-voice-client

✅ 3. 検証

デプロイメントの最終状態を確認します。

# Check container status (All three should show Status: Up)
docker ps

# Check the voice client logs for successful initialization and audio device detection
docker logs sensecraft-voice-client

ログが重大なエラーなしに正常な開始を示している場合、SenseCraftサービスは正常にデプロイされています。

SenseCraft音声サービスへのアクセス

SenseCraft Voice ClientはreRouterのIPアドレスのポート8090でWebインターフェースを公開します。 以下のURLでWebブラウザからアクセスできます：

http://<reRouter_IP_Address>:8090