媒体播放器

  • macOS

更新时间

了解实时互动 RTC 在不同平台上的媒体播放器方式,包括接入流程、关键配置和平台差异。

本文介绍如何调用媒体播放器相关的 API 播放本地或在线媒体资源,或将媒体资源同步分享给声网频道内的远端用户。

前提条件

在进行操作之前,请确保你已经在项目中实现了基本的实时音视频功能。详见实现音视频互动。

实现方法

参考如下步骤,在你的项目中使用媒体播放器:

  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 播放媒体文件。

    注意

    请在收到 didChangedToState 回调报告播放状态为 AgoraMediaPlayerStateOpenCompleted 后再调用 play 方法播放媒体文件。

    Swift
    mediaPlayerKit.play()
  7. 当用户离开频道时,调用 stop 停止播放、调用 destroyMediaPlayer 销毁媒体播放器、取消注册播放观测器,并销毁分配的资源。

    Swift
    mediaPlayerKit.stop()
    agoraKit.destroyMediaPlayer(mediaPlayerKit)

参考信息

示例项目

声网提供了开源的示例项目供你参考,你可以前往下载或查看其中的源代码。

支持的格式

声网的媒体播放器支持下列格式及协议:

视频编码格式

  • 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 参考