iOS 直播观看SDK开发指南

This is an old version of this page. You can view the most recent version or browse the history.

1.概述

Live_iOS_Play_SDK 是一个适用于iOS平台的直播SDK，使用此SDK可以与CC视频云服务进行对接，在iOS端使用CC视频的直播功能,本SDK只针对iOS手机播放端。

1.1 功能特性

功能	描述
直播视频	观看直播视频
文档展示	能够观看当前直播文档
线路更换	观看卡顿请换个线路
清晰度	支持直播多清晰度切换播放
答题卡	支持实时检测课堂学生的掌握程度
问答	能够发送问题和接受回答信息
简介	支持对直播间的信息展示
问卷	支持对观看直播的人进行信息采集
广播	支持发送全体消息
连麦	支持与直播人员进行音视频沟通
签到	支持签到功能
抽奖	支持抽奖功能
投票	支持投票功能

1.2 阅读对象

本文档为技术文档，需要阅读者：

具备基本的iOS开发能力
准备接入CC视频的直播SDK相关功能
对CC云直播产品使用方法有基础的了解，使用帮助地址

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 集成前需要知道的事情:

工程分三个部分：一个有连麦功能（Demo-观看端有连麦），体积较大，一个无连麦功能（Demo-观看端无连麦），体积较小，第三个部分是离线下载回放（Demo-离线下载），其中离线下载回放中的CCSDK用有连麦的库和无连麦的库都可以，示例中用的无连麦的库(体积较小)
（重要）本SDK只支持真机，不支持模拟器
（重要）本SDK只支持iOS8.0及以上版本，iOS7.x版本不支持
(重要) 当使用有连麦工程时，分为音视频连麦和音频连麦两种连麦，有连麦的demo中没有以页面体现两种连麦的按钮，当选中简介时，连麦为音视频连麦，当选中文档，聊天或问答任意一个时，连麦为音频连麦，代码使中用_isAudioVideo加以区分，当_isAudioVideo==YES;时为音视频连麦，当_isAudioVideo==NO;时为音频连麦

3.1 导入framework

三个工程SDK目录都在工程目录下的CCSDK文件夹中，文件夹中的所有文件都属于SDK部分，应全部应用(注意不要遗漏socketio.html文件)

3.2 Demo

Demo-观看端有连麦实现了基本的播放，在线回放逻辑，可以直接运行
Demo-观看端无连麦实现了基本的播放，在线回放逻辑，可以直接运行，除无连麦外，功能同上
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，不可以留黑边
* 4.根据直播间文档显示模式的返回值进行设置(推荐)(The New Method)
*/
@property(assign, nonatomic)NSInteger                   PPTScalingMode;//PPT适配方式，含义见上面
/**
* json格式字符串，可选，自定义用户信息，该信息会记录在用户访问记录中，用于统计分析使用（长度不能超过1000个字符，若直播间启用接口验证则该参数无效）如果不需要的话就不要传值
* 格式如下：
* viewercustominfo: '{"exportInfos": [ {"key": "城市", "value": "北京"}, {"key": "姓名", "value": "哈哈"}]}'
*/
@property(nonatomic, copy)NSString                      *viewercustominfo;

3.4 登录直播间

可以登录也可以不登录,本文档是按照需要登录设计的,如不需登录请跳过3.4 (1). 首先导入头文件

#import "CCSDK/CCLiveUtil.h"
#import "CCSDK/RequestData.h"

(2). 配置参数

PlayParameter *parameter = [[PlayParameter alloc] init];
parameter.userId = @"用户ID";
parameter.roomId = @"房间ID";
parameter.viewerName = @"用户名称";
parameter.token = @"房间密码";
parameter.security = @"是否使用https，静态库暂时只能使用http协议";
parameter.viewerCustomua = @"viewercustomua";
RequestData *requestData = [[RequestData alloc] initLoginWithParameter:parameter];
requestData.delegate = self;//需要实现RequestDataDelegate代理方法

(3). 实现代理方法

#pragma mark - RequestDataDelegate
//@optional
/**
*    @brief    请求成功
*/
-(void)loginSucceedPlayBack {
控制器跳转
}

/**
*    @brief    登录请求失败
*/
-(void)loginFailed:(NSError *)error reason:(NSString *)reason {
NSString *message = nil;
if (reason == nil) {
message = [error localizedDescription];
} else {
message = reason;
}
}

3.5 开启观看视频直播

跳转到直播页面配置观看直播同样需要导入头文件

#import "CCSDK/CCLiveUtil.h"
#import "CCSDK/RequestData.h"

配置参数,和登录时配置的参数差不多,很多参数都是登录传过来的

PlayParameter *parameter = [[PlayParameter alloc] init];
parameter.userId = @"登录传过来的";
parameter.roomId = @"登录传过来的";
parameter.viewerName = @"用户名称";
parameter.token = @"房间密码";
parameter.playerParent = self.videoView;//视频父类窗口
parameter.playerFrame = _videoRect//视频区域;
parameter.security = NO;
parameter.PPTScalingMode = 2;
parameter.defaultColor = [UIColor whiteColor];
parameter.scalingMode = 1;
parameter.pauseInBackGround = NO;
parameter.viewerCustomua = @"viewercustomua";
_requestData = [[RequestData alloc] initWithParameter:parameter];

3.6 文档观看

PlayParameter增加两个属性

@property(nonatomic,strong)UIView                       *docParent;//文档父类窗口
@property(nonatomic,assign)CGRect                       docFrame;//文档区域

4. 功能使用

4.1 RequestData直播请求类介绍

4.1.1 在直播类PlayViewController.m文件中主要调用此类来和此SDK交互

4.1.2 RequestData中的成员变量

@property (weak,nonatomic) id<RequestDataDelegate>      delegate;//代理
@property (retain,    atomic) id<IJKMediaPlayback>      ijkPlayer;//播放器

4.1.3 RequestData中的成员方法

(1). 初始化登录

/**
*    @brief    登录房间
*    @param     parameter   配置参数信息
*  必填参数 userId;
*  必填参数 roomId;
*  必填参数 viewerName;
*  必填参数 token;
*  必填参数 security;
*  （选填参数） viewercustomua;
*/
- (id)initLoginWithParameter:(PlayParameter *)parameter;

(2). 进入房间

/**
*    @brief    进入房间，并请求画图聊天数据并播放视频（可以不登陆，直接从此接口进入直播间）
*    @param     parameter   配置参数信息
*  必填参数 userId;
*  必填参数 roomId;
*  必填参数 viewerName;
*  必填参数 token;
*  必填参数 docParent;
*  必填参数 docFrame;
*  必填参数 playerParent;
*  必填参数 playerFrame;
*  必填参数 PPTScalingMode;
*  必填参数 security;
*  必填参数 defaultColor;
*  必填参数 scalingMode;
*  必填参数 pauseInBackGround;
*  （选填参数） viewercustomua;
*/
- (id)initWithParameter:(PlayParameter *)parameter;

(3). 提问

/**
*    @brief    提问
*    @param     message 提问内容
*/
- (void)question:(NSString *)message;

(4). 发送公聊

/**
*    @brief    发送公聊信息
*    @param     message  发送的消息内容
*/
- (void)chatMessage:(NSString *)message;

(5). 发送私聊

/**
*    @brief  发送私聊信息
*/
- (void)privateChatWithTouserid:(NSString *)touserid msg:(NSString *)msg;

(6). 退出播放时销毁文档和视频

/**
*    @brief    销毁文档和视频，清除视频和文档的时候需要调用,推出播放页面的时候也需要调用
*/
- (void)requestCancel;

(7). 房间人数

/**
*    @brief  获取在线房间人数，当登录成功后即可调用此接口，登录不成功或者退出登录后就不可以调用了，如果要求实时性比较强的话，可以写一个定时器，不断调用此接口，几秒钟发一次就可以，然后在代理回调函数中，处理返回的数据
*/
- (void)roomUserCount;

(8). 文档宽高比

/**
*    @brief  获取文档区域内白板或者文档本身的宽高比，返回值即为宽高比，做屏幕适配用
*/
- (CGFloat)getDocAspectRatio;

(9). 改变文档区域大小

/**
*    @brief  改变文档区域大小,主要用在文档生成后改变文档窗口的frame
*/
- (void)changeDocFrame:(CGRect) docFrame;

(10). 改变播放器frame

/**
*    @brief  改变播放器frame
*/
- (void)changePlayerFrame:(CGRect) playerFrame;

(11). 改变播放器父窗口

/**
*    @brief  改变播放器父窗口
*/
- (void)changePlayerParent:(UIView *) playerParent;

(12). 改变文档父窗口

/**
*    @brief  改变文档父窗口
*/
- (void)changeDocParent:(UIView *) docParent;

(13). 播放器暂停

/**
*    @brief  播放器暂停
*/
- (void)pausePlayer;

(14). 播放器播放

/**
*    @brief  播放器播放
*/
- (void)startPlayer;

(15). 播放器关闭并移除

/**
*    @brief  播放器关闭并移除
*/
- (void)shutdownPlayer;

(16). 播放器停止

/**
*    @brief  播放器停止
*/
- (void)stopPlayer;

(17). 切换播放线路

/**
*    @brief   切换播放线路
*  firIndex表示第几个源
*  key表示该源对应的描述信息
*/
- (void)switchToPlayUrlWithFirIndex:(NSInteger)firIndex key:(NSString *)key;

(18). 重新加载视频

/*
* 重新加载视频,参数force表示是否强制重新加载视频，
* 一般重新加载视频的时间间隔应该超过3秒，如果强制重新加载视频，时间间隔可以在3S之内
*/
-(void)reloadVideo:(BOOL)force;

(19). 签到

/*
*签到
*/
-(void)answer_rollcall;

(20). 答单选题

/*
*答单选题
*/
-(void)reply_vote_single:(NSInteger)index;

(21). 答多选题

/*
*答多选题
*/
-(void)reply_vote_multiple:(NSMutableArray *)indexArray;

(22). 播放器是否播放

/**
*    @brief  播放器是否播放
*/
- (BOOL)isPlaying;

(23). 设置后台是否可播放

/**
*    @brief  设置后台是否可播放
*/
- (void)setpauseInBackGround:(BOOL)pauseInBackGround;

(24). 提交问卷结果

/*
*  @brief 提交问卷结果
*/
-(void)commitQuestionnaire:(NSDictionary *)dic;

(25). 修改昵称

/**
*    @brief     修改昵称(The new method)
*    @param     nickName  修改后的昵称
*/
- (void)changeNickName:(NSString *)nickName;

(26). 连麦相关方法

/*(连麦相关方法)
* 当收到- (void)acceptSpeak:(NSDictionary *)dict;回调方法后，调用此方法
* dict 正是- (void)acceptSpeak:(NSDictionary *)dict;接收到的的参数
* remoteView 是远程连麦页面的view，需要自己设置并发给SDK，SDK将要在这个view上进行远程画面渲染
*/
- (void)saveUserInfo:(NSDictionary *)dict remoteView:(UIView *)remoteView;

/*(连麦相关方法)
* 观看端主动断开连麦时候需要调用的接口
*/
- (void)disConnectSpeak;

/*(连麦相关方法)
* 当观看端主动申请连麦时，需要调用这个接口，并把本地连麦预览窗口传给SDK，SDK会在这个view上
* 进行远程画面渲染
*/
-(void)requestAVMessageWithLocalView:(UIView *)localView;

/*(连麦相关方法)
*设置本地预览窗口的大小，连麦成功后调用才生效，连麦不成功调用不生效
*/
-(void)setLocalVideoFrameA:(CGRect)localVideoFrame;

/*(连麦相关方法)
*设置远程连麦窗口的大小，连麦成功后调用才生效，连麦不成功调用不生效
*/
-(void)setRemoteVideoFrameA:(CGRect)remoteVideoFrame;

/*(连麦相关方法)
*将要连接WebRTC
*/
-(void)gotoConnectWebRTC;

连麦方法调用顺序

（1）-(void)gotoConnectWebRTC; //申请视频连麦

（2）回调- (void)whetherOrNotConnectWebRTCNow:(BOOL)connect;//现在情况下是否可以连麦

（3）-(void)requestAVMessageWithLocalView:(UIView *)localView;//连麦，传进去本机的预览窗口view

（4）回调- (void)acceptSpeak:(NSDictionary *)dict;//主播接受视频连麦

（5）- (void)saveUserInfo:(NSDictionary *)dict remoteView:(UIView *)remoteView;//传回dict数据，和远端的视图view

（6）回调- (void)connectWebRTCSuccess;//表示连麦成功，不成功不用管，会自动挂断

断开连麦：

（1）- (void)disConnectSpeak;//主动断开连接

（2）回调-(void)speak_disconnect:(BOOL)isAllow;//参数isAllow表示是否直播间允许连麦，在这里写一些UI的操作，一般里面都会调用- (void)allowSpeakInteraction:(BOOL)isAllow;这个方法类似的内容

（3）回调方法- (void)allowSpeakInteraction:(BOOL)isAllow;//表示此房间是否允许连麦，一般做一些UI的内容，此方法不止调用一次（登陆，断网联网，改变房间是否允许连麦状态的时候都会回调此代理方法），尽量不要做一些重复的操作

连麦预览中可以调用：

（1）-(void)setLocalVideoFrameA:(CGRect)localVideoFrame;//修改本地预览窗口大小，连麦过程中，本地预览窗口就销毁，因为不会展示本地预览窗口了，只会展示远端窗口

连麦过程中调用：

（1）-(void)setRemoteVideoFrameA:(CGRect)remoteVideoFrame;//修改远端视频窗口的大小，推流中只会展示远端窗口

4.2 事件监听

事件监听只需要实现对应的代理方法即可

4.2.1 请求播放地址成功

/**
*    @brief    请求播放地址成功
*/
-(void)requestSucceed;

4.2.2 请求播放地址失败

/**
*    @brief    请求播放地址失败
*/
-(void)requestFailed:(NSError *)error reason:(NSString *)reason;

4.2.3 收到提问

/**
*    @brief  收到提问，用户观看时和主讲的互动问答信息
*/
- (void)onQuestionDic:(NSDictionary *)questionDic;

4.2.4 收到回答

/**
*    @brief  收到回答，用户观看时和主讲的互动问答信息
*/
- (void)onAnswerDic:(NSDictionary *)answerDic;

4.2.5 主讲和其他用户的历史互动问答信息

/**
*    @brief  收到提问&回答，在用户登录之前，主讲和其他用户的历史互动问答信息
*/
- (void)onQuestionArr:(NSArray *)questionArr onAnswerArr:(NSArray *)answerArr;

4.2.6 历史聊天数据

/**
*    @brief  历史聊天数据
*/
- (void)onChatLog:(NSArray *)chatLogArr;

4.2.7 主讲开始推流

/**
*    @brief  主讲开始推流
*/
- (void)onLiveStatusChangeStart;

4.2.8 停止直播

/**
*    @brief  停止直播，endNormal表示是否异常停止推流，这个参数对观看端影响不大
*/
- (void)onLiveStatusChangeEnd:(BOOL)endNormal;

4.2.9 收到公聊消息

/**
*    @brief  收到公聊消息
*/
- (void)onPublicChatMessage:(NSDictionary *)message;

4.2.10 收到私聊信息

/**
*    @brief    收到私聊信息
*/
- (void)OnPrivateChat:(NSDictionary *)dic;

4.2.11 自己被禁言

/*
*  @brief  收到自己的禁言消息，如果你被禁言了，你发出的消息只有你自己能看到，其他人看不到
*/
- (void)onSilenceUserChatMessage:(NSDictionary *)message;

4.2.12 收到在线人数

/**
*    @brief    收到在线人数
*/
- (void)onUserCount:(NSString *)count;

4.2.13 主讲全体禁言时，你再发消息

/**
*    @brief    当主讲全体禁言时，你再发消息，会出发此代理方法，information是禁言提示信息
*/
- (void)information:(NSString *)information;

4.2.14 服务器端给自己设置的UserId

/**
*    @brief    服务器端给自己设置的UserId
*/
-(void)setMyViewerId:(NSString *)viewerId;

4.2.15 收到踢出消息

/**
*    @brief  收到踢出消息，停止推流并退出播放（被主播踢出）
*/
- (void)onKickOut;

4.2.16 获取房间信息

/**
*    @brief  获取房间信息，主要是要获取直播间模版来类型，根据直播间模版类型来确定界面布局
*    房间简介：dic[@"desc"];
*    房间名称：dic[@"name"];
*    房间模版类型：[dic[@"templateType"] integerValue];
*    模版类型为1: 聊天互动： 无 直播文档： 无 直播问答： 无
*    模版类型为2: 聊天互动： 有 直播文档： 无 直播问答： 有
*    模版类型为3: 聊天互动： 有 直播文档： 无 直播问答： 无
*    模版类型为4: 聊天互动： 有 直播文档： 有 直播问答： 无
*    模版类型为5: 聊天互动： 有 直播文档： 有 直播问答： 有
*    模版类型为6: 聊天互动： 无 直播文档： 无 直播问答： 有
*/
-(void)roomInfo:(NSDictionary *)dic;

4.2.17 直播状态

/**
*    @brief  收到播放直播状态 0直播 1未直播
*/
- (void)getPlayStatue:(NSInteger)status;

4.2.18 白板或者文档本身的宽高

/**
*    @brief  获取文档内白板或者文档本身的宽高，来进行屏幕适配用的
*/
- (void)getDocAspectRatioOfWidth:(CGFloat)width height:(CGFloat)height;

4.2.19 登录成功

/**
*    @brief  登录成功
*/
- (void)loginSucceedPlay;

4.2.20 登录失败

/**
*    @brief  登录失败
*/
-(void)loginFailed:(NSError *)error reason:(NSString *)reason;

4.2.21 连麦相关代理方法

/*（连麦相关代理方法）
*  @brief WebRTC连接成功，在此代理方法中主要做一些界面的更改
*/
- (void)connectWebRTCSuccess;

4.2.22 当前是否可以连麦

/*（连麦相关代理方法）
*  @brief 当前是否可以连麦
*/
- (void)whetherOrNotConnectWebRTCNow:(BOOL)connect;

4.2.23 主播端接受连麦请求

/*（连麦相关代理方法）
*  @brief 主播端接受连麦请求，在此代理方法中，要调用DequestData对象的
*  - (void)saveUserInfo:(NSDictionary *)dict remoteView:(UIView *)remoteView;方法
*  把收到的字典参数和远程连麦页面的view传进来，这个view需要自己设置并发给SDK，SDK将要在这个view上进行渲染
*/
- (void)acceptSpeak:(NSDictionary *)dict;

4.2.24 主播端发送断开连麦

/*（连麦相关代理方法）
*  @brief 主播端发送断开连麦的消息，收到此消息后做断开连麦操作
*/
-(void)speak_disconnect:(BOOL)isAllow;

4.2.25 允许连麦的房间

/*（连麦相关代理方法）
*  @brief 本房间为允许连麦的房间，会回调此方法，在此方法中主要设置UI的逻辑，
*  在断开推流,登录进入直播间和改变房间是否允许连麦状态的时候，都会回调此方法
*/
- (void)allowSpeakInteraction:(BOOL)isAllow;

4.2.26 切换源

/*
*  @brief 切换源，firRoadNum表示一共有几个源，secRoadKeyArray表示每
*  个源的描述数组，具体参见demo，firRoadNum是下拉列表有面的tableviewcell
*  的行数，secRoadKeyArray是左面的tableviewcell的描述信息数组
*/
- (void)firRoad:(NSInteger)firRoadNum secRoadKeyArray:(NSArray *)secRoadKeyArray;

4.2.27 自定义消息

/*
*  自定义消息
*/
- (void)customMessage:(NSString *)message;

4.2.28 公告

/*
*  公告
*/
- (void)announcement:(NSString *)str;

4.2.29 监听到有公告消息

/*
*  监听到有公告消息
*/
- (void)on_announcement:(NSDictionary *)dict;

4.2.30 开始抽奖

/*
*  开始抽奖
*/
- (void)start_lottery;

4.2.31 抽奖结果

/*
*  抽奖结果
*/
- (void)lottery_resultWithCode:(NSString *)code myself:(BOOL)myself winnerName:(NSString *)winnerName remainNum:(NSInteger)remainNum;

4.2.32 退出抽奖

/*
*  退出抽奖
*/
- (void)stop_lottery;

4.2.33 开始签到

/*
*  开始签到
*/
- (void)start_rollcall:(NSInteger)duration;

4.2.34 开始答题

/*
*  开始答题
*/
- (void)start_vote:(NSInteger)count singleSelection:(BOOL)single;

4.2.35 结束答题

/*
*  结束答题
*/
- (void)stop_vote;

4.2.36 答题结果

/*
*  答题结果
*/
- (void)vote_result:(NSDictionary *)resultDic;

4.2.37 加载视频失败

/*
*  加载视频失败
*/
- (void)play_loadVideoFail;

4.2.38 接收到发送的广播

/*
*  接收到发送的广播
*/
- (void)broadcast_msg:(NSDictionary *)dic;

4.2.39 发布问题的ID

/*
*  发布问题的ID
*/
- (void)publish_question:(NSString *)publishId;

4.2.40 发布问卷

/*
*  发布问卷
*/
- (void)questionnaire_publish;

4.2.41 结束发布问卷

/*
*  结束发布问卷
*/
- (void)questionnaire_publish_stop;

4.2.42 问卷详细内容

/*
*  获取问卷详细内容
*/
- (void)questionnaireDetailInformation:(NSDictionary *)detailDic;

4.2.43 提交问卷结果

/*
*  提交问卷结果（成功，失败）
*/
- (void)commitQuestionnaireResult:(BOOL)success;

4.2.44 观看直播修改昵称

/**
*    @brief    修改后的昵称(The new method)
*    @param     nickName  修改后的昵称
*/
- (void)onChangeNickname:(NSString *)nickNime;

4.2.45 获取PPT当前页数和总页数

/**
*  @brief  获取ppt当前页数和总页数(The new method)
*
*  回调当前翻页的页数信息 <br/>
*  白板docTotalPage一直为0, pageNum从1开始<br/>
*  其他文档docTotalPage为正常页数,pageNum从0开始<br/>
*  @param dictionary 翻页信息
*/
- (void)onPageChange:(NSDictionary *) dictionary;

4.2.46 获取最近一条广播

/**
*  @brief  收到最近一条广播(The new method)
*  content 广播内容
*  time 发布时间(单位:秒)
*/
- (void)broadcastHistory_msg:(NSArray *)History_msg;

4.2.47 获取最近一条广播

/**
 *  @brief  获取直播开始时间和直播时长(The new method)
 *  liveDuration 直播持续时间，单位（s），直播未开始返回-1"
 *  liveStartTime 新增开始直播时间（格式：yyyy-MM-dd HH:mm:ss），如果直播未开始，则返回空字符串
 */
- (void)startTimeAndDurationLiveBroadcast:(NSDictionary *)dataDic;

4.2.48 直播间封禁和解禁代理

/**
*    @brief     直播间被禁(The new method)
*/
- (void)theRoomWasBanned;

/**
*    @brief     直播间解禁(The new method)
*/
- (void)theRoomWasCleared;

4.2.49 双击ppt事件代理方法

/**
*    @brief     双击ppt(The new method)
*/
- (void)doubleCllickPPTView;

4.3 播放器监听

添加播放器监听事件（监听播放状态改变）

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  视频播放完成(有可能是加载失败，也有可能是播放结束)

4.4 接收数据格式介绍

收到提问&回答(RequestDataDelegate和RequestDataPlayBackDelegate 中代理方法)

RequestDataDelegate中代理名称如下：
- (void)onQuestionArr:(NSArray *)questionArr onAnswerArr:(NSArray *)answerArr;

RequestDataPlayBackDelegate中代理名称如下：
- (void)onParserQuestionArr:(NSArray *)questionArr onParserAnswerArr:(NSArray *)answerArr;

提问格式，数组

(
{
content = question;//问题内容
encryptId = 2264AF619DD010E9;//问题ID
id = 342854;//提问ID，此ID和上面的encryptId无差别，都是提问的唯一标志，且和下面的回答id是一对多对应，一个问题可以有多条回答信息
isPublish = 1;//问题是否发布
questionUserAvatar = "";//头像
questionUserId = 00d30351184d4cbdb0fcbadd9a55ba1c;//提问问题的用户的用户id
questionUserName = qwer;//提问问题用户的用户名
time = 69006;//提问问题时间点（毫秒）
triggerTime = "2017-11-21 13:50:19";//具体时间点
}
)

收到提问(RequestDataDelegate中代理方法)

- (void)onQuestionDic:(NSDictionary *)questionDic;
{
action = question;
time = 0;//新的提问和回答时间全部为0，历史的提问和回答才有正确时间
value =     {
content = question;
id = BC2D248818827729;//如果该用户被禁言后，该用户发出问题的id都为-1，并且该问题只会发送给该用户，不会发送给其他用户
triggerTime = "2017-11-21 14:02:54";
userAvatar = "";
userId = 9c408a9761d74cb9b64587b2776c5327;
userName = qwer;
};
}
注：提问者角色默认为学生

4 收到回答(RequestDataDelegate中代理方法)

- (void)onAnswerDic:(NSDictionary *)answerDic;
{
action = answer;
time = 0;//新的提问和回答时间全部为0，历史的提问和回答才有正确时间
value =     {
content = answer;
isPrivate = 0;
questionId = BC2D248818827729;
questionUserId = 9c408a9761d74cb9b64587b2776c5327;
triggerTime = "2017-11-21 14:04:17";
userAvatar = "";
userId = 4c70191006d54d549e43ccff4bc1bfd1;
userName = admin;
userRole = publisher;
};
}

5 收到30条历史聊天数据信息(RequestDataDelegate中代理方法)

- (void)onChatLog:(NSArray *)chatLogArr;
(
{
content = message;//聊天内容
time = 68996;//聊天时间（毫秒）
userAvatar = "";//聊天者头像
userCustomMark = "";//个性化信息
userId = 00d30351184d4cbdb0fcbadd9a55ba1c;//聊天者id
userName = qwer;//聊天者用户名
userRole = student;//聊天者用户角色
}
)

6 收到学生发送的公聊信息(RequestDataDelegate中代理方法)

- (void)onPublicChatMessage:(NSDictionary *)dic;
{
msg = chat;//内容
time = "14:10:16";//时间
useravatar = "";//头像
usercustommark = "";//个性化信息
userid = 9c408a9761d74cb9b64587b2776c5327;//用户id
username = qwer;//用户名
userrole = student;//用户角色
}

7 收到学生禁言消息(RequestDataDelegate中代理方法)

- (void)onSilenceUserChatMessage:(NSDictionary *)message;

{

msg = asdfghj;

time = "14:13:53";

useravatar = "";

usercustommark = "";

userid = 9c408a9761d74cb9b64587b2776c5327;

username = qwer;

userrole = student;

}

8 收到学生私聊(RequestDataDelegate中代理方法)

- (void)OnPrivateChat:(NSDictionary *)dic;

{

fromuseravatar = "";

fromuserid = 9c408a9761d74cb9b64587b2776c5327;

fromusername = qwer;

fromuserrole = student;

usercustommark = "";

msg = chat;

time = "14:11:32";

touserid = 00d30351184d4cbdb0fcbadd9a55ba1c;

}

9 聊天信息数组(RequestDataPlayBackDelegate中代理方法)

- (void)onParserChat:(NSArray *)chatArr;

(

{

content = aaa;//聊天内容

time = 27;//聊天的时间点

userAvatar = "";//聊天用户头像

userCustomMark = "";//个性化信息

userId = 00942719153943a4a847d8c9278f030d;//聊天用户id

userName = admin;//聊天用户名

userRole = publisher;//聊天用户角色

}

)

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 两处即可