文档反馈官招募中，报名立赚积分兑换代金券！> HOT
文档中心>即时通信 IM>视频通话（含 UI）>常见问题>iOS

iOS

最近更新时间：2025-07-07 14:29:02

我的收藏

本页目录：

错误提示“The package you purchased does not support this ability”？

如遇以上错误提示，是由于您当前应用的音视频通话能力包过期或未开通，请参见 开通服务，领取或者开通音视频通话能力，进而继续使用TUICallKit组件。

如何购买音视频通话套餐？

请参见购买链接 开通正式版，如有其他问题，请点击页面右侧，进行售前套餐咨询；也可以加入我们的 TUICallKit 技术交流平台 zhiliao，进行咨询和反馈。

如何修改 TUICallKit 源码？

使用 CocoaPods 导入组件，具体步骤如下：
1. 在您的工程 Podfile 文件同一级目录下创建 TUICallKit 文件夹。
2. 单击进入 Github/TUICallKit ，选择克隆/下载代码，然后将 iOS 目录下的 TUICallKit_Swift 文件夹和 TUICallKit_Swift.podspec 文件拷贝到您在 步骤1 创建的 TUICallKit 文件夹下。
3. 在您的 Podfile 文件中添加以下依赖。
# :path => "指向 TUICallKit_Swift.podspec 的相对路径"
pod 'TUICallKit_Swift', :path => "TUICallKit/TUICallKit_Swift.podspec"
4. 执行 pod install 命令，完成导入。
注意：
TUICallKit_Swift文件夹和TUICallKit_Swift.podspec文件必须在同一目录下。
TUICallKit_Swift 组件集成后效果：



说明：
TUICallKit_Swift 组件集成后支持文件夹分层显示，方便您阅读和修改源代码。

Xcode 15 编译报错？

1、出现 Sandbox: rsync 编译报错




可以在 Build Settings 中把 User Script Sandboxing 设置为 NO：




2、出现 SDK does not contain 编译报错




可以在 Podfile 添加如下代码：
# target 'xxxx' do
#  ...
#  pod 'TUICallKit_Swift'
# end

post_install do |installer|
  installer.pods_project.targets.each do |target|
    target.build_configurations.each do |config|
      config.build_settings['IPHONEOS_DEPLOYMENT_TARGET'] = '13.0'
    end
  end
end

3、如果在 M 系列电脑上运行模拟器，可能会出现 Linker command failed with exit code 1 (use -v to see invocation) 编译报错




可以在 Podfile 添加如下代码：
# target 'xxxx' do
#  ...
#  pod 'TUICallKit_Swift'
# end

post_install do |installer|
  installer.pods_project.targets.each do |target|
    target.build_configurations.each do |config|
      config.build_settings['EXCLUDED_ARCHS[sdk=iphonesimulator*]'] = "arm64"
    end
  end
end

TUICallKit 和自己集成的音视频库冲突了？

腾讯云的 音视频库 不能同时集成，可能存在符号冲突，可以按照下面的场景处理。
1. 如果您使用了 TXLiteAVSDK_TRTC 库，不会发生符号冲突。可直接在 Podfile 文件中添加依赖，
pod 'TUICallKit_Swift'
2. 如果您使用了 TXLiteAVSDK_Professional 库，会产生符号冲突。您可在 Podfile 文件中添加依赖，
pod 'TUICallKit_Swift/Professional'
3. 如果您使用了 TXLiteAVSDK_Enterprise 库，会产生符号冲突。建议升级到 TXLiteAVSDK_Professional 后使用 TUICallKit_Swift/Professional。

TUICallKit 是否可以不引入 IM SDK，只使用 TRTC？

不可以。TUIKit 全系组件都使用了腾讯云 IM SDK 作为通信的基础服务，比如通话拨打信令、通话忙线信令等核心逻辑，如果您已经购买有其他 IM 产品，也可以参照 TUICallKit 逻辑进行适配。

TUICallKit 组件支持自定义铃声吗？

支持，调用 setCallingBell 即可。

TUICallKit 是否支持后台运行？

支持，如需要进入后台仍然运行相关功能，可选中当前工程项目，在 Capabilities 下的 Background Modes 模块中勾选 Audio，AirPlay and Picture in Picture ，如下图所示：




如何查看 TRTC 日志？

TRTC 的日志默认压缩加密，后缀为 .xlog。日志是否加密是可以通过 setLogCompressEnabled 来控制，生成的文件名里面含 C(compressed) 的就是加密压缩的，含 R(raw) 的就是明文的。
iOS：sandbox的Documents/log
说明：
查看 .xlog 文件需要下载 解密工具，在 Python 2.7环境中放到 xlog 文件同目录下直接使用 python decode_mars_log_file.py 运行即可。
查看 .clog 文件（9.6 版本以后新的日志格式）需要下载 解密工具，在 Python 2.7 环境中放到 clog 文件同目录下直接使用 python decompress_clog.py 运行即可。
中国站
目录