إعداد سياسات الصوت

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

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

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

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

تم إيقاف audio_policy.conf نهائيًا في Android 7.0 ودعمه لتحديد طوبولوجيا صوتية باستخدام تنسيق ملف 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) نشطة.
  • لا يحتوي العميل على خدمة تعمل في المقدّمة أو واجهة مستخدم تعمل في المقدّمة.
  • وتتعرّف السياسة على الأدوار الخاصة:
    • خدمة مخصّصة لتسهيل الاستخدام: يمكن أن تسجّل المحتوى حتى في حال تفعيل حالة استخدام تراعي الخصوصية.
    • مساعد Google: يعتبر ذلك حساسًا للخصوصية إذا كانت واجهة المستخدم في أعلى الشاشة.
• تتمتع الملفات الشخصية الصوتية ببنية مشابهة لأدوات وصف الصوت البسيطة بمنفذ HDMI، مما يتيح مجموعة من معدلات أخذ العيّنات/أقنعة القنوات لكل تنسيق صوتي
• ثمة تعريفات واضحة لجميع عمليات الربط المحتملة بين الأجهزة وساحات المشاركات. في السابق، أتاحت القاعدة الضمنية إمكانية ربط جميع الأجهزة المتصلة بـ HAL نفسه. لمنع سياسة الصوت من التحكم في الاتصالات المطلوبة باستخدام تصحيح الصوت واجهات برمجة التطبيقات. في تنسيق XML، يحدد وصف المخطط قيود الاتصال.
• دعم يتضمن تجنُّب تكرار عمليات A2DP القياسية أو USB أو إعادة توجيه الإرسال التعريفات.
• تكون منحنيات الحجم قابلة للتخصيص. في السابق، كانت جداول الحجم غير قابلة للتغيير في البرنامج. في XML وتنسيقها، ووصف جداول الحجم ويمكن تخصيصها.

القالب في frameworks/av/services/audiopolicy/config/audio_policy_configuration.xml تعرض العديد من هذه الميزات قيد الاستخدام.

تنسيق الملف وموقعه

ملف إعداد السياسة الصوتية الجديد هو audio_policy_configuration.xml ويقع في /system/etc تعرض الأمثلة التالية ضبطًا بسيطًا لسياسة الصوت في تنسيق ملف XML لنظام التشغيل Android 12 والإصدارات الأقدم الإصدار 12 من نظام التشغيل Android.

عرض مثال على سياسة الصوت في 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.

يجب استخدام التضمينات لتجنُّب نسخ المشروع العادي المفتوح المصدر لنظام Android (AOSP). معلومات تكوينات وحدة HAL الصوتية لجميع تكوينات السياسة الصوتية الملفات (التي تكون عرضة للأخطاء). ملف XML الخاص بإعداد سياسة الصوت العادية لـ HALs الصوتية التالية:

• 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 إطار العمل، وهو إطار عمل مستند إلى المكونات الإضافية ومستند إلى القواعد للتعامل مع المعلمات.

يتيح استخدام سياسة الصوت القابلة للضبط للمصنّعين الأصليين للأجهزة تنفيذ ما يلي:

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

للحصول على تفاصيل حول واجهة برمجة تطبيقات التعداد والاختيار، يمكنك الاطّلاع على أجهزة Android واجهات الإعداد وOpenSLES_AndroidConfiguration.h. للحصول على تفاصيل حول التوجيه الصوتي، راجِع التوجيه الصوتي:

دعم قنوات متعددة

إذا كان الجهاز وبرنامج التشغيل يتيحان الصوت متعدد القنوات عبر 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 إلى صوت ستيريو تلقائيًا عند إرساله إلى جهاز سماعي غير مفعَّل تتيح لك هذه الميزة إنشاء محتوى صوتي متعدّد القنوات

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

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