iOS媒体播放器集成与实现-阿里云帮助中心

环境要求

iOS端具体环境要求，更多信息，请参见支持的平台。

功能说明

目前支持播放的媒体格式有视频格式（MP4、M3U8、FLV、MKV）和音频格式（MP3），并且支持H.264、H.265视频编码和AAC音频编码。
使用阿里云播放器（AliyunPlayer）可实现本地播放媒体资源；阿里云RTC SDK实现实时音视频通信；AliRtcPlayerExtension支持将播放的媒体流发布给同频道中的远端用户，远端用户可以订阅并播放。
发布播放器画面到远端时，支持使用屏幕流通道，远端用户可通过订阅相机流和屏幕流，同时看到主播和播放器的画面。

集成开发环境

创建Xcode项目，具体操作，请参见Create a project。
集成阿里云RTC SDK，具体操作，请参见集成客户端SDK。

说明需要集成RTC SDK 1.17.48及以上版本，目前暂不支持RTC SDK 2.1版本，详情请参见SDK下载。
集成阿里云播放器SDK，具体操作，请参见iOS端集成。
需要集成阿里云播放器SDK 5.4.1.2版本，建议使用pod方式集成，如下所示：
```
target 'Your App' do
    pod 'AliPlayerSDK_iOS', '~> version', '5.4.1.2'
end
```
集成媒体播放器组件。
1. 下载并解压媒体播放器组件，下载地址，请参见组件下载。
2. 将解压后的媒体播放器组件文件复制到工程中。
3. 在业务代码中导入头文件。
```
#import "AliRtcPlayerExtension.h"
```

功能实现——本地播放媒体资源

集成阿里云播放器SDK后，您可以实现本地播放功能，步骤如下：

创建播放器实例。
```
self.player = [[AliPlayer alloc] init];
```

设置播放器监听事件。

播放器提供了多种监听事件，通过监听这些事件，您可以更好地掌握播放过程，如果播放发生异常，您可以根据这些事件排查问题。回调详细说明请参见接口说明。示例如下所示：

@interface SimplePlayerViewController ()<AVPDelegate>
@end
- (void)viewDidLoad {
    self.player = [[AliPlayer alloc] init];
    self.player.playerView = self.avpPlayerView.playerView;
    self.player.delegate = self;
    //...
}
/**
 @brief 错误代理回调
 @param player 播放器player指针
 @param errorModel 播放器错误描述，参考AliVcPlayerErrorModel
 */
- (void)onError:(AliPlayer*)player errorModel:(AVPErrorModel *)errorModel {
    //提示错误，及stop播放
}
/**
 @brief 播放器事件回调
 @param player 播放器player指针
 @param eventType 播放器事件类型，@see AVPEventType
 */
-(void)onPlayerEvent:(AliPlayer*)player eventType:(AVPEventType)eventType {
    switch (eventType) {
        case AVPEventPrepareDone: {
            // 准备完成
        }
            break;
        case AVPEventAutoPlayStart:
            // 自动播放开始事件
            break;
        case AVPEventFirstRenderedStart:
            // 首帧显示
            break;
        case AVPEventCompletion:
            // 播放完成
            break;
        case AVPEventLoadingStart:
            // 缓冲开始
            break;
        case AVPEventLoadingEnd:
            // 缓冲完成
            break;
        case AVPEventSeekEnd:
            // 跳转完成
            break;
        case AVPEventLoopingStart:
            // 循环播放开始
            break;
        default:
            break;
    }
}
/**
 @brief 视频当前播放位置回调
 @param player 播放器player指针
 @param position 视频当前播放位置
 */
- (void)onCurrentPositionUpdate:(AliPlayer*)player position:(int64_t)position {
    // 更新进度条
}
//...

准备播放。

创建DataSource。
此处以AVPUrlSource为例，调用AliPlayer接口的prepare准备播放，支持网络路径或本地路径。如下所示：
```
AVPUrlSource *source = [[AVPUrlSource alloc] urlWithString:@"播放地址"];
[self.player setUrlSource:source];
[self.player prepare];
```
说明请确保收到onPlayerEvent回调播放状态为AVPEventPrepareDone后再进行下一步操作。

设置显示的view及播放控制。

//设置view
self.player.playerView = self.avpPlayerView.playerView;//用户显示的view
// 开始播放
[self.player start];
//暂停播放
[self.player pause];
//停止播放
[self.player stop];
// 跳转到，目前只支持不精准
[self.player seekToTime:position seekMode:AVP_SEEKMODE_INACCURATE];
// 重置
[self.player reset];
//释放，释放后播放器将不可再被使用
[self.player destroy];
self.player = nil;

说明本地screen流不预览，不需要设置view给RtcEngine。

更多功能使用方式，请参见功能使用。

功能实现——发布媒体资源到远端

集成完阿里云RTC SDK、阿里云播放器SDK、媒体播放器组件后，您可以发布媒体资源供频道内的远端用户订阅，步骤如下：

初始化RTC SDK并加入频道。

创建AliRtcEngine实例，实现本地用户以主播身份加入互动模式频道。

// 创建RtcEngine
self.engine = [AliRtcEngine sharedInstance:selfextras:@""];
//设置频道模式为互动模式
[self.engine setChannelProfile:AliRtcInteractivelive];
//设置角色为AliRTCSDK_Interactive
[self.engine setClientRole:AliRtcClientRoleInteractive];
//加入频道
[self.engine joinChannel:authInfo name:name onResult:^(NSInteger errCode){
    if (errCode == 0) {
    //加入频道成功
    } else {
    //加入频道失败
    }
}];

说明请确保收到onJoinChannelResult回调后再进行下一步操作。

创建播放器并绑定指定频道。

//创建播放器对象
self.player = [[AliPlayer alloc]init];
self.player.delegate = self;
self.player.playerView = self.containerView;

//如果业务层未单独保存播放器相关日志，建议将播放器关键日志绑定到RTC，方便问题分析
[AliRtcPlayerExtension enablePlayerLogger:YES];
//创建AliRtcPlayerExtension对象并绑定AliRtcEngine对象
self.playerExtension = [AliRtcPlayerExtension shareInstance];
[self.playerExtension bindPlayerToRtcEngine:self.player engine:self.engine]

发布媒体资源。

//使用屏幕流时，需调用configLocalScreenPublish打开屏幕流
[self.engine configLocalScreenPublish:YES];

// 使用播放器播放本地或在线资源（参考本地播放媒体资源）。

// 分享播放器媒体流给远端用户
[self.playerExtension publishAudio:NO];
[self.playerExtension publishVideo:AliRtcVideosourceScreenShareType renderMode:AliRtcRenderModeAuto];

说明 AliRtcPlayerExtension会设置播放器音频为mute状态，当调用publishAudio后，通过RtcEngine进行音频播放，实现回声消除等功能。

您可以调用setExternalAudioPublishVolume方法调节远端用户听到的音量，或者调用setExternalAudioPlayoutVolume方法调节本地用户的播放音量。

可选：取消发布媒体资源并解除绑定频道。

[self.engine configLocalScreenPublish:NO];
[self.playerExtension unpublishVideo];
[self.playerExtension unpublishAudio];

// 取消播放器和RtcEngine的绑定
[self.playerExtension unbindPlayerFromRtcEngine];

前提条件

环境要求

功能说明

集成开发环境

功能实现——本地播放媒体资源

功能实现——发布媒体资源到远端