Public Switched Telephone Network (PSTN)

The Video SDK call out feature allows users to join Video SDK sessions completely over the phone or use their phone as the audio connection to the session while viewing the Video on Windows. This is useful when:

  • You do not have a microphone or speaker on your computer.
  • You do not have an iOS or Android smartphone.
  • You cannot connect to a network for a video session with computer audio (VoIP).

See Customize audio conferencing for details.

Prerequisites

Make a call

Use video_sdk_obj->getPhoneHelper(); to make a call.

  • Provide the name if the user will join completely by phone.
  • If the user is already connected to the session, but wants to use their phone for the audio portion, the name will default to the name provided in the session_context.
IZoomVideoSDKPhoneHelper* m_phonehelper= video_sdk_obj->getPhoneHelper();
if (m_phonehelper->isSupportPhoneFeature()){
    m_phonehelper->inviteByPhone(L"+1",L"2025550176",L"Alice");
}

Get call status

Use getInviteByPhoneStatus to find out about the status of the call, for example, ringing, accepted, hangup, etc.

IZoomVideoSDKPhoneHelper* m_phonehelper= video_sdk_obj->getPhoneHelper();
m_phonehelper.getInviteByPhoneStatus();

Receive call status

You can receive the call status and failure reason under the onInviteByPhoneStatus callback under IZoomVideoSDKDelegate.

virtual void onInviteByPhoneStatus(PhoneStatus status, PhoneFailedReason 	reason) {
	printf("Current invitation status: %s\n",status);
printf("Reason of failure: %s\n",reason);
};