החל מ-Android 13, לחצני המדיה בממשק המשתמש של המערכת מכילים עדכונים ללחצני הפעולה ולפעלת המדיה מרחוק. השינויים האלה תומכים בחוויית בקרת מדיה משופרת בטלפונים ובטאבלטים, ומאפשרים העברות מדיה חלקות בין מכשירים.
עדכונים בממשק השליטה במדיה
בקטע הזה מתוארים העדכונים שבוצעו בפקדי המדיה ב-Android 13 לחצני פעולה ולהפעלה מרחוק.
שינויים בלחצן הפעולה
כדי להבטיח שלמשתמשים תהיה גישה לקבוצה עשירה של פקדי מדיה באפליקציות שמפעילות מדיה, לחצני הפעולה בפקדי המדיה ב-Android 13 נגזרים ממצבי הפעולה PlaybackState.
בעקבות השינוי הזה, הפונקציה MediaDataManager#createActionsFromState
מנפיקה מידע על לחצן הפעולה על סמך מצב הפעולה PlaybackState.
זה תואם לאופן שבו לחצני המדיה מוצגים בפלטפורמות אחרות של Android, כמו Auto, Assistant ו-Wear.
לעומת זאת, ב-Android 12, לחצני הפעולה בלחצני המדיה נקבעים לפי פעולות ההתראות שנוספו להתראה MediaStyle.
במאמר StatusBarManager תוכלו למצוא סיכום של השינויים שתואמים לאפליקציה שבוצעו בעדכונים של לחצן הפעולה.
Remote playback API
כדי לספק חוויית מדיה עקבית במגוון מכשירים, החל מ-Android 13 נוסף ממשק API חדש למערכת Notification#setRemotePlaybackInfo כדי לסמן התראות מדיה בממשק המשתמש של מערכת בקרת המדיה להפעלה מרחוק. ממשק ה-API הזה מאפשר לאפליקציות מערכת ששולחות את ההתראות לבצע את הפעולות הבאות:
- לספק מידע ופונקציונליות של מדיה שמקורה במכשיר מרוחק למתג ברירת המחדל של הפלט בלחצני הבקרה של המדיה.
- במקרה הצורך, מומלץ להחליף את התקציב של מחליף הפלט.
לאפליקציות מערכת שמשתמשות בהתראה הזו צריכה להיות ההרשאה MEDIA_CONTENT_CONTROL.
ב-API של Notification#setRemotePlaybackInfo מתווספים גם הפרמטרים הבאים של extras כדי לקבוע את השם, הסמל והכוונה של מכשיר ההפעלה מרחוק:
Notification#EXTRA_MEDIA_REMOTE_DEVICENotification#EXTRA_MEDIA_REMOTE_ICONNotification#EXTRA_MEDIA_REMOTE_INTENT
המידע הזה מאפשר לממשק המשתמש של המערכת להחליף את פרטי המכשיר שבברירת המחדל של מתג המעבר למכשיר ולהוסיף את פקד המדיה להפעלה מרחוק בסוף הרשימה של פקדי המדיה המקומית.
הטמעת אמצעי בקרה למדיה
יצרני ציוד מקורי צריכים להיות מודעים לשינוי הזה בהתנהגות ברירת המחדל, כי הוא משפיע על האופן שבו מתבצעת היצירה של אמצעי הבקרה של המדיה באפליקציות. יצרני ציוד מקורי צריכים גם לוודא ש-System API החדש פועל כראוי בממשק של מתג הפלט.
יצרני ציוד מקורי (OEM) לא נדרשים לבצע שינויים כלשהם, והם יכולים להשתמש בהטמעת ברירת המחדל ב-AOSP.
התאמה אישית של הפעלה מרחוק
במקרים שבהם ל-OEM יש אפליקציית מערכת שמפרסמת התראות על הפעלת מדיה מרחוק, האפליקציה יכולה לקרוא ל-setRemotePlaybackInfo כדי לקבל התראה, כל עוד היא קיבלה את ההרשאה MEDIA_CONTENT_CONTROL. עם זאת, זו לא דרישה, והשותף יכול לבחור שלא לבצע התאמה אישית.
אימות אמצעי הבקרה על המדיה
כדי לבדוק את אמצעי הבקרה של המדיה בממשק המשתמש, מריצים בדיקה ידנית כדי לאמת את הדברים הבאים:
- הלחצנים פועלים כמצופה כשמפעילים מדיה מאפליקציה.
- במתג הפלט מוצגים פרטי המכשיר הנכונים.
כדי לאמת את ה-API להפעלה מרחוק, משתמשים בבדיקות הבאות:
- בדיקות CTS ב-
NotificationManagerTest, כמוtestMediaStyleRemotePlayback_noPermissionו-testMediaStyleRemotePlayback_hasPermission. - בדיקות יחידה בקטע
com.android.systemui.media.
מומלץ לעיין בדרישה החדשה של CDD [3.8.3.1/H-1-SR] לקבלת המלצות.