สัญญาณเตือนควันและคาร์บอนมอนอกไซด์

สัญญาณเตือนควันและคาร์บอนมอนอกไซด์

Nest Protect ออกแบบมาเพื่อตรวจจับควันและคาร์บอนมอนอกไซด์ (CO) ในสภาพแวดล้อมที่อยู่อาศัย โดยมีเซ็นเซอร์หลายตัวที่ช่วยให้เข้าใจสิ่งที่เกิดขึ้นในบ้าน

Nest API ให้สิทธิ์เข้าถึงข้อมูลต่อไปนี้ใน Nest Protect

  • สถานะสัญญาณเตือนควันหรือคาร์บอนมอนอกไซด์ (CO)
  • สถานะแบตเตอรี่
  • สถานะการทดสอบด้วยตนเองและการประทับเวลาล่าสุด
  • สถานะออนไลน์และข้อมูลการเชื่อมต่อล่าสุด
  • โครงสร้างและชื่อของอุปกรณ์

สิทธิ์เกี่ยวกับควันและคาร์บอนมอนอกไซด์

หากต้องการสิทธิ์การอ่านค่าข้อมูล Smoke+CO API ของ Smoke+CO ทั้งหมด ให้เลือกสิทธิ์Smoke+CO สําหรับไคลเอ็นต์

ไม่มีสิทธิ์การเขียนสําหรับ Smoke+CO Alert API

ตัวระบุควันและคาร์บอนมอนอกไซด์

อุปกรณ์

อุปกรณ์ Nest จะแสดงตามประเภทเป็นอาร์เรย์ของรหัสที่ใช้ระบุอุปกรณ์ได้โดยไม่ซ้ํากันผ่านเส้นทางอุปกรณ์ ดังนั้น รหัสสัญญาณเตือนควัน+co ของ "RTMTKxs..." จึงช่วยให้คุณโหลดโมเดลอุปกรณ์ตรวจจับควันและco ที่ devices/smoke_co_alarms/RTMTKxs... ผ่าน API

เมื่ออุปกรณ์เชื่อมต่อกับผลิตภัณฑ์หลายรายการ นักพัฒนาแอปแต่ละรายจะเห็นรหัสที่แตกต่างกันสําหรับอุปกรณ์นั้น สําหรับอุปกรณ์ที่ติดตั้งผลิตภัณฑ์หลายรายการจากนักพัฒนาซอฟต์แวร์คนเดียวกัน นักพัฒนาแอปจะเห็นรหัสเดียวกัน

ชื่อ

ระบุแอตทริบิวต์ชื่อ 2 รายการ แอตทริบิวต์ name แบบสั้นจะแสดงในป้ายกํากับอินเทอร์เฟซผู้ใช้ ส่วน name_long จะใช้ในข้อความแบบยาว

name

ในตัวอย่างนี้ name คือ "Nest Protect"

ชื่อ

name_long

ในตัวอย่างนี้ name_long คือ "Base Protect ของ Nest"

ชื่อยาว

สถานที่

where_id

  • ตัวระบุที่ไม่ซ้ํากันและสร้างขึ้น Nest ที่เป็นตัวแทนของ name
  • where_id เป็นแบบอ่านอย่างเดียวและจะสร้างขึ้นโดยอัตโนมัติในการโทรเพื่อสร้างค่าที่กําหนดเอง โดยที่ name

ดูข้อมูลเพิ่มเติมเกี่ยวกับชื่อของ Nest Thermostat, Nest Protect และ Nest Cam

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 ระดับแบตเตอรี่ OK
replace ระดับแบตเตอรี่อ่อนควรเปลี่ยนใหม่

สัญญาณเตือนคาร์บอนมอนอกไซด์

ใช้ช่อง co_alarm_state เพื่อดูสถานะสัญญาณเตือนคาร์บอนมอนอกไซด์

ค่า คำอธิบาย
ok การดําเนินการปกติ
warning การตรวจหาระดับ CO ที่เพิ่มขึ้น
emergency ระดับ CO สูงเกินไป ผู้ใช้ควรออกจากบ้าน

สัญญาณเตือนควัน

ใช้ช่อง smoke_alarm_state เพื่อดูสถานะสัญญาณเตือนควัน

ค่า คำอธิบาย
ok การดําเนินการปกติ
warning การตรวจหาระดับควันที่เพิ่มขึ้น
emergency ระดับควันสูงเกินไป ผู้ใช้ควรออกจากบ้าน

การทดสอบด้วยตนเอง

ใช้ช่องเหล่านี้เพื่อตรวจสอบว่าการทดสอบควันหรือคาร์บอนมอนอกไซด์ด้วยตนเองทํางานอยู่หรือไม่ และครั้งล่าสุดได้ทําการทดสอบควันหรือคาร์บอนมอนอกไซด์สําเร็จ

สถานะสี UI

เราได้จัดเตรียมช่อง ui_color_state ที่บ่งบอกสถานะโดยรวมของ Nest Protect ในระดับสูงเพื่อให้ออกแบบ UI แบบข้ามผลิตภัณฑ์ให้สอดคล้องกันได้ง่ายขึ้น ข้อมูลนี้มาจาก is_online, battery_health, co_alarm_state และ smoke_alarm_state ซึ่งให้เงื่อนไขรวมที่สะท้อนให้เห็นตัวบ่งชี้สีจริงที่แสดงในแอป Nest

ข้อความแสดงข้อผิดพลาด

ดูข้อมูลเกี่ยวกับความหมายของการเรียก API และวิธีจัดการข้อผิดพลาดได้ที่ข้อความแสดงข้อผิดพลาด