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

החל מ-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.
• בדיקות יחידה בתיקייה com.android.systemui.media.

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

מתאים.