Google致力于提高黑人社区的种族平等。 怎么看。
此页面由 Cloud Translation API 翻译。
Switch to English

烟雾+ CO报警

烟雾+ CO警报

Nest Protect旨在检测住宅环境中的烟雾和一氧化碳(CO),并具有多个传感器以帮助其了解家庭中发生的事情。

Nest API可让您访问Nest Protect上的以下数据:

  • 烟雾或一氧化碳(CO)警报状态
  • 电池健康状态
  • 上次手动测试状态和时间戳
  • 联机状态和上次连接信息
  • 结构名称和设备“位置名称”(家庭中的位置)

Smoke + CO权限

要对所有Smoke + CO警报API数据值进行读取访问, 为您的客户端选择Smoke + CO读取权限。

Smoke + CO警报API没有可用的写权限。

Smoke + CO标识符

设备

嵌套设备按类型列出为ID数组,可用于通过设备路径唯一标识设备。因此,烟雾+联合警报ID为"RTMTKxs..."意味着您可以通过API在devices/smoke_co_alarms/RTMTKxs...上加载烟雾+联合警报设备模型。

当设备连接到多个产品时,每个开发人员将看到该设备的不同ID。对于已安装来自同一开发人员的多个产品的设备,开发人员将看到相同的ID。

名称

提供了两个名称属性。较短的name属性显示在用户界面标签中,而name_long用于长格式文本。

name

在此示例中, name为“嵌套保护”。

名称

name_long

在此示例中, name_long是“ Basement Nest Protect”。

名字长

哪里

where_id

  • 由Nest生成的唯一标识符,代表name
  • where_id是只读的,并且会在调用中自动创建以创建自定义where name

详细了解Nest ThermostatsNest ProtectsNest Cams的名称

where_name

选择Smoke + CO读取许可权后 ,可以从设备对象( devices/smoke_co_alarms )访问设备where_name

其他元数据

除非另有说明,否则所有数据值都是只读的。

资料值描述
locale 分配给此设备的语言和国家/地区代码
software_version 代表设备当前安装的固件的字符串
structure_id 一个唯一表示此结构的字符串;这是设备与之配对的结构
last_connection 上次成功连接Nest服务的时间戳
is_online 联机状态。这是由Nest使用last_connection时间和特定于设备的预期重新连接窗口确定的。

烟雾+ CO功能

电池健康

使用battery_health字段查看电池的健康状态。

描述
ok 电池电量正常
replace 电池电量不足,应更换

一氧化碳报警器

使用co_alarm_state字段查看CO警报状态。

描述
ok 普通手术
warning 检测上升的一氧化碳水平
emergency CO水平过高,用户应离开家

烟雾报警器

使用smoke_alarm_state字段查看烟雾警报状态。

描述
ok 普通手术
warning 检测烟雾水平上升
emergency 烟雾水平过高,用户应离开家

手动测试

使用这些字段来检查当前是否正在进行手动烟气或一氧化碳测试,以及最后一次成功进行烟气或一氧化碳测试的时间。

UI颜色状态

为了使设计一致的跨产品UI更加容易,我们提供了ui_color_state字段,该字段从高层指示了Nest Protect的整体状态。它是从is_onlinebattery_healthco_alarm_statesmoke_alarm_state ,提供了一个汇总条件,可以反映Nest应用程序中显示的实际颜色指示器。

错误讯息

有关什么是API调用错误的含义以及如何处理错误的信息 ,请参见错误消息