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 macOS. 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 ZMVideoSDK.sharedVideoSDK()?.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 client.join().
if let phoneHelper = ZMVideoSDK.sharedVideoSDK()?.getPhoneHelper() {
    phoneHelper.invite(byPhone: "+1", phoneNumber: "123123123", name: "Alice")
}
ZMVideoSDKPhoneHelper *phoneHelper = [[ZMVideoSDK sharedVideoSDK] getPhoneHelper()];
[phoneHelper inviteByPhone:@"+1" phoneNumber:@"123123123" name:@"Alice"];

Receive call status

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

public func onInvite(by status: ZMPhoneStatus, fail reason: ZMPhoneFailedReason) {
    print("Current invitation status: \(status) and reason of failure: \(reason)")
}
- (void)onInviteByPhoneStatus:(ZMPhoneStatus)status reason:(ZMPhoneFailedReason)reason {
    NSLog(@"Current invitation status: %@ and reason of failure: %@", @(status), @(reason));
}