騰訊互動白板+即時通訊+實時音視頻，Android學生端接入

• 2021 年 7 月 8 日
• 筆記
• Android

騰訊互動白板+即時通訊+實時音視頻，Android學生端接入

一、簡介

線上教學方案：騰訊雲互動白板（Tencent Interactive Whiteboard，TIW）+即時通信（Instant Messaging，IM）+實時音視頻（Tencent RTC）實現老師線上互動教學

官方地址：

//cloud.tencent.com/product/tiw

//cloud.tencent.com/product/im

//cloud.tencent.com/product/trtc

二、接入

1、前置步驟

需要在控制台申請appid，key等，參考：//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 '//dl.bintray.com/tencentqcloudterminal/maven' }
        ...
    }
}
...
allprojects {
     repositories {
        ...
        maven {url '//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回調都可以參考下表說明：

注意：調用 IM SDK Login 成功登錄後，將會開始計算 DAU，請根據業務場景合理使用 IM SDK Login操作，避免出現 DAU 過高的情況。

• 退出登錄：

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();