Google 致力于为黑人社区推动种族平等。查看具体举措

相机API

Nest API 适用于所有 Nest Cam™ 型号。

用户可以多巢凸轮添加到devices/cameras基,直至每结构最大。当您调用此数据位置时,您可以访问 Nest Cam 数据(结构中设备的数据值)。

下面所有的值被每个下找到devices/cameras/ device_id的JSON文档英寸

设备编号

Nest Cam 唯一标识符。

细节
https://developer-api.nest.com/devices/cameras/ device_id /device_id
退货string
示例:“awJo6rH...”
使用权只读
可在摄像头读取 / v1-v3
相机读取 + 图像 / v1-v4
相机读/写 / v1-v3
相机读/写+图像/ v1-v4

软件版本

软件版本。

细节
https://developer-api.nest.com/devices/cameras/ device_id /software_version
退货string
示例:“4.0”
使用权只读
可在摄像头读取 / v1-v3
相机读取 + 图像 / v1-v4
相机读/写 / v1-v3
相机读/写+图像/ v1-v4

结构标识

结构唯一标识符。

细节
https://developer-api.nest.com/devices/cameras/ device_id /structure_id
退货string
示例:“VqFabWH21nw...”
使用权只读
可在摄像头读取 / v1-v3
相机读取 + 图像 / v1-v4
相机读/写 / v1-v3
相机读/写+图像/ v1-v4

where_id

一个唯一的,巢生成的标识符,它表示name ,设备的显示名称。

了解更多关于哪里的名字 鸟巢恒温器巢保护巢凸轮

细节
https://developer-api.nest.com/devices/cameras/ device_id /where_id
退货string
示例:“d6reb_OZTM...”
使用权只读
可在摄像头读取 / v1-v3
相机读取 + 图像 / v1-v4
相机读/写 / v1-v3
相机读/写+图像/ v1-v4

where_name

设备的显示名称。相关的巢凸轮where_id 。可以是我们提供的列表中的任何房间名称,也可以是自定义名称。了解更多关于哪里的名字 鸟巢恒温器巢保护巢凸轮

细节
https://developer-api.nest.com/devices/cameras/ device_id /where_name
退货string
示例:“走廊”
使用权只读
可在相机读取 / v3
相机读取 + 图像 / v4
相机读/写/ v3
相机读/写+图像/ v4

名称

设备的显示名称;可以是我们提供的列表中的任何房间名称,也可以是自定义名称。

细节
https://developer-api.nest.com/devices/cameras/ device_id /name
退货string
示例:“走廊”
使用权只读
可在摄像头读取 / v1-v3
相机读取 + 图像 / v1-v4
相机读/写 / v1-v3
相机读/写+图像/ v1-v4

name_long

设备的长显示名称。包括,或者通过自定义(标记),由用户创建的wheres

细节
https://developer-api.nest.com/devices/cameras/ device_id /name_long
退货string
示例:“Hallway Nest Cam(楼上)”
使用权只读
可在摄像头读取 / v1-v3
相机读取 + 图像 / v1-v4
相机读/写 / v1-v3
相机读/写+图像/ v1-v4

在线

设备与 Nest 服务的连接状态。

细节
https://developer-api.nest.com/devices/cameras/ device_id /is_online
退货boolean
值:真、假
使用权只读
可在摄像头读取 / v1-v3
相机读取 + 图像 / v1-v4
相机读/写 / v1-v3
相机读/写+图像/ v1-v4

is_streaming

摄像头状态,可以是开启和正在流式传输视频,也可以是关闭。请参阅您的相机如何与民政工作/无人协助的详细信息。

细节
https://developer-api.nest.com/devices/cameras/ device_id /is_streaming
退货boolean
值:真、假
使用权读/写
可在摄像头读取 / v1-v3
相机读取 + 图像 / v1-v4
相机读/写 / v1-v3
相机读/写+图像/ v1-v4

is_audio_input_enabled

摄像头麦克风状态,打开和收听,或关闭。了解更多关于鸟巢凸轮音频设置

细节
https://developer-api.nest.com/devices/cameras/ device_id /is_audio_input_enabled
退货boolean
值:真、假
使用权只读
可在摄像头读取 / v1-v3
相机读取 + 图像 / v1-v4
相机读/写 / v1-v3
相机读/写+图像/ v1-v4

last_is_online_change

时间戳标识的在线状态的最后一个变化,在ISO 8601的格式。

细节
https://developer-api.nest.com/devices/cameras/ device_id /last_is_online_change
退货string
示例:“2016-12-29T18:42:00.000Z”
使用权只读
可在摄像头读取 / v1-v3
相机读取 + 图像 / v1-v4
相机读/写 / v1-v3
相机读/写+图像/ v1-v4

is_video_history_enabled

巢意识到订阅状态(订阅有效与否)。

细节
https://developer-api.nest.com/devices/cameras/ device_id /is_video_history_enabled
退货boolean
值:真、假
使用权只读
可在摄像头读取 / v1-v3
相机读取 + 图像 / v1-v4
相机读/写 / v1-v3
相机读/写+图像/ v1-v4

网址

网页URL(深层链接)的实时视频流在home.nest.com

细节
https://developer-api.nest.com/devices/cameras/ device_id /web_url
退货string
例如: “ https://home.nest.com/cameras/ device_id ?auth= camera_token
使用权只读
可在摄像头读取 / v1-v3
相机读取 + 图像 / v1-v4
相机读/写 / v1-v3
相机读/写+图像/ v1-v4

app_url

Nest 应用中直播视频流的应用 URL(深层链接)。

细节
https://developer-api.nest.com/devices/cameras/ device_id /app_url
退货string
例如: “ nestmobile://cameras/ device_id ?auth= camera_token
使用权只读
可在摄像头读取 / v1-v3
相机读取 + 图像 / v1-v4
相机读/写 / v1-v3
相机读/写+图像/ v1-v4

is_public_share_enabled

用户可以选择分享自己的视频,并可以查看该人。当启用公共共享,你可以阅读public_share_url

细节
https://developer-api.nest.com/devices/cameras/ device_id /is_public_share_enabled
退货boolean
值:真、假
使用权只读
可在相机读取 + 图像 / v3-v4
相机读/写 + 图像 / v3-v4

活动区域

返回所有已定义活动区的数组。

活动区被用于监控内的视频流的用户定义的区域中的运动的事件。需要巢感知

细节
https://developer-api.nest.com/devices/cameras/ device_id /activity_zones
退货array
例如: [ {"name" : " string1 ", "id" : " string2 "},... ]

string1是区域名称,或者用户定义的或自动时创建的区域时产生。
string2是创建活动区时由Nest分配一个标识符。
使用权只读
可在相机读取 + 图像 / v3-v4
相机读/写+图像/ v3-v4

public_share_url

当用户使得他们可以访问此网址的视频流公众

细节
https://developer-api.nest.com/devices/cameras/ device_id /public_share_url
退货string
例如:“ https://video.nest.com/live/ string1 ? string2

string1是视频流的名称,或者用户定义当流被设置为公共或自动生成的。
使用权只读
可在相机读取 + 图像 / v3-v4
相机读/写+图像/ v3-v4

快照网址

按需捕获图像。返回从实时视频流中捕获的图像的 URL。要求相机处于开启状态并进行流式传输。

使用此字段从实时视频流中获取快照。

  • snapshot_url -返回实况视频流捕获的图像的URL
  • 要求相机已打开并正在流式传输

如果您符合以下条件,则 API 的快照质量仅为 1080p 吞吐量:

  • 在应用程序中积极地观察摄像机流( web_url
  • 积极观看公共流( app_url
  • 订阅了 Nest Aware

如果您没有积极查看流或没有 Nest Aware 订阅,则该 API 没有 1080p 源可从中检索该分辨率的快照并生成较低质量的图像。此外,如果存在 Nest Aware,本地网络带宽较低可能会导致 API 快照分辨率低于 1080p。

详细了解了鸟巢相机的带宽需求

速率限制适用于这一呼吁,取决于巢意识到订阅状态

细节
https://developer-api.nest.com/devices/cameras/ device_id /snapshot_url
退货string
例如: “ string1 / device_id / string2 ?auth= camera_token
使用权只读
可在相机读取 + 图像 / v3-v4
相机读/写+图像/ v3-v4

最后一个事件

此对象捕获有关触发通知的最后一个事件的信息。

一些领域和一些权限组合需要一个巢意识到订阅访问最后一个事件的信息。

下面所有的值下的每个找到devices/cameras/ device_id /last_event的JSON文档英寸

has_sound

声音事件 - 检测到声音。

细节
https://developer-api.nest.com/devices/cameras/ device_id /last_event/has_sound
退货boolean
值:真、假
使用权只读
可在摄像头读取 / v1-v3
相机读取 + 图像 / v1-v4
相机读/写 / v1-v3
相机读/写+图像/ v1-v4

has_motion

运动事件 - 检测到运动。

细节
https://developer-api.nest.com/devices/cameras/ device_id /last_event/has_motion
退货boolean
值:真、假
使用权只读
可在摄像头读取 / v1-v3
相机读取 + 图像 / v1-v4
相机读/写 / v1-v3
相机读/写+图像/ v1-v4

has_person

人员事件 - 检测到人员。

细节
https://developer-api.nest.com/devices/cameras/ device_id /last_event/has_person
退货boolean
值:真、假
使用权只读
可在摄像头读取 / v1-v3
相机读取 + 图像 / v1-v4
相机读/写 / v1-v3
相机读/写+图像/ v1-v4

开始时间

活动开始时间,以ISO 8601的格式。

细节
https://developer-api.nest.com/devices/cameras/ device_id /last_event/start_time
退货string
示例:“2016-12-29T00:00:00.000Z”
使用权只读
可在摄像头读取 / v1-v3
相机读取 + 图像 / v1-v4
相机读/写 / v1-v3
相机读/写+图像/ v1-v4

时间结束

活动结束时间,以ISO 8601的格式。

细节
https://developer-api.nest.com/devices/cameras/ device_id /last_event/end_time
退货string
示例:“2016-12-29T00:00:00.000Z”
使用权只读
可在摄像头读取 / v1-v3
相机读取 + 图像 / v1-v4
相机读/写 / v1-v3
相机读/写+图像/ v1-v4

urls_expire_time

时间戳,以ISO 8601的格式,标识这些事件相关的URL到期:

期满时间被计算为: last_event/start_time + n天(其中,n = 10或30天,这取决于巢感知订阅计划)。

需要巢感知

细节
https://developer-api.nest.com/devices/cameras/ device_id /last_event/urls_expire_time
退货string
示例:“2016-12-29T00:00:00.000Z”
使用权只读
可在摄像头读取 / v1-v3
相机读取 + 图像 / v1-v4
相机读/写 / v1-v3
相机读/写+图像/ v1-v4

网址

网页URL(深层链接)到最后的声音或运动事件的home.nest.com 。用于显示上次记录的事件,需要用户登录帐户。

需要巢感知。如果事件 URL 已过期或设备没有活动订阅,则此值不包含在有效负载中。

last_event/urls_expire_time查找有关此URL的过期时间信息。

细节
https://developer-api.nest.com/devices/cameras/ device_id /last_event/web_url
退货string
例如: “ https://home.nest.com/cameras/ device_id /cuepoints/ string ?auth= camera_token
使用权只读
可在摄像头读取 / v1-v3
相机读取 + 图像 / v1-v4
相机读/写 / v1-v3
相机读/写+图像/ v1-v4

app_url

将应用 URL(深层链接)嵌套到最后一个声音或动作事件。用于显示上次记录的事件,需要用户登录帐户。

需要巢感知。如果事件 URL 已过期或设备没有活动订阅,则此值不包含在有效负载中。

last_event/urls_expire_time查找有关此URL的过期时间信息。

细节
https://developer-api.nest.com/devices/cameras/ device_id /last_event/app_url
退货string
例如: “ nestmobile://cameras/ device_id /cuepoints/ string ?auth= camera_token
使用权只读
可在摄像头读取 / v1-v3
相机读取 + 图像 / v1-v4
相机读/写 / v1-v3
相机读/写+图像/ v1-v4

图片网址

为声音或动作事件捕获的图像文件的 URL(链接)。

需要巢感知。见last_event/urls_expire_time查找有关此URL的过期时间信息。

细节
https://developer-api.nest.com/devices/cameras/ device_id /last_event/image_url
退货string
例如: “ https://www.dropcam.com/api/wwn.get_image/ string1 / device_id / string2 ?auth= camera_token
使用权只读
可在相机读取 + 图像 / v1-v4
相机读/写+图像/ v1-v4

动画图像网址

为声音或动作事件捕获的 gif 文件的 URL(链接)。

需要巢感知

细节
https://developer-api.nest.com/devices/cameras/ device_id /last_event/animated_image_url
退货string
例如: “ https://www.dropcam.com/api/wwn.get_image/ string1 / device_id / string2 ?auth= camera_token
使用权只读
可在相机读取 + 图像 / v1-v4
相机读/写+图像/ v1-v4

activity_zone_ids

检测到运动事件的活动区域的标识符。

需要巢感知。当与使用activity_zones数组,你可以从这些ID获得的区域名称。

如果last_event/has_motion IS

  • true =返回检测到的运动事件的活动区域ID
  • false =返回一个空数组
细节
https://developer-api.nest.com/devices/cameras/ device_id /last_event/activity_zone_ids
退货array
例如: [ string1 , string2 ,... ]
使用权只读
可在相机读取 + 图像 / v3-v4
相机读/写+图像/ v3-v4