החל מ-27 במרץ 2025, מומלץ להשתמש ב-android-latest-release
במקום ב-aosp-main
כדי ליצור תרומות ל-AOSP. מידע נוסף זמין במאמר שינויים ב-AOSP.
סקירה כללית
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
Media היא פלטפורמה ליצירת אפליקציות מדיה שמספקות חוויית מידע ובידור בטוחה, חלקה ומחוברת בכל רכב עם Android.
Media היא אפליקציית מערכת של Android שנועדה לספק חוויית גלישה וצפייה ללא הסחות דעת (DO) באפליקציות מדיה. הטמעה פונקציונלית מלאה של Media כלולה ב-Android Open Source Project (AOSP).
איור 1. הטמעות לדוגמה של מסך מדיה.
מידע נוסף על מדיה זמין בדפים הבאים:
- רכיבי המערכת ומסלולי המשתמשים
מידע נוסף על הרכיבים שמקיימים אינטראקציה עם Media, ועל תהליכי המשתמש הנפוצים ביותר.
- הטמעת רדיו עם מדיה
כאן מוסבר איך לשלב את ממשק המשתמש של הרדיו עם Media כדי לאפשר למשתמשים לקיים אינטראקציה עם מקורות מדיה ורדיו כאילו מדובר באפליקציה אחת.
- התאמה אישית של המדיה
איך עובדים עם סגנונות ונכסים שמוגדרים ברמות שונות במבנה של AOSP.
- מטמיעים כרטיס מדיה.
הטמעת כרטיס מדיה כדי להציג מטא-נתונים של מדיה, כמו שמות, עטיפות אלבומים ועוד. בכרטיס מדיה אפשר גם להציג תור של פריטים של מדיה, כמו פלייליסט.
טרמינולוגיה
המונחים האלה מופיעים בקטע הזה.
מקור המדיה
אפליקציית Android שמטמיעה את MediaBrowserService API של Android כדי לחשוף את אמצעי הבקרה על ההפעלה ואת הגלישה בקטלוג של פריטי המדיה שלה.
פריט מדיה
רכיב בקטלוג של מקורות המדיה. פריטי המדיה יכולים להיות:
- פריטי מדיה שניתן להפעיל. קטעי אודיו שמערכת Android Auto יכולה להשמיע, כמו שירים, פרקים של ספרים ופרקים של פודקאסטים
- פריטי מדיה שאפשר לעיין בהם. רכיבי ארגון שמשמשים לקיבוץ פריטים של מדיה שניתן להפעיל או לעיין בהם, כמו קטגוריות של שירים, תיקיית שירים מהזמן האחרון, פודקאסטים ופריטי מדיה שניתן להפעיל, שממוינים לפי אומן, מחבר או קהל.
התכונות האלה זמינות ב-Media.
בזמן נהיגה |
במהלך חניה |
---|
רכיבי UI להפעלה.
-
הצגת פריט המדיה שמופעל כרגע (למשל שיר), כולל כותרת, עטיפת האלבום, משך הזמן, תיאור ומיקום ההפעלה הנוכחי.
-
ביצוע פעולות סטנדרטיות של מדיה (לדוגמה, הפעלה, עצירה, השהיה ודילוג קדימה).
-
ביצוע פעולות מדיה בהתאמה אישית (פעולות בהתאמה אישית שכל מקור מדיה מספק).
-
הצגת תור ההפעלה, אם הוא מסופק על ידי אפליקציית המדיה.
דפדוף בקטלוג.
-
הצגת קטגוריות ברמה העליונה.
-
להציג פירוט של פריטי מדיה שאפשר לעיין בהם (לדוגמה, תיקיות).
-
מבחר של פריטים של מדיה שניתן להפעיל (לדוגמה, שירים), כולל כותרת, עטיפת האלבום וסמנים. לדוגמה, תוכן בוטה ותוכן שהורדתם.
|
כל מה שמופיע בקטע בזמן נהיגה, וגם:
-
נכנסים לחשבון. במקורות המדיה שדורשים כניסה, צריך להיות אפשרי להתחיל את תהליך הכניסה ישירות מ'מדיה'.
-
הגדרות. מקור המדיה יכול להציג ממשק משתמש של הגדרות.
-
חיפוש באמצעות המקלדת. המשתמשים יכולים לבצע חיפוש טקסט ב'מדיה'.
|
Tasks
בטבלה הזו מתוארות המשימות של כל צד.
יצרני כלי רכב (vOEM) |
Google |
מפתחי אפליקציות |
---|
- פיתוח מערכת מידע ובידור שתואמת במלואה ל-Android CDD באמצעות Android Automotive.
- לעמוד בכל הציפיות של MediaSession וממשקי ה-API של הדפדפן, וכן בתאימות עם Media:
- כבדו את מבנה הגלישה.
- לכבד פעולות בהתאמה אישית.
- להעניק לאפליקציה הרשאה להתחברות, להגדרות וכו'.
- חשוב לפעול בהתאם לרכיבי המיתוג של האפליקציה שנתמכים במפורש בממשקי ה-API. לדוגמה, שם האפליקציה.
|
- הגדרה ופיתוח של ממשקי Media API.
- מתן הטמעה של Media ב-AOSP.
- הגדרת תהליך בדיקת האפליקציות לפרסום אפליקציות מדיה ב-Play Store.
- לספק מסמכים לגבי רכיבים כמו ממשקי API, התאמות אישיות, תהליכי בדיקה ואימות
|
- מטמיעים את ממשקי ה-Media API:
- לספק מבנה כללי של גלישה במדיה עם תוכן מתאים.
- מספקים פעולות בהתאמה אישית לפי הצורך.
- להפוך את מצבי ההפעלה לזמינים למערכת.
- לספק רכיבי מיתוג, כמו שם האפליקציה.
- מטמיעים את תהליכי הכניסה, ההרשמה, ההגדרות ופתרון השגיאות לפי הצורך.
- פיתוח ופרסום של חבילות APK לרכב בחנות Play.
|
הנחיות להתאמה אישית
הטמעת המדיה שכלולה ב-AOSP משתמשת ב-Car UI Library כדי לאפשר התאמה אישית, ומספקת עיצוב ותבנית בסיסיים שאפשר לאמץ כפי שהם או לשנות בהתאם למגבלות הבאות. בטבלה הבאה מתוארות האחריותיות של יצרני ציוד מקורי (OEM) בנוגע להתאמה אישית של מדיה.
התאמה אישית של מדיה |
תיאור |
---|
צריך |
לשנות את העיצוב הכללי ואת הסגנון, כולל לוח הצבעים והמידות. |
מאי |
לשנות את המבנה ברמה גבוהה של המדיה (לדוגמה, מיקום הכרטיסייה). |
אסור |
שינוי חוזים של Media API, כולל מיתוג האפליקציה:
- יכולת פעולה הדדית של MediaSession ו-MediaBrowser
- השם והסמל של מקור המדיה
שינוי ארכיטקטורת המידע של:
|
דוגמאות התוכן והקוד שבדף הזה כפופות לרישיונות המפורטים בקטע רישיון לתוכן. Java ו-OpenJDK הם סימנים מסחריים או סימנים מסחריים רשומים של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-07-27 (שעון UTC).
[[["התוכן קל להבנה","easyToUnderstand","thumb-up"],["התוכן עזר לי לפתור בעיה","solvedMyProblem","thumb-up"],["סיבה אחרת","otherUp","thumb-up"]],[["חסרים לי מידע או פרטים","missingTheInformationINeed","thumb-down"],["התוכן מורכב מדי או עם יותר מדי שלבים","tooComplicatedTooManySteps","thumb-down"],["התוכן לא עדכני","outOfDate","thumb-down"],["בעיה בתרגום","translationIssue","thumb-down"],["בעיה בדוגמאות/בקוד","samplesCodeIssue","thumb-down"],["סיבה אחרת","otherDown","thumb-down"]],["עדכון אחרון: 2025-07-27 (שעון UTC)."],[],[],null,["# Overview\n\n*Media* provides a platform on which to build media apps that provide safe,\nseamless, and connected infotainment experiences in every Android-enabled car.\nMedia is an Android system application designed to provide a\n[Distraction Optimized (DO)](/docs/automotive/driver_distraction/guidelines) playback\nand browse experience for media apps. A fully functional implementation of Media is included with\n[Android Open Source Project (AOSP)](/).\n\n\n\u003cbr /\u003e\n\n\n**Figure 1.** Media screen sample implementations.\n\nTo learn about Media, see the following pages:\n\n- **[System components and user flows](/docs/automotive/hmi/media/technical_details).** Learn more about the components that interact with Media, as well as the most common user flows.\n- **[Implement radio with media](/docs/automotive/hmi/media/radio).** Read how to integrate the Radio UI with Media to provide enable users to interact with media sources and radio as if they were a single application.\n- **[Customize media](/docs/automotive/hmi/media/customization).** Learn how to work with styles and assets defined at different levels in the AOSP structure.\n- **[Implement a media card](/docs/automotive/hmi/media/media-card).** Implement a media card to display media metadata such as titles, album art, and more. A media card can also display a queue of media items, such as a playlist.\n\nTerminology\n-----------\n\nThese terms are used in this section.\nMedia Source An Android app that implements the Android [MediaBrowserService API](https://developer.android.com/guide/topics/media-apps/audio-app/building-an-audio-app) to expose playback control and browsing of its catalog of media items. Media Item An element in the Media Source catalog. Media items can be either:\n\n- Playable Media items. Audio segments that can be played by the system such as songs, chapters of books, and episodes of podcasts\n- Browsable Media items. Organizational elements used to group playable or other browseable media items such as song categories, a recent songs folder, as well as podcasts and playable media items sorted by artist, author, or audience.\n\nMedia features\n--------------\n\nMedia provides these features.\n\n| While driving | While parked |\n|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| Playback control. - Presentation of currently playing media item (for example, a song), including title, album art, duration, description, and current play position. - Execution of standard media actions (for example, play, stop, pause, and skip forward). - Execution of custom media actions (custom actions provided by each media source). - Presentation of the playback queue, if provided by the media app. Catalog browse. - Display of top-level categories. - Drill down into browse-able media items (for example, folders). - Selection of playable media items (for example, songs) including title, album art, and indicators. For example, explicit content and downloaded content. | Everything listed under *While Driving* as well as: - Sign-in. For those media sources that require sign-in, it should be possible to start the sign in flow directly from Media. - Settings. Media source can display a settings UI. - Search, with keyboard. Users can perform a text search on Media. |\n\nTasks\n-----\n\nThis table describes the tasks of each party.\n\n| Vehicle makers (vOEMs) | Google | App developers |\n|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| - Build a fully-compliant [Android CDD](/docs/compatibility/10/android-10-cdd) infotainment system with Android Automotive. - Fulfill all expectations of MediaSession and Browser APIs and the interoperability with Media: - Respect browse structure. - Respect custom actions. - Delegate to the app for sign-in, settings, and so on. - Respect the app branding elements explicitly supported by the APIs. For example, the app name. | - Define and evolve Media APIs. - Provide Media implementation in AOSP. - Define app review process for publishing of media apps on Play Store. - Provide documentation for elements such as APIs, customizations, review, and certification processes | - Implement Media APIs: - Provide overall media browse structure with appropriate content. - Provide custom actions as appropriate. - Make playback states available to the system. - Provide branding elements, such as app name. - Implement the sign-in, sign-up, settings, and error resolution flows, as needed. - Build and publish car APKs to the Play Store. |\n\nCustomization guidelines\n------------------------\n\nThe Media implementation included in AOSP uses\n[Car UI Library](/docs/automotive/hmi/car_ui) to enable\ncustomization and provides a base theme and structure that can be adopted as is or modified\naccording to the following restrictions. The following table describes OEM responsibilities\nregarding Media customization.\n\n| Media customization | Description |\n|---------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| SHOULD | Adjust overall theme and styling, including color pallette and sizing. |\n| MAY | Modify the high-level structure of Media (for example, tab placement). |\n| MUST NOT | Modify Media API contracts, including app branding: - MediaSession and MediaBrowser interoperability - Media source name, icon Modify information architecture of: - Playback - Browse - Search |"]]