AliPlayer_iOS 技术文档

AliPlayer_iOS 技术文档

---

本文档旨在为开发者详细介绍如何在iOS平台上集成并使用阿里云的AliPlayer SDK，涵盖安装、基本使用、API概览以及高级功能等核心环节，确保您能够快速上手，高效地在应用中集成视频播放能力。

1. 安装指南

阿里云AliPlayer支持CocoaPods进行便捷安装。首先，在您的Xcode项目中，打开Podfile，并添加以下依赖行：

pod 'AliPlayer'

接着，运行命令行工具中的pod install来安装AliPlayer。安装完成后，您将能够在项目中导入AliPlayer的相关库和头文件。

2. 项目的使用说明

初始化播放器

创建AliPlayer或AliListPlayer实例，用于单个或列表视频播放。安全下载的视频需设置加密校验信息：

self.player = [[AliPlayer alloc] init];
self.listPlayer = [[AliListPlayer alloc] init];
[[AliPrivateService alloc] initKey:encrptyFilePath];

设置Delegate

实现AVPDelegate协议中的方法，以便接收播放器状态变化、错误信息等回调。例如：

- (void)viewDidLoad {
    ...
    self.player.delegate = self;
    ...
}

创建播放源并准备播放

选择合适的播放源类（如AVPVidStsSource），设置播放源信息，并使用prepare来准备播放：

AVPVidStsSource *source = [[AVPVidStsSource alloc] init];
source.region = self.videoRegion;
source.vid = self.videoVid;
// 设置其他必要属性
[self.player setStsSource:source];
[self.player prepare];

显示视图与控制播放

设置玩家的显示视图，并通过播放控制接口执行播放、暂停、停止等操作：

self.player.playerView = self.avpPlayerView.playerView;
[self.player start];

3. API使用文档

播放控制相关API

• 播放: [self.player start];
• 暂停: [self.player pause];
• 停止: [self.player stop];
• 跳转: [self.player seekToTime:position seekMode:AVP_SEEKMODE_INACCURATE];
• 释放: [self.player destroy]; self.player = nil;

设置播放特性

• 自动播放: self.player.autoPlay = YES;
• 循环播放: self.player.loop = YES;
• 屏幕旋转: self.player.rotateMode = AVP_ROTATE_0;
• 音量与静音: self.player.volume = 1.0f; self.player.muted = NO;
• 倍速播放: self.player.rate = 1.0f;

回调函数

定义并实现在AVPDelegate中声明的方法，如onError, onPlayerEvent, onCurrentPositionUpdate等，以处理各种播放事件和信息更新。

4. 项目安装方式（已包含在安装指南）

安装阿里云AliPlayer主要通过CocoaPods，通过在Podfile中指定依赖，然后使用CocoaPods进行管理。上述步骤提供了详细的安装过程，确保您的开发环境具备集成条件。

---

遵循以上步骤，您可以顺利完成AliPlayer的集成，并利用其提供的丰富功能来构建强大的视频播放体验。记得调整代码中的示例变量（如videoRegion, videoVid等）以适配实际应用场景。