ยินดีต้อนรับสู่ Google Home Developer Center แหล่งใหม่เรียนรู้วิธีพัฒนาการดําเนินการในบ้านอัจฉริยะ หมายเหตุ: คุณจะสร้างการดําเนินการต่างๆ ต่อไปในคอนโซลการดําเนินการ
จัดทุกอย่างให้เป็นระเบียบอยู่เสมอด้วยคอลเล็กชัน บันทึกและจัดหมวดหมู่เนื้อหาตามค่ากำหนดของคุณ

สคีมาของโหมด Smart Home

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

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

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

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

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

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

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

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

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

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

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

แอตทริบิวต์ ประเภท คำอธิบาย
sceneReversible บูลีน

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

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

ตัวอย่าง

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

{
  "sceneReversible": true
}

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

ไม่มี

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

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

action.devices.commands.ActivateScene

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

พารามิเตอร์

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

ต้องระบุ

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

ตัวอย่าง

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

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

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

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

อุปกรณ์ ERRORS

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