از سال ۲۰۲۶، برای هماهنگی با مدل توسعه پایدار اصلی خود و اطمینان از پایداری پلاتفرم برای بوم‌سازگان، کد منبع را در سه‌ماهه دوم و چهارم در AOSP منتشر خواهیم کرد. برای ساختن و همیاری در AOSP، از android-latest-release استفاده کنید. شاخه مانیفست android-latest-release همیشه به جدیدترین نسخه منتشرشده که به AOSP ارسال شده است ارجاع می‌دهد. برای اطلاعات بیشتر، تغییرات در AOSP را ببینید.

‫Google برای ترجمه محتوا به زبان ترجیحی شما از فناوری هوشواره استفاده می‌کند. ترجمه‌های هوشواره‌ای ممکن است اشتباه داشته باشند.

پیکربندی خط‌مشی‌های صوتی

نسخه Android 10 شامل بازسازی قابل‌توجهی در مدیر خط‌مشی صوتی است تا انعطاف‌پذیری بیشتری برای پشتیبانی از موارد استفاده پیچیده خودرو فراهم کند:

استراتژی‌های مسیریابی خاص سازنده اصلی محصول.
گروه‌های حجم قابل‌سفارشی‌سازی برای گروه‌های انواع جاری‌سازی قدیمی که از منحنی‌های حجم یکسان استفاده می‌کنند.
استراتژی‌های مسیریابی به‌جای کدگذاری سخت، توسط موتور خط‌مشی صوتی اعلام می‌شود.
منحنی‌های میزان صدا و گروه‌های مدیریت‌شده توسط موتور خط‌مشی صوتی.
بازسازی کد داخلی برای آماده‌سازی تقسیم آینده بین کد مشترک و کد قابل‌پیکربندی و ارائه مدیریت غنی‌تر دستگاه صوتی. برای مثال، استفاده از همه ویژگی‌های دستگاه، نه فقط نوع آن در قوانین خط‌مشی.

در 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 برای انتخاب قالب XML فایل‌های پیکربندی استفاده می‌کند.

توجه: پشتیبانی از پرچم ساخت USE_XML_AUDIO_POLICY_CONF و درنتیجه توانایی استفاده از قالب CONF منسوخ‌شده در Android 10 برداشته شد.

مزایای قالب XML

همانند فایل CONF، فایل XML امکان تعریف تعداد و انواع نمایه‌های جاری‌سازی برونداد و ورودی، دستگاه‌های قابل‌استفاده برای بازپخش و ضبط، و مشخصه‌های صوتی را فراهم می‌کند. علاوه‌براین، قالب XML بهبودهای زیر را ارائه می‌دهد:

در Android 10، استفاده هم‌زمان از بیش‌از یک برنامه ضبط فعال مجاز است.
- شروع ضبط هرگز به‌دلیل وضعیت هم‌زمان رد نمی‌شود.
- کاربرگ registerAudioRecordingCallback(AudioManager.AudioRecordingCallback cb) تغییرات مسیر ضبط را به مشتریان اطلاع می‌دهد.
در موقعیت‌های زیر، کارخواه نمونه‌های صوتی بی‌صدا دریافت می‌کند:
- مورد استفاده حساس به حریم خصوصی (برای مثال، VOICE_COMMUNICATION) فعال است.
- کارخواه سرویس پیش‌زمینه‌ای یا واسط کاربر پیش‌زمینه‌ای ندارد.
- نقش‌های ویژه توسط خط‌مشی تشخیص داده می‌شوند:
  - سرویس دسترس‌پذیری: حتی اگر مورد استفاده حساس به حریم خصوصی فعال باشد، می‌تواند ضبط کند.
  - «دستیار»: اگر میانای کاربری در بالا باشد، حساس به حریم خصوصی درنظر گرفته می‌شود.
ساختار نمایه‌های صوتی مشابه با توصیف‌گرهای صوتی ساده HDMI است و مجموعه‌ای متفاوت از نرخ‌های نمونه‌برداری/ماسک‌های کانال را برای هر قالب صوتی فعال می‌کند.
تعاریف صریحی برای همه اتصالات ممکن بین دستگاه‌ها و جاری‌سازی‌ها وجود دارد. قبلاً، یک قانون ضمنی امکان اتصال همه دستگاه‌های متصل به یک ماژول HAL را فراهم می‌کرد و از کنترل اتصالات درخواستی با APIهای وصله صوتی توسط خط‌مشی صوتی جلوگیری می‌کرد. در قالب XML، شرح توپولوژی محدودیت‌های اتصال را تعریف می‌کند.
پشتیبانی از شامل از تکرار تعریف‌های استاندارد A2DP،‏ USB، یا ارسال مجدد جلوگیری می‌کند.
منحنی‌های صدا قابل سفارشی‌سازی هستند. قبلاً، جدول‌های حجم کدبندی سخت می‌شدند. در قالب XML، جدول‌های حجم توصیف می‌شوند و می‌توانند سفارشی‌سازی شوند.

الگوی موجود در frameworks/av/services/audiopolicy/config/audio_policy_configuration.xml بسیاری از این ویژگی‌ها را درحال استفاده نشان می‌دهد.

قالب و مکان فایل

فایل پیکربندی خط‌مشی صوتی جدید audio_policy_configuration.xml است و در /system/etc قرار دارد. مثال‌های زیر پیکربندی خط‌مشی صوتی ساده‌ای را در قالب فایل «زبان نشانه‌گذاری توسعه‌پذیر» برای 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 صوتی مطابقت دارد، که هر ماژول دارای فهرستی از درگاه‌های ترکیبی، درگاه‌های دستگاه، و مسیرها است:

درگاه‌های ترکیبی نمایه‌های پیکربندی احتمالی را برای جاری‌سازی‌هایی که می‌توانند در HAL صوتی برای بازپخش و ضبط باز شوند توصیف می‌کنند.
درگاه‌های دستگاه دستگاه‌هایی را که می‌توانند متصل شوند با نوع آن‌ها (و درصورت لزوم نشانی و ویژگی‌های صوتی) توصیف می‌کنند.
مسیرها از توصیفگر درگاه ترکیبی جدا شده است و توصیف مسیرها از دستگاه به دستگاه یا جاری‌سازی به دستگاه را امکان‌پذیر می‌کند.

جدول‌های میزان صدا فهرست‌های ساده‌ای از نقاطی هستند که منحنی استفاده‌شده برای تبدیل شاخص واسط کاربر به میزان صدا در دسی‌بل را تعریف می‌کنند. یک فایل 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» استاندارد (AOSP) در همه فایل‌های پیکربندی خط‌مشی صوتی (که مستعد خطا است) استفاده کنید. یک فایل XML پیکربندی خط‌مشی صوتی استاندارد برای HALهای صوتی زیر ارائه شده است:

A2DP: a2dp_audio_policy_configuration.xml
تغییر مسیر زیرمیکس: rsubmix_audio_policy_configuration.xml
USB: usb_audio_policy_configuration.xml

سازمان کد خط‌مشی صوتی

‫AudioPolicyManager.cpp به چند واحد تقسیم شده است تا نگهداری و پیکربندی آن آسان شود. سازمان frameworks/av/services/audiopolicy شامل پیمانه‌های زیر است.

مدول	شرح
`/managerdefault`	شامل پیاده‌سازی رفتار و میاناهای عمومی مشترک بین همه برنامه‌ها می‌شود. مشابه `AudioPolicyManager.cpp` با عملکرد موتور و مفاهیم رایج انتزاعی.
`/common`	کلاس‌های پایه را تعریف می‌کند (برای مثال، ساختارهای داده برای نمایه‌های جاری‌سازی صوتی ورودی خروجی، توصیف‌گرهای دستگاه صوتی، وصله‌های صوتی، و درگاه‌های صوتی). این مورد قبلاً در `AudioPolicyManager.cpp` تعریف شده است.
`/engine`	قوانینی را که مشخص می‌کند کدام دستگاه و حجم باید برای مورد استفاده قرار گیرد اجرا می‌کند. این رابط استاندارد با بخش عمومی را پیاده‌سازی می‌کند، برای مثال، برای دریافت دستگاه مناسب برای یک مورد استفاده بازپخش یا ضبط خاص، یا برای تنظیم دستگاه‌های متصل یا وضعیت خارجی (یعنی وضعیت تماس استفاده اجباری) که می‌تواند تصمیم مسیریابی را تغییر دهد. در دو نسخه دردسترس است: پیکربندی‌پذیر و پیش‌فرض. برای اطلاعات مربوط به نحوه انتخاب نسخه، پیکربندی بااستفاده از چارچوب پارامتر را ببینید.
`/engineconfigurable`	پیاده‌سازی موتور خط‌مشی که به «چارچوب پارامتر» متکی است (به زیر مراجعه کنید). پیکربندی براساس «چارچوب پارامتر» است و خط‌مشی توسط فایل‌های XML تعریف می‌شود.
`/enginedefault`	پیاده‌سازی موتور خط‌مشی براساس پیاده‌سازی‌های قبلی «مدیر خط‌مشی صوتی Android». این حالت پیش‌فرض است و شامل قوانین سخت‌رمزی است که با پیاده‌سازی‌های Nexus و AOSP مطابقت دارد.
`/service`	شامل میاناهای صحافی، رشته‌بندی، و پیاده‌سازی قفل کردن با میانای بقیه چارچوب می‌شود.

پیکربندی بااستفاده از «چارچوب پارامتر»

کد خط‌مشی صوتی به‌گونه‌ای سازمان‌دهی شده است که درک و نگهداری آن آسان باشد و درعین‌حال از خط‌مشی صوتی که کاملاً توسط فایل‌های پیکربندی تعریف شده است پشتیبانی کند. سازمان و طراحی خط‌مشی صوتی براساس «چارچوب پارامتر Intel»، چارچوبی مبتنی بر افزایه و مبتنی بر قانون برای مدیریت پارامترها است.

استفاده از خط‌مشی صوتی پیکربندی‌پذیر به فروشندگان OEM امکان می‌دهد:

ساختار سیستم و پارامترهای آن را در XML توصیف کنید.
برای دسترسی به پارامترهای شرح‌داده‌شده، زیرینه (افزایه) بنویسید (به زبان ++C) یا از زیرینه موجود استفاده مجدد کنید.
شرایط/قوانینی را تعریف کنید (در XML یا در زبان خاص دامنه) که براساس آن‌ها پارامتر معینی باید مقدار معینی را بپذیرد.

‫AOSP شامل نمونه‌ای از فایل پیکربندی خط‌مشی صوتی است که از «چارچوب پارامتر» در Frameworks/av/services/audiopolicy/engineconfigurable/parameter-framework/example/Settings/PolicyConfigurableDomains.xml استفاده می‌کند. برای جزئیات، به اسناد Intel درباره چارچوب پارامتر مراجعه کنید.

در Android 10 یا پایین‌تر، خط‌مشی صوتی پیکربندی‌پذیر بااستفاده از گزینه ساخت USE_CONFIGURABLE_AUDIO_POLICY انتخاب می‌شود. در Android 11 یا بالاتر، نسخه موتور خط‌مشی صوتی در فایل audio_policy_configuration.xml انتخاب می‌شود. برای انتخاب موتور خط‌مشی صوتی قابل‌پیکربندی، مقدار مشخصه engine_library عنصر globalConfiguration را روی configurable تنظیم کنید، مانند مثال زیر:

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

میاناهای برنامه‌سازی کاربردی مسیریابی خط‌مشی صوتی

در Android 6.0، «میانای برنامه‌سازی کاربردی» عمومی «شمارش و انتخاب» معرفی شد که در بالای زیرساخت وصله صوتی/درگاه صوتی قرار دارد و به توسعه‌دهندگان برنامه امکان می‌دهد اولویت خود را برای خروجی یا ورودی دستگاه خاصی برای قطعه‌ها یا آهنگ‌های صوتی متصل نشان دهند.

در Android 7.0، «میانای برنامه‌سازی کاربردی شمارش و انتخاب» با آزمون‌های «مجموعه آزمون سازگاری» درستی‌سنجی می‌شود و برای شامل شدن مسیریابی برای جاری‌سازی‌های صوتی بومی 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 به‌طور خودکار محتوا را به صدای استریو تبدیل می‌کند.

کدک‌های رسانه

مطمئن شوید که کدک‌های صوتی که سخت‌افزار و درایورهای شما پشتیبانی می‌کنند به‌درستی برای محصولتان اعلام شده‌اند. برای جزئیات، به نمایش کدک‌ها در چارچوب مراجعه کنید.

پیکربندی خط‌مشی‌های صوتی با مجموعه‌ها، منظم بمانید ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.

مزایای قالب XML

قالب و مکان فایل

نمایش نمونه خط‌مشی صوتی برای Android 12

نمایش نمونه خط‌مشی صوتی برای نسخه‌های پایین‌تر از Android 12

نمایش نمونه جدول حجم

نمایش نمونه جلدها

گنجاندن فایل

سازمان کد خط‌مشی صوتی

پیکربندی بااستفاده از «چارچوب پارامتر»

میاناهای برنامه‌سازی کاربردی مسیریابی خط‌مشی صوتی

پشتیبانی چندکاناله

نمونه پیکربندی دستگاه HDMI را نشان دهید

کدک‌های رسانه

پیکربندی خط‌مشی‌های صوتی