播放信息获取

getDuration

获取媒体资源的时长。

Objective-C

- (NSInteger)getDuration NS_SWIFT_NAME(getDuration());

返回值

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

所属接口类

• AgoraRtcMediaPlayerProtocol

getMediaPlayerId

获取媒体播放器的 ID。

Objective-C

- (int)getMediaPlayerId NS_SWIFT_NAME(getMediaPlayerId());

返回值

• 0：方法调用成功，返回媒体播放器的 ID。
• < 0：方法调用失败。详见错误码了解详情和解决建议。

所属接口类

• AgoraRtcMediaPlayerProtocol

getMute

报告媒体资源是否被静音。

Objective-C

- (BOOL)getMute NS_SWIFT_NAME(getMute());

返回值

• YES：媒体资源已静音。
• NO：媒体资源未静音。

所属接口类

• AgoraRtcMediaPlayerProtocol

getPlayoutVolume

获取本地播放音量。

Objective-C

- (int)getPlayoutVolume NS_SWIFT_NAME(getPlayoutVolume());

你可以通过该方法获取本地播放音量，取值范围为 0 到 100。

返回值

方法调用成功，返回本地播放音量，取值范围为 0 到 100。 0 表示静音，100（默认）表示原始音量。

所属接口类

• AgoraRtcMediaPlayerProtocol

getPosition

获取当前本地播放进度。

Objective-C

- (NSInteger)getPosition NS_SWIFT_NAME(getPosition());

返回值

• 0：方法调用成功。
• < 0：方法调用失败，详见 AgoraMediaPlayerReason。

所属接口类

• AgoraRtcMediaPlayerProtocol

getPlaySrc

获取正在播放的媒体资源路径。

Objective-C

- (NSString *)getPlaySrc NS_SWIFT_NAME(getPlaySrc());

返回值

方法调用成功时，返回正在播放的媒体资源路径。 方法调用失败时，返回空字符串。

所属接口类

• AgoraRtcMediaPlayerProtocol

getPublishSignalVolume

获取用于发布的媒体文件音量。

Objective-C

- (int)getPublishSignalVolume NS_SWIFT_NAME(getPublishSignalVolume());

返回值

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

所属接口类

• AgoraRtcMediaPlayerProtocol

getPlayerState

获取当前播放状态。

Objective-C

- (AgoraMediaPlayerState)getPlayerState NS_SWIFT_NAME(getPlayerState());

返回值

方法调用成功，返回当前播放状态，详见 AgoraMediaPlayerState。

所属接口类

• AgoraRtcMediaPlayerProtocol

getStreamCount

获取媒体资源中的流的数量。

Objective-C

- (NSInteger)getStreamCount NS_SWIFT_NAME(getStreamCount());

信息

在调用该方法前，请先调用 open:startPos: 方法，并等待 didChangedToState:reason: 回调报告 AgoraMediaPlayerStateOpenCompleted 状态。

返回值

• 0：方法调用成功。
• < 0：方法调用失败，详见 AgoraMediaPlayerReason。

所属接口类

• AgoraRtcMediaPlayerProtocol

getStreamByIndex:

获取媒体流的详细信息。

Objective-C

- (AgoraRtcMediaStreamInfo *_Nullable)getStreamByIndex:(int)index NS_SWIFT_NAME(getStreamBy(_:));

调用该方法可获取指定索引的媒体流的详细信息。

调用时机

在调用 getStreamCount 方法之后调用该方法。

参数

index

媒体流的索引。该参数必须小于 getStreamCount 的返回值。

返回值

• 方法调用成功，返回一个 AgoraRtcMediaStreamInfo 对象，详见 AgoraRtcMediaStreamInfo。
• 方法调用失败，返回 nil。

所属接口类

• AgoraRtcMediaPlayerProtocol

AgoraRtcMediaPlayer:playbackStats:

播放媒体文件的统计信息回调。

Objective-C

- (void)AgoraRtcMediaPlayer:(id<AgoraRtcMediaPlayerProtocol> _Nonnull)playerKit playbackStats:(AgoraMediaPlayerPlaybackStats *_Nonnull)info NS_SWIFT_NAME(AgoraRtcMediaPlayer(_:playbackStats:));

触发时机

该回调每秒触发一次，用于报告正在播放的媒体文件的统计信息。

参数

playerKit

播放器实例。详见 AgoraRtcMediaPlayerProtocol。

info

媒体文件的统计信息。详见 AgoraMediaPlayerPlaybackStats。

所属接口类

• AgoraRtcMediaPlayerDelegate