实现音视频通话
简要说明
- 快速创建并进入房间,开始音视频通话;以下均为Java代码,详细代码请参考Examples目录下Demo源代码。
- 请先完成开发环境准备,并确认音视频设备工作正常。
1. 初始化SDK
初始化是整个SDK的使用基础,通常在程序启动的时候进行初始化(init),退出的时候进行反初始化(uninit),整个程序的生命周期中只进行一次初始化和反初始化。
SDK内部的组件多为单例组件,整个程序中只能有一个实例,比如“基础组件”,“房间管理组件”,“视频房间组件”,具体请参见各个组件说明。
// SDK初始化数据对象,默认为https
SdkInitDat initDat = new SdkInitDat();
// SDK初始化数据对象,http配置
SdkInitDat initDat = new SdkInitDat();
initDat.datEncType = "0";
initDat.params.put("VerifyHttpsCert", "0");
// 初始化SDK
RTCSDK.getInstance().init(getApplicationContext(), initDat);
相关API请参考:
相关结构定义请参考:
2. 硬件加速视频渲染
通过设置视频控件相关的窗口进行硬件加速,利用手机硬件GPU来提升界面的渲染效果
AndroidManifest.xml配置文件:
<activity
android:name=".VideoMeetingActivity"
android:hardwareAccelerated = "true"
</activity>
注意:配置硬件加速可能导致某些机型上非视频控件显示不正常,需要关闭其他控件的硬件加速:
noUIVideoLayout.setLayerType(View.LAYER_TYPE_SOFTWARE, null);
3. 登录连接视频服务器
设置视频服务器地址,使用AppID、AppSecret和自定义用户编号登录(走https时不校验服务器SSL验证书)
- 调用接口:
// 设置服务器地址
RTCSDK.getInstance().setServerAddr(server);
// 登录数据对象
LoginDat loginDat = new LoginDat();
// 昵称
loginDat.nickName = nickName;
// 用户ID
loginDat.privAcnt = userID;
// appID,使用开通SDK的账号
loginDat.authAcnt = appID;
// appSecret必须做MD5处理
loginDat.authPswd = appSecret;
// 执行登录操作
RTCMgr.getInstance().login(loginDat);
- 回调通知:
// 登陆失败
@Override
public void loginFail(CRVIDEOSDK_ERR_DEF sdkErr, String cookie) {
}
// 登陆成功
@Override
public void loginSuccess(String usrID, String cookie) {
}
//掉线
@Override
public void lineOff(CRVIDEOSDK_ERR_DEF sdkErr) {
}
相关API请参考:
4. 创建房间
创建一个房间
- 调用接口:
// 创建房间
RTCMgr.getInstance().createMeeting(cookie);
- 回调通知:
// 创建房间成功
@Override
public void createMeetingSuccess(MeetInfo meetInfo, String cookie) {
}
// 创建房间失败
public void createMeetingFail(CRVIDEOSDK_ERR_DEF sdkErr, String cookie) {
}
相关API请参考:
5. 进入房间
用创建成功的房间ID进入房间,其他用户也是利用此房间信息进入该房间。
- 调用接口:
RTCMeeting.getInstance().enterMeeting(meetInfo.ID, nickname)
- 回调通知:
@Override
public void enterMeetingRslt(CRVIDEOSDK_ERR_DEF code) {
if (code == CRVIDEOSDK_NOERR) {
//进入房间成功
} else if (code == CRVIDEOSDK_MEETROOMLOCKED) {
// 房间已加锁
} else {
//进入房间失败
}
}
相关API请参考:
6. 打开麦克风/摄像头
紧接第4步,进入房间成功后,打开自己的麦克风和摄像头,以便本地、远端显示自己的视频图像
// 打开摄像头
RTCMeeting.getInstance().openVideo(myUserID);
// 打开麦克风
RTCMeeting.getInstance().openMic(myUserID);
// 开启外放
RTCMeeting.getInstance().setSpeakerOut(true);
// 获取摄像头的相关配置
VideoCfg cfg = RTCMeeting.getInstance().getVideoCfg();
//配置分辨率为640x360
cfg.size = new Size(640, 360);
//配置码率为默认
cfg.maxbps = -1;
// 保存摄像头配置到SDK
RTCMeeting.getInstance().setVideoCfg(cfg);
相关API请参考:
相关结构定义请参考:
7. 观看他人视频
成功进入房间后,根据他人登录用户id ,设置并观看他人视频图像
创建成员视频UI显示组件
<RelativeLayout
android:layout_width="match_parent"
android:layout_height="match_parent"
android:tag="1v1" >
<com.rtc.sdk.VideoUIView
android:id="@+id/video_self"
android:layout_width="match_parent"
android:layout_height="match_parent" />
<com.rtc.sdk.VideoUIView
android:id="@+id/video_peer"
android:layout_width="160dp"
android:layout_height="90dp"
android:layout_alignParentBottom="true"
android:layout_alignParentRight="true" />
</RelativeLayout>
获取成员视频UI显示组件
VideoUIView mOtherYuv = (VideoUIView)findViewById(R.id.yuv_other);
设置成员视频UI显示组件的相关摄像头Id
// 一对一视频情况下 观看他人的摄像头视频
VideoUIView selfView = (VideoUIView) findViewById(R.id.video_self);
//-1表示观看默认摄像头
selfView.setUsrVideoId(new UsrVideoId(myUserId, (short)-1);
//设置观看对方视频
VideoUIView peerView = (VideoUIView) findViewById(R.id.video_peer);
//可以从会议中取到所有参数者,然后按业务逻辑选取想观看他人视频;(以下代码是随机选取一个非自已的视频)
ArrayList<MemberInfo> allMembers = getAllMembers();
for (MemberInfo memb : allMembers) {
if (!memb.userId.equals(myUserId))
{
peerView.setUsrVideoId(memb.userId);
break;
}
}
相关API请参考:
相关结构定义请参考:
8. 退出房间
// 离开房间
RTCMeeting.getInstance().exitMeeting();
相关API请参考:
9. 注销登录
//注销本次登录
RTCMgr.getInstance().logout();
相关API请参考:
10. 反初始化,退出SDK
执行反初始化后SDK功能不再可用。
//反初始化
RTCSDK.getInstance().unInit();
相关API请参考: