สคีมาระดับเสียงของบ้านอัจฉริยะ
action.devices.traits.Volume
- ลักษณะเฉพาะนี้เป็นของอุปกรณ์ที่ปรับระดับเสียงได้ (เช่น ตั้งระดับเสียงเป็นระดับ ปิดเสียง หรือเปิดเสียง)
แอตทริบิวต์อุปกรณ์
อุปกรณ์ที่มีลักษณะเฉพาะนี้อาจรายงานแอตทริบิวต์ต่อไปนี้เป็นส่วนหนึ่งของการดําเนินการ SYNC
ดูข้อมูลเพิ่มเติมเกี่ยวกับการจัดการ Intent ของ SYNC
ได้ที่การดําเนินการตามความตั้งใจ
แอตทริบิวต์ | ประเภท | คำอธิบาย |
---|---|---|
volumeMaxLevel |
จำนวนเต็ม |
ต้องระบุ ระดับเสียงสูงสุดสมมติว่าเป็นฐาน 0 (ปิดเสียง) Assistant จะปรับคําสั่งอ่านออกเสียง (เช่น "ทําให้ทีวีดังขึ้นหน่อย") ตามความเหมาะสม |
volumeCanMuteAndUnmute |
บูลีน |
ต้องระบุ ระบุว่าอุปกรณ์จะปิดและเปิดเสียงได้หรือไม่ การปิดเสียงเป็นตัวเลือกแยกต่างหากเนื่องจากลักษณะการทํางาน "ปิดเสียง" จะมีระดับเสียงเป็น 0 ในขณะที่จําระดับเสียงก่อนหน้าเพื่อให้การเปิดเสียงกู้คืน การดําเนินการนี้จะแสดงสถานะระดับเสียง หากระดับเสียงเป็น 5 และผู้ใช้ปิดเสียง ระดับเสียงจะยังคงเป็น 5 และ |
volumeDefaultPercentage |
จำนวนเต็ม |
(ค่าเริ่มต้น: ระดับเสียง (เป็นเปอร์เซ็นต์) ของระดับเสียงเริ่มต้นที่กําหนดโดยผู้ใช้หรือผู้ผลิต สเกลต้องเป็น 0-100 |
levelStepSize |
จำนวนเต็ม |
(ค่าเริ่มต้น: ขนาดขั้นตอนเริ่มต้นสําหรับการค้นหาปริมาณสัมพัทธ์ เช่น "เพิ่มระดับเสียงใน <device_name>" |
commandOnlyVolume |
บูลีน |
(ค่าเริ่มต้น: ระบุว่าอุปกรณ์ทํางานโดยใช้การสื่อสารทางเดียว (จริง) หรือสองทาง (เท็จ) เช่น หากตัวควบคุมยืนยันสถานะอุปกรณ์ใหม่หลังจากส่งคําขอได้ ช่องนี้จะเป็นเท็จ หากยืนยันไม่ได้ว่าได้ดําเนินการคําขอสําเร็จหรือรับสถานะของอุปกรณ์ (เช่น หากอุปกรณ์เป็นรีโมตอินฟราเรดแบบดั้งเดิม) ให้ตั้งค่าช่องนี้เป็น "จริง" |
ตัวอย่าง
อุปกรณ์ลําโพงที่ปิดเสียงได้และรายงานสถานะปัจจุบัน
{ "volumeMaxLevel": 11, "volumeCanMuteAndUnmute": true, "levelStepSize": 2, "commandOnlyVolume": false, "volumeDefaultPercentage": 6 }
สถานะอุปกรณ์
เอนทิตีที่มีลักษณะเฉพาะนี้อาจรายงานสถานะต่อไปนี้เป็นส่วนหนึ่งของการดําเนินการ QUERY
ดูข้อมูลเพิ่มเติมเกี่ยวกับการจัดการ Intent ของ QUERY
ได้ที่การดําเนินการตามความตั้งใจ
รัฐ | ประเภท | คำอธิบาย |
---|---|---|
currentVolume |
จำนวนเต็ม |
ต้องระบุ เปอร์เซ็นต์ปริมาณปัจจุบัน ต้องอยู่ระหว่าง |
isMuted |
บูลีน |
ต้องระบุหากตั้งค่าแอตทริบิวต์ |
ตัวอย่าง
อุปกรณ์ลําโพงที่ปิดเสียงได้และรายงานสถานะปัจจุบัน
{ "currentVolume": 5, "isMuted": false }
คําสั่งของอุปกรณ์
อุปกรณ์ที่มีลักษณะเฉพาะนี้อาจตอบสนองต่อคําสั่งต่อไปนี้ซึ่งเป็นส่วนหนึ่งของการดําเนินการ EXECUTE
ดูข้อมูลเพิ่มเติมเกี่ยวกับการจัดการ Intent ของ EXECUTE
ได้ที่การดําเนินการตามความตั้งใจ
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
เมื่อระดับเสียงเบาที่สุดแล้ว