白板与文档组件

1. 白板画笔相关

1.1 白板基础功能

1.1.1 白板初始化

白板与文档组件的核心类是CCDocViewManager;

//在工程需要的地方引入头文件
#import <CCDocLibrary/CCDocLibrary.h>

//1、类的实例化
- (CCDocVideoView *)ccVideoView
{
    if (!_ccVideoView) {
        CGRect frame = CGRectMake(0, 0, 200, 100);
        _ccVideoView = [[CCDocVideoView alloc]initWithFrame:frame];
        [_ccVideoView addObserverNotify];
    }
    return _ccVideoView;
}

1.1.2 建立Base库的依赖

//与BaseSDK建立联系
- (void)addBasicClient:(CCStreamerBasic *)basic;

1.1.3 修改画板的尺寸

/** 设置frame */
- (void)setDocFrame:(CGRect)frame;

1.1.4 添加画板相关监听事件

//添加监听
- (void)addObserverNotify;

1.1.4 移除画板监听事件

//移除监听
- (void)removeObserverNotify;

1.1.5 设置日志开关

//设置日志开关
+ (void)setLogState:(BOOL)open;

1.1.6 socket事件接收

//事件处理
- (void)onSocketReceive:(NSString *)event value:(id)object;
- (void)onSocketReceive:(NSString *)message onTopic:(NSString *)topic;

1.1.7 设置插播音视频view

//视频框
- (void)setPlayerFrame:(CGRect)playerFrame superView:(UIView *)showView;

1.2 设置手指触发画笔

- (void)setDocEditable:(BOOL)canEdit;

object 参数说明:

1.3 设置画笔的粗细(支持老师端,或是被设为讲师,或是授权标注,才需要设置)

/** 设置画笔宽度 */
- (void)setStrokeWidth:(CGFloat)width;

object 参数说明:

1.4 设置画笔的颜色(支持老师端,或是被设为讲师,或是授权标注,才需要设置)

/** 设置画笔颜色 */
- (void)setStrokeColor:(UIColor *)color;

object 参数说明:

1.5 撤销画笔(支持老师端,或是被设为讲师,或是授权标注,才需要设置)

/** 老师撤销画笔(可以撤销所有人) */
- (void)revokeLastDraw;
/** 学生撤销 */
- (void)revokeLastDrawByStudent;

1.6 清空画笔数据(支持老师端,或是被设为讲师,或是授权标注,才需要设置)

1、清空当前页的画笔数据:

/** 清除当前页的画笔数据 */
- (void)revokeAllDraw;

2、清空整个文档的画笔数据

/** 清空整个文档的画笔数据 */
- (void)revokeAllDocDraw;

1.7 橡皮擦功能

1、是否开启橡皮擦功能:

/** 设置当前是否是橡皮擦 */
- (void)setCurrentIsEraser:(BOOL)eraser;

object 参数说明:

1.8 手势支持功能

1、是否打开文档手势支持:

/** 设置手势开关 */
- (void)setGestureOpen:(BOOL)open;

如果关闭手势支持,文档会恢复缩放前的状态;

object 参数说明:

2 权限相关

2.1 设为讲师/取消设为讲师

1、设为讲师

/** 设为讲师 */
- (BOOL)authUserAsTeacher:(NSString *)userId;

2、取消设为讲师

/** 取消设为讲师 */
- (BOOL)cancleAuthUserAsTeacher:(NSString *)userId;

2.2 授权标注/取消授权标注

1、授权标注

/** 授权标注 */
- (BOOL)authUserDraw:(NSString *)userId;

2、取消授权标注

/** 取消授权标注 */
- (BOOL)cancleAuthUserDraw:(NSString *)userId;

3. 加载画板内容

进入房间成功后调用

- (void)startDocView;

4. 事件消息通知

4.1 添加消息监听

在需要画板的相关控制器内根据需求添加与移除监听事件

#pragma mark -- 接收
-(void)addObserver
{
    [[NSNotificationCenter defaultCenter] addObserver:self selector:@selector(receiveSocketEvent:) name:CCNotiReceiveSocketEvent object:nil];
}
-(void)removeObserver
{
    [[NSNotificationCenter defaultCenter] removeObserver:self];
}

4.2 监听事件处理

收到监听事件后根据业务需求进行其它相关操作

- (void)receiveSocketEvent:(NSNotification *)noti
{
    CCSocketEvent event = (CCSocketEvent)[noti.userInfo[@"event"] integerValue];
    id value = noti.userInfo[@"value"];

if (event == CCSocketEvent_ReciveDrawStateChanged)
    {
               //授权标注事件
         CCUser *user = noti.userInfo[@"user"];
        if (user.user_drawState)
        {
            //被授权标注..客户开展后续自己的业务
        }
    }
    else if (event == CCSocketEvent_ReciveAnssistantChange)
    {
        //设为讲师事件
        CCUser *user = noti.userInfo[@"user"];
        if (user.user_AssistantState)
        {
            //被设为讲师..客户开展后续自己的业务
        }
    }
}