会议抄送事件 - 网易会议

开发者中心

网易会议

服务端 API

会议抄送事件

更新时间： 2024/08/15 18:22:57

本文介绍网易会议组件（NEMeetingKit）的相关抄送事件的参数说明和示例。

适用场景

会议组件抄送支持配置回调来接收某些重要事件，比房间组件（NERoomKit）抄送更加适用于视频会议业务场景。

开启会议组件抄送后，您可同时接收会议抄送与 NERoomKit 抄送，从而根据自身需求处理抄送逻辑。
当事件被触发时，回调服务将主动推送相应事件内容到用户配置的回调地址。

开通消息抄送的操作步骤请参考开通消息抄送。

事件类型

eventType	事件描述
MEETING_INFO_CHANGE	创建会议或修改会议
MEETING_STATE_CHANGE_EVENT	会议状态变更
MEETING_MEMBER_ENTRY	会议成员进入
MEETING_MEMBER_LEAVE	会议成员离开
MEETING_MEMBER_USERNAME_CHANGE	会议成员修改昵称
MEETING_MEMBER_ROLE_CHANGE	会议成员角色变更
MEETING_RECORD	录制文件下载
MEETING_DURATION	会议时长抄送
MEETING_MEMBER_INVITE	会议成员邀请抄送
MEETING_MEMBER_INVITE_CANCEL	会议成员邀请取消抄送
MEETING_TRANSCRIPT_COMPLETED	会议转写记录文件完成事件

创建会议或修改会议

当成功创建会议或修改会议时，会触发该事件。

消息体

字段名	类型	说明
requestId	String	抄送事件唯一标识
eventType	String	事件类型，本事件的类型为：MEETING_INFO_CHANGE
timestamp	Number	该事件发生的 UTC 时间戳，从 1970 年 1 月 1 日 0 点 0 分 0 秒开始到现在的毫秒数
+ body	JSON 对象	抄送消息体
subject	String	会议主题
settings	String	会议设置和 NERoom 房间配置
meetingType	Integer	会议类型： 1：即刻会议 2：个人会议 3：预约会议
state	Integer	会议状态： 1：未开始 2：进行中 3：已结束 4：已取消 5：已回收
ownerUserUuid	String	会议创建者的 userUuid
meetingId	Long	会议 ID
roomArchiveId	Long	归档到历史记录中的房间 ID，全局唯一，最大长度 36 个字符
meetingNum	String	会议号

JSON 示例

JSON{
"requestId": "test_a2f048dfeb764929b3f8c9e52f3b9689",
"eventType": "MEETING_INFO_CHANGE",
"timestamp": 1685527356932,
"body": {
    "subject": "Jack 的即刻会议",
    "settings": "{\"liveConfig\":{\"canvas\":{\"width\":1920,\"height\":1080,\"color\":0},\"liveAddress\":\"https://106.**.**.**:3001/appLive/v2/KBKWYRprHDAmUS3-Q-ThtA\\u003d\\u003d\"},\"roomInfo\":{\"roomConfig\":{\"resource\":{\"rtc\":true,\"chatroom\":true,\"live\":false,\"whiteboard\":true,\"record\":true,\"sip\":true}},\"roomProperties\":{\"extraData\":{\"value\":\"\"},\"focus\":{\"value\":\"\"},\"live\":{\"canvas\":{\"width\":1920,\"height\":1080,\"color\":0}},\"sip\":{\"sipCid\":\"76990361\"}},\"roleBinds\":{\"1159798067911364\":\"host\"},\"roomConfigId\":40}}",
    "meetingType": 1,
    "state": 1,
    "ownerUserUuid": "115***911364",
    "meetingId": 75517,
    "roomArchiveId": 300507,
    "meetingNum": "727356983"
}
}

会议状态变更

当会议状态变更时会触发该回调。

消息体

字段名	类型	说明
requestId	String	抄送事件唯一标识
eventType	String	事件类型，本事件的类型为：MEETING_STATE_CHANGE_EVENT
timestamp	Number	该事件发生的 UTC 时间戳，从 1970 年 1 月 1 日 0 点 0 分 0 秒开始到现在的毫秒数
+ body	JSON 对象	抄送消息体
state	Integer	当前会议状态： 1：未开始 2：进行中 3：已结束 4：已取消 5：已回收
preState	Integer	上一个会议状态： 1：未开始 2：进行中 3：已结束 4：已取消 5：已回收
updateTime	Number	会议状态变更的时间
meetingId	Long	会议 ID
roomArchiveId	Long	归档到历史记录中的房间 ID，全局唯一，最大长度 36 个字符
meetingNum	String	会议号

JSON 示例

JSON{
"requestId": "test_778e15103bd9425788e74da1bc0c579f",
"eventType": "MEETING_STATE_CHANGE_EVENT",
"timestamp": 1685527357617,
"body": {
    "state": 2,
    "preState": 1,
    "updateTime": 1685527357594,
    "meetingId": 75517,
    "roomArchiveId": 300507,
    "meetingNum": "727356983"
}
}

会议成员进入

当有成员进入会议时，会触发该回调。

消息体

字段名	类型	说明
requestId	String	抄送事件唯一标识
eventType	String	事件类型，本事件的类型为：MEETING_MEMBER_ENTRY
timestamp	Number	该事件发生的 UTC 时间戳，从 1970 年 1 月 1 日 0 点 0 分 0 秒开始到现在的毫秒数
+ body	JSON 对象	抄送消息体
userUuid	String	进入会议的用户的 userUuid
clientType	String	该会议成员使用的客户端类型： ios：iPhone 手机 android：安卓手机 pc：windows 电脑 mac：Mac 电脑 web：网页 sip：sip 设备
entryTime	Long	进入会议的时间，单位：毫秒
meetingId	Long	会议 ID
roomArchiveId	Long	归档到历史记录中的房间 ID，全局唯一，最大长度 36 个字符
meetingNum	String	会议号

JSON 示例

JSON{
  "requestId": "test_778e15103bd9425788e74da1bc0c579f",
  "eventType": "MEETING_MEMBER_ENTRY",
  "timestamp": 1685527357669,
  "body": {
    "userUuid": "115***911364",
    "clientType": "mac",
    "entryTime": 1685527501565,
    "meetingId": 75517,
    "roomArchiveId": 300507,
    "meetingNum": "727356983"
  }
}

会议成员离开

当会议中有成员离开会议时，会触发该回调。

消息体

字段名	类型	说明
requestId	String	抄送事件唯一标识
eventType	String	事件类型，该事件的类型为：MEETING_MEMBER_LEAVE
timestamp	Number	该事件发生的 UTC 时间戳，从 1970 年 1 月 1 日 0 点 0 分 0 秒开始到现在的毫秒数
+ body	JSON 对象	抄送消息体
userUuid	String	离开会议的用户的 userUuid
clientType	String	该会议成员使用的客户端类型： ios：iPhone 手机 android：安卓手机 pc：windows 电脑 mac：Mac 电脑 web：网页 sip：sip 设备
leaveTime	Long	离开会议的时间，单位：毫秒
reason.type	String	离开原因： SELF_KICK：多端登录互踢 ADMIN_KICK：被主持人或联席主持人踢出 NORMAL：正常退出 SYS_KICK：通过服务端接口踢出 NORMAL_RTC_OFFLINE：离线退出 ROOM_CLOSED：房间关闭
reason.deviceId	String	设备 ID
meetingId	Long	会议 ID
roomArchiveId	Long	归档到历史记录中的房间 ID，全局唯一，最大长度 36 个字符
meetingNum	String	会议号

JSON 示例

JSON{
"requestId": "test_c79e58a19dba43bb92c101cc5769bba0",
"eventType": "MEETING_MEMBER_LEAVE",
"timestamp": 1685527541766,
"body": {
    "userUuid": "1159***11364",
    "leaveTime": 1685527541565,
    "clientType": "mac",
    "reason": {
    "type": "NORMAL",
    "deviceId": "793D7C28-7673-51BF-A5C4-504298DCF45F"
    },
    "meetingId": 75517,
    "roomArchiveId": 300507,
    "meetingNum": "727356983"
}
}

会议成员修改昵称

当会议中有成员修改昵称时会触发该回调。

消息体

字段名	类型	说明
requestId	String	抄送事件唯一标识
eventType	String	事件类型，该事件的类型为：MEETING_MEMBER_USERNAME_CHANGE
timestamp	Number	该事件发生的 UTC 时间戳，从 1970 年 1 月 1 日 0 点 0 分 0 秒开始到现在的毫秒数
+ body	JSON 对象	抄送消息体
userUuid	String	修改昵称的用户的 userUuid
clientType	String	该会议成员使用的客户端类型： ios：iPhone 手机 android：安卓手机 pc：windows 电脑 mac：Mac 电脑 web：网页 sip：sip 设备
operatorUserUuid	String	执行该操作的用户的 userUuid
newUsername	String	新昵称
oldUsername	String	旧昵称
meetingId	Long	会议 ID
roomArchiveId	Long	归档到历史记录中的房间 ID，全局唯一，最大长度 36 个字符
meetingNum	String	会议号

JSON 示例

JSON{
"requestId": "test_e7ce2cca01f44f82be84e6dc85e54bbe",
"eventType": "MEETING_MEMBER_USERNAME_CHANGE",
"timestamp": 1685587699747,
"body": {
    "userUuid": "1159799092265382",
    "clientType": "web",
    "operatorUserUuid": "1159799092265382",
    "newUsername": "yy",
    "oldUsername": "asd123",
    "meetingId": 75667,
    "roomArchiveId": 300781,
    "meetingNum": "787303261"
}
}

会议成员角色变更

当会议成员角色变更时会触发该回调。

消息体

字段名	类型	说明
requestId	String	抄送事件唯一标识
eventType	String	事件类型，该事件的类型为：MEETING_MEMBER_ROLE_CHANGE
timestamp	Number	该事件发生的 UTC 时间戳，从 1970 年 1 月 1 日 0 点 0 分 0 秒开始到现在的毫秒数
+ body	JSON 对象	抄送消息体
meetingId	Long	会议 ID
roomArchiveId	Long	归档到历史记录中的房间 ID，全局唯一，最大长度 36 个字符
meetingNum	String	会议号
userUuid	String	变更角色的用户的 userUuid
clientType	String	该会议成员使用的客户端类型： ios：iPhone 手机 android：安卓手机 pc：windows 电脑 mac：Mac 电脑 web：网页 sip：SIP 设备
operatorUserUuid	String	执行该操作的用户的 userUuid
newRole	String	新角色
oldRole	String	旧角色

JSON 示例

JSON{
"requestId": "test_841e8c46ae744339be9b833a2661b7b4",
"eventType": "MEETING_MEMBER_ROLE_CHANGE",
"timestamp": 1685587882691,
"body": {
    "userUuid": "1159***65382",
    "clientType": "web",
    "operatorUserUuid": "1159***87911364",
    "oldRole": "cohost",
    "newRole": "member",
    "meetingId": 75667,
    "roomArchiveId": 300781,
    "meetingNum": "787303261"
}
}

录制文件下载

当录制文件生成完毕，并且上传到点播系统成功后触发本抄送。

消息体

字段名	类型	说明
requestId	String	抄送事件唯一标识
eventType	String	事件类型，该事件的类型为：MEETING_RECORD
timestamp	Number	该事件发生的 UTC 时间戳，从 1970 年 1 月 1 日 0 点 0 分 0 秒开始到现在的毫秒数
+ body	JSON 对象	抄送消息体
type	String	文件的类型，即文件扩展名。包括： aac：实时音频录制文件 mp4：实时视频录制文件 flv：互动直播视频录制文件
mix	Boolean	是否为混合录制文件 true：混合录制文件 false：单人录制文件
filename	String	文件名。混合录制文件的 `filename` 带有 -mix 标记，具体命名规则如下：实时音视频单人录制文件：uid-cid-timestamp-sliceindex.filetype 实时音视频混合录制文件：0-cid-timestamp-sliceindex-mix.filetype 互动直播录制文件：taskId-cid-timestamp-sliceindex.filetype
md5	String	文件的 MD5 值
size	Long	文件大小，单位为字节
url	String	文件的下载地址如果点播域名开启了 URL 鉴权，您需要手工拼接防盗链 URL，即在原始地址的最后手工增加 `wsSecret` 和 `wsTime` 相关的值，否则用户会无法访问相应的资源。拼接防盗链 URL 的方法请参考防盗链 URL 构成。
vid	Long	点播文件 ID，通过该参数可以调用点播接口查询相关信息
pieceIndex	Integer	录制文件的切片索引，如果单通通话录制时长超过切片时长，则录制文件会被且被切割成多个文件
timestamp	Long	录制文件生成的时间，单位：毫秒
meetingId	Long	会议 ID
roomArchiveId	Long	归档到历史记录中的房间 ID，全局唯一，最大长度 36 个字符
meetingNum	String	会议号
userUuid	String	该录制文件对应的用户的 userUuid 只有单人录制时才有该参数。混合录制时没有该参数。

JSON 示例

JSON{
"requestId": "test_0f029feb45ae4336966283444439c6a0",
"eventType": "MEETING_RECORD",
"timestamp": 1685953298465,
"body": {
    "type": "mp4",
    "mix": true,
    "filename": "0-13459***779-1685953197143-0-mix.mp4",
    "md5": "81ff9369a85f***b6cddffaa0",
    "size": 10612662,
    "url": "http://jd***afj.vod.126.net/jdv***afj/0-13459***79-1685953197143-0-mix.mp4",
    "vid": 8337140563,
    "pieceIndex": 0,
    "timestamp": 1685953197143,
    "meetingId": 76623,
    "roomArchiveId": 302854,
    "meetingNum": "289194820"
}
}

会议时长抄送

消息体

字段名	类型	说明
requestId	String	抄送事件唯一标识
eventType	String	事件类型，该事件的类型为：MEETING_DURATION
timestamp	Number	该事件发生的 UTC 时间戳，从 1970 年 1 月 1 日 0 点 0 分 0 秒开始到现在的毫秒数
+ body	JSON 对象	抄送消息体
live	Integer	该房间是否已推流，即对外直播。 0：未开启推流 1：已开启推流
rtcCid	String	音视频房间的 cid
duration	Long	房间内所有成员的音视频总时长，单位：秒
createTime	Long	音视频房间开始时间，单位：毫秒
type	String	通话类型： AUDIO：表示音频通话 VIDEO：表示音视频通话
status	String	音视频房间的状态： SUCCESS：正常挂断 RUNNING：运行中
running	Boolean	音视频房间是否进行中 true：进行中 false：已结束
memberDurations	Array of JSON	房间成员信息
userUuid	String	用户的 userUuid
duration	Long	用户过去 12 小时在房间里的通话时长，单位为毫秒。
rtcUid	Long	音视频房间 uid
userType	Integer	用户类型。 2：IM 3：独立音视频 4：录制 SDK
meetingId	Long	会议 ID
roomArchiveId	Long	归档到历史记录中的房间 ID，全局唯一，最大长度 36 个字符
meetingNum	String	会议号

JSON 示例

JSON{
"requestId": "test_3782233c33cc4ffcbb8d6fca7605a559",
"eventType": "MEETING_DURATION",
"timestamp": 1685689473397,
"body": {
    "live": 0,
    "rtcCid": "13459***088025",
    "duration": 234,
    "memberDurations": [
    {
        "duration": 234,
        "rtcUid": 32988,
        "userType": 3,
        "userUuid": "1159***7911364"
    }
    ],
    "createTime": 1685689237240,
    "type": "VIDEO",
    "status": "SUCCESS",
    "running": false,
    "meetingId": 75957,
    "roomArchiveId": 301485,
    "meetingNum": "252359406"
}
}

会议成员邀请抄送

消息体

字段名	类型	说明
requestId	String	抄送事件唯一标识
eventType	String	事件类型，该事件的类型为：MEETING_DURATION
timestamp	Number	该事件发生的 UTC 时间戳，从 1970 年 1 月 1 日 0 点 0 分 0 秒开始到现在的毫秒数
+ body	JSON 对象	抄送消息体
inviteeUserUuid	String	受邀者 ID
operatorUserUuid	String	邀请者 ID
operatorName	String	邀请者昵称
reason	String	邀请理由 MEETING_START_INVITE: 会议即将开始邀请 NORMAL_INVITE：会中发起呼叫邀请
meetingId	Long	会议 ID
roomArchiveId	Long	归档到历史记录中的房间 ID，全局唯一，最大长度 36 个字符
meetingNum	String	会议号

JSON 示例

JSON{
"requestId": "test_3782233c33cc4ffcbb8d6fca7605a559",
"eventType": "MEETING_MEMBER_INVITE",
"timestamp": 1685689473397,
"body": {
    "inviteeUserUuid": "user01*****1232",
    "operatorUserUuid": "13459***088025",
    "operatorName": "testName",
    "reason": "NORMAL_INVITE",
    "meetingId": 75957,
    "roomArchiveId": 301485,
    "meetingNum": "252359406"
}
}

会议成员邀请取消抄送

消息体

字段名	类型	说明
requestId	String	抄送事件唯一标识
eventType	String	事件类型，该事件的类型为：MEETING_DURATION
timestamp	Number	该事件发生的 UTC 时间戳，从 1970 年 1 月 1 日 0 点 0 分 0 秒开始到现在的毫秒数
+ body	JSON 对象	抄送消息体
inviteeUserUuid	String	受邀者 ID
operatorUserUuid	String	操作者 ID
operatorName	String	操作者昵称
reason	String	取消理由 CANCEL: 呼叫邀请被主持人取消 NO_ANSWER：呼叫邀请超时 REMOVED: 呼叫邀请被主持人移除
meetingId	Long	会议 ID
roomArchiveId	Long	归档到历史记录中的房间 ID，全局唯一，最大长度 36 个字符
meetingNum	String	会议号

JSON 示例

JSON{
"requestId": "test_3782233c33cc4ffcbb8d6fca7605a559",
"eventType": "MEETING_MEMBER_INVITE_CANCEL",
"timestamp": 1685689473397,
"body": {
    "inviteeUserUuid": "user01*****1232",
    "operatorUserUuid": "13459***088025",
    "operatorName": "testName",
    "reason": "CANCEL",
    "meetingId": 75957,
    "roomArchiveId": 301485,
    "meetingNum": "252359406"
}
}

会议转写记录文件完成事件

由于转写文件属于敏感内容，在接收到该事件后，需通过获取转写文件接口获取下载链接

消息体

字段名	类型	说明
requestId	String	抄送事件唯一标识
eventType	String	事件类型，该事件的类型为：MEETING_TRANSCRIPT_COMPLETED
timestamp	Number	该事件发生的 UTC 时间戳，从 1970 年 1 月 1 日 0 点 0 分 0 秒开始到现在的毫秒数
+ body	JSON 对象	抄送消息体
meetingId	Long	会议 ID，可通过获取转写文件接口获取下载链接
roomArchiveId	Long	归档到历史记录中的房间 ID，全局唯一，最大长度 36 个字符
meetingNum	String	会议号

JSON 示例

JSON{
"requestId": "prd_3782233c33cc4ffcbb8d6fca7605a559",
"eventType": "MEETING_TRANSCRIPT_COMPLETED",
"timestamp": 1685689473397,
"body": {
    "meetingId": 75957,
    "roomArchiveId": 301485,
    "meetingNum": "252359406"
}
}

在线咨询

微信咨询

电话咨询

此文档是否对你有帮助？

有帮助

去反馈

适用场景
事件类型
创建会议或修改会议
会议状态变更
会议成员进入
会议成员离开
会议成员修改昵称
会议成员角色变更
录制文件下载
会议时长抄送
会议成员邀请抄送
会议成员邀请取消抄送
会议转写记录文件完成事件