播放信息获取
- macOS
更新时间不可用
getDuration
获取媒体资源的时长。
- (NSInteger)getDuration NS_SWIFT_NAME(getDuration());返回值
- 0：方法调用成功。
- < 0：方法调用失败。详见错误码了解详情和解决建议。
所属接口类
getMediaPlayerId
获取媒体播放器的 ID。
- (int)getMediaPlayerId NS_SWIFT_NAME(getMediaPlayerId());返回值
- 0：方法调用成功，返回媒体播放器的 ID。
- < 0：方法调用失败。详见错误码了解详情和解决建议。
所属接口类
getMute
报告媒体资源是否被静音。
- (BOOL)getMute NS_SWIFT_NAME(getMute());返回值
- YES：媒体资源已静音。
- NO：媒体资源未静音。
所属接口类
getPlayoutVolume
获取本地播放音量。
- (int)getPlayoutVolume NS_SWIFT_NAME(getPlayoutVolume());你可以通过该方法获取本地播放音量，取值范围为 0 到 100。
返回值
方法调用成功，返回本地播放音量，取值范围为 0 到 100。 0 表示静音，100（默认）表示原始音量。
所属接口类
getPosition
获取当前本地播放进度。
- (NSInteger)getPosition NS_SWIFT_NAME(getPosition());返回值
- 0：方法调用成功。
- < 0：方法调用失败，详见 AgoraMediaPlayerReason。
所属接口类
getPlaySrc
获取正在播放的媒体资源路径。
- (NSString *)getPlaySrc NS_SWIFT_NAME(getPlaySrc());返回值
方法调用成功时，返回正在播放的媒体资源路径。 方法调用失败时，返回空字符串。
所属接口类
getPublishSignalVolume
获取用于发布的媒体文件音量。
- (int)getPublishSignalVolume NS_SWIFT_NAME(getPublishSignalVolume());返回值
- 0：方法调用成功。
- < 0：方法调用失败。详见错误码了解详情和解决建议。
所属接口类
getPlayerState
获取当前播放状态。
- (AgoraMediaPlayerState)getPlayerState NS_SWIFT_NAME(getPlayerState());返回值
方法调用成功，返回当前播放状态，详见 AgoraMediaPlayerState。
所属接口类
getStreamCount
获取媒体资源中的流的数量。
- (NSInteger)getStreamCount NS_SWIFT_NAME(getStreamCount());注： 在调用该方法前，请先调用 open:startPos: 方法，并等待 didChangedToState:reason: 回调报告 AgoraMediaPlayerStateOpenCompleted 状态。
返回值
- 0：方法调用成功。
- < 0：方法调用失败，详见 AgoraMediaPlayerReason。
所属接口类
getStreamByIndex:
获取媒体流的详细信息。
- (AgoraRtcMediaStreamInfo *_Nullable)getStreamByIndex:(int)index NS_SWIFT_NAME(getStreamBy(_:));调用该方法可获取指定索引的媒体流的详细信息。
调用时机
在调用 getStreamCount 方法之后调用该方法。
参数
| 参数名 | 描述 |
|---|---|
index | 媒体流的索引。该参数必须小于 getStreamCount 的返回值。 |
返回值
- 方法调用成功，返回一个 AgoraRtcMediaStreamInfo 对象，详见 AgoraRtcMediaStreamInfo。
- 方法调用失败，返回 nil。
所属接口类
AgoraRtcMediaPlayer:playbackStats:
播放媒体文件的统计信息回调。
- (void)AgoraRtcMediaPlayer:(id<AgoraRtcMediaPlayerProtocol> _Nonnull)playerKit playbackStats:(AgoraMediaPlayerPlaybackStats *_Nonnull)info NS_SWIFT_NAME(AgoraRtcMediaPlayer(_:playbackStats:));触发时机
该回调每秒触发一次，用于报告正在播放的媒体文件的统计信息。
参数
| 参数名 | 描述 |
|---|---|
playerKit | 播放器实例。详见 AgoraRtcMediaPlayerProtocol。 |
info | 媒体文件的统计信息。详见 AgoraMediaPlayerPlaybackStats。 |