Google cam kết thúc đẩy công bằng chủng tộc cho Cộng đồng người da đen. Xem cách thực hiện.

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ột môi trường khu 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à.

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

  • Trạng thái cảnh báo khói hoặc carbon monoxide (CO)
  • Trạng thái sức khỏe của pin
  • Trạng thái kiểm tra thủ công cuối cùng 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ị "tên ở đâu" (vị trí trong nhà)

Quyền Smoke + CO

Để truy cập đọc cho tất cả khói + CO giá trị dữ liệu API báo thức, chọn khói + CO đọc phép 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 Smoke + CO

Thiết bị

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, một khói + đồng ID báo động của "RTMTKxs..." có nghĩa là bạn có thể tải khói + đồng mô hình thiết bị báo động tại devices/smoke_co_alarms/RTMTKxs... 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. Ngắn hơn name thuộc tính được hiển thị trong giao diện người dùng nhãn, 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 Nest Protect".

Tên dài

Ở đâu

where_id

  • Một độc đáo, định danh Nest tạo đại diện cho name
  • where_id là read-only, và được tạo ra tự động trong các cuộc gọi để tạo ra một phong tục nơi name

Tìm hiểu thêm về nơi tên cho nhiệt Nest ,Nest Bảo vệNest Cams .

where_name

Khi bạn chọn khói + CO quyền đọc , bạn có thể truy cập vào thiết bị where_name từ đối tượng thiết bị ( 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 chỉ định khác.

Giá trị dữ liệu Sự miêu tả
locale Ngôn ngữ và mã quốc gia được chỉ định 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 lần kết nối thành công gần đây nhất với dịch vụ Nest
is_online Trạng thái trực tuyến. Đây được xác định bởi Nest sử dụng last_connection thời gian và một cửa sổ kết nối lại dự kiến đó là thiết bị cụ thể.

Tính năng Smoke + CO

Tình trạng pin

Sử dụng các battery_health lĩnh vực để xem tình trạng sức khỏe của pin.

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

Báo động CO

Sử dụng các co_alarm_state lĩnh vực để xem tình trạng báo động CO.

Giá trị Sự miêu tả
ok Hoạt động binh thương
warning Phát hiện mức 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 các smoke_alarm_state lĩnh vực để xem tình trạng báo động khói.

Giá trị Sự miêu tả
ok Hoạt động binh thương
warning Phát hiện mức độ khói tăng
emergency Mức 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, và lần cuối cùng một thử nghiệm khói hoặc CO thành công đã được thực hiện.

Trạng thái màu giao diện người dùng

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

Thông báo lỗi

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