Skip to content

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

Notifications You must be signed in to change notification settings

yunsean/miio_acpartner

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

5 Commits
 
 
 
 
 
 
 
 

Repository files navigation

功能说明

小米空调伴侣杂项功能,包含收音机控制、铃声控制以及作为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使用,同样适用于小米网关

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages