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

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

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

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

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

แอตทริบิวต์ Type คำอธิบาย
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

รัฐ Type คำอธิบาย
currentVolume จำนวนเต็ม

ต้องระบุ

เปอร์เซ็นต์ปริมาณในปัจจุบัน ต้องอยู่ระหว่าง >0 ถึง volumeMaxLevel

isMuted บูลีน

ต้องระบุหากแอตทริบิวต์ volumeCanMuteAndUnmute ตั้งค่าเป็น "จริง" จริง หากปิดเสียงอุปกรณ์ไว้ จะเป็น "เท็จ" หากไม่เป็นเช่นนั้น หาก isMuted เป็นจริง อุปกรณ์จะยังแสดงผล currentVolume สําหรับจุดที่คุณจําได้

ตัวอย่าง

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

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

อุปกรณ์ COMMANDS

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

action.devices.commands.mute

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

พารามิเตอร์

พารามิเตอร์ Type คำอธิบาย
mute บูลีน

ต้องระบุ

เลือกว่าจะปิดเสียงอุปกรณ์หรือเปิดเสียงอุปกรณ์

ตัวอย่าง

ปิดเสียงลําโพง

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

action.devices.commands.setVolume

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

พารามิเตอร์

พารามิเตอร์ Type คำอธิบาย
volumeLevel จำนวนเต็ม

ต้องระบุ

ชุดใหม่ จาก 0 ถึง volumeMaxLevel

ตัวอย่าง

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

{
  "command": "action.devices.commands.setVolume",
  "params": {
    "volumeLevel": 6
  }
}

action.devices.commands.volumeRelative

ตั้งค่าระดับเสียงn ขึ้นหรือลงโดยอิงตาม volumeMaxLevel สําหรับคําสั่งที่ใช้สเกลแบบสัมพัทธ์ Assistant จะเลือก n อย่างเหมาะสมเพื่อปรับขนาดตามก้าวที่มีอยู่ ตัวอย่างเช่น ทําให้ทีวีดังขึ้นมากจะตั้งขั้นตอนเป็นจํานวนมากกว่าการทําให้ทีวีดังขึ้นเล็กน้อย

พารามิเตอร์

พารามิเตอร์ Type คำอธิบาย
relativeSteps จำนวนเต็ม

ต้องระบุ

เชิงลบสําหรับ "ลดลง"

ตัวอย่าง

ตั้งระดับเสียงสัมพัทธ์ของอุปกรณ์ลําโพงในโหมดเฉพาะคําสั่ง

{
  "command": "action.devices.commands.volumeRelative",
  "params": {
    "relativeSteps": -1
  }
}

อุปกรณ์ ERRORS

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