הסכימה של מאפיין MediaState לבית חכם

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

Assistant משתמשת במאפיין MediaState למטרות הבאות:

  • כדי לדעת מה מופעל בכל מכשיר, גם אם ההפעלה בוצעה על ידי Assistant וגם אם לא. המידע הזה עוזר ל-Assistant להבין טוב יותר את כוונות המשתמשים. לדוגמה, משתמשים יגידו "Pause the Tonight Show" כשהכוונה שלהם היא "Pause the device currently playing the Tonight Show".
  • לצורך ניידות בין נגני מדיה – אם Assistant יודעת מה מושמע ואת המיקום של ההפעלה הנוכחית, היא יכולה להעביר את ההפעלה למכשיר אחר כשהמשתמש עובר בין חדרים, או לשמור את ההפעלה למועד מאוחר יותר במכשיר שרירותי.

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

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

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

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

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

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

supportPlaybackState בוליאני

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

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

דוגמאות

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

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

מצבי המכשיר

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

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

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

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

INACTIVE
STANDBY
ACTIVE
playbackState String

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

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

PAUSED
PLAYING
FAST_FORWARDING
REWINDING
BUFFERING
STOPPED

דוגמאות

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

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

פקודות למכשיר

ללא.

שגיאות במכשיר

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