|
|
|
## 1.概述
|
|
|
|
Live_iOS_Play_SDK 是一个适用于iOS平台的直播SDK，使用此SDK可以与CC视频云服务进行对接，在iOS端使用CC视频的直播回放功能,本SDK只针对iOS手机播放端。
|
|
|
|
|
|
|
|
### 1.1 功能特性
|
|
|
|
| 功能 | 描述 |
|
|
|
|
| :----------- | :------------------- |
|
|
|
|
| 回放视频 | 观看直播回放视频 |
|
|
|
|
| 文档展示 | 观看直播时展示的文档 |
|
|
|
|
| 问答 | 观看直播时的问答 |
|
|
|
|
| 历史聊天数据 | 观看历史聊天数据 |
|
|
|
|
| 房间信息 | 观看直播间信息 |
|
|
|
|
|
|
|
|
### 1.2 阅读对象
|
|
|
|
# 1.概述
|
|
|
|
|
|
|
|
## 1.1 阅读对象
|
|
|
|
|
|
|
|
本文档为技术文档，需要阅读者：
|
|
|
|
* 具备基本的iOS开发能力
|
|
|
|
* 准备接入CC视频的直播回放SDK相关功能
|
|
|
|
* 对CC云直播产品使用方法有基础的了解，[使用帮助地址](http://doc.bokecc.com/live/manual/introduction/)
|
|
|
|
|
|
|
|
- 具备基本的iOS开发能力
|
|
|
|
- 准备接入CC视频的直播SDK相关功能
|
|
|
|
- 对CC云直播产品使用方法有基础的了解，[使用帮助地址](https://doc.bokecc.com/live/)
|
|
|
|
|
|
|
|
## 2.开发准备
|
|
|
|
##1.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). 系统错误
|
|
|
|
# 2.开发准备
|
|
|
|
|
|
|
|
typedef NS_ENUM(NSInteger, ERROR_SYSTEM_TYPE) {
|
|
|
|
ERROR_RETURNDATA = 1004,//@"返回内容格式错误"
|
|
|
|
ERROR_PARAMETER = 1005,//@"可能是参数错误"
|
|
|
|
ERROR_NETWORK = 1006,//@"网络错误"
|
|
|
|
};
|
|
|
|
## 2.1 开发环境
|
|
|
|
|
|
|
|
**日志工具类**
|
|
|
|
(1) 单例模式
|
|
|
|
- Xcode : Xcode 开发IDE
|
|
|
|
- Version 10.0 及以上
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @brief 获取单例对象
|
|
|
|
*/
|
|
|
|
+ (instancetype)sharedInstance;
|
|
|
|
##2.2 SDK配置
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @brief 是否需要存储日志信息到文件中，最好在AppDelegate类里面调用，这样就适用于全局日
|
|
|
|
* 志的存储，当然中途调用也可以，从调用后开始应用之后的日志存储逻辑
|
|
|
|
*/
|
|
|
|
-(void)isNeedToSaveLog:(BOOL)needsave;
|
|
|
|
### 2.2.1 CocoaPods集成
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @brief 存储日志的信息
|
|
|
|
* action相当于key，也可以理解为存储的事件名称
|
|
|
|
* logStr相当于value，也可以理解为存储的日志信息字符串
|
|
|
|
*/
|
|
|
|
-(void)saveLog:(NSString *)logStr action:(NSString *)action;
|
|
|
|
**已安装CocoaPods**
|
|
|
|
|
|
|
|
(2) 示例应用及说明
|
|
|
|
```
|
|
|
|
如果是有连麦的SDK:
|
|
|
|
pod 'CCLivePlaySDK', '~> 3.8.0'
|
|
|
|
如果是无连麦的SDK:
|
|
|
|
pod 'CCLivePlaySDK', :podspec => 'https://raw.githubusercontent.com/CCVideo/Live_iOS_Play_SDK/3.8.0/CCLivePlaySDK.podspec'
|
|
|
|
|
|
|
|
在CCSDK中相关的信息已经做了日志打印的相关处理操作，但是在demo中也添加了几句话，用户也可以自定义添加自己需要的日志，用于记录或者调试都可以。
|
|
|
|
注:3.8.0为版本号,修改为自己想要的版本号即可
|
|
|
|
```
|
|
|
|
|
|
|
|
注意：
|
|
|
|
**未安装CocoaPods**
|
|
|
|
|
|
|
|
1) SDK中设置的日志存储目录为：NSHomeDirectory()/Library/CCLog/ ，存储文件名为yyyy-MM-dd.log
|
|
|
|
1. 安装CocoaPods
|
|
|
|
|
|
|
|
2) SDK中如果开启了日志存储以后，日志只存不删，需要使用者按照自己的逻辑进行删除
|
|
|
|
打开终端：>_
|
|
|
|
1、查看当前Ruby版本
|
|
|
|
|
|
|
|
1. 在AppDelegate.m中添加了
|
|
|
|
[[SaveLogUtil sharedInstance]isNeedToSaveLog:YES];
|
|
|
|
表示设置为记录日志log
|
|
|
|
```
|
|
|
|
ruby -v
|
|
|
|
```
|
|
|
|
|
|
|
|
2. 在PlayForPCVC.m中添加了
|
|
|
|
[[SaveLogUtil sharedInstance] saveLog:@"" action:@"视频加载成功或开始播放，多次调用，不必关心"];
|
|
|
|
表示视频加载成功或开始播放
|
|
|
|
2、升级Ruby环境，首先需要安装rvm（第一步要下载一些东西等两分钟左右）
|
|
|
|
|
|
|
|
3. PlayBackVC.m中添加了
|
|
|
|
[[SaveLogUtil sharedInstance] saveLog:@"" action:@"视频加载成功或开始播放，多次调用，不必关心"];
|
|
|
|
表示视频加载成功或开始播放
|
|
|
|
```
|
|
|
|
curl -L get.rvm.io | bash -s stable
|
|
|
|
source ~/.bashrc
|
|
|
|
source ~/.bash_profile
|
|
|
|
```
|
|
|
|
|
|
|
|
## 3.快速集成
|
|
|
|
3、查看rvm版本
|
|
|
|
|
|
|
|
首先，需要下载最新版本的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文件)
|
|
|
|
```
|
|
|
|
rvm -v
|
|
|
|
|
|
|
|
### 3.2 Demo
|
|
|
|
1. Demo-观看端有连麦实现了基本的播放，在线回放逻辑，可以直接运行
|
|
|
|
2. Demo-观看端无连麦实现了基本的播放，在线回放逻辑，可以直接运行，除无连麦外，功能同上
|
|
|
|
3. Demo-离线下载实现了基本的离线下载和离线回放逻辑，可以直接运行（其中的CCSDK用4，5两个工程中的任意一个CCSDK文件夹即可）
|
|
|
|
显示如下(或者是其他版本)
|
|
|
|
rvm 1.29.3 (latest) by Michal Papis, Piotr Kuczynski, Wayne E. Seguin [https://rvm.io]
|
|
|
|
```
|
|
|
|
|
|
|
|
### 3.3 配置依赖库
|
|
|
|
4、列出ruby可安装的版本信息
|
|
|
|
|
|
|
|
在项目/General/Linked framework and libraries 中不要忘记添加对用的依赖
|
|
|
|
```
|
|
|
|
rvm list known
|
|
|
|
|
|
|
|
**基础配置类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适配方式，含义见上面
|
|
|
|
```
|
|
|
|
显示如下
|
|
|
|
# MRI Rubies
|
|
|
|
[ruby-]1.8.6[-p420]
|
|
|
|
[ruby-]1.8.7[-head] # security released on head
|
|
|
|
[ruby-]1.9.1[-p431]
|
|
|
|
[ruby-]1.9.2[-p330]
|
|
|
|
[ruby-]1.9.3[-p551]
|
|
|
|
[ruby-]2.0.0[-p648]
|
|
|
|
[ruby-]2.1[.10]
|
|
|
|
[ruby-]2.2[.10]
|
|
|
|
[ruby-]2.3[.7]
|
|
|
|
[ruby-]2.4[.4]
|
|
|
|
[ruby-]2.5[.1] // 重点在这里 重点在这里 重点在这里
|
|
|
|
[ruby-]2.6[.0-preview2] // 测试版
|
|
|
|
ruby-head
|
|
|
|
.....
|
|
|
|
```
|
|
|
|
|
|
|
|
5、安装一个ruby版本
|
|
|
|
|
|
|
|
```
|
|
|
|
rvm install 2.5.1
|
|
|
|
// 注意:安装过程中需要两次按下 Enter 键, 第二次按下后需要输入电脑访问密码(不可见,只管输入就行);
|
|
|
|
// 如果你电脑没有安装Xcode和Command Line Tools for Xcode以及Homebrew 会自动下载安装,建议提前安装这三者.
|
|
|
|
|
|
|
|
|
|
|
|
这里很多小伙伴会遇到错误，大部分是因为没有安装Homebrew造成，所以所以所以要提前安装比较好
|
|
|
|
/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
|
|
|
|
```
|
|
|
|
|
|
|
|
6、设置为默认版本
|
|
|
|
|
|
|
|
```
|
|
|
|
rvm use 2.5.1 --default
|
|
|
|
```
|
|
|
|
|
|
|
|
7、更换源
|
|
|
|
|
|
|
|
```
|
|
|
|
sudo gem update --system
|
|
|
|
|
|
|
|
gem sources --remove https://rubygems.org/
|
|
|
|
|
|
|
|
gem sources --add https://gems.ruby-china.com/
|
|
|
|
```
|
|
|
|
|
|
|
|
8、为了验证你的Ruby镜像是并且仅是ruby-china，执行以下命令查看
|
|
|
|
|
|
|
|
```
|
|
|
|
gem sources -l
|
|
|
|
|
|
|
|
|
|
|
|
### 3.4 播放离线的文件
|
|
|
|
**下载的过程这里就不叙述了,请自行编写,如需要Demo里面有完整的下载代码**
|
|
|
|
首先导入头文件
|
|
|
|
如果是以下结果说明正确，如果有其他的请自行百度解决
|
|
|
|
*** CURRENT SOURCES ***
|
|
|
|
|
|
|
|
https://gems.ruby-china.com/
|
|
|
|
```
|
|
|
|
|
|
|
|
9、这时候才正式开始安装CocoaPods
|
|
|
|
|
|
|
|
```
|
|
|
|
sudo gem install -n /usr/local/bin cocoapods
|
|
|
|
```
|
|
|
|
|
|
|
|
10、如果安装了多个Xcode使用下面的命令选择（一般需要选择最近的Xcode版本）
|
|
|
|
|
|
|
|
```
|
|
|
|
sudo xcode-select -switch /Applications/Xcode.app/Contents/Developer
|
|
|
|
```
|
|
|
|
|
|
|
|
11、安装本地库
|
|
|
|
|
|
|
|
```
|
|
|
|
pod setup
|
|
|
|
```
|
|
|
|
|
|
|
|
12、执行以上命令后
|
|
|
|
|
|
|
|
```
|
|
|
|
Setting up CocoaPods master repo
|
|
|
|
$ /usr/bin/git clone https://github.com/CocoaPods/Specs.git master --progress
|
|
|
|
Cloning into 'master'...
|
|
|
|
remote: Counting objects: 1879515, done.
|
|
|
|
remote: Compressing objects: 100% (321/321), done.
|
|
|
|
Receiving objects: 21% (404525/1879515), 73.70 MiB | 22.00 KiB/
|
|
|
|
然后就是漫长的等待，当然,网络好的情况下会更快
|
|
|
|
```
|
|
|
|
|
|
|
|
2. 在Podfile文件中添加
|
|
|
|
|
|
|
|
```
|
|
|
|
如果是有连麦的SDK:
|
|
|
|
pod 'CCLivePlaySDK', '~> 3.8.0'
|
|
|
|
如果是无连麦的SDK:
|
|
|
|
pod 'CCLivePlaySDK', '~> 3.8.0', :podspec => 'https://raw.githubusercontent.com/CCVideo/Live_iOS_Play_SDK/master/CCLivePlaySDK.podspec'
|
|
|
|
```
|
|
|
|
|
|
|
|
3. 在终端中执行
|
|
|
|
|
|
|
|
```
|
|
|
|
pod install
|
|
|
|
```
|
|
|
|
|
|
|
|
**ps:目前CocoaPods集成仅支持3.8.0及以后的版本,旧版本暂不支持CocoaPods集成**
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
###2.2.2 手动集成
|
|
|
|
|
|
|
|
1.将SDK文件夹内的所有文件拖到项目中
|
|
|
|
|
|
|
|
```
|
|
|
|
#import "CCSDK/OfflinePlayBack.h"
|
|
|
|
command + b 编译，如果报错" file '...xxx/IJKMediaFramework.framework/IJKMediaFramework' for architecture arm64 "
|
|
|
|
解决方案：
|
|
|
|
Targets -> Build Settings -> 搜索 "Enable Bitcode" 设置为 "NO"
|
|
|
|
```
|
|
|
|
配置参数
|
|
|
|
2.command + r 运行
|
|
|
|
|
|
|
|
```
|
|
|
|
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];//开始解析数据并播放视频
|
|
|
|
如果报错" dyld: Library not loaded: @rpath/XXX.framework "
|
|
|
|
解决方案：
|
|
|
|
Targets -> Build Phases ->
|
|
|
|
点击左上角 "+" 按钮 ->
|
|
|
|
选择 "New Copy Files Phase" ->
|
|
|
|
点击新添加的 Copy Files 前面的下拉箭头 ->
|
|
|
|
Destination 选择 "Frameworks" ->
|
|
|
|
点击当前目录下的 "+" 将SDK包含的.framework 包添加即可
|
|
|
|
```
|
|
|
|
实现代理方法
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
##2.3 日志存储
|
|
|
|
|
|
|
|
在AppDelegate.m文件导入头文件
|
|
|
|
|
|
|
|
```
|
|
|
|
#import "CCSDK/SaveLogUtil.h"
|
|
|
|
```
|
|
|
|
#pragma mark - OfflinePlayBackDelegate
|
|
|
|
**
|
|
|
|
* @brief 请求成功
|
|
|
|
*/
|
|
|
|
-(void)requestSucceed {
|
|
|
|
NSLog(@"请求成功！");
|
|
|
|
}
|
|
|
|
|
|
|
|
在启动方法中添加日志存储
|
|
|
|
|
|
|
|
```
|
|
|
|
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
|
|
|
|
/**
|
|
|
|
* @brief 登录请求失败
|
|
|
|
*/
|
|
|
|
-(void)requestFailed:(NSError *)error reason:(NSString *)reason {
|
|
|
|
NSString *message = nil;
|
|
|
|
if (reason == nil) {
|
|
|
|
message = [error localizedDescription];
|
|
|
|
} else {
|
|
|
|
message = reason;
|
|
|
|
}
|
|
|
|
* @brief 是否存储日志
|
|
|
|
*/
|
|
|
|
[[SaveLogUtil sharedInstance]isNeedToSaveLog:YES];
|
|
|
|
return YES;
|
|
|
|
}
|
|
|
|
```
|
|
|
|
## 4. OfflinePlayBack离线回放请求类介绍
|
|
|
|
|
|
|
|
### 4.1 在回放OfflinePlayBackVC.m中主要调用此类来和此SDK交互
|
|
|
|
## 2.4 错误码
|
|
|
|
|
|
|
|
服务错误类型
|
|
|
|
|
|
|
|
```
|
|
|
|
ERROR_SERVICE_TYPE
|
|
|
|
|
|
|
|
### 4.2 OfflinePlayBack中的成员变量
|
|
|
|
ERROR_ROOM_STATE = 1001 直播间状态不可用，可能没有开始推流
|
|
|
|
ERROR_USELESS_INFO = 1002 没有获取到有用的视频信息
|
|
|
|
ERROR_PASSWORD = 1003 密码错误
|
|
|
|
```
|
|
|
|
@property (weak,nonatomic) id<OfflinePlayBackDelegate> delegate;//代理
|
|
|
|
@property (retain, atomic) id<IJKMediaPlayback> ijkPlayer;//播放器
|
|
|
|
系统错误类型
|
|
|
|
|
|
|
|
```
|
|
|
|
ERROR_SYSTEM_TYPE
|
|
|
|
|
|
|
|
播放器倍速，直播和回放都可以用，一般只用于回放
|
|
|
|
ERROR_RETURNDATA = 1004 返回内容格式错误
|
|
|
|
ERROR_PARAMETER = 1005 直播间信息填写错误
|
|
|
|
ERROR_NETWORK = 1006 网络异常
|
|
|
|
ERROR_LOGINDATA = 1007 登录
|
|
|
|
ERROR_PLAYERURL = 1008 视频播放地址
|
|
|
|
ERROR_QUESTIONLIST = 1009 问卷列表
|
|
|
|
ERROR_STATISTICAL = 1010 问卷统计
|
|
|
|
ERROR_DOCLIST = 1011 文档列表
|
|
|
|
ERROR_HISTORY = 1012 历史信息
|
|
|
|
PRACTICE_LIST = 1013 随堂测试
|
|
|
|
PRACTICECOMMIT = 1014 提交随堂测试
|
|
|
|
PRACTICESTATIS = 1015 获取随堂测统计
|
|
|
|
PRACTICERANK = 1016 获取随堂测排名
|
|
|
|
ERROR_SOCKET = 1017 socket加载失败
|
|
|
|
ERROR_PUNCH = 1018 获取打卡信息失败
|
|
|
|
ERROR_PUNCHCOMMIT = 1019 获取打卡提交结果失败
|
|
|
|
ERROR_DRMURL = 1020 获取加密地址失败
|
|
|
|
```
|
|
|
|
|
|
|
|
ijkPlayer.playbackRate = 1.5; 设置播放器以1.5倍速播放，其他倍速同理，可快可慢
|
|
|
|
float speed = ijkPlayer.playbackRate; 获取当前播放器的播放速度，并赋值给speed变量
|
|
|
|
# 3.快速集成
|
|
|
|
|
|
|
|
### 4.3 OfflinePlayBack中的成员方法
|
|
|
|
##3.0解压方法
|
|
|
|
|
|
|
|
```
|
|
|
|
/**
|
|
|
|
* @brief 初始化
|
|
|
|
* @param parameter 配置参数信息
|
|
|
|
* 必填参数 docFrame;
|
|
|
|
* 必填参数 docParent;
|
|
|
|
* 必填参数 playerParent;
|
|
|
|
* 必填参数 playerFrame;
|
|
|
|
* 必填参数 scalingMode;
|
|
|
|
* 必填参数 destination;
|
|
|
|
* 必填参数 defaultColor;
|
|
|
|
* 必填参数 PPTScalingMode;
|
|
|
|
* 必填参数 pauseInBackGround;
|
|
|
|
*/
|
|
|
|
- (id)initWithParameter:(PlayParameter *)parameter;
|
|
|
|
* @brief 解压并解密(加密和非加密均能解压)
|
|
|
|
* @param dst 需要进行解压解密的文件.
|
|
|
|
* @param dir 解压后输出目录, =NULL则解压到当前目录.
|
|
|
|
* @return 0-成功
|
|
|
|
* errcode:
|
|
|
|
-1 -打开输入文件(dst)失败；
|
|
|
|
-2 -本地生成(dst)内部目录或文件失败,fopen或mkdir失败，检测是否有权限或者目录名是否正确;
|
|
|
|
-3 -获取压缩文件中具体文件信息(dst->file)失败;
|
|
|
|
-4 -获取全局信息(dst)失败;
|
|
|
|
-5 -打开或读取压缩文件的内部文件失败;
|
|
|
|
-6 -dst存在但并不是加密文件格式;
|
|
|
|
*/
|
|
|
|
- (int)DecompressZipWithDec:(NSString *)dst dir:(NSString *)dir;
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
## 3.1 配置参数
|
|
|
|
|
|
|
|
3.1.1 调用方法
|
|
|
|
|
|
|
|
```
|
|
|
|
/*
|
|
|
|
* @brief 开始解析数据并播放视频
|
|
|
|
*/
|
|
|
|
-(void)startPlayAndDecompress;
|
|
|
|
/**
|
|
|
|
* @brief 初始化
|
|
|
|
* @param parameter 配置参数信息
|
|
|
|
* 必填参数 docFrame; //文档区域
|
|
|
|
* 必填参数 docParent; //文档父类窗口
|
|
|
|
* 必填参数 playerParent; //视频父类窗口
|
|
|
|
* 必填参数 playerFrame; //视频区域
|
|
|
|
* 必填参数 scalingMode; //屏幕适配方式
|
|
|
|
* 必填参数 destination; //下载文件解压到的目录路径(离线下载相关)
|
|
|
|
* 必填参数 defaultColor; //ppt默认底色，不写默认为白色
|
|
|
|
* 必填参数 PPTScalingMode; //PPT适配方式 PPT适配模式分为四种，1.一种是全部填充屏幕，可拉伸变形，2.第二种是等比缩放，横向或竖向贴住边缘，另一方向可以留黑边，3.第三种是等比缩放，横向或竖向贴住边缘，另一方向出边界，裁剪PPT，不可以留黑边，4.根据直播间文档显示模式的返回值进行设置(推荐)(The New Method)
|
|
|
|
* 必填参数 pauseInBackGround; //后台是否继续播放，注意：如果开启后台播放需要打开 xcode->Capabilities->Background Modes->on->Audio,AirPlay,and Picture in Picture
|
|
|
|
*/
|
|
|
|
- (id)initWithParameter:(PlayParameter *)parameter;
|
|
|
|
```
|
|
|
|
|
|
|
|
代理方法
|
|
|
|
|
|
|
|
```
|
|
|
|
/**
|
|
|
|
* @brief 销毁文档和视频，清除视频和文档的时候需要调用,推出播放页面的时候也需要调用
|
|
|
|
*/
|
|
|
|
- (void)requestCancel;
|
|
|
|
* @brief 加载视频失败
|
|
|
|
*/
|
|
|
|
- (void)offline_loadVideoFail;
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
3.1.2 集成
|
|
|
|
|
|
|
|
导入头文件
|
|
|
|
|
|
|
|
```
|
|
|
|
/**
|
|
|
|
* @brief time：从直播开始到现在的秒数，SDK会在画板上绘画出来相应的图形
|
|
|
|
*/
|
|
|
|
- (void)continueFromTheTime:(NSInteger)time;
|
|
|
|
#import "CCSDK/OfflinePlayBack.h"//SDK
|
|
|
|
```
|
|
|
|
|
|
|
|
声明变量
|
|
|
|
|
|
|
|
```
|
|
|
|
/**
|
|
|
|
* @brief 获取文档区域内白板或者文档本身的宽高比，返回值即为宽高比，做屏幕适配用
|
|
|
|
*/
|
|
|
|
- (CGFloat)getDocAspectRatio;
|
|
|
|
@property (nonatomic,strong)OfflinePlayBack * offlinePlayBack;//sdk
|
|
|
|
```
|
|
|
|
|
|
|
|
配置参数:PlayParameter的属性如下
|
|
|
|
|
|
|
|
```
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @brief 改变文档区域大小,主要用在文档生成后改变文档窗口的frame
|
|
|
|
*/
|
|
|
|
- (void)changeDocFrame:(CGRect) docFrame;
|
|
|
|
* @brief 文档父类窗口
|
|
|
|
*/
|
|
|
|
@property(nonatomic,strong)UIView *docParent;//文档父类窗口
|
|
|
|
/**
|
|
|
|
* @brief 文档区域
|
|
|
|
*/
|
|
|
|
@property(nonatomic,assign)CGRect docFrame;//文档区域
|
|
|
|
/**
|
|
|
|
* @brief 视频父类窗口
|
|
|
|
*/
|
|
|
|
@property(nonatomic,strong)UIView *playerParent;//视频父类窗口
|
|
|
|
/**
|
|
|
|
* @brief 视频区域
|
|
|
|
*/
|
|
|
|
@property(nonatomic,assign)CGRect playerFrame;//视频区域
|
|
|
|
/**
|
|
|
|
* @brief
|
|
|
|
* 0:IJKMPMovieScalingModeNone
|
|
|
|
* 1:IJKMPMovieScalingModeAspectFit
|
|
|
|
* 2:IJKMPMovieScalingModeAspectFill
|
|
|
|
* 3:IJKMPMovieScalingModeFill
|
|
|
|
*/
|
|
|
|
@property(assign, nonatomic)NSInteger scalingMode;//屏幕适配方式，含义见上面
|
|
|
|
/**
|
|
|
|
* @brief ppt默认底色，不写默认为白色
|
|
|
|
*/
|
|
|
|
@property(nonatomic,strong)UIColor *defaultColor;//ppt默认底色，不写默认为白色
|
|
|
|
/**
|
|
|
|
* @brief /后台是否继续播放，注意：如果开启后台播放需要打开 xcode->Capabilities->Background Modes->on->Audio,AirPlay,and Picture in Picture
|
|
|
|
*/
|
|
|
|
@property(nonatomic,assign)BOOL pauseInBackGround;//后台是否继续播放，注意：如果开启后台播放需要打开 xcode->Capabilities->Background Modes->on->Audio,AirPlay,and Picture in Picture
|
|
|
|
/**
|
|
|
|
* @brief PPT适配模式分为四种，
|
|
|
|
* 1.一种是全部填充屏幕，可拉伸变形，
|
|
|
|
* 2.第二种是等比缩放，横向或竖向贴住边缘，另一方向可以留黑边，
|
|
|
|
* 3.第三种是等比缩放，横向或竖向贴住边缘，另一方向出边界，裁剪PPT，不可以留黑边
|
|
|
|
* 4.根据直播间文档显示模式的返回值进行设置(推荐)
|
|
|
|
*/
|
|
|
|
@property(assign, nonatomic)NSInteger PPTScalingMode;//PPT适配方式，含义见上面
|
|
|
|
/**
|
|
|
|
* @brief PPT是否允许滚动
|
|
|
|
*/
|
|
|
|
@property(nonatomic, assign)BOOL pptInteractionEnabled;
|
|
|
|
/**
|
|
|
|
* @brief 下载文件解压到的目录路径(离线下载相关)
|
|
|
|
*/
|
|
|
|
@property(nonatomic, copy)NSString *destination;//下载文件解压到的目录路径(离线下载相关)
|
|
|
|
|
|
|
|
```
|
|
|
|
|
|
|
|
开始配置
|
|
|
|
|
|
|
|
```
|
|
|
|
/**
|
|
|
|
* @brief 改变播放器frame
|
|
|
|
*/
|
|
|
|
- (void)changePlayerFrame:(CGRect) playerFrame;
|
|
|
|
第一步:实例化参数类
|
|
|
|
PlayParameter *parameter = [[PlayParameter alloc] init];
|
|
|
|
//配置PlayParameter里面的属性,如userId,roomId等!
|
|
|
|
第二步实例化RequestData类
|
|
|
|
_offlinePlayBack = [[OfflinePlayBack alloc] initWithParameter:parameter];
|
|
|
|
_offlinePlayBack.delegate = self;
|
|
|
|
第三步添加代理
|
|
|
|
_offlinePlayBack.delegate = self;
|
|
|
|
第四步开始播放
|
|
|
|
[_offlinePlayBack startPlayAndDecompress];
|
|
|
|
|
|
|
|
```
|
|
|
|
|
|
|
|
添加代理
|
|
|
|
|
|
|
|
```
|
|
|
|
/**
|
|
|
|
* @brief 改变播放器父窗口
|
|
|
|
*/
|
|
|
|
- (void)changePlayerParent:(UIView *) playerParent;
|
|
|
|
@interface 您的控制器 ()<OfflinePlayBackDelegate>
|
|
|
|
```
|
|
|
|
|
|
|
|
实现代理
|
|
|
|
|
|
|
|
```
|
|
|
|
/**
|
|
|
|
* @brief 改变文档父窗口
|
|
|
|
*/
|
|
|
|
- (void)changeDocParent:(UIView *) docParent;
|
|
|
|
* @brief 加载视频失败
|
|
|
|
*/
|
|
|
|
- (void)offline_loadVideoFail;
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
**至此您的项目已经可以运行了,并且已经集成好了视频基本功能;如果不需要文档功能则不配置文档相关属性即可,另外添加文档功能写一个定时器在视频开始播放时调用下面的方法即可**
|
|
|
|
|
|
|
|
```
|
|
|
|
/**
|
|
|
|
* @brief 播放器暂停
|
|
|
|
*/
|
|
|
|
- (void)pausePlayer;
|
|
|
|
* @brief time：从直播开始到现在的秒数，SDK会在画板上绘画出来相应的图形
|
|
|
|
*/
|
|
|
|
- (void)continueFromTheTime:(NSInteger)time;
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
## 3.2 观看离线回放
|
|
|
|
|
|
|
|
3.2.1 代理方法(可选)
|
|
|
|
|
|
|
|
```
|
|
|
|
/**
|
|
|
|
* @brief 播放器播放
|
|
|
|
*/
|
|
|
|
- (void)startPlayer;
|
|
|
|
* @brief 加载视频失败
|
|
|
|
*/
|
|
|
|
- (void)offline_loadVideoFail;
|
|
|
|
/**
|
|
|
|
* @brief 回放的开始时间和结束时间
|
|
|
|
* @param dic {endTime //结束时间
|
|
|
|
startTime //开始时间 }
|
|
|
|
*/
|
|
|
|
-(void)liveInfo:(NSDictionary *)dic;
|
|
|
|
```
|
|
|
|
|
|
|
|
3.2.2 主动方法(可选)
|
|
|
|
|
|
|
|
```
|
|
|
|
/**
|
|
|
|
* @brief 播放器关闭并移除
|
|
|
|
*/
|
|
|
|
* @brief 开始解析数据并播放视频
|
|
|
|
*/
|
|
|
|
-(void)startPlayAndDecompress;
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @brief 销毁文档和视频，清除视频和文档的时候需要调用,推出播放页面的时候也需要调用
|
|
|
|
*/
|
|
|
|
- (void)requestCancel;
|
|
|
|
/**
|
|
|
|
* @brief time：从直播开始到现在的秒数，SDK会在画板上绘画出来相应的图形
|
|
|
|
*/
|
|
|
|
- (void)continueFromTheTime:(NSInteger)time;
|
|
|
|
/**
|
|
|
|
* @brief 改变播放器frame
|
|
|
|
*/
|
|
|
|
- (void)changePlayerFrame:(CGRect) playerFrame;
|
|
|
|
/**
|
|
|
|
* @brief 改变播放器父窗口
|
|
|
|
*/
|
|
|
|
- (void)changePlayerParent:(UIView *) playerParent;
|
|
|
|
/**
|
|
|
|
* @brief 播放器暂停
|
|
|
|
*/
|
|
|
|
- (void)pausePlayer;
|
|
|
|
/**
|
|
|
|
* @brief 播放器播放
|
|
|
|
*/
|
|
|
|
- (void)startPlayer;
|
|
|
|
/**
|
|
|
|
* @brief 播放器关闭并移除
|
|
|
|
*/
|
|
|
|
- (void)shutdownPlayer;
|
|
|
|
```
|
|
|
|
```
|
|
|
|
/**
|
|
|
|
* @brief 播放器停止
|
|
|
|
*/
|
|
|
|
* @brief 播放器停止
|
|
|
|
*/
|
|
|
|
- (void)stopPlayer;
|
|
|
|
```
|
|
|
|
```
|
|
|
|
/**
|
|
|
|
* @brief 从头播放
|
|
|
|
*/
|
|
|
|
* @brief 从头播放
|
|
|
|
*/
|
|
|
|
- (void)replayPlayer;
|
|
|
|
```
|
|
|
|
```
|
|
|
|
/**
|
|
|
|
* @brief 播放器是否播放
|
|
|
|
*/
|
|
|
|
* @brief 播放器是否播放
|
|
|
|
*/
|
|
|
|
- (BOOL)isPlaying;
|
|
|
|
```
|
|
|
|
```
|
|
|
|
/*
|
|
|
|
* @brief 播放器当前播放时间
|
|
|
|
*/
|
|
|
|
/**
|
|
|
|
* @brief 播放器当前播放时间
|
|
|
|
*/
|
|
|
|
- (NSTimeInterval)currentPlaybackTime;
|
|
|
|
/**
|
|
|
|
* @brief 设置播放器当前播放时间（用于拖拽进度条时掉用的）
|
|
|
|
*/
|
|
|
|
- (void)setCurrentPlaybackTime:(NSTimeInterval)time;
|
|
|
|
/**
|
|
|
|
* @brief 回放视频总时长
|
|
|
|
*/
|
|
|
|
- (NSTimeInterval)playerDuration;
|
|
|
|
/**
|
|
|
|
* @brief 设置后台是否可播放
|
|
|
|
*/
|
|
|
|
- (void)setpauseInBackGround:(BOOL)pauseInBackGround;
|
|
|
|
```
|
|
|
|
|
|
|
|
## 3.3 文档功能
|
|
|
|
|
|
|
|
3.3.1 代理方法(可选)
|
|
|
|
|
|
|
|
```
|
|
|
|
/*
|
|
|
|
* @brief 设置播放器当前播放时间（用于拖拽进度条时掉用的）
|
|
|
|
*/
|
|
|
|
- (void)setCurrentPlaybackTime:(NSTimeInterval)time;
|
|
|
|
/**
|
|
|
|
* @brief 获取文档内白板或者文档本身的宽高，来进行屏幕适配用的
|
|
|
|
*/
|
|
|
|
- (void)offline_getDocAspectRatioOfWidth:(CGFloat)width height:(CGFloat)height;
|
|
|
|
/**
|
|
|
|
* @brief 获取ppt当前页数和总页数(The new method)
|
|
|
|
*
|
|
|
|
* 回调当前翻页的页数信息
|
|
|
|
* 白板docTotalPage一直为0, pageNum从1开始
|
|
|
|
* 其他文档docTotalPage为正常页数,pageNum从0开始
|
|
|
|
* @param dictionary 翻页信息
|
|
|
|
* dictionary :{docId 文档ID
|
|
|
|
* docName 文档名
|
|
|
|
* docTotalPage 文档总页数
|
|
|
|
* pageNum 文档页码}
|
|
|
|
*/
|
|
|
|
- (void)onPageChange:(NSDictionary *) dictionary;
|
|
|
|
/**
|
|
|
|
* @brief 回放翻页数据列表
|
|
|
|
* @param array[{ docName //文档名
|
|
|
|
pageTitle //页标题
|
|
|
|
time //时间
|
|
|
|
url //地址 }]
|
|
|
|
*/
|
|
|
|
- (void)pageChangeList:(NSMutableArray *)array;
|
|
|
|
/**
|
|
|
|
* @brief 文档加载状态(The new method)
|
|
|
|
* index
|
|
|
|
* 2 非动画文档加载完成
|
|
|
|
*/
|
|
|
|
- (void)docLoadCompleteWithIndex:(NSInteger)index;
|
|
|
|
```
|
|
|
|
|
|
|
|
3.3.2 主动方法(可选)
|
|
|
|
|
|
|
|
```
|
|
|
|
/*
|
|
|
|
* @brief 回放视频总时长
|
|
|
|
*/
|
|
|
|
- (NSTimeInterval)playerDuration;
|
|
|
|
/**
|
|
|
|
* @brief time：从直播开始到现在的秒数，SDK会在画板上绘画出来相应的图形
|
|
|
|
*/
|
|
|
|
- (void)continueFromTheTime:(NSInteger)time;
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @brief 获取文档区域内白板或者文档本身的宽高比，返回值即为宽高比，做屏幕适配用
|
|
|
|
*/
|
|
|
|
- (CGFloat)getDocAspectRatio;
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @brief 改变文档区域大小,主要用在文档生成后改变文档窗口的frame
|
|
|
|
*/
|
|
|
|
- (void)changeDocFrame:(CGRect) docFrame;
|
|
|
|
/**
|
|
|
|
* @brief 改变文档父窗口
|
|
|
|
*/
|
|
|
|
- (void)changeDocParent:(UIView *) docParent;
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
##3.4 房间信息
|
|
|
|
|
|
|
|
代理方法(可选)
|
|
|
|
|
|
|
|
```
|
|
|
|
/**
|
|
|
|
* @brief 设置后台是否可播放
|
|
|
|
*/
|
|
|
|
- (void)setpauseInBackGround:(BOOL)pauseInBackGround;
|
|
|
|
* @brief 获取房间信息，主要是要获取直播间模版来类型，根据直播间模版类型来确定界面布局
|
|
|
|
* 房间简介：dic[@"desc"];
|
|
|
|
* 房间名称：dic[@"name"];
|
|
|
|
* 房间模版类型：[dic[@"templateType"] integerValue];
|
|
|
|
* 模版类型为1: 聊天互动： 无 直播文档： 无 直播问答： 无
|
|
|
|
* 模版类型为2: 聊天互动： 有 直播文档： 无 直播问答： 有
|
|
|
|
* 模版类型为3: 聊天互动： 有 直播文档： 无 直播问答： 无
|
|
|
|
* 模版类型为4: 聊天互动： 有 直播文档： 有 直播问答： 无
|
|
|
|
* 模版类型为5: 聊天互动： 有 直播文档： 有 直播问答： 有
|
|
|
|
* 模版类型为6: 聊天互动： 无 直播文档： 无 直播问答： 有
|
|
|
|
*/
|
|
|
|
-(void)offline_roomInfo:(NSDictionary *)dic;
|
|
|
|
```
|
|
|
|
|
|
|
|
### 4.4事件监听
|
|
|
|
事件监听只需要实现对应的代理方法即可
|
|
|
|
#### 4.4.1 获取文档内白板或者文档本身的宽高
|
|
|
|
##3.5 聊天功能
|
|
|
|
|
|
|
|
代理方法(可选)
|
|
|
|
|
|
|
|
```
|
|
|
|
/**
|
|
|
|
* @brief 获取文档内白板或者文档本身的宽高，来进行屏幕适配用的
|
|
|
|
*/
|
|
|
|
- (void)offline_getDocAspectRatioOfWidth:(CGFloat)width height:(CGFloat)height;
|
|
|
|
* @brief 解析本房间的历史聊天数据
|
|
|
|
* @param chatArr [{ chatId //聊天ID
|
|
|
|
content //聊天内容
|
|
|
|
groupId //聊天组ID
|
|
|
|
time //时间
|
|
|
|
userId //用户ID
|
|
|
|
userName //用户名
|
|
|
|
userRole //用户角色}]
|
|
|
|
*/
|
|
|
|
-(void)offline_onParserChat:(NSArray *)arr;
|
|
|
|
```
|
|
|
|
#### 4.4.2 历史提问&回答
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
## 3.6 问答功能
|
|
|
|
|
|
|
|
代理方法(可选)
|
|
|
|
|
|
|
|
```
|
|
|
|
/**
|
|
|
|
* @brief 收到本房间的历史提问&回答
|
|
|
|
*/
|
|
|
|
* @brief 收到历史提问&回答
|
|
|
|
* @param questionArr [{content //问答内容
|
|
|
|
encryptId //加密ID
|
|
|
|
groupId //分组ID
|
|
|
|
isPublish //1 发布的问答 0 未发布的问答
|
|
|
|
questionUserId //问答用户ID
|
|
|
|
questionUserName //问答用户名
|
|
|
|
time //问答时间
|
|
|
|
triggerTime //问答具体时间}]
|
|
|
|
* @param answerArr [{answerUserId //回复用户ID
|
|
|
|
answerUserName //回复名
|
|
|
|
answerUserRole //回复角色（主讲、助教）
|
|
|
|
content //回复内容
|
|
|
|
encryptId //加密ID
|
|
|
|
groupId //分组ID
|
|
|
|
isPrivate //1 私聊回复 0 公共回复
|
|
|
|
time = 135; //回复时间
|
|
|
|
triggerTime //回复具体时间}]
|
|
|
|
*/
|
|
|
|
- (void)offline_onParserQuestionArr:(NSArray *)questionArr onParserAnswerArr:(NSArray *)answerArr;
|
|
|
|
```
|
|
|
|
#### 4.4.3 历史聊天数据
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
## 3.7 广播功能
|
|
|
|
|
|
|
|
代理方法(可选)
|
|
|
|
|
|
|
|
```
|
|
|
|
/**
|
|
|
|
* @brief 解析本房间的历史聊天数据
|
|
|
|
*/
|
|
|
|
-(void)offline_onParserChat:(NSArray *)arr;
|
|
|
|
* @brief 收到本房间历史广播(The new method)
|
|
|
|
* content 广播内容
|
|
|
|
* time 发布时间(单位:秒)
|
|
|
|
*/
|
|
|
|
- (void)broadcastHistory_msg:(NSArray *)array;
|
|
|
|
```
|
|
|
|
#### 4.4.4 获取房间信息
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
#4.常见问题
|
|
|
|
|
|
|
|
##4.1 旋转屏错误
|
|
|
|
|
|
|
|
常用的旋转屏方式
|
|
|
|
|
|
|
|
第一个方法决定是否支持多方向旋转屏，如果返回NO则后面的两个方法都不会再被调用，而且只会支持默认的UIInterfaceOrientationMaskPortrait方向；
|
|
|
|
|
|
|
|
第二个方法直接返回支持的旋转方向，该方法在iPad上的默认返回值是UIInterfaceOrientationMaskAll，iPhone上的默认返回值是UIInterfaceOrientationMaskAllButUpsideDown，官方文档有说明
|
|
|
|
|
|
|
|
第三个方法返回最优先显示的屏幕方向，比如同时支持Portrait和Landscape方向，但想优先显示Landscape方向，那软件启动的时候就会先显示Landscape，在手机切换旋转方向的时候仍然可以在Portrait和Landscape之间切换
|
|
|
|
|
|
|
|
HD云直播的页面跳转均是采用模态形式跳转
|
|
|
|
|
|
|
|
```
|
|
|
|
/**
|
|
|
|
* @brief 获取房间信息，主要是要获取直播间模版来类型，根据直播间模版类型来确定界面布局
|
|
|
|
* 房间简介：dic[@"desc"];
|
|
|
|
* 房间名称：dic[@"name"];
|
|
|
|
* 房间模版类型：[dic[@"templateType"] integerValue];
|
|
|
|
* 模版类型为1: 聊天互动： 无 直播文档： 无 直播问答： 无
|
|
|
|
* 模版类型为2: 聊天互动： 有 直播文档： 无 直播问答： 有
|
|
|
|
* 模版类型为3: 聊天互动： 有 直播文档： 无 直播问答： 无
|
|
|
|
* 模版类型为4: 聊天互动： 有 直播文档： 有 直播问答： 无
|
|
|
|
* 模版类型为5: 聊天互动： 有 直播文档： 有 直播问答： 有
|
|
|
|
* 模版类型为6: 聊天互动： 无 直播文档： 无 直播问答： 有
|
|
|
|
*/
|
|
|
|
-(void)offline_roomInfo:(NSDictionary *)dic;
|
|
|
|
- (void)presentViewController:(UIViewController *)viewControllerToPresent animated: (BOOL)flag completion:(void (^ __nullable)(void))completion NS_AVAILABLE_IOS(5_0);
|
|
|
|
```
|
|
|
|
#### 4.4.5 加载视频失败
|
|
|
|
|
|
|
|
在每个控制器或者基类控制器设置旋转选项
|
|
|
|
|
|
|
|
```
|
|
|
|
/*
|
|
|
|
* 加载视频失败
|
|
|
|
*/
|
|
|
|
- (void)offline_loadVideoFail;
|
|
|
|
#pragma mark - 屏幕旋转
|
|
|
|
- (BOOL)shouldAutorotate{
|
|
|
|
return NO;//该旋转的页面自己变量控制
|
|
|
|
}
|
|
|
|
|
|
|
|
- (UIInterfaceOrientation)preferredInterfaceOrientationForPresentation
|
|
|
|
{
|
|
|
|
return UIInterfaceOrientationPortrait;
|
|
|
|
}
|
|
|
|
|
|
|
|
- (UIInterfaceOrientationMask)supportedInterfaceOrientations
|
|
|
|
{
|
|
|
|
return UIInterfaceOrientationMaskPortrait;
|
|
|
|
}
|
|
|
|
```
|
|
|
|
#### 4.4.6 回放翻页数据列表
|
|
|
|
|
|
|
|
## 4.2 Swift实现代理错误
|
|
|
|
|
|
|
|
```
|
|
|
|
/*
|
|
|
|
* 回放翻页数据列表
|
|
|
|
//初始化
|
|
|
|
let parameter = PlayParameter.init()
|
|
|
|
/**
|
|
|
|
*配置各种参数
|
|
|
|
*/
|
|
|
|
- (void)pageChangeList:(NSMutableArray *)array;
|
|
|
|
//守护代理
|
|
|
|
guard let player = offlinePlayBack else {
|
|
|
|
return}
|
|
|
|
player.delegate = self
|
|
|
|
```
|
|
|
|
|
|
|
|
### 4.5.事件监听
|
|
|
|
#### 4.5.1添加播放器监听事件（监听播放状态改变）
|
|
|
|
## 4.3 查看手机日志
|
|
|
|
|
|
|
|
首先: 在AppDelegate中写如下代码(仅限CCSDK);
|
|
|
|
|
|
|
|
```
|
|
|
|
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 视频播放完成(有可能是加载失败，也有可能是播放结束)
|
|
|
|
[[SaveLogUtil sharedInstance]isNeedToSaveLog:YES];
|
|
|
|
```
|
|
|
|
|
|
|
|
## 5.API查询
|
|
|
|
第一步:选择Windows下面的Devices and Simulators
|
|
|
|
|
|
|
|
Doc目录打开index.html文件
|
|
|
|
第二步:点击Devices and Simulators 会出现手机信息以及测试的INSTALLED APPS, 点击设置(齿轮图标) 会出现三个选项, 选择Download Container...
|
|
|
|
|
|
|
|
## 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 两处即可
|
|
|
|
第三步: 点击Download Container... 下载并保存日志文件,打开文件找到XXLog文件里面就是相关的打印日志
|
|
|
|
|
|
|
|
第四步:这里可以看到相关的请求信息和打印日志, 也可以判断错误原因 |
