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

קל לארגן דפים בעזרת אוספים אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.

החל מ-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

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

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

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

יצרני ציוד מקורי לא נדרשים לבצע שינויים כלשהם, והם יכולים להשתמש בהטמעת ברירת המחדל ב-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] לקבלת המלצות.