Google cam kết thúc đẩy công bằng chủng tộc cho Cộng đồng người da đen. Xem cách thực hiện.

Trang này được dịch bởi Cloud Translation API.

Định cấu hình chính sách âm thanh

Bản phát hành Android 10 tái cấu trúc đáng kể âm thanh trình quản lý chính sách để linh hoạt hơn nhằm hỗ trợ các trường hợp sử dụng ô tô phức tạp:

Chiến lược định tuyến dành riêng cho OEM.
Nhóm âm lượng có thể tuỳ chỉnh cho các nhóm loại luồng cũ sử dụng cùng đường cong âm lượng.
Các chiến lược định tuyến được công cụ chính sách âm thanh khai báo thay vì được mã hoá cứng.
Nhóm và đường cong âm lượng do công cụ chính sách âm thanh quản lý.
Tái cấu trúc nội bộ để chuẩn bị cho việc phân chia trong tương lai giữa mã chung và mã có thể định cấu hình và cung cấp tính năng quản lý thiết bị âm thanh phong phú hơn. Ví dụ: việc sử dụng tất cả thuộc tính thiết bị, không chỉ loại tương ứng trong quy tắc chính sách.

Android 7.0 ra mắt một định dạng tệp cấu hình chính sách âm thanh (XML) cho mô tả cấu trúc liên kết âm thanh của bạn.

Các bản phát hành Android trước đây phải sử dụng device/<company>/<device>/audio/audio_policy.conf để khai báo các thiết bị âm thanh có trên sản phẩm (bạn có thể xem ví dụ về tệp này cho phần cứng âm thanh Galaxy Nexus trong device/samsung/tuna/audio/audio_policy.conf). Tuy nhiên, CONF là một định dạng đơn giản, thuộc quyền sở hữu riêng quá giới hạn nên không thể mô tả những lời xin lỗi phức tạp đối với các ngành dọc như TV và ô tô.

Android 7.0 không dùng audio_policy.conf nữa và có thêm tính năng hỗ trợ để xác định cấu trúc liên kết âm thanh bằng cách sử dụng định dạng tệp XML, con người có thể đọc được, có nhiều loại công cụ chỉnh sửa và phân tích cú pháp, đồng thời linh hoạt đủ để mô tả những lời xin lỗi âm thanh phức tạp. Android 7.0 sử dụng Cờ bản dựng USE_XML_AUDIO_POLICY_CONF để chọn XML của các tệp cấu hình.

Lưu ý: Hỗ trợ cho USE_XML_AUDIO_POLICY_CONF gắn cờ xây dựng và do đó có khả năng sử dụng định dạng CONF không dùng nữa đã bị xoá trong Android 10.

Ưu điểm của định dạng XML

Như trong tệp CONF, tệp XML cho phép xác định số lượng và loại cấu hình luồng đầu ra và đầu vào, các thiết bị có thể sử dụng để phát và chụp, và thuộc tính âm thanh. Ngoài ra, định dạng XML còn có những tính năng nâng cao sau:

Trong Android 10, nhiều ứng dụng ghi âm đang hoạt động được phép đồng thời.
- Quá trình bắt đầu ghi không bao giờ bị từ chối do tình huống đồng thời.
- registerAudioRecordingCallback(AudioManager.AudioRecordingCallback cb) lệnh gọi lại thông báo cho ứng dụng khách về các thay đổi đối với đường dẫn chụp.
Trong những trường hợp sau, máy khách sẽ nhận được mẫu âm thanh im lặng:
- Một trường hợp sử dụng nhạy cảm về quyền riêng tư (ví dụ: VOICE_COMMUNICATION) đang hoạt động.
- Ứng dụng không có dịch vụ trên nền trước hoặc giao diện người dùng trên nền trước.
- Chính sách công nhận các vai trò đặc biệt:
  - Dịch vụ hỗ trợ tiếp cận: Có thể ghi âm ngay cả khi một trường hợp sử dụng nhạy cảm về quyền riêng tư đang hoạt động.
  - Trợ lý: Được coi là nhạy cảm về quyền riêng tư nếu giao diện người dùng nằm ở trên cùng.
Các cấu hình âm thanh có cấu trúc tương tự như bộ mô tả âm thanh đơn giản HDMI, cho phép bộ tốc độ lấy mẫu/mặt nạ kênh cho từng định dạng âm thanh.
Có định nghĩa rõ ràng cho tất cả các kết nối có thể có giữa thiết bị và luồng. Trước đây, quy tắc ngầm ẩn cho phép kết nối tất cả các thiết bị được gắn với cùng một HAL mô-đun, ngăn chính sách âm thanh kiểm soát các kết nối được yêu cầu bằng bản vá âm thanh API. Trong định dạng XML, phần mô tả cấu trúc liên kết xác định các giới hạn kết nối.
Việc hỗ trợ cho bao gồm giúp tránh lặp lại quy trình gửi A2DP, USB tiêu chuẩn hoặc định tuyến lại định nghĩa.
Đường cong âm lượng có thể tuỳ chỉnh được. Trước đây, bảng âm lượng được mã hoá cứng. Trong tệp XML định dạng, bảng khối lượng được mô tả và có thể tuỳ chỉnh.

Mẫu tại frameworks/av/services/audiopolicy/config/audio_policy_configuration.xml cho thấy nhiều tính năng trong số này đang được sử dụng.

Định dạng tệp và vị trí

Tệp cấu hình chính sách âm thanh mới là audio_policy_configuration.xml và nằm ở /system/etc Các ví dụ sau đây minh hoạ một cấu hình chính sách âm thanh đơn giản trong Định dạng tệp XML cho Android 12 và các phiên bản bên dưới Android 12.

Hiện ví dụ về chính sách âm thanh cho 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>

Hiện ví dụ về chính sách âm thanh cho các phiên bản Android 12 trở xuống

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

Cấu trúc cấp cao nhất chứa các mô-đun tương ứng với mỗi lớp âm thanh HAL mô-đun phần cứng, trong đó mỗi mô-đun có một danh sách các cổng kết hợp, cổng thiết bị và tuyến đường:

Kết hợp cổng mô tả các cấu hình có thể có cho luồng có thể mở ở HAL âm thanh để phát lại và ghi lại.
Cổng thiết bị mô tả những thiết bị có thể kết nối loại của chúng (và tuỳ ý địa chỉ và các thuộc tính âm thanh, nếu thích hợp).
Tuyến đường được tách biệt với chỉ số mô tả cổng kết hợp, bật tính năng mô tả các tuyến đường từ thiết bị này đến thiết bị khác hoặc truyền trực tuyến đến thiết bị.

Bảng âm lượng là danh sách đơn giản gồm các điểm xác định đường cong được dùng để dịch từ chỉ mục giao diện người dùng sang âm lượng tính bằng dB. Tệp "include" riêng biệt cung cấp giá trị mặc định Tuy nhiên, mỗi đường cong cho một trường hợp sử dụng và danh mục thiết bị nhất định có thể bị ghi đè.

Hiển thị ví dụ về bảng âm lượng

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

Hiện ví dụ về tập

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

Bao gồm tệp

Bạn có thể sử dụng phương thức XML Inclusions (XInclude) để thêm chính sách về âm thanh thông tin cấu hình nằm trong các tệp XML khác. Tất cả tệp được đưa vào phải tuân theo cấu trúc được mô tả ở trên với các hạn chế sau:

Tệp chỉ có thể chứa các phần tử cấp cao nhất.
Tệp không được chứa các phần tử XInclude.

Sử dụng bao gồm để tránh sao chép Dự án nguồn mở Android (AOSP) tiêu chuẩn thông tin về cấu hình mô-đun HAL âm thanh cho tất cả cấu hình chính sách âm thanh (dễ bị lỗi). Tệp XML cấu hình chính sách âm thanh chuẩn được cung cấp cho các HAL âm thanh sau đây:

A2DP: a2dp_audio_policy_configuration.xml
Định tuyến lại danh sách phụ: rsubmix_audio_policy_configuration.xml
USB: usb_audio_policy_configuration.xml

Sắp xếp mã chính sách âm thanh

AudioPolicyManager.cpp được chia thành nhiều mô-đun để dễ dàng duy trì và định cấu hình. Tổ chức của frameworks/av/services/audiopolicy bao gồm các mô-đun sau.

Mô-đun	Mô tả
`/managerdefault`	Bao gồm những giao diện chung và cách triển khai hành vi chung cho tất cả mọi người của chúng tôi. Tương tự như `AudioPolicyManager.cpp` khi có công cụ chức năng và các khái niệm phổ biến bị loại bỏ.
`/common`	Xác định các lớp cơ sở (ví dụ: cấu trúc dữ liệu cho luồng âm thanh đầu vào cấu hình, mã mô tả thiết bị âm thanh, bản vá âm thanh và cổng âm thanh). Trước đây là được xác định bên trong `AudioPolicyManager.cpp`.
`/engine`	Triển khai các quy tắc xác định thiết bị và ổ đĩa nào sẽ được sử dụng một trường hợp sử dụng cụ thể. Công cụ này triển khai một giao diện chuẩn với phần chung, chẳng hạn như để có được thiết bị thích hợp cho một trường hợp sử dụng phát hoặc ghi hình nhất định, hoặc để đặt thiết bị đã kết nối hoặc trạng thái bên ngoài (tức là trạng thái cuộc gọi sử dụng bắt buộc) có thể thay đổi quyết định định tuyến. Có hai phiên bản: có thể định cấu hình và mặc định. Để biết thông tin về cách chọn phiên bản, hãy xem Cấu hình bằng Khung thông số.
`/engineconfigurable`	Quy trình triển khai công cụ chính sách dựa trên Khung thông số (xem bên dưới). Cấu hình dựa trên Khung thông số và vị trí của chính sách do các tệp XML xác định.
`/enginedefault`	Triển khai công cụ chính sách dựa trên Trình quản lý chính sách âm thanh trên Android trước đây thực tế. Đây là chế độ mặc định và bao gồm các quy tắc được cố định giá trị trong mã tương ứng với triển khai Nexus và AOSP.
`/service`	Bao gồm các giao diện liên kết, tạo luồng và khoá khi triển khai bằng giao diện với phần còn lại của khung.

Định cấu hình bằng Khung thông số

Mã chính sách dạng âm thanh được sắp xếp sao cho dễ hiểu và dễ hiểu duy trì mà vẫn hỗ trợ chính sách âm thanh được xác định hoàn toàn theo cấu hình tệp. Thiết kế của tổ chức và chính sách âm thanh dựa trên Tham số của Intel Khung dựa trên trình bổ trợ và quy tắc để xử lý các tham số.

Việc sử dụng chính sách âm thanh có thể định cấu hình cho phép OEM của nhà cung cấp:

Mô tả cấu trúc và các tham số của hệ thống trong XML.
Viết (trong C++) hoặc sử dụng lại phần phụ trợ (trình bổ trợ) để truy cập vào nội dung được mô tả tham số.
Xác định điều kiện/quy tắc (trong XML hoặc bằng ngôn ngữ miền cụ thể) mà theo đó một tham số nhất định phải nhận một giá trị nhất định.

AOSP có một ví dụ về tệp cấu hình chính sách âm thanh sử dụng Parameters Khung tại Frameworks/av/services/audiopolicy/engineconfigurable/parameter-framework/example/Settings/PolicyConfigurableDomains.xml. Cho hãy tham khảo tài liệu của Intel trên Khung thông số.

Trên Android 10 trở xuống, chính sách về âm thanh có thể định cấu hình được chọn bằng tuỳ chọn bản dựng USE_CONFIGURABLE_AUDIO_POLICY. Trên Android 11 trở lên, phiên bản của chính sách âm thanh công cụ được chọn trong tệp audio_policy_configuration.xml. Để chọn công cụ chính sách âm thanh có thể định cấu hình, hãy đặt giá trị của engine_library thuộc tính của phần tử globalConfiguration với configurable như trong ví dụ sau:

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

API định tuyến chính sách âm thanh

Android 6.0 ra mắt một API Enumeration và Selection API công khai nằm trên ở đầu cơ sở hạ tầng bản vá âm thanh/cổng âm thanh và cho phép ứng dụng nhà phát triển cho biết lựa chọn ưu tiên về một đầu ra hoặc đầu vào cụ thể của thiết bị bản ghi hoặc bản âm thanh được kết nối.

Trong Android 7.0, Enumeration and Selection API được xác minh qua các bài kiểm thử CTS và được mở rộng để bao gồm cả chức năng định tuyến cho các luồng âm thanh C/C++ (OpenSL ES) gốc. Việc định tuyến các luồng gốc tiếp tục được thực hiện trong Java, với việc bổ sung giao diện AudioRouting thay thế, kết hợp và ngừng sử dụng các phương thức định tuyến rõ ràng dành riêng cho AudioTrack và AudioRecord.

Để biết thông tin chi tiết về API liệt kê và lựa chọn, vui lòng tham khảo Android giao diện cấu hình và OpenSLES_AndroidConfiguration.h. Để biết thông tin chi tiết về việc định tuyến âm thanh, tham khảo Định tuyến âm thanh.

Hỗ trợ đa kênh

Nếu phần cứng và trình điều khiển của bạn hỗ trợ âm thanh đa kênh qua HDMI, thì bạn có thể xuất luồng âm thanh trực tiếp đến phần cứng âm thanh (điều này bỏ qua Bộ trộn AudioFlinger để không bị trộn lẫn xuống hai kênh.) Lớp trừu tượng phần cứng (HAL) cho âm thanh phải cho biết cấu hình luồng đầu ra có hỗ trợ âm thanh đa kênh hay không các chức năng khác nhau. Nếu HAL cho thấy khả năng của mình, thì trình quản lý chính sách mặc định cho phép phát đa kênh qua HDMI. Để biết thông tin chi tiết về cách triển khai, hãy xem device/samsung/tuna/audio/audio_hw.c.

Để cho biết rằng sản phẩm của bạn có chứa đầu ra âm thanh đa kênh, hãy chỉnh sửa tệp cấu hình chính sách âm thanh để mô tả đầu ra đa kênh cho của Google. Ví dụ sau từ frameworks/av/services/audiopolicy/config/primary_audio_policy_configuration_tv.xml hiển thị mặt nạ kênh động, tức là trình quản lý chính sách âm thanh truy vấn kênh mặt nạ được hỗ trợ bởi bồn lưu trữ HDMI sau khi kết nối.

Hiện ví dụ về cấu hình thiết bị 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>

Bạn cũng có thể chỉ định một mặt nạ kênh tĩnh như AUDIO_CHANNEL_OUT_5POINT1. Bộ trộn của AudioFlinger kết hợp các bản nhạc nội dung sang âm thanh nổi tự động khi được gửi đến thiết bị âm thanh không và hỗ trợ âm thanh đa kênh.

Bộ mã hoá và giải mã nội dung nghe nhìn

Đảm bảo rằng bộ mã hoá và giải mã âm thanh mà phần cứng và trình điều khiển hỗ trợ đều đúng cách khai báo cho sản phẩm của mình. Để biết thông tin chi tiết, hãy xem Hiển thị Codec cho Khung.