สคีมาลักษณะของ MediaState แบบ Smart Home

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

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

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

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

ATTRIBUTES ของอุปกรณ์

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

Attributes ประเภท คำอธิบาย
supportActivityState บูลีน

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

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

supportPlaybackState บูลีน

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

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

ตัวอย่าง

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

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

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

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

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

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

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

INACTIVE
STANDBY
ACTIVE
playbackState String

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

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

PAUSED
PLAYING
FAST_FORWARDING
REWINDING
BUFFERING
STOPPED

ตัวอย่าง

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

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

COMMANDS ของอุปกรณ์

ไม่ต้องแจ้งเตือนเลย

ข้อผิดพลาดเกี่ยวกับอุปกรณ์

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