腾讯互动白板+即时通讯+实时音视频，Android学生端接入

一、简介

线上教学方案：腾讯云互动白板（Tencent Interactive Whiteboard，TIW）+即时通信（Instant Messaging，IM）+实时音视频（Tencent RTC）实现老师线上互动教学

官方地址：

https://cloud.tencent.com/product/tiw

https://cloud.tencent.com/product/im

https://cloud.tencent.com/product/trtc

二、接入

1、前置步骤

需要在控制台申请appid，key等，参考：https://cloud.tencent.com/document/product/1137/39899

2、配置工程

app.build: 引用依赖库 rtc,im,eb，并指定app的cpu架构

android{
    ...
    defaultconfig{
        ...
        ndk {
            abiFilters "armeabi", "armeabi-v7a", "arm64-v8a"
        }
        ...
    }
    ...
}
...
dependencies{
    ...
    api \'com.tencent.liteav:LiteAVSDK_TRTC:8.7.10102\'
    api \'com.tencent.imsdk:imsdk:4.8.50\'
    api \'com.tencent.edu:TEduBoardSdk:2.6.0.98\'
    ...
}

project.build: app.build中的依赖文件下载出问题时，可以参考如下配置

buildscript {
    repositories {
        ...
        maven {url \'https://dl.bintray.com/tencentqcloudterminal/maven\' }
        ...
    }
}
...
allprojects {
     repositories {
        ...
        maven {url \'https://dl.bintray.com/tencentqcloudterminal/maven\' }
        ...
    }
}

Manifest: 添加以下权限

<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission android:name="android.permission.CAMERA" />
<uses-permission android:name="android.permission.CHANGE_NETWORK_STATE" />
<uses-permission android:name="android.permission.MODIFY_AUDIO_SETTINGS" />
<uses-permission android:name="android.permission.READ_PHONE_STATE" />
<uses-permission android:name="android.permission.RECEIVE_BOOT_COMPLETED" />
<uses-permission android:name="android.permission.RECORD_AUDIO" />
<uses-permission android:name="android.permission.VIBRATE" />
<uses-permission android:name="android.permission.WAKE_LOCK" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />

<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.BLUETOOTH" />
<uses-feature android:name="android.hardware.camera" />
<uses-feature android:name="android.hardware.camera.autofocus" />

3、接入IM

• 初始化IM：

V2TIMManager.getInstance().initSDK(Context context, int sdkAppID, V2TIMSDKConfig config,V2TIMSDKListener     listener)

sdkAppID: 上述控制台上申请的appid

config: 配置信息可为传null，目前只有配置日志等级，默认info级别

listener: 初始化回调接口，提供了网络状态和用户信息变化回调，所有V2TIMSDKListener回调都可以参考下：

• 登录IM：

V2TIMManager.getInstance().login(String userId, String userSig, V2TIMCallback callback);

userId： 用户id，可自定义，不超过32位

userSig： IM SDK 登录票据（token），由业务服务器生成

callback： 操作结果回调，所有V2TIMCallback回调都可以参考下表说明：

• 退出登录：

V2TIMManager.getInstance().logout(null);

为了降低 DAU，项目在结束连麦后，要及时调用退出登录。

• 加入群组：

群分类： 好友工作群（Work）、陌生人社交群（Public）、临时会议群（Meeting）、直播群（AVChatRoom）；项目采用public群（需要审批），详细区别参考：官方群类型介绍

申请入群：

V2TIMManager.getInstance().joinGroup(String groupID, String message, V2TIMCallback callback);

入群结果监听：void onApplicationProcessed(String groupID, V2TIMGroupMemberInfo opUser, booleanisAgreeJoin, String opReason) 其中isAgreeJoin为true表示同意加群，反之被拒绝。同意加群后，全员（包括请求者）收到onMemberEnter回。

监听申请结果：

V2TIMManager.getInstance().setGroupListener(V2TIMGroupListener listener);

V2TIMGroupListener：该回调接口能监听所有群相关的状态，重要方法参考下表：

4、接入RTC

备注：rtc使用的房间为im中的房间

• 概念：

• 初始化RTC：

1. 获取 TRTCCloud 实例：TRTCCloud.sharedInstance(context);
2. 设置腾讯云视频通话功能的事件回调接口：setListener(TRTCCloudListener listener)

• 设置本地视频编码参数：
  详情参考官方文档说明

  void setVideoEncoderParam(com.tencent.trtc.TRTCCloudDef.TRTCVideoEncParam trtcVideoEncParam)
  

• 进入房间：

  void enterRoom(com.tencent.trtc.TRTCCloudDef.TRTCParams trtcParams, int scene)

  进入房间的返回结果，会在TRTCCloudListener.onEnterRoom(result)中回调。更多详情参考官方文档

  • trtcParams:appid,token,roomId,role等，如果进入房间并互动，role要设置为主播。更多详情参考官方文档
  • scene:应用场景主播端和连入端必须统一，本项目采用连麦直播（Live）TRTCCloudDef.TRTC_APP_SCENE_LIVE。更多详情参考官方文档

  注意：不管进房是否成功，enterRoom 都必须与 exitRoom 配对使用，在调用 exitRoom 前再次调用 enterRoom 函数会导致不可预期的错误问题

• 退出房间: void exitRoom()
• 开始连麦互动：

  trtcCloud.startLocalAudio(TRTCCloudDef.TRTC_AUDIO_QUALITY_DEFAULT);
  trtcCloud.startLocalPreview(true, view);

  • 如果当前没有在互动中，需要先调用trtcCloud.switchRole(TRTCCloudDef.TRTCRoleAnchor)切换到主播角色
  • startLocalAudio: 开启音频，参数为音频质量。更多详细说明请参考官网文档
  • startLocalPreview: 开启摄像头预览，第一个参数是否为前置摄像头，第二个参数为承载预览的TXCloudVideoView。更多详细说明请参考官网文档
  • 只要在房间中，会自动推流
• 结束连麦互动:

  trtcCloud.stopLocalAudio();
  trtcCloud.stopLocalPreview();

5、接入IW

互动白板在有IM前提下，接入比较简单

• 初始化：

  // 创建并初始化白板控制器
  //（1）鉴权配置
  TEduBoardController.TEduBoardAuthParam authParam = new TEduBoardController.TEduBoardAuthParam(sdkAppId, userId, userSig);
  //（2）白板默认配置
  TEduBoardController.TEduBoardInitParam initParam = new TEduBoardController.TEduBoardInitParam();
  mBoard = new TEduBoardController(context);
  //（3）添加白板事件回调
  mBoard.addCallback(callback);
  //（4）进行初始化
  mBoard.init(authParam, roomId, initParam);

  initParam: 白板配置为默认配置，如果有笔画颜色等特殊需求，参考官方文档配置。

• 显示白板：

  //（1）获取白板 View
  View boardview = mBoard.getBoardRenderView();
  //（2）添加到父视图中
  FrameLayout.LayoutParams layoutParams = new FrameLayout.LayoutParams(FrameLayout.LayoutParams.MATCH_PARENT, FrameLayout.LayoutParams.MATCH_PARENT);
  FrameLayout container = findViewById(R.id.board_view_container);
  container.addView(boardview, layoutParams);

• 销毁： TIMManager.getInstance().unInit();