Pour localiser ces chaînes, définissez les attributs name des éléments <string> dans le fichier res/values-<your-language-code>/strings.xml (situé dans les ressources d'application) à l'aide des clés suivantes. Par exemple, pour traduire le titre de la vue de clavardage en anglais, ajoutez ce qui suit dans un fichier nommé res/value-en/strings.xml :

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

Pour traduire 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 de res/value/strings.xml sont utilisées par défaut pour les clés qui ne se trouvent pas dans res/values-<your-language-code>/strings.xml. Pour ces deux exemples, les valeurs par défaut sont utilisées pour les ressources qui ne sont pas définies dans le fichier res/value-fr/strings.xml ou res/value-en/strings.xml.

Paramètres :

• application : Instance d'application. Cette valeur ne peut pas être vide.
• botsConfiguration : Objet BotsConfiguration utilisé pour contrôler les fonctions de la bibliothèque. Cette valeur ne peut pas être vide.

Bots.init(getApplication(),
      botsConfiguration);

Paramètres :

• application : Instance d'application. Cette valeur ne peut pas être vide.
• botsConfiguration : Objet BotsConfiguration utilisé pour contrôler les fonctions de la bibliothèque. Cette valeur ne peut pas être vide.
• botsCallback : rappel 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 d'application. Cette valeur ne peut pas être vide.
• chatServerUrl : URL du serveur de clavardage Oracle. Cette valeur ne peut pas être vide.
• channelId : ID canal appartenant au canal Oracle Android qui est acheminé vers l'assistant numérique ou la compétence. Cette valeur ne peut pas être vide.
• userId : Identificateur unique de l'utilisateur. La trousse SDK initialise cette valeur lorsqu'elle n'est pas fournie.
• botsCallback : rappel reçu lors de l'établissement de la connexion au serveur de clavardage Oracle.

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

Paramètres :

• application : Instance d'application. Cette valeur ne peut pas être vide.
• chatServerUrl : URL du serveur de clavardage Oracle. Cette valeur ne peut pas être vide.
• authTokenProvider : Instance de AuthenticationTokenProvider utilisée pour générer le jeton d'authentification lorsque cela est nécessaire.
• botsCallback : Rappel reçu lors de l'établissement de la connexion.

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

Une instance de cette interface peut être transmise à la propriété authTokenProvider pour permettre à la trousse SDK de générer un nouveau jeton d'authentification lorsqu'il est exigé pour établir une connexion à un canal authentifié. Lors de la mise en oeuvre 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 rappel lors de l'initialisation de la bibliothèque.

• void onSuccess(Response paramResponse) : Cette méthode est appelée quand la connexion WebSocket a été établie avec succès.
• void onFailure(Response paramResponse) : Cette méthode est appelée en cas d'échec lors de l'initialisation de la bibliothèque.

Après l'initialisation de la trousse SDK, 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 avis reçus pour les messages de la compétence en instanciant la classe NotificationCustomizer et en transmettant l'instance à la propriété notificationCustomizer. Les constructeurs sont les suivants :

• NotificationCustomizer() : Initialise le canal d'avis avec la configuration par défaut.
• NotificationCustomizer(String channelId) : Initialise le canal d'avis avec l'ID canal indiqué. Le paramètre channelId correspond à l'ID du canal d'avis par lequel les avis sont envoyés.
• NotificationCustomizer(String channelId, String channelName, String description, String title) – Initialise le canal d'avis avec les paramètres indiqués :

  • channelID : ID du canal d'avis par lequel les avis sont envoyés.
  • channelName : Nom du canal d'avis par lequel les avis sont envoyés.
  • description : Description du canal d'avis par lequel les avis sont envoyés.
  • title : Titre affiché avec les avis.

Par exemple :

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