如何通过AndroidSDK演示文档

观看文档准备

  1. 注册微吼开发者账号

  2. 创建应用 获取AppID

  3. 设置应用包名签名

  4. 获取 频道ID channelID

    可以通过 【测试工具】 或 【API】 获得

  5. 获取包含文档权限的access_token

    可以通过 【测试工具】 或 【API】 获得

工程配置

在开始使用sdk之前,我们要配置好IDE和创建基础的工程代码。相关内容在【工程配置】中有详细说明。

对接流程

1 创建 VHOPS

文档的构建有两种方式:第一种,通过channelId和accessToken构建,适用于独立的文档直播场景;第二种,通过recordId构建,适用于观看录播的过程中,观看此录播对应的文档。

 // 第一步创建 VHDocument 对象 , 传入对应的参数
 mDocument = new VHOPS(mChannelId, "", mAccessToken);

2 设置文档的显示区域

 // VHDocumentView 是SDK中提供用来显示文档的控件
view = (VHOPSView) this.findViewById(R.id.doc);
 // 获取到VHDocumentView的实例添加到Document中
document.setDocumentView(view);

3 加入频道

调用Join()加入频道,获取Document的服务和消息.

document.join();

4 设置监听

监听文档服务回调出来的事件,包含当前页、步和总页、总步等.

mDocument.setEventListener(new VHOPS.OnEventListener() {
            @Override
            public void onEvent(JSONObject object) {
                Log.i(TAG, "object:" + object.toString());
                mPageView.setText("页数:" + (object.optInt("currentPage") + 1) + "/" + object.optInt("page"));
                mStepView.setText("步数:" + (object.optInt("currentStep") + 1) + "/" + object.optInt("step"));
            }
        });

5 离开频道

调用leave()加入频道,终止Document的服务和消息.

document.leave();

6 设置是否可操作文档(重要)

开启文档编辑,可操作文档,涂鸦或翻页等,观看端会同步展示操作展示 目前在使用过程中,尽量保持同一时间内,只有一个使用者有编辑文档权限。

mDocument.getView().setEditable(false);

以下是文档操作接口示例,只有有文档操作权限才能调用

7 翻页、翻步数

mDocument.getView().preSlide();
mDocument.getView().nextSlide();
mDocument.getView().preStep();
mDocument.getView().nextStep();

8 设置操作类型(添加、修改、删除)

mDocument.getView().setAction(IVHOPS.DrawAction.ADD);

9 设置涂鸦类型

  mDocument.getView().setDrawType(type);

10 设置文档

  mDocument.getView().setDoc(docid);

其他相关文档

  1. 快速开始
  2. 文档模块参考手册