产品动态
产品近期公告
关于 TRTC Live 正式上线的公告
关于TRTC Conference 正式版上线的公告
Conference 商业化版本即将推出
关于多人音视频 Conference 开启内测公告
关于音视频通话 Call 正式版上线的公告
关于腾讯云音视频终端 SDK 播放升级及新增授权校验的公告
关于 TRTC 应用订阅套餐服务上线的相关说明
RTC Room Engine SDK 实现背景音乐相关功能。startPlayMusic和stopPlayMusic两个接口，来开始或停止播放背景音乐。startPlayMusic开始播放背景音乐时，需要传入一个TXAudioMusicParam类型的参数来设置播放控制信息。TXAudioMusicParam包含以下信息，您可以分别对其进行设置：枚举类型 | 描述 |
id | 字段含义：音乐 ID。 特殊说明：SDK 允许播放多路音乐，因此需要使用 ID 进行标记，用于控制音乐的开始、停止、音量等。 |
endTimeMS | 字段含义：音乐结束播放时间点，单位毫秒，0表示播放至文件结尾。 |
isShortFile | 字段含义：播放的是否为短音乐文件。 推荐取值： YES：需要重复播放的短音乐文件。 NO：正常的音乐文件。默认值：NO。 |
loopCount | 字段含义：音乐循环播放的次数。 推荐取值：取值范围为0 - 任意正整数，默认值：0。0 表示播放音乐一次；1 表示播放音乐两次；以此类推。 |
path | 字段含义：音效文件的完整路径或 URL 地址。支持的音频格式包括 MP3、AAC、M4A、WAV。 |
publish | 字段含义：是否将音乐传到远端。 推荐取值： YES：音乐在本地播放的同时，远端用户也能听到该音乐。 NO：主播只能在本地听到该音乐，远端观众听不到。默认值：NO。 |
startTimeMS | 字段含义：音乐开始播放时间点，单位：毫秒。 |
startPlayMusic和stopPlayMusic两个接口，来开始或停止播放背景音乐。startPlayMusic开始播放背景音乐时，需要传入一个AudioMusicParam类型的参数来设置播放控制信息。AudioMusicParam包含以下信息，您可以分别对其进行设置：枚举类型 | 描述 |
id | 字段含义：音乐 ID。 特殊说明：SDK 允许播放多路音乐，因此需要使用 ID 进行标记，用于控制音乐的开始、停止、音量等。 |
endTimeMS | 字段含义：音乐结束播放时间点，单位毫秒，0表示播放至文件结尾。 |
isShortFile | 字段含义：播放的是否为短音乐文件。 推荐取值： YES：需要重复播放的短音乐文件。 NO：正常的音乐文件。默认值：NO。 |
loopCount | 字段含义：音乐循环播放的次数。 推荐取值：取值范围为0 - 任意正整数，默认值：0。0 表示播放音乐一次；1 表示播放音乐两次；以此类推。 |
path | 字段含义：音效文件的完整路径或 URL 地址。支持的音频格式包括 MP3、AAC、M4A、WAV。 |
publish | 字段含义：是否将音乐传到远端。 推荐取值： YES：音乐在本地播放的同时，远端用户也能听到该音乐。 NO：主播只能在本地听到该音乐，远端观众听不到。默认值：NO。 |
startTimeMS | 字段含义：音乐开始播放时间点，单位：毫秒。 |
import RTCRoomEngineimport TXLiteAVSDK_Professionallet audioEffectManager = TUIRoomEngine.sharedInstance().getTRTCCloud().getAudioEffectManager()// 开始播放背景音乐let musicParam = TXAudioMusicParam()musicParam.id = 0 // 替换为您自己的音乐IDmusicParam.path = "path" // 替换为音乐文件的完整路径或 URL 地址musicParam.publish = true // 将音乐传到远端musicParam.loopCount = 0 // 替换为您需要循环播放的次数audioEffectManager.startPlayMusic(musicParam) { code inif code == 0 {// 开始播放成功} else {// 开始播放失败}} onProgress: { progress, duration in// 播放进度回调} onComplete: { _ in// 播放结束回调}// 停止播放背景音乐audioEffectManager.stopPlayMusic(musicId) // 替换为您需要停止播放的音乐ID
TXAudioEffectManager audioEffectManager = TUIRoomEngine.sharedInstance().getTRTCCloud().getAudioEffectManager();int id = 0; // 替换为您自己的音乐IDString path = "path"; // 替换为音乐文件的完整路径或 URL 地址// 开始播放背景音乐TXAudioEffectManager.AudioMusicParam musicParam = new TXAudioEffectManager.AudioMusicParam(id, path);musicParam.publish = true; // 将音乐传到远端musicParam.loopCount = 0; // 替换为您需要循环播放的次数audioEffectManager.startPlayMusic(musicParam);// 停止播放背景音乐audioEffectManager.stopPlayMusic(id); // 替换为您需要停止播放的音乐ID
setAllMusicVolume接口并传入一个Int值，来设置背景音乐的音量。setAllMusicVolume设置背景音乐音量的示例：import RTCRoomEngineimport TXLiteAVSDK_Professionallet audioEffectManager = TUIRoomEngine.sharedInstance().getTRTCCloud().getAudioEffectManager()let volume = 60 // 替换为您需要设置的音量大小audioEffectManager.setAllMusicVolume(volume)
TXAudioEffectManager audioEffectManager = TUIRoomEngine.sharedInstance().getTRTCCloud().getAudioEffectManager();int volume = 60; // 替换为您需要设置的音量大小audioEffectManager.setAllMusicVolume(volume);
文档反馈