【Android】腾讯云互动白板TeduBoard简单使用

腾讯云互动白板（Tencent Interactive Whiteboard，TIW）提供整套完备的多人实时白板互动服务，打破线上教学中师生信息传递障碍，拥有比面授教学板书更丰富、直观和多样的功能。包含的功能有互动涂鸦、轨迹实时同步、文档共享、媒体共享、文档转码、白板与音视频实时同步录制、回放等功能。具备灵活易用、扩展性强的优点，帮助用户高度还原线下面授教学的互动体验，显著提升线上教学质量。

环境配置

//根据官网最新版本接入
implementation 'com.tencent.teduboard:TEduBoardSdk:2.5.6.85'

defaultConfig{
    ndk{
        abiFilters "armeabi", "armeabi-v7a", "arm64-v8a"
    }
}

白板初始化

//通过TRTC Manager获取白板控制器对象 权限WRITE/READ STORAGE
TEduBoardController mBoardController = mTicManager.getBoardController();    
//获取白板的View
View boardView = mBoardController.getBoardRenderView();
//这里指定了一下白板的大小，根据业务判断是否添加
boardView.setLayoutParams(new FrameLayout.LayoutParams(ViewGroup.LayoutParams.MATCH_PARENT, ViewGroup.LayoutParams.MATCH_PARENT));
//将白板加入FrameLayout容器中
mBinding.flRoomWhiteboard.addView(boardView);

关键方法

加载多个带有图片的白板

mBoardController.reset();   //重置白板
List<String> imageUrls = new ArrayList<String>();
mBoardController.addImagesFile(imageUrls);

白板翻页

mBoardController.prevBoard();   //上一页
mBoardController.nextBoard();   //下一页

白板画笔

mBoardController.setToolType(TEduBoardController.TEduBoardToolType.TEDU_BOARD_TOOL_TYPE_PEN);
mBoardController.setDrawEnable(true);   //开启或关闭绘制

白板橡皮擦

mBoardController.setDrawEnable(true);  //开启或关闭橡皮擦
mBoardController.setToolType(TEduBoardController.TEduBoardToolType.TEDU_BOARD_TOOL_TYPE_ERASER);

清空白板

mBoardController.clear(false,false);

白板缩放

int currentScale = mBoardController.getBoardScale(); //获得当前的缩放比例 
mBoardController.setBoardScale(targetScale);    //设置缩放比例 最高300 最低100

白板拖拽

mBoardController.setDrawEnable(true);   //开启或关闭白板拖拽
mBoardController.setToolType(TEduBoardController.TEduBoardToolType.TEDU_BOARD_TOOL_TYPE_ZOOM_DRAG);

获取白板页数和白板文件相关

String currentFileId = mRoomActivity.mBoardController.getCurrentFile(); //获得当前白板的文件ID
String currentBoardId = mRoomActivity.mBoardController.getCurrentBoard(); //获得当前白板的ID
List<String> fileList = mRoomActivity.mBoardController.getFileBoardList(currentFileId); //通过文件ID获得白板的ID列表

事件监听

public class MyWhiteBoardListener implements TEduBoardController.TEduBoardCallback {

    @Override
    public void onTEBError(int i, String s) {
        //白板发生错误  错误码i 错误信息s
    }

    @Override
    public void onTEBWarning(int i, String s) {
        //白板发生警告  警告码i 警告信息s
    }

    @Override
    public void onTEBInit() {
        //白板初始化完成
        mBoardController.setDrawEnable(true); //默认开启绘制
        mBoardController.setDataSyncEnable(true);    //开启白板历史数据同步
        mBoardController.setBoardRatio("3:4");    //设置白板比例，可以不加

        //在这里可以初次加载白板内容
    }

    @Override
    public void onTEBHistroyDataSyncCompleted() {
        //白板历史记录同步完成
    }

    @Override
    public void onTEBSyncData(String s) {
        //白板同步数据
    }

    @Override
    public void onTEBUndoStatusChanged(boolean b) {
        //白板可撤销状态改变
    }

    @Override
    public void onTEBRedoStatusChanged(boolean b) {
        //白板可重做状态改变
    }

    @Override
    public void onTEBImageStatusChanged(String s, String s1, int i) {
        switch (i){
            case TEduBoardController.TEduBoardImageStatus.TEDU_BOARD_IMAGE_STATUS_LOADING:
                //背景图片加载中
                break;
            case TEduBoardController.TEduBoardImageStatus.TEDU_BOARD_IMAGE_STATUS_LOAD_DONE:
                //背景图片加载完成
                break;
            case TEduBoardController.TEduBoardImageStatus.TEDU_BOARD_IMAGE_STATUS_LOAD_ABORT:
                //背景图片加载中断
                break;
            case TEduBoardController.TEduBoardImageStatus.TEDU_BOARD_IMAGE_STATUS_LOAD_ERROR:
                //背景图片加载错误
                break;
            case TEduBoardController.TEduBoardImageStatus.TEDU_BOARD_IMAGE_STATUS_LOAD_TIMEOUT:
                //背景图片加载超时
                break;
            case TEduBoardController.TEduBoardImageStatus.TEDU_BOARD_IMAGE_STATUS_LOAD_CANCEL:
                //背景图片取消加载 一般可以在这里去刷新刷新白板
                break;
            case TEduBoardController.TEduBoardImageStatus.TEDU_BOARD_IMAGE_STATUS_READ_ERROR:
                //本地图片加载错误
                break;
        }
    }

    @Override
    public void onTEBSetBackgroundImage(String s) {
        //设置白板背景图片 s图片地址
    }

    @Override
    public void onTEBAddImageElement(String s) {
        //添加图片元素 这个最好不要用，多次添加图片会叠在白板上
    }

    @Override
    public void onTEBAddElement(String s, String s1) {
        //添加元素
    }

    @Override
    public void onTEBBackgroundH5StatusChanged(String s, String s1, int i) {
        //白板背景 H5 状态改变
    }

    @Override
    public void onTEBAddBoard(List<String> list, String s) {
        //添加白板页 这里可以设置白板的显示比例和填充模式
        mBoardController.setBoardRatio("3:4");
        mBoardController.setBoardContentFitMode(TEduBoardController.TEduBoardContentFitMode.TEDU_BOARD_CONTENT_FIT_MODE_CENTER_INSIDE);
    }

    @Override
    public void onTEBDeleteBoard(List<String> list, String s) {
        //删除白板页
    }

    @Override
    public void onTEBGotoBoard(String s, String s1) {
        //切换白板
    }

    @Override
    public void onTEBGotoStep(int currentStep, int totalStep) {
        //白板跳转
    }

    @Override
    public void onTEBRectSelected() {

    }

    @Override
    public void onTEBRefresh() {
        //刷新白板
    }

    @Override
    public void onTEBAddTranscodeFile(String s) {
        Log.d("白板事件","增加转码文件");
    }

    @Override
    public void onTEBDeleteFile(String s) {
        Log.d("白板事件","删除文件");
    }

    @Override
    public void onTEBSwitchFile(String s) {
        Log.d("白板事件","切换文件");
    }

    @Override
    public void onTEBFileUploadProgress(String s, int i, int i1, int i2, float v) {
        Log.d("白板事件","文件上传进度:"+s);
    }

    @Override
    public void onTEBFileUploadStatus(String s, int i, int i1, String s1) {
        Log.d("白板事件","文件上传状态");
    }

    @Override
    public void onTEBFileTranscodeProgress(String s, String s1, String s2, TEduBoardController.TEduBoardTranscodeFileResult tEduBoardTranscodeFileResult) {

    }

    @Override
    public void onTEBH5FileStatusChanged(String s, int i) {
        Log.i("白板事件","H5文件变化:"+s);
    }

    @Override
    public void onTEBAddImagesFile(String s) {
        Log.i("白板事件","添加白板URL:"+s);
    }

    @Override
    public void onTEBVideoStatusChanged(String s, int i, float v, float v1) {

    }

    @Override
    public void onTEBAudioStatusChanged(String s, int i, float v, float v1) {

    }

    @Override
    public void onTEBSnapshot(String s, int i, String s1) {
        Log.d("白板事件","白板快照");
    }

    @Override
    public void onTEBH5PPTStatusChanged(int i, String s, String s1) {

    }
}