集成使您可以集成Google Nest家庭助理的设备。必威是什么此集成使用智能设备管理API和Google的Cloud PubSub有效地聆听设备状态或其他事件的变化。看支持的设备对于SDM API支持的所有设备。

目前,家庭助理中的以下设备类型支持:必威是什么

相机和门铃的使用自动化和设备触发器对于活动和一个媒体来源用于在受支持的设备上捕获媒体图像。SDM API当前不支持其他设备类型,例如SMOKE和CO警报或安全系统。

您可以控制接触家庭助理的信息和功能。必威是什么您可以为任何特定设备授权单个设备,多个设备或不同级别的功能,例如运动事件,实时流。集成足够灵活,可以根据您的允许进行调整。

NEST智能设备管理(SDM)API需要5美元的费用

视频演练

设备访问注册

对于第一阶段,您将打开API并创建必要的凭据,以与Nest API进行家庭助理对话。必威是什么

创建和配置云项目[Cloud Console]
配置OAuth同意屏幕[Cloud Console]
配置oauth client_id和client_secret [云控制台]
创建设备访问project_id [设备访问控制台]

配置

现在,您应该拥有在家庭助理中配置巢的一切所需的一切。必威是什么编辑您的configuration.yaml文件并填充一个以下面的示例配置格式输入。

#示例Configuration.yaml条目client_idclient_idclient_secretclient_secret#设备访问控制台中的“项目ID”(不是云项目ID!)Project_IDProject_ID

然后确保重新启动家庭助理必威是什么服务器控件

配置变量

client_id 细绳 必需的

您的设备访问或Nest Developer客户端ID。

client_secret 细绳 必需的

您的设备访问或Nest Developer客户端秘密。

Project_ID 细绳 ((选修的

您的设备访问项目ID。这启用了SDM API。

subscriber_id 细绳 ((选修的

建议离开空白,让集成为您管理。如果要使用订阅,请输入酒吧/子订阅名称的完整路径。

设备设置

一次configuration.yaml有效条目,您需要通过使用此my按钮通过用户界面将NEST添加到您的必威体育存款家庭助理实必威是什么例:

手动配置步骤

NEST集成设置将带您完成授权您的家庭助理访问您的帐户和巢设备的步骤。必威是什么必威体育存款

OAuth和设备授权步骤

气候

所有Google Nest恒温器模型均被视为气候使用的实体恒温特征在SDM API中。恒温器对恒温器的状态变化通过Cloud PubSub用户报告给家庭助理。必威是什么

给定恒温器楼上然后,气候实体是用一个名称创建的气候

以下权限启用了此功能:

  • 允许家庭助理必威是什么访问并控制您的恒温器

传感器

所有Google Nest恒温器模型均具有SDM API暴露的特征。传感器的初始值在启动时获取,然后使用Cloud PubSub订阅者定期更新。传感器支持以下特征:

给定恒温器楼上然后,传感器是用诸如传感器。upstairs_temperature或者传感器。upstairs_humity

以下权限启用了此功能:

  • 允许家庭助理必威是什么访问并控制您的恒温器
SDM API不支持其他嵌套温度传感器。

相机

必威是什么家庭助理支持所有SDM API功能。但是,每个相机或门铃设备都具有不同的内置功能。相机设备具有以下实时流类型之一:

  • RTSP:这些设备具有由家庭助理核心提供的HLS流。必威是什么这些相机支持服务器侧相机诸如流录制或图像预览之类的服务。看低延迟HLS作为能够减少流延迟的绝佳选择。
  • webrtc:这些设备支持直接浏览器到相机通信和超低延迟流。一种图片眼镜卡可以在网格中显示现场流相机视图调成居住(不建议用于电池供电的摄像机)。相机诸如流录制之类的服务是不支持

以下权限启用了此功能:

  • 允许家庭助理必威是什么查看并显示相机的直播
  • 巢或Google Home应用程序中的其他权限

所有相机都有运动和人触发器,但是只有一些支持捕获事件的快照。下表总结了支持的SDM API功能对于每个设备。

设备 现场直播 触发 /事件 媒体来源
用于触发器 /事件
Nest Cam(室内,有线)
巢凸轮(室外,电池)
webrtc 运动
N/A。
巢凸轮室内
Nest Cam IQ室内
Nest Cam IQ户外
Nest Cam户外
RTSP
记录
运动

声音
快照(JPG)
嵌套凸轮带有泛光灯 webrtc 运动
N/A。
巢门铃(电池) webrtc 运动

剪辑预览(MP4,GIF)
巢门铃(有线) RTSP
记录
运动

声音
快照(JPG)
Nest Hub Max RTSP
记录
运动

声音
*SDM API已知问题
快照(JPG)

给定一个命名的相机前院然后,相机是用一个名称创建的摄像头。front_yard

自动化和设备触发器

巢的整合提供设备触发器启用自动化家庭助理。必威是什么您应该查看自动化家庭助理必威是什么入门自动化指南或自动化文档以获取完整的详细信息。

屏幕快照设备触发

示例设备触发器 /事件有效载荷

继续在下面阅读到媒体源附件查看如何使用通知操作的媒体。

以下权限启用了此功能:

  • 允许家庭助理必威是什么知道何时有相机活动
  • 允许家庭助理必威是什么知道何时有门铃活动
  • 巢或Google Home应用程序中的其他权限

媒体来源

鸟巢媒体来源平台使您可以浏览剪辑以获取最近的相机事件。必威是什么家庭助理并不是要成为网络视频记录器(NVR)平台,但是,支持捕获最近事件的基本支持。

上表描述了哪些设备支持事件图像快照或10帧MP4视频剪辑,用于最近的事件。

媒体附件

媒体源API可用于伴侣应用程序附件作为作为上述设备触发器的操作的通知门铃压了。您将需要熟悉相机支持的媒体资源以及Companion应用程序的媒体功能。

  • /api/nest/event_media/device_id/event_id:事件的媒体,该事件支持图像快照(JPG)或剪辑预览(MP4),具体取决于相机类型。

  • /api/nest/event_media/device_id/event_id/缩略图:根据摄像机类型,支持图像快照(JPG)或剪辑预览(GIF)的介质的缩略图预览。

您可以使用事件有效负载字段设备编号event_id自动化动作如下所示。

示例操作:iOS的剪辑预览(MP4)附件
示例动作:clip预览缩略图(GIF),用于Android或iOS
示例操作:Android或iOS的快照(JPG)附件

以下权限启用了此功能:

  • 根据您选择从该设备共享的事件,允许家庭助理访问相机录像剪辑必威是什么
  • 根据您选择从该设备共享的事件,允许家庭助理访问相机快照必威是什么
  • 巢或Google Home应用程序中的其他权限

故障排除

  • 您可以管理巢穴中授予家庭助理的设备和权限必威是什么合作伙伴Connections Manager。重新启动家庭助理必威是什么,使新设备可用。看到SDM API故障排除文档以获取更多详细信息。

  • 有关SDM API OAUTH授权流的一般麻烦,请参见故障排除

  • 查看设置- >系统- >日志要查看是否有任何错误消息或错误配置,请查看下面的错误消息。

  • 经常需要重新验证:如果您每7天登录一次,这意味着出于某些其他原因,Google撤销了OAuth同意屏幕误解或您的身份验证令牌。

有关重新验证问题的详细信息
  • 错误400:redirect_uri_mismatch:这意味着您有一个现有的Web应用程序凭据。建议删除现有的OAuth客户端ID并创建新的桌面应用程序使用上述说明凭证。这具有不需要SSL或公共DNS名称的优势。

  • 恒温器未出现或不可用由于SDM API确实返回设备的错误而发生。一个常见的修复使API再次工作是:

如何重新启动恒温器
  • 没有创建设备或实体如果SDM API未返回授权帐户的任何设备。仔细检查GCP正确配置为启用API并在OAuth设置流中授权至少一台设备。如果您在这里遇到麻烦,那么您可能需要浏览Google说明并直接针对API发出命令,直到您成功地收回设备为止。

  • 错误403:Access_denied意味着您需要参观OAuth同意屏幕并将您的Google帐户添加为一个测试用户

  • 错误:Invalid_client无应用名称表示OAuth同意屏幕该项目尚未完全配置。输入所需字段(应用程序名称,支持电子邮件,开发人员电子邮件),并将其他所有内容留为默认值。

  • 订户错误意思是configuration.yaml有不正确subscriber_id否则订阅是错误的。建议将其从配置中删除,然后删除并重新添加集成以使其为您创建订阅。

  • 未收到更新通常意味着订户配置的问题。确保检查日志是否有任何错误消息。当所有内容正确配置时,诸如传感器或恒温器温度设定点之类的更改应立即发布到主题,并由家庭助理订户接收。必威是什么

  • 您可以在云控制台其中包括您的设备发布的消息,以及您的家庭助理订阅者已承认多少消息。必威是什么必威体育存款你也可以查看消息查看已出版的例子。许多旧的未经认可的消息表明订户没有接收消息,并且完全无法连接。

  • 为了帮助诊断订户问题或相机流问题,将其中的一些或全部添加到您的configuration.yaml取决于您遇到麻烦的地方:

记录器默认信息日志homeassistant.components.nest调试homeassistant.components.nest.climate_sdm调试homeassistant.components.nest.camera_sdm调试homeassistant.components.nest.sensor_sdm调试homeassistant.helpers.config_entry_flow调试homeassistant.helpers.config_entry_oauth2_flow调试Google_nest_sdm调试Google_nest_sdm.device调试Google_nest_sdm.device_manager调试google_nest_sdm.google_nest_subscriber调试Google_nest_sdm.event调试
  • 建议让Home Assistant为您创建酒吧/子必威是什么订阅。但是,如果您想要更多的控制权,则可以输入susbcriber_id在配置中。看订阅事件有关如何手动创建订阅并使用家庭助理配置中的完整订阅名称的更多说明,例如必威是什么项目/GCP项目名称/订阅/订阅-ID

与Nest API一起使用

遗产与Nest一起使用API不接受新的注册。

传统与巢配置步骤一起工作
Baidu