腾讯云即时通信IMAndroid_AI解决方案_同尘科技
升级说明
TUICallKit 是腾讯云推出一款新的音视频通话 UI 组件,是 TUICalling 的升级版本,TUICallKit 体积更小,稳定性更好,也支持更多特性:更加简单易用的 API、更加全面的通话回调、集成包体体积更小。全面升级群组通话功能:支持通话过程中邀请他人加入,主动加入通话等全新能力。更加灵活的参数设置:新增美颜强度设置,新增编码参数设置,新增渲染参数设置。新增音视频通话专属功能:新增弱网环境通话卡顿优化、A 降噪能力、通话悬浮窗。更多特性:支持多端登录、支持服务端结束通话等等。欢迎您使用新的 TUICallKit 组件,在升级前您需要了解到:TUICalling 和 TUICallKit 支持相互呼叫,升级前后,请保持 SDKAppID 不变,否则会影响相互通信;TUICallKit 需要搭配 IM 音视频通话能力套餐,可以单击 IM 控制台,进入对应 SDKAppID 应用的 基本配置 页面,并在页面的右下角找到 开通腾讯实时音视频服务 功能区,单击 免费体验 即可开通 TUICallKit 的 7 天免费试用服务。如果需要正式应用上线,可以单击 前往加购 即可进入购买页面。注意IM 音视频通话能力针对不同的业务需求提供了差异化的付费版本供您选择,您可以在 IM 购买页 了解包含功能并选购您适合的版本。
升级步骤
TUICallKit 在设计之初就兼顾了 TUICalling 客户的升级诉求,仅需要简单两步就可以升级完成,预计花费 20 分钟;
下载&替换 TUICallKit
1. 在 Github 中克隆/下载代码,然后拷贝 Android 目录下的 tuicallkit 子目录到您当前工程中的 app 同级目录中,同时删除 tuicalling 目录,结果如下图:
2. 在工程根目录下找到
setting.gradle
文件,将include ':tuicalling'
替换成include ':tuicallkit'
3. 在 app 目录下找到 build.gradle
文件,将api project(':tuicalling')
替换成api project(':tuicallkit')
说明如果您之前是配合 TUIChat、TUIContact 等IM 组件一起使用的话,执行完这个步骤即可正常使用 TUICallKit,TUICallKit 组件内部已经处理好兼容逻辑。
修改 API 使用
在完成上述步骤后,您的工程就无法正常编译了,需要将 TUICalling API 替换成新的 TUICallKit API,可以参照如下 API 对比信息,搜索替换即可。
API 含义 | TUICalling(包名:com.tencent.liteav.trtccalling) | TUICallKit(包名:com.tencent.qcloud.tuikit.tuicallkit) | 备注 |
创建 TUICallKit 实例 | TUICallingImpl.sharedInstance | TUICallKit.[createInstance](https://cloud.tencent.com/document/product/647/78750#createinstance) | 替换引用、名称 |
设置用户的昵称 | TUICalling.setUserNickname | TUICallKit.[setSelfInfo](https://cloud.tencent.com/document/product/647/78750#setselfinfo) | 设置头像、昵称的接口整合到`setSelfInfo`接口 |
设置用户的头像 | TUICalling.setUserAvatar | TUICallKit.[setSelfInfo](https://cloud.tencent.com/document/product/647/78750#setselfinfo) | 设置头像、昵称的接口整合到`setSelfInfo`接口 |
发起 1v1 通话 | TUICalling.call | TUICallKit.[call](https://cloud.tencent.com/document/product/647/78750#call) | 详见 [TUICalling.call 接口变更](#call) |
发起群组通话 | / | TUICallKit.[groupCall](https://cloud.tencent.com/document/product/647/78750#groupcall) | / |
主动加入当前的群组通话中 | / | TUICallKit.[joinInGroupCall](https://cloud.tencent.com/document/product/647/78750#joiningroupcall) | / |
设置自定义来电铃音 | TUICalling.setCallingBell | TUICallKit.[setCallingBell](https://cloud.tencent.com/document/product/647/78750#setcallingbell) | 替换引用、名称 |
开启/关闭静音模式 | TUICalling.enableMuteMode | TUICallKit.[enableMuteMode](https://cloud.tencent.com/document/product/647/78750#enablemutemode) | 替换引用、名称 |
开启/关闭悬浮窗功能 | TUICalling.enableFloatWindow | TUICallKit.[enableFloatWindow](https://cloud.tencent.com/document/product/647/78750#enablefloatwindow) | 替换引用、名称 |
设置监听事件 | TUICalling.setCallingListener | TUICallEngine.[addObserver](https://cloud.tencent.com/document/product/647/78750#enablefloatwindow) | 详见 [TUICalling.setCallingListener 接口变更](#observer) |
如下是此次升级过程中,变化较大的两个 API 的适配方案:
TUICalling.call 接口变更
TUICalling 代码示例
//原接口void call(String[] userIDs, Type type);
//原调用方式String[] userIDs = new String[1];userIDs[0] = "123";TUICallingImpl.sharedInstance(this).call(userIDs, TUICalling.Type.AUDIO);
TUICallKit 代码示例
//新接口public void call(String userId, TUICallDefine.MediaType callMediaType)
//新调用方式TUICallKit.createInstance().call("mike", TUICallDefine.MediaType.Audio)
TUICalling.setCallingListener 接口变更
TUICalling 代码示例
TUICallingImpl.sharedInstance(this).setCallingListener(new TUICalling.TUICallingListener() { @Override public boolean shouldShowOnCallView() { return true; }
@Override public void onCallStart(String[] userIDs, TUICalling.Type type, TUICalling.Role role, View tuiCallingView) { }
@Override public void onCallEnd(String[] userIDs, TUICalling.Type type, TUICalling.Role role, long totalTime) { }
@Override public void onCallEvent(TUICalling.Event event, TUICalling.Type type, TUICalling.Role role, String message) { }});
TUICallKit 代码示例
private TUICallObserver mTUICallObserver = new TUICallObserver() { @Override public void onError(int code, String msg) { super.onError(code, msg); }
@Override public void onCallReceived(String callerId, List calleeIdList, String groupId, TUICallDefine.MediaType callMediaType) { super.onCallReceived(callerId, calleeIdList, groupId, callMediaType); }
@Override public void onCallCancelled(String callerId) { super.onCallCancelled(callerId); }
@Override public void onCallBegin(TUICommonDefine.RoomId roomId, TUICallDefine.MediaType callMediaType, TUICallDefine.Role callRole) { super.onCallBegin(roomId, callMediaType, callRole); }
@Override public void onCallEnd(TUICommonDefine.RoomId roomId, TUICallDefine.MediaType callMediaType, TUICallDefine.Role callRole, long totalTime) { super.onCallEnd(roomId, callMediaType, callRole, totalTime); } //按需加载其他事件监听 ......}
TUICallEngine.createInstance(mContext).addObserver(mTUICallObserver);
升级完上述 API 后,即可正常使用TUICallKit
组件。
对即时通讯IM解决方案有疑惑?想了解解决方案收费? 联系解决方案专家
腾讯云限时活动1折起,即将结束: 马上收藏
同尘科技为腾讯云授权服务中心,购买腾讯云享受折上折,更有现金返利:同意关联,立享优惠
阿里云解决方案也看看?: 点击对比阿里云的解决方案
暂无评论,你要说点什么吗?