Call
  • 产品概述
  • Web
    • 跑通 Demo
    • 集成
      • Web&H5 (React)
      • Web&H5 (Vue3)
    • AI 降噪
    • 虚拟背景
    • UI 定制
    • 云端录制
    • 更多功能
      • 设置昵称和头像
      • 设置分辨率和填充模式
      • 群组通话
      • 悬浮窗
      • 自定义铃声
      • 监控通话状态
    • 客户端 API
      • 接口概述
      • TUICallKit
      • TUICallEngine
      • TUICallEvent
    • 服务端 API
      • 通话状态回调
        • 通话状态回调
        • 通话事件回调
        • 回调配置
          • 回调配置接口列表
          • 创建回调配置
          • 查询回调配置
          • 更新回调配置
          • 删除回调配置
      • REST 接口
        • REST 接口简介
        • 通过 callId 获取记录
        • 通过条件获取记录
    • 发布说明
  • Android
    • 跑通 Demo
    • 集成
    • AI 降噪
    • 虚拟背景
    • UI 定制
    • 离线通话推送
    • 云端录制
    • 更多功能
      • 设置昵称和头像
      • 群组通话
      • 悬浮窗
      • 自定义铃声
      • 监控通话状态
    • 客户端 API
      • 接口概述
      • TUICallKit
      • TUICallEngine
      • TUICallObserver
      • 类型定义
    • 服务端 API
      • 通话状态回调
        • 通话状态回调
        • 通话事件回调
        • 回调配置
          • 回调配置接口列表
          • 创建回调配置
          • 查询回调配置
          • 更新回调配置
          • 删除回调配置
      • REST 接口
        • REST 接口简介
        • 通过 callId 获取记录
        • 通过条件获取记录
    • 发布说明
  • iOS
    • 跑通 Demo
    • 集成
    • AI 降噪
    • 虚拟背景
    • UI 定制
    • 离线通话推送
      • VoIP
      • APN
    • 云端录制
    • 更多功能
      • 设置昵称和头像
      • 群组通话
      • 悬浮窗
      • 自定义铃声
      • 监控通话状态
    • 客户端 API
      • 接口概述
      • TUICallKit
      • TUICallEngine
      • TUICallObserver
      • 类型定义
    • 服务端 API
      • 通话状态回调
        • 通话状态回调
        • 通话事件回调
        • 回调配置
          • 回调配置接口列表
          • 创建回调配置
          • 查询回调配置
          • 更新回调配置
          • 删除回调配置
      • REST 接口
        • REST 接口简介
        • 通过 callId 获取记录
        • 通过条件获取记录
    • 发布说明
  • Flutter
    • 跑通 Demo
    • 集成
    • AI 降噪
    • 虚拟背景
    • UI 定制
    • 离线通话推送
      • 通知
      • VoIP(可选)
    • 云端录制
    • 更多功能
      • 设置昵称和头像
      • 群组通话
      • 悬浮窗
      • 美颜特效
      • 自定义铃声
      • 监控通话状态
    • 客户端 API
      • 接口概述
      • TUICallKit
      • TUICallEngine
      • TUICallObserver
      • 类型定义
    • 服务端 API
      • 通话状态回调
        • 通话状态回调
        • 通话事件回调
        • 回调配置
          • 回调配置接口列表
          • 创建回调配置
          • 查询回调配置
          • 更新回调配置
          • 删除回调配置
      • REST 接口
        • REST 接口简介
        • 通过 callId 获取记录
        • 通过条件获取记录
    • 升级
    • 发布说明
  • 产品概述
    • 产品概述
  • 开通服务
  • 价格中心
    • 免费时长
    • 音视频通话 Call 包月套餐
    • Billing Explanation for Subscription Package Duration
    • Pay-as-you-go
      • Billing of Audio and Video Duration
      • Billing of On-Cloud Recording and Recording Delivery
      • Billing of MixTranscoding and Relay to CDN
  • ErrorCode
  • 常见问题
    • All Platform
      • FAQs
      • UserSig
    • Web
    • Flutter
    • iOS
    • Android
Call

Android

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

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

在通话邀请超时时间内,被邀请者如果离线再上线,能否弹出通话界面?

单人通话时,如果在超时时间内上线,会触发来电邀请;群组通话,如果在超时时间内上线,会拉起未处理的20条群消息,如果存在通话邀请,则触发来电邀请。在不同的版本上来电的显示策略有所不同(详见下方:被叫端来电显示策略)。

应用在后台时,不能自动将通话界面拉取到前台

1. TUICallKit 2.3 及以上版本调整了被叫端的来电显示策略,见下方:被叫端来电显示策略
2. TUICallKit 2.3 版本之前,将应用从后台自动拉取到前台,需要检查 App 是否开启了“后台自启动”或“悬浮窗”权限。
不同厂商、甚至同一厂商不同 Android 版本,其对于应用开放的权限以及权限名称也会存在不一致。例如,小米6只需要开启后台弹出界面权限,而红米需要同时打开后台弹出界面和显示悬浮窗权限。
如何开启权限,详见下方:相关权限开启

被叫端来电显示策略

为使 TUICallKit 适应不同的业务需求,增加产品特色,提升用户的使用体验,TUICallKit 2.3 及以上版本发布日志),优化收到来电后的通话页面显示弹出策略,详情如下所示:
全屏显示通话等待界面
横幅显示来电请求






1. 如果您想要被叫端收到邀请时,尽量去拉起全屏通话界面,那么您可以集成 tuicallkit-kt 代码。默认情况下,被叫端的来电显示策略如下:



2. 如果您想在被叫端收到通话的时候,先展示一个横幅,然后根据需要拉起全屏通话界面,那么您可以调用以下接口开启该功能。
TUICallKit.createInstance(context).enableIncomingBanner(true);
开启后,被叫端的来电策略如下所示,只要开启悬浮窗权限,就能尽可能的展示来电横幅。



说明
相关权限如何开启,详见下方:相关权限开启
如果没有按照上述策略显示来电界面,请过滤onCallReceived日志,检查是否收到通话邀请。

相关权限开启

为实现良好的通话体验,建议您在应用中开启“通知”权限、“显示在其他应用上层(悬浮窗)”以及“后台拉起界面”权限,具体方法如下:
手动开启
代码指引
安装应用后,您可以长按应用图标,选择“应用信息”,然后开启“通知”权限、“显示在其他应用上层”以及“后台拉起界面”权限。或者您可以到手机->系统设置->应用管理->应用中手动开启上述权限。
Pixel 4a
VIVO






通知权限:便于展示推送通知:请参考通知运行时权限请求运行时权限 根据业务需求自行实现。
悬浮窗权限:用于展示自定义的来电横幅,以及通话悬浮窗。
后台拉起界面权限:用于当应用在后台时拉起界面(例如:vivo手机)。
fun requestPermission(context: Context?) {
//In TUICallKit,Please open both OverlayWindows and Background pop-ups permission.
PermissionRequester.newInstance(