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服务器，通过https://developers.google.com/assistant/sdk/overview#google_assistant_service%E6%8F%90%E4%BE%9BREST API，用于向Google Assistant发送广播文本消息。

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

Home Assistant从v2023.1.0版本开始提供https://www.home-assistant.io/integrations/google_assistant_sdk%E3%80%82%E5%AE%83%E6%94%AF%E6%8C%81%E5%9C%A8%E4%B8%8D%E4%B8%AD%E6%96%AD%E9%9F%B3%E4%B9%90/%E8%A7%86%E9%A2%91%E6%92%AD%E6%94%BE%E7%9A%84%E6%83%85%E5%86%B5%E4%B8%8B%E5%B9%BF%E6%92%AD%E6%B6%88%E6%81%AF%EF%BC%8C%E8%BF%98%E8%83%BD%E5%8F%91%E9%80%81%E6%96%87%E6%9C%AC%E5%91%BD%E4%BB%A4%E3%80%82%E8%BF%99%E6%AD%A3%E6%98%AF%60google-assistant-broadcast%60 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智能音箱https://support.google.com/assistant/answer/9071582%EF%BC%9F%E7%8E%B0%E5%9C%A8%E5%8F%AF%E4%BB%A5%E5%AE%9E%E7%8E%B0%E4%BA%86%EF%BC%8C%E4%B8%94%E8%AE%BE%E7%BD%AE%E8%BF%87%E7%A8%8B%E5%B7%B2%E5%B0%BD%E5%8F%AF%E8%83%BD%E7%AE%80%E5%8C%96%E3%80%82

该项目源于大量研究，最初始于Home Assistant论坛上的https://community.home-assistant.io/t/community-hass-io-add-on-google-assistant-webserver-broadcast-messages-without-interrupting-music/37274%E3%80%82

致谢：

• 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. 根据https://support.google.com/assistant/answer/9071582%EF%BC%8C%E6%82%A8%E4%B9%9F%E5%8F%AF%E4%BB%A5%E5%B9%BF%E6%92%AD%E5%88%B0%E7%89%B9%E5%AE%9A%E6%89%AC%E5%A3%B0%E5%99%A8%EF%BC%8C%E6%B6%88%E6%81%AF%E6%A0%BC%E5%BC%8F%E4%B8%BA%60Broadcast 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，详见https://docs.docker.com/get-docker/%E3%80%82
• 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: docker.xuanyuan.run/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 \
docker.xuanyuan.run/ismarslomic/google-assistant-broadcast:latest

使用方法

与Home Assistant集成

可通过https://www.home-assistant.io/integrations/notify.rest/%E5%B9%B3%E5%8F%B0%E5%B0%86%E6%AD%A4REST 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更改语言，支持的语言代码见https://developers.google.com/assistant/sdk/reference/rpc/languages%E3%80%82

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

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