MiService
XiaoMi Cloud Service for mi.com
Install
pip3 install miservice
Library
MiService：XiaoMi Cloud Service
|
|-- MiAccount：Account Srvice
|-- MiBaseService：(TODO if needed)
| |
| |-- MiIOService：MiIO Service (sid=xiaomiio)
| | |
| | |-- MIoT_xxx：MIoT Service, Based on MiIO
| |
| |-- MiNAService：MiAI Service (sid=micoapi)
| |
| |-- MiAPIService：(TODO)
|-- MiIOCommand：MiIO Command Style Interface
Command Line
Usage: The following variables must be set:
export MI_USER=《username》
export MI_PASS=《password》
export MIIO_DID=《deviceId》
Get Props: micli.py 《siid[-piid]》[,...]
micli.py 1,1-2,1-3,1-4,2-1,2-2,3
Set Props: micli.py 《siid[-piid]=[#]value》[,...]
micli.py 2=#60,2-2=#false,3=test
Do Action: micli.py 《siid[-piid]》 《arg1》 [...]
micli.py 5 Hello
micli.py 5-4 Hello #1
Call MIoT: micli.py 《cmd=prop/get|/prop/set|action》 《params》
micli.py action '{"did":"267090026","siid":5,"aiid":1,"in":["Hello"]}'
Call MiIO: micli.py /《uri》 《data》
micli.py /home/device_list '{"getVirtualModel":false,"getHuamiDevices":1}'
Devs List: micli.py list [name=full|name_keyword] [getVirtualModel=false|true] [getHuamiDevices=0|1]
micli.py list Light true 0
MiIO Spec: micli.py spec [model_keyword|type_urn]
micli.py spec
micli.py spec speaker
micli.py spec xiaomi.wifispeaker.lx04
micli.py spec urn:miot-spec-v2:device:speaker:0000A015:xiaomi-lx04:1
套路，例子：
请在 Mac OS 或 Linux 下执行，Windows 下要支持也应该容易但可能需要修改？
1. 先设置账号
export MI_USER=《username》
export MI_PASS=《password》
2. 查询自己的设备
micli.py list
可以显示自己账号下的设备列表，包含名称、类型、DID、Token 等信息。
3. 设置 DID
为了后续操作，请设置 Device ID（来自上面这条命令的结果）。
export MIIO_DID=《deviceId》
4. 查询设备的接口文档
查询设备的 MIoT 接口能力描述：
micli.py spec xiaomi.wifispeaker.lx04
其中分为属性获取、属性设置、动作调用三种描述。
5. 查询音量属性
micli.py 2-1
其中 2 为 siid，1 为 piid（如果是 1 则可以省略），可从 spec 接口描述中查得。
6. 设置音量属性
micli.py 2=#60
siid 和 piid 规则同属性查询命令。注意 # 号的意思是整数类型，如果不带则默认是文本字符串类型，要根据接口描述文档来确定类型。
7. 动作调用：TTS 播报和执行文本
以下命令执行后小爱音箱会播报“您好”：
micli.py 5 您好
其中，5 为 siid，此处省略了 1 的 aiid。
以下命令执行后相当于直接对对音箱说“小爱同学，查询天气”是一个效果：
micli.py 5-4 查询天气 #1
其中 #1 表示设备语音回应，如果要执行默默关灯（不要音箱回应），可以如下：
micli.py 5-4 关灯 #0
8. 其它应用
在扩展插件中使用，比如，参考 ZhiMsg 小爱同学 TTS 播报/执行插件
[复制链接]
发表于 2021-3-2 12:01:59
