# 媒体播放器 (/zh-CN/realtime-media/rtc/build/audio/media-player/ios) > For AI agents: see the complete documentation index at [llms.txt](/llms.txt). 本文介绍如何调用媒体播放器相关的 API 播放本地或在线媒体资源,或将媒体资源同步分享给声网频道内的远端用户。 ## 前提条件 [#前提条件-1] 在进行操作之前,请确保你已经在项目中实现了基本的实时音视频功能。详见[实现音视频互动](/zh-CN/realtime-media/rtc/get-started/quick-start)。 ## 实现方法 [#实现方法-1] 参考如下步骤,在你的项目中使用媒体播放器: 1. 初始化 `AgoraRtcEngineKit` 后,调用 `createMediaPlayer` 创建 `AgoraRtcMediaPlayerProtocol` 对象。 ```swift // 初始化 AgoraRtcEngineKit agoraKit = AgoraRtcEngineKit.sharedEngine(with: config, delegate: self) // 创建 mediaPlayerKit 对象 mediaPlayerKit = agoraKit.createMediaPlayer(with: self) ``` 2. 实现媒体播放器回调。根据你的需求,你可以通过 `didChangedToState` 回调来观测播放器的状态,通过 `didChangedToPosition` 回调来获取当前媒体文件的播放进度。 ```swift extension MediaPlayerMain: AgoraRtcMediaPlayerDelegate { // 报告播放器的状态 func agoraRtcMediaPlayer(_ playerKit: AgoraRtcMediaPlayerProtocol, didChangedTo state: AgoraMediaPlayerState, error: AgoraMediaPlayerError) { LogUtils.log(message: "player rtc channel publish helper state changed to: \(state.rawValue), error: \(error.rawValue)", level: .info) DispatchQueue.main.async { [weak self] in guard let weakself = self else { return } switch state { case .failed: weakself.showAlert(message: "media player error: \(error.rawValue)") break case .openCompleted: let duration = weakself.mediaPlayerKit.getDuration() weakself.playerControlStack.isHidden = false weakself.playerDurationLabel.text = "\(String(format: "%02d", duration / 60)) : \(String(format: "%02d", duration % 60))" weakself.playerProgressSlider.setValue(0, animated: true) break case .stopped: weakself.playerControlStack.isHidden = true weakself.playerProgressSlider.setValue(0, animated: true) weakself.playerDurationLabel.text = "00 : 00" break default: break } } } // 报告当前的播放进度 func agoraRtcMediaPlayer(_ playerKit: AgoraRtcMediaPlayerProtocol, didChangedToPosition position: Int) { let duration = Float(mediaPlayerKit.getDuration() * 1000) var progress: Float = 0 var left: Int = 0 if duration > 0 { progress = Float(mediaPlayerKit.getPosition()) / duration left = Int((mediaPlayerKit.getDuration() * 1000 - mediaPlayerKit.getPosition()) / 1000) } DispatchQueue.main.async { [weak self] in guard let weakself = self else { return } weakself.playerDurationLabel.text = "\(String(format: "%02d", left / 60)) : \(String(format: "%02d", left % 60))" if !weakself.playerProgressSlider.isTouchInside { weakself.playerProgressSlider.setValue(progress, animated: true) } } } } ``` 3. 调用 `setupLocalVideo` 渲染本地媒体播放视图。 ```swift mediaPlayerKit.setView(localVideo.videoView) let videoCanvas = AgoraRtcVideoCanvas() videoCanvas.view = localVideo.videoView videoCanvas.renderMode = .hidden videoCanvas.sourceType = .mediaPlayer videoCanvas.sourceId = mediaPlayerKit.getMediaPlayerId() agoraKit.setupLocalVideo(videoCanvas) ``` 4. 调用 `joinChannelByToken` 加入频道时,通过 `mediaOptions` 设置媒体播放器 ID,发布媒体播放器的音视频,将媒体资源分享给声网频道内的远端用户。 ```swift let option1 = AgoraRtcChannelMediaOptions() ... option1.publishMediaPlayerId = .of((Int32)(mediaPlayerKit.getMediaPlayerId())) ``` 5. 调用 `open` 打开本地或在线媒体文件。 ```swift mediaPlayerKit.open(url, startPos: 0) ``` 6. 调用 `play` 播放媒体文件。 :::warning[注意] 请在收到 `didChangedToState` 回调报告播放状态为 `AgoraMediaPlayerStateOpenCompleted` 后再调用 `play` 方法播放媒体文件。 ::: ```swift mediaPlayerKit.play() ``` 7. 当用户离开频道时,调用 `stop` 停止播放、调用 `destroyMediaPlayer` 销毁媒体播放器、取消注册播放观测器,并销毁分配的资源。 ```swift mediaPlayerKit.stop() agoraKit.destroyMediaPlayer(mediaPlayerKit) ``` ## 参考信息 [#参考信息-1] ### 示例项目 [#示例项目-1] 声网提供了开源的示例项目供你参考,你可以前往下载或查看其中的源代码。 ### 支持的格式 [#支持的格式-1] 声网的媒体播放器支持下列格式及协议: **视频编码格式** - H.263、H.264、H.265、MPEG4、MPEG2、RMVB、Theora、VP3、VP8、AVS、WMV **音频编码格式** - WAV、MP2、MP3、AAC、OPUS、FLAC、Vorbis、AMR-NB、AMR-WB、WMA v1、WMA v2 **容器格式** - WAV、FLAC、OGG、MOV、ASF、FLV、MP3、MP4、MPEG-TS、Matroska (MKV)、AVI、ASS、CONCAT、DTS、AVS **支持的协议** - HTTP、HTTPS、RTMP、HLS、RTP、RTSP ### API 参考 [#api-参考-1] - [`createMediaPlayerWithDelegate`](/zh-CN/api-reference/rtc/ios/play/mediaplayer/mediaplayer-initialize#api_irtcengine_createmediaplayer) - [`destroyMediaPlayer`](/zh-CN/api-reference/rtc/ios/play/mediaplayer/mediaplayer-initialize#api_irtcengine_destroymediaplayer) - [`getMediaPlayerId`](/zh-CN/api-reference/rtc/ios/play/mediaplayer/mediaplayer-info#api_imediaplayer_getmediaplayerid) - [`open`](/zh-CN/api-reference/rtc/ios/play/mediaplayer/mediaplayer-open#api_imediaplayer_open) - [`play`](/zh-CN/api-reference/rtc/ios/play/mediaplayer/mediaplayer-control#api_imediaplayer_play) - [`pause`](/zh-CN/api-reference/rtc/ios/play/mediaplayer/mediaplayer-control#api_imediaplayer_pause) - [`stop`](/zh-CN/api-reference/rtc/ios/play/mediaplayer/mediaplayer-control#api_imediaplayer_stop)