# 播放信息获取 (/zh-CN/api-reference/rtc/ios/play/mediaplayer/mediaplayer-info) > For AI agents: see the complete documentation index at [llms.txt](/llms.txt). ## getAudioBufferDelay [#getaudiobufferdelay] 获取你播放媒体文件时的音频缓冲延迟。 ```objc - (NSInteger)getAudioBufferDelay NS_SWIFT_NAME(getAudioBufferDelay()); ``` ### 返回值 [#返回值] - 0:方法调用成功,返回音频缓冲延迟(毫秒)。 - < 0:方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。你可以使用 `MediaPlayerReason` 检查失败原因。 ### 所属接口类 [#所属接口类] - [AgoraRtcMediaPlayerProtocol](/zh-CN/api-reference/rtc/ios/rtc-interface-class#class_imediaplayer) ## getDuration [#getduration] 获取媒体资源的时长。 ```objc - (NSInteger)getDuration NS_SWIFT_NAME(getDuration()); ``` ### 返回值 [#返回值-1] - 0:方法调用成功。 - < 0:方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。 ### 所属接口类 [#所属接口类-1] - [AgoraRtcMediaPlayerProtocol](/zh-CN/api-reference/rtc/ios/rtc-interface-class#class_imediaplayer) ## getMediaPlayerId [#getmediaplayerid] 获取媒体播放器的 ID。 ```objc - (int)getMediaPlayerId NS_SWIFT_NAME(getMediaPlayerId()); ``` ### 返回值 [#返回值-2] - 0:方法调用成功,返回媒体播放器的 ID。 - < 0:方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。 ### 所属接口类 [#所属接口类-2] - [AgoraRtcMediaPlayerProtocol](/zh-CN/api-reference/rtc/ios/rtc-interface-class#class_imediaplayer) ## getMute [#getmute] 报告媒体资源是否被静音。 ```objc - (BOOL)getMute NS_SWIFT_NAME(getMute()); ``` ### 返回值 [#返回值-3] - YES:媒体资源已静音。 - NO:媒体资源未静音。 ### 所属接口类 [#所属接口类-3] - [AgoraRtcMediaPlayerProtocol](/zh-CN/api-reference/rtc/ios/rtc-interface-class#class_imediaplayer) ## getPlayoutVolume [#getplayoutvolume] 获取本地播放音量。 ```objc - (int)getPlayoutVolume NS_SWIFT_NAME(getPlayoutVolume()); ``` 你可以通过该方法获取本地播放音量,取值范围为 0 到 100。 ### 返回值 [#返回值-4] 方法调用成功,返回本地播放音量,取值范围为 0 到 100。 0 表示静音,100(默认)表示原始音量。 ### 所属接口类 [#所属接口类-4] - [AgoraRtcMediaPlayerProtocol](/zh-CN/api-reference/rtc/ios/rtc-interface-class#class_imediaplayer) ## getPosition [#getposition] 获取当前本地播放进度。 ```objc - (NSInteger)getPosition NS_SWIFT_NAME(getPosition()); ``` ### 返回值 [#返回值-5] - 0:方法调用成功。 - < 0:方法调用失败,详见 [AgoraMediaPlayerReason](/zh-CN/api-reference/rtc/ios/enum-mediaplayerreason)。 ### 所属接口类 [#所属接口类-5] - [AgoraRtcMediaPlayerProtocol](/zh-CN/api-reference/rtc/ios/rtc-interface-class#class_imediaplayer) ## getPlaySrc [#getplaysrc] 获取正在播放的媒体资源路径。 ```objc - (NSString *)getPlaySrc NS_SWIFT_NAME(getPlaySrc()); ``` ### 返回值 [#返回值-6] 方法调用成功时,返回正在播放的媒体资源路径。 方法调用失败时,返回空字符串。 ### 所属接口类 [#所属接口类-6] - [AgoraRtcMediaPlayerProtocol](/zh-CN/api-reference/rtc/ios/rtc-interface-class#class_imediaplayer) ## getPublishSignalVolume [#getpublishsignalvolume] 获取用于发布的媒体文件音量。 ```objc - (int)getPublishSignalVolume NS_SWIFT_NAME(getPublishSignalVolume()); ``` ### 返回值 [#返回值-7] - 0:方法调用成功。 - < 0:方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。 ### 所属接口类 [#所属接口类-7] - [AgoraRtcMediaPlayerProtocol](/zh-CN/api-reference/rtc/ios/rtc-interface-class#class_imediaplayer) ## getPlayerState [#getplayerstate] 获取当前播放状态。 ```objc - (AgoraMediaPlayerState)getPlayerState NS_SWIFT_NAME(getPlayerState()); ``` ### 返回值 [#返回值-8] 方法调用成功,返回当前播放状态,详见 [AgoraMediaPlayerState](/zh-CN/api-reference/rtc/ios/enum-mediaplayerstate)。 ### 所属接口类 [#所属接口类-8] - [AgoraRtcMediaPlayerProtocol](/zh-CN/api-reference/rtc/ios/rtc-interface-class#class_imediaplayer) ## getStreamCount [#getstreamcount] 获取媒体资源中的流的数量。 ```objc - (NSInteger)getStreamCount NS_SWIFT_NAME(getStreamCount()); ``` :::note 注: 在调用该方法前,请先调用 [open\:startPos:](/zh-CN/api-reference/rtc/ios/play/mediaplayer/mediaplayer-open#api_imediaplayer_open) 方法,并等待 `didChangedToState:reason:` 回调报告 `AgoraMediaPlayerStateOpenCompleted` 状态。 ::: ### 返回值 [#返回值-9] - 0:方法调用成功。 - < 0:方法调用失败,详见 [AgoraMediaPlayerReason](/zh-CN/api-reference/rtc/ios/enum-mediaplayerreason)。 ### 所属接口类 [#所属接口类-9] - [AgoraRtcMediaPlayerProtocol](/zh-CN/api-reference/rtc/ios/rtc-interface-class#class_imediaplayer) ## getStreamByIndex: [#getstreambyindex] 获取媒体流的详细信息。 ```objc - (AgoraRtcMediaStreamInfo *_Nullable)getStreamByIndex:(int)index NS_SWIFT_NAME(getStreamBy(_:)); ``` 调用该方法可获取指定索引的媒体流的详细信息。 ### 调用时机 [#调用时机] 在调用 [getStreamCount](/zh-CN/api-reference/rtc/ios/play/mediaplayer/mediaplayer-info#api_imediaplayer_getstreamcount) 方法之后调用该方法。 ### 参数 [#参数] 媒体流的索引。该参数必须小于 [getStreamCount](/zh-CN/api-reference/rtc/ios/play/mediaplayer/mediaplayer-info#api_imediaplayer_getstreamcount) 的返回值。 ### 返回值 [#返回值-10] - 方法调用成功,返回一个 [AgoraRtcMediaStreamInfo](/zh-CN/api-reference/rtc/ios/class-playerstreaminfo) 对象,详见 [AgoraRtcMediaStreamInfo](/zh-CN/api-reference/rtc/ios/class-playerstreaminfo)。 - 方法调用失败,返回 nil。 ### 所属接口类 [#所属接口类-10] - [AgoraRtcMediaPlayerProtocol](/zh-CN/api-reference/rtc/ios/rtc-interface-class#class_imediaplayer) ## AgoraRtcMediaPlayer\:playbackStats: [#agorartcmediaplayerplaybackstats] 播放媒体文件的统计信息回调。 ```objc - (void)AgoraRtcMediaPlayer:(id _Nonnull)playerKit playbackStats:(AgoraMediaPlayerPlaybackStats *_Nonnull)info NS_SWIFT_NAME(AgoraRtcMediaPlayer(_:playbackStats:)); ``` ### 触发时机 [#触发时机] 该回调每秒触发一次,用于报告正在播放的媒体文件的统计信息。 ### 参数 [#参数-1] 播放器实例。详见 [AgoraRtcMediaPlayerProtocol](/zh-CN/api-reference/rtc/ios/rtc-interface-class#class_imediaplayer)。 媒体文件的统计信息。详见 [AgoraMediaPlayerPlaybackStats](/zh-CN/api-reference/rtc/ios/class-playerplaybackstats)。 ### 所属接口类 [#所属接口类-11] - [AgoraRtcMediaPlayerDelegate](/zh-CN/api-reference/rtc/ios/rtc-interface-class#class_imediaplayersourceobserver)