sker65/wyoming-satellite

wyoming-satellite Docker镜像

概述

该镜像用于运行wyoming-satellite，这是一个远程语音设备，旨在与Home Assistant的语音代理（如"alexa"）交互，实现Home Assistant Assist的远程语音控制功能。

核心功能与特性

• 远程语音交互：作为Home Assistant的远程语音接口，支持语音输入与输出
• 语音活动检测（VAD）：可配置语音活动检测，仅在检测到语音时流式传输音频
• 自定义音频设备：支持指定麦克风和扬声器设备，适配不同硬件环境

使用场景

适用于需要通过语音远程控制Home Assistant的场景，例如智能家居语音交互、语音命令执行、远程语音助手等。

使用方法

基本运行命令

sh
docker run --rm -it --device /dev/snd --group-add audio \
  -p 10700:10700 sker65/wyoming-satellite --name my-satellite \
  --vad --vad-trigger-level 1 --vad-threshold 0.6 --debug \
  --uri 'tcp://0.0.0.0:10700' \
  --mic-command 'arecord -D default:CARD=USB -r 16000 -c 1 -f S16_LE -t raw' \
  --snd-command 'aplay -D default:CARD=USB -r 22050 -c 1 -f S16_LE -t raw'

参数说明

• --device /dev/snd：挂载音频设备
• --group-add audio：添加音频组权限
• -p 10700:10700：映射容器端口到主机
• --name：指定卫星名称
• --vad：启用语音活动检测
• --vad-trigger-level：语音触发级别（示例中为1）
• --vad-threshold：语音检测阈值（示例中为0.6）
• --debug：启用调试模式
• --uri：服务监听地址（示例中为tcp://0.0.0.0:10700）
• --mic-command：麦克风录制命令（指定设备和参数）
• --snd-command：扬声器播放命令（指定设备和参数）

使用默认音频设备

若无需指定特定音频设备，可简化麦克风和扬声器命令，移除-D <device>选项：

sh
--mic-command 'arecord -r *** -c 1 -f S16_LE -t raw' \
--snd-command 'aplay -r 22050 -c 1 -f S16_LE -t raw'