腾讯互动白板+即时通讯+实时音视频,Android学生端接入
腾讯互动白板+即时通讯+实时音视频,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();
文档来源:博客园https://www.cnblogs.com/zhoux123/p/14984116.html
页:
[1]