החל מ-27 במרץ 2025, מומלץ להשתמש ב-android-latest-release במקום ב-aosp-main כדי ליצור תרומות ל-AOSP. מידע נוסף זמין במאמר שינויים ב-AOSP.

דף זה תורגם על ידי Cloud Translation API.

הגדרת כללי מדיניות האודיו

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

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

ב-Android 7.0 הושק פורמט קובץ הגדרות מדיניות אודיו (XML) לתיאור טופולוגיית האודיו.

בגרסאות קודמות של Android היה צריך להשתמש ב-device/<company>/<device>/audio/audio_policy.conf כדי להצהיר על מכשירי האודיו שקיימים במוצר (אפשר לראות דוגמה לקובץ הזה עבור חומרת האודיו של Galaxy Nexus ב-device/samsung/tuna/audio/audio_policy.conf). עם זאת, CONF הוא פורמט פשוט וקנייני שמוגבל מדי כדי לתאר טופולוגיות מורכבות עבור תעשיות כמו טלוויזיות ומכוניות.

ב-Android 7.0 הוצא משימוש audio_policy.conf והוספה תמיכה בהגדרת טופולוגיה של אודיו באמצעות פורמט קובץ XML שקל יותר לקריאה, שיש לו מגוון רחב של כלי עריכה וניתוח, והוא גמיש מספיק כדי לתאר טופולוגיות מורכבות של אודיו. ב-Android 7.0 נעשה שימוש בדגל USE_XML_AUDIO_POLICY_CONF build כדי לבחור את פורמט ה-XML של קובצי ההגדרות.

הערה: התמיכה בדגל ה-build‏ USE_XML_AUDIO_POLICY_CONF, ולכן גם האפשרות להשתמש בפורמט CONF שיצא משימוש, הוסרה ב-Android 10.

היתרונות של פורמט XML

בדומה לקובץ ה-CONF, קובץ ה-XML מאפשר להגדיר את המספר והסוגים של פרופילי פלט וקלט של סטרימינג, מכשירים שאפשר להשתמש בהם להפעלה וללכידה, ומאפייני אודיו. בנוסף, פורמט ה-XML כולל את השיפורים הבאים:

ב-Android 10, אפשר להפעיל בו-זמנית יותר מאפליקציית הקלטה אחת.
- התחלת ההקלטה אף פעם לא נדחית בגלל מצב של פעילות בו-זמנית.
- registerAudioRecordingCallback(AudioManager.AudioRecordingCallback cb) הקריאה החוזרת מודיעה ללקוחות על שינויים בנתיב הלכידה.
במצבים הבאים, לקוח מקבל דגימות אודיו שקטות:
- תרחיש שימוש שקשור לפרטיות (לדוגמה, VOICE_COMMUNICATION) פעיל.
- ללקוח אין שירות שפועל בחזית או ממשק משתמש שפועל בחזית.
- התפקידים המיוחדים שמוכרים במדיניות:
  - שירות נגישות: יכול להקליט גם אם תרחיש שימוש שקשור לפרטיות פעיל.
  - ‫Assistant: נחשבת רגישה לפרטיות אם ממשק המשתמש מוצג בחלק העליון.
לפרופילי אודיו יש מבנה שדומה לתיאורי אודיו פשוטים של HDMI, שמאפשר להגדיר קבוצה שונה של שיעורי דגימה או מסכות ערוצים לכל פורמט אודיו.
יש הגדרות ברורות לכל החיבורים האפשריים בין מכשירים לבין מקורות נתונים. בעבר, כלל מרומז אפשר לחבר את כל המכשירים שמצורפים לאותו מודול HAL, וכך מנע ממדיניות האודיו לשלוט בחיבורים שהתבקשו באמצעות ממשקי API של תיקון אודיו. בפורמט XML, תיאור הטופולוגיה מגדיר את מגבלות החיבור.
התמיכה ב-כולל מונעת חזרה על הגדרות סטנדרטיות של A2DP,‏ USB או הגשה של ניתוב מחדש.
אפשר להתאים אישית את עקומות עוצמת הקול. בעבר, טבלאות הנפח היו מקודדות. בפורמט XML, טבלאות הנפח מתוארות ואפשר להתאים אותן אישית.

בתבנית בכתובת frameworks/av/services/audiopolicy/config/audio_policy_configuration.xml אפשר לראות שימוש ברבות מהתכונות האלה.

פורמט הקובץ והמיקום

קובץ ההגדרה החדש של מדיניות האודיו הוא audio_policy_configuration.xml והוא נמצא בנתיב /system/etc. בדוגמאות הבאות מוצגת הגדרת מדיניות פשוטה לגבי אודיו בפורמט קובץ XML ל-Android 12 ולגרסאות שקודמות ל-Android 12.

דוגמה למדיניות אודיו ב-Android 12

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<audioPolicyConfiguration version="7.0" xmlns:xi="http://www.w3.org/2001/XInclude">
    <globalConfiguration speaker_drc_enabled="true"/>
    <modules>
        <module name="primary" halVersion="3.0">
            <attachedDevices>
                <item>Speaker</item>
                <item>Earpiece</item>
                <item>Built-In Mic</item>
            </attachedDevices>
            <defaultOutputDevice>Speaker</defaultOutputDevice>
            <mixPorts>
                <mixPort name="primary output" role="source" flags="AUDIO_OUTPUT_FLAG_PRIMARY">
                    <profile name="" format="AUDIO_FORMAT_PCM_16_BIT"
                             samplingRates="48000" channelMasks="AUDIO_CHANNEL_OUT_STEREO"/>
                </mixPort>
                <mixPort name="primary input" role="sink">
                    <profile name="" format="AUDIO_FORMAT_PCM_16_BIT"
                             samplingRates="8000 16000 48000"
                             channelMasks="AUDIO_CHANNEL_IN_MONO"/>
                </mixPort>
            </mixPorts>
            <devicePorts>
                <devicePort tagName="Earpiece" type="AUDIO_DEVICE_OUT_EARPIECE" role="sink">
                   <profile name="" format="AUDIO_FORMAT_PCM_16_BIT"
                            samplingRates="48000" channelMasks="AUDIO_CHANNEL_IN_MONO"/>
                </devicePort>
                <devicePort tagName="Speaker" role="sink" type="AUDIO_DEVICE_OUT_SPEAKER" address="">
                    <profile name="" format="AUDIO_FORMAT_PCM_16_BIT"
                             samplingRates="48000" channelMasks="AUDIO_CHANNEL_OUT_STEREO"/>
                </devicePort>
                <devicePort tagName="Wired Headset" type="AUDIO_DEVICE_OUT_WIRED_HEADSET" role="sink">
                    <profile name="" format="AUDIO_FORMAT_PCM_16_BIT"
                             samplingRates="48000" channelMasks="AUDIO_CHANNEL_OUT_STEREO"/>
                </devicePort>
                <devicePort tagName="Built-In Mic" type="AUDIO_DEVICE_IN_BUILTIN_MIC" role="source">
                    <profile name="" format="AUDIO_FORMAT_PCM_16_BIT"
                             samplingRates="8000 16000 48000"
                             channelMasks="AUDIO_CHANNEL_IN_MONO"/>
                </devicePort>
                <devicePort tagName="Wired Headset Mic" type="AUDIO_DEVICE_IN_WIRED_HEADSET" role="source">
                    <profile name="" format="AUDIO_FORMAT_PCM_16_BIT"
                             samplingRates="8000 16000 48000"
                             channelMasks="AUDIO_CHANNEL_IN_MONO"/>
                </devicePort>
            </devicePorts>
            <routes>
                <route type="mix" sink="Earpiece" sources="primary output"/>
                <route type="mix" sink="Speaker" sources="primary output"/>
                <route type="mix" sink="Wired Headset" sources="primary output"/>
                <route type="mix" sink="primary input" sources="Built-In Mic,Wired Headset Mic"/>
            </routes>
        </module>
        <xi:include href="a2dp_audio_policy_configuration.xml"/>
    </modules>

    <xi:include href="audio_policy_volumes.xml"/>
    <xi:include href="default_volume_tables.xml"/>
</audioPolicyConfiguration>

דוגמה למדיניות אודיו לגרסאות שקודמות ל-Android 12

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<audioPolicyConfiguration version="1.0" xmlns:xi="http://www.w3.org/2001/XInclude">
    <globalConfiguration speaker_drc_enabled="true"/>
    <modules>
        <module name="primary" halVersion="3.0">
            <attachedDevices>
                <item>Speaker</item>
                <item>Earpiece</item>
                <item>Built-In Mic</item>
            </attachedDevices>
            <defaultOutputDevice>Speaker</defaultOutputDevice>
            <mixPorts>
                <mixPort name="primary output" role="source" flags="AUDIO_OUTPUT_FLAG_PRIMARY">
                    <profile name="" format="AUDIO_FORMAT_PCM_16_BIT"
                             samplingRates="48000" channelMasks="AUDIO_CHANNEL_OUT_STEREO"/>
                </mixPort>
                <mixPort name="primary input" role="sink">
                    <profile name="" format="AUDIO_FORMAT_PCM_16_BIT"
                             samplingRates="8000,16000,48000"
                             channelMasks="AUDIO_CHANNEL_IN_MONO"/>
                </mixPort>
            </mixPorts>
            <devicePorts>
                <devicePort tagName="Earpiece" type="AUDIO_DEVICE_OUT_EARPIECE" role="sink">
                   <profile name="" format="AUDIO_FORMAT_PCM_16_BIT"
                            samplingRates="48000" channelMasks="AUDIO_CHANNEL_IN_MONO"/>
                </devicePort>
                <devicePort tagName="Speaker" role="sink" type="AUDIO_DEVICE_OUT_SPEAKER" address="">
                    <profile name="" format="AUDIO_FORMAT_PCM_16_BIT"
                             samplingRates="48000" channelMasks="AUDIO_CHANNEL_OUT_STEREO"/>
                </devicePort>
                <devicePort tagName="Wired Headset" type="AUDIO_DEVICE_OUT_WIRED_HEADSET" role="sink">
                    <profile name="" format="AUDIO_FORMAT_PCM_16_BIT"
                             samplingRates="48000" channelMasks="AUDIO_CHANNEL_OUT_STEREO"/>
                </devicePort>
                <devicePort tagName="Built-In Mic" type="AUDIO_DEVICE_IN_BUILTIN_MIC" role="source">
                    <profile name="" format="AUDIO_FORMAT_PCM_16_BIT"
                             samplingRates="8000,16000,48000"
                             channelMasks="AUDIO_CHANNEL_IN_MONO"/>
                </devicePort>
                <devicePort tagName="Wired Headset Mic" type="AUDIO_DEVICE_IN_WIRED_HEADSET" role="source">
                    <profile name="" format="AUDIO_FORMAT_PCM_16_BIT"
                             samplingRates="8000,16000,48000"
                             channelMasks="AUDIO_CHANNEL_IN_MONO"/>
                </devicePort>
            </devicePorts>
            <routes>
                <route type="mix" sink="Earpiece" sources="primary output"/>
                <route type="mix" sink="Speaker" sources="primary output"/>
                <route type="mix" sink="Wired Headset" sources="primary output"/>
                <route type="mix" sink="primary input" sources="Built-In Mic,Wired Headset Mic"/>
            </routes>
        </module>
        <xi:include href="a2dp_audio_policy_configuration.xml"/>
    </modules>

    <xi:include href="audio_policy_volumes.xml"/>
    <xi:include href="default_volume_tables.xml"/>
</audioPolicyConfiguration>

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

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

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

הצגת דוגמה לטבלת נפח

<?xml version="1.0" encoding="UTF-8"?>
<volumes>
    <reference name="FULL_SCALE_VOLUME_CURVE">
        <point>0,0</point>
        <point>100,0</point>
    </reference>
    <reference name="SILENT_VOLUME_CURVE">
        <point>0,-9600</point>
        <point>100,-9600</point>
    </reference>
    <reference name="DEFAULT_VOLUME_CURVE">
        <point>1,-4950</point>
        <point>33,-3350</point>
        <point>66,-1700</point>
        <point>100,0</point>
    </reference>
</volumes>

דוגמה להצגת נפחים

<?xml version="1.0" encoding="UTF-8"?>
<volumes>
    <volume stream="AUDIO_STREAM_VOICE_CALL" deviceCategory="DEVICE_CATEGORY_HEADSET" ref="DEFAULT_VOLUME_CURVE"/>
    <volume stream="AUDIO_STREAM_VOICE_CALL" deviceCategory="DEVICE_CATEGORY_SPEAKER" ref="DEFAULT_VOLUME_CURVE"/>
    <volume stream="AUDIO_STREAM_VOICE_CALL" deviceCategory="DEVICE_CATEGORY_EARPIECE" ref="DEFAULT_VOLUME_CURVE"/>
    <volume stream="AUDIO_STREAM_VOICE_CALL" deviceCategory="DEVICE_CATEGORY_EXT_MEDIA" ref="DEFAULT_VOLUME_CURVE"/>

    <volume stream="AUDIO_STREAM_SYSTEM" deviceCategory="DEVICE_CATEGORY_HEADSET" ref="DEFAULT_VOLUME_CURVE"/>
    <volume stream="AUDIO_STREAM_SYSTEM" deviceCategory="DEVICE_CATEGORY_SPEAKER" ref="DEFAULT_VOLUME_CURVE"/>
    <volume stream="AUDIO_STREAM_SYSTEM" deviceCategory="DEVICE_CATEGORY_EARPIECE" ref="DEFAULT_VOLUME_CURVE"/>
    <volume stream="AUDIO_STREAM_SYSTEM" deviceCategory="DEVICE_CATEGORY_EXT_MEDIA" ref="DEFAULT_VOLUME_CURVE"/>

    <volume stream="AUDIO_STREAM_RING" deviceCategory="DEVICE_CATEGORY_HEADSET" ref="DEFAULT_VOLUME_CURVE"/>
    <volume stream="AUDIO_STREAM_RING" deviceCategory="DEVICE_CATEGORY_SPEAKER" ref="DEFAULT_VOLUME_CURVE"/>
    <volume stream="AUDIO_STREAM_RING" deviceCategory="DEVICE_CATEGORY_EARPIECE" ref="DEFAULT_VOLUME_CURVE"/>
    <volume stream="AUDIO_STREAM_RING" deviceCategory="DEVICE_CATEGORY_EXT_MEDIA"ref="DEFAULT_VOLUME_CURVE"/>

    <volume stream="AUDIO_STREAM_MUSIC" deviceCategory="DEVICE_CATEGORY_HEADSET" ref="DEFAULT_VOLUME_CURVE"/>
    <volume stream="AUDIO_STREAM_MUSIC" deviceCategory="DEVICE_CATEGORY_SPEAKER">
        <point>1,-5500</point>
        <point>20,-4300</point>
        <point>86,-1200</point>
        <point>100,0</point>
    </volume>
    <volume stream="AUDIO_STREAM_MUSIC" deviceCategory="DEVICE_CATEGORY_EARPIECE" ref="DEFAULT_VOLUME_CURVE"/>
    <volume stream="AUDIO_STREAM_MUSIC" deviceCategory="DEVICE_CATEGORY_EXT_MEDIA" ref="DEFAULT_VOLUME_CURVE"/>

    <volume stream="AUDIO_STREAM_ALARM" deviceCategory="DEVICE_CATEGORY_HEADSET" ref="DEFAULT_VOLUME_CURVE"/>
    <volume stream="AUDIO_STREAM_ALARM" deviceCategory="DEVICE_CATEGORY_SPEAKER" ref="DEFAULT_VOLUME_CURVE"/>
    <volume stream="AUDIO_STREAM_ALARM" deviceCategory="DEVICE_CATEGORY_EARPIECE" ref="DEFAULT_VOLUME_CURVE"/>
    <volume stream="AUDIO_STREAM_ALARM" deviceCategory="DEVICE_CATEGORY_EXT_MEDIA" ref="DEFAULT_VOLUME_CURVE"/>

    <volume stream="AUDIO_STREAM_NOTIFICATION" deviceCategory="DEVICE_CATEGORY_HEADSET" ref="DEFAULT_VOLUME_CURVE"/>
    <volume stream="AUDIO_STREAM_NOTIFICATION" deviceCategory="DEVICE_CATEGORY_SPEAKER" ref="DEFAULT_VOLUME_CURVE"/>
    <volume stream="AUDIO_STREAM_NOTIFICATION" deviceCategory="DEVICE_CATEGORY_EARPIECE" ref="DEFAULT_VOLUME_CURVE"/>
    <volume stream="AUDIO_STREAM_NOTIFICATION" deviceCategory="DEVICE_CATEGORY_EXT_MEDIA" ref="DEFAULT_VOLUME_CURVE"/>

    <volume stream="AUDIO_STREAM_BLUETOOTH_SCO" deviceCategory="DEVICE_CATEGORY_HEADSET" ref="DEFAULT_VOLUME_CURVE"/>
    <volume stream="AUDIO_STREAM_BLUETOOTH_SCO" deviceCategory="DEVICE_CATEGORY_SPEAKER" ref="DEFAULT_VOLUME_CURVE"/>
    <volume stream="AUDIO_STREAM_BLUETOOTH_SCO" deviceCategory="DEVICE_CATEGORY_EARPIECE" ref="DEFAULT_VOLUME_CURVE"/>
    <volume stream="AUDIO_STREAM_BLUETOOTH_SCO" deviceCategory="DEVICE_CATEGORY_EXT_MEDIA" ref="DEFAULT_VOLUME_CURVE"/>

    <volume stream="AUDIO_STREAM_ENFORCED_AUDIBLE" deviceCategory="DEVICE_CATEGORY_HEADSET" ref="DEFAULT_VOLUME_CURVE"/>
    <volume stream="AUDIO_STREAM_ENFORCED_AUDIBLE" deviceCategory="DEVICE_CATEGORY_SPEAKER" ref="DEFAULT_VOLUME_CURVE"/>
    <volume stream="AUDIO_STREAM_ENFORCED_AUDIBLE" deviceCategory="DEVICE_CATEGORY_EARPIECE" ref="DEFAULT_VOLUME_CURVE"/>
    <volume stream="AUDIO_STREAM_ENFORCED_AUDIBLE" deviceCategory="DEVICE_CATEGORY_EXT_MEDIA" ref="DEFAULT_VOLUME_CURVE"/>

    <volume stream="AUDIO_STREAM_DTMF" deviceCategory="DEVICE_CATEGORY_SPEAKER" ref="DEFAULT_VOLUME_CURVE"/>
    <volume stream="AUDIO_STREAM_DTMF" deviceCategory="DEVICE_CATEGORY_SPEAKER" ref="DEFAULT_VOLUME_CURVE"/>
    <volume stream="AUDIO_STREAM_DTMF" deviceCategory="DEVICE_CATEGORY_EARPIECE" ref="DEFAULT_VOLUME_CURVE"/>
    <volume stream="AUDIO_STREAM_DTMF" deviceCategory="DEVICE_CATEGORY_EXT_MEDIA" ref="DEFAULT_VOLUME_CURVE"/>

    <volume stream="AUDIO_STREAM_TTS" deviceCategory="DEVICE_CATEGORY_HEADSET" ref="SILENT_VOLUME_CURVE"/>
    <volume stream="AUDIO_STREAM_TTS" deviceCategory="DEVICE_CATEGORY_SPEAKER" ref="FULL_SCALE_VOLUME_CURVE"/>
    <volume stream="AUDIO_STREAM_TTS" deviceCategory="DEVICE_CATEGORY_EARPIECE" ref="SILENT_VOLUME_CURVE"/>
    <volume stream="AUDIO_STREAM_TTS" deviceCategory="DEVICE_CATEGORY_EXT_MEDIA" ref="SILENT_VOLUME_CURVE"/>

    <volume stream="AUDIO_STREAM_ACCESSIBILITY" deviceCategory="DEVICE_CATEGORY_HEADSET" ref="DEFAULT_VOLUME_CURVE"/>
    <volume stream="AUDIO_STREAM_ACCESSIBILITY" deviceCategory="DEVICE_CATEGORY_SPEAKER" ref="DEFAULT_VOLUME_CURVE"/>
    <volume stream="AUDIO_STREAM_ACCESSIBILITY" deviceCategory="DEVICE_CATEGORY_EARPIECE" ref="DEFAULT_VOLUME_CURVE"/>
    <volume stream="AUDIO_STREAM_ACCESSIBILITY" deviceCategory="DEVICE_CATEGORY_EXT_MEDIA" ref="DEFAULT_VOLUME_CURVE"/>

    <volume stream="AUDIO_STREAM_REROUTING" deviceCategory="DEVICE_CATEGORY_HEADSET" ref="FULL_SCALE_VOLUME_CURVE"/>
    <volume stream="AUDIO_STREAM_REROUTING" deviceCategory="DEVICE_CATEGORY_SPEAKER" ref="FULL_SCALE_VOLUME_CURVE"/>
    <volume stream="AUDIO_STREAM_REROUTING" deviceCategory="DEVICE_CATEGORY_EARPIECE" ref="FULL_SCALE_VOLUME_CURVE"/>
    <volume stream="AUDIO_STREAM_REROUTING" deviceCategory="DEVICE_CATEGORY_EXT_MEDIA" ref="FULL_SCALE_VOLUME_CURVE"/>

    <volume stream="AUDIO_STREAM_PATCH" deviceCategory="DEVICE_CATEGORY_HEADSET" ref="FULL_SCALE_VOLUME_CURVE"/>
    <volume stream="AUDIO_STREAM_PATCH" deviceCategory="DEVICE_CATEGORY_SPEAKER" ref="FULL_SCALE_VOLUME_CURVE"/>
    <volume stream="AUDIO_STREAM_PATCH" deviceCategory="DEVICE_CATEGORY_EARPIECE" ref="FULL_SCALE_VOLUME_CURVE"/>
    <volume stream="AUDIO_STREAM_PATCH" deviceCategory="DEVICE_CATEGORY_EXT_MEDIA" ref="FULL_SCALE_VOLUME_CURVE"/>
</volumes>

הכללות של קבצים

אפשר להשתמש בשיטת הכללות XML ‏ (XInclude) כדי לכלול מידע על הגדרות מדיניות אודיו שנמצא בקובצי XML אחרים. כל הקבצים הכלולים צריכים להיות מובנים בפורמט שמתואר למעלה, עם ההגבלות הבאות:

הקבצים יכולים להכיל רק רכיבים ברמה העליונה.
קבצים לא יכולים להכיל רכיבי XInclude.

כדי להימנע מהעתקה של מידע על הגדרות של מודול HAL של אודיו בפרויקט Android Open Source Project‏ (AOSP) לכל קובצי ההגדרות של מדיניות האודיו (שעלולה לגרום לשגיאות), צריך להשתמש בהכללות. קובץ XML סטנדרטי להגדרת מדיניות אודיו מסופק עבור HALs של אודיו מהסוגים הבאים:

‫A2DP: a2dp_audio_policy_configuration.xml
Reroute submix: rsubmix_audio_policy_configuration.xml
‫USB: usb_audio_policy_configuration.xml

ארגון קוד המדיניות בנושא אודיו

‫AudioPolicyManager.cpp מחולק לכמה מודולים כדי שיהיה קל לתחזק ולהגדיר אותו. הארגון של frameworks/av/services/audiopolicy כולל את המודולים הבאים.

מודול	תיאור
`/managerdefault`	כולל את הממשקים הגנריים והתנהגות ההטמעה שמשותפים לכל האפליקציות. בדומה ל-`AudioPolicyManager.cpp`, עם פונקציונליות של מנוע ומושגים נפוצים שמוסתרים.
`/common`	הגדרת מחלקות בסיס (לדוגמה, מבני נתונים לפרופילים של זרם אודיו של קלט/פלט, תיאורים של מכשירי אודיו, תיקוני אודיו ויציאות אודיו). ההגדרה הזו הייתה קודם בתוך `AudioPolicyManager.cpp`.
`/engine`	המדיניות הזו מטמיעה את הכללים שמגדירים באילו מכשירים ובאילו אמצעי אחסון צריך להשתמש בתרחיש שימוש מסוים. הוא מיישם ממשק סטנדרטי עם החלק הגנרי, למשל כדי לקבל את המכשיר המתאים לתרחיש שימוש נתון של הפעלה או לכידה, או כדי להגדיר מכשירים מחוברים או מצב חיצוני (כלומר, מצב שיחה של שימוש מאולץ) שיכול לשנות את החלטת הניתוב. התכונה זמינה בשתי גרסאות: ניתנת להגדרה וברירת מחדל. מידע על בחירת הגרסה זמין במאמר הגדרה באמצעות Parameter Framework.
`/engineconfigurable`	הטמעה של מנוע מדיניות שמסתמכת על Parameter Framework (מסגרת פרמטרים) (ראו בהמשך). ההגדרה מבוססת על Parameter Framework, והמדיניות מוגדרת על ידי קובצי XML.
`/enginedefault`	הטמעה של מנוע מדיניות שמבוססת על הטמעות קודמות של Android Audio Policy Manager. זוהי הגדרת ברירת המחדל, והיא כוללת כללים שמוטמעים בקוד ומתאימים להטמעות של Nexus ו-AOSP.
`/service`	כולל ממשקי binder, שרשור ויישום נעילה עם הממשק לשאר המסגרת.

הגדרה באמצעות Parameter Framework

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

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

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

‫AOSP כולל דוגמה לקובץ הגדרות מדיניות אודיו שמשתמש ב-Parameter Framework בכתובת Frameworks/av/services/audiopolicy/engineconfigurable/parameter-framework/example/Settings/PolicyConfigurableDomains.xml. פרטים נוספים מופיעים במסמכי התיעוד של Intel בנושא Parameter Framework.

ב-Android מגרסה 10 ומטה, מדיניות האודיו שניתנת להגדרה נבחרת באמצעות אפשרות ה-build‏ USE_CONFIGURABLE_AUDIO_POLICY. ב-Android 11 ומעלה, הגרסה של מנוע מדיניות האודיו נבחרת בקובץ audio_policy_configuration.xml. כדי לבחור את מנוע מדיניות האודיו שניתן להגדרה, מגדירים את הערך של המאפיין engine_library של רכיב globalConfiguration ל-configurable כמו בדוגמה הבאה:

<audioPolicyConfiguration>
    <globalConfiguration engine_library="configurable" />
...
</audioPolicyConfiguration>

ממשקי API של ניתוב מדיניות אודיו

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

ב-Android 7.0, ה-API של Enumeration and Selection מאומת על ידי בדיקות CTS, והוא מורחב כך שיכלול ניתוב של זרמי אודיו מקוריים של C/C++‎ ‏ (OpenSL ES). הניתוב של סטרימינג מקורי ממשיך להתבצע ב-Java, עם הוספה של ממשק AudioRouting שמחליף את שיטות הניתוב המפורשות שהיו ספציפיות למחלקות AudioTrack ו-AudioRecord, משלב אותן ומוציא אותן משימוש.

פרטים על Enumeration and Selection API זמינים במאמרים ממשקי הגדרה של Android ו-OpenSLES_AndroidConfiguration.h. לפרטים על ניתוב אודיו, אפשר לעיין במאמר בנושא AudioRouting.

תמיכה במגוון ערוצים

אם החומרה והדרייבר תומכים באודיו רב-ערוצי דרך HDMI, אפשר להוציא את זרם האודיו ישירות לחומרת האודיו (הפעולה הזו מדלגת על המיקסר AudioFlinger, כך שלא מתבצעת המרה של האודיו לשני ערוצים). ה-HAL של האודיו צריך לחשוף אם פרופיל של זרם פלט תומך ביכולות של אודיו רב-ערוצי. אם HAL חושף את היכולות שלו, מנהל המדיניות שמוגדר כברירת מחדל מאפשר הפעלה של כמה ערוצים דרך HDMI. פרטים על ההטמעה זמינים במאמר device/samsung/tuna/audio/audio_hw.c.

כדי לציין שהמוצר שלכם מכיל פלט אודיו רב-ערוצי, עורכים את קובץ ההגדרות של מדיניות האודיו כדי לתאר את הפלט הרב-ערוצי של המוצר. בדוגמה הבאה מתוך frameworks/av/services/audiopolicy/config/primary_audio_policy_configuration_tv.xml מוצגת מסכת ערוצים דינמית, כלומר מנהל מדיניות האודיו שולח שאילתה למסכות הערוצים שנתמכות על ידי יעד ה-HDMI אחרי החיבור.

הצגת דוגמה להגדרת מכשיר HDMI

<module name="primary" halVersion="2.0">
    <attachedDevices>
        <item>Speaker</item>
    </attachedDevices>
    <defaultOutputDevice>Speaker</defaultOutputDevice>
    <mixPorts>
        <mixPort name="primary output" role="source" flags="AUDIO_OUTPUT_FLAG_PRIMARY">
            <profile name="" format="AUDIO_FORMAT_PCM_16_BIT"
                     samplingRates="48000" channelMasks="AUDIO_CHANNEL_OUT_STEREO"/>
        </mixPort>
        <mixPort name="direct" role="source" flags="AUDIO_OUTPUT_FLAG_DIRECT" />
        <mixPort name="tunnel" role="source"
                 flags="AUDIO_OUTPUT_FLAG_DIRECT|AUDIO_OUTPUT_FLAG_HW_AV_SYNC" />
   </mixPorts>
   <devicePorts>
        <devicePort tagName="Speaker" type="AUDIO_DEVICE_OUT_SPEAKER" role="sink" />
        <devicePort tagName="Out Aux Digital" type="AUDIO_DEVICE_OUT_AUX_DIGITAL" role="sink"
                    encodedFormats="AUDIO_FORMAT_AC3 AUDIO_FORMAT_IEC61937" />
    </devicePorts>
    <routes>
        <route type="mix" sink="Speaker" sources="primary output"/>
        <route type="mix" sink="Out Aux Digital" sources="primary output,direct,tunnel"/>
    </routes>
</module>

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

קודקים של מדיה

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

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

היתרונות של פורמט XML

פורמט הקובץ והמיקום

דוגמה למדיניות אודיו ב-Android 12

דוגמה למדיניות אודיו לגרסאות שקודמות ל-Android 12

הצגת דוגמה לטבלת נפח

דוגמה להצגת נפחים

הכללות של קבצים

ארגון קוד המדיניות בנושא אודיו

הגדרה באמצעות Parameter Framework

ממשקי API של ניתוב מדיניות אודיו

תמיכה במגוון ערוצים

הצגת דוגמה להגדרת מכשיר HDMI

קודקים של מדיה

הגדרת כללי מדיניות האודיו