สคีมาลักษณะเฉพาะของระดับเสียงสมาร์ทโฮม

action.devices.traits.Volume - ลักษณะนี้เป็นของอุปกรณ์ที่เปลี่ยนระดับเสียงได้ (เช่น ตั้งระดับเสียงเป็นระดับหนึ่งๆ ปิดเสียง หรือเปิดเสียง)

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

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

Attributes	ประเภท	คำอธิบาย
volumeMaxLevel	จำนวนเต็ม	ต้องระบุ ระดับเสียงสูงสุด โดยใช้เกณฑ์พื้นฐานเป็น 0 (ปิดเสียง) Assistant จะปรับคำสั่งที่เป็นคำกริยา (เช่น "ทำให้ทีวีดังขึ้นเล็กน้อย") ให้สอดคล้องกัน
volumeCanMuteAndUnmute	บูลีน	ต้องระบุ บ่งบอกว่าอุปกรณ์ปิดเสียงและเปิดเสียงได้หรือไม่ การปิดเสียงคือตัวเลือก "ปิดเสียง" แยกต่างหาก ลักษณะการทำงานจะทำให้ระดับเสียงเป็น 0 ขณะจำระดับเสียงก่อนหน้า เพื่อให้การเปิดเสียงคืนค่าระดับเสียงนั้น ซึ่งจะแสดงในสถานะระดับเสียง หากระดับเสียงคือ 5 และผู้ใช้ปิดเสียงอยู่ ระดับเสียงจะยังคงเป็น 5 และ isMuted จะเป็นจริง
volumeDefaultPercentage	จำนวนเต็ม	(ค่าเริ่มต้น: 40) ระดับเสียง (เป็นเปอร์เซ็นต์) ของปริมาณเริ่มต้นที่กำหนดโดยผู้ใช้หรือผู้ผลิต สเกลต้องเป็น 0-100
levelStepSize	จำนวนเต็ม	(ค่าเริ่มต้น: 1) ขนาดขั้นตอนเริ่มต้นสำหรับการค้นหาระดับเสียงสัมพัทธ์ เช่น "เพิ่มระดับเสียงใน <device_name>
commandOnlyVolume	บูลีน	(ค่าเริ่มต้น: false) ระบุว่าอุปกรณ์ทำงานโดยใช้การสื่อสารแบบทางเดียว (จริง) หรือ 2 ทาง (เท็จ) ตัวอย่างเช่น หากตัวควบคุมยืนยันสถานะของอุปกรณ์ใหม่ได้หลังจากส่งคำขอ ช่องนี้จะเป็น "เท็จ" หากไม่สามารถยืนยันได้ว่าคำขอดำเนินการสำเร็จหรือขอสถานะของอุปกรณ์ (เช่น หากอุปกรณ์เป็นรีโมตอินฟราเรดแบบดั้งเดิม) ให้ตั้งค่าช่องนี้เป็น "จริง"

ตัวอย่าง

อุปกรณ์ลำโพงที่ปิดเสียงได้และรายงานสถานะปัจจุบันของได้

{
  "volumeMaxLevel": 11,
  "volumeCanMuteAndUnmute": true,
  "levelStepSize": 2,
  "commandOnlyVolume": false,
  "volumeDefaultPercentage": 6
}

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

เอนทิตีที่มีลักษณะนี้อาจรายงานสิ่งต่อไปนี้ สถานะเป็นส่วนหนึ่งของการดำเนินการ QUERY เพื่อเรียนรู้ ดูข้อมูลเพิ่มเติมเกี่ยวกับการจัดการ Intent QUERY ได้ที่ การจำหน่าย Intent

รัฐ	ประเภท	คำอธิบาย
currentVolume	จำนวนเต็ม	ต้องระบุ เปอร์เซ็นต์ระดับเสียงปัจจุบัน ค่านี้ต้องอยู่ระหว่าง >0 ถึง volumeMaxLevel
isMuted	บูลีน	ต้องระบุหากตั้งค่าแอตทริบิวต์ volumeCanMuteAndUnmute เป็น "จริง" เป็นจริงหากอุปกรณ์ปิดเสียงอยู่ เท็จ หากไม่เป็นเช่นนั้น หาก isMuted เป็นจริง อุปกรณ์จะยังคงแสดงผล currentVolume ในจุดที่จดจำไว้

ตัวอย่าง

อุปกรณ์ลำโพงที่ปิดเสียงได้และรายงานสถานะปัจจุบันของได้

{
  "currentVolume": 5,
  "isMuted": false
}

คำสั่งอุปกรณ์

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

action.devices.commands.mute

ปิดหรือเปิดเสียงอุปกรณ์

พารามิเตอร์

พารามิเตอร์	ประเภท	คำอธิบาย
mute	บูลีน	ต้องระบุ ปิดเสียงอุปกรณ์หรือเปิดเสียงอุปกรณ์

ตัวอย่าง

ปิดเสียงอุปกรณ์ลำโพง

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

action.devices.commands.setVolume

ตั้งระดับเสียงเป็นระดับที่ขอ โดยอิงตาม volumeMaxLevel

พารามิเตอร์

พารามิเตอร์	ประเภท	คำอธิบาย
volumeLevel	จำนวนเต็ม	ต้องระบุ ชุดใหม่ จาก 0 ถึง volumeMaxLevel

ตัวอย่าง

ตั้งระดับเสียงสัมบูรณ์ของอุปกรณ์ลำโพง

{
  "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
  }
}

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

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

• volumeAlreadyMax: อุปกรณ์จะได้รับคำสั่ง VolumeUp เมื่อ ที่ระดับเสียงสูงสุดแล้ว
• volumeAlreadyMin: อุปกรณ์จะได้รับคำสั่ง VolumeDown เมื่อ ที่ระดับเสียงต่ำสุดแล้ว