To localize these strings, define the name attributes for the <string> elements in the app resource's res/values-<your-language-code>/strings.xml file with the keys. For example, to localize the title of the chat view in English, define the following in a file called res/value-en/strings.xml:

<resources>
    <string name="odaas_bot_chat_title">Support</string>
</resources>

To localize the title in French, you'd add the following to a file called res/value-fr/strings.xml file:

<resources>
    <string name="odaas_bot_chat_title">Soutien</string>
</resources>

The values for res/value/strings.xml are used by default for the keys that are not found in res/values-<your-language-code>/strings.xml. For these two examples, the default values would be used for the resources that are not defined in either the res/value-fr/strings.xml or res/value-en/strings.xml files.

Parameters:

• application – The application instance. This cannot be null.
• botsConfiguration – The BotsConfiguration object used to control the features of library. This cannot be null.

Bots.init(getApplication(),
      botsConfiguration);

Parameters:

• application – The application instance. This cannot be null.
• botsConfiguration – The BotsConfiguration object used to control the features of library. This cannot be null.
• botsCallback – The callback received while establishing the connection.

Bots.init(getApplication(), botsConfiguration, new BotsCallback() {
    @Override
    public void onSuccess(Response paramResponse) {}
 
    @Override
    public void onFailure(Response paramResponse) {}
});

Parameters:

• application – The application instance. This cannot be null.
• chatServerUrl – The URL of the Oracle Chat Server. This cannot be null.
• channelId – The Channel ID belonging to the Oracle Android channel that's routed to the skill or digital assistant. This cannot be null.
• userId – A unique identifier for the user. The SDK initializes this value when it's not provided.
• botsCallback – The callback received while establishing the connection to the Oracle Chat Server.

Bots.init(getApplication(), chatServerUrl, authTokenProvider, new BotsCallback() {
    @Override
    public void onSuccess(Response paramResponse) {}
 
    @Override
    public void onFailure(Response paramResponse) {}
});

Parameters:

• application – The application instance. This cannot be null.
• chatServerUrl – The URL of the Oracle Chat Server. This cannot be null.
• authTokenProvider – The instance of AuthenticationTokenProvider, which is used to generate the authentication token whenever it's needed.
• botsCallback – The callback received while establishing connection.

BotsConfiguration botsConfiguration = new BotsConfiguration.BotsConfigurationBuilder(<SERVER_URI>, getApplicationContext())

An instance of this interface can be passed to the authTokenProvider property to allow the SDK to generate a new authentication token when one is required to establish an authenticated channel connection. When implementing this interface, override the public String getAuthToken method.

private class AuthTokenProvider implements AuthenticationTokenProvider {
    @Override
    public String getAuthToken() {
        // Generate a new JWT Token and return
    }
}

This interface acts as a callback while initializing the library.

• void onSuccess(Response paramResponse) – This method is called when the web socket connection has been successfully established.
• void onFailure(Response paramResponse) – This method is called on any failures that occur while initializing the library.

After initializing the SDK, display the conversation view by invoking public static void show(Context context). This method's context parameter is the context from which to start the activity.

ConversationActivity.show(getApplicationContext())

You can customize the notifications received for the skill's messages by instantiating the NotificationCustomizer class and passing the instance to the notificationCustomizer property. The constructors are:

• NotificationCustomizer()– Initializes the notification channel with the default configuration.
• NotificationCustomizer(String channelId) – Initializes the notification channel with the given channel ID. The channelId parameter is the ID of the notification channel through which the notifications are sent.
• NotificationCustomizer(String channelId, String channelName, String description, String title) – Initializes the notification channel with the given parameters:

  • channelID – The ID of the notification channel through which notifications are sent.
  • channelName – The name of the notification channel through which the notifications are sent.
  • description – A description of the notification channel through which the notifications are sent.
  • title – The title displayed on the notifications.

For example:

new BotsConfiguration.NotificationCustomizer(<NOTIFICATION_CHANNEL_ID>,
    <NOTIFICATION_CHANNEL_NAME>, <NOTIFICATION_CHANNEL_DESCRIPTION>, <NOTIFICATION_TITLE>);