实现音视频通话
基本步骤如下:
1. 初始化SDK
初始化是整个 SDK 的使用基础,通常在程序启动的时候进行初始化(init),退出的时候进行反初始化(uninit),整个程序的生命周期中只进行一次初始化和反初始化。
SDK 内部的组件多为单例组件,整个程序中只能有一个实例,比如“基础组件”,“房间管理组件”,“视频房间组件”,具体请参见各个组件说明。
// SDK初始化数据对象
SdkInitDat sdkInitDat =
SdkInitDat(
sdkDatSavePath: path,
noCall: true, // 需要用到呼叫模块,则传false
noQueue: true // 需要用到队列模块,则传false
);
// 初始化SDK
RtcSDK.sdkManager.init(sdkInitDat, SDKListener(
onLineOff: () {
// 掉线通知
}
));
// 各个模块的监听
RtcSDK.roomManager.setListener(RoomListener(
onUserEnterMeeting: userEnterMeeting,
onUserLeftMeeting: userLeftMeeting,
onMeetingDropped: meetingDropped,
onMeetingStopped: meetingStopped,
onNetStateChanged: netStateChanged,
onNotifyMeetingCustomMsg: notifyMeetingCustomMsg,
));
RtcSDK.audioManager.setListener(AudioListener(
onAudioStatusChanged: audioStatusChanged,
onAudioDevChanged: audioDevChanged,
onMicEnergyUpdate: micEnergyUpdate,
));
RtcSDK.videoManager.setListener(VideoListener(
onVideoStatusChanged: videoStatusChanged,
onVideoDevChanged: videoDevChanged,
));
RtcSDK.memberManager.setListener(MemberListener(
onNotifyNickNameChanged: notifyNickNameChanged,
));
RtcSDK.screenShareManager.setListener(ScreenShareListener(
onNotifyScreenShareStarted: notifyScreenShareStarted,
onNotifyScreenShareStopped: notifyScreenShareStopped,
onNotifyScreenMarkStarted: notifyScreenMarkStarted,
onNotifyScreenMarkStopped: notifyScreenMarkStopped,
));
RtcSDK.recordManager.setListener(RecordListener(
onLocMixerOutputInfo: locMixerOutputInfo,
onLocMixerStateChanged: locMixerStateChanged,
onNotifyRecordFileStateChanged: notifyRecordFileStateChanged,
onNotifyRecordFileUploadProgress: notifyRecordFileUploadProgress,
onCreateCloudMixerFailed: createCloudMixerFailed, // 启动云端录制、云端直播失败通知
onCloudMixerStateChanged: cloudMixerStateChanged, // 云端录制、云端直播状态变化通知
onCloudMixerInfoChanged: cloudMixerInfoChanged, // 云端录制、云端直播配置变化通知
onCloudMixerOutputInfoChanged:
cloudMixerOutputInfoChanged, // 云端录制文件、云端直播输出变化通知
));
RtcSDK.mediaManager.setListener(MediaListener(
onNotifyMediaOpened: notifyMediaOpened,
onNotifyMediaStart: notifyMediaStart,
onNotifyMediaPause: notifyMediaPause,
onNotifyMediaStop: notifyMediaStop,
));
相关 API 请参考:
相关结构定义请参考:
2. 登录连接视频服务器
设置视频服务器地址,使用AppID、AppSecret和自定义用户编号登录
- 调用接口:
// 设置服务器地址
RtcSDK.sdkManager.setServerAddr(server);
// 登录数据对象
LoginDat config = LoginDat(
nickName: nickName, // 昵称
privAcnt: privAcnt, // 用户ID
appID: appID, // appID,使用开通SDK的账号
appSecret: appSecret // appSecret必须做MD5处理
);
// 执行登录操作
RtcSDK.sdkManager.login(config);
相关 API 请参考:
4. 创建房间
创建一个房间
- 调用接口:
// 创建房间
MeetInfo meetInfo = await RtcSDK.roomManager.createMeeting();
if (meetInfo.sdkErr == 0) {
// 创建房间成功
} else {
// 创建房间失败
}
相关 API 请参考:
5. 进入房间
用创建成功的房间 ID 进入房间,其他用户也是利用此房间信息进入该房间。
- 调用接口:
int sdkErr = await RtcSDK.videoManager.enterMeeting(confid, nickName);
相关 API 请参考:
6. 打开麦克风/摄像头
紧接第 5 步,进入房间成功后,创建视频容器,打开自己的麦克风和摄像头,以便本地、远端显示自己的视频图像
// 用户摄像头信息,-1表示观看默认摄像头
UsrVideoId usrVideoId = UsrVideoId(userId: myUserID, videoID: -1);
// 创建视频
Widget view = RtcSDK.videoManager.createView((viewID) {
RtcSDK.videoManager.setUsrVideoId(viewID, usrVideoId);
});
// 打开摄像头 (在onVideoDevChanged之后调用)
RtcSDK.videoManager.openVideo(myUserID);
// 打开麦克风 (在onAudioDevChanged之后调用)
RtcSDK.audioManager.openMic(myUserID);
// 开启外放
RtcSDK.audioManager.setSpeakerOut(true);
// 获取视频的相关配置
VideoCfg cfg = RtcSDK.videoManager.getVideoCfg();
//配置分辨率为640x360
cfg.size = VSize(640, 360);
//配置视频帧率
cfg.fps = 25;
// 保存视频配置到SDK
RtcSDK.videoManager.setVideoCfg(cfg);
相关 API 请参考:
相关结构定义请参考:
7. 观看他人视频
成功进入房间后,根据他人登录用户 id ,设置并观看他人视频图像
设置成员视频 UI 显示组件的相关摄像头 Id
// 创建成员视频 UI 显示组件
// 设置观看对方视频
RtcSDK.videoManager.getWatchableVideos().then((List<UsrVideoId> usrVideoIds) {
for (UsrVideoId uvi in usrVideoIds) {
if (uvi.userId != myUserID) {
Widget view = RtcSDK.videoManager.createView((viewID) {
RtcSDK.videoManager.setUsrVideoId(viewID, uvi);
});
}
}
});
相关 API 请参考:
相关结构定义请参考:
8. 退出房间
// 根据viewId删除创建的容器
RtcSDK.videoManager.destroyPlatformView(viewId);
// 离开房间
RtcSDK.roomManager.exitMeeting();
相关 API 请参考:
9. 注销登录
//注销本次登录
RtcSDK.sdkManager.logout();
相关 API 请参考:
10. 反初始化,退出SDK
执行反初始化后 SDK 功能不再可用。
//反初始化
RtcSDK.sdkManager.unInit();
相关 API 请参考: