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

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

ATTRIBUTES ของอุปกรณ์

อุปกรณ์ที่มีลักษณะเช่นนี้อาจรายงานแอตทริบิวต์ต่อไปนี้ซึ่งเป็นส่วนหนึ่งของการดำเนินการ SYNC ดูข้อมูลเพิ่มเติมเกี่ยวกับการจัดการ Intent SYNC ได้ที่Fulfillment 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 ได้ที่Fulfillment Intent

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

ตัวอย่าง

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

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

COMMANDS ของอุปกรณ์

อุปกรณ์ที่มีลักษณะเช่นนี้อาจตอบสนองต่อคำสั่งต่อไปนี้โดยเป็นส่วนหนึ่งของการดำเนินการ EXECUTE ดูข้อมูลเพิ่มเติมเกี่ยวกับการจัดการ Intent EXECUTE ได้ที่Fulfillment 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 เมื่อมีระดับเสียงต่ำสุดอยู่แล้ว