สคีมาระดับเสียงของบ้านอัจฉริยะ

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

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

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

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

ตัวอย่าง

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

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

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

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

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

ตัวอย่าง

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

{
  "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	จำนวนเต็ม	ต้องระบุ ระดับเสียงใหม่ ตั้งแต่ 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
  }
}

อุปกรณ์ ERRORS

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

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