当前位置：首页 > news >正文

Android14 系统左右声音通道设置代码

news 来源：原创 2025/8/10 5:19:56

Android14 系统左右声音通道设置代码

文章目录

Android14 系统左右声音通道设置代码
- 一、前言
- 二、系统级设置左右声音通道分析
- - 1、各方案设置左右声音通道的主要代码
  - - （1）3588 Android13 方案的实现
    - （2）9679 Android14 方案的实现
    - （3）311D2 Android13 方案的实现
  - 2、串口验证左右声道平衡设置
  - 3、AudioService.java 监听并设置左右声音通道平衡
  - 4、AudioSystem.java 上层设置左右声音通道平衡的主要代码
- 三、其他
- - 1、Android设置左右声音通道代码小结
  - - （1）串口设置左右平衡声音通道：
  - 2、为啥不用方案需要调用不同的声音通道接口实现？

一、前言

Android 系统左右声音通道设置在有些场景下会有用，信源或者多音箱的条件下可能需要设置，
还有些需求比如：用户偏好设置、将声音定位到特定方向，提升沉浸感。

最简单的理解：

比如耳机接入Android设备后，设置声音通道左平衡，只有左边的耳机出声；
设置声音通道右平衡，只有右边的耳机出声；

上面这样就可以简单验证系统左右声音通道是否有效。

网上基本找不到系统级的设置左右声音通道的代码，即使使用AI工具也搜不到。
网上设置左右声音通道都是针对某个播放媒体对象进行设置，并不是全局的。
网上设置左右声音通道关键部分代码如下：

    // 1、应用左右声道平衡，audioTrack 设置for (int i = 0; i < audioData.length; i += 2) {audioData[i] = (short) (audioData[i] * leftVolume); // 左声道audioData[i + 1] = (short) (audioData[i + 1] * rightVolume); // 右声道}audioTrack.write(audioData, 0, audioData.length);// 2、应用左右声道平衡，MediaPlayer 设置mediaPlayer = MediaPlayer.create(this, R.raw.your_audio_file);if (mediaPlayer != null) {// 设置左声道音量为 0.2，右声道音量为 0.8mediaPlayer.setVolume(0.2f, 0.8f);mediaPlayer.start();}

上面的两种方法都是针对某个音频流对象，并不针对系统的。

那么系统有接口方法吗？

其实是有设置左右声音通道接口的，本文记录总结一下。

二、系统级设置左右声音通道分析

目前接触的系统芯片方案主要有：RK、MTK、AML；他们的设置左右声音通道代码居然都不一样。

1、各方案设置左右声音通道的主要代码

（1）3588 Android13 方案的实现

    @Overridepublic int getBalance() throws RemoteException {float result = 0.0f;int value_int = 0;String value = "";try {result = Settings.System.getFloatForUser(mContext.getContentResolver(),Settings.System.MASTER_BALANCE, UserHandle.USER_CURRENT);value_int = (int) Math.round(result);Log.d(TAG,"getBalance result == " + result+",value_int:"+value_int);} catch (Exception e) {e.printStackTrace();}return value_int;}@Overridepublic void setBalance(int balance) throws RemoteException {synchronized (lock) {Settings.System.putFloatForUser(mContext.getContentResolver(),Settings.System.MASTER_BALANCE, uiValue2parameterValue(balance), UserHandle.USER_CURRENT);}}//将UI 输入值 [-50, 50] 映射到 参数范围 [-1.0, 1.0]public  float uiValue2parameterValue(int value) {float y = ((float)(value + 50) / 50) - 1.0f;return y;}

上面看起来是比较原生的设置代码；
通过读取和设置 Settings.System.MASTER_BALANCE 的值设置左右声音平衡
系统中的 System.MASTER_BALANCE 的是值-1f ~ 1f,需要转换成-50 ~ 50
用户获取和设置的左右平衡值范围是-50 ~ 50。

（2）9679 Android14 方案的实现

import com.mediatek.tv.oneworld.tvapi.audio.TvAudioManager; //mtk apiprivate TvAudioManager mTvAudioManager;mTvAudioManager = new TvAudioManager(mContext);@Overridepublic int getBalance() throws RemoteException {int result = mTvAudioManager.get(mContext, TvAudioManager.CFG_AUD_AUD_BALANCE, 0);DebugLog.debug("getBalance result == " + result);return result;}@Overridepublic void setBalance(int balance) throws RemoteException {// balance : (-50 ~ 50)mTvAudioManager.set(mContext, TvAudioManager.CFG_AUD_AUD_BALANCE, String.valueOf(balance));DebugLog.debug("setBalance: balance == " + balance);}

（3）311D2 Android13 方案的实现

        import com.droidlogic.app.AudioEffectManager; //AML方案private AudioEffectManager mAudioEffectManager;public SkgVoiceService(Context applicationContext) {mContext = applicationContext;mAudioEffectManager = AudioEffectManager.getInstance(applicationContext);DebugLog.debug("");}@Overridepublic int getBalance() throws RemoteException {int result = mAudioEffectManager.getBalanceStatus();DebugLog.debug("getBalance result == " + result);return result;}@Overridepublic void setBalance(int balance) throws RemoteException {mAudioEffectManager.setBalance(balance);DebugLog.debug("setBalance and no return balance == " + balance);}

后面的MTK 和AML 方案上，实现都不一样，都是供应商封装的接口；
通过Settings属性查看并没有修改上层的 System.MASTER_BALANCE 属性值；
可能是直接控制底层接口完成的左右声音通道平衡设置，这里不进行深入研究。

从上面的代码看，RK实现左右声音通道平衡设置的代码可以移植使用。

那么其他方案也可以用Settings属性值设置的方式吗？

2、串口验证左右声道平衡设置

属性：Settings.System.MASTER_BALANCE 的设置和读取：
settings 属性名称都是纯小写的。

settings get  system master_balance //获取当前左右声音通道平衡值，默认 nullsettings put system master_balance -1 //设置左平衡，左边音箱出声
settings put system master_balance 1 //设置右平衡，右边音箱出声
settings put system master_balance 0 //设置左右平衡，左右音箱都出声，默认情况

通过串口命令验证了下确实可用。MTK方案上试了有用。

为啥会有用呢，应该是系统某个地方监听了settings属性变化，
最后调用某个接口，实现了调用逻辑。

查看了系统代码，确实有监听的地方，就在 AudioService.java

3、AudioService.java 监听并设置左右声音通道平衡

framework\base\services\core\java\com\android\server\audio\AudioService.java

下面是主要代码：

private class SettingsObserver extends ContentObserver {SettingsObserver() {super(new Handler());
... //十几个Settings 属性状态的监听mContentResolver.registerContentObserver(Settings.Global.getUriFor(Settings.Global.DOCK_AUDIO_MEDIA_ENABLED), false, this);mContentResolver.registerContentObserver(Settings.System.getUriFor(Settings.System.MASTER_MONO), false, this);//这个有注册监听 Settings.System.MASTER_BALANCE 的变化mContentResolver.registerContentObserver(Settings.System.getUriFor(Settings.System.MASTER_BALANCE), false, this);}@Overridepublic void onChange(boolean selfChange) {super.onChange(selfChange);synchronized (mSettingsLock) {readDockAudioSettings(mContentResolver); //读取停靠音频设置updateMasterMono(mContentResolver); //更新主声道单声道updateMasterBalance(mContentResolver); //更新主声道平衡,左右声音通道平衡设置updateEncodedSurroundOutput(); //更新编码环绕声输出sendEnabledSurroundFormats(mContentResolver, mSurroundModeChanged); //发送启用的环绕声格式updateAssistantUIdLocked(/* forceUpdate= */ false); //并更新助手UID（不强制更新）}}...}//继续追踪左右声道平衡的代码逻辑private void updateMasterBalance(ContentResolver cr) {//或者左右声音通道平衡的具体值final float masterBalance = System.getFloatForUser(cr, System.MASTER_BALANCE, 0.f /* default */, UserHandle.USER_CURRENT);if (DEBUG_VOL) { // DEBUG_VOL 默认trueLog.d(TAG, String.format("Master balance %f", masterBalance));}//调用 AudioSystem.setMasterBalance 方法设置左右声音通道if (AudioSystem.setMasterBalance(masterBalance) != 0) {Log.e(TAG, String.format("setMasterBalance failed for %f", masterBalance));}}

上面可以看到左右声音通道平衡的设置最终是调用了 AudioSystem 的接口方法。

import android.media.AudioSystem;
AudioSystem.setMasterBalance(masterBalance); //设置值范围：-1f ~ 1f

AudioSystem 接口和方法默认是隐藏的，系统framework中可以调用到。
系统签名应用也是无法调用到，需要导入系统的framework jar包就可能调用到AudioSystem 的类。

4、AudioSystem.java 上层设置左右声音通道平衡的主要代码

framework\base\media\java\android\media\AudioSystem.java

/*** @hide*/
@TestApi
public class AudioSystem
{private static final boolean DEBUG_VOLUME = false;private static final String TAG = "AudioSystem";// private constructor to prevent instantiating AudioSystemprivate AudioSystem() { //不能 newthrow new UnsupportedOperationException("Trying to instantiate AudioSystem");}//暴露的都是静态方法，所以不用new。/** @hide returns master balance value in range -1.f -> 1.f, where 0.f is dead center. */@TestApi@RequiresPermission(android.Manifest.permission.MODIFY_AUDIO_SETTINGS)public static native float getMasterBalance();/** @hide Changes the audio balance of the device. */@TestApi@RequiresPermission(android.Manifest.permission.MODIFY_AUDIO_SETTINGS)public static native int setMasterBalance(float balance);}

上面已有提示左右声音通道的值范围是：-1.f -> 1.f

声音通道平衡的具体实现是nativie的调用，后续不做进一步分析。
有兴趣的自行查阅：framework\base\core\jni\android_media_AudioSystem.cpp

三、其他

1、Android设置左右声音通道代码小结

（1）串口设置左右平衡声音通道：

settings get  system master_balance //获取当前左右声音通道平衡值，默认 nullsettings put system master_balance -1 //设置左平衡，左边音箱出声
settings put system master_balance 1 //设置右平衡，右边音箱出声
settings put system master_balance 0 //设置左右平衡，左右音箱都出声，默认情况

Android 原生设置左右声音通道代码：

//1、Settings属性设置，AudioService.java 有监听变化和调用接口Settings.System.putFloat(mContext.getContentResolver(),Settings.System.MASTER_BALANCE, balance);//2、AudioSystem 的静态方法
AudioSystem.setMasterBalance(masterBalance)

如果是系统签名应用，但是又没有导入framework的jar包，
是无法识别AudioSystem的，并且System.MASTER_BALANCE 也是无法识别的；

可以使用代码直接设置具体属性就行：

 Settings.System.putFloat(mContext.getContentResolver(), "master_balance", balance);

2、为啥不用方案需要调用不同的声音通道接口实现？

这里不去看他们的具体实现，直接简单分析一下。

对比了不同的Android版本的系统代码：

Android 9或者更旧的代码 AudioSystem.java 里面是没有setMasterBalance方法的;
Android11 的系统代码中是有AudioSystem.setMasterBalance 方法的。

所以之前Android9之前的版本，不得不使用自定义的接口调用底层声音设置。
所以不同供应商提供的调用接口是有差异的。
这个只是我的一个猜测哈。

测试了一下MTK方案：

使用供应商提供的设置声音接口或者使用Settings属性都是可以设置左右声音通道平衡的；
但是有个小问题：Settings属性设置左声道后，再次调用供应商的接口设置左声道或者右声道，会导致设备没有声音；
重新用供应商的接口设置左右声音通道值为0 ，设备就有声音了。

估计是底层兼容有问题！同时设置可能标志位会错乱。
如果能只用Google接口实现是最好的。毕竟Google考虑的应该比较全一点。

最近也是发现一个供应商的蓝牙音箱左右声音通道问题：
连接耳机设置左右声音通道都是没有问题的。

AML 和MTK 的方案都是存在的：
连接多音箱的蓝牙设备，设置左右声音通道没有用！
RK 的方案是没有问题的，因为它是使用的Google原生接口设置的左右声音通道实现。

这种情况有可能就是 AML 和MTK 的方案没有考虑蓝牙连接下的左右声音通道平衡导致。