สคีมาลักษณะเฉพาะของบ้านอัจฉริยะ
action.devices.traits.Volume
- ลักษณะนี้เป็นของอุปกรณ์ที่ปรับระดับเสียงได้ (เช่น การตั้งระดับเสียงไปที่ระดับหนึ่ง ปิดเสียง หรือเปิดเสียง)
แอตทริบิวต์ของอุปกรณ์
อุปกรณ์ที่มีลักษณะเฉพาะนี้อาจรายงานแอตทริบิวต์ต่อไปนี้เป็นส่วนหนึ่งของการดําเนินการ SYNC
หากต้องการดูข้อมูลเพิ่มเติมเกี่ยวกับการจัดการ Intent ของ SYNC
โปรดดูการดําเนินการ Intent
Attributes | ประเภท | คำอธิบาย |
---|---|---|
volumeMaxLevel |
จำนวนเต็ม |
ต้องระบุ ระดับเสียงสูงสุด โดยมีเกณฑ์พื้นฐานเป็น 0 (ปิดเสียง) Assistant จะปรับคํากริยา (เช่น "ทําให้ทีวีเสียงดังขึ้นเล็กน้อย") ตามความเหมาะสม |
volumeCanMuteAndUnmute |
บูลีน |
ต้องระบุ ระบุว่าอุปกรณ์จะปิดและเปิดเสียงได้หรือไม่ ปิดเสียงเป็นตัวเลือกแยกต่างหากเนื่องจากลักษณะการทํางาน "ปิดเสียง" ใช้ระดับเสียงไปที่ 0 ขณะจําระดับเสียงก่อนหน้านี้เพื่อให้การเปิดเสียงกลับมาดังเดิม การดําเนินการนี้จะแสดงสถานะระดับเสียง หากระดับเสียงอยู่ที่ 5 และผู้ใช้ปิดเสียง ระดับเสียงจะยังคงเป็น 5 และ |
volumeDefaultPercentage |
จำนวนเต็ม |
(ค่าเริ่มต้น: ระดับเสียง (เป็นเปอร์เซ็นต์) ของระดับเสียงเริ่มต้นที่กําหนดโดยผู้ใช้หรือผู้ผลิต สเกลต้องเป็น 0-100 |
levelStepSize |
จำนวนเต็ม |
(ค่าเริ่มต้น: ขนาดขั้นตอนเริ่มต้นสําหรับการค้นหาวอลุ่มสัมพัทธ์ เช่น "เพิ่มระดับเสียงใน <device_name>" |
commandOnlyVolume |
บูลีน |
(ค่าเริ่มต้น: ระบุว่าอุปกรณ์ดําเนินการโดยใช้การสื่อสารแบบทางเดียว (จริง) หรือสองทาง (เท็จ) เช่น หากตัวควบคุมยืนยันสถานะอุปกรณ์ใหม่หลังจากส่งคําขอได้ ช่องนี้จะเป็นเท็จ หากยืนยันไม่ได้ว่าคําขอดําเนินการสําเร็จหรือรับข้อมูลสถานะของอุปกรณ์ (เช่น หากอุปกรณ์เป็นรีโมตอินฟราเรดแบบดั้งเดิม) ให้ตั้งค่าช่องนี้เป็น "จริง" |
ตัวอย่าง
อุปกรณ์ลําโพงที่ปิดเสียงและรายงานสถานะปัจจุบันได้
{ "volumeMaxLevel": 11, "volumeCanMuteAndUnmute": true, "levelStepSize": 2, "commandOnlyVolume": false, "volumeDefaultPercentage": 6 }
อุปกรณ์ STATES
เอนทิตีที่มีลักษณะนี้อาจรายงานสถานะต่อไปนี้เป็นส่วนหนึ่งของการดําเนินการ QUERY
หากต้องการดูข้อมูลเพิ่มเติมเกี่ยวกับการจัดการ Intent ของ QUERY
โปรดดูการดําเนินการ Intent
รัฐ | ประเภท | คำอธิบาย |
---|---|---|
currentVolume |
จำนวนเต็ม |
ต้องระบุ เปอร์เซ็นต์ปริมาณในปัจจุบัน ต้องอยู่ระหว่าง |
isMuted |
บูลีน |
ต้องระบุหากแอตทริบิวต์ |
ตัวอย่าง
อุปกรณ์ลําโพงที่ปิดเสียงและรายงานสถานะปัจจุบันได้
{ "currentVolume": 5, "isMuted": false }
อุปกรณ์ COMMANDS
อุปกรณ์ที่มีลักษณะเฉพาะนี้อาจตอบสนองต่อคําสั่งต่อไปนี้ในฐานะส่วนหนึ่งของการดําเนินการ EXECUTE
หากต้องการดูข้อมูลเพิ่มเติมเกี่ยวกับการจัดการ Intent ของ EXECUTE
โปรดดูการดําเนินการ Intent
action.devices.commands.mute
ปิดหรือเปิดเสียงอุปกรณ์
พารามิเตอร์
พารามิเตอร์ | ประเภท | คำอธิบาย |
---|---|---|
mute |
บูลีน |
ต้องระบุ เลือกว่าจะปิดเสียงอุปกรณ์หรือเปิดเสียงอุปกรณ์ |
ตัวอย่าง
ปิดเสียงลําโพง
{ "command": "action.devices.commands.mute", "params": { "mute": true } }
action.devices.commands.setVolume
ปรับระดับเสียงเป็นระดับที่ต้องการตาม volumeMaxLevel
พารามิเตอร์
พารามิเตอร์ | ประเภท | คำอธิบาย |
---|---|---|
volumeLevel |
จำนวนเต็ม |
ต้องระบุ ชุดใหม่ จาก |
ตัวอย่าง
ตั้งระดับเสียงสัมบูรณ์ของอุปกรณ์ลําโพง
{ "command": "action.devices.commands.setVolume", "params": { "volumeLevel": 6 } }
action.devices.commands.volumeRelative
ตั้งค่าระดับเสียงn ขึ้นหรือลงโดยอิงตาม volumeMaxLevel
สําหรับคําสั่งที่ใช้สเกลแบบสัมพัทธ์ Assistant จะเลือก n อย่างเหมาะสมเพื่อปรับขนาดตามก้าวที่มีอยู่ ตัวอย่างเช่น ทําให้ทีวีดังขึ้นมากจะตั้งขั้นตอนเป็นจํานวนมากกว่าการทําให้ทีวีดังขึ้นเล็กน้อย
พารามิเตอร์
พารามิเตอร์ | ประเภท | คำอธิบาย |
---|---|---|
relativeSteps |
จำนวนเต็ม |
ต้องระบุ เชิงลบสําหรับ "ลดลง" |
ตัวอย่าง
ตั้งระดับเสียงสัมพัทธ์ของอุปกรณ์ลําโพงในโหมดเฉพาะคําสั่ง
{ "command": "action.devices.commands.volumeRelative", "params": { "relativeSteps": -1 } }
อุปกรณ์ ERRORS
ดูรายการข้อผิดพลาดและข้อยกเว้นทั้งหมดvolumeAlreadyMax
: อุปกรณ์จะได้รับคําสั่งVolumeUp
เมื่อมีระดับเสียงสูงสุดอยู่แล้วvolumeAlreadyMin
: อุปกรณ์จะได้รับคําสั่งVolumeDown
เมื่อมีระดับเสียงต่ําสุดอยู่แล้ว