Alone

实体日志中是否出现过`不可用`状态，以及`配置`-`日志`中有无该设备相关报错日志。

请提供[开发者工具](https://my.home-assistant.io/redirect/developer_states)中该设备的所有实体的状态属性。

❓️ 支持哪些设备？是否支持XX型号？ --- 🙋 本插件是通过miot-spec规范接入设备的，因此是通过设备所提供的服务(`service`)对其提供支持。比如一个风扇灯设备，在其型号对应的spec中定义了灯、风扇两个服务，本插件则会根据这两个服务及其属性(`property`)、方法(`action`)将设备集成到HA中。查看目前已支持的设备服务请[点击这里](https://github.com/al-one/hass-xiaomi-miot/#supported-devices)。

❓️ 账号集成还是token集成？ --- 🙋 账号集成通过小米云获取该账号下的所有设备，并可通过筛选设备、型号、WiFi等批量将符合条件的设备集成到HA。且一个小米账号可被多次添加，可将不同类型的设备添加至不同的集成配置以方便管理。 自[v0.4.4](https://github.com/al-one/hass-xiaomi-miot/releases/latest)版本开始，插件新增**支持账号集成时选择连接设备的模式**： - **自动模式**：插件定期更新[支持本地miot协议的设备](https://github.com/al-one/hass-xiaomi-miot/blob/master/custom_components/xiaomi_miot/core/miot_local_devices.py)，并自动将用户筛选的设备中符合条件的型号使用本地连接（推荐） - **本地模式**：集成配置所筛选的所有设备都将使用本地连接，如勾选了不支持本地协议的设备将不可用 - **云端模式**：集成配置所筛选的所有设备都将使用云端连接，建议旧版miio、蓝牙、ZigBee设备使用 🙋 token集成可以将在[局域网环境下支持miot-spec协议](https://github.com/al-one/hass-xiaomi-miot/blob/master/custom_components/xiaomi_miot/core/miot_local_devices.py)或[已适配miio2miot](https://github.com/al-one/hass-xiaomi-miot/blob/master/custom_components/xiaomi_miot/core/miio2miot_specs.py)的设备接入HA。 ### ⭐️ 目前支持本地模式的设备有： - [支持本地miot协议的设备 `MIOT_LOCAL_MODELS`](https://github.com/al-one/hass-xiaomi-miot/blob/master/custom_components/xiaomi_miot/core/miot_local_devices.py) - [已适配miio2miot的设备 `MIIO_TO_MIOT_SPECS`](https://github.com/al-one/hass-xiaomi-miot/blob/master/custom_components/xiaomi_miot/core/miio2miot_specs.py)

❓️ 为什么XX型号的设备需要开启云端模式？如何开启？ --- 🙋 由于部分设备使用的是旧版的miio协议，在局域网环境下无法通过miot-spec协议读写数据，但是却可以在小米云端使用miot-spec协议，因此此类设备需要开启云端模式后才可以正常接入。 开启云端模式的具体方法： - 使用账号集成 - 在集成配置选择中将连接模式选为`Automatic (自动模式)`或`Cloud (云端模式)` - v0.4.4以下版本账号集成的设备默认已开启云端模式 - 使用token集成 - 在`configuration.yaml`中配置账号密码 ```yaml xiaomi_miot: username: xiaomi_username password: xiaomi_password # server_country: cn ``` - >...

❓️ 怎样为一个实体添加自定义选项？ --- 🙋 添加自定义属性有以下三种方式(任选一种)： > ⚠️ 进入[个人资料](https://my.home-assistant.io/redirect/profile)页面开启`高级模式` 1. [通过UI自定义实体/设备](https://github.com/al-one/hass-xiaomi-miot/issues/600) (推荐) > 自[`v0.6.5`](https://github.com/al-one/hass-xiaomi-miot/releases/tag/v0.6.5)版本开始，本插件支持通过UI管理自定义选项(自定义属性) 1. 添加[`Xiaomi Miot Auto`](https://my.home-assistant.io/redirect/config_flow_start/?domain=xiaomi_miot)集成 2. `Customizing entity (自定义实体)` - 选择实体类型 - 选择要自定义的实体 3. `Customizing device (自定义设备)` -...

❓️ 如何翻译实体的选项文本？ --- 🙋 通过本插件集成的设备实体，比如风扇的预设模式等选项可能为英文，这是因为设备厂家在定义miot-spec协议的时候填写的是英文。而本插件在[v0.3.7](https://github.com/al-one/hass-xiaomi-miot/commit/921fc033810ddb21d06444c6d5e25125e2a5898e)版本开始支持翻译这些选项文本，目前可通过配置`configuration.yaml`实现，具体方法如下： 1. 使用插件默认的翻译词库 ```yaml xiaomi_miot: language: zh # 目前仅支持翻译到中文，且只支持扫地机、洗衣机，将随着版本升级陆续完善 ``` 2. 扩展自己的翻译词库示例 ```yaml xiaomi_miot: language: zh translations: # 全局词库，对所有实体生效 idle: '空闲' busy: '工作中' # 指定风扇模式的词典 fan.mode:...

❓️ 如何让**小爱同学**播放文本(TTS)和执行语音命令？ --- 🙋 通过本插件集成小爱音响后会生成一个`media_player`实体，该实体可以控制播放暂停、调节音量和静音等，更多的功能需要通过[HA服务](https://my.home-assistant.io/redirect/developer_services)去调用，服务还可被用于自动化、脚本、模板实体等。本插件为小爱提供了[`xiaomi_miot.intelligent_speaker`](https://my.home-assistant.io/redirect/developer_call_service/?service=xiaomi_miot.intelligent_speaker)服务可以实现TTS和执行语音命令。 - 播放文本(TTS) ```yaml service: xiaomi_miot.intelligent_speaker data: entity_id: media_player.xiaoai_entity_id text: 你好 execute: false # 不执行，朗读text文本 ``` - 执行语音命令 ```yaml service: xiaomi_miot.intelligent_speaker data: entity_id: media_player.xiaoai_entity_id text: 开灯...

❓️ 如何在HA查看摄像头实体回放(看家助手)视频？ --- 🙋 本插件在[v0.4版本](https://github.com/al-one/hass-xiaomi-miot/releases)中添加了对**摄像头**、**猫眼**及**可视门铃**的回放视频支持，原理是通过米家接口获取设备的最后一个看家助手视频。如接入摄像头后仍看不到回放视频，请在米家APP中开启摄像头的`看家助手`。 由于小米云端视频文件编码的问题，部分型号摄像头的回放视频仍然无法播放，你可以尝试为主实体[添加自定义属性](#issuecomment-864678774)`motion_stream_slice: -1`，经测试此方法可能会显示一个静止的视频画面，原因未知。 ```yaml # customize.yaml # 以下自定义属性不是必须 camera.your_entity_id: use_motion_stream: true # 在主实体开启回放，猫眼默认已开启 sub_motion_stream: true # 为回放视频单独生成一个camera实体，与`use_motion_stream`属性选其一 motion_stream_slice: -1 # 视频切片文件索引，-1表示最后一个切片文件，0表示第一个 ```

❓️ 为什么设备状态会有延迟？如何减小延迟？ --- 🙋 延迟通常是指通过米家APP或物理按键等操作设备后，设备在HA中的实体状态要等几秒甚至十几秒后才会更新。原因是本插件目前主要是通过轮询的方式获取设备状态，通俗的讲就是每隔几十秒去刷新一次状态。在token方式集成时，这个时长是可以直接修改的(添加集成和修改集成选项均可)，目前默认是30秒。而通过账号集成时，由于一个集成配置会对应多个设备，因此无法统一配置，需要为每个设备实体添加[自定义属性](#issuecomment-864678774)`interval_seconds`来修改轮询时长： ```yaml # customize.yaml sensor.your_entity_id: interval_seconds: 10 # 轮询间隔时长(秒) ``` 一般情况下，对于开关、灯、环境传感器等设备，我们推荐使用默认轮询时长即可，过于频繁的请求状态可能会使设备负载过高，且大部分请求是无意义的。 对于人体传感器、门磁、无线开关类设备，它们的状态通常为瞬时状态(即：事件)，部分型号支持获取最后一次事件触发的时间，且默认轮询时长为15秒，对于无法获取最后触发事件的设备，即使修改轮询时间到1秒，也可能无法获取正确的状态。因此此类设备通过本插件集成后不太推荐用于触发实时自动化，仅适合作为如几分钟无人移动关灯这类自动化的条件。如果需要实时更新状态，推荐使用[多模网关](https://home.miot-spec.com/s/lumi.gateway.mgl03)配合[XiaomiGateway3](https://github.com/AlexxIT/XiaomiGateway3)集成。 另外还有一种延迟，比如在HA打开某个实体开关后，几秒内开关回弹到操作前的状态，然而实际上已经操作成功，并在一分钟内实体状态又恢复到实际状态。这种情况通常发生在小米账号(云端)接入的设备，具体原因是操作后指令发送给设备后HA会立即请求新的状态，而这个时候设备还未将新的状态同步到小米云端，导致获取到操作之前的状态，一分钟后HA重新获取到实际的状态。目前本插件针对这种情况已经做了优化(操作后延迟几秒再获取状态)，大部分设备已不会出现，如果你的设备有出现，请[提交issue](https://github.com/al-one/hass-xiaomi-miot/issues/new/choose)或通过[自定义属性](#issuecomment-864678774)`cloud_delay_update`来修改延迟时长： ```yaml # customize.yaml sensor.your_entity_id: cloud_delay_update: 6 # 延迟时长(秒) ```