הנחיה לגבי AEP: ‏ Media3

כדי לוודא שהאפליקציות משתמשות בממשקי API מומלצים לטיפול במשימות מדיה מורכבות בכל סוגי המכשירים עם Android, כדאי לשלב את ספריית Jetpack Media3 כסטנדרט להפעלת מדיה, סשנים, עריכה, מטא-נתונים וחילוץ פריימים. העברת נתונים מממשקי API של מסגרות מדור קודם (כמו MediaPlayer,‏ MediaMuxer ו-MediaExtractor) לספריית Jetpack Media3 החזקה מאפשרת ליצור ארכיטקטורה מודרנית של מדיה. הספרייה הזו מספקת ערכת כלים מאוחדת ועשירה בתכונות, שמבטיחה חוויות מדיה עקביות.

הטמעה נדרשת

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

מזהה הנחיה
AEP-M3-GAA לא להשתמש בממשקי Android Framework API מדור קודם, כולל MediaPlayer,‏ MediaExtractor,‏ MediaMuxer ו-MediaMetadataRetriever.
AEP-M3-GAB אם הפעלת תוכן היא חלק מהתהליך המרכזי שעובר המשתמש, האפליקציה צריכה לשלב סשנים של מדיה כדי שמערכת ההפעלה תזהה אותם וכדי לאפשר שילוב מקושר למכשיר אחר.
AEP-M3-GAC אם באפליקציה יש ספרייה של תוכן אודיו, היא צריכה לחשוף את התוכן דרך MediaLibraryService ולתמוך בהפעלה מחדש של מדיה.

היכן ההנחיה חלה

ההנחיה הזו רלוונטית:

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

פטורים

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

מזהה פטור
AEP-M3-EAA ברשת מהירה, הפריים הראשון של הסרטון צריך להיות מוצג תוך 500 אלפיות השנייה מרגע שהמשתמש מפעיל אותו.
ההפעלה צריכה להיות חלקה, ללא ירידות במספר הפריימים או חוסרים באודיו שניתן לשמוע במהלך חלון של 30 שניות.
האפליקציה צריכה לנהל בצורה תקינה את הרשאת האודיו.
האפליקציה חייבת להגיב למקשי מדיה בחומרה, גם כשהיא פועלת ברקע.
אם האפליקציה תומכת בהפעלה ברקע, היא צריכה לפרסם התראה בסגנון מדיה ולהשתמש בשירות שפועל בחזית.
אם האפליקציה תומכת בהמשך הפעלה, היא צריכה להטמיע המשך הפעלה של מדיה.
צריך לטפל בניתוקים של האוזניות בצורה חלקה. לדוגמה, להשהות את ההפעלה במקום לעבור לרמקול.
ההפעלה צריכה להימשך בלי השמטת פריימים כשעוברים בין כיווני המכשיר.

חומרי עזר ומשאבים בנושא תכונות

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