סכימת MediaState של בית חכם

action.devices.traits.MediaState – התכונה הזו משמשת למכשירים שיכולים לדווח על מצבי מדיה.

התכונה MediaState משמשת את Assistant למטרות הבאות:

  • כדי לדעת מה מופעל בכל מכשיר, האם התכונה הופעלה שמופעל על ידי Assistant. המידע הזה עוזר ל-Assistant להבין טוב יותר את כוונות המשתמשים. לדוגמה, משתמשים יאמרו "Pause the Tonight Show" (השהיה של מופע הלילה) כשהכוונה שלהם בפועל היא "השהיית המכשיר שבו פועלת עכשיו תוכנית הלילה.
  • לניידות בין נגני מדיה — אם ה-Assistant יודע מה מופעל את המיקום הנוכחי של ההפעלה, Assistant יכולה להעביר את ההפעלה למכשיר אחר משתמש עובר בין חדרים או שומר את ההפעלה למועד מאוחר יותר במכשיר אקראי.

אפשר לציין את הרמה וההיבט של מצבי המדיה שהפתרון מספק הגדרת המאפיינים בתכונה הזו. בדרך כלל משתמשים בתכונה הזו יחד עם TransportControl תכונות

מאפייני המכשיר

מכשירים עם התכונה הזו עשויים לדווח על הדברים הבאים כחלק מהפעולה SYNC. למידה מידע נוסף על טיפול בכוונות של SYNC: מילוי Intent.

מאפיינים סוג תיאור
supportActivityState בוליאני

(ברירת המחדל: false)

לציין אם המכשיר יכול לדווח על מצב הפעילות.

supportPlaybackState בוליאני

(ברירת המחדל: false)

מציינים אם המכשיר יכול לדווח על מצב ההפעלה הנוכחי.

דוגמאות

מכשיר מדיה שמדווח גם על הפעילות וגם על מצב ההפעלה לתגובת סנכרון

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

מצבי המכשיר

ישויות עם התכונה הזו עשויות לדווח על הנושאים הבאים כחלק מהפעולה QUERY. למידה מידע נוסף על טיפול בכוונות של QUERY: מילוי Intent.

מדינות סוג תיאור
activityState String

לציין אם המכשיר פעיל והמשתמש מקיים איתו אינטראקציה באופן פעיל.

ערכים נתמכים:

INACTIVE
STANDBY
ACTIVE
playbackState String

ציון המצב הנוכחי כשמפעילים מדיה.

ערכים נתמכים:

PAUSED
PLAYING
FAST_FORWARDING
REWINDING
BUFFERING
STOPPED

דוגמאות

מכשיר מדיה שמדווח גם על פעילות וגם על מצב הפעלה

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

CommandS במכשיר

ללא.

ERRORS במכשיר

ראה את הרשימה המלאה של שגיאות וחריגים.