媒体资源播放和渲染
- macOS
更新时间不可用
selectAudioTrack:
选择播放过程中使用的音轨。
- (int)selectAudioTrack:(int)index NS_SWIFT_NAME(selectAudioTrack(_:));获取音频文件的音轨索引后，可以调用该方法指定任意音轨进行播放。例如，如果一个多音轨文件的不同音轨存储了不同语言的歌曲，可以调用该方法设置播放语言。
注： 需要在调用 getStreamByIndex: 获取音频流索引值之后再调用该方法。
参数
返回值
- 0：方法调用成功。
- < 0：方法调用失败。详见错误码了解详情和解决建议。
所属接口类
setAudioDualMonoMode:
设置当前音频文件的声道模式。
- (int)setAudioDualMonoMode:(AgoraAudioDualMonoMode)mode NS_SWIFT_NAME(setAudioDualMonoMode(_:));你可以使用该方法设置当前音频文件的声道模式，包括原始模式、左声道模式、右声道模式或混合声道模式。例如，在 KTV 场景中，音乐文件的左声道存储伴奏，右声道存储人声。如果你只需要听伴奏，可以调用该方法将声道模式设置为左声道模式；如果你需要同时听到伴奏和人声，可以将声道模式设置为混合声道模式。
注：
- 请在调用 open:startPos: 方法之后调用此方法。
- 此方法仅适用于立体声音频文件。
参数
| 参数名 | 描述 |
|---|---|
mode | 声道模式。详见 AgoraAudioDualMonoMode。 |
返回值
- 0：方法调用成功。
- < 0：方法调用失败。详见错误码了解详情和解决建议。
所属接口类
setAudioPitch:
设置当前媒体资源的音调。
- (int)setAudioPitch:(NSInteger)pitch NS_SWIFT_NAME(setAudioPitch(_:));注： 请在调用 open:startPos: 方法之后调用此方法。
参数
返回值
- 0：方法调用成功。
- < 0：方法调用失败。详见错误码了解详情和解决建议。
所属接口类
setLoopCount:
设置循环播放次数。
- (int)setLoopCount:(int)loopCount NS_SWIFT_NAME(setLoopCount(_:));调用此方法可设置循环播放次数。循环播放完成后，SDK 会触发 AgoraRtcMediaPlayer:didChangedToState:reason: 回调，并报告播放状态为 AgoraMediaPlayerStatePlayBackAllLoopsCompleted。
参数
返回值
- 0：方法调用成功。
- < 0：方法调用失败。详见错误码了解详情和解决建议。
所属接口类
setPlaybackSpeed:
设置当前音频文件的播放速度。
- (int)setPlaybackSpeed:(int)speed NS_SWIFT_NAME(setPlaybackSpeed(_:));调用该方法前，需要先调用 open:startPos: 方法。
参数
返回值
- 0：方法调用成功。
- < 0：方法调用失败。详见错误码了解详情和解决建议。
所属接口类
setPlayerOption:value:
设置媒体播放器选项。
- (int)setPlayerOption:(NSString *)key value:(NSInteger)value NS_SWIFT_NAME(setPlayerOption(_:value:));你可以通过 key 和 value 设置媒体播放器的选项。该方法与 setPlayerOptionString:value: 的区别在于，本方法的 value 参数类型为 NSInteger，而 setPlayerOptionString:value: 的 value 参数类型为 NSString。这两个方法不能同时使用。一般情况下，你无需调用此方法，直接使用媒体播放器提供的默认选项即可。
适用场景
适用于需要技术预览或特殊定制功能的场景。
调用时机
在调用 open:startPos: 或 openWithMediaSource: 方法之前调用。
参数
返回值
- 0：方法调用成功。
- < 0：方法调用失败。详见错误码了解详情和解决建议。
所属接口类
setPlayerOptionString:value:
设置媒体播放器的选项。
- (int)setPlayerOptionString:(NSString *)key value:(NSString *)value NS_SWIFT_NAME(setPlayerOptionString(_:value:));你可以通过 key 和 value 设置媒体播放器的选项。该方法与 setPlayerOption:value: 的区别在于，此方法的 value 参数类型为 NSString，而 setPlayerOption:value: 的 value 参数类型也是 NSString，但这两个方法不能同时使用。通常情况下，你无需调用此方法，直接使用媒体播放器提供的默认选项即可。
适用场景
适用于需要技术预览或特殊定制功能的场景。
调用时机
在调用 open:startPos: 或 openWithMediaSource: 方法之前调用此方法。
参数
返回值
- 0：方法调用成功。
- < 0：方法调用失败。详见错误码了解详情和解决建议。
所属接口类
setView:
设置渲染视图。
- (int)setView:(View *_Nullable)view NS_SWIFT_NAME(setView(_:));调用时机
你可以在加入频道前或加入后调用该方法。
参数
返回值
- 0：方法调用成功。
- < 0：方法调用失败。详见错误码了解详情和解决建议。