HomeAssistant 阿里云通义千问 STT 语音识别插件
本插件集成了阿里云通义千问 (Qwen) 实时语音识别服务，为 Home Assistant 提供高精度的语音转文字功能。
功能特性
- 模型支持：支持
qwen3-asr-flash-realtime（通义千问实时识别）。
- 图形化配置：支持通过 Home Assistant 前端界面直接添加集成。
- 多语言支持：支持中文、英文、粤语等多种语言识别。
- 实时识别：基于 WebSocket 协议，低延迟实时转写。
- 多区域支持：支持北京（国内）和新加坡（国际）节点。
- 音频格式：WAV（PCM 16-bit / 16kHz / 单声道）。
安装说明
方法一：手动安装
- 下载本项目代码。
- 将
/custom_components/下的hass_stt_qwen 文件夹复制到您的 Home Assistant 配置目录下的 custom_components 文件夹中。
- 最终路径应为：
/config/custom_components/hass_stt_qwen/
- 重启 Home Assistant。
方法二：HACS 安装（推荐）
- 确保你已经在 Home Assistant 中安装并配置了 HACS（Home Assistant Community Store）。
- 点击 HACS 界面左上角的菜单，选择
自定义仓库（Custom repositories），在弹出的窗口中输入仓库地址 You need to
登录 to view this content. (Refresh after logging in.)
集成，然后点击 添加。之后再搜索 阿里通义千问语音识别 即可找到。
- 选择
阿里通义千问语音识别 集成，点击 下载此存储库。
- 下载完成后，重启 Home Assistant。
配置指南
- 登录 Home Assistant。
- 点击左侧菜单的 配置 -> 设备与服务。
- 点击右下角的 添加集成 按钮。
- 搜索 阿里通义千问语音识别 并点击。
- 在弹出的配置窗口中输入以下信息：
- API 密钥: 您的阿里云 DashScope API 密钥。
- 模型: 选择您需要使用的模型（推荐
qwen3-asr-flash-realtime）。
- 区域: 根据您的 API Key 所在区域选择（北京或新加坡）。
- 点击 提交 完成配置。
使用方法
配置完成后，您可以在 Home Assistant 的语音助手设置中选择 阿里通义千问语音识别 作为语音转文字 (STT) 引擎。
- 进入 配置 -> 语音助手。
- 选择或创建一个语音助手。
- 在 语音转文字 选项中选择 阿里通义千问语音识别。
常见问题
Q: 如何获取 API Key？
A: 请访问 阿里云百炼控制台，开通服务并创建 API Key。
Q: 插件支持哪些 Home Assistant 版本？
A: 需要 Home Assistant 支持 SpeechToTextEntity（STT 实体）的版本。
Q: 支持哪些语言？
A: 通义千问 Qwen ASR 支持中文、英文、粤语、日语等多种语言。
Q: 遇到连接失败怎么办？
A: 请检查 API Key 是否正确，以及网络连接是否正常。如果您在海外，请尝试切换到新加坡区域。
