实现音视频通话
简要说明
- 快速创建并进入房间,开始音视频通话;代码部分均为 C# 代码,详细代码请参考 APIDemo_Unity_Source 源代码。
准备环境
操作系统:Windows(64位)Vista 及以上操作系统
编译器:Unity 2021.3.33f1 或以上版本
集成SDK
1. 下载SDK
根据应用场景,从SDK下载中心下载获取最新 SDK,解压后将 CRVideoSDK 目录复制到 Unity 工程的 Assets 目录下
2. 初始化SDK
初始化是整个SDK的使用基础,通常在程序启动的时候进行初始化(create),退出后进行反初始化(uninitSDK),整个程序的生命周期中只进行一次初始化和反初始化。
//初始化 sdkUsePath 是SDK工作目录,用于存储配置文件、临时文件等。 如果传空值,则默认为程序的运行目录
string sdkAppPath = "";
CRVSDKMain g_sdkMain = CRVSDKMain.create(sdkAppPath);
/初始化失败则退出程序
if (g_sdkMain == null)
{
Debug.Log("Create SDK failed!"));
#if UNITY_EDITOR
UnityEditor.EditorApplication.isPlaying = false;
#else
Application.Quit();
#endif
}
设置回调函数
class MeetingPage
{
//登录结果回调
private void loginRslt(CRVSDK_ERR_DEF sdkErr, string cookie)
{
}
//通知掉线回调 可以弹出提示,或调用登录接口再次重试登录
private void notifyLineOff(CRVSDK_ERR_DEF sdkErr)
{
}
//创建房间成功
private void createMeetingSuccess(int meetid, string cookie)
{
}
//创建房间失败
private void createMeetingFail(CRVSDK_ERR_DEF sdkErr, string cookie);
//进入房间的完成响应
private void enterMeetingRslt(CRVSDK_ERR_DEF sdkErr);
...
//更多回调
...
private void initCallbacks()
{
if (null == g_sdkMain)
return;
g_sdkMain.onLoginRslt = loginRslt;
g_sdkMain.notifyLineOff = notifyLineOff;
g_sdkMain.onCreateMeetingSuccess = createMeetingSuccess;
g_sdkMain.onCreateMeetingFail = createMeetingFail;
g_sdkMain.onDestroyMeetingRslt = destroyMeetingRslt;
}
}
相关API请参考:
3. 登录连接视频服务器
设置视频服务器地址,然后使用appID和md5加密后的appSecret登录。(获取App ID及App Secret)
- 调用接口:
//如果使用云服务时填sdk.cloudroom.com,使用私有化部署的服务器时要填部署的服务器地址;此处以云服务为例。
sdkLoginDat loginDat = new sdkLoginDat();
loginDat._sdkAuthType = CRVSDK_AUTHTP_SECRET;
loginDat._appID = loginAppID;
//appSecret 需要进行md5加密传入进去
loginDat._md5_appSecret = CommonTools.MakeMd5(loginAppSecret);
loginDat._serverAddr = "sdk.cloudroom.com";
loginDat._webProtocol = CRVSDK_WEBPTC_HTTP;
loginDat._userID = loginUserID;
loginDat._nickName = loginUserID; //用户的昵称
//登录
g_sdkMain.login(loginDat);
- 回调通知:
//登录结果
private void loginRslt(CRVSDK_ERR_DEF sdkErr, string cookie)
{
//若失败 可以弹出错误提示,或调用登录接口再次重试登录
if (sdkErr != CRVSDK_ERR_DEF.CRVSDKERR_NOERR)
{
Debug.Log("Login failed, err: " + sdkErr);
return;
}
//若成功 可以进入房间或者创建房间,见第4步
Debug.Log("Login success");
}
//通知掉线 可以弹出提示,或调用登录接口再次重试登录
private void notifyLineOff(CRVSDK_ERR_DEF sdkErr)
{
Debug.Log("Server connection lost, reason: " + sdkErr);
}
相关API请参考:
4. 创建房间
- 调用接口:
//创建房间
g_sdkMain.createMeeting();
- 回调通知:
//创建房间成功 可以进入房间
private void createMeetingSuccess(int meetid, string cookie)
{
mMyMeetId = meetid;
}
//创建房间失败 可以弹出错误提示
private void createMeetingFail(CRVSDK_ERR_DEF sdkErr, string cookie)
{
Debug.Log("Create meeting failed, err: " + sdkErr);
}
相关API请参考:
5. 进入房间
用创建成功的房间信息(房间ID)进入房间,其他用户也是利用此房间信息进入该房间。
- 调用接口:
//进入房间
g_sdkMain.getSDKMeeting().enterMeeting(meetid);
- 回调通知处理:
//进入房间的完成响应
private void enterMeetingRslt(CRVSDK_ERR_DEF sdkErr)
{
//进入房间失败
if (sdkErr != CRVSDK_ERR_DEF.CRVSDKERR_NOERR)
{
Debug.Log("Fail to enter meeting, err: " + sdkErr);
return;
}
//进入房间成功,切换场景
SceneManager.LoadScene("MeetingScene", LoadSceneMode.Single);
}
//监控房间结束
private void notifyMeetingStopped()
{
Debug.Log("Meeting has stopped!"));
SceneManager.LoadScene("LoginScene", LoadSceneMode.Single);
}
相关API请参考:
6. 打开麦克风/摄像头
进入房间成功后,打开自己的麦克风和摄像头,以便本地、远端显示自己的视频图像
//打开自己的麦克风
g_sdkMain.getSDKMeeting().openMic(mMyUserId);
//打开自己的摄像头
g_sdkMain.getSDKMeeting().openVideo(mMyUserId);
相关API请参考:
7. 观看自己/他人视频
成功进入房间后,根据自己/他人登录id ,设置并观看其视频图像
- 创建 VideoUI 控件,绑定 UserVideoID,手动开启/关闭图像绘制
GameObject go = new GameObject();
if (go == null)
return null;
go.name = objName;
go.AddComponent<RawImage>();
GameObject canvas = GameObject.Find("MeetingCanvas");
if (canvas != null)
{
go.transform.SetParent(canvas.transform);
}
// 移动到对应位置
Rect canvasRt = canvas.GetComponent<Canvas>().pixelRect;
float xPos = 120 - canvasRt.width / 2f;
float yPos = canvasRt.height / 2f - videoHeight / 2f;
go.transform.localPosition = new Vector3(xPos, yPos, 0);
go.transform.localScale = new Vector3(3.2f, 1.8f, 1f);
VideoUI vUI = go.AddComponent<VideoUI>();
vUI.SetSDKMain(g_sdkMain);
// 观看自己的视频
sdkUserVideoID myVID = new sdkUserVideoID(mMyUserId);
vUI.UserInfo = myVID;
vUI.SetEnableRender(true);
//从会议中取到所有参数者,然后按业务逻辑选取想观看他人视频;(以下代码是随机选取一个非自已的视频)
MeetingMemberList allMembers = g_sdkMain.getSDKMeeting().getAllMembers();
for (var obj = allMembers.First; obj != null; obj = obj.Next)
{
sdkMeetingMember mem = obj.Value;
if (mem._userId != mMyUserId)
{
sdkUserVideoID otherID = new sdkUserVideoID(mem._userId);
vUI.UserInfo = otherID;
vUI.SetEnableRender(true);
break;
}
}
8.退出房间
//退出房间
g_sdkMain.getSDKMeeting().exitMeeting();
相关API请参考:
9. 注销登录
//注销本次登录
g_sdkMain.logout();
相关API请参考:
10.反初始化,退出SDK
执行反初始化后SDK功能不再可用。
//反初始化
g_sdkMain.uninitSDK();
g_sdkMain = null;
相关API请参考: