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

สคีมาของ Smart Home MediaState Trait

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

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

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

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

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

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

แอตทริบิวต์ ประเภท คำอธิบาย
supportActivityState บูลีน

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

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

supportPlaybackState บูลีน

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

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

ตัวอย่าง

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

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

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

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

รัฐ ประเภท คำอธิบาย
activityState สตริง

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

ค่าที่รองรับมีดังต่อไปนี้

INACTIVE
STANDBY
ACTIVE
playbackState สตริง

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

ค่าที่รองรับมีดังต่อไปนี้

PAUSED
PLAYING
FAST_FORWARDING
REWINDING
BUFFERING
STOPPED

ตัวอย่าง

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

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

คําสั่งของอุปกรณ์

ไม่มี

อุปกรณ์ ERRORS

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