logi圈


logi_circle实施使您可以集成您的logi圈家庭助理的相机。必威是什么要连接logi圈,您将不得不注册API访问并得到一个client_id,,,,client_secretapi_key

请求API访问

  1. 导航到Circle OAuth2客户端请求表
  2. 填写您的联系人名称和电子邮件地址。
  3. 对于用户可见客户名称,请指定“家庭助理”必威是什么
  4. 请求以下范围:
    • 圈子:活动
    • 圆:配件
    • 圈子:live_image
    • 圈子:直播
    • 圈子:通知
    • 圈子:摘要
  5. 请求授权_code赠款类型。
  6. 对于重定向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_circleclient_idyour_client_idclient_secretyour_client_secretapi_keyyour_api_keyredirect_uriyour_redirect_uri

配置变量

client_id 细绳 必需的

Logitech发给您的客户ID。

client_secret 细绳 必需的

Logitech发给您的客户秘密。

api_key 细绳 必需的

Logitech发给您的API密钥。

redirect_uri 细绳 必需的

与您的家庭助理实例相对应的重定向URI。必威是什么必威体育存款当您从Logitech请求API访问时,它必须匹配指定的重定向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传感器。

配置变量

传感器 地图 ((可选的

配置传递到所有传感器。

监视_conditions 列表 ((可选的,默认:全部

创建传感器的条件。

电池_level

从相机返回电池电量百分比。

last_activity_time

从上一次检测到任何活动的Logi Circle摄像头从上次返回时间戳。

记录

相机的录制模式。如果是错误的,则相机将不会捕获活动。

signal_strength_category

从相机返回Wi-Fi信号级别。

signal_strength_percentage

从相机返回Wi-Fi信号百分比。

相机的柔软开/关状态。

服务

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
价值 模式值。允许的值:真的,,,,错误的
Baidu