

Voice Call v4.0.0 Beta





Start a Video Call

Last updated 2022/09/27 02:40:00

Real-time video chatting immerses people in the sights and sounds of human connections, keeping them engaged in your app longer.

This page shows the minimum code you need to integrate high-quality, low-latency Video Call function into your app using the Video SDK.

Understand the tech

The following figure shows the workflow you need to integrate into your app in order to achieve Video Call functionality.

To start video call, implement the following steps in your app:

1. Set the role

Set both app clients as the host.

2. Join a channel

Call joinChannel to create and join a channel. When using the same App ID, users who pass in the same channel name enter the same channel.

3 and 4. Publish and subscribe to audio and video in the channel

After joining a channel, both hosts can publish video and audio stream to the channel and subscribe to each other.

Prerequisites

Microsoft Visual Studio 2017 or later
A Windows device running Windows 7 or later
C++ 11 or higher
A valid Agora account. (Sign up for free)
A computer that can access the Internet. Ensure that no firewall is deployed in your network environment, otherwise the project fails.
A valid Agora account and an Agora project, please refer to Start using the Agora platform and get the following information from Agora Console:
- The App ID: A randomly generated string provided by Agora for identifying your app.
- A temporary token: A token is the credential that authenticates a user when your app client joins a channel. A temporary token is valid for 24 hours.
- The channel name: A string that identifies the channel.

Project setup

In order to create the environment necessary to integrate Video Call into your app, do the following:

Create a Windows project

See Create a C++ console app project to create a C++ console app on Visual Studio.

Integrate the SDK

Follow these steps to integrate the Agora Video SDK into your project.

Go to SDK Downloads, download the latest version of the Agora SDK, and unzip the downloaded SDK package.
Copy the x86 or x86_64 folder of the downloaded SDK package to your project files according to your development environment.

Configure the project properties

Right-click the project name in the Solution Explorer window, click Properties to configure the following project properties, and click OK.

Go to the C/C++ > General > Additional Include Directories menu, click Edit, and input $(SolutionDir)include in the pop-up window.
Go to the Linker > General > Additional Library Directories menu, click Edit, and input $(SolutionDir) in the pop-up window.
Go to the Linker > Input > Additional Dependencies menu, click Edit, and input agora_rtc_sdk.dll.lib in the pop-up window.

Implement a client for Video Call

The following figure shows the API call sequence of the video call.

Create the UI

Create the user interface (UI) for the video call in your project. Skip to Initialize IRtcEngine if you already have an UI in your project.

If you are implementing the video call, we recommend adding the following elements into the UI:
- The view of the host
- The exit button
When you use the UI setting of the sample project, you can see the following interface:

Initialize IRtcEngine

Create and initialize the IRtcEngine object before calling any other Agora APIs.

Call the createAgoraRtcEngine method and the initialize method, and pass in the App ID to initialize the IRtcEngine object.

You can also listen for callback events, such as when the local user joins or leaves the channel.

// Create Rtc engine.
m_lpAgoraEngine = createAgoraRtcEngine();
RtcEngineContext ctx;

// Add the register events and callbacks.
ctx.eventHandler = &m_engineEventHandler;

// Input your App ID.Fill the App ID of your project generated on Agora Console.
ctx.appId = "Your App ID";

// Initialize the IRtcEngine object.
m_lpAgoraEngine->initialize(ctx);

// Inherit the events and callbacks of IRtcEngineEventHandler.
class CAGEngineEventHandler :
    public IRtcEngineEventHandler
{
public:
    CAGEngineEventHandler();
    ~CAGEngineEventHandler();
    void setMainWnd(HWND wnd);
    HWND GetMsgReceiver() {return m_hMainWnd;};

    // Listen for the onJoinChannelSuccess callback.
    // This callback occurs when the local user successfully joins the channel.
    virtual void onJoinChannelSuccess(const char* channel, uid_t uid, int elapsed);

    // Listen for the onLeaveChannel callback.
    // This callback occurs when the local user successfully leaves the channel.
    virtual void onLeaveChannel(const RtcStats& stat);

    // Listen for the onUserJoined callback.
    // This callback occurs when the remote host successfully joins the channel.
    // After receiving this callback, immediately call setupRemoteVideo to set the remote video view.
    virtual void onUserJoined(uid_t uid, int elapsed) override;

    // Listen for the onUserOffline callback.
    // This callback occurs when the remote host leaves the channel or drops offline.
    virtual void onUserOffline(uid_t uid, USER_OFFLINE_REASON_TYPE reason);
private:
    HWND m_hMainWnd;
};

Set the local video view

After setting the channel profile and client role, set the local video view before joining the channel so that the host can see the local video in the video call. Follow these steps to configure the local video view:

// Enable the video module.
m_lpAgoraEngine->enableVideo();
// Start local preview.
m_lprtcEngine->startPreview();

// Set the local video view.
VideoCanvas vc;
vc.uid = 0;
vc.view = hVideoWnd;
vc.renderMode = RENDER_MODE_TYPE::RENDER_MODE_HIDDEN;
m_lpAgoraEngine->setupLocalVideo(vc);

Join the channel

Set channel profile and client role and join the channel by a temp token.

ChannelMediaOptions options;
// For a video call scenario, set the channel profile as BROADCASTING.
options.channelProfile = CHANNEL_PROFILE_LIVE_BROADCASTING;
// Set both clients as the BROADCASTER.
options.clientRoleType = CLIENT_ROLE_BROADCASTER;

// Join channel with a temp token that you generate on Agora Console.
BOOL CAgoraObject::JoinChannel("Your token", LPCTSTR lpChannelName, 0, options)
{
    int nRet = 0;
    LPCSTR lpStreamInfo = "{\"owner\":true,\"width\":640,\"height\":480,\"bitrate\":500}";
#ifdef UNICODE
    CHAR szChannelName[128];
    ::WideCharToMultiByte(CP_ACP, 0, lpChannelName, -1, szChannelName, 128, NULL, NULL);
       if (nRet == 0)
        m_strChannelName = lpChannelName;
    return nRet == 0 ? TRUE : FALSE;
}

Set the remote video view

Shortly after a remote host joins the channel, the SDK gets the host's user ID in the onUserJoined callback. Call the setupRemoteVideo method in the callback and pass in the uid to set the video view of the host.

// Listen for the onUserJoined callback.
// After receiving this callback, immediately call setupRemoteVideo to set the remote video view.
void CAGEngineEventHandler::onUserJoined(uid_t uid, int elapsed)
{
    LPAGE_USER_JOINED lpData = new AGE_USER_JOINED;

    lpData->uid = uid;
    lpData->elapsed = elapsed;

    if(m_hMainWnd != NULL)
        ::PostMessage(m_hMainWnd, WM_MSGID(EID_USER_JOINED), (WPARAM)lpData, 0);
}

VideoCanvas canvas;
canvas.renderMode = RENDER_MODE_FIT;
POSITION pos = m_listWndInfo.GetHeadPosition();
......
AGVIDEO_WNDINFO &agvWndInfo = m_listWndInfo.GetNext(pos);
canvas.uid = agvWndInfo.nUID;
canvas.view = m_wndVideo[nIndex].GetSafeHwnd();
agvWndInfo.nIndex = nIndex;

// Set the remote video view.
CAgoraObject::GetEngine()->setupRemoteVideo(canvas);

Leave the channel

Call the leaveChannel method to leave the current channel according to your scenario, for example, when the video call ends, when you need to close the app, or when your app runs in the background.

void CLiveBroadcastingDlg::UnInitAgora()
{
 if (m_rtcEngine) {
     if(m_joinChannel)
     // Leave the current channel.
     m_rtcEngine->leaveChannel();
     m_lstInfo.InsertString(m_lstInfo.GetCount(), _T("leaveChannel"));
     // Stop local preview.
     m_rtcEngine->stopPreview();
     m_lstInfo.InsertString(m_lstInfo.GetCount(), _T("stopPreview"));
     // Disable video module.
     m_rtcEngine->disableVideo();
     m_lstInfo.InsertString(m_lstInfo.GetCount(), _T("disableVideo"));
     // Release the IRtcEngine object.
     m_rtcEngine->release(true);
     m_lstInfo.InsertString(m_lstInfo.GetCount(), _T("release rtc engine"));
     m_rtcEngine = NULL;
 }
}

Next steps

In a test or production environment, use a token server to generate token is recommended to ensure communication security, see Authenticate Your Users with Tokens for details.