Skip to content

GitLab

iOS 直播离线回放SDK开发指南 · Changes

Page history
Created iOS 直播离线回放SDK开发指南 (markdown) authored by Lucces's avatar Lucces
Hide whitespace changes
Inline Side-by-side
Showing with 420 additions and 0 deletions
iOS-直播离线回放SDK开发指南.md 0 → 100644
View page @ 58ecabf1
## 1.概述
Live_iOS_Play_SDK 是一个适用于iOS平台的直播SDK，使用此SDK可以与CC视频云服务进行对接，在iOS端使用CC视频的直播回放功能,本SDK只针对iOS手机播放端。
### 1.1 功能特性
| 功能 | 描述 |
| :----------- | :------------------- |
| 回放视频 | 观看直播回放视频 |
| 文档展示 | 观看直播时展示的文档 |
| 问答 | 观看直播时的问答 |
| 历史聊天数据 | 观看历史聊天数据 |
| 房间信息 | 观看直播间信息 |
### 1.2 阅读对象
本文档为技术文档，需要阅读者：
* 具备基本的iOS开发能力
* 准备接入CC视频的直播回放SDK相关功能
* 对CC云直播产品使用方法有基础的了解，[使用帮助地址](http://doc.bokecc.com/live/manual/introduction/)
## 2.开发准备
### 2.1 开发环境
* Xcode : Xcode 开发IDE
### 2.2错误码及错误描述
(1). 业务错误
typedef NS_ENUM(NSInteger, ERROR_SERVICE_TYPE) {
ERROR_ROOM_STATE = 1001,//@"直播间状态不可用，可能没有开始推流"
ERROR_USELESS_INFO = 1002,//@"没有获取到有用的视频信息"
ERROR_PASSWORD = 1003,//@"密码错误"
};
(2). 系统错误
typedef NS_ENUM(NSInteger, ERROR_SYSTEM_TYPE) {
ERROR_RETURNDATA = 1004,//@"返回内容格式错误"
ERROR_PARAMETER = 1005,//@"可能是参数错误"
ERROR_NETWORK = 1006,//@"网络错误"
};
**日志工具类**
(1) 单例模式
/**
* @brief 获取单例对象
*/
+ (instancetype)sharedInstance;
/**
* @brief 是否需要存储日志信息到文件中，最好在AppDelegate类里面调用，这样就适用于全局日
* 志的存储，当然中途调用也可以，从调用后开始应用之后的日志存储逻辑
*/
-(void)isNeedToSaveLog:(BOOL)needsave;
/**
* @brief 存储日志的信息
* action相当于key，也可以理解为存储的事件名称
* logStr相当于value，也可以理解为存储的日志信息字符串
*/
-(void)saveLog:(NSString *)logStr action:(NSString *)action;
(2) 示例应用及说明
在CCSDK中相关的信息已经做了日志打印的相关处理操作，但是在demo中也添加了几句话，用户也可以自定义添加自己需要的日志，用于记录或者调试都可以。
注意：
1) SDK中设置的日志存储目录为：NSHomeDirectory()/Library/CCLog/ ，存储文件名为yyyy-MM-dd.log
2) SDK中如果开启了日志存储以后，日志只存不删，需要使用者按照自己的逻辑进行删除
1. 在AppDelegate.m中添加了
[[SaveLogUtil sharedInstance]isNeedToSaveLog:YES];
表示设置为记录日志log
2. 在PlayForPCVC.m中添加了
[[SaveLogUtil sharedInstance] saveLog:@"" action:@"视频加载成功或开始播放，多次调用，不必关心"];
表示视频加载成功或开始播放
3. PlayBackVC.m中添加了
[[SaveLogUtil sharedInstance] saveLog:@"" action:@"视频加载成功或开始播放，多次调用，不必关心"];
表示视频加载成功或开始播放
## 3.快速集成
首先，需要下载最新版本的SDK，下载地址为：[Live_iOS_Play_SDK](https://github.com/CCVideo/Live_iOS_Play_SDK)
集成前需要知道的事情:
1. 工程分三个部分：一个有连麦功能（Demo-观看端有连麦），体积较大，一个无连麦功能（Demo-观看端无连麦），体积较小，第三个部分是离线下载回放（Demo-离线下载），其中离线下载回放中的CCSDK用有连麦的库和无连麦的库都可以，示例中用的无连麦的库(体积较小)
2. （重要）本SDK只支持真机，不支持模拟器
3. （重要）本SDK只支持iOS8.0及以上版本，iOS7.x版本不支持
4. （重要）当使用有连麦工程时，分为音视频连麦和音频连麦两种连麦，有连麦的demo中没有以页面体现两种连麦的按钮，当选中简介时，连麦为音视频连麦，当选中 文档，聊天或问答任意一个时，连麦为音频连麦，代码使中用_isAudioVideo加以区分，当_isAudioVideo==YES;时为音视频连麦，当_isAudioVideo==NO;时为音频连麦
### 3.1 导入framework
三个工程SDK目录都在工程目录下的CCSDK文件夹中，文件夹中的所有文件都属于SDK部分，应全部应用(注意不要遗漏socketio.html文件)
### 3.2 Demo
1. Demo-观看端有连麦实现了基本的播放，在线回放逻辑，可以直接运行
2. Demo-观看端无连麦实现了基本的播放，在线回放逻辑，可以直接运行，除无连麦外，功能同上
3. Demo-离线下载实现了基本的离线下载和离线回放逻辑，可以直接运行（其中的CCSDK用4，5两个工程中的任意一个CCSDK文件夹即可）
### 3.3 配置依赖库
在项目/General/Linked framework and libraries 中不要忘记添加对用的依赖
**基础配置类PlayParameter**
```
@property(nonatomic, copy)NSString *userId;//用户ID
@property(nonatomic, copy)NSString *roomId;//房间ID
@property(nonatomic, copy)NSString *viewerName;//用户名称
@property(nonatomic, copy)NSString *token;//房间密码
@property(nonatomic, copy)NSString *liveId;//回放ID，回放时才用到
@property(nonatomic, copy)NSString *recordId;//回放ID
@property(nonatomic, copy)NSString *viewerCustomua;//用户自定义参数，需和后台协商，没有定制传@""
@property(nonatomic, copy)NSString *destination;//下载文件解压到的目录路径(离线下载相关)
@property(nonatomic,strong)UIView *docParent;//文档父类窗口
@property(nonatomic,assign)CGRect docFrame;//文档区域
@property(nonatomic,strong)UIView *playerParent;//视频父类窗口
@property(nonatomic,assign)CGRect playerFrame;//视频区域
@property(nonatomic,assign)BOOL security;//是否使用https，静态库暂时只能使用http协议
/*
* 0:IJKMPMovieScalingModeNone
* 1:IJKMPMovieScalingModeAspectFit
* 2:IJKMPMovieScalingModeAspectFill
* 3:IJKMPMovieScalingModeFill
*/
@property(assign, nonatomic)NSInteger scalingMode;//屏幕适配方式，含义见上面
@property(nonatomic,strong)UIColor *defaultColor;//ppt默认底色，不设置(nil)默认为白色
@property(nonatomic,assign)BOOL pauseInBackGround;//后台是否继续播放，注意：如果开启后台播放需要打开 xcode->Capabilities->Background Modes->on->Audio,AirPlay,and Picture in Picture
/*
* PPT适配模式分为三种，
* 1.一种是全部填充屏幕，可拉伸变形，
* 2.第二种是等比缩放，横向或竖向贴住边缘，另一方向可以留黑边，
* 3.第三种是等比缩放，横向或竖向贴住边缘，另一方向出边界，裁剪PPT，不可以留黑边
*/
@property(assign, nonatomic)NSInteger PPTScalingMode;//PPT适配方式，含义见上面
```
### 3.4 播放离线的文件
**下载的过程这里就不叙述了,请自行编写,如需要Demo里面有完整的下载代码**
首先导入头文件
```
#import "CCSDK/OfflinePlayBack.h"
```
配置参数
```
PlayParameter *parameter = [[PlayParameter alloc] init];
parameter.userId = @"//用户ID";
parameter.roomId = @"//房间ID";
parameter.liveId =@"//直播ID，回放时才用到";
parameter.viewerName = @"//用户名称";
parameter.token =@"//房间密码";
parameter.docParent = @"//文档父类窗口";
parameter.docFrame = @"//文档区域";
parameter.playerParent = @"//视频父类窗口";
parameter.playerFrame = @"//视频区域";
parameter.security = NO;//是否使用https，静态库暂时只能使用http协议
parameter.PPTScalingMode = 1;//PPT适配方式
parameter.pauseInBackGround = NO;//后台是否继续播放，注意：如果开启后台播放需要打开 xcode->Capabilities->Background Modes->on->Audio,AirPlay,and Picture in Picture
parameter.defaultColor = [UIColor whiteColor];//ppt默认底色，不写默认为白色
parameter.scalingMode = 1;//屏幕适配方式
parameter.destination = self.destination;//下载文件解压到的目录路径(离线下载相关)
_offlinePlayBack = [[OfflinePlayBack alloc] initWithParameter:parameter];
_offlinePlayBack.delegate = self;
[_offlinePlayBack startPlayAndDecompress];//开始解析数据并播放视频
```
实现代理方法
```
#pragma mark - OfflinePlayBackDelegate
**
* @brief 请求成功
*/
-(void)requestSucceed {
NSLog(@"请求成功！");
}
/**
* @brief 登录请求失败
*/
-(void)requestFailed:(NSError *)error reason:(NSString *)reason {
NSString *message = nil;
if (reason == nil) {
message = [error localizedDescription];
} else {
message = reason;
}
}
```
## 4. OfflinePlayBack离线回放请求类介绍
### 4.1 在回放OfflinePlayBackVC.m中主要调用此类来和此SDK交互
### 4.2 OfflinePlayBack中的成员变量
```
@property (weak,nonatomic) id<OfflinePlayBackDelegate> delegate;//代理
@property (retain, atomic) id<IJKMediaPlayback> ijkPlayer;//播放器
```
播放器倍速，直播和回放都可以用，一般只用于回放
ijkPlayer.playbackRate = 1.5; 设置播放器以1.5倍速播放，其他倍速同理，可快可慢
float speed = ijkPlayer.playbackRate; 获取当前播放器的播放速度，并赋值给speed变量
### 4.3 OfflinePlayBack中的成员方法
```
/**
* @brief 初始化
* @param parameter 配置参数信息
* 必填参数 docFrame;
* 必填参数 docParent;
* 必填参数 playerParent;
* 必填参数 playerFrame;
* 必填参数 scalingMode;
* 必填参数 destination;
* 必填参数 defaultColor;
* 必填参数 PPTScalingMode;
* 必填参数 pauseInBackGround;
*/
- (id)initWithParameter:(PlayParameter *)parameter;
```
```
/*
* @brief 开始解析数据并播放视频
*/
-(void)startPlayAndDecompress;
```
```
/**
* @brief 销毁文档和视频，清除视频和文档的时候需要调用,推出播放页面的时候也需要调用
*/
- (void)requestCancel;
```
```
/**
* @brief time：从直播开始到现在的秒数，SDK会在画板上绘画出来相应的图形
*/
- (void)continueFromTheTime:(NSInteger)time;
```
```
/**
* @brief 获取文档区域内白板或者文档本身的宽高比，返回值即为宽高比，做屏幕适配用
*/
- (CGFloat)getDocAspectRatio;
```
```
/**
* @brief 改变文档区域大小,主要用在文档生成后改变文档窗口的frame
*/
- (void)changeDocFrame:(CGRect) docFrame;
```
```
/**
* @brief 改变播放器frame
*/
- (void)changePlayerFrame:(CGRect) playerFrame;
```
```
/**
* @brief 改变播放器父窗口
*/
- (void)changePlayerParent:(UIView *) playerParent;
```
```
/**
* @brief 改变文档父窗口
*/
- (void)changeDocParent:(UIView *) docParent;
```
```
/**
* @brief 播放器暂停
*/
- (void)pausePlayer;
```
```
/**
* @brief 播放器播放
*/
- (void)startPlayer;
```
```
/**
* @brief 播放器关闭并移除
*/
- (void)shutdownPlayer;
```
```
/**
* @brief 播放器停止
*/
- (void)stopPlayer;
```
```
/**
* @brief 从头播放
*/
- (void)replayPlayer;
```
```
/**
* @brief 播放器是否播放
*/
- (BOOL)isPlaying;
```
```
/*
* @brief 播放器当前播放时间
*/
- (NSTimeInterval)currentPlaybackTime;
```
```
/*
* @brief 设置播放器当前播放时间（用于拖拽进度条时掉用的）
*/
- (void)setCurrentPlaybackTime:(NSTimeInterval)time;
```
```
/*
* @brief 回放视频总时长
*/
- (NSTimeInterval)playerDuration;
```
```
/**
* @brief 设置后台是否可播放
*/
- (void)setpauseInBackGround:(BOOL)pauseInBackGround;
```
### 4.4事件监听
事件监听只需要实现对应的代理方法即可
#### 4.4.1 获取文档内白板或者文档本身的宽高
```
/**
* @brief 获取文档内白板或者文档本身的宽高，来进行屏幕适配用的
*/
- (void)offline_getDocAspectRatioOfWidth:(CGFloat)width height:(CGFloat)height;
```
#### 4.4.2 历史提问&回答
```
/**
* @brief 收到本房间的历史提问&回答
*/
- (void)offline_onParserQuestionArr:(NSArray *)questionArr onParserAnswerArr:(NSArray *)answerArr;
```
#### 4.4.3 历史聊天数据
```
/**
* @brief 解析本房间的历史聊天数据
*/
-(void)offline_onParserChat:(NSArray *)arr;
```
#### 4.4.4 获取房间信息
```
/**
* @brief 获取房间信息，主要是要获取直播间模版来类型，根据直播间模版类型来确定界面布局
* 房间简介：dic[@"desc"];
* 房间名称：dic[@"name"];
* 房间模版类型：[dic[@"templateType"] integerValue];
* 模版类型为1: 聊天互动： 无 直播文档： 无 直播问答： 无
* 模版类型为2: 聊天互动： 有 直播文档： 无 直播问答： 有
* 模版类型为3: 聊天互动： 有 直播文档： 无 直播问答： 无
* 模版类型为4: 聊天互动： 有 直播文档： 有 直播问答： 无
* 模版类型为5: 聊天互动： 有 直播文档： 有 直播问答： 有
* 模版类型为6: 聊天互动： 无 直播文档： 无 直播问答： 有
*/
-(void)offline_roomInfo:(NSDictionary *)dic;
```
#### 4.4.5 加载视频失败
```
/*
* 加载视频失败
*/
- (void)offline_loadVideoFail;
```
#### 4.4.6 回放翻页数据列表
```
/*
* 回放翻页数据列表
*/
- (void)pageChangeList:(NSMutableArray *)array;
```
### 4.5.事件监听
#### 4.5.1添加播放器监听事件（监听播放状态改变）
```
1. 播放器的监听事件有以下几种
1. IJKMPMoviePlayerLoadStateDidChangeNotification 视频加载视频状态发生改变
（1）IJKMPMovieLoadStateStalled 正在加载
（2）IJKMPMovieLoadStatePlayable 可以播放
（3）IJKMPMovieLoadStatePlaythroughOK 已经缓存完成,如果设置了自动播放,这时会自动播放
2. IJKMPMoviePlayerPlaybackStateDidChangeNotification 视频播放状态发生改变
（1）IJKMPMoviePlaybackStateStopped 播放停止
（2）IJKMPMoviePlaybackStatePlaying 播放
（3）IJKMPMoviePlaybackStatePaused 暂停
（4）IJKMPMoviePlaybackStateInterrupted 打断（停止，中断）
（5）IJKMPMoviePlaybackStateSeekingForward 向前拖动
（6）IJKMPMoviePlaybackStateSeekingBackward 向后拖动
3. IJKMPMoviePlayerPlaybackDidFinishReasonUserInfoKey 视频播放终止播放原因
4. IJKMPMoviePlayerPlaybackDidFinishNotification 视频终止播放
5. IJKMPMovieNaturalSizeAvailableNotification 视频开始播放时，用这个可以监听到视频的分辨率
6. IJKMPMoviePlayerPlaybackDidFinishReasonUserInfoKey 视频播放完成(有可能是加载失败，也有可能是播放结束)
7. IJKMPMoviePlayerPlaybackDidFinishNotification 视频播放完成(有可能是加载失败，也有可能是播放结束)
```
## 5.API查询
Doc目录打开index.html文件
## 6.Q&A
### 6.1如发现 dyld: Library not loaded: @rpath/CCPush.framework/CCPush
Referenced from: /var/containers/Bundle/Application/3CC41924-7F22-48FC-AAD1-7C2C089EF749/demo.app/demo
Reason: image not found问题
将报错的类库添加进入
General -> Embedded Binaries 和 General -> Linked Frameworks and Libraries 两处即可