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

แบบแผนของ Smart Home MediaState

action.devices.traits.MediaState - ลักษณะนี้ใช้สําหรับอุปกรณ์ที่รายงานสถานะสื่อได้

Assistant ใช้ลักษณะเฉพาะของ MediaState เพื่อวัตถุประสงค์ต่อไปนี้

  • หากต้องการทราบว่ากําลังเล่นอะไรในอุปกรณ์แต่ละชิ้น Assistant เป็นผู้เริ่มต้นเล่นหรือไม่ ข้อมูลนี้จะช่วยให้ Assistant เข้าใจความตั้งใจของผู้ใช้ได้ดียิ่งขึ้น เช่น ผู้ใช้จะพูดว่า "หยุดโชว์คืนนี้ชั่วคราว" หากความตั้งใจที่แท้จริงคือ "หยุดอุปกรณ์ที่กําลังเล่นคืนนี้ชั่วคราว"
  • เพื่อความสามารถในการเคลื่อนย้ายระหว่างโปรแกรมเล่นสื่อ หาก Assistant รู้ว่าอะไรกําลังเล่นอยู่และตําแหน่งของการเล่นปัจจุบัน Assistant จะโอนการเล่นนั้นไปยังอุปกรณ์อีกเครื่องหนึ่งเมื่อผู้ใช้เลื่อนดูห้องต่างๆ หรือบันทึกการเล่นภายหลังบนอุปกรณ์ที่กําหนดเองได้

คุณจะระบุระดับและมุมมองของสถานะสื่อที่โซลูชันมีได้ด้วยการกําหนดค่าแอตทริบิวต์ในลักษณะเฉพาะนี้ โดยปกติแล้ว ลักษณะนี้จะใช้ร่วมกับลักษณะเฉพาะของ TransportControl

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

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

แอตทริบิวต์ Type คำอธิบาย
supportActivityState บูลีน

(ค่าเริ่มต้น: false)

ระบุว่าอุปกรณ์รายงานสถานะกิจกรรมได้หรือไม่

supportPlaybackState บูลีน

(ค่าเริ่มต้น: false)

ระบุว่าอุปกรณ์รายงานสถานะการเล่นปัจจุบันได้หรือไม่

ตัวอย่าง

อุปกรณ์สื่อที่รายงานทั้งกิจกรรมและสถานะการเล่นสําหรับการตอบกลับด้วย SYNC

{
  "supportActivityState": true,
  "supportPlaybackState": true
}

อุปกรณ์ STATES

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

รัฐ Type คำอธิบาย
activityState สตริง

ระบุว่าอุปกรณ์ทํางานอยู่และผู้ใช้โต้ตอบด้วยอยู่หรือไม่

ค่าที่รองรับ:

INACTIVE
STANDBY
ACTIVE
playbackState สตริง

ระบุสถานะปัจจุบันของการเล่นสื่อ

ค่าที่รองรับ:

PAUSED
PLAYING
FAST_FORWARDING
REWINDING
BUFFERING
STOPPED

ตัวอย่าง

อุปกรณ์สื่อที่รายงานทั้งกิจกรรมและสถานะการเล่น

{
  "activityState": "ACTIVE",
  "playbackState": "PAUSED"
}

อุปกรณ์ COMMANDS

ไม่มี

อุปกรณ์ ERRORS

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