Skip to end of metadata
Go to start of metadata

WRTC web application allows you to use the basic call as well as some advanced functionalities as listed below:

Basic Browser to Browser Communication

Advanced Browser to Browser Communication

It supports cross browser functionality which allows you to communicate with other WRTC users using different web browsers, such as Microsoft IE and Apple Safari with Temasys plug-ins.

WRTC web application also allows you to perform Browser-to-SIP communication. For more information, refer Browser-to-SIP Communication.

Browser-to- Browser IM

Browser-to-browser IM in WRTC is established using WebSocket protocol. Users can initiate an IM session with others users available over an IP network to send or receive messages and emoticons. A user can close the IM session at any time during the session. Perform the following steps to begin an IM conversation with a user:

  1. On the WebRTC login page, perform the following steps to login to the WRTC:
    1. Select the supported brokered authentication from the list for example, your Gmail user account information and then, click Sign In. You can also login as Anonymous user or select the following authentication methods:

      Tool Tip is added to retrieve detail information of each field in the UC app.

      Figure : WRTC Login Page

    2. Enter the WRTC server IP or FQDN in the Enter WRTC Server FQDN field, and Statistics server IP or FQDN in Enter STATS Server FQDN field on the settings page.
    3. Click Save to save the WRTC server IP or FQDN and Statistics server IP or FQDN.

      Statistics server IP or FQDN is required to fetch media-related statistics.

      Figure : Setting page

       

      You will be redirected to the WRTC web application Home page. Also, you will be assigned a registered contact number to make outgoing and incoming calls.

      Figure : WRTC_login

       

  2. Click  icon.

    A popup appears:

    Figure : Communication Options

  3. Enter the user information like email ID and click Chat.
    The IM Window appears:

    Figure : IM Popup

  4. Enter your message in the text box and press Enter to send the message to the user.
    The sent and received messages will appear in the IM window:

    Figure : Caller and Callee IM Windows

  5. Click  or  icon to close the IM window. Following are the messages that appear when a call is rejected by caller and callee before it is established:

    Figure : Call Reject Message

    When a callee rejects the call, following message is displayed to the caller:

    When a caller disconnects the call before the call being established, following message is displayed to the callee:

Upgrading From IM to Audio or Video Call

At any time during an IM session, you can upgrade the IM to audio or video call. Perform the following steps to upgrade to audio or video call:

  1. Click  icon to upgrade to audio call.
    Once the Caller upgrades to audio call, the Callee receives a confirmation alert message:

    Figure : Audio Call Upgrade Alert for Callee

    To upgrade the IM session to audio call, the Callee can click the Audio option.

  2. Click  icon to upgrade an IM session to a video call.
    IM participant receives an alert message:

    Figure : Video Call Upgrade Alert for Callee

    To upgrade the IM session to video call, the Callee can click the Video option.

The audio or video call, and IM will end if any of the participants (caller or the callee) ends the call by clicking the  or icon.

  • If the participant rejects to upgrade from IM to audio or video call by clicking Cancel. The caller will get the following message:

    Figure : Upgrade Cancelled Message

Browser-to-Browser Audio and Video Calls

After logging into WRTC web application you can make video calls or voice only calls to other WRTC users. WRTC supports the browser related video and voice codecs; the media policy configured on WRTC decides which codec must be used, by default WRTC uses Opus codec for voice. You can cancel a call even before it is established and during a call either the caller or the callee can end the call. The caller or the callee can also put an active call on hold, mute the microphone, and view the video in full screen mode and so on. You can also transfer calls by inviting the other user to the call and dropping out of the conference.

Audio Calls

Perform the following steps to make an audio only call:

  1. Click  icon.
    A popup appears:

    Figure : Communication Options

  2. Enter the callee information like email ID and click Audio.

    A popup details the call information:

    Figure : Caller and Callee Audio Call Windows

    Caller Screen

    Callee Screen

    A call is established only when the callee clicks  icon to answer the call.

    The call options available to manage an established call are as follows:

    • Voice Mute: this option will mute the microphone preventing any noise or disturbance during a call but allows the user to listen. Click  icon to mute a call and  icon to unmute.

    • Video Mute: this option will pause the video relay to the other users in a video call. Click  icon to pause the video relay and  icon to resume. When you mute the video the video display at the bottom right of the WRTC page will go blank and the other users will get a paused image. WRTC also allows you to capture screens of the video, click  icon to capture the screen.

    • Call Hold: this option allows you to put a call on hold where the video and voice streams do not send or receive any data packets to the users; click  icon to put a call on hold and  icon to resume the call.

    • Call Transfer: this option allows you to transfer the call to another user, by transferring the call to another user you will be automatically dropped from the call; click  icon to transfer the call.
    • Desktop Share: this option allows you to share your desktop with other user; click  icon to share the desktop.
    • Dial Pad: this option allows you to dial number to call other WRTC users; click  icon to switch over to dial pad option.
    • End Call: this option ends an active call; click  icon to end the call.

     

  3. Enter your message in the text box and press Enter to simultaneously chat during an audio only call.

Upgrading from Audio Call to Video Call

At any time during an audio call, you can upgrade the call to a video call by clicking the  icon in the call window. You can also downgrade from a video call by clicking the  icon.

An error message is displayed if the participant rejects to upgrade the call by clicking Cancel.

Video Calls

Perform the following steps to make a video call in WRTC web application:

  1. Click  icon.
    A popup appears:

    Figure : Communication Options

    Enter the callee information like email ID and click Video.

    The callee must click   icon to answer the call. Once the video call is established, the following WRTC page appears:

    Figure : Caller and Callee Video Call Information

    Caller Screen

     

    Callee Screen

    The call options available to manage an established video call are as follows:

    • Voice Mute: this option will mute the microphone preventing any noise or disturbance during a call but allows the user to listen. Click  icon to mute a call and  icon to unmute.

    • Video Mute: this option will pause the video relay to the other users in a video call. Click  icon to pause the video relay and  icon to resume. When you mute the video the video display at the bottom right of the WRTC page will go blank and the other users will get a paused image. WRTC also allows you to capture screens of the video, click  icon to capture the screen.

    • Call Hold: this option allows you to put a call on hold where the video and voice streams do not send or receive any data packets to the users; click  icon to put a call on hold and  icon to resume the call.

    • Call Transfer: this option allows you to transfer the call to another user, by transferring the call to another user you will be automatically dropped from the call; click  icon to transfer the call.
    • Desktop Share: this option allows you to share your desktop with other user; click  icon to share the desktop.
    • Dial Pad: this option allows you to dial number to call other WRTC users; click  icon to switch over to dial pad option.
    • End Call: this option ends an active call; click  icon to end the call.

  2. Enter your message in the text box and press Enter to simultaneously chat during a video call.

For information on screen and file sharing during a call, see Screen and File Sharing.

Automatic Media Update

In one way communication, if the caller upgrades to video not necessary the callee needs to upgrade to video. The callee can still be in the audio mode.

Similarly, if the caller downgrades to audio call in one way communication then, the callee may or may not downgrade to audio mode. The callee can still be in video mode as shown in the following figure.

Figure : Upgrade and Downgrade in one way communication

In case of automatic media update in two way communication, if both the caller and the callee clicks User Configuration settings and selects the Allow Automatic Media Update option then, the callee automatically gets upgraded to video mode once the caller is upgraded to video mode and vice versa. The same applies to downgrading the call from video to audio call.

Figure : Automatic Media Update

Figure : Automatic Upgrade to Video Calls

Caller Screen Upgraded to Video

Callee Screen Automatically Gets Upgraded to Video

"Allow Automatic Media Update " is not applicable for web-sip calls.

Transferring Audio or Video Calls

You can transfer an active call between two users to another available WRTC user. Perform the following steps to transfer a call in WRTC:

  1. Click  icon to transfer the audio or video call.
    A popup appears:

    Figure : Call Transfer popup

  2. Enter the email ID of the user to whom the audio or video call must be transferred.
  3. Click Transfer Call.
    Once the user to whom the call is transferred clicks the  icon and joins the call the user transferring, the call will be automatically dropped from the call. For example, consider wrtc user1 is calling wrtc user2 and both are engaged in a conversation. WRTC user2 then transfers the call to wrtc user3. When wrtc user3 answers the call, wrtc user2 would automatically be dropped out of the conversation while the users1 and 3 would be engaged in the conversation.

    Figure : Call Transfer Window

Multiple Points of Presence

Transferring Call to Another Device

You can transfer an active call to another device that you have logged in with the same user Id. Perform the following steps to transfer an active call to another device:

  1. When you log into multiple devices with the same credentials, you can view the OS type, browser name, and last 4 digits of the peer devices in the "Other Device" drop-down list.

    Figure : Peer Device Information

  2. Select the device you want to transfer the active call from the "Other Device" drop-down list, and click Transfer  icon to transfer the audio or video call.

    Figure : Select Transfer Device


    The device selected to transfer the call now receives an incoming call from the originator.

    Figure : Call Getting Transferred

  3. Once the user to whom the call is transferred clicks the  icon and joins the call, the device transferring the call will be automatically dropped from the call from the conversation.

    Figure : Successful Call Transfer

  4. Once a session is established, the peer device gets the information of this active session in the same drop-down as shown in the following figure:

    Figure : Two Party Call Status

    The call status information is seen in the peer device for browser to browser two party call, group chat, conference, call transfer, device transfer, call pickup, and calls from SIP endpoint to browser.

Call Pickup

You can pickup an ongoing call from another device that you have logged in with the same user Id. Perform the following steps to pickup an active call from another device:

  1. Select the device you want to transfer the active call and click Pickup icon to transfer the audio or video call.

    Figure : Select Call Pickup Device

  2. The device selected to pick the call now receives an incoming call from the originator. At this point, if screen or file sharing is in progress, then it would be canceled.

    Figure : Successful Call Pickup

Browser-to-Browser Communication Using Data Channel

Similar to a conventional browser-to-browser communication, Sonus WebRTC allows you to communicate with other WebRTC users through data channel. The data transmission is carried out through data channels without interacting with any web servers. You can also transfer files, upgrade a IM through data channel to an audio call or a video call.

You must select Enable data channel option from the settings before communication using data channel.

WRTC SDK supports data transmission in any raw format over the data channel with senddata  API.

Perform the following steps to establish a data call through data channel with other WRTC user:

  1. Click  icon.

    A popup appears:

    Figure : Communication Options

  2. Enter the user information like email ID and click Data.

    Figure : Data Call Through Data Channel

    Caller Screen

    Callee Screen

    The call options available are similar to the conventional browser to browser call options, except that call hold option is not available for communications through data channel.

     

  3. Enter your message in the text box and press Enter to send the message to the user.

    Figure : IM through Data Channel Call

Upgrading from IM to Audio or Video Call

Similar to the conventional IM, you can upgrade it to audio or video call by clicking the  or  icon in the call window.

  • You can also downgrade from a video call by clicking the  icon.
  • An error message is displayed if the participant rejects to upgrade the call by clicking Cancel.

Data Channel Pass Through

Data Channel Pass through allows WRTC user to send any data over data channel which is not necessarily in JSON object format.

Perform the following steps to send data through data channel with Data Channel Pass Through flag enabled in an active session.

  1. Enable Data Channel Pass Through flag before establishing an audio or video call over data channel.

    Figure : Configuration Settings

  2. Establish an audio or a video call with another WRTC user over data channel.

    Figure : Active Call Through Data Channel

  3. Enable the Send Data flag while the call session is active to send data through the Data channel block.

    Figure : Send Data Enabled

  4. A notification is send to the callee.

    Figure : Notification

  5. When the data is received the callee views it in the Data channel block in call div, and an acknowledgement message is sent for the received message.

    Figure : Acknowledgement