通话记录看板是音视频通话能力(TUICallKit)的配套服务,提供 TUICallKit 的通话数据统计及通话记录可视化看板。服务包含通话次数、通话人数、最大并发通话数等统计数据,以及通话发起时间、通话参与人数、通话持续时间等单条通话记录信息。
使用条件
仅开通了音视频通话能力(TUICallKit) 群组通话版的应用(SDKAppId)可以使用通话记录功能,您也可以开通体验版免费试用,版本说明及开通指引参考 购买指南。
目前各平台仅在特定版本的 TUICallKit 可使用通话记录看板,详见下表:
平台/框架 | 版本号 |
Android/iOS/Flutter/uni-app(客户端) | ≥ 1.7.1 |
Web | ≥ 1.4.6 |
微信小程序 | ≥ 1.5.1 |
注意:
参与通话的所有平台/框架升级到上述新的版本后,才可在控制台上查看到对应的通话信息。
使用指引
1. 登录 即时通信IM 控制台,单击目标应用卡片,进入应用的基础配置页面。
2. 在页面的右下角找到含 UI 低代码场景方案 > 音视频通话(TUICallKit)功能区。
3. 您可通过点击查看通话记录,进入通话记录页面。
4. 若您为首次使用通话记录,需阅读并确认服务开通界面说明,勾选我已知晓并同意《腾讯云视立方·音视频通话 SDK 个人信息保护规则》,随后单击立即开通。
数据指标及功能
统计数据
数据指标
指标 | 定义 |
通话次数 | 发起通话的总次数,不论是否接通均统计在内。 |
通话人数 | 成功加入通话的 UserID 去重后的总数。 如收到了通话邀请但未接听的 UserID 不会统计在内;如一个 UserID 在统计时间范围内参与多场通话,在通话人数中也只记录为1。 |
最大并发通话数 | 同时进行通话的最大通话数量。 在今日通话总览和本月通话总览中,最大并发通话数是1v1通话和群组通话2种方式的最大值,如统计时间范围内1v1通话的最大并发通话数是20,群组通话的最大并发通话数是10,那么对应数据将为20。 |
数据筛选条件
筛选条件 | 定义 |
时间 | 最多可查询近一年统计数据,最小时间粒度为天。 |
通话类型 | 分为1v1通话、群组通话和全部通话三个统计维度。 今日通话总览和本月通话总览均为全部通话统计结果。 |
通话记录
数据指标
通话类型 | 指标 | 定义 |
1v1通话 | 通话 ID | 每一条通话记录的唯一标识。 |
| 通话发起时间 | 发起通话的时刻,时间粒度到秒,如:2023-5-20 10:28:08。 |
| 通话持续时长 | 通话接通后的持续时长。 |
| 通话结果 | 1. 取消:主叫方在接通前取消通话。 2. 拒接:被叫方拒接。 3. 未接听:被叫方超时未接听。 4. 完成:通话接通并正常结束。 5. 忙线:通话忙线。 6. 中断:网络等原因导致通话中断。 未知原因:未知原因。如本地网络、进程异常中断等原因导致的数据上报失败。 |
| 主叫 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天通话记录,最小查询时间粒度为天。 |
通话结果 | |
通话 ID | 输入通话 ID 进行查询。 |
UserID | 输入 UserID 进行查询。 |