一、集成指南

适用范围

本集成文档适用于Android ARBoard SDK 3.0.0+版本。

准备环境

• Android Studio 2.1或以上版本
• Android 版本不低于 4.0.3 且支持音视频的 Android 设备（不支持模拟器）
• Android 设备已经连接到有效网络

导入SDK

Gradle方式导入

添加Jcenter仓库 Gradle依赖：

dependencies {
    compile 'org.ar:board:3.0.7'
}

二、开发指南

集成SDK后，还需对SDK进行初始化操作，建议在Application中完成。

1.1 初始化SDK并配置开发者信息

调用 initEngine() 方法配置开发者信息，开发者信息可在anyRTC管理后台中获得，详见创建anyRTC账号

示例代码：

public class ARApplication extends Application {

    @Override
    public void onCreate() {
        super.onCreate();
        ARBoardEngine.Inst().initEngine("AppId",  "AppToken");
       // ARBoardEngine.Inst().configServerForPriCloud(String strAddr, int nPort, boolean isHttps); 
       //私有云配置 没有可不写
    }
}

自定义的Application需在AndroidManifest.xml注册

1.2 添加白板View到布局当中

示例代码

<RelativeLayout 
    xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    >

    <org.ar.arboard.weight.ARBoardView
        android:id="@+id/ar_board"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_centerInParent="true">
    </org.ar.arboard.weight.ARBoardView>

</RelativeLayout>

直接在布局文件中添加即可，为了保证数据的准确展示，各端白板视图的长宽比需保持一致。

1.3 设置画板监听回调

示例代码

arBoardView.setWhiteBoardListener(ARBoardListener arBoardListener);

1.4 设置图片加载器

示例代码

public class BoardmageLoader extends ImageLoader {
    @Override
    public void displayImage(Context context, Object path, ARPinchImageView imageView) {
        RequestManager requestManager= Glide.with(context);
        requestManager.load(path).
                into(imageView);
    }
}

arBoardView.setImageLoader(new BoardmageLoader());

新建一个类，继承ImageLoader，在重载方法displayImage()里用您项目中加载网络图片的方式加载即可，上述代码以Glide为例

1.5 初始化画板房间

示例代码

arBoardView.initWithRoomId(String roomId, String fileId, String userId, List<String> imageList);

注:用户如果第一次进入则创建，第二次进入则拉取白板数据；用户可以根据自己的实际情况来使用,所有参数不能为空，imageList可以传入图片URL地址或者颜色代码（例：#FF0000）

1.6 设置画笔类型撤销等操作

示例代码

//设置画笔类型
arBoardView.getARBoardConfig().setBrushModel(ARBoardConfig.BrushModel.Line);
//撤销
arBoardView.undo()

更多请参考API介绍

三、API文档

主要类文件概览

1.配置开发者

注:使用ARBoardSDK必须先配置开发者信息，可从www.anyrtc.cc管理中心获取。

2. 是否打印日志

ARBoardEngine.Inst().setDebugLog(false);//true

3.获取SDK版本号

 ARBoardEngine.Inst().getSdkVersion();

4.注册回调监听

class YourActivity extends AppCompatActivity implements ARBoardListener{

    ARBoardView arBoardView

    arBoardView.setWhiteBoardListener(this);
}

5.设置图片加载器（安卓特有）

public class ImageLoader extends org.ar.arboard.imageloader.ImageLoader {

    @Override
    public void displayImage(Context context, Object path, PinchImageView imageView) {
        RequestManager requestManager= Glide.with(context);
        requestManager.load(path).
                into(imageView);
    }
}

arBoardView.setImageLoader(new ImageLoader())

说明：新建一个类，继承ImageLoader，在重载方法displayImage()里用您项目中加载网络图片的方式加载即可。

6.初始化画板

ARBoardView 的指定初始化方法，需传入一个房间 ID,文件ID,用户ID,图片地址集合, 参数说明如下：

注:用户如果第一次进入则创建，第二次进入则拉取白板数据；用户可以根据自己的实际情况来使用

7.白板配置类操作

画笔类型包含以下5种

示例：设置画笔类型为箭头
arBoardView.getARBoardConfig().setBrushModel(ARBoardConfig.BrushModel.Arrow);

8.白板基本操作

9.回调信息

错误码

更新说明

2020/3/3 3.0.7 修复截图可能导致崩溃