בקרות מדיה בממשק המשתמש של המערכת

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

עדכונים לפקדי מדיה

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

כפתור הפעולה משתנה

כדי להבטיח שמשתמשים יוכלו לגשת לסט עשיר של פקדי מדיה עבור אפליקציות המנגנות מדיה, לחצני הפעולה בפקדי המדיה עבור אנדרואיד 13 נגזרים ממצבי הפעולה של PlaybackState . עם שינוי זה, הפונקציה MediaDataManager#createActionsFromState מייצרת מידע על לחצן פעולה המבוסס על מצב הפעולה PlaybackState . זה מתיישב עם האופן שבו פקדי מדיה מעובדים בפלטפורמות Android אחרות כגון Auto, Assistant ו-Wear.

לעומת זאת, באנדרואיד 12, כפתורי הפעולה בפקדי המדיה נקבעו על ידי פעולות התראה שנוספו להתראת MediaStyle .

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

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