1. References
  2. Web SDK
  3. VoxImplant
  4. EventHandlers
  5. MicAccessResult
Rate this page:

Client

Interface that connects, logs in, and manages push notifications tokens.

Methods

connect

Copy URL
connect(options: 
ConnectOptions
, callback: 
ConnectionCallback
): 
Unit

Connects to the Voximplant cloud.

Parameters

Returns

  • type:

    Unit

disconnect

Copy URL
disconnect(): 
Unit

Closes the connection with the Voximplant Cloud.

If this method is called while client is disconnected, ClientSessionListener.onConnectionClosed is triggered with DisconnectReason.AlreadyDisconnected reason.

Returns

  • type:

    Unit

handlePushNotification

Copy URL
handlePushNotification(notification: 
Map<String, String>
): 
Unit

Handles an incoming push notification.

Parameters

  • notification:

    Map<String, String>

    Incoming push notification that comes from FirebaseMessagingService.onMessageReceived(RemoteMessage remoteMessage)

Returns

  • type:

    Unit

login

Copy URL
login(username: 
String
, password: 
String
, callback: 
LoginCallback
): 
Unit

Logs in to the specified Voximplant application with password.

Parameters

  • username:

    String

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

  • password:

    String

    User password

  • callback:

    LoginCallback

Returns

  • type:

    Unit

loginWithAccessToken

Copy URL
loginWithAccessToken(username: 
String
, accessToken: 
String
, callback: 
LoginCallback
): 
Unit

Performs login via the specified username and access token that has been obtained in LoginCallback.onSuccess callback before.

Parameters

  • username:

    String

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

  • accessToken:

    String

    Access token that is obtained in onLoginSuccessful callback

  • callback:

    LoginCallback

Returns

  • type:

    Unit

loginWithOneTimeKey

Copy URL
loginWithOneTimeKey(username: 
String
, hash: 
String
, callback: 
LoginCallback
): 
Unit

Performs login via one time key that has been generated before.

Parameters

  • username:

    String

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

  • hash:

    String

    Hash that is generated via the 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 "@".

  • callback:

    LoginCallback

Returns

  • type:

    Unit

refreshToken

Copy URL
refreshToken(username: 
String
, refreshToken: 
String
, callback: 
RefreshTokenCallback
): 
Unit

Performs refresh of login tokens required for login via access token.

Parameters

  • username:

    String

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

  • refreshToken:

    String

    Refresh token that is obtained in onLoginSuccessful callback

  • callback:

    RefreshTokenCallback

Returns

  • type:

    Unit

registerForPushNotifications

Copy URL
registerForPushNotifications(pushConfig: 
PushConfig
, callback: 
RegisterPushTokenCallback?
): 
Unit

Registers for push notifications. Application can receive push notifications from Voximplant Server after first log in.

The API may be called in any client state, but the push token is registered only after login successful.

Parameters

Returns

  • type:

    Unit

requestOneTimeKey

Copy URL
requestOneTimeKey(username: 
String
, callback: 
GenerateOneTimeKeyCallback
): 
Unit

Generates one time login key for automated login process.

Parameters

  • username:

    String

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

  • callback:

    GenerateOneTimeKeyCallback

Returns

  • type:

    Unit

setClientSessionListener

Copy URL
setClientSessionListener(listener: 
ClientSessionListener?
): 
Unit

Sets the ClientSessionListener listener to handle events related to the connection with the Voximplant Cloud.

Parameters

Returns

  • type:

    Unit

unregisterFromPushNotifications

Copy URL
unregisterFromPushNotifications(pushConfig: 
PushConfig
, callback: 
RegisterPushTokenCallback?
): 
Unit

Unregisters from push notifications. Application can no longer receive push notifications from the Voximplant server.

The API may be called in any Client state, but the push token is unregistered only after a successful login.

Parameters

  • pushConfig:

    PushConfig

    Configuration for push notifications including push token and bundle id

  • callback:

    RegisterPushTokenCallback?

    Optional

    Object to receive the result of this operation

Returns

  • type:

    Unit

Props

clientState

Copy URL
clientState:

Gets the current client state.

Returns

displayName

Copy URL
displayName:

Gets the current user's display name. Display name is available only when the user is logged in, otherwise the property returns null.

Returns

  • type:

    String?