לחצני המדיה בממשק המשתמש של המערכת

החל מ-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_DEVICE
• Notification#EXTRA_MEDIA_REMOTE_ICON
• Notification#EXTRA_MEDIA_REMOTE_INTENT

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

הטמעה של אמצעי בקרה למדיה

יצרני ציוד מקורי (OEM) צריכים להיות מודעים לשינוי הזה בהתנהגות ברירת המחדל, כי הוא משפיע על האופן שבו נוצרים אמצעי הבקרה של המדיה באפליקציות. יצרני ציוד מקורי (OEM) צריכים גם לוודא שממשק ה-API החדש של המערכת פועל בהתאם לצורך במזמינוּת של מתג מעבר למכשיר אחר.

יצרני ציוד מקורי לא נדרשים לבצע שינויים כלשהם ויכולים להשתמש בהטמעה שמוגדרת כברירת מחדל ב-AOSP.

התאמה אישית של הפעלה מרחוק

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

אימות של ממשק השליטה במדיה

כדי לבדוק את אמצעי הבקרה של המדיה בממשק המשתמש של המערכת, מריצים בדיקה ידנית כדי לוודא את הדברים הבאים:

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

כדי לאמת את API ההפעלה מרחוק, אפשר להשתמש בבדיקות הבאות:

• בדיקות CTS ב-NotificationManagerTest, כמו testMediaStyleRemotePlayback_noPermission ו-testMediaStyleRemotePlayback_hasPermission.
• בדיקות יחידה (unit testing) בקטע com.android.systemui.media.

מומלץ לעיין בדרישה החדשה בנושא CDD [3.8.3.1/H-1-SR] לקבלת המלצות.

.