音视频通话

实现音视频通话

基本步骤如下:

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 请参考: