สคีมาลักษณะเฉพาะของบ้านอัจฉริยะ

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) ระบุว่าอุปกรณ์ดําเนินการโดยใช้การสื่อสารแบบทางเดียว (จริง) หรือสองทาง (เท็จ) เช่น หากตัวควบคุมยืนยันสถานะอุปกรณ์ใหม่หลังจากส่งคําขอได้ ช่องนี้จะเป็นเท็จ หากยืนยันไม่ได้ว่าคําขอดําเนินการสําเร็จหรือรับข้อมูลสถานะของอุปกรณ์ (เช่น หากอุปกรณ์เป็นรีโมตอินฟราเรดแบบดั้งเดิม) ให้ตั้งค่าช่องนี้เป็น "จริง"

ตัวอย่าง

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

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

อุปกรณ์ STATES

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

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

ตัวอย่าง

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

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