腾讯云即时通信IMiOS_AI解决方案_同尘科技
升级说明
TUICallKit 是腾讯云推出一款新的音视频通话 UI 组件,是 TUICalling 的升级版本,TUICallKit 体积更小,稳定性更好,也支持更多特性:更加简单易用的 API、更加全面的通话回调、集成包体体积更小。全面升级群组通话功能:支持通话过程中邀请他人加入,主动加入通话等全新能力。更加灵活的参数设置:新增美颜强度设置,新增编码参数设置,新增渲染参数设置。新增音视频通话专属功能:新增弱网环境通话卡顿优化、A 降噪能力、通话悬浮窗。更多特性:支持多端登录、支持服务端结束通话等等。欢迎您使用新的 TUICallKit 组件,在升级前您需要了解到:TUICalling 和 TUICallKit 支持相互呼叫,升级前后,请保持 SDKAppID 不变,否则会影响相互通信;TUICallKit 需要搭配 IM 音视频通话能力套餐,可以单击 IM 控制台,进入对应 SDKAppID 应用的 基本配置 页面,并在页面的右下角找到 开通腾讯实时音视频服务 功能区,单击 免费体验 即可开通 TUICallKit 的 7 天免费试用服务。如果需要正式应用上线,可以单击 前往加购 即可进入购买页面。注意IM 音视频通话能力针对不同的业务需求提供了差异化的付费版本供您选择,您可以在 IM 购买页 了解包含功能并选购您适合的版本。
升级步骤
TUICallKit 在设计之初就兼顾了 TUICalling 客户的升级诉求,仅需要简单两步就可以升级完成,预计花费 20 分钟;
替换 TUICallKit
1. 删除您的工程 Podfile
文件同一级目录下的 TUICalling
文件夹。2. 删除您的 Podfile
文件中的以下依赖。
# :path => "指向TUICalling.podspec的相对路径"pod 'TUICalling', :path => "TUICalling/TUICalling.podspec", :subspecs => ["TRTC"]
3. 在您的 Podfile
文件中添加以下依赖。
pod 'TUICallKit'
4. 执行以下命令,安装组件。
pod install
如果无法安装 TUICallKit 最新版本,执行以下命令更新本地的 CocoaPods 仓库列表。
pod repo update
说明 如果您之前是配合 TUIChat、TUIContact 等IM 组件一起使用的话,执行完这个步骤即可正常使用 TUICallKit,TUICallKit 组件内部已经处理好兼容逻辑。
修改 API 使用
在完成上述步骤后,您的工程就无法正常编译了,需要将 TUICalling API 替换成新的TUICallKit API, 可以参照如下 API 对比信息,搜索替换即可。
API 含义 | TUICalling | TUICallKit | 备注 |
创建 TUICallKit 实例 | TUICallingImpl.sharedInstance | TUICallKit.[createIstance](https://cloud.tencent.com/document/product/647/78753#createinstance) | 替换引用、名称 |
设置用户的昵称 | TUICalling.setUserNickname | TUICallKit.[setSelfInfo](https://cloud.tencent.com/document/product/647/78753#setselfinfo) | 设置头像、昵称的接口整合到`setSelfInfo`接口 |
设置用户的头像 | TUICalling.setUserAvatar | TUICallKit.[setSelfInfo](https://cloud.tencent.com/document/product/647/78753#setselfinfo) | 设置头像、昵称的接口整合到`setSelfInfo`接口 |
发起 1v1 通话 | TUICalling.call | TUICallKit.[call](https://cloud.tencent.com/document/product/647/78753#call) | 详见 [TUICalling.call 接口变更](#call) |
发起群组通话 | / | TUICallKit.[groupCall](https://cloud.tencent.com/document/product/647/78753#groupcall) | / |
主动加入当前的群组通话中 | / | TUICallKit.[joinInGroupCall](https://cloud.tencent.com/document/product/647/78753#joiningroupcall) | / |
设置自定义来电铃音 | TUICalling.setCallingBell | TUICallKit.[setCallingBell](https://cloud.tencent.com/document/product/647/78753#setcallingbell) | 替换引用、名称 |
开启/关闭静音模式 | TUICalling.enableMuteMode | TUICallKit.[enableMuteMode](https://cloud.tencent.com/document/product/647/78753#enablemutemode) | 替换引用、名称 |
开启/关闭悬浮窗功能 | TUICalling.enableFloatWindow | TUICallKit.[enableFloatWindow](https://cloud.tencent.com/document/product/647/78753#enablefloatwindow) | 替换引用、名称 |
设置监听事件 | TUICalling.setCallingListener | TUICallEngine.[addObserver](https://cloud.tencent.com/document/product/647/78753#enablefloatwindow) | 详见[TUICalling.setCallingListener 接口变](#observer) |
如下是此次升级过程中,变化较大的两个 API 的适配方案:
TUICalling.call 接口变更
TUICalling 代码示例:
// 原接口[[TUICalling shareInstance] call:@[@"mike"] type:TUICallingTypeVideo];
TUICallKit 代码示例:
// 新调用方式[[TUICallKit createInstance] call:@"mike" callMediaType:TUICallMediaTypeVideo];
TUICalling.setCallingListener 接口变更
TUICalling 代码示例
[[TUICalling shareInstance] setCallingListener:self];
- (BOOL)shouldShowOnCallView { return YES;}- (void)callStart:(nonnull NSArray *)userIDs type:(TUICallingType)type role:(TUICallingRole)role viewController:(UIViewController * _Nullable)viewController {
}- (void)callEnd:(nonnull NSArray *)userIDs type:(TUICallingType)type role:(TUICallingRole)role totalTime:(float)totalTime {
}- (void)onCallEvent:(TUICallingEvent)event type:(TUICallingType)type role:(TUICallingRole)role message:(nonnull NSString *)message {
}
TUICallKit 代码示例
[[TUICallEngine createInstance] addObserver:self];
- (void)onCallBegin:(TUIRoomId *)roomId callMediaType:(TUICallMediaType)callMediaType callRole:(TUICallRole)callRole {
}- (void)onCallEnd:(TUIRoomId *)roomId callMediaType:(TUICallMediaType)callMediaType callRole:(TUICallRole)callRole totalTime:(float)totalTime {
}- (void)onUserNetworkQualityChanged:(NSArray *)networkQualityList {
}// 按需加载其他事件监听......
升级完上述 API 后,您可以正常使用TUICallKit
组件。
对即时通讯IM解决方案有疑惑?想了解解决方案收费? 联系解决方案专家
腾讯云限时活动1折起,即将结束: 马上收藏
同尘科技为腾讯云授权服务中心,购买腾讯云享受折上折,更有现金返利:同意关联,立享优惠
阿里云解决方案也看看?: 点击对比阿里云的解决方案
暂无评论,你要说点什么吗?