ลักษณะเฉพาะ

ลักษณะใน SDM API ประกอบด้วยฟิลด์ คําสั่ง และเหตุการณ์

ช่อง

ฟิลด์คือค่าที่มีประเภทข้อมูลทั่วไป เช่น ตัวเลขหรือสตริง เช่น ฟิลด์หนึ่งๆ อาจประกอบด้วยโหมดปัจจุบันหรือความชื้นสัมพัทธ์ของ Google Nest Thermostat

คุณดูลักษณะและช่องได้ด้วยGETการเรียกใช้ปลายทาง API ที่ต้องการ ดังนี้

GET /enterprises/project-id/devices/device-id
{
  "name" : "enterprises/project-id/devices/device-id",
  "type" : "sdm.devices.types.device-type",
  "traits" : { ... },
  "parentRelations" : [
    {
      "parent" : "enterprises/project-id/structures/structure-id/rooms/room-id",
      "displayName" : "Lobby"
    }
  ]
}

ประเภทอุปกรณ์

คุณไม่ควรใช้ sdm.devices.types.device-type ที่ SDM API แสดงผลเพื่ออนุมานหรือตีความฟังก์ชันการทำงานของอุปกรณ์จริงที่กำหนดไว้ เราไม่รับประกันว่าประเภทอุปกรณ์จะยังคงทำงานได้อย่างเสถียรสำหรับอุปกรณ์หนึ่งๆ เมื่อมีการเพิ่มฟีเจอร์ลงใน SDM API ให้ใช้ลักษณะที่แสดงผลสำหรับอุปกรณ์แทน

parentRelations

ออบเจ็กต์ parentRelations แสดงถึงทรัพยากรหลักของทรัพยากรปัจจุบัน ไม่ว่าจะเป็นโครงสร้างหรือห้อง ชื่อที่แสดงสอดคล้องกับช่อง customName ของ Info trait สําหรับอุปกรณ์ที่มีโครงสร้างหลัก หรือRoomInfo trait สําหรับอุปกรณ์ที่มีห้องหลัก

คำสั่ง

คําสั่งคือคําขอที่เชื่อมโยงกับลักษณะ เช่น การเปลี่ยนโหมดปัจจุบันหรืออุณหภูมิที่ต้องการให้ตัวควบคุมรักษาไว้บน Google Nest Thermostat

คำสั่งที่ส่งโดยการเรียก executeCommand API

POST /enterprises/project-id/devices/device-id:executeCommand
{
  "command" : "command-name",
  "params" : {
    "field" : "value"
  }
}

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

กิจกรรม

เหตุการณ์เป็นแบบไม่พร้อมกันและจัดการโดย Google Cloud Pub/Sub ในหัวข้อเดียวต่อ Project รหัส

ระบบจะส่งเหตุการณ์โดยค่าเริ่มต้นเมื่อมีการเปลี่ยนแปลงค่าของช่องลักษณะ นอกจากนี้ ระบบยังอาจส่งการแจ้งเตือนเพื่อตอบสนองต่อการดำเนินการบางอย่างของอุปกรณ์หรือการเปลี่ยนแปลงในการมอบหมายทรัพยากร ดูข้อมูลเพิ่มเติมในเหตุการณ์

หมวดหมู่ลักษณะ

โครงสร้าง

อุปกรณ์

ตัวควบคุมอุณหภูมิ

กล้อง

กริ่งประตู