Pour localiser ces chaînes, définissez les attributs name des éléments <string> dans le fichier res/values-<your-language-code>/strings.xml de la ressource d'application avec les clés. Par exemple, pour localiser le titre de la vue de discussion en anglais, définissez les éléments suivants dans un fichier nommé res/value-en/strings.xml :

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

Pour localiser le titre en français, ajoutez ce qui suit à un fichier nommé res/value-fr/strings.xml :

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

Les valeurs pour res/value/strings.xml sont utilisées par défaut pour les clés introuvables dans res/values-<your-language-code>/strings.xml. Dans ces deux exemples, les valeurs par défaut seront utilisées pour les ressources qui ne sont pas définies dans les fichiers res/value-fr/strings.xml ou res/value-en/strings.xml.

Paramètres :

• application : instance de l'application. Ne peut pas avoir la valeur NULL.
• botsConfiguration : objet BotsConfiguration utilisé pour contrôler les fonctionnalités de la bibliothèque. Ne peut pas avoir la valeur NULL.

Bots.init(getApplication(),
      botsConfiguration);

Paramètres :

• application : instance de l'application. Ne peut pas avoir la valeur NULL.
• botsConfiguration : objet BotsConfiguration utilisé pour contrôler les fonctionnalités de la bibliothèque. Ne peut pas avoir la valeur NULL.
• botsCallback : callback reçu lors de l'établissement de la connexion.

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

Paramètres :

• application : instance de l'application. Ne peut pas avoir la valeur NULL.
• chatServerUrl : URL du serveur de discussion Oracle. Ne peut pas avoir la valeur NULL.
• channelId : ID de canal appartenant au canal Oracle Android acheminé vers la brique ou l'assistant numérique. Ne peut pas avoir la valeur NULL.
• userId : identificateur unique de l'utilisateur. Le kit SDK initialise cette valeur si elle n'est pas fournie.
• botsCallback : callback reçu lors de l'établissement de la connexion au serveur de discussion Oracle.

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

Paramètres :

• application : instance de l'application. Ne peut pas avoir la valeur NULL.
• chatServerUrl : URL du serveur de discussion Oracle. Ne peut pas avoir la valeur NULL.
• authTokenProvider : instance de AuthenticationTokenProvider utilisée pour générer le jeton d'authentification lorsque nécessaire.
• botsCallback : callback reçu lors de l'établissement de la connexion.

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

Vous pouvez transmettre une instance de cette interface à la propriété authTokenProvider pour permettre au kit SDK de générer un nouveau jeton d'authentification lorsqu'il est requis pour établir une connexion de canal authentifié. Lors de l'implémentation de cette interface, remplacez la méthode public String getAuthToken.

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

Cette interface agit comme un callback lors de l'initialisation de la bibliothèque.

• void onSuccess(Response paramResponse) : cette méthode est appelée lorsque la connexion de socket Web a été établie.
• void onFailure(Response paramResponse) : cette méthode est appelée pour tous les échecs survenant lors de l'initialisation de la bibliothèque.

Une fois le kit SDK initialisé, affichez la vue de conversation en appelant public static void show(Context context). Le paramètre context de cette méthode est le contexte à partir duquel démarrer l'activité.

ConversationActivity.show(getApplicationContext())

Vous pouvez personnaliser les notifications reçues pour les messages de la brique en instanciant la classe NotificationCustomizer et en transmettant l'instance à la propriété notificationCustomizer. Les constructeurs sont les suivants :

• NotificationCustomizer() : initialise le canal de notification avec la configuration par défaut.
• NotificationCustomizer(String channelId) : initialise le canal de notification avec l'ID de canal donné. Le paramètre channelId est l'ID du canal de notification via lequel les notifications sont envoyées.
• NotificationCustomizer(String channelId, String channelName, String description, String title) : initialise le canal de notification avec les paramètres donnés :

  • channelID : ID du canal de notification via lequel les notifications sont envoyées.
  • channelName : nom du canal de notification via lequel les notifications sont envoyées.
  • description : description du canal de notification via lequel les notifications sont envoyées.
  • title : titre affiché sur les notifications.

Par exemple :

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