Alexa 设备

Expert icon Experimental icon

Music Assistant 支持 Alexa 设备。此组件由 Sameer Alam 贡献和维护。

功能

除了单个播放器设置外，Alexa 提供商在高级部分还有一个独特设置和一个独特的预设部分

使用 Docker Compose 运行（推荐）：

从原型仓库（https://github.com/alams154/music-assistant-alexa-skill-prototype）复制 docker-compose.yml，确保已安装 Docker 和 Docker Compose。
在 docker-compose.yml 旁边创建 secrets/ 目录，并添加以下文件（相对于 compose 文件）：
- ./secrets/api_username.txt — 包含您的 API 用户名
- ./secrets/api_password.txt — 包含您的 API 密码
根据需要编辑 docker-compose.yml 中的环境变量（例如：MA_HOSTNAME、PORT）。
启动服务：
```
docker compose up -d
```
默认情况下，服务将在 http://localhost:5000（或您配置的 IP/端口）上可用。
在浏览器中，打开 http://localhost:5000/setup 的设置 UI。设置页面将：
- 检测现有的持久 ASK 凭据（如果存在）并跳过基于浏览器的认证流程
- 如果凭据不存在，指导您完成 ASK CLI 授权流程
- 运行自动技能创建/更新、交互模型上传、模型构建轮询和测试启用。
在浏览器中，打开 http://localhost:5000/status 的状态 UI 检查技能状态

在技能原型服务（默认端口：5000）和 Music Assistant 流媒体端口（默认端口：8097）前配置反向代理（如 Nginx 或 Caddy）[如果仅使用 APL 设备则可选]
为您的域获取并安装有效的 SSL 证书（例如使用 Let's Encrypt）
确保原型和 Music Assistant 流媒体端点 [如果仅使用 APL 设备则可选] 都可通过 HTTPS（端口：443）访问，因为 Alexa 需要安全端点

在 交互模型 → 意图 下，添加名为 PlayAudio 的意图，示例话语如 play audio、start 和 play，然后构建模型。
在接口下，启用 音频播放器 和 Alexa Presentation Language 接口并保存更改。
转到测试标签页，通过切换到开发启用测试。

摘要：
技能原型作为单独的服务器运行，必须设置带有 SSL 证书的代理，创建并配置 Alexa 技能，然后 Music Assistant 播放现在应该在您的 Alexa 设备上启用。