MeetingEngine 是 Meeting SDK 对外总入口,覆盖会前管理、入会会控、媒体能力与消息能力。
静态方法
version()
参数说明:无。
返回值说明:
String,字符串结果。
buildTime()
参数说明:无。
返回值说明:
String,字符串结果。
create()
MeetingEngine 实例。参数说明:
app:Application,应用上下文(建议传Application实例)。 返回值说明:MeetingEngine,MeetingEngine实例。
核心属性
infosManager(属性)
参数说明:无。
返回值说明:
InfosManager,属性值。
imEvent(属性)
参数说明:无。
返回值说明:
ImEvent?,属性值。
roomEvent(属性)
参数说明:无。
返回值说明:
RoomEvent?,属性值。
userEvent(属性)
参数说明:无。
返回值说明:
UserEvent?,属性值。
roomMsgEvent(属性)
参数说明:无。
返回值说明:
RoomMsgEvent?,属性值。
mediaEvent(属性)
参数说明:无。
返回值说明:
MediaEvent?,属性值。
enableClientCloudRecordCapture(属性)
参数说明:无。
返回值说明:
Boolean,属性值。
生命周期与配置
getShareCustomVideoTrack()
参数说明:
preOpt:PreOptionCustomVideo?,预设参数;为null时使用 SDK 默认预设。 返回值说明:LocalCustomVideoTrack?,本地自定义视频轨道;未就绪时返回null。
initSdk()
参数说明:
meetToken:String,会议鉴权令牌,用于初始化 SDK 与后续会控请求。options:RTCMediaOptions?,流媒体参数配置;传null时使用默认媒体配置。listener:MeetingResultCallback?,结果回调,返回调用成功或失败信息。 返回值说明:无(Unit)。
release()
参数说明:无。
返回值说明:无(
Unit)。
updateMediaOptions()
参数说明:
options:RTCMediaOptions,流媒体参数配置;传null时使用默认媒体配置。 返回值说明:无(Unit)。
getSelfInfo()
参数说明:
callback:Callback<Data<UserBean?>?>?,异步结果回调,返回接口执行结果或错误信息。 返回值说明:无(Unit)。
getAgentList()
参数说明:
types:MutableList<AgentType>,设备类型筛选列表。keyword:String,关键字,用于按名称或属性筛选结果。page:Int,分页页码(从 1 开始)。perPage:Int,每页数量。callback:Callback<Data2<List<AgentBean>>>,异步结果回调,返回接口执行结果或错误信息。 返回值说明:无(Unit)。
IM 相关
enableIm()
参数说明:
callback:EnableImCallback,异步结果回调,返回接口执行结果或错误信息。 返回值说明:无(Unit)。
disableIm()
0参数说明:无。
返回值说明:无(
Unit)。
callUser()
参数说明:
targetUids:MutableList<String>,被呼叫用户 UID 列表。callback:Callback<Data<String>>,异步结果回调,返回接口执行结果或错误信息。 返回值说明:无(Unit)。
会前会议管理
createImmediateMeeting()
参数说明:
title:String,会议标题option:CreateImmediateMeetingOption,创建即时会议可选参数callback:Callback<Data<MeetingCreatedBean>>?,异步结果回调,返回接口执行结果或错误信息。 返回值说明:无(Unit)。
createScheduleMeeting()
参数说明:
title:String,会议标题planTime:Long,开始时间时间戳planDur:Int,会议时长option:CreateScheduleMeetingOption,创建预约会议可选参数callback:Callback<Data<MeetingCreatedBean>>?,异步结果回调,返回接口执行结果或错误信息。 返回值说明:无(Unit)。
updateMeetingBeforeStart()
参数说明:
meetingId:String,会议idoption:UpdateMeetingOption,修改会议可选参数callback:Callback<Data<String?>>,异步结果回调,返回接口执行结果或错误信息。 返回值说明:无(Unit)。
getMeetingList()
参数说明:
page:Int,分页页码(从 1 开始)。perPage:Int,每页数量。callback:Callback<Data2<List<MeetInfo>>>,异步结果回调,返回接口执行结果或错误信息。 返回值说明:无(Unit)。
getHistoryMeetingList()
参数说明:
page:Int,分页页码(从 1 开始)。perPage:Int,每页数量。callback:Callback<Data2<List<MeetInfo>>>,异步结果回调,返回接口执行结果或错误信息。 返回值说明:无(Unit)。
getMeetingDetail()
参数说明:
meetingId:String,会议 ID。callback:Callback<Data<MeetDetail>>,异步结果回调,返回接口执行结果或错误信息。 返回值说明:无(Unit)。
getMeetingDetailByRoomNo()
参数说明:
roomNo:String,会议房间号。callback:Callback<Data<MeetDetail>>,异步结果回调,返回接口执行结果或错误信息。 返回值说明:无(Unit)。
cancelMeetingBeforeStart()
参数说明:
meetingId:String,会议 ID。callback:Callback<Data<String?>>,异步结果回调,返回接口执行结果或错误信息。 返回值说明:无(Unit)。
入会与离会
enterMeeting()
参数说明:
activity:Activity,activityroomNo:String,房间号password:String?,密码nick:String,入会名称avatar:String,用户头像 URL 或头像标识。streamVendor:String,流媒体厂商extendInfo:String?,扩展属性callback:EnterMeetingCallback,回调参数:JoinRoomInfo、Room room、User me、List<User> members。 返回值说明:无(Unit)。
enterMeetingByMeetingId()
参数说明:
activity:Activity,activitymeetingId:String,会议idpassword:String?,密码nick:String,入会名称avatar:String,用户头像 URL 或头像标识。streamVendor:String,流媒体厂商extendInfo:String?,扩展属性callback:EnterMeetingCallback,回调参数:JoinRoomInfo、Room room、User me、List<User> members。 返回值说明:无(Unit)。
exitMeeting()
参数说明:无。
返回值说明:无(
Unit)。
exitWaitingRoom()
参数说明:
callback:Callback<Data<String?>>?,结果回调 返回值说明:无(Unit)。
主持人会控
adminDestroyMeeting()
参数说明:
callback:Callback<Data<String?>>?,回调 返回值说明:无(Unit)。
adminUpdateConferee()
参数说明:
conferees:MutableList<String>,受邀成员列表callback:Callback<Data<String?>>?,回调 返回值说明:无(Unit)。
adminUpdateRoomCameraState()
参数说明:
selfUnMuteCameraDisabled:Boolean,房间是否允许自我解除禁画状态,默认true,true-禁解除 false-不限制cameraDisabled:Boolean,房间视频禁用状态,默认false true-禁用 false-不禁用callback:Callback<Data<String?>>?,异步结果回调,返回接口执行结果或错误信息。 返回值说明:无(Unit)。
adminUpdateRoomSelfUnmuteCameraDisabled()
参数说明:
selfUnMuteCameraDisabled:Boolean,房间是否允许自我解除禁画状态,默认true,true-禁解除 false-不限制callback:Callback<Data<String?>>?,异步结果回调,返回接口执行结果或错误信息。 返回值说明:无(Unit)。
adminUpdateRoomMicState()
参数说明:
selfUnMuteMicDisabled:Boolean,房间是否允许自我解除禁音状态 默认true,true-禁解除 false-不限制micDisabled:Boolean,房间音频禁用状态 默认false true-禁用 false-不禁用callback:Callback<Data<String?>>?,异步结果回调,返回接口执行结果或错误信息。 返回值说明:无(Unit)。
adminUpdateRoomSelfUnmuteMicDisabled()
参数说明:
selfUnMuteMicDisabled:Boolean,房间是否允许自我解除禁音状态 默认true,true-禁解除 false-不限制callback:Callback<Data<String?>>?,异步结果回调,返回接口执行结果或错误信息。 返回值说明:无(Unit)。
adminUpdateRoomShareState()
参数说明:
shareDisabled:Boolean,是否禁用房间共享能力。callback:Callback<Data<String?>>?,异步结果回调,返回接口执行结果或错误信息。 返回值说明:无(Unit)。
adminUpdateRoomChatDisabled()
参数说明:
chatDisabled:Boolean,房间文本消息禁用状态,默认false,true-禁用 false-不禁用callback:Callback<Data<String?>>?,回调 返回值说明:无(Unit)。
adminUpdateRoomScreenshotDisabled()
参数说明:
screenshotDisabled:Boolean,截屏功能禁用状态 默认false true-禁用 false-不禁用callback:Callback<Data<String?>>?,异步结果回调,返回接口执行结果或错误信息。 返回值说明:无(Unit)。
adminUpdateRoomWatermarkDisabled()
参数说明:
watermarkDisabled:Boolean,水印禁用状态 默认false true-禁用 false-不禁用callback:Callback<Data<String?>>?,异步结果回调,返回接口执行结果或错误信息。 返回值说明:无(Unit)。
adminUpdateRoomLocked()
参数说明:
locked:Boolean,房间锁定状态,默认 false, true-开启 false-关闭callback:Callback<Data<String?>>?,异步结果回调,返回接口执行结果或错误信息。 返回值说明:无(Unit)。
adminUpdateUserName()
参数说明:
targetId:String,String 目标用户IDname:String,String 名称callback:Callback<Data<String?>>?,结果回调 返回值说明:无(Unit)。
adminUpdateUserRole()
参数说明:
targetId:String,String 目标用户IDrole:MemberRoleType,Int 角色 0普通成员 1主持人callback:Callback<Data<String?>>?,结果回调 返回值说明:无(Unit)。
adminMoveHost()
参数说明:
targetId:String,String 目标用户IDcallback:Callback<Data<String?>>?,结果回调 返回值说明:无(Unit)。
adminUpdateUserDrawDisabled()
参数说明:
targetId:String,String 目标用户IDdrawDisabled:Boolean,涂鸦禁用状态,默认 true,true-禁用 false-不禁用callback:Callback<Data<String?>>?,结果回调 返回值说明:无(Unit)。
adminUpdateUserChatDisabled()
参数说明:
targetId:String,String 目标用户IDchatDisabled:Boolean,聊天禁用状态,默认 false,true-禁用 false-不禁用callback:Callback<Data<String?>>?,结果回调 返回值说明:无(Unit)。
adminRequestUserOpenCamera()
参数说明:
targetId:String,String 目标用户IDcallback:Callback<Data<String?>>?,结果回调 返回值说明:无(Unit)。
adminCloseUserCamera()
参数说明:
targetId:String,String 目标用户IDcallback:Callback<Data<String?>>?,结果回调 返回值说明:无(Unit)。
adminDisableUserCamera()
参数说明:
targetId:String,目标用户 idcameraDisabled:Boolean,摄像头禁用状态,默认 false,true-禁用 false-不禁用callback:Callback<Data<String?>>?,结果回调 返回值说明:无(Unit)。
adminRequestUserOpenMic()
参数说明:
targetId:String,String 目标用户IDcallback:Callback<Data<String?>>?,结果回调 返回值说明:无(Unit)。
adminCloseUserMic()
参数说明:
targetId:String,String 目标用户IDcallback:Callback<Data<String?>>?,结果回调 返回值说明:无(Unit)。
adminDisableUserMic()
参数说明:
targetId:String,目标用户 idmicDisabled:Boolean,麦克风禁用状态,默认 false,true-禁用 false-不禁用callback:Callback<Data<String?>>?,结果回调 返回值说明:无(Unit)。
adminRequestUserShare()
参数说明:
targetId:String,目标用户 idcallback:Callback<Data<String?>>?,结果回调 返回值说明:无(Unit)。
adminStopRoomShare()
参数说明:
callback:Callback<Data<String?>>?,结果回调 返回值说明:无(Unit)。
adminInviteAgent()
参数说明:
agents:List<AgentRequestBean>,邀请设备请求列表callback:Callback<Data<String?>>?,结果回调 返回值说明:无(Unit)。
adminKickUserOut()
参数说明:
targetId:String,String 目标用户IDcallback:Callback<Data<String?>>?,结果回调 返回值说明:无(Unit)。
adminConfirmHandUp()
参数说明:
targetId:String,String 目标用户IDcode:HandUpType,举手类型,1:申请开音频 2:申请开视频 3:申请聊天 4:申请共享 5:申请涂鸦approve:Boolean,处理用户举手 true-同意 false-拒绝callback:Callback<Data<String?>>?,结果回调 返回值说明:无(Unit)。
adminGetOnlineMembers()
参数说明:
meetingId:String?,String 会议idpage:Int,Int 分页页码,从 1 开始prePage:Int,Int 每页数据量,最大1000,默认20callback:Callback<Data2<List<MemberBean>>>,结果回调 返回值说明:无(Unit)。
adminUpdateRoomMCUMode()
参数说明:无。
返回值说明:无(
Unit)。
等候室与讨论组
adminWaitingRoomDisabled()
参数说明:
waitingRoomDisabled:Boolean,是否禁用等待室 默认true true:禁用 false:不禁用callback:Callback<Data<String?>>?,结果回调 返回值说明:无(Unit)。
adminMoveOutWaitingRoom()
参数说明:
uid:String?,用户 UID;在等候室场景中为null时表示全部用户。callback:Callback<Data<String?>>?,结果回调 返回值说明:无(Unit)。
adminMoveInWaitingRoom()
参数说明:
uid:String,目标用户 UID。nickName:String,用户显示名称。callback:Callback<Data<String?>>?,异步结果回调,返回接口执行结果或错误信息。 返回值说明:无(Unit)。
adminGetWaitingRoomUsers()
参数说明:
callback:Callback<Data<List<WaitingRoomUserBean>>>,结果回调 返回值说明:无(Unit)。
createSubMeeting()
参数说明:
subMeetingTitles:MutableList<String>,子会议名称列表callback:Callback<Data<String?>>?,结果回调 返回值说明:无(Unit)。
updateSubMeetingTitle()
参数说明:
id:String,讨论组 idtitle:String,讨论组标题callback:Callback<Data<String?>>?,结果回调 返回值说明:无(Unit)。
updateSubMeetingUsers()
参数说明:
id:String,讨论组 idmembers:MutableList<MemberRequestBean>,讨论组参与者全量数据callback:Callback<Data<String?>>?,结果回调 返回值说明:无(Unit)。
deleteSubMeeting()
参数说明:
ids:MutableList<String>,讨论组id列表callback:Callback<Data<String?>>?,结果回调 返回值说明:无(Unit)。
getSubMeetingList()
参数说明:
callback:Callback<Data<MutableList<SubMeetingBean>?>>,结果回调 返回值说明:无(Unit)。
startSubMeeting()
参数说明:
ids:MutableList<String>,讨论组id列表callback:Callback<Data<String?>>?,异步结果回调,返回接口执行结果或错误信息。 返回值说明:无(Unit)。
stopSubMeeting()
参数说明:
ids:MutableList<String>,讨论组id列表callback:Callback<Data<String?>>?,结果回调 返回值说明:无(Unit)。
moveSubMeetingUser()
参数说明:
fromId:String,来自哪个小组的idtoId:String?,移动到哪个小组的id, 空表示主会场uid:String,移动用户的 uidcallback:Callback<Data<String?>>?,结果回调 返回值说明:无(Unit)。
updateEnterBeforeHostDisabled()
参数说明:
meetingId:String,会议 identerBeforeHostDisabled:Boolean,是否禁止在主持人之前进入会议callback:Callback<Data<String?>>?,结果回调 返回值说明:无(Unit)。
helpSubMeeting()
参数说明:
meetingId:String,会议 ID。callback:Callback<Data<String?>>?,异步结果回调,返回接口执行结果或错误信息。 返回值说明:无(Unit)。
成员媒体控制
updateName()
参数说明:
name:String,姓名callback:Callback<Data<String?>>?,结果回调 返回值说明:无(Unit)。
requestOpenCamera()
参数说明:
view:View?,预览画面渲染工具preOpt:PreOptionCamera?,打开摄像头预设参数callback:Callback<Data<String?>>?,结果回调 返回值说明:无(Unit)。
closeCamera()
参数说明:无。
返回值说明:无(
Unit)。
switchCamera()
参数说明:
isFrontCamera:Boolean,true: 前置;false:后置 返回值说明:无(Unit)。
switchLight()
参数说明:
open:Boolean,true:打开;false:关闭 返回值说明:无(Unit)。
addPreview()
参数说明:
view:View,View 返回值说明:无(Unit)。
removePreview()
参数说明:
view:View?,如果 view 不为空,则移除指定控件;如果 view 为空,则移除所有控件 返回值说明:无(Unit)。
replacePreView()
参数说明:
mViews:MutableList<View>, 返回值说明:无(Unit)。
getAllPreview()
参数说明:无。
返回值说明:
ArrayList<View>,当前已绑定的本地预览视图列表。
requestOpenMic()
参数说明:
preOpt:PreOptionMic?,打开麦克风预设参数callback:Callback<Data<String?>>?,结果回调 返回值说明:无(Unit)。
closeMic()
参数说明:无。
返回值说明:无(
Unit)。
屏幕共享与白板
initScreenShare()
参数说明:
activity:Activity,活动notificationParam:ScreenNotificationOption?,通知栏参数,如果不启用通知栏,这个参数可以不设置preOpt:PreOptionScreen?,屏幕共享预设参数event:ScreenShareEvent,屏幕共享事件回调 返回值说明:无(Unit)。
startScreenShare()
参数说明:
hasBar:Boolean,是否启用通知栏listener:MeetingResultCallback?,结果回调,返回调用成功或失败信息。 返回值说明:无(Unit)。
stopScreenShare()
参数说明:无。
返回值说明:无(
Unit)。
requestShareBoard()
参数说明:
callback:BoardShareCallback,结果回调 返回值说明:无(Unit)。
stopShareWhiteBoard()
参数说明:无。
返回值说明:无(
Unit)。
聊天与举手
sendRoomChatMessage()
参数说明:
targetId:String?,String 目标用户ID,传null发送为全体msg:String,String 消息msgType:ChatMsgType,Int 消息类型 1:文本(默认) 2:文件 3:图片 4:语音callback:Callback<Data<String?>>?,结果回调 返回值说明:无(Unit)。
sendRoomCustomMessage()
参数说明:
targetId:String?,String? 目标用户ID,传null发送为全体msg:String,String? 消息内容callback:Callback<Data<String?>>?,结果回调 返回值说明:无(Unit)。
getRoomChatMsgList()
参数说明:
page:Int,Int 页码prePage:Int,Int 每页个数callback:Callback<Data2<List<ChatMsgBean?>>>,结果回调 返回值说明:无(Unit)。
requestHandUp()
参数说明:
code:HandUpType,举手申请类型 1:申请开音频 2:申请开视频 3:申请聊天 4:申请共享 5:申请涂鸦callback:Callback<Data<String?>>?,结果回调 返回值说明:无(Unit)。
cancelHandUp()
参数说明:
code:HandUpType,举手申请类型 1:申请开音频 2:申请开视频 3:申请聊天 4:申请共享 5:申请涂鸦 返回值说明:无(Unit)。
请求确认
confirmOpenCameraAgree()
参数说明:
targetId:String,目标用户(主持人)idview:View?,渲染器控件preOpt:PreOptionCamera?,摄像头参数callback:Callback<Data<String?>>?,异步结果回调,返回接口执行结果或错误信息。 返回值说明:无(Unit)。
confirmOpenCameraRefuse()
参数说明:
targetId:String,目标用户(主持人)idcallback:Callback<Data<String?>>?,异步结果回调,返回接口执行结果或错误信息。 返回值说明:无(Unit)。
confirmOpenMicAgree()
参数说明:
targetId:String,目标用户(主持人)idpreOpt:PreOptionMic?,麦克风参数callback:Callback<Data<String?>>?,异步结果回调,返回接口执行结果或错误信息。 返回值说明:无(Unit)。
confirmOpenMicRefuse()
参数说明:
targetId:String,目标用户(主持人)idcallback:Callback<Data<String?>>?,结果回调 返回值说明:无(Unit)。
confirmStartScreenShareAgree()
参数说明:
targetId:String,目标用户(主持人)idhasBar:Boolean,是否显示通知栏listener:MeetingResultCallback?,结果回调 返回值说明:无(Unit)。
confirmStartScreenShareRefuse()
参数说明:
targetId:String,callback:Callback<Data<String?>>?,异步结果回调,返回接口执行结果或错误信息。 返回值说明:无(Unit)。
confirmStartWhiteBoardShareAgree()
参数说明:
targetId:String,callback:BoardShareCallback, 返回值说明:无(Unit)。
confirmStartWhiteBoardShareRefuse()
参数说明:
targetId:String,callback:Callback<Data<String?>>?,异步结果回调,返回接口执行结果或错误信息。 返回值说明:无(Unit)。
录制相关
startCloudRecord()
参数说明:
layoutData:LayoutData?,云录制布局参数;传null时使用默认布局。callback:Callback<Data<String?>>?,异步结果回调,返回接口执行结果或错误信息。 返回值说明:无(Unit)。
stopCloudRecord()
参数说明:
callback:Callback<Data<String?>>?,异步结果回调,返回接口执行结果或错误信息。 返回值说明:无(Unit)。
enableCourseRecordTrack()
参数说明:
track:LocalCustomVideoTrack,用于课程录制发布的本地自定义视频轨道。callback:CommonCallback?,轨道发布完成回调 返回值说明:无(Unit)。
disableCourseRecordTrack()
参数说明:无。
返回值说明:无(
Unit)。
音频与远端播放
toggleRemoteAudioMute()
参数说明:
mute:Boolean,true:静音 false:取消静音 返回值说明:无(Unit)。
getAudioRouterManager()
参数说明:无。
返回值说明:
AudioRouterManager?,音频路由管理器实例;未初始化时返回 null。
releaseAudioRouterManager()
参数说明:无。
返回值说明:无(
Unit)。
startPlayRemoteVideo()
参数说明:
uid:String,目标成员 UID。trackDesc:String,轨道描述(如camera_big、camera_small、screen)。view:View?,视频渲染视图;传null时仅订阅不渲染。 默认值:null。event:RTCRemoteVideoEvent?,远端视频播放事件回调。 默认值:null。 返回值说明:RemoteVideoTrack?,远端视频轨道实例;未找到或未订阅时返回null。
stopPlayRemoteVideo()
参数说明:
uid:String,目标成员 UID。trackDesc:String,轨道描述(如camera_big、camera_small、screen)。 返回值说明:无(Unit)。
getRemoteVideoTrack()
参数说明:
uid:String,目标成员 UID。trackDesc:String,轨道描述(如camera_big、camera_small、screen)。 返回值说明:RemoteVideoTrack?,远端视频轨道实例;未找到或未订阅时返回null。
startPlayRemoteMixture()
参数说明:
view:View?,视频渲染视图;传null时仅订阅不渲染。event:RTCRemoteVideoEvent?,远端合成流播放事件回调。 默认值:null。 返回值说明:RemoteVideoTrack?,远端合成视频轨道实例;未找到时返回null。
stopPlayRemoteMixture()
参数说明:无。
返回值说明:无(
Unit)。
getRemoteMixtureTrack()
参数说明:无。
返回值说明:
RemoteVideoTrack?,远端视频轨道实例;未找到或未订阅时返回 null。