Giters

E-NINA / miio_acpartner

小米空调伴侣杂项功能，包含收音机控制、铃声控制以及作为TTS使用，同样适用于小米网关

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

功能说明

小米空调伴侣杂项功能，包含收音机控制、铃声控制以及作为TTS使用，同样适用于小米网关

部署安装

  • 将下载得到的miio_acpartner和xiaomi_ac_radio文件夹都复制到home assistant配置目录下的custom_components中

  • 设备配置

miio_acpartner:
  - platform: xiaomi_ac_radio
    name: "ChildrenRoom" 
    host: 192.168.2.238
    token: YOUR_TOKEN
    api_key: "YOUR_BAIDU_TTS_API_KEY"
    secret_key: "Your_BAIDU_TTS_SECRET_KEY"
    base_url: "http://192.168.2.249:8123"
    base_path: "C:\\Users\\Dylan\\AppData\\Roaming\\.homeassistant"
    notify: true

多个设备就配置多个platform组。

  • 参数说明：
  • name、host、token：miio设备固有配置，请参考空调伴侣网关等基本设置方法
  • api_key、secret_key：百度TTS开放服务为你提供的相关信息，如果你不使用TTS功能，这俩配置可以不要
  • base_url base_path：你的home assistant环境信息
    • base_url：你的home assistant在内网的访问基础地址（后边不需要斜杠哦）
    • base_path：你的home assistant配置所在的目录，请在该目录下创建www文件夹，并且给予可写权限
  • notify：由于TTS使用时，ffmpeg感觉不是很稳定，有时候tts会失败，所以增加此选项，当开启后，tts和vod成功后，会在hass的notification中展示结果（失败就没有）。

功能说明

该插件提供如下功能：

miio_acpartner.turn_on

打开广播

  • entity_id：指定entity_i d为打开指定空调伴侣的广播，不指定则打开所配置的所有radio组件对应的设备广播

miio_acpartner.turn_off

关闭广播

  • entity_id：指定entity_id为关闭指定空调伴侣的广播，不指定则关闭所配置的所有radio组件对应的设备广播

miio_acpartner.toggle

切换打开关闭状态

  • entity_id：用途同上

miio_acpartner.set_volume

设置音量

  • entity_id：用途同上
  • volume：音量值，0-100
{
    "entity_id": "radio.childrenroom_fm",
    "volume": 100
}

miio_acpartner.next_radio

播放下一个收藏频道【当前只能在频道编号最低的10个频道中循环】

entity_id：用途同上

miio_acpartner.prev_radio

播放上一个收藏频道【当前只能在频道编号最低的10个频道中循环】

  • entity_id：用途同上

miio_acpartner.play_radio

播放指定频道

  • entity_id：用途同上

  • program_id：需要播放的频带ID

{
    "entity_id": "radio.childrenroom_fm",
    "program_id": 1739
}
频道ID的获取方式：
  • 通过米家APP播放你想播放的电台
  • 通过home assitant的states接口或者网站的states页面（左侧“开发者工具”下方有一对尖括号图标那个），找到你的设备，右侧中可以看到channel，后边有形如：
space_free: 11638627
channel: 1739
volume: 100
  • 其中channel就是当前正在播放节目的program_id，后续使用该数字即可播放指定电台。

miio_acpartner.play_ringtone

播放指定铃声

  • entity_id：用途同上

  • ringtone_id：需要播放的铃声ID

  • volume：播放铃声的音量（可选），默认为上次音量

铃声ID的获取方式：

  • 通过home assitant的states接口或者网站的states页面（左侧“开发者工具”下方有一对尖括号图标那个），找到你的设备，右侧中可以看到ringtones，里面分三种铃声：

    • alarm 报警铃声
    • clock 闹铃
    • doorbell 门铃

  • 无论哪种铃声，使用list下的index作为ringtone_id即可。

miio_acpartner.play_tts

TTS输出

  • entity_id：用途同上

  • message：需要播放的文字内容（转换成语音后总长度不能超过30s）

  • volume：播放音量，默认为上次音量

    此功能需要百度TTS以及ffmpeg的支持。

miio_acpartner.play_vod

播放指定音频流

  • entity_id：用途同上

  • url：需要播放的音频流地址（http格式的纯音频流，不要超过30s）

  • volume：播放音量，默认为上次音量

特别说明：

play_tts和play_vod需要三项配置支持：

  1. home assistant的http服务支持：需要在配置文件所在目录下创建www文件夹，并且保证该目录权限可写，具体可参考：https://www.home-assistant.io/components/http/ ，页面最下部分：Hosting files
  2. ffmpeg支持，具体参考：https://www.home-assistant.io/components/ffmpeg/
  3. 百度tts支持，可参考网页帖子：https://bbs.hassbian.com/forum.php?mod=viewthread&tid=33&highlight=%E7%99%BE%E5%BA%A6tts ，不可谓不深情并茂。

玩法参考

  1. 天猫精灵这个蠢货，目前还没有发现通过API控制音量和暂停的手段，可以通过空调伴侣间隔控制天猫精灵（附件带了三个文件，可以通过米家上传为自定义铃声后，通过在特定场景播放指定铃声完成对猫精的控制），后来笔者想到的控制天猫精灵关闭的方法不采用这种扰民的方案了，买一个天猫精灵按呗（阿里咋啥都背？），用esp控制按呗出发信号控制天猫精灵关闭；
  2. 使用网关和空调伴侣的朋友，免费多了几个TTS设备（虽然空调伴侣的声音又小又渣，聊胜于无）；
  3. 可以自行搭建一个http服务器，通过APP的方式，将手机录音上传到服务器后，然后使用play_vod将上传的录音通过空调伴侣或者网关播放出来（至2020年年中的时候小米已经限制录音文件的长度为30s了，这个功能基本无意义了）；
  4. 一个可以上一台下一台选取的收音机（目前只能在program_id最低的10个收藏台中循环）。

About

小米空调伴侣杂项功能，包含收音机控制、铃声控制以及作为TTS使用，同样适用于小米网关

Languages

Language:Python 100.0%