สคีมาของ 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

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