ismarslomic/google-assistant-broadcast

google-assistant-broadcast

https://github.com/ismarslomic/google-assistant-broadcast/actions/workflows/docker-image.yml/badge.svg?branch=main](https://github.com/ismarslomic/google-assistant-broadcast/actions/workflows/docker-image.yml)

运行小型Web服务器，通过Google Assistant Service提供REST API，用于向Google Assistant发送广播文本消息。

====== 重要 - 已被Home Assistant中的Google Assistant SDK替代! ======

Home Assistant从v2023.1.0版本开始提供Google Assistant SDK集成。它支持在不中断音乐/视频播放的情况下广播消息，还能发送文本命令。这正是google-assistant-broadcast Docker容器提供的功能。由于官方集成已满足需求且设置更简单，作者将不再维护此仓库。您可以继续使用、或 fork 该仓库进行改进。

====== 重要! ======

获取支持

与源代码和Docker镜像相关的错误和问题，可在https://github.com/ismarslomic/google-assistant-broadcast%E4%BB%93%E5%BA%93%E7%9A%84https://github.com/ismarslomic/google-assistant-broadcast/issues%E4%B8%AD%E6%8A%A5%E5%91%8A%E3%80%82

关于

是否曾想过在不中断当前播放音乐的情况下，向家中的Google Assistant智能音箱广播语音消息？现在可以实现了，且设置过程已尽可能简化。

该项目源于大量研究，最初始于Home Assistant论坛上的这个帖子。

致谢：

• https://github.com/endoplasmic/google-assistant by @endoplasmic
• https://github.com/AndBobsYourUncle/hassio-addons/blob/master/google-assistant-webserver/README.md by @AndBobsYourUncle
• https://github.com/greghesp/assistant-relay by @greghesp

广播到所有或特定扬声器

1. 默认情况下，无需在消息前添加broadcast、shout或tell等前缀，系统会自动处理。消息将广播到与您Google账户关联的所有扬声器。

2. 根据Google Assistant文档，您也可以广播到特定扬声器，消息格式为Broadcast to <扬声器所在房间名称>, Hello world.（例如：Broadcast to 客厅, 大家好）。

向Google Assistant发送命令

通过禁用默认消息前缀（含"broadcast"），您还可以向Google Assistant发送命令，例如Turn off lights in living room（关闭客厅灯光）。

在docker run命令或docker-compose文件中添加环境变量APPEND_BROADCAST_TO_MESSAGE=false，然后发送POST请求：

json
{
  "message": "关闭客厅灯光"
}

安装设置

前提条件

• Docker - 需在设备上安装Docker，详见Get Docker。
• Google OAuth 2.0客户端ID和访问密钥 - 用于身份验证并获取Google Assistant访问权限
  • 可在https://github.com/ismarslomic/google-assistant-oauth%E8%8E%B7%E5%8F%96%E5%B8%AE%E5%8A%A9%E5%92%8C%E6%9B%B4%E5%A4%9A%E4%BF%A1%E6%81%AF%E3%80%82

方法1：使用docker-compose运行容器

创建子文件夹（如/home/pi/config），并添加client_secret.json和tokens.json文件。

docker-compose.yml

yaml
version: '3.8'
services:
  google-assistant-broadcast:
    container_name: google-assistant-broadcast
    image: ismarslomic/google-assistant-broadcast:latest
    restart: unless-stopped
    ports:
      - "8085:8085"
    volumes:
      - /home/pi/config:/usr/src/config

启动容器：

bash
docker-compose up -d

方法2：使用docker run运行容器

创建子文件夹（如/home/pi/config），并添加client_secret.json和tokens.json文件。

bash
docker run -d --name google-assistant-broadcast \
-p 8085:8085 \
-v /home/pi/config:/usr/src/config \
--restart unless-stopped \
ismarslomic/google-assistant-broadcast:latest

使用方法

与Home Assistant集成

可通过RESTful Notifications平台将此REST API集成到Home Assistant。

在configuration.yaml文件中添加：

yaml
# Google Assistant Broadcast - REST API
notify:
  - platform: rest
    name: ga_broadcast
    resource: http://localhost:8085/broadcast
    method: POST_JSON

在Home Assistant中使用

调用通知服务ga_broadcast（上述步骤定义）广播消息：

yaml
service: notify.ga_broadcast
data:
  message: 你好，世界！

直接调用REST API

端点： POST http://localhost:8085/broadcast

请求体：

json
{
  "message": "你好，世界！"
}

curl示例

bash
curl -X POST http://localhost:8085/broadcast \
 -d '{"message":"你好，世界！"}' \
 -H "Content-Type: application/json"

已知问题

1. 广播请求已发送，但未在扬声器上播放

容器运行正常，但通过Postman/CURL/Home Assistant发送广播请求后，扬声器未播放消息，日志中出现以下内容（详见https://github.com/ismarslomic/google-assistant-broadcast/issues/5%EF%BC%89%EF%BC%9A

bash
Sending message: Broadcast Hello world!
[OK] Conversation Response:  empty
[OK] Conversation Completed

可能的解决方案1

在Google Actions Console中删除现有设备注册并重新创建，详见https://github.com/ismarslomic/google-assistant-broadcast/issues/5%E7%9A%84https://github.com/ismarslomic/google-assistant-broadcast/issues/5#issuecomment-***%E3%80%82

可能的解决方案2

此问题与容器中Google Assistant SDK的语言设置有关（默认语言为en-GB）。具体原因尚不明确，但将语言从en-US切换为en-GB对作者有效。您可能还需要调整同一Google账户在Google Assistant应用中的语言设置。

可通过设置环境变量LANGUAGE更改语言，支持的语言代码见支持的语言代码。

使用docker run时添加-e LANGUAGE=<语言代码>参数，或在docker-compose中添加environment配置：

yaml
version: '3.8'
services:
  google-assistant-broadcast:
    ...
    environment:
      - LANGUAGE=<语言代码>