媒体资源播放和渲染

selectAudioTrack

指定当前音频文件的播放音轨。

C++

virtual int selectAudioTrack(int index) = 0;

获取音频文件的音轨索引后，你可以调用该方法指定任一音轨进行播放。例如，如果一个多音轨文件的不同音轨存放了不同语言的歌曲，则你可以调用该方法设置播放语言。

注意：你需要在调用 getStreamInfo 获取音频流索引值后调用该方法。

参数

参数名	描述
index	音轨的索引值。

返回值

• 0: 方法调用成功。

• < 0: 方法调用失败。详见错误码了解详情和解决建议。

所属接口类

• IMediaPlayer

setAudioDualMonoMode

设置当前音频文件的声道模式。

C++

virtual int setAudioDualMonoMode(agora::media::base::AUDIO_DUAL_MONO_MODE mode) = 0;

在双声道音频文件中，左声道和右声道可以存储不同的音频数据。根据实际需要，你可以设置声道模式为原始模式、左声道模式、右声道模式或混合模式。例如，在 KTV 场景中，音频文件的左声道存储了伴奏，右声道存储了原唱的歌声。如果你只需听伴奏，调用该方法设置音频文件的声道模式为左声道模式；如果你需要同时听伴奏和原唱，调用该方法设置声道模式为混合模式。

注意：

• 你需要在调用 open 后调用该方法。

• 该方法仅适用于双声道的音频文件。

参数

参数名	描述
mode	声道模式。详见 AUDIO_DUAL_MONO_MODE。

返回值

• 0: 方法调用成功。

• < 0: 方法调用失败。详见错误码了解详情和解决建议。

所属接口类

• IMediaPlayer

setAudioPitch

调整当前播放的媒体资源的音调。

C++

virtual int setAudioPitch(int pitch) = 0;

注： 你需要在调用 open 后调用该方法。

参数

参数名	描述
pitch	按半音音阶调整本地播放的音乐文件的音调，默认值为 0，即不调整音调。取值范围为 [-12,12]，每相邻两个值的音高距离相差半音。取值的绝对值越大，音调升高或降低得越多。

返回值

• 0: 方法调用成功。

• < 0: 方法调用失败。详见错误码了解详情和解决建议。

所属接口类

• IMediaPlayer

setLoopCount

设置循环播放。

C++

virtual int setLoopCount(int loopCount) = 0;

如果你希望循环播放，请调用该方法并设置循环播放次数。

循环播放结束时，SDK 会触发 onPlayerSourceStateChanged 回调，向你报告播放状态为 PLAYER_STATE_PLAYBACK_ALL_LOOPS_COMPLETED。

参数

参数名	描述
loopCount	循环播放的次数。

返回值

• 0: 方法调用成功。

• < 0: 方法调用失败。详见错误码了解详情和解决建议。

所属接口类

• IMediaPlayer

setPlaybackSpeed

设置当前音频文件的播放速度。

C++

virtual int setPlaybackSpeed(int speed) = 0;

你需要在 open 后调用该方法。

参数

参数名	描述
speed	播放速度。推荐取值范围为 [50,400]，其中： 50: 0.5 倍速。 100: 原始速度。 400: 4 倍速。

返回值

• 0: 方法调用成功。

• < 0: 方法调用失败。详见错误码了解详情和解决建议。

所属接口类

• IMediaPlayer

setSpatialAudioParams

开启或关闭媒体播放器的空间音效。

C++

virtual int setSpatialAudioParams(const SpatialAudioParams& params) = 0;

成功设置媒体播放器的空间音效参数后，SDK 会开启媒体播放器的空间音效，即本地用户听媒体资源会有空间感。

如果需关闭媒体播放器的空间音效，你需要将 params 参数设为空。

参数

参数名	描述
params	媒体播放器的空间音效参数。详见 SpatialAudioParams。

返回值

• 0: 方法调用成功。

• < 0: 方法调用失败。详见错误码了解详情和解决建议。

所属接口类

• IMediaPlayer

setView

设置播放器渲染视图。

C++

virtual int setView(media::base::view_t view) = 0;

参数

参数名	描述
view	渲染视图。Windows 平台为窗口句柄（HWND）。

返回值

• 0: 方法调用成功。

• < 0: 方法调用失败。详见错误码了解详情和解决建议。

所属接口类

• IMediaPlayer