ยินดีต้อนรับสู่ Google Home Developer Center แหล่งใหม่เรียนรู้วิธีพัฒนาการดําเนินการในบ้านอัจฉริยะ หมายเหตุ: คุณจะสร้างการดําเนินการต่างๆ ต่อไปในคอนโซลการดําเนินการ
จัดทุกอย่างให้เป็นระเบียบอยู่เสมอด้วยคอลเล็กชัน บันทึกและจัดหมวดหมู่เนื้อหาตามค่ากำหนดของคุณ

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

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 เมื่อระดับเสียงเบาที่สุดแล้ว