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

این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

سیاست های صوتی را پیکربندی کنید

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

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

اندروید ۷.۰ یک فرمت فایل پیکربندی سیاست صوتی (XML) برای توصیف توپولوژی صوتی شما معرفی کرد.

نسخه‌های قبلی اندروید برای اعلام دستگاه‌های صوتی موجود در محصول شما، استفاده از device/<company>/<device>/audio/audio_policy.conf را الزامی می‌کردند (می‌توانید نمونه‌ای از این فایل را برای سخت‌افزار صوتی گلکسی نکسوس در device/samsung/tuna/audio/audio_policy.conf مشاهده کنید). با این حال، CONF یک فرمت ساده و اختصاصی است که برای توصیف توپولوژی‌های پیچیده برای دستگاه‌های عمودی مانند تلویزیون و خودرو بسیار محدود است.

اندروید ۷.۰ audio_policy.conf را منسوخ کرد و پشتیبانی از تعریف توپولوژی صوتی با استفاده از فرمت فایل XML که برای انسان خواناتر است، طیف گسترده‌ای از ابزارهای ویرایش و تجزیه را دارد و به اندازه کافی انعطاف‌پذیر است تا توپولوژی‌های صوتی پیچیده را توصیف کند، اضافه کرد. اندروید ۷.۰ از پرچم ساخت USE_XML_AUDIO_POLICY_CONF برای انتخاب فرمت XML فایل‌های پیکربندی استفاده می‌کند.

توجه: پشتیبانی از پرچم ساخت USE_XML_AUDIO_POLICY_CONF و در نتیجه امکان استفاده از فرمت منسوخ‌شده‌ی CONF در اندروید ۱۰ حذف شده است.

مزایای فرمت XML

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

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

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

فرمت و محل فایل

فایل پیکربندی جدید سیاست صوتی audio_policy_configuration.xml است و در مسیر /system/etc قرار دارد. مثال‌های زیر یک پیکربندی ساده از سیاست صوتی را در قالب فایل XML برای اندروید ۱۲ و نسخه‌های پایین‌تر از اندروید ۱۲ نشان می‌دهند.

نمایش مثال سیاست صوتی برای اندروید ۱۲

<?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>

نمایش مثال خط‌مشی صوتی برای نسخه‌های پایین‌تر از اندروید ۱۲

<?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 صوتی برای پخش و ضبط باز شوند.
پورت‌های دستگاه، دستگاه‌هایی را که می‌توانند متصل شوند، به همراه نوعشان (و در صورت لزوم، آدرس و ویژگی‌های صوتی اختیاری) توصیف می‌کنند.
مسیرها از توصیفگر پورت ترکیبی جدا شده‌اند و امکان توصیف مسیرها از دستگاهی به دستگاه دیگر یا جریانی به دستگاه دیگر را فراهم می‌کنند.

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

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

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

فایل‌ها فقط می‌توانند شامل عناصر سطح بالا باشند.
فایل‌ها نمی‌توانند شامل عناصر XInclude باشند.

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

A2DP: a2dp_audio_policy_configuration.xml
تغییر مسیر زیرمیکس: rsubmix_audio_policy_configuration.xml
یو‌اس‌بی: usb_audio_policy_configuration.xml

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

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

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

پیکربندی با استفاده از Parameter Framework

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

استفاده از سیاست صوتی قابل تنظیم، فروشندگان OEM را قادر می‌سازد تا:

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

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

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

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

APIهای مسیریابی سیاست صوتی

اندروید ۶.۰ یک API عمومی برای شمارش و انتخاب معرفی کرد که بر روی زیرساخت پورت صوتی/پچ صوتی قرار می‌گیرد و به توسعه‌دهندگان برنامه اجازه می‌دهد تا اولویت یک خروجی یا ورودی دستگاه خاص را برای رکوردها یا آهنگ‌های صوتی متصل مشخص کنند.

در اندروید ۷.۰، API شمارش و انتخاب توسط تست‌های CTS تأیید شده و برای شامل شدن مسیریابی برای جریان‌های صوتی بومی C/C++ (OpenSL ES) توسعه داده شده است. مسیریابی جریان‌های بومی همچنان در جاوا انجام می‌شود، با اضافه شدن یک رابط AudioRouting که جایگزین، ترکیب و منسوخ کردن روش‌های مسیریابی صریح مختص کلاس‌های AudioTrack و AudioRecord می‌شود.

برای جزئیات بیشتر در مورد API شمارش و انتخاب، به رابط‌های پیکربندی اندروید و 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

فرمت و محل فایل

نمایش مثال سیاست صوتی برای اندروید ۱۲

نمایش مثال خط‌مشی صوتی برای نسخه‌های پایین‌تر از اندروید ۱۲

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

نمایش حجم‌ها به عنوان مثال

موارد گنجانده شده در فایل

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

پیکربندی با استفاده از Parameter Framework

APIهای مسیریابی سیاست صوتی

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

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

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

سیاست های صوتی را پیکربندی کنید