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

POOPE

腾讯互动白板+即时通讯+实时音视频，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回调都可以参考下：
回调方法描述推荐操作onConnecting()SDK 正在连接到腾讯云服务器适合在 UI 上展示“正在连接”状态。onConnectSuccess()SDK 已经成功连接到腾讯云服务器连接成功onConnectFailed()SDK 连接腾讯云服务器失败可以提示用户当前网络连接不可用。onKickedOffline()当前用户被踢下线此时可以 UI 提示用户“您已经在其他端登录了当前账号，是否重新登录？”onUserSigExpired()在线时票据过期请使用新签发的 UserSig 进行登录。onSelfInfoUpdated()登录用户的资料发生了更新可以在 UI 上更新自己的头像和昵称。

• 登录IM：
  

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

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

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

callback： 操作结果回调，所有V2TIMCallback回调都可以参考下表说明：
回调方法描述void onError(int code, String    desc);出错时回调，code码详情void onSuccess();成功时回调　　注意：调用 IM SDK Login 成功登录后，将会开始计算 DAU，请根据业务场景合理使用 IM SDK Login操作，避免出现     DAU 过高的情况。

登录时机说明App 启动后首次使用 IM SDK 的能力时本项目为进入连麦模式才首次登录IM SDK (V2TIMSDKListener) 抛出 onUserSigExpired 回调登录票据 (token) 已过期，需要使用新的 UserSig进行登录IM SDK(V2TIMSDKListener) 抛出 onKickOffline    回调当前用户被踢下线，同平台多点登录时触发，可考虑重新登录或者下线

• 退出登录：
  

V2TIMManager.getInstance().logout(null);

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

• 加入群组：
  

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

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

参数说明groupID群id，由主播端创建、业务服务器下发message申请入群说明callback发送申请状态回调　　入群结果监听：void onApplicationProcessed(String groupID, V2TIMGroupMemberInfo opUser, booleanisAgreeJoin, String opReason) 其中isAgreeJoin为true表示同意加群，反之被拒绝。同意加群后，全员（包括请求者）收到onMemberEnter回。
　　监听申请结果：

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

　　V2TIMGroupListener：该回调接口能监听所有群相关的状态，重要方法参考下表：
方法说明void onMemberEnter(String groupID, List<V2TIMGroupMemberInfo>memberList)有用户加入群（全员能够收到）
memberList - 加入的成员void onMemberLeave(String groupID, V2TIMGroupMemberInfomember)有用户离开群（全员能够收到）
member - 离开的成员
注意：群主只能解散群不能离开void onMemberKicked(String groupID, V2TIMGroupMemberInfo opUser, List<V2TIMGroupMemberInfo>memberList)某些人被踢出某群（全员能够收到）
opUser - 处理人
memberList - 被踢成员void onGroupDismissed(String groupID, V2TIMGroupMemberInfoopUser)群被解散了（全员能收到）
opUser - 处理人void onGroupRecycled(String groupID, V2TIMGroupMemberInfoopUser)群被回收（全员能收到）
opUser - 处理人void onApplicationProcessed(String groupID, V2TIMGroupMemberInfo opUser, boolean isAgreeJoin, StringopReason)加群请求已经被群主或管理员处理了（只有申请人能够收到）
opUser -处理人
isAgreeJoin - 是否同意加群
opReason - 处理原因4、接入RTC
　　备注：rtc使用的房间为im中的房间

• 概念：
  

名称说明通话模式无旁路，本项目不用直播模式有旁路接口机用于连麦互动，费用高代理机用于观众拉流观看，费用低

• 初始化RTC：
  

• 获取 TRTCCloud 实例：TRTCCloud.sharedInstance(context);
  
• 设置腾讯云视频通话功能的事件回调接口：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();