اعتبارًا من 27 آذار (مارس) 2025، ننصحك باستخدام android-latest-release بدلاً من aosp-main لإنشاء AOSP والمساهمة فيه. لمزيد من المعلومات، يُرجى الاطّلاع على التغييرات في AOSP.

تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

ضبط سياسات الصوت

يتضمّن إصدار Android 10 إعادة تصميم كبيرة لمدير سياسات الصوت بهدف توفير المزيد من المرونة لدعم حالات الاستخدام المعقّدة في السيارات:

استراتيجيات التوجيه الخاصة بالمصنّع الأصلي للجهاز
مجموعات مستوى الصوت القابلة للتخصيص لمجموعات أنواع البث القديمة التي تستخدم منحنيات مستوى الصوت نفسها
استراتيجيات التوجيه التي يحدّدها محرك سياسة الصوت بدلاً من أن تكون مبرمَجة بشكل ثابت
منحنيات مستوى الصوت والمجموعات التي يديرها محرّك سياسة الصوت
إعادة تصميم داخلية استعدادًا لتقسيم مستقبلي بين الرموز البرمجية الشائعة والرموز البرمجية القابلة للإعداد، وتوفير إدارة أكثر شمولاً لأجهزة الصوت على سبيل المثال، استخدام جميع خصائص الجهاز وليس نوعه فقط في قواعد السياسة.

قدّمت الإصدار 7.0 من نظام التشغيل Android تنسيق ملف إعدادات سياسة الصوت (XML) لوصف بنية الصوت.

كانت إصدارات Android السابقة تتطلّب استخدام device/<company>/<device>/audio/audio_policy.conf للإعلان عن أجهزة الصوت المتوفّرة في منتجك (يمكنك الاطّلاع على مثال لهذا الملف الخاص بأجهزة الصوت في هاتف Galaxy Nexus في device/samsung/tuna/audio/audio_policy.conf). ومع ذلك، فإنّ CONF هو تنسيق بسيط خاص ومحدود جدًا بحيث لا يمكنه وصف التصاميم المعقّدة الخاصة بمجالات مثل أجهزة التلفزيون والسيارات.

أوقف الإصدار 7.0 من نظام التشغيل Android استخدام audio_policy.conf وأتاح إمكانية تحديد بنية الصوت باستخدام تنسيق ملف XML يسهل قراءته، ويتضمّن مجموعة كبيرة من أدوات التعديل والتحليل، ويتسم بالمرونة الكافية لوصف بنى الصوت المعقّدة. يستخدم الإصدار 7.0 من نظام Android علامة الإنشاء 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 نفسها، ما يمنع سياسة الصوت من التحكّم في عمليات الربط المطلوبة باستخدام واجهات برمجة التطبيقات الخاصة بتصحيح الصوت. في تنسيق 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 للصوت، حيث تحتوي كل وحدة على قائمة بمنافذ الخلط ومنافذ الأجهزة والمسارات:

تصف منافذ الخلط ملفات الإعداد المحتملة للبث التي يمكن فتحها في طبقة تجريد الأجهزة الصوتية (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 (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 حول إطار عمل المعلمات.

في الإصدار 10 من نظام التشغيل Android أو الإصدارات الأقدم، يتم اختيار سياسة الصوت القابلة للضبط باستخدام خيار الإصدار USE_CONFIGURABLE_AUDIO_POLICY. في نظام التشغيل Android 11 أو الإصدارات الأحدث، يتم اختيار إصدار محرك سياسة الصوت في الملف audio_policy_configuration.xml. لاختيار محرّك سياسة الصوت القابل للضبط، اضبط قيمة السمة engine_library للعنصر globalConfiguration على configurable كما في المثال التالي:

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

واجهات برمجة التطبيقات لتوجيه سياسة الصوت

قدّم الإصدار 6.0 من نظام التشغيل Android واجهة برمجة تطبيقات عامة خاصة بالتعداد والاختيار، وهي تستند إلى بنية أساسية خاصة بمنافذ الصوت وتتيح لمطوّري التطبيقات تحديد الجهاز المفضّل لإخراج الصوت أو إدخاله في التسجيلات أو المقاطع الصوتية المتصلة.

في نظام التشغيل Android 7.0، يتم التحقّق من صحة واجهة برمجة التطبيقات Enumeration and Selection API من خلال اختبارات CTS، ويتم توسيع نطاقها لتشمل توجيه بث الصوت الأصلي C/C++ (OpenSL ES). يستمر توجيه عمليات البث الأصلية بلغة Java، مع إضافة واجهة AudioRouting تحلّ محلّ طرق التوجيه الواضحة الخاصة بالفئتَين AudioTrack وAudioRecord وتدمجهما وتوقف استخدامهما.

للحصول على تفاصيل حول واجهة برمجة التطبيقات Enumeration and Selection، يُرجى الرجوع إلى واجهات ضبط 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

برامج ترميز الوسائط

ضبط سياسات الصوت