logi圈
这logi_circle
实施使您可以集成您的logi圈家庭助理的相机。必威是什么要连接logi圈,您将不得不注册API访问并得到一个client_id
,,,,client_secret
和api_key
。
请求API访问
- 导航到Circle OAuth2客户端请求表。
- 填写您的联系人名称和电子邮件地址。
- 对于用户可见客户名称,请指定“家庭助理”必威是什么
- 请求以下范围:
圈子:活动
圆:配件
圈子:live_image
圈子:直播
圈子:通知
圈子:摘要
- 请求
授权_code
赠款类型。 - 对于重定向URI,请指定您的家庭助理URL,然后指定必威是什么必威体育存款
/api/logi_circle
。例如,如果您的家庭助理URL是必威是什么必威体育存款https://abc123.ui.nabu.casa
,然后请求https://abc123.ui.nabu.casa/api/logi_circle
。重定向URI必须符合以下标准:
- URL必须是由受信任的CA颁发的SSL证书(即,由普通浏览器信任)。
- 在您向Logitech提交请求时,您需要证明您对重定向URI中的完全合格域名具有独家控制。重定向URI的活跃家必威是什么庭助理实例就足够了。如果您不想公开公开曝光家庭助理实例,则还可以在重定向UR必威体育存款I上放置一必威是什么个静态页面,并带有简短的消息,您将管理将授权令重定向到本地家庭助理实例。允许发行托管子域的自由静态主机(例如,Netlify)。
- 由于重定向URI必须是公共面对面的,因此不允许局部/保留的tld(例如,local,.localhost,.example等)。
请注意,API访问的转折时间最多需要一个月,然后使用您提供的表格中提供的电子邮件地址与您联系。
配置
集成与您的相关的相机logi圈帐户,将以下内容添加到您的configuration.yaml
文件:
#示例Configuration.yaml条目logi_circle:client_id:your_client_idclient_secret:your_client_secretapi_key:your_api_keyredirect_uri:your_redirect_uri
相机
这logi_circle
相机平台可让您查看静止框架logi圈相机的直播在家庭助理中。必威是什么
Logi Circle摄像机支持摄像头
和camera.turn_off
服务。这将相应地设置相机的流模式属性,以控制是否可用实时流并捕获活动记录。
传感器
这logi_circle
传感器平台使您可以监视连接到您的传感器logi圈家庭助理的相机。必威是什么
要自定义设置哪些传感器,您可以在您的中扩展Logi Circle Integration配置configuration.yaml
具有以下设置的文件:
#示例Configuration.yaml条目logi_circle:传感器:监视_conditions:-电池_level-last_activity_time-记录-signal_strength_category-signal_strength_percentage-流
默认情况下,将监视Logi Circle设备中的所有传感器。离开监视_conditions
空白以禁用Logi Circle组件的所有传感器。没有内部电池的设备不会暴露电池_level
传感器。
服务
这logi_circle
平台公开3个服务,用于与您的Logi Circle设备进行交互。使用一个或多个实体ID调用服务时,请确保您针对相机实体(例如。camera.living_room_camera
)。
服务logi_circle.livestream_record
启动对相机实时流的录制。
服务数据属性 | 可选的 | 描述 |
---|---|---|
ENTITY_ID |
是的 | 实体的名称,以启动录音,例如camera.living_room_camera 。如果空白,则针对所有Logi Circle摄像机。 |
文件名 |
不 | 文件名的模板。变量为ENTITY_ID ,例如,/tmp/rectoring _ {{entity_id}}。mp4 。 |
期间 |
不 | 记录的持续时间,几秒钟。 |
路径部分文件名
必须是allowlist_external_dirs
在你的乡亲:
您的部分configuration.yaml
文件。
服务logi_circle.livestream_snapshot
从相机的直播中拿起快照。这与通用的不同快照在此中,明确要求从Logi Circle的API请求新的图像。这将迫使相机处于深度睡眠状态。
请注意,只有在缓存的快照大于30岁的情况下,才会生成新的快照。在快速连续中请求多个快照可能会返回相同的图像。同样,请求积极流式传输的相机的快照(即不在深度睡眠中)将返回一个不超过30岁的缓存图像。
服务数据属性 | 可选的 | 描述 |
---|---|---|
ENTITY_ID |
是的 | 实体的名称,以创建一个实时流快照,例如camera.living_room_camera 。如果空白,则针对所有Logi Circle摄像机。 |
文件名 |
不 | 文件名的模板。变量为ENTITY_ID ,例如,/tmp/snapshot _ {{entity_id}}。 。 |
路径部分文件名
必须是allowlist_external_dirs
在你的乡亲:
您的部分configuration.yaml
文件。
服务logi_circle.set_config
为您的相机设置配置属性。
服务数据属性 | 可选的 | 描述 |
---|---|---|
ENTITY_ID |
是的 | 实体的名称,以设置操作模式,例如camera.living_room_camera 。如果空白,则针对所有Logi Circle摄像机。 |
模式 |
不 | 设置的配置属性。允许的值:引领 ,,,,recording_mode |
价值 |
不 | 模式值。允许的值:真的 ,,,,错误的 |