تمت ترجمة هذه الصفحة بواسطة 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 لاختيار تنسيق 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 لتكوين سياسة الصوت القياسية لـ HALs الصوتية التالية:

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`	ينفذ القواعد التي تحدد الجهاز ووحدات التخزين التي يجب استخدامها لحالة استخدام معينة. يقوم بتنفيذ واجهة قياسية مع الجزء العام، مثل الحصول على الجهاز المناسب لحالة استخدام معينة للتشغيل أو الالتقاط، أو لتعيين الأجهزة المتصلة أو الحالة الخارجية (أي حالة اتصال للاستخدام القسري) التي يمكن أن تغير التوجيه قرار. متوفر في نسختين: شكلي وافتراضي . للحصول على معلومات حول كيفية تحديد الإصدار، راجع التكوين باستخدام Parameter Framework .
`/engineconfigurable`	تنفيذ محرك السياسة الذي يعتمد على Parameter Framework (انظر أدناه). يعتمد التكوين على Parameter Framework وحيث يتم تعريف السياسة بواسطة ملفات XML.
`/enginedefault`	تنفيذ محرك السياسة استنادًا إلى تطبيقات Android Audio Policy Manager السابقة. هذا هو الإعداد الافتراضي ويتضمن قواعد مضمنة تتوافق مع تطبيقات Nexus وAOSP.
`/service`	يتضمن واجهات الموثق، والترابط، وتنفيذ القفل مع الواجهة لبقية إطار العمل.

التكوين باستخدام إطار المعلمة

تم تنظيم كود سياسة الصوت لتسهيل فهمه وصيانته مع دعم أيضًا سياسة الصوت المحددة بالكامل بواسطة ملفات التكوين. يعتمد تصميم التنظيم والسياسة الصوتية على Intel's Parameter Framework، وهو إطار عمل قائم على المكونات الإضافية وقائم على القواعد للتعامل مع المعلمات.

يتيح استخدام سياسة الصوت القابلة للتكوين لمصنعي المعدات الأصلية للموردين القيام بما يلي:

وصف بنية النظام ومعلماته في XML.
اكتب (في C++) أو أعد استخدام الواجهة الخلفية (المكون الإضافي) للوصول إلى المعلمات الموضحة.
حدد (في XML أو بلغة خاصة بالمجال) الشروط/القواعد التي يجب أن تأخذ المعلمة المحددة قيمة معينة بناءً عليها.

يتضمن AOSP مثالاً لملف تكوين سياسة الصوت الذي يستخدم Parameter Framework في Frameworks/av/services/audiopolicy/engineconfigurable/parameter-framework/example/Settings/PolicyConfigurableDomains.xml . للحصول على التفاصيل، راجع وثائق Intel في Parameter Framework .

في نظام التشغيل 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، تم التحقق من واجهة برمجة التطبيقات Enumeration and Selection API من خلال اختبارات CTS وتم توسيعها لتشمل التوجيه للتدفقات الصوتية الأصلية لـ C/C++ (OpenSL ES). يستمر توجيه التدفقات الأصلية في Java، مع إضافة واجهة AudioRouting التي تحل محل طرق التوجيه الصريحة التي كانت خاصة بفئتي AudioTrack و AudioRecord ودمجها وإهمالها.

للحصول على تفاصيل حول واجهة برمجة تطبيقات التعداد والتحديد، راجع واجهات تكوين 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 بخلط المحتوى إلى الاستريو تلقائيًا عند إرساله إلى جهاز صوتي لا يدعم الصوت متعدد القنوات.

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

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