สคีมา Smart Home Scene Trait

action.devices.traits.Scene - ลักษณะเฉพาะนี้ ให้นําอุปกรณ์เสมือนมาใช้พร้อมกับประเภทอุปกรณ์ SCENE

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

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

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

คุณวางฉากในห้อง (หากเกี่ยวข้อง) เพื่อใส่คําอธิบายได้ดังนี้

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

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

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

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

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

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

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

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

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

ตัวอย่าง

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

{
  "sceneReversible": true
}

อุปกรณ์ STATES

ไม่ต้องแจ้งเตือนเลย

อุปกรณ์ COMMANDS

อุปกรณ์ที่มีลักษณะเฉพาะนี้อาจตอบสนองต่อคําสั่งต่อไปนี้ในฐานะส่วนหนึ่งของการดําเนินการ 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
  }
}

อุปกรณ์ ERRORS

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