实时音视频
实时音视频
文档指南
请输入
- 文档首页
实时音视频实时音视频常见问题集成相关为什么通过系统音量无法调节背景音乐音量
复制全文
下载 pdf为什么通过系统音量无法调节背景音乐音量
文档反馈
问问助手问题详述
在移动设备中，用户在后台播放背景音乐，加入 RTC 频道后，用户无法通过调节系统音量去改变背景音乐的音量。
问题解答
用户加入 RTC 频道后， RTC SDK 控制的音量类型决定了系统音量控制的音量类型。当 SDK 控制通话音量，背景音乐使用媒体音量时，系统音量只能控制通话音量，无法调节背景音乐的音量。
你可通过以下三种方法进行解决：
方案一：将背景音乐通过 RTC 托管播放
你可以使用混音功能播放背景音乐，让 SDK 同时控制背景音乐和通话声音。不论 SDK 使用的是通话音量还是媒体音量，用户都可以通过系统音量同时调节背景音乐和通话声音的音量。关于该功能的使用方法参看使用混音功能。
方案二：切换媒体模式
方案三：通过系统 API 监听音量变化并调节
Android
具体实现步骤如下：
- 创建 RTC 引擎并注册音量变化监听；
- 使用手机硬件音量键或声音调节 UI 调整声音时，收到系统声音变化广播；
- 判断音量变化声音类型，如果为通话音量则计算当前通话音量与可设置最大通话音量比例，按照比例同步调用系统 API 调整媒体音量；
- 销毁引擎并取消音量变化的监听；
你可参看以下示例代码实现：
/**
* RTC 引擎的创建方法
*/
public void createVolcEngine() {
//省略无关代码 ......
//初始化音量变化管理器，管理器构造方法中初始化并注册音量变化监听广播及首次将通话音量同步至媒体音量
if (mContext != null) {
mVolumeChangeManager = new VolumeChangeManager(mContext.getApplicationContext());
}
//创建火山引擎，createRTCVideo
//省略无关代码 ......
}
/**
*RTC 引擎销毁方法
*/
@Override
public void destory() {
//省略无关代码 ......
//销毁火山引擎同时取消音量变化的监听
if (mVolumeChangeManager != null) {
mVolumeChangeManager.unregisterVolumeReceiver();
}
//销毁火山引擎，destoryRTCVideo
//省略无关代码 ......
}
/**
* 音量变化管理器：内部封装对通过系统API获取媒体最大音量，媒体最小音量，通话最大音量，设置通话音量等API的调用，音量变化监听的注册和反注册
*/
public static class VolumeChangeManager {
public static final String VOLUME_CHANGE_ACTION = "android.media.VOLUME_CHANGED_ACTION";
private Context mContext;
private AudioManager mAudioManager;
private VolumeBroadCastReceiver mVolumeBroadCastReceiver;
private int mMediaMaxVolume = 0;
private int mMediaMinVolume = 0;
private int mCallMaxVolume = 0;
private VolumeChangeManager(@NotNull Context context) {
mContext = context;
//获取系统声音管理器
mAudioManager = (AudioManager) context.getSystemService(Context.AUDIO_SERVICE);
if (mAudioManager == null) {
Logger.e("VolcEngine syncMediaCallVolume mAudioManager is null!");
return;
}
//获取媒体最大音量
mMediaMaxVolume = mAudioManager.getStreamMaxVolume(AudioManager.STREAM_MUSIC);
//获取媒体最小音量
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.P) {
mMediaMinVolume = mAudioManager.getStreamMinVolume(AudioManager.STREAM_MUSIC);
} else {
mMediaMinVolume = 0;
}
//获取通话最大音量
mCallMaxVolume = mAudioManager.getStreamMaxVolume(AudioManager.STREAM_VOICE_CALL);
mVolumeBroadCastReceiver = new VolumeBroadCastReceiver();
//初始化音量变化监听器
mVolumeBroadCastReceiver.setVolumeChangeManager(this);
//注册音量变化监听广播
context.registerReceiver(mVolumeBroadCastReceiver, new IntentFilter(VOLUME_CHANGE_ACTION));
//首次将通话音量同步至媒体音量，防止本身媒体音量太小
syncMediaCallVolumeWhenInit();
}
private void syncMediaCallVolumeWhenInit() {
int callVolume = getCallVolume();
int mediaVolume = getMediaVolume();
double callProgress = (double) callVolume / (double)mCallMaxVolume;
double mediaProgress = (double) mediaVolume / (double)mMediaMaxVolume;
if (mediaProgress >= callProgress) {
return;
}
double progress = callProgress > 0.8 ? 0.8 : callProgress;
int volume = (int)(progress * mMediaMaxVolume);
Logger.i("VolcEngine syncMediaCallVolumeWhenInit volume:" + volume + ", maxVolume:" + mMediaMaxVolume);
setMediaVolume(volume);
}
private void syncMediaCallVolume() {
int callVolume = getCallVolume();
//按照当前设置的通话音量比例计算应该设置的媒体音量
int volume = (int) ((callVolume / (float) mCallMaxVolume) * mMediaMaxVolume);
setMediaVolume(volume);
}
/**
* 取消声音变化监听
*/
private void unregisterVolumeReceiver() {
if (mVolumeBroadCastReceiver != null && mContext != null) {
mContext.unregisterReceiver(mVolumeBroadCastReceiver);
mVolumeBroadCastReceiver.setVolumeChangeManager(null);
mVolumeBroadCastReceiver = null;
mAudioManager = null;
mContext = null;
}
}
/**
* 设置媒体音量
*
* @param volume 媒体最新音量
*/
private void setMediaVolume(int volume) {
if (mAudioManager != null) {
if (volume > mMediaMaxVolume) {
volume = mMediaMaxVolume;
}
if (volume < mMediaMinVolume) {
volume = mMediaMinVolume;
}
mAudioManager.setStreamVolume(AudioManager.STREAM_MUSIC, volume, AudioManager.FLAG_PLAY_SOUND);
}
}
/**
* 获取当前通话音量
*/
private int getCallVolume() {
if (mAudioManager != null) {
return mAudioManager.getStreamVolume(AudioManager.STREAM_VOICE_CALL);
}
return 1;
}
/**
* 获取当前媒体音量
*/
private int getMediaVolume() {
if (mAudioManager != null) {
return mAudioManager.getStreamVolume(AudioManager.STREAM_MUSIC);
}
return 1;
}
}
/**
* 声音变化监听器
*/
public static class VolumeBroadCastReceiver extends BroadcastReceiver {
public static final String EXTRA_VOLUME_STREAM_TYPE = "android.media.EXTRA_VOLUME_STREAM_TYPE";
private VolumeChangeManager mVolumeChangeHelper;
public void setVolumeChangeManager(VolumeChangeManager volumeChangeHelper) {
mVolumeChangeHelper = volumeChangeHelper;
}
@Override
public void onReceive(Context context, Intent intent) {
//获取音量变化的声音类型
int changeVolumeType = intent.getIntExtra(EXTRA_VOLUME_STREAM_TYPE, -1);
if (mVolumeChangeHelper != null) {
changeMediaVolume(changeVolumeType);
}
}
public void changeMediaVolume(int volumeType) {
//如果音量变化的声音类型为通话音量，则同步改变媒体音量
if (volumeType == AudioManager.STREAM_VOICE_CALL) {
mVolumeChangeHelper.syncMediaCallVolume();
}
}
}
iOS
最近更新时间：2026.09.28 09:46:50
这个页面对您有帮助吗？
有用
有用
无用
无用