สคีมาลักษณะฉากสมาร์ทโฮม

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

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

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

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

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

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

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

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

ฉากควรมีชื่อที่ผู้ใช้ระบุเสมอ แทนที่จะใช้ชื่อ "ฉาก BobCo" ที่เป็นค่าเริ่มต้น แต่ละฉากเป็นอุปกรณ์เสมือนจริงของตัวเองที่มีชื่อเป็นของตัวเอง ชื่อที่ผู้ใช้ระบุอาจมาจาก 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
  }
}

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

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