hass-edge-tts - 实现Microsoft Edge浏览器TTS服务的Home Assistant组件

项目介绍：hass-edge-tts

hass-edge-tts 是一个基于微软 Edge 浏览器文本转语音服务（TTS）的开源项目，适用于 Home Assistant 平台的用户。与其他 TTS 服务不同，它不需要申请 app_key，极大地降低了使用的门槛。

安装方法

要安装 hass-edge-tts，用户需将 custom_components/edge_tts 文件夹下载并复制到 Home Assistant 配置文件夹中的 custom_components 文件夹内。为了方便用户，提供了一条命令行指令来自动完成安装：

wget -O - https://hacs.vip/get | DOMAIN=edge_tts REPO_PATH=hasscc/hass-edge-tts ARCHIVE_TAG=main bash -

配置指南

在进行配置时，用户需在 configuration.yaml 文件中添加以下内容：

tts:
  - platform: edge_tts
    language: zh-CN # 默认语言或语音（可选）

用户还可以自定义默认选项，例如服务名、语言和音量设置：

tts:
  - platform: edge_tts
    service_name: xiaomo_say
    language: zh-CN-XiaoxiaoNeural
    volume: +10%

项目支持多种语言和语音，具体参考微软文档和项目源码中的列表。

使用方法

用户可以通过 Home Assistant 提供的服务调用或者 REST API 来使用此 TTS 服务。例如，使用以下服务调用：

service: tts.edge_tts_say
data:
  entity_id: media_player.your_player_entity_id
  message: Hello
  language: zh-CN-XiaoyiNeural

更复杂的使用示例可以添加缓存和其他可选参数：

service: tts.edge_tts_say
data:
  entity_id: media_player.your_player_entity_id
  message: 吃葡萄不吐葡萄皮，不吃葡萄倒吐葡萄皮
  language: zh-CN
  cache: true
  options:
    voice: zh-CN-XiaoyiNeural
    rate: +0%
    volume: +10%

此外，还可以使用 curl 命令调用 API：

curl -X POST -H "Authorization: Bearer <ACCESS TOKEN>" \
     -H "Content-Type: application/json" \
     -d '{"platform": "edge_tts", "message": "欢迎回家", "language": "zh-CN-XiaoyiNeural", "cache": true, "options": {"volume": "+10%"}}' \
     http://home-assistant.local:8123/api/tts_get_url

注意事项

需要特别说明的是，一些选项如 style、styledegree、role 和 contour 已不再支持，这些特性早先可能出现在项目中，但已被移除。

特别感谢

项目特别感谢其他开源项目的贡献者，包括 rany2 和 ag2s20150909 提供的相关代码与灵感。