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

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

Assistant משתמשת ב-trait MediaState למטרות הבאות:

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

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

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

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

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

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

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

supportPlaybackState בוליאני

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

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

דוגמאות

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

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

מכשיר STATES

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

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

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

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

INACTIVE
STANDBY
ACTIVE
playbackState String

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

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

PAUSED
PLAYING
FAST_FORWARDING
REWINDING
BUFFERING
STOPPED

דוגמאות

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

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

COMMANDS של מכשיר

ללא.

מכשיר ERRORS

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