音视频通话

实现音视频通话

简要说明

  • 快速创建并进入房间,开始音视频通话;代码部分均为 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请参考: