สคีมาลักษณะเฉพาะของฉากสมาร์ทโฮม

action.devices.traits.Scene - ลักษณะนี้จะใช้เพื่อติดตั้งใช้งานอุปกรณ์เสมือนร่วมกับประเภทอุปกรณ์ SCENE

ดูข้อมูลเพิ่มเติมได้ที่คู่มือประเภทฉาก

ตัวอย่างเช่น หากอุปกรณ์อนุญาตให้ผู้ใช้กำหนดค่าการจัดกลุ่มตามคำสั่งได้ด้วยการแตะเพียงครั้งเดียว เช่น การตั้งค่าแสงไฟเป็นสีเฉพาะ หรือจัดลำดับฟีเจอร์ด้านความปลอดภัยต่างๆ หรือกิจกรรมอื่นๆ ผสมกัน การกำหนดค่านี้จะเปิดเผยผ่าน SYNC เป็นโหมดที่มีชื่อ และ Assistant จะให้ผู้ใช้ใช้งานโหมดเหล่านี้ผ่านไวยากรณ์แบบง่ายๆ ได้

  • เริ่มโหมดปาร์ตี้
  • เปิดใช้งานฉากเที่ยงคืน

เนื่องจากเป็นวัตถุเสมือน คุณจึงวางฉากในห้อง (หากเกี่ยวข้อง) เพื่อชี้แจงได้ ดังนี้

  • เริ่มปาร์ตี้ในห้องครัว
  • เปิดใช้งานโหมดแสงตอนกลางคืนในห้องนอน

ความแตกต่างอย่างหนึ่งระหว่างฉากและเป้าหมายทางกายภาพคือ Assistant จะใช้เอฟเฟกต์พหูพจน์กับคำสั่งของฉากโดยอัตโนมัติ ซึ่งช่วยให้ผู้ใช้เรียกใช้ฉากผ่านพาร์ทเนอร์หลายรายได้ เช่น หากผู้ใช้มีฉาก "ปาร์ตี้โหมด" ในพาร์ทเนอร์ 2 รายที่แตกต่างกัน โดย 1 รายสำหรับการรักษาความปลอดภัยและอีก 1 รายสำหรับไฟ เปิดใช้งานปาร์ตี้โหมดจะทริกเกอร์ทั้ง 2 รายการ

ฉากจะโต้ตอบกับการดำเนินการแบบเป็นส่วนตัวที่กำลังจะเปิดตัวสำหรับไวยากรณ์ที่กำหนดเองได้ดี (เช่น เปิดใช้งานโหมดปาร์ตี้ -> มาเริ่มปาร์ตี้กันเถอะ)

ฉากควรมีชื่อที่ผู้ใช้ระบุเสมอ แทนที่จะเป็นชื่อ "BobCo Scene" ตามค่าเริ่มต้น แต่ละฉากเป็นอุปกรณ์เสมือนจริงที่มีชื่อเป็นของตัวเอง ชื่อที่ผู้ใช้ระบุอาจมาจาก SYNC

แอตทริบิวต์อุปกรณ์

อุปกรณ์ที่มีลักษณะนี้อาจรายงานแอตทริบิวต์ต่อไปนี้ซึ่งเป็นส่วนหนึ่งของการดำเนินการ SYNC ดูข้อมูลเพิ่มเติมเกี่ยวกับการจัดการ Intent SYNC ได้ที่การดำเนินการตาม Intent

Attributes ประเภท คำอธิบาย
sceneReversible บูลีน

(ค่าเริ่มต้น: false)

บ่งบอกว่าฉากนี้ยกเลิกได้ แอตทริบิวต์นี้เกี่ยวข้องกับฉากที่ปรับเปลี่ยนสถานะและจดจำสถานะก่อนหน้าเท่านั้น อุปกรณ์รองรับคำสั่ง ActivateScene ที่พารามิเตอร์ deactivate เป็นจริง

ตัวอย่าง

อุปกรณ์ที่รองรับฉากแบบกลับด้าน

{
  "sceneReversible": true
}

สถานะอุปกรณ์

ไม่มี

คำสั่งของอุปกรณ์

อุปกรณ์ที่มีลักษณะนี้อาจตอบสนองต่อคําสั่งต่อไปนี้ซึ่งเป็นส่วนหนึ่งของการดำเนินการ EXECUTE ดูข้อมูลเพิ่มเติมเกี่ยวกับการจัดการ Intent EXECUTE ได้ที่การดำเนินการตาม Intent

action.devices.commands.ActivateScene

เปิดหรือปิดใช้งานโหมด

พารามิเตอร์

พารามิเตอร์ ประเภท คำอธิบาย
deactivate บูลีน

ต้องระบุ

จริงเพื่อยกเลิกฉากหากยกเลิกได้ เท็จเพื่อเปิดใช้งานฉาก

ตัวอย่าง

เปิดใช้งานโหมดตามชื่อ

{
  "command": "action.devices.commands.ActivateScene",
  "params": {
    "deactivate": false
  }
}

ปิดใช้งานโหมดตามชื่อ

{
  "command": "action.devices.commands.ActivateScene",
  "params": {
    "deactivate": true
  }
}

ข้อผิดพลาดของอุปกรณ์

ดูรายการข้อผิดพลาดและข้อยกเว้นทั้งหมด