package cn.iocoder.yudao.module.im.framework.rtc.core;
|
|
import com.fasterxml.jackson.annotation.JsonIgnoreProperties;
|
import lombok.Data;
|
|
/**
|
* LiveKit Webhook 事件载荷；只反序列化我们关心的字段，其余忽略
|
* <p>
|
* 文档参考：<a href="https://docs.livekit.io/home/server/webhook/">webhook 文档</a>
|
*
|
* @author 芋道源码
|
*/
|
@Data
|
@JsonIgnoreProperties(ignoreUnknown = true)
|
public class LiveKitWebhookEventDTO {
|
|
/**
|
* 房间创建：首个 participant 加入时触发
|
*/
|
public static final String EVENT_ROOM_STARTED = "room_started";
|
/**
|
* 房间销毁：最后一个 participant 离开 / 显式 DeleteRoom 后触发；用于业务侧兜底关房
|
*/
|
public static final String EVENT_ROOM_FINISHED = "room_finished";
|
/**
|
* 参与者加入房间
|
*/
|
public static final String EVENT_PARTICIPANT_JOINED = "participant_joined";
|
/**
|
* 参与者离开房间：关 tab / 网络断 / 显式 disconnect 都会触发；用于业务侧兜底清理
|
*/
|
public static final String EVENT_PARTICIPANT_LEFT = "participant_left";
|
/**
|
* 参与者发布媒体轨道（摄像头 / 麦克风 / 屏幕共享）
|
*/
|
public static final String EVENT_TRACK_PUBLISHED = "track_published";
|
|
/**
|
* 事件 id：用于幂等去重
|
*/
|
private String id;
|
|
/**
|
* 事件类型；取值参见本类 EVENT_* 常量
|
*/
|
private String event;
|
|
/**
|
* 房间元信息：room_started / room_finished 必填
|
*/
|
private RoomInfo room;
|
|
/**
|
* 参与者元信息：participant_* 事件必填
|
*/
|
private ParticipantInfo participant;
|
|
@Data
|
@JsonIgnoreProperties(ignoreUnknown = true)
|
public static class RoomInfo {
|
|
private String sid;
|
private String name;
|
private Long creationTime;
|
private Integer numParticipants;
|
|
}
|
|
@Data
|
@JsonIgnoreProperties(ignoreUnknown = true)
|
public static class ParticipantInfo {
|
|
private String sid;
|
/**
|
* 用户身份：签 token 时写入 userId 字符串，后续支持多端会拼成 userId#terminal
|
*/
|
private String identity;
|
private String name;
|
private Long joinedAt;
|
|
}
|
|
}
|
