媒体资源播放和渲染

selectAudioTrack

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

Dart

Future<void> selectAudioTrack(int index);

详情

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

注意

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

参数

index

音轨的索引值。

返回值

方法成功调用时，无返回值；方法调用失败时，会抛出 AgoraRtcException 异常，你需要捕获异常并进行处理。详见错误码了解详情和解决建议。

所属接口类

• MediaPlayer

setAudioDualMonoMode

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

Dart

Future<void> setAudioDualMonoMode(AudioDualMonoMode mode);

详情

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

注意

• 你需要在调用 open 后调用该方法。
• 该方法仅适用于双声道的音频文件。

参数

mode

声道模式。详见 AudioDualMonoMode。

返回值

方法成功调用时，无返回值；方法调用失败时，会抛出 AgoraRtcException 异常，你需要捕获异常并进行处理。详见错误码了解详情和解决建议。

所属接口类

• MediaPlayer

setAudioPitch

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

Dart

Future<void> setAudioPitch(int pitch);

详情

信息

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

参数

pitch

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

返回值

方法成功调用时，无返回值；方法调用失败时，会抛出 AgoraRtcException 异常，你需要捕获异常并进行处理。详见错误码了解详情和解决建议。

所属接口类

• MediaPlayer

setLoopCount

设置循环播放。

Dart

Future<void> setLoopCount(int loopCount);

详情

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

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

参数

loopCount

循环播放的次数。

• ≥0：循环次数。例如，设为 0 表示不循环播放，一共播放一次；设为 1 表示循环播放一次，一共播放 2 次。
• -1：无限循环播放。

返回值

方法成功调用时，无返回值；方法调用失败时，会抛出 AgoraRtcException 异常，你需要捕获异常并进行处理。详见错误码了解详情和解决建议。

所属接口类

• MediaPlayer

setPlaybackSpeed

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

Dart

Future<void> setPlaybackSpeed(int speed);

详情

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

参数

speed

播放速度。推荐取值范围为 [50,400]，其中：

• 50: 0.5 倍速。
• 100: 原始速度。
• 400: 4 倍速。

返回值

方法成功调用时，无返回值；方法调用失败时，会抛出 AgoraRtcException 异常，你需要捕获异常并进行处理。详见错误码了解详情和解决建议。

所属接口类

• MediaPlayer

setPlayerOptionInInt

设置媒体播放器选项，用于提供技术预览或特别定制功能。

Dart

Future<void> setPlayerOptionInInt({required String key, required int value});

详情

媒体播放器支持通过 key 和 value 来设置选项。一般情况下，你无需知晓选项设置，使用媒体播放器默认的选项设置即可。

该方法和 setPlayerOptionInString 的区别在于，该方法的 value 是 Int 型，setPlayerOptionInString 的 value 是 String 型。二者不可混用。

注意

请确保在 open 或 openWithMediaSource 之前调用该方法。

参数

key

key 值。

value

value 值。

返回值

方法成功调用时，无返回值；方法调用失败时，会抛出 AgoraRtcException 异常，你需要捕获异常并进行处理。详见错误码了解详情和解决建议。

所属接口类

• MediaPlayer

setPlayerOptionInString

设置媒体播放器选项，用于提供技术预览或特别定制功能。

Dart

Future<void> setPlayerOptionInString(
    {required String key, required String value});

详情

媒体播放器支持通过 key 和 value 来设置选项。一般情况下，你无需知晓选项设置，使用媒体播放器默认的选项设置即可。

该方法和 setPlayerOptionInInt 的区别在于，该方法的 value 是 String 型，setPlayerOptionInInt 的 value 是 Int 型。二者不可混用。

注意

请确保在 open 或 openWithMediaSource 之前调用该方法。

参数

key

key 值。

value

value 值。

返回值

方法成功调用时，无返回值；方法调用失败时，会抛出 AgoraRtcException 异常，你需要捕获异常并进行处理。详见错误码了解详情和解决建议。

所属接口类

• MediaPlayer

setView

设置播放器渲染视图。

Dart

Future<void> setView(int view);

注意

在 Flutter 中你不需要主动调用该方法，请使用 AgoraVideoView 渲染本地和远端视图。

参数

view

渲染视图。Windows 平台为窗口句柄（HWND）。

返回值

方法成功调用时，无返回值；方法调用失败时，会抛出 AgoraRtcException 异常，你需要捕获异常并进行处理。详见错误码了解详情和解决建议。

所属接口类

• MediaPlayer