הסכימה של מאפיין 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) לציין אם המכשיר יכול לדווח על מצב ההפעלה הנוכחי.

דוגמאות

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

{
  "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"
}

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

ללא.

ERRORS במכשיר

כאן מפורטת הרשימה המלאה של שגיאות וחריגים.