Package com.unblu.sdk.core

Class Unblu

java.lang.Object

com.unblu.sdk.core.Unblu

public class Unblu
extends Object

This class is the entry point where any implementation of the Unblu Mobile SDK should begin so that an end user can use Unblu. It's the main class to initialize either the AgentClient or VisitorClient. Additionally, it provides access to global events related to the Unblu SDK via Observables.

Field Summary

Fields

Modifier and Type	Field	Description
static boolean	enableCapturingPerformanceLogging	Enables the logging of capturing performance, for example, frames per second (FPS).
static boolean	enableDebugOutput	Enables the debug output of the Unblu SDK.

Method Summary

Modifier and Type	Method	Description
static void	createAgentClient(android.app.Application application, android.app.Activity activity, UnbluClientConfiguration unbluClientConfiguration, UnbluNotificationApi notificationApi, InitializeSuccessCallback<UnbluAgentClient> success, InitializeExceptionCallback failure)	Creates a new instance of the UnbluAgentClient.
static void	createAgentClient(android.app.Application application, UnbluClientConfiguration unbluClientConfiguration, UnbluNotificationApi notificationApi, InitializeSuccessCallback<UnbluAgentClient> success, InitializeExceptionCallback failure)	Creates a new instance of the UnbluAgentClient.
static android.widget.FrameLayout	createTwoFactorAuthWebView(android.content.Context context, UnbluClientConfiguration config, com.unblu.sdk.core.internal.webview.UnbluTwoFactorAuthErrorUIConfig errorUIConfig, Consumer<kotlin.Pair<Boolean,String>> onResult)	Creates an instance of FrameLayout that hosts a WebView for handling two-factor authentication (2FA).
static void	createVisitorClient(android.app.Application application, android.app.Activity activity, UnbluClientConfiguration unbluClientConfiguration, UnbluNotificationApi notificationApi, InitializeSuccessCallback<UnbluVisitorClient> success, InitializeExceptionCallback failure)	Creates a new instance of the UnbluVisitorClient.
static void	createVisitorClient(android.app.Application application, UnbluClientConfiguration unbluClientConfiguration, UnbluNotificationApi notificationApi, InitializeSuccessCallback<UnbluVisitorClient> success, InitializeExceptionCallback failure)	Creates a new instance of the UnbluVisitorClient.
static LogLevel	getLogLevel()	Returns the log level of the Unblu SDK.
static io.reactivex.rxjava3.core.Observable<UnbluAgentClient>	onAgentInitialized()	Fired when an UnbluAgentClient is available.
static io.reactivex.rxjava3.core.Observable<ErrorData>	onError()	Fired when an internal error occurs.
static io.reactivex.rxjava3.core.Observable<UiHideRequestModel>	onUiHideRequest()	Fired whenever the Unblu UI needs to be hidden.
static io.reactivex.rxjava3.core.Observable<UiVisibilityRequestModel>	onUiVisibilityRequest()	Fired whenever the Unblu UI needs to be displayed.
static io.reactivex.rxjava3.core.Observable<UnbluVisitorClient>	onVisitorInitialized()	Fired when an UnbluVisitorClient is available.
static void	setLogLevel(LogLevel logLevel)	Sets the log level of the Unblu SDK.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details

enableDebugOutput

public static boolean enableDebugOutput

Enables the debug output of the Unblu SDK. The debug output contains additional information on log messages and is independent of the log level defined using setLogLevel(LogLevel). The default value is false, that is, debug output is disabled.

enableCapturingPerformanceLogging

public static boolean enableCapturingPerformanceLogging

Enables the logging of capturing performance, for example, frames per second (FPS). The default value is false, that is, capturing performance logging is disabled.

Method Details

createVisitorClient

public static void createVisitorClient(android.app.Application application,
 UnbluClientConfiguration unbluClientConfiguration,
 UnbluNotificationApi notificationApi,
 @Nullable
 InitializeSuccessCallback<UnbluVisitorClient> success,
 @Nullable
 InitializeExceptionCallback failure)

Creates a new instance of the UnbluVisitorClient. The instance returned can then be used to access Unblu features such as chat, co-browsing, or calls. Which features are available depends on the modules you register and the collaboration server configuration.

Use this method if you initialize Unblu when there's no activity, otherwise use the method createVisitorClient(Application, Activity, UnbluClientConfiguration, UnbluNotificationApi, InitializeSuccessCallback, InitializeExceptionCallback).

The instance should be maintained across the application as long as Unblu is in use. If the instance enters an error state it's automatically deinitialized (UnbluClient.deinitClient(SuccessVoidCallback, DeinitializeExceptionCallback)). When this occurs, you can initialize the instance again afterwards.

Parameters:

application - An Application instance

unbluClientConfiguration - An UnbluClientConfiguration instance

notificationApi - An implementation of UnbluNotificationApi

success - SuccessCallback

failure - InitializeExceptionCallback

createAgentClient

public static void createAgentClient(android.app.Application application,
 UnbluClientConfiguration unbluClientConfiguration,
 UnbluNotificationApi notificationApi,
 @Nullable
 InitializeSuccessCallback<UnbluAgentClient> success,
 @Nullable
 InitializeExceptionCallback failure)

Creates a new instance of the UnbluAgentClient. The instance returned can then be used to access Unblu features such as chat, co-browsing, or calls. Which features are available depends on the modules you register and the collaboration server configuration.

Use this method if you initialize Unblu when there's no activity, otherwise use the method createAgentClient(Application, Activity, UnbluClientConfiguration, UnbluNotificationApi, InitializeSuccessCallback, InitializeExceptionCallback).

The instance should be maintained across the application as long as Unblu is used. If the instance enters an error state, it's automatically deinitialized (UnbluClient.deinitClient(SuccessVoidCallback, DeinitializeExceptionCallback)). When this occurs, you can initialize the instance again afterwards.

Parameters:

application - An Application instance

unbluClientConfiguration - An UnbluClientConfiguration instance

notificationApi - An implementation of UnbluNotificationApi

success - SuccessCallback

failure - InitializeExceptionCallback

createVisitorClient

public static void createVisitorClient(android.app.Application application,
 android.app.Activity activity,
 UnbluClientConfiguration unbluClientConfiguration,
 UnbluNotificationApi notificationApi,
 @Nullable
 InitializeSuccessCallback<UnbluVisitorClient> success,
 @Nullable
 InitializeExceptionCallback failure)

Creates a new instance of the UnbluVisitorClient. The instance returned can then be used to access Unblu features such as chat, co-browsing, or calls. Which features are available depends on the modules you register and the collaboration server configuration.

Use this method if you already have an activity, otherwise use the method createVisitorClient(Application, UnbluClientConfiguration, UnbluNotificationApi, InitializeSuccessCallback, InitializeExceptionCallback).

The instance should be maintained across the application as long as Unblu is in use. If the instance enters an error state it's automatically deinitialized (UnbluClient.deinitClient(SuccessVoidCallback, DeinitializeExceptionCallback)). When this occurs, you can initialize the instance again afterwards.

Parameters:

application - An Application instance

activity - The current Activity

unbluClientConfiguration - An UnbluClientConfiguration instance

notificationApi - An implementation of UnbluNotificationApi

success - SuccessCallback

failure - InitializeExceptionCallback

createAgentClient

public static void createAgentClient(android.app.Application application,
 android.app.Activity activity,
 UnbluClientConfiguration unbluClientConfiguration,
 UnbluNotificationApi notificationApi,
 @Nullable
 InitializeSuccessCallback<UnbluAgentClient> success,
 @Nullable
 InitializeExceptionCallback failure)

Creates a new instance of the UnbluAgentClient. The instance returned can then be used to access Unblu features such as chat, co-browsing, or calls. Which features are available depends on the modules you register and the collaboration server configuration.

Use this method if you already have an activity, otherwise use the method createAgentClient(Application, UnbluClientConfiguration, UnbluNotificationApi, InitializeSuccessCallback, InitializeExceptionCallback).

The instance should be maintained across the application as long as Unblu is in use. If the instance enters an error state it's automatically deinitialized (UnbluClient.deinitClient(SuccessVoidCallback, DeinitializeExceptionCallback)). When this occurs, you can initialize the instance again afterwards.

Parameters:

application - An Application instance

activity - the current Activity

unbluClientConfiguration - An UnbluClientConfiguration instance

notificationApi - An implementation of UnbluNotificationApi

success - SuccessCallback

failure - InitializeExceptionCallback

createTwoFactorAuthWebView

public static android.widget.FrameLayout createTwoFactorAuthWebView(@NotNull
 android.content.Context context,
 @NotNull
 UnbluClientConfiguration config,
 @NotNull
 com.unblu.sdk.core.internal.webview.UnbluTwoFactorAuthErrorUIConfig errorUIConfig,
 Consumer<kotlin.Pair<Boolean,String>> onResult)

Creates an instance of FrameLayout that hosts a WebView for handling two-factor authentication (2FA).

Note: This isn't available for agents who log in with single sign-on (SSO).

Parameters:

context - The application context used to initialize the view.

config - The configuration settings required for the UnbluClient.

errorUIConfig - The UI configuration used to customize the appearance of the error view and buttons.

onResult - A callback function that receives a Pair:

• Boolean — whether the authentication was successful.
• String — an error message if authentication failed, or null on success.

Returns:

A newly created FrameLayout instance containing the configured 2FA WebView.

setLogLevel

public static void setLogLevel(LogLevel logLevel)

Sets the log level of the Unblu SDK. Any messages with a lower log level than the one specified here go unlogged.
The default value is LogLevel.VERBOSE. In release builds, the VERBOSE and DEBUG logs are stripped out via proguard.

Parameters:

logLevel - The log level to set

See Also:

• getLogLevel()

getLogLevel

public static LogLevel getLogLevel()

Returns the log level of the Unblu SDK. Any messages with a lower log level than the one specified here go unlogged.

Returns:

The log level of the Unblu SDK.

See Also:

• setLogLevel(LogLevel)

onUiVisibilityRequest

public static io.reactivex.rxjava3.core.Observable<UiVisibilityRequestModel> onUiVisibilityRequest()

Fired whenever the Unblu UI needs to be displayed. This happens when a push notification for a call comes in, for example, or if the user clicks a notification and a conversation should be displayed. You should observe this from the beginning of the application running so you receive visibility requests related to notifications.

Returns:

An Observable that emits UiVisibilityRequestModel data

onUiHideRequest

public static io.reactivex.rxjava3.core.Observable<UiHideRequestModel> onUiHideRequest()

Fired whenever the Unblu UI needs to be hidden. This happens when mobile co-browsing is started, for example.

Returns:

An Observable that emits UiHideRequestModel data

onError

public static io.reactivex.rxjava3.core.Observable<ErrorData> onError()

Fired when an internal error occurs. Normally this is the case if UnbluClient couldn't load anything from the Unblu server.
The error message is intended for internal use only. It isn't localized and shouldn't be displayed to users.

Returns:

An Observable that emits ErrorData

onAgentInitialized

public static io.reactivex.rxjava3.core.Observable<UnbluAgentClient> onAgentInitialized()

Fired when an UnbluAgentClient is available. The client instance is provided in an initialized state, ready to use.

Returns:

An Observable that emits each time an UnbluAgentClient is initialized.

onVisitorInitialized

public static io.reactivex.rxjava3.core.Observable<UnbluVisitorClient> onVisitorInitialized()

Fired when an UnbluVisitorClient is available. The client instance is provided in an initialized state, ready to use.

Returns:

An Observable that emits each time an UnbluVisitorClient is initialized.