文档中心>实时音视频>动态与公告>2023年公告>(7月)音视频通话(TUICallKit)上线通话记录看板功能

(7月)音视频通话(TUICallKit)上线通话记录看板功能

最近更新时间:2023-07-10 11:42:41

我的收藏
音视频通话组件(TUICallKit)新上线通话记录看板功能。通话记录是音视频通话能力(TUICallKit)的配套服务,提供 TUICallKit 的通话数据查询功能,包含通话次数、通话人数、最大并发通话数等统计数据,以及通话发起时间、通话参与人数、通话持续时间等单条通话记录信息。

使用条件

音视频通话能力由 TRTC 和 IM 联合提供,目前仅 IM 中国数据中心的应用支持使用通话记录功能,其他数据中心将陆续开放,敬请期待。
仅开通了音视频通话能力(TUICallKit) 群组通话版的应用(SDKAppId)可以使用通话记录功能,您也可以开通体验版免费试用,版本说明及开通指引参考 音视频通话能力版本
目前各平台仅在特定版本的 TUICallKit 可使用通话记录看板,详见下表:
平台/框架
版本号
Android/iOS/Flutter/uni-app(客户端)
>= 1.7.1
Web
>= 1.4.6
微信小程序
>= 1.5.1

使用指引

1. 登录 即时通信IM 控制台,单击目标应用卡片,进入应用的基础配置页面。
2. 在页面的右下角找到腾讯实时音视频服务 TRTC > 音视频通话能力(TUICallKit)功能区。
3. 您可通过点击查看通话记录,进入通话记录页面。若您为首次使用通话记录,需阅读并确认服务开通界面说明,勾选我已知晓并同意《腾讯云视立方·音视频通话 SDK 个人信息保护规则》,随后单击立即开通



4. 若您为首次使用通话记录,需阅读并确认服务开通界面说明,勾选我已知晓并同意《腾讯云视立方·音视频通话 SDK 个人信息保护规则》,随后单击立即开通




数据指标及功能

统计数据

数据指标

指标
定义
通话次数
发起通话的总次数,不论是否接通均统计在内
通话人数
成功加入通话的 UserID 去重后的总数,如收到了通话邀请但未接听的 UserID 不会统计在内
最大并发通话数
同时进行通话的最大通话数量

数据筛选条件

筛选条件
定义
时间
最多可查询近一年统计数据,最小时间粒度为天
通话类型
分为1v1通话、群组通话和全部通话三个统计维度
今日通话总览和本月通话总览均为全部通话统计结果

通话记录


数据指标


通话类型
指标
定义
1v1通话
通话 ID
每一条通话记录的唯一标识
通话发起时间
发起通话的时刻,时间粒度到秒,如:2023-5-20 10:28:08
通话持续时长
通话接通后的持续时长
通话结果
1、取消:主叫方在接通前取消通话
2、拒接:被叫方拒接
3、未接听:被叫方超时未接听
4、完成:通话接通并正常结束
5、发起失败:通话未顺利发起
6、忙线:通话忙线
7、通话中止:网络等原因导致通话中断
主叫 UserID
发起通话的 UserID
被叫 UserID
接听通话的 UserID
群组通话
通话 ID
每一条通话记录的唯一标识
通话发起时间
发起通话的时刻,时间粒度到秒,如:2023-5-20 10:28:08
通话持续时长
通话参与人数大于1人的持续时长
同时通话人数峰值
同时在线通话人数的峰值
参与人数
成功加入过群组通话的人数,以 UserID 去重,点击对应数字可查看详情,包含:
1、UserID:成功加入通话的 UserID
2、通话时长:通话参与人数大于1人时,对应 UserID 的通话持续时长
3、平台:接入通话的平台,分为iOS、Android 、Web 和微信小程序

数据筛选条件

筛选条件
指标
通话类型
1v1通话和群组通话
时间
最多可查询近90天通话记录,最小查询时间粒度为天
通话结果
仅1v1通话支持,通话结果分类及定义参见 通话记录 > 数据指标
通话 ID
输入通话 ID 进行查询
UserID
输入 UserID 进行查询