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

烟雾+一氧化碳警报

烟雾 + CO 警报

巢保护设计用于检测烟雾和一氧化碳(CO)在居住环境,与多个传感器,以帮助其了解情况,在家里。

巢API可以访问以下数据上巢保护:

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

Smoke+CO 权限

对于读访问所有的烟雾和一氧化碳报警器API的数据值,选择烟雾和一氧化碳读取权限为您的客户。

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

烟雾+一氧化碳标识符

设备

Nest 设备按类型作为 ID 数组列出,可用于通过设备路径唯一标识设备。所以的烟雾和一氧化碳报警器ID "RTMTKxs..."意味着你可以加载在烟雾和一氧化碳报警装置型号devices/smoke_co_alarms/RTMTKxs...通过API。

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

名称

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

name

在这个例子中, name是“鸟巢保护”。

名称

name_long

在这个例子中, name_long是“地下室巢保护”。

名字长

在哪里

where_id

  • 代表一个唯一的,巢生成的标识符name
  • where_id是只读的,并在通话中自动创建创建自定义的地方name

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

where_name

当选择烟雾+ CO读取权限,则可以访问设备where_name从设备对象( devices/smoke_co_alarms )。

其他元数据

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

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

烟雾+一氧化碳特性

电池健康

使用battery_health现场查看电池健康状态。

价值描述
ok电池电量正常
replace电池电量低,应更换

一氧化碳报警器

使用co_alarm_state现场查看CO报警状态。

价值描述
ok普通手术
warning检测不断上升的 CO 水平
emergency CO 水平太高,用户应该离开家

烟雾报警器

使用smoke_alarm_state现场查看烟雾报警状态。

价值描述
ok普通手术
warning检测上升的烟雾水平
emergency烟雾浓度太高,用户应该离开家

手动测试

使用这些字段检查手动烟雾或 CO 测试当前是否处于活动状态,以及上次成功执行烟雾或 CO 测试的时间。

界面颜色状态

为了更容易地设计一个连贯的跨产品的UI,我们提供的ui_color_state场,这给鸟巢保护的整体状态的一个高层次的指示。衍生它的is_onlinebattery_healthco_alarm_state ,和smoke_alarm_state ,提供反映在所显示的实际颜色指标聚集条件Nest应用

错误信息

对于哪些API调用错误的含义及如何处理这些信息,请参阅错误信息