Google cam kết thúc đẩy công bằng chủng tộc cho các cộng đồng Đen. Xem thế nào.
Trang này được dịch bởi Cloud Translation API.
Switch to English

Báo động khói + CO

Báo động khói + CO

Nest Protect được thiết kế để phát hiện khói và carbon monoxide (CO) trong môi trường dân cư, với nhiều cảm biến để giúp nó hiểu những gì đang xảy ra trong nhà.

API Nest cung cấp quyền truy cập vào dữ liệu sau trên Nest Protect:

  • Trạng thái báo động khói hoặc carbon monoxide (CO)
  • Tình trạng sức khỏe của pin
  • Trạng thái kiểm tra thủ công lần cuối và dấu thời gian
  • Trạng thái trực tuyến và thông tin kết nối cuối cùng
  • Tên cấu trúc và thiết bị "nơi tên" (vị trí trong nhà)

Cấp phép khói + CO

Để truy cập đọc vào tất cả các giá trị dữ liệu API cảnh báo của khói + CO, hãy chọn quyền đọc khói + CO cho khách hàng của bạn.

Không có quyền ghi có sẵn cho API cảnh báo khói + CO.

Số nhận dạng khói + CO

Thiết bị

Các thiết bị Nest được liệt kê theo loại dưới dạng một mảng ID, có thể được sử dụng để nhận dạng duy nhất một thiết bị thông qua đường dẫn thiết bị. Vì vậy, ID báo động khói + đồng của "RTMTKxs..." có nghĩa là bạn có thể tải mô hình thiết bị báo động khói + đồng tại devices/smoke_co_alarms/RTMTKxs... thông qua API.

Khi một thiết bị được kết nối với nhiều sản phẩm, mỗi nhà phát triển sẽ thấy một ID khác nhau cho thiết bị đó. Đối với một thiết bị đã cài đặt nhiều sản phẩm từ cùng một nhà phát triển, nhà phát triển sẽ thấy cùng một ID.

Tên

Hai thuộc tính tên được cung cấp. Thuộc tính name ngắn hơn được hiển thị trong nhãn giao diện người dùng, trong khi name_long được sử dụng trong văn bản dạng dài.

name

Trong ví dụ này, name là "Nest Protect".

Tên

name_long

Trong ví dụ này, name_long là "Tầng hầm bảo vệ tổ".

Tên dài

Ở đâu

where_id

  • Một định danh duy nhất, do Nest tạo ra đại diện cho name
  • where_id ở chế độ chỉ đọc và được tạo tự động trong cuộc gọi để tạo một name tùy chỉnh

Tìm hiểu thêm về nơi đặt tên cho Nest Thermostats , Nest ProtectsNest Cam .

where_name

Khi bạn chọn quyền đọc Khói + CO , bạn có thể truy cập vào thiết bị where_name từ đối tượng devices/smoke_co_alarms ( devices/smoke_co_alarms ).

Siêu dữ liệu khác

Tất cả các giá trị dữ liệu chỉ được đọc, trừ khi có quy định khác.

Giá trị dữ liệu Sự miêu tả
locale Ngôn ngữ và mã quốc gia được gán cho thiết bị này
software_version Một chuỗi đại diện cho phần sụn hiện được cài đặt trên thiết bị
structure_id Một chuỗi đại diện duy nhất cho cấu trúc này; đây là cấu trúc mà thiết bị được ghép nối với
last_connection Dấu thời gian của kết nối thành công cuối cùng với dịch vụ Nest
is_online Trạng thái trực tuyến. Điều này được Nest xác định bằng cách sử dụng thời gian kết nối last_connection cùng và cửa sổ kết nối lại dự kiến ​​dành riêng cho thiết bị.

Tính năng khói + CO

Sức khỏe của pin

Sử dụng trường battery_health để xem trạng thái sức khỏe của pin.

Giá trị Sự miêu tả
ok Mức pin ok
replace Pin yếu, nên được thay thế

Báo động CO

Sử dụng trường co_alarm_state để xem trạng thái cảnh báo CO.

Giá trị Sự miêu tả
ok Hoạt động binh thương
warning Phát hiện nồng độ CO tăng
emergency Mức CO quá cao, người dùng nên ra khỏi nhà

Báo động khói

Sử dụng trường smoke_alarm_state để xem trạng thái báo động khói.

Giá trị Sự miêu tả
ok Hoạt động binh thương
warning Phát hiện nồng độ khói tăng
emergency Khói quá cao, người dùng nên ra khỏi nhà

Kiểm tra thủ công

Sử dụng các trường này để kiểm tra xem thử nghiệm khói hoặc CO thủ công hiện đang hoạt động chưa và lần cuối cùng thực hiện thử nghiệm khói hoặc CO thành công.

Trạng thái màu UI

Để giúp thiết kế giao diện người dùng chéo sản phẩm dễ dàng hơn, chúng tôi đã cung cấp trường ui_color_state , cung cấp chỉ báo cấp cao về trạng thái chung của Nest Protect. Nó có nguồn gốc từ is_online , battery_health , co_alarm_statesmoke_alarm_state , cung cấp một điều kiện tổng hợp phản ánh các chỉ số màu thực tế được hiển thị trong ứng dụng Nest .

Thông báo lỗi

Để biết thông tin về lỗi gọi API nghĩa là gì và cách xử lý chúng, hãy xem Thông báo lỗi .