+44 20 3695 6215
+44 20 3695 6215

VIClient

Interface that may be used to connect and login to Voximplant Cloud, make and receive audio/video calls.

Methods(21)

Properties(5)

Methods

call:settings:

- (nullable VICall *)call:(NSString *)number
                 settings:(VICallSettings *)settings

Create a new call instance. Call must be then started using [VICall start].

Parameters

  • number:

    NSString *

    SIP URI, username or phone number to make call to. Actual routing is then performed by VoxEngine scenario.

  • settings:

    VICallSettings *

    Call settings with additional call parameters, such as preferred video codec, custom data, extra headers etc.

Returns

  • Return:

    nullable VICall *

    Call instance or nil if client is not logged in or user is nil

callConference:settings:

- (nullable VICall *)callConference:(NSString *)conference
                           settings:(VICallSettings *)settings

Create call to a dedicated conference without proxy session. Call must be then started using [VICall start]. For details see the video conferencing guide.

Parameters

  • conference:

    NSString *

    The number to call. For SIP compatibility reasons it should be a non-empty string even if the number itself is not used by a Voximplant cloud scenario.

  • settings:

    VICallSettings *

    Call settings with additional call parameters, such as preferred video codec, custom data, extra headers etc.

Returns

  • Return:

    nullable VICall *

    Call instance or nil if client is not logged in or conference is nil

clientVersion

+ (NSString *)clientVersion

Get client version.

Returns

  • Return:

    NSString *

    Voximplant Client version.

connect

- (BOOL)connect

Connect to Voximplant Cloud.

Returns

  • Return:

    BOOL

    YES if the attempt to connect can be performed, NO otherwise. Return value "NO" means that the connection to Voximplant Cloud is currently establishing or already established. In this case please check the current client state via [VIClient clientState] property and proceed according to the current state.

connectWithConnectivityCheck:gateways:

- (BOOL)connectWithConnectivityCheck:(BOOL)connectivityCheck
                            gateways:(nullable NSArray *)gateways

Connect to Voximplant Cloud.

Parameters

  • connectivityCheck:

    BOOL

    Checks whether UDP traffic will flow correctly between device and Voximplant Cloud. This check reduces connection speed.

  • gateways:

    nullable NSArray *

    Array of server names of particular media gateways for connection.

Returns

  • Return:

    BOOL

    YES if the attempt to connect can be performed, NO otherwise. Return value NO means that the connection to Voximplant Cloud is currently establishing or already established. In this case please check the current client state via [VIClient clientState] property and proceed according to the current state.

disconnect

- (void)disconnect

Disconnect from Voximplant Cloud.

handlePushNotification:

- (nullable NSUUID *)handlePushNotification:(NSDictionary *)notification

Handle incoming push notification.

Parameters

Returns

  • Return:

    nullable NSUUID *

    CallKit UUID if the push notification was received from the Voximplant Cloud, nil otherwise. CallKit UUID matches [VICall.callKitUUID] only for the incoming call this push notification was sent for. CallKit UUID may be used to match CXCall and VICall instances.

initWithDelegateQueue:

- (instancetype)initWithDelegateQueue:(dispatch_queue_t)queue

Initialize client instance.

Parameters

  • queue:

    dispatch_queue_t

    All delegates methods will be called in this queue. Queue should be serial, but not concurrent (main queue is applicable).

Returns

  • Return:

    instancetype

    Client instance.

initWithDelegateQueue:bundleId:

- (instancetype)initWithDelegateQueue:(dispatch_queue_t)queue
                             bundleId:(nullable NSString *)bundleId

Initialize client instance.

You need to use this only if you are going to send push notifications across several iOS apps using a single Voximplant application.

Parameters

  • queue:

    dispatch_queue_t

    All delegates methods will be called in this queue. Queue should be serial, but not concurrent (main queue is applicable).

  • bundleId:

    nullable NSString *

    Application bundle id

Returns

  • Return:

    instancetype

    Client instance.

loginWithUser:oneTimeKey:success:failure:

- (void)loginWithUser:(NSString *)user
           oneTimeKey:(NSString *)oneTimeKey
              success:(nullable VILoginSuccess)success
              failure:(nullable VILoginFailure)failure

Login to Voximplant Cloud using one time key.

Parameters

  • user:

    NSString *

    Full user name, including app and account name, like someuser@someapp.youraccount.voximplant.com.

  • oneTimeKey:

    NSString *

    Hash that was generated using following formula:

    MD5(oneTimeKey+"|"+MD5(user+":voximplant.com:"+password))

    Please note that here user is just a user name, without app name, account name or anything else after "@".

    So if you pass myuser@myapp.myacc.voximplant.com as a username, you should only use myuser while computing this hash.

  • success:

    nullable VILoginSuccess

    Completion handler triggered if operation is completed successfully.

    typedef void (^VILoginSuccess)(NSString *displayName, VIAuthParams *authParams);
    • displayName: Display name of logged in user.
    • authParams: Auth parameters that can be used to login using access token.

  • failure:

    nullable VILoginFailure

    Completion handler failure triggered if operation is failed.

    typedef void (^VILoginFailure)(NSError *error);

loginWithUser:password:success:failure:

- (void)loginWithUser:(NSString *)user
             password:(NSString *)password
              success:(nullable VILoginSuccess)success
              failure:(nullable VILoginFailure)failure

Login to Voximplant Cloud using password.

Parameters

  • user:

    NSString *

    Full user name, including app and account name, like someuser@someapp.youraccount.voximplant.com.

  • password:

    NSString *

    User password.

  • success:

    nullable VILoginSuccess

    Completion handler triggered if operation is completed successfully.

    typedef void (^VILoginSuccess)(NSString *displayName, VIAuthParams *authParams);
    • displayName: Display name of logged in user.
    • authParams: Auth parameters that can be used to login using access token.

  • failure:

    nullable VILoginFailure

    Completion handler failure triggered if operation is failed.

    typedef void (^VILoginFailure)(NSError *error);

loginWithUser:token:success:failure:

- (void)loginWithUser:(NSString *)user
                token:(NSString *)token
              success:(nullable VILoginSuccess)success
              failure:(nullable VILoginFailure)failure

Login to Voximplant Cloud using access token.

Parameters

  • user:

    NSString *

    Full user name, including app and account name, like someuser@someapp.youraccount.voximplant.com.

  • token:

    NSString *

    Access token obtained from authParams.

  • success:

    nullable VILoginSuccess

    Completion handler triggered if operation is completed successfully.

    typedef void (^VILoginSuccess)(NSString *displayName, VIAuthParams *authParams);
    • displayName: Display name of logged in user.
    • authParams: Auth parameters that can be used to login using access token.

  • failure:

    nullable VILoginFailure

    Completion handler failure triggered if operation is failed.

    typedef void (^VILoginFailure)(NSError *error);

refreshTokenWithUser:token:result:

- (void)refreshTokenWithUser:(NSString *)user
                       token:(NSString *)token
                      result:(nullable VIRefreshTokenResult)result

Perform refresh of login tokens required for login using access token.

Parameters

  • user:

    NSString *

    Full user name, including app and account name, like someuser@someapp.youraccount.voximplant.com.

  • token:

    NSString *

    Refresh token obtained from authParams.

  • result:

    nullable VIRefreshTokenResult

    Completion handler that is triggered when the operation is completed.

    typedef void (^VIRefreshTokenResult)(VIAuthParams *authParams, NSError *error);
    • authParams: Auth parameters that can be used to login using access token.
    • error: Occurred error. See VILoginErrorCode for possible variants.

registerPushNotificationsToken:imToken:

- (BOOL)registerPushNotificationsToken:(nullable NSData *)voipToken
                               imToken:(nullable NSData *)imToken

Register Apple Push Notifications token.

After calling this function application will receive push notifications from Voximplant Server.

Parameters

Returns

  • Return:

    BOOL

    YES if the provided tokens are not nil and the client is logged in; NO otherwise. If the provided tokens are not nil, but the client is not logged in, the tokens will be registered just after login, despite the API returns NO.

requestOneTimeKeyWithUser:result:

- (void)requestOneTimeKeyWithUser:(NSString *)user
                           result:(VIOneTimeKeyResult)result

Generates one time login key to be used for automated login process.

For additional information please see:

Parameters

  • user:

    NSString *

    Full user name, including app and account name, like someuser@someapp.youraccount.voximplant.com.

  • result:

    VIOneTimeKeyResult

    Completion handler that is triggered when the operation is completed.

    typedef void (^VIOneTimeKeyResult)(NSString *oneTimeKey, NSError *error);
    • oneTimeKey: Resulting One Time Key.
    • error: Occurred error. See VILoginErrorCode for possible variants.

setLogDelegate:

+ (void)setLogDelegate:(id<VILogDelegate>)logDelegate

Set log delegate to handle Voximplant iOS SDK log messages.

Parameters

setLogLevel:

+ (void)setLogLevel:(VILogLevel)logLevel

Set a verbosity level for log messages. This method must be called before creating SDK object instance.

Parameters

unregisterPushNotificationsToken:imToken:

- (BOOL)unregisterPushNotificationsToken:(nullable NSData *)voipToken
                                 imToken:(nullable NSData *)imToken

Unregister Apple Push Notifications token.

After calling this function application stops receive push notifications from Voximplant Server.

Parameters

Returns

  • Return:

    BOOL

    YES if the provided tokens are not nil and the client is logged in; NO otherwise. If the provided tokens are not nil, but the client is not logged in, the tokens will be unregistered just after login, despite the API returns NO.

webrtcVersion

+ (NSString *)webrtcVersion

Get underlying WebRTC version.

Returns

  • Return:

    NSString *

    WebRTC version.

writeLogsToFile

+ (void)writeLogsToFile

Enable saving of the logs to file(s). Log files are located at: Library/Caches/Logs.

Available via the CocoaLumberjackLogger subspec.

writeLogsToFileLogger:

+ (void)writeLogsToFileLogger:(DDFileLogger *)fileLogger

Enable saving of the logs to the specified CocoaLumberjack file logger.

Available via the CocoaLumberjackLogger subspec.

Parameters

  • fileLogger:

    DDFileLogger *

    configured DDFileLogger instance

Properties

callManagerDelegate

@property (nonatomic, weak, nullable) id<VIClientCallManagerDelegate> callManagerDelegate

Call manager delegate that handles incoming calls.

calls

@property (nonatomic, strong, readonly) NSDictionary<NSString *, VICall *> *calls

Dictionary of actual calls with their ids.

clientState

@property (nonatomic, readonly) VIClientState clientState

Current client state.

messenger

@property (nonatomic, strong, readonly) VIMessenger *messenger

Get instance of messaging subsystem.

Messenger instance.

sessionDelegate

@property (nonatomic, weak) id<VIClientSessionDelegate> sessionDelegate

Session delegate that handles events for connection with Voximplant Cloud.