【Android Audio】Parameter Framework - pfw配置介绍

已于 2025-04-21 16:09:04 修改
阅读量1k 收藏 18
点赞数 19
文章标签： android Audio
于 2025-04-07 20:33:26 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/u013120422/article/details/147052285
版权

Parameter Framework - Android AudioPolicy Engine

使用 libaudiopolicyengineconfigurable.so 来取缔默认安卓音频引擎 libaudiopolicyenginedefault.so，因为默认安卓音频引擎是通过代码来决定策略，然而 libaudiopolicyengineconfigurable 采用读取pfw类型的文件来实现音频策略配置。

1. 优势

不需要修改代码，直接修改pfw配置文件就可以修改音频策略

2. 启用Parameter framework

Android U之前的版本
在 audio_policy_configuration.xml文件中 globalConfiguration字段增加字段： engine_library="configurable" 
<globalConfiguration speaker_drc_enabled="false" engine_library="configurable" />
Android U之后的版本
使用aidl的hal，读取config的时候检测 audio_policy_engine_criterion_types.xml和 audio_policy_engine_criteria.xml文件存在就会启用

hardware\interfaces\audio\aidl\default\EngineConfigXmlConverter.cpp

void EngineConfigXmlConverter::init() {
...
    if (getXsdcConfig()->hasCriteria() && getXsdcConfig()->hasCriterion_types()) {
        AudioHalEngineConfig::CapSpecificConfig capSpecificConfig;
        capSpecificConfig.criteriaV2 =
                std::make_optional<>(VALUE_OR_FATAL((convertCapCriteriaCollectionToAidl(
                        getXsdcConfig()->getCriteria(), getXsdcConfig()->getCriterion_types()))));
...

3. 功能

当前主要是3大配置

    <InstanceDefinition>
        <Component Name="streams" Type="Streams"/>
        <Component Name="input_sources" Type="InputSources"/>
        <Component Name="product_strategies" Type="ProductStrategies"/>
    </InstanceDefinition>

3.1 输入（input_sources）

device_for_input_source.pfw
不同的audio_source_t使用什么样的输入设备

<ComponentType Name="InputSources" Description="associated to audio_source_t definition,
					 identifier mapping must match the value of the enum">
	<Component Name="default" Type="InputSource" Mapping="Name:AUDIO_SOURCE_DEFAULT"/>
	<Component Name="mic" Type="InputSource" Mapping="Name:AUDIO_SOURCE_MIC"/>
	<Component Name="voice_uplink" Type="InputSource"
								   Mapping="Name:AUDIO_SOURCE_VOICE_UPLINK"/>
	<Component Name="voice_downlink" Type="InputSource"
									 Mapping="Name:AUDIO_SOURCE_VOICE_DOWNLINK"/>
	<Component Name="voice_call" Type="InputSource"
								 Mapping="Name:AUDIO_SOURCE_VOICE_CALL"/>
	<Component Name="camcorder" Type="InputSource" Mapping="Name:AUDIO_SOURCE_CAMCORDER"/>
	<Component Name="voice_recognition" Type="InputSource"
										Mapping="Name:AUDIO_SOURCE_VOICE_RECOGNITION"/>
	<Component Name="voice_communication" Type="InputSource"
										  Mapping="Name:AUDIO_SOURCE_VOICE_COMMUNICATION"/>
	<Component Name="remote_submix" Type="InputSource"
									Mapping="Name:AUDIO_SOURCE_REMOTE_SUBMIX"/>
	<Component Name="unprocessed" Type="InputSource"
									Mapping="Name:AUDIO_SOURCE_UNPROCESSED"/>
	<Component Name="voice_performance" Type="InputSource"
									Mapping="Name:AUDIO_SOURCE_VOICE_PERFORMANCE"/>
	<Component Name="echo_reference" Type="InputSource"
									Mapping="Name:AUDIO_SOURCE_ECHO_REFERENCE"/>
	<Component Name="fm_tuner" Type="InputSource" Mapping="Name:AUDIO_SOURCE_FM_TUNER"/>
	<Component Name="hotword" Type="InputSource" Mapping="Name:AUDIO_SOURCE_HOTWORD"/>
</ComponentType>

3.2 输出设备优先级（product_strategies）

device_for_product_strategy_phone.pfw、device_for_product_strategy_media.pfw…
不同的product_strategy_t使用什么样的输出设备

<ComponentType Name="ProductStrategies" Description="">
	<Component Name="phone" Type="ProductStrategy" Mapping="Name:STRATEGY_PHONE"/>
	<Component Name="sonification" Type="ProductStrategy" Mapping="Name:STRATEGY_SONIFICATION"/>
	<Component Name="enforced_audible" Type="ProductStrategy" Mapping="Name:STRATEGY_ENFORCED_AUDIBLE"/>
	<Component Name="accessibility" Type="ProductStrategy" Mapping="Name:STRATEGY_ACCESSIBILITY"/>
	<Component Name="sonification_respectful" Type="ProductStrategy" Mapping="Name:STRATEGY_SONIFICATION_RESPECTFUL"/>
	<Component Name="media" Type="ProductStrategy" Mapping="Name:STRATEGY_MEDIA"/>
	<Component Name="dtmf" Type="ProductStrategy" Mapping="Name:STRATEGY_DTMF"/>
	<Component Name="transmitted_through_speaker" Type="ProductStrategy" Mapping="Name:STRATEGY_TRANSMITTED_THROUGH_SPEAKER"/>
	<Component Name="assistant" Type="ProductStrategy" Mapping="Name:STRATEGY_ASSISTANT"/>
</ComponentType>

3.3 音量曲线切换（streams）

volumes.pfw
不同的audio_stream_type_t使用哪个stream type的音量曲线
eg: system的stream可以使用music的音量曲线

<ComponentType Name="Streams" Description="associated to audio_stream_type_t definition">
	<Component Name="voice_call" Type="Stream" Mapping="Name:AUDIO_STREAM_VOICE_CALL"/>
	<Component Name="system" Type="Stream" Mapping="Name:AUDIO_STREAM_SYSTEM"/>
	<Component Name="ring" Type="Stream" Mapping="Name:AUDIO_STREAM_RING"/>
	<Component Name="music" Type="Stream" Mapping="Name:AUDIO_STREAM_MUSIC"/>
	<Component Name="alarm" Type="Stream" Mapping="Name:AUDIO_STREAM_ALARM"/>
	<Component Name="notification" Type="Stream" Mapping="Name:AUDIO_STREAM_NOTIFICATION"/>
	<Component Name="bluetooth_sco" Type="Stream" Mapping="Name:AUDIO_STREAM_BLUETOOTH_SCO"/>
	<Component Name="enforced_audible" Type="Stream" Mapping="Name:AUDIO_STREAM_ENFORCED_AUDIBLE"
			   Description="Sounds that cannot be muted by user and must be routed to speaker"/>
	<Component Name="dtmf" Type="Stream" Mapping="Name:AUDIO_STREAM_DTMF"/>
	<Component Name="tts" Type="Stream" Mapping="Name:AUDIO_STREAM_TTS"
					 Description="Transmitted Through Speaker. Plays over speaker only, silent on other devices"/>
	<Component Name="accessibility" Type="Stream" Mapping="Name:AUDIO_STREAM_ACCESSIBILITY"
					 Description="For accessibility talk back prompts"/>
	<Component Name="assistant" Type="Stream" Mapping="Name:AUDIO_STREAM_ASSISTANT"
					 Description="used by a virtual assistant like Google Assistant, Bixby, etc."/>
	<Component Name="rerouting" Type="Stream" Mapping="Name:AUDIO_STREAM_REROUTING"
					 Description="For dynamic policy output mixes"/>
	<Component Name="patch" Type="Stream" Mapping="Name:AUDIO_STREAM_PATCH"
					 Description="For internal audio flinger tracks. Fixed volume"/>
</ComponentType>

4. 配置pfw文件

4.1 supDomain

  • supDomain定义是对Strategy进行分类命名，可以任意修改
  • 可以定义多级supDomain，生成的xml中是以"."分隔
    （eg： DeviceForProductStrategy.Media）
supDomain: DeviceForProductStrategy
	supDomain: Media
		domain: Device1
			conf: ForceUseBtA2dpSpeaker
				AvailableOutputDevices Includes BLUETOOTH_A2DP_SPEAKER
				ForceUseForMedia Is BT_A2DP
				component: /Policy/policy/product_strategies/vx_1005/selected_output_devices/mask
					speaker = 0
					spdif = 0
					bluetooth_a2dp_speaker = 1
...

4.2 domain

  • supDomain下面可以配置多个domain
  • 多个domain的device是共存的
  • 同一supDomain中不同的domain中不能配置相同的device
    eg：下面Assistant的Strategy中配置了2个domain（Device1、Device2），ARC可以跟其他device共存
supDomain: DeviceForProductStrategy
	supDomain: Assistant
		domain: Device1
			conf: RemoteSubmix
				AvailableOutputDevices Includes REMOTE_SUBMIX
				AvailableOutputDevicesAddresses Includes 0
				component: /Policy/policy/product_strategies/assistant/selected_output_devices/mask
					speaker = 0
					remote_submix = 1
...
		domain: Device2
			#
			# these following domains consists in device(s) that can co-exist with others
			# e.g. ARC, SPDIF, AUX_LINE
			#
			conf: Selected
				AvailableOutputDevices Includes HDMI_ARC
				component: /Policy/policy/product_strategies/assistant/selected_output_devices/mask
					hdmi_arc = 1

			conf: NotSelected
				component: /Policy/policy/product_strategies/assistant/selected_output_devices/mask
					hdmi_arc = 0
...

4.3 config

  • 每一个domain下面的config相当于代码中的switch-case语句。放在前面的config先被执行到。
  • 满足config条件才会被使用，之后不再执行同一domain下的config。如果不满足条件则进行下一个config条件检查。
domain: Device1
	conf: ForceUseBtA2dpSpeaker
		AvailableOutputDevices Includes BLUETOOTH_A2DP_SPEAKER
		ForceUseForMedia Is BT_A2DP
		component: /Policy/policy/product_strategies/vx_1005/selected_output_devices/mask
			speaker = 0
			spdif = 0
			hdmi = 0
			hdmi_arc = 0
			bluetooth_a2dp_speaker = 1
			usb_device = 0
	conf: UsbDevice
		AvailableOutputDevices Includes USB_DEVICE
		component: /Policy/policy/product_strategies/vx_1005/selected_output_devices/mask
			speaker = 0
			spdif = 0
			hdmi = 0
			hdmi_arc = 0
            bluetooth_a2dp_speaker = 0
			usb_device = 1
4.3.1 criterion （准则/标准）

每个criterion 定义: pfw中所有能使用的准则类型 audio_policy_engine_criteria.xml

frameworks/av/services/audiopolicy/engineconfigurable/config/example/common/audio_policy_engine_criteria.xml

<criteria>
    <criterion name="AvailableInputDevices" type="InputDevicesMaskType" default="none"/>
    <criterion name="AvailableOutputDevices" type="OutputDevicesMaskType" default="none"/>
    <criterion name="ForceUseForMedia" type="ForceUseForMediaType" default="ForceNone"/>
...
</criteria>
4.3.2 每个criterion的值：每个准则类型的值

/vendor/etc/audio_policy_engine_criteria.xml是audio_policy_engine_criterion_typespython脚本根据audio_policy_engine_criterion_types.xml.in文件自动生成。

  • Android 16使用Google最新的capBuildPolicyCriterionTypes.py，之前安卓版本使用buildPolicyCriterionTypes.py的Python脚本。

frameworks/av/services/audiopolicy/engineconfigurable/tools/

frameworks/av/services/audiopolicy/engineconfigurable/config/example/common/audio_policy_engine_criterion_types.xml.in

<criterion_types>
        <criterion_type name="OutputDevicesMaskType" type="inclusive">
                <values>
                        <value literal="EARPIECE" android_type="0x1"/>
                        <value literal="SPEAKER" android_type="0x2"/>
                        <value literal="WIRED_HEADSET" android_type="0x4"/>
                        <value literal="WIRED_HEADPHONE" android_type="0x8"/>
                        <value literal="BLUETOOTH_SCO" android_type="0x10"/>
                        <value literal="BLUETOOTH_SCO_HEADSET" android_type="0x20"/>
                        <value literal="BLUETOOTH_SCO_CARKIT" android_type="0x40"/>
                        <value literal="BLUETOOTH_A2DP" android_type="0x80"/>
                        <value literal="BLUETOOTH_A2DP_HEADPHONES" android_type="0x100"/>
                        <value literal="BLUETOOTH_A2DP_SPEAKER" android_type="0x200"/>
                </values>
        </criterion_type>
...
    <criterion_type name="ForceUseForMediaType" type="exclusive">
        <values>
            <value literal="ForceNone" numerical="0"/>
            <value literal="ForceSpeaker" numerical="1"/>
            <value literal="ForceHeadphones" numerical="2"/>
            <value literal="ForceBtA2dp" numerical="4"/>
            <value literal="ForceWiredAccessory" numerical="5"/>
            <value literal="ForceAnalogDock" numerical="8"/>
            <value literal="ForceDigitalDock" numerical="9"/>
            <value literal="ForceNoBtA2dp" numerical="10"/>
        </values>
    </criterion_type>
...

4.3.3 使用criterion

例如：配置输出设备策略

    conf: UsbDevice
        AvailableOutputDevices Includes USB_DEVICE
		AvailableOutputDevices Excludes WIRED_HEADPHONE
        ANY
            ForceUseForCommunication Is BT_SCO
            ALL
                ForceUseForCommunication Is SPEAKER
                TelephonyMode IsNot IN_CALL
				component: /Policy/policy/product_strategies/vx_1000/selected_output_devices/mask
...
					usb_accessory = 0
					usb_device = 1
					usb_headset = 0
					speaker = 0
...

上面的config转化为伪代码的case：

if (AvailableOutputDevices 存在 USB_DEVICE) {
    if (AvailableOutputDevices 不存在 WIRED_HEADPHONE) {
        if (ForceUseForCommunication == BT_SCO ||
        (ForceUseForCommunication == SPEAKER && TelephonyMode != IN_CALL)) {
            return USB_DEVICE;
        }
    }
}

当前Google pfw支持3个SubSystem（Stream、InputSource、ProductStrategy）

frameworks\av\services\audiopolicy\engineconfigurable\parameter-framework\plugin\PolicySubsystem.cpp

    // Provide creators to upper layer
    addSubsystemObjectFactory(
        new TSubsystemObjectFactory<Stream>(
            mStreamComponentName,
            (1 << MappingKeyName))
        );
    addSubsystemObjectFactory(
        new TSubsystemObjectFactory<InputSource>(
            mInputSourceComponentName,
            (1 << MappingKeyName))
        );
    addSubsystemObjectFactory(
        new TSubsystemObjectFactory<ProductStrategy>(
            mProductStrategyComponentName, (1 << MappingKeyName))
        );

分别通过下面3个函数推送到Engine中

frameworks\av\services\audiopolicy\engineconfigurable\parameter-framework\plugin\
Stream::sendToHW
Engine::setVolumeProfileForStream
InputSource::sendToHW
Engine::setDeviceForInputSource
ProductStrategy::sendToHW
Engine::setDeviceTypesForProductStrategy
Engine::setDeviceAddressForProductStrategy

/vendor/etc/parameter-framework/Structure/Policy/PolicySubsystem-CommonTypes.xml

5.1 快速debug

修改完对应的pfw文件之后
parameter framework的pfw所在路径下mm -j，将/vendor/etc/parameter-framework/目录替换到平台即可

zgyhc2050
关注
Android 13.0 展讯平台关于ota升级开机logo的相关功能实现
安卓兼职framework和app工程师的博客
09-14 366
在13.0的展讯平台的系统rom定制开发中，关于ota升级功能的需求也好多，但是对于ota升级开机logo这样的bmp图片，就不能像 升级其他功能一样简单做ota差分包，然后ota升级就可以了，接下来就来实现这个功能
Android 14.0 展讯平台关于ota升级开机logo的相关功能实现
最新发布
安卓兼职framework和app工程师的博客
05-02 112
​ 在14.0的展讯平台的系统rom定制开发中，关于ota升级功能的需求也好多，但是对于ota升级开机logo这样的bmp图片，就不能像 升级其他功能一样简单做ota差分包，然后ota升级就可以了，接下来就来实现这个功能 ​
Android13音频子系统分析(一)---整体架构
热门推荐
余静江的博客
09-14 1万+
本文基于AOSP13源码进行分析解读。所以与各个SoC平台厂商提供的运行在真实设备上的源码会有细微差异，但核心原理区别不大。音频子系统在Android中是一个较为复杂的子系统，横跨应用API层，框架层，Native层和HAL层。使用Java、C++、C语言进行编写。运行在Linux用户空间的4个进程中：APP应用进程(API层的代码)、SystemServer进程(框架层的代码)、AudioServer进程(Native层的代码)、AudioHAL进程(HAL层的代码)。
Android Audio代码分析(2): AudioPoilicyService 启动
u011279649的专栏
08-05 2940
AudioPolicyService 所在进程 frameworks/av/media/audioserver ➜ audioserver git:(0111) ✗ tree . ├── Android.mk ├── audioserver.rc ├── main_audioserver.cpp └── OWNERS int main(int argc __unused, char **argv) { android::hardware::configureRpcThreadpool(...
Android 10 Audio系统：REMOTE_SUBMIX 实现原理
biandan1231的专栏
06-26 9086
Android10 Audio系统：REMOTE_SUBMIX 实现原理前言什么是REMOTE_SUBMIX怎么使用REMOTE_SUBMIX如何实现的创建REMOTE_SUBMIX类型的 input输入设备创建output设备如何通过output设备采集到数据小结 前言 由于业务需求，需要对Android设备的音频输出进行采集，同时还需要保持Android本身设备的输出。Android原生是无法实现的，因为使用了REMOTE_SUBMIX 之后，Android本身喇叭输出会停止，所以需要对音频系统进行一定
配置音频政策
tronteng的专栏
11-29 1408
配置音频政策 Android 7.0 引入了一种新的音频政策配置文件格式 (XML)，用于描述音频拓扑。 以前的 Android 版本需要使用 device/&lt;company&gt;/&lt;device&gt;/audio/audio_policy.conf 来声明您产品上存在的音频设备（您可以在 device/samsung/tuna/audio/audio_policy.conf ...
android音量的控制曲线的计算方法
neverbefat的博客
11-07 2617
本文介绍了android音量的控制曲线的计算方法。 转载地址 　　由于人耳对声音的听感具指数曲线型，也就是对小音量时比较敏感，随着声音的加大其听感随之变的不敏感，其变化近似指数函数曲线的形式。为了使听感变的近似直线的变化，人们在实践中就采用了音量变化近似对数式曲线型的电位器来实现这个目的。对比法产生音量控制曲线与最终扬声器输出的声压有关，当然您也可以根据扬声器的输出功率来进行比对，但功率终究不如
HSD101PFW3-B00_Tentative_spec-显示屏技术规格书.pdf
11-21
- **1.0 一般描述**：这部分通常会介绍产品的基本属性，如尺寸、分辨率、显示颜色能力等，帮助理解屏幕的基本工作原理和功能。 - **2.0 绝对最大额定值**：这是关于显示屏可以承受的最大电压、电流和温度等极限条件...
pfw for PB12.5
04-13
3. **pfw.usr.opt**：这可能是一个用户配置文件，用于存储框架的个性化设置，如默认首选项或特定用户的配置信息。 4. **res.pbd**：这是PowerBuilder的数据窗口资源文件，可能包含了pfw框架使用的数据窗口对象，...
Android 9.0 展讯平台关于ota升级开机logo的相关功能实现
安卓兼职framework和app工程师的博客
04-24 465
在9.0的展讯平台的系统ROM定制化开发中，关于ota升级功能的需求也好多，但是对于ota升级开机logo这样的bmp图片，就不能像 升级其他功能一样简单做ota差分包，然后ota升级就可以了，接下来就带大家来实现这个功能
AudioPolicyService::instantiate()流程分析
Good Good Study Day Day Up!!!
01-17 1255
分析instantiate()之前， 依然是接着前面分析了main()函数的开始：Android Audio:main_audioserver.cpp中的main()函数启动流程 接下来分析AudioPolicyService的instantiate()，写的hin粗糙仅供自己实习学习记录 android\frameworks\av\services\audiopolicy\service\A...
msm8953+android8.1接听电话时声音由默认听筒输出改为外放输出
LoongEmbedded的专栏
05-16 1868
1. 方法一，修改frameworks/av//services/audiopolicy/enginedefault/src/Engine.cpp Engine::getDeviceForStrategyInt()函数的case STRATEGY_PHONE下 switch (mForceUse[AUDIO_POLICY_FORCE_FOR_COMMUNICATION]) { ...
如何从AP层控制到audiopolicy
ch853199769的博客
09-04 3059
Audio 参数的设置 audioFlinger audiopolicy 音频策略 setParameters
Android编译脚本(.mk文件)解析
u012773843的博客
03-01 4866
摘要：本文将简单介绍Android编译系统并举例说明如何编写不同类型的mk文件以达到不同的目的。虽然.mk文件即将被.bp文件替代，但是在Android9之前的版本中.mk文件的使用频率依旧很高，同时理解.mk文件也有助于理解Android编译系统和其替代者.bp文件。 一、Android编译系统 1.从基础make脚本到Android编译系统 首先我们来看一个make脚本的基本格式： 目标(target): 条件:(prerequest) 命令 比如： hello: hello.c gcc he.
[Android 15] 在GlobalActionsDialog 中新增项目
Leif_dong的专栏
04-30 334
在GlobalActionsDialog 中新增项目
Android adb 安装应用失败(安装次数限制)
ansondroider的博客
04-28 1197
Android Debug Bridge (ADB) 是一个功能强大的命令行工具，用于与 Android 设备通信。安装 APK 文件使用命令adb install <apk文件路径>可以将 APK 文件安装到设备上。 突然出现的安装失败, 原因居然是安装次数的限制
Android 热点开发调试总结
wenzhi的博客
04-28 993
如果开发热点相关功能，必须先掌握基本api知识和相关广播的监听；热点用的功能基本都是系统签名权限的系统应用，比如Settings；有些方案中需要设置热点不同的信道值，这个是Settings没有的功能；本简单介绍热点开发基本知识，有兴趣的可以看看。
Android pm命令参考
oh_my_god的专栏
04-30 519
通过ad执行pm命令，可以做很多事，拿下系统代码。
Chromium 134 编译指南 - Android 篇：从Linux版切换到Android版（六）
守城小轩的技术窝棚
05-01 796
通过本篇文章的指导，您已经成功将Linux版的Chromium源代码转换为同时支持Android平台的配置。这种方法不仅节省了重新下载整个代码库的时间和带宽，还让您的开发环境更加灵活，能够在不同平台间快速切换。理解了.gclient文件的作用和重要性修改了配置文件，添加了Android作为目标平台同步了Android平台所需的特定依赖项验证了配置是否成功完成这些步骤看似简单，但对于高效开发Chromium跨平台版本至关重要。
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值