מיקוד אודיו

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

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

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

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

• בלעדי
• דחייה
• בו-זמני

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

זהו מודל האינטראקציה הנפוץ ביותר ב-Android.

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

דחיית האינטראקציה

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

אינטראקציה בו-זמנית

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

• בקשת המיקוד הנכנסת חייבת לבקש AudioManager.AUDIOFOCUS_GAIN_TRANSIENT_MAY_DUCK

• האלמנט הנוכחי שמקבל את המיקוד לא setPauseWhenDucked(true)

• המשתמש הנוכחי שמחזיק במיקוד בוחר לא לקבל אירועים של הנמכת עוצמת קול של אודיו

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

טיפול בשידורים חיים בו-זמניים

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

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

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

מטריצת אינטראקציות

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

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

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

איור 1. מטריצת אינטראקציה של מיקוד אודיו.

ניווט במהלך שיחות טלפון

ב-Android 11, הוצגה הגדרת משתמש חדשה שמאפשרת למשתמשים לשנות את התנהגות האינטראקציה בין הניווט לבין שיחות טלפון. אם מגדירים את android.car.KEY_AUDIO_FOCUS_NAVIGATION_REJECTED_DURING_CALL, האינטראקציה בין בקשות נכנסות למיקוד NAVIGATION לבין בעלי המיקוד הנוכחיים CALL משתנה ממקבילה לדחייה. אם משתמש מעדיף שהוראות הניווט לא יקטעו את השיחה, הוא יכול להפעיל את ההגדרה. ההגדרה הזו נשמרת עבור המשתמש, ואפשר להגדיר אותה באופן דינאמי כך שבקשות מיקוד עתידיות יתחשבו בהגדרה החדשה.

השהיה של הרשאת האודיו

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

כללים לבקשות מושהות להתמקדות באודיו

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

• אפשר לדחות רק בקשה אחת בכל פעם. אם מתקבלת בקשה שניתן לעכב בזמן שיש כבר בקשה מעוכבת, הבקשה המקורית המעוכבת מקבלת אירוע שינוי AUDIOFOCUS_LOSS והבקשה החדשה מקבלת תשובה סינכרונית של AUDIOFOCUS_REQUEST_DELAYED.

• בקשות שאפשר לדחות צריכות לכלול את OnAudioFocusChangeListener. אחרי שהבקשה מתעכבת, נעשה שימוש ב-listener כדי להודיע למגיש הבקשה כשהבקשה מאושרת בסופו של דבר (AUDIOFOCUS_GAIN), או אם היא נדחית בהמשך (AUDIOFOCUS_LOSS).

בקשה להשהיית המיקוד

כדי ליצור בקשה שאפשר לדחות:

1. שימוש בכתובת AudioFocusRequest.Builder#setAcceptsDelayedFocusGain.

   mMediaWithDelayedFocusListener = new MediaWithDelayedFocusListener();
   
   mDelayedFocusRequest = new AudioFocusRequest
        .Builder(AudioManager.AUDIOFOCUS_GAIN)
        .setAudioAttributes(mMusicAudioAttrib)
        .setOnAudioFocusChangeListener(mMediaWithDelayedFocusListener)
        .setForceDucking(false)
        .setWillPauseWhenDucked(false)
        .setAcceptsDelayedFocusGain(true)
        .build();
   

2. כשמגישים את הבקשה, צריך לטפל בתגובה AUDIOFOCUS_REQUEST_DELAYED:

   int delayedFocusRequestResults = mAudioManager.requestAudioFocus(mDelayedFocusRequest);
   if (delayedFocusRequestResults == AudioManager.AUDIOFOCUS_REQUEST_GRANTED) {
       // start audio playback
       return;
   }
   if (delayedFocusRequestResults == AudioManager.AUDIOFOCUS_REQUEST_DELAYED) {
        // audio playback delayed to audio focus listener
        return;
   }
   

3. כשהבקשה מתעכבת, מאזין המיקוד מטפל בשינויים במיקוד:

   private final class MediaWithDelayedFocusListener implements
   OnAudioFocusChangeListener {
          @Override
          public void onAudioFocusChange(int focusChange) {
              synchronized (mLock) {
                  switch (focusChange) {
                      case AudioManager.AUDIOFOCUS_GAIN:
                          … // Start focus playback
                      case AudioManager.AUDIOFOCUS_LOSS_TRANSIENT:
                          … // Pause media transiently
                      case AudioManager.AUDIOFOCUS_LOSS:
                          … // Stop media
   

הנמכה אוטומטית של עוצמת הקול

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

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

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

עיצוב ברמה גבוהה

באיור הבא מוצג העיצוב הכללי והתמיכה בתכונה של איבוד הפוקוס במכוניות:

איור 2. עיצוב כללי של תכונת ההנמכה שנאכפת על ידי המערכת.

• הנמכה ממוקדת: הנמכה ב-Android 15 מופעלת על ידי המערכת ומיועדת במיוחד למצבים שבהם אפליקציה מאבדת את פוקוס האודיו אבל ממשיכה להפעיל אודיו.
• מנגנון ההנמכה: כשאפליקציה מאבדת את המיקוד באודיו לטובת אפליקציה חדשה שמבקשת אותו:
  • מסגרת האודיו מחלישה אוטומטית את האודיו של האפליקציה שהפסידה.
  • אחרי ההנמכה, המערכת משתיקה את שידור האודיו.
  • לאחר מכן האפליקציה מקבלת התראה על אובדן הרשאת האודיו.
  • אפליקציות שמתנהגות בצורה לא תקינה מושתקות עד שהן מקבלות שוב את המיקוד באודיו.
  • לוגיקת ברירת המחדל היא להציג בהדרגה את האפליקציות שהוצגו בהדרגה אחרי 2 שניות. עם זאת, יצרני ציוד מקורי יכולים להגדיר את זה לכל ערך של זמן קצוב לפעילות.
  • מסגרת האודיו משתמשת בהגדרות OEM גם להנמכה הדרגתית וגם להגברה הדרגתית.

• קובץ הגדרות יצרן ציוד מקורי (OEM): ב-Android 15 יש קובץ הגדרות חדש, car_audio_fade_configuration.xml:

  • הקובץ הזה מאפשר ליצרני ציוד מקורי (OEM) להגדיר קריטריונים שלפיהם המערכת תחיל את ההגדרה של העברת פוקוס האודיו על אפליקציה שהפסידה את הפוקוס.
  • מסגרת האודיו אוכפת את ההנמכה וההשתקה רק אם האפליקציה המפסידה תואמת לכללים שהוגדרו על ידי יצרן הציוד המקורי בקובץ ה-XML הזה.
  • כך יצרני ציוד מקורי יכולים להתאים אישית את התנהגות התכונה על סמך מאפייני האפליקציה או סוגי השימוש באודיו.

• שליטה בתכונה באמצעות RRO: הוספנו דגל חדש של שכבת-על של משאב בזמן ריצה (RRO),‏ audioUseFadeManagerConfiguration, כדי להפעיל או להשבית את התכונה הזו:

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

הגדרות של ניהול מעברים הדרגתיים

במסגרת האודיו של Android 15 מוצג FadeManagerConfigurationמאוחד כדי לספק ליצרני ציוד מקורי (OEM) שליטה מדויקת בהתנהגות של הנמכת עוצמת הקול. המסגרת הזו מוצגת באיור 3:

איור 3. הגדרת מנהל המעברים.

ההגדרה הזו כוללת:

• מאפייני מעבר של הדהייה: הגדרות של הדהייה החוצה והדהייה פנימה.
  • אפשר להגדיר אותו עם שימושים או מאפיינים ספציפיים של אודיו.
  • מאפשרת להגדיר משך זמן בהתאמה אישית.
  • ההגדרות האלה משמשות ליצירת VolumeShaper.Configuration.
• כללי מדיניות לגבי הדהייה: כללים שקובעים מתי מתרחשת הדהייה.
  • מתג גלובלי להפעלה או להשבתה של דעיכה.
  • רשימה ניתנת להגדרה של שימושים באודיו שאפשר להנמיך (אם הם מאבדים את המיקוד).
  • רשימות החרגות (שאי אפשר להחליש) מונעות החלשה של מקורות אודיו קריטיים או ייעודיים. הרשימות האלה יכולות להתבסס על:
    • סוגי תוכן
    • מאפייני אודיו
    • מזהי UID של אפליקציות (אפשר להגדיר רק במהלך זמן הריצה)

הגדרות OEM

בקטע הזה נבחן את ההתאמות האישיות הזמינות ליצרני ציוד מקורי.

קובץ XML של הגדרות ההנחתה של האודיו ברכב

ב-Android 15 מוצג קובץ הגדרה חדש, car_audio_fade_configuration.xml, שמאפשר ליצרני ציוד מקורי (OEM) לבצע התאמה אישית נרחבת של התנהגות ההנמכה של האודיו במהלך אובדן המיקוד.

• בקובץ ה-XML הזה אפשר להגדיר כמה תצורות שונות של מעברים הדרגתיים, וכל אחת מהן צריכה שם ייחודי כדי שאפשר יהיה להפנות אליהן ב-car_audio_configuration.xml.
• אפשר להחיל את ההגדרות האלה בצורה גמישה על אזורי אודיו שונים ועל הגדרות אזורים שונות.
• חשוב לציין שכל הגדרת מעבר מקבלת רק ערכי משך באלפיות השנייה, והמערכת משתמשת בהם כדי ליצור באופן פנימי את VolumeShaper.Configuration המתאים.

הנחיות מעשיות להטמעה מופיעות בדוגמאות להגדרות שזמינות לאמולטור בכתובת device/generic/car/emulator/audio/car_audio_fade_configuration.xml.

<carAudioFadeConfiguration version="1">
    <configs>
        <config name="relaxed fading" defaultFadeOutDurationInMillis="800" defaultFadeInDurationInMillis="500">
            <fadeState value="1" />
            <fadeableUsages>
                <usage value="AUDIO_USAGE_MEDIA" />
                <usage value="AUDIO_USAGE_GAME" />
                <usage value="AUDIO_USAGE_ASSISTANCE_SONIFICATION" />
                <usage value="AUDIO_USAGE_ASSISTANCE_ACCESSIBILITY" />
                <usage value="AUDIO_USAGE_ASSISTANCE_NAVIGATION_GUIDANCE" />
                <usage value="AUDIO_USAGE_ASSISTANT" />
                <usage value="AUDIO_USAGE_NOTIFICATION" />
                <usage value="AUDIO_USAGE_ANNOUNCEMENT"/>
            </fadeableUsages>
            <unfadeableContentTypes>
                <contentType value="AUDIO_CONTENT_TYPE_SPEECH" />
            </unfadeableContentTypes>
            <unfadeableAudioAttributes>
                <audioAttributes>
                    <audioAttribute usage="AUDIO_USAGE_MEDIA" tags="oem_specific_tag1" />
                </audioAttributes>
            </unfadeableAudioAttributes>
            <fadeOutConfigurations>
                <fadeConfiguration fadeDurationMillis="500">
                    <audioAttributes>
                        <usage value="AUDIO_USAGE_MEDIA" />
                        <usage value="AUDIO_USAGE_GAME" />
                        <audioAttribute usage="AUDIO_USAGE_ASSISTANT" tags="oem_specific_tag2" />
                    </audioAttributes>
                </fadeConfiguration>
                <fadeConfiguration fadeDurationMillis="800">
                    <audioAttributes>
                        <usage value="AUDIO_USAGE_ASSISTANCE_SONIFICATION" />
                        <usage value="AUDIO_USAGE_ASSISTANCE_ACCESSIBILITY" />
                        <usage value="AUDIO_USAGE_ASSISTANCE_NAVIGATION_GUIDANCE" />
                        <usage value="AUDIO_USAGE_ASSISTANT" />
                        <usage value="AUDIO_USAGE_ANNOUNCEMENT"/>
                    </audioAttributes>
                </fadeConfiguration>
            </fadeOutConfigurations>
            <fadeInConfigurations>
                <fadeConfiguration fadeDurationMillis="1000">
                    <audioAttributes>
                        <usage value="AUDIO_USAGE_MEDIA" />
                        <usage value="AUDIO_USAGE_GAME" />
                        <audioAttribute usage="AUDIO_USAGE_ASSISTANT" tags="oem_specific_tag2" />
                    </audioAttributes>
                </fadeConfiguration>
                <fadeConfiguration fadeDurationMillis="800">
                    <audioAttributes>
                        <usage value="AUDIO_USAGE_ASSISTANCE_SONIFICATION" />
                        <usage value="AUDIO_USAGE_ASSISTANCE_ACCESSIBILITY" />
                        <usage value="AUDIO_USAGE_ASSISTANCE_NAVIGATION_GUIDANCE" />
                        <usage value="AUDIO_USAGE_ASSISTANT" />
                        <usage value="AUDIO_USAGE_ANNOUNCEMENT"/>
                    </audioAttributes>
                </fadeConfiguration>
            </fadeInConfigurations>
        </config>
        <config name="aggressive fading">
            <fadeState value="1" />
            <fadeableUsages>
                <usage value="AUDIO_USAGE_MEDIA" />
                <usage value="AUDIO_USAGE_GAME" />
                <usage value="AUDIO_USAGE_ASSISTANCE_SONIFICATION" />
                <usage value="AUDIO_USAGE_ASSISTANCE_ACCESSIBILITY" />
                <usage value="AUDIO_USAGE_ASSISTANCE_NAVIGATION_GUIDANCE" />
                <usage value="AUDIO_USAGE_ASSISTANT" />
                <usage value="AUDIO_USAGE_NOTIFICATION" />
                <usage value="AUDIO_USAGE_ANNOUNCEMENT"/>
            </fadeableUsages>
            <unfadeableContentTypes>
                <contentType value="AUDIO_CONTENT_TYPE_SPEECH" />
            </unfadeableContentTypes>
            <unfadeableAudioAttributes>
                <audioAttributes>
                    <audioAttribute usage="AUDIO_USAGE_MEDIA" tags="oem_specific_tag1" />
                    <audioAttribute usage="AUDIO_USAGE_ASSISTANT" tags="oem_projection_service" />
                </audioAttributes>
            </unfadeableAudioAttributes>
            <fadeOutConfigurations>
                <fadeConfiguration fadeDurationMillis="150">
                    <audioAttributes>
                        <usage value="AUDIO_USAGE_MEDIA" />
                        <usage value="AUDIO_USAGE_GAME" />
                    </audioAttributes>
                </fadeConfiguration>
                <fadeConfiguration fadeDurationMillis="400">
                    <audioAttributes>
                        <usage value="AUDIO_USAGE_ASSISTANCE_SONIFICATION" />
                        <usage value="AUDIO_USAGE_ASSISTANCE_ACCESSIBILITY" />
                        <usage value="AUDIO_USAGE_ASSISTANCE_NAVIGATION_GUIDANCE" />
                        <usage value="AUDIO_USAGE_ASSISTANT" />
                        <usage value="AUDIO_USAGE_ANNOUNCEMENT"/>
                    </audioAttributes>
                </fadeConfiguration>
            </fadeOutConfigurations>
            <fadeInConfigurations>
                <fadeConfiguration fadeDurationMillis="300">
                    <audioAttributes>
                        <usage value="AUDIO_USAGE_MEDIA" />
                        <usage value="AUDIO_USAGE_GAME" />
                    </audioAttributes>
                </fadeConfiguration>
                <fadeConfiguration fadeDurationMillis="550">
                    <audioAttributes>
                        <usage value="AUDIO_USAGE_ASSISTANCE_SONIFICATION" />
                        <usage value="AUDIO_USAGE_ASSISTANCE_ACCESSIBILITY" />
                        <usage value="AUDIO_USAGE_ASSISTANCE_NAVIGATION_GUIDANCE" />
                        <usage value="AUDIO_USAGE_ASSISTANT" />
                        <usage value="AUDIO_USAGE_ANNOUNCEMENT"/>
                    </audioAttributes>
                </fadeConfiguration>
            </fadeInConfigurations>
        </config>
        <config name="disabled fading">
            <fadeState value="0" />
        </config>
        <config name="dynamic device fading" defaultFadeOutDurationInMillis="800" defaultFadeInDurationInMillis="500">
            <fadeState value="1" />
            <fadeableUsages>
                <usage value="AUDIO_USAGE_ASSISTANCE_SONIFICATION" />
                <usage value="AUDIO_USAGE_ASSISTANCE_ACCESSIBILITY" />
                <usage value="AUDIO_USAGE_ASSISTANCE_NAVIGATION_GUIDANCE" />
                <usage value="AUDIO_USAGE_ASSISTANT" />
                <usage value="AUDIO_USAGE_NOTIFICATION" />
                <usage value="AUDIO_USAGE_ANNOUNCEMENT"/>
            </fadeableUsages>
            <unfadeableContentTypes>
                <contentType value="AUDIO_CONTENT_TYPE_SPEECH" />
            </unfadeableContentTypes>
            <unfadeableAudioAttributes>
                <audioAttributes>
                    <audioAttribute usage="AUDIO_USAGE_MEDIA" tags="oem_specific_tag1" />
                </audioAttributes>
            </unfadeableAudioAttributes>
            <fadeOutConfigurations>
                <fadeConfiguration fadeDurationMillis="500">
                    <audioAttributes>
                        <audioAttribute usage="AUDIO_USAGE_ASSISTANT" tags="oem_specific_tag2" />
                    </audioAttributes>
                </fadeConfiguration>
                <fadeConfiguration fadeDurationMillis="800">
                    <audioAttributes>
                        <usage value="AUDIO_USAGE_ASSISTANCE_SONIFICATION" />
                        <usage value="AUDIO_USAGE_ASSISTANCE_ACCESSIBILITY" />
                        <usage value="AUDIO_USAGE_ASSISTANCE_NAVIGATION_GUIDANCE" />
                        <usage value="AUDIO_USAGE_ASSISTANT" />
                        <usage value="AUDIO_USAGE_ANNOUNCEMENT"/>
                    </audioAttributes>
                </fadeConfiguration>
            </fadeOutConfigurations>
            <fadeInConfigurations>
                <fadeConfiguration fadeDurationMillis="1000">
                    <audioAttributes>
                        <audioAttribute usage="AUDIO_USAGE_ASSISTANT" tags="oem_specific_tag2" />
                    </audioAttributes>
                </fadeConfiguration>
                <fadeConfiguration fadeDurationMillis="800">
                    <audioAttributes>
                        <usage value="AUDIO_USAGE_ASSISTANCE_SONIFICATION" />
                        <usage value="AUDIO_USAGE_ASSISTANCE_ACCESSIBILITY" />
                        <usage value="AUDIO_USAGE_ASSISTANCE_NAVIGATION_GUIDANCE" />
                        <usage value="AUDIO_USAGE_ASSISTANT" />
                        <usage value="AUDIO_USAGE_ANNOUNCEMENT"/>
                    </audioAttributes>
                </fadeConfiguration>
            </fadeInConfigurations>
        </config>
    </configs>
</carAudioFadeConfiguration>

קובץ XML של הגדרות האודיו ברכב

ב-Android 15 מוצג קובץ car_audio_configuration.xml מעודכן, עכשיו בגרסה 4, שכולל תגי applyFadeConfigs ו-fadeConfig חדשים. התג applyFadeConfigs יכול להכיל כמה הגדרות של fadeConfig, מה שמאפשר הגדרה גמישה של האפקט. כל הגדרה:

• חייב לכלול fadeConfig ברירת מחדל אחת שמסומנת ב-isDefault = true.
• יכול לכלול כמה הגדרות fadeConfig זמניות. ההגדרות הזמניות האלה חלות באופן ספציפי במהלך אינטראקציות של אובדן מיקוד שמע, ורק כשהאפליקציה שמקבלת את מיקוד השמע עומדת בקריטריונים שמוגדרים בהגדרה הזמנית.

הנחיות מעשיות להטמעה מופיעות בדוגמאות להגדרות שזמינות לאמולטור בכתובת device/generic/car/emulator/audio/car_audio_configuration.xml.

<carAudioConfiguration version="4">
    <zones>
        <zone name="primary zone" isPrimary="true" occupantZoneId="0">
            <zoneConfigs>
                <zoneConfig name="primary zone config 0" isDefault="true">
                    <volumeGroups>
                    .....
                    </volumeGroups>
                    <applyFadeConfigs>
                            <fadeConfig name="relaxed fading" isDefault="true"> </fadeConfig>
                            <fadeConfig name="aggressive fading">
                                    <audioAttributes>
                                          <usage value="AUDIO_USAGE_VOICE_COMMUNICATION" />
                                          <usage value="AUDIO_USAGE_SAFETY" />
                                  </audioAttributes>
                            </fadeConfig>
                            <fadeConfig name="disabled fading">
                                    <audioAttributes>
                                          <usage value="AUDIO_USAGE_EMERGENCY" />
                                    </audioAttributes>
                            </fadeConfig>
                    </applyFadeConfigs>
                  </zoneConfig>
            </zoneConfigs>
        </zone>
    </zones>
</carAudioConfiguration>

תוסף שירות למיקוד אודיו של OEM

יצרני ציוד מקורי שמטמיעים שירות מותאם אישית למיקוד באודיו ברכב יכולים להגדיר את ההגדרות של הנמכת עוצמת הקול באודיו על ידי הכללתן ב-OemCarAudioFocusResult. אפשר לעשות את זה באמצעות שיטת ה-builder‏ setAudioAttributesToCarAudioFadeConfigurationMap():

/** @see OemCarAudioFocusResult#getAudioAttributesToCarAudioFadeConfigurationMap() **/
@NonNull
public Builder setAudioAttributesToCarAudioFadeConfigurationMap(@NonNull
        Map<AudioAttributes, CarAudioFadeConfiguration> attrsToCarAudioFadeConfig) {
}

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

תרשים רצף

בתרשים הרצף הזה מוצגת ההתנהגות אחרי שמוענק פוקוס אודיו לאפליקציה App2, ואחרי שאפליקציה App1 מאבדת את פוקוס האודיו:

• כששירות האודיו ברכב שולח את איבוד המיקוד באודיו אל App1, ההפעלה מהנגן של App1 עוברת דעיכה בהתאם לFadeManagerConfiguration הפעיל. אחרי שפעולת ההנמכה מסתיימת, App1 מקבל קריאה חוזרת רגילה של אובדן הרשאת אודיו.
• אופציונלי: אפשר להגדיר שהאודיו של App1 יחזור בהדרגה אחרי פרק זמן שניתן להגדרה. יצרני ציוד מקורי יכולים להגדיר את משך הזמן הזה באמצעות Builder#setFadeInDurationForUsage(int, long) בהתאם לדרישות המוצר הספציפיות שלהם.

איור 4. דיאגרמת רצף לתכונת ההנמכה של עוצמת הקול ברכב.

ניהול המיקוד במספר אזורים

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

בכל האפליקציות, המערכת CarAudioService מנהלת את המיקוד באופן אוטומטי. אזור האודיו של בקשת מיקוד נקבע לפי הרכיב המשויך UserId או UID (פרטים נוספים זמינים במאמר בנושא ניתוב אודיו למספר אזורים).

בקשת אודיו מכמה אזורים בו-זמנית

אם אפליקציה רוצה להפעיל אודיו בכמה אזורים בו-זמנית, היא צריכה לבקש פוקוס לכל אזור על ידי הכללת AUDIOFOCUS_EXTRA_REQUEST_ZONE_ID בחבילה:

//Create attribute with bundle and AUDIOFOCUS_EXTRA_REQUEST_ZONE_ID
Bundle bundle = new Bundle();
bundle.putInt(CarAudioManager.AUDIOFOCUS_EXTRA_REQUEST_ZONE_ID,
               zoneId);

AudioAttributes attributesWithZone = new AudioAttributes.Builder()
     .setUsage(AudioAttributes.USAGE_MEDIA)
     .addBundle(bundle)
     .build();

//Create focus request using built attributesWithZone

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

הרשאת אודיו ב-HAL

החל מ-Android 11, ‏ HAL מופעל כדי לבקש מיקוד בשם זרמים חיצוניים. השימוש בממשקי ה-API האלה הוא אופציונלי, אבל מומלץ מאוד להשתמש בהם כדי לאפשר לצלילים חיצוניים להשתלב בצורה אופטימלית במערכת האקולוגית של Android ולספק חוויית משתמש חלקה.

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

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

AudioControl@2.0

בגרסה 2.0 של AudioControl HAL נוספו ממשקי ה-API החדשים הבאים:

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

מלבד registerFocusListener, הבקשות האלה הן oneway כדי להבטיח שמערכת Android לא תעכב את HAL בזמן עיבוד בקשת המיקוד. ה-HAL לא צריך להמתין עד לקבלת המיקוד לפני הפעלת צלילים קריטיים לבטיחות. ה-HAL לא חייב להאזין לשינויים במיקוד האודיו ולהגיב להם באמצעות IAudioControl#onAudioFocusChange.

שירות OEM להרשאת אודיו ברכב

ב-Android 14, ‏ AAOS הציגה את שירותי הפלאגין של יצרן הרכב המקורי כדי לאפשר הגדרה של רכיבים מסוימים ברכב. במקרה של Car Audio Plugin Service, שירות הפלאגין מאפשר ליצרני ציוד מקורי לנהל בקשות למיקוד שנחטפות על ידי שירות האודיו ברכב. כך יצרני ציוד מקורי (OEM) יכולים לנהל את המיקוד בצורה גמישה יותר בהתאם לדרישות הכללים והתקנות. לכן, האינטראקציה של מיקוד האודיו עשויה להיות שונה בין יצרנים שונים, ומאזור לאזור. ההנחה הבסיסית לגבי מיקוד אודיו עדיין תקפה: אפליקציות צריכות לבקש מיקוד כדי לנהל טוב יותר את האודיו ולשפר את חוויית המשתמש. באופן כללי, כללים מסוימים עדיין חלים על בקשות למיקוד אודיו מאפליקציות:

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

• בזמן שמיקוד המדיה פעיל:

  • אפליקציות שמבקשות להתמקד בשימוש בשיחות צריכות להיות מסוגלות לקבל את השיחה במקביל או באופן בלעדי.

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

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

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

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