abundant-magician-17307
12/24/2025, 8:59 AMtall-airline-16756
12/24/2025, 8:59 AMtall-airline-16756
12/24/2025, 9:00 AMroom_sid / `room_name`(房间信息)
◦ `event_timestamp`(事件时间戳)
◦ `event_type`(固定为 `participant_left`)
• 离开原因(关键诊断)
◦ 主动离开:`CLIENT_INITIATED`(用户调用 `leave()`)
◦ 重复身份:`DUPLICATE_IDENTITY`(被新连接替换)
◦ 连接超时/网络问题:`CONNECTION_TIMEOUT`(ICE/网络失败)
◦ 被移除:`PARTICIPANT_REMOVED`(管理员或 API 踢出)
◦ 房间被删除:`ROOM_DELETED`
◦ 节点迁移完成:`MIGRATION`
• 会话与行为分析
◦ `session_duration`(离开时间 - 加入时间)用于停留时长统计
◦ 是否为“最后一个离开者”(房间是否空)
◦ `peak_participant_count`(用户离开前房间人数)
• 媒体与交互上下文
◦ 是否正在发布音/视频(TrackPublication 状态)
◦ 最后一次活跃时间(最后发言/VAD/STT 时间)
◦ 连接质量历史(丢包、RTT、码率波动)
◦ 设备类型与客户端版本
◦ 是否启用 E2EE(可能影响行为与稳定性)
• Webhook/投递与可靠性指标
◦ webhook 投递是否成功(`webhook_delivery_success`)
◦ 重试次数(`delivery_attempts`)
◦ 事件到达延迟/事件年龄(超出 MaxAge 可能被丢弃)
如何采集与使用(简要建议)
• 启用并接收 participant_left Webhook;在后端记录事件并校验签名。
• 在 participant_joined 时记录 `join_time`,在 participant_left 时计算 `session_duration`。
• 将回调中的 DisconnectReason / closeReason 保存为离开原因分类。
• 结合客户端或 Agent 上报的连接质量、设备与最后活跃时间,做离开前兆分析。
• 记录 webhook 投递日志与重试情况,用于评估事件可靠性与延迟。
我可以:
• 提供 participant_left Webhook 的示例 payload;或
• 帮你设计需要存进数据库的字段列表(按分析/BI 需求分组);或
• 给出如何从现有事件计算会话时长与离开原因统计的示例查询。
你希望我优先帮你做哪一项?
Sources: livekit/livekit_composite | DeepWiki | Server-side | livekit/livekit_composite | DeepWiki | server-sdk-ruby | livekit/livekit_composite | DeepWiki | LLM Metrics | LiveKit docs | server-sdk-js | livekit/livekit_composite | DeepWikiabundant-magician-17307
12/24/2025, 9:05 AMtall-airline-16756
12/24/2025, 9:05 AMparticipant_connection_aborted 在我们现有资料中没有明确记载。下面说明我能确认和可以帮助你的方向:
• 目前资料中未包含 participant_connection_aborted 的官方定义或示例 payload。
• 常见类似用途:这样的事件名通常用于表示参与者的连接被中止或提前终止(可能对应连接超时、ICE 失败或客户端/服务端主动中断),但我无法肯定它对应哪个具体的 DisconnectReason 或触发条件。
• 我可以为你做的事情:
◦ 帮你检查你接收到该事件的完整 webhook/payload(示例字段、`closeReason`、时间戳、room/participant 信息),以判断它实际代表的含义;
◦ 或者把该事件与已知断开原因(如 `CONNECTION_TIMEOUT`、`PARTICIPANT_REMOVED`、`CLIENT_INITIATED` 等)做对比,给出匹配与判定规则;
◦ 如果你需要,我也可以给出如何在后端记录与分类该事件的建议字段列表,以及如何把它纳入离开原因统计。
你想先把收到的该事件的完整 payload 发给我,还是我直接给出分类与记录字段建议?
Sources: server-sdk-ruby | livekit/livekit_composite | DeepWiki | Server-side | livekit/livekit_composite | DeepWiki | server-sdk-js | livekit/livekit_composite | DeepWiki