Per localizzare queste stringhe, definire gli attributi name per gli elementi <string> nel file res/values-<your-language-code>/strings.xml della risorsa applicazione con le chiavi. Ad esempio, per localizzare il titolo della vista chat in inglese, definire quanto segue in un file denominato res/value-en/strings.xml:

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

Per localizzare il titolo in francese, è necessario aggiungere quanto segue a un file denominato res/value-fr/strings.xml:

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

I valori per res/value/strings.xml vengono utilizzati per impostazione predefinita per le chiavi non trovate in res/values-<your-language-code>/strings.xml. Per questi due esempi, verranno utilizzati i valori predefiniti per le risorse non definite nei file res/value-fr/strings.xml o res/value-en/strings.xml.

Parametri:

• application: l'istanza dell'applicazione. Non può essere nullo.
• botsConfiguration: l'oggetto BotsConfiguration utilizzato per controllare le funzioni della libreria. Non può essere nullo.

Bots.init(getApplication(),
      botsConfiguration);

Parametri:

• application: l'istanza dell'applicazione. Non può essere nullo.
• botsConfiguration: l'oggetto BotsConfiguration utilizzato per controllare le funzioni della libreria. Non può essere nullo.
• botsCallback: il callback ricevuto durante il tentativo di stabilire la connessione.

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

Parametri:

• application: l'istanza dell'applicazione. Non può essere nullo.
• chatServerUrl: l'URL del server Oracle Chat. Non può essere nullo.
• channelId: l'ID canale appartenente al canale Oracle Android instradato alla competenza o all'assistente digitale. Non può essere nullo.
• userId: un identificativo univoco per l'utente. L'SDK inizializza questo valore quando non viene fornito.
• botsCallback: il callback ricevuto durante il tentativo di stabilire la connessione a Oracle Chat Server.

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

Parametri:

• application: l'istanza dell'applicazione. Non può essere nullo.
• chatServerUrl: l'URL del server Oracle Chat. Non può essere nullo.
• authTokenProvider: l'istanza di AuthenticationTokenProvider, utilizzata per generare il token di autenticazione ogni volta che è necessario.
• botsCallback: il callback ricevuto durante il tentativo di stabilire la connessione.

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

Un'istanza di questa interfaccia può essere passata alla proprietà authTokenProvider per consentire al kit SDK di generare un nuovo token di autenticazione quando è necessario stabilire una connessione canale autenticata. Durante l'implementazione di questa interfaccia, eseguire l'override del metodo public String getAuthToken.

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

Questa interfaccia agisce da callback durante l'inizializzazione della libreria.

• void onSuccess(Response paramResponse): questo metodo viene chiamato quando la connessione al socket Web è stata stabilita correttamente.
• void onFailure(Response paramResponse): questo metodo viene chiamato in caso di errori durante l'inizializzazione della libreria.

Dopo aver inizializzato l'SDK, visualizzare la vista della conversazione richiamando public static void show(Context context). Il parametro context di questo metodo è il contesto da cui avviare l'attività.

ConversationActivity.show(getApplicationContext())

È possibile personalizzare le notifiche ricevute per i messaggi dello skill creando un'istanza della classe NotificationCustomizer e passando l'istanza alla proprietà notificationCustomizer. I costruttori sono:

• NotificationCustomizer(): inizializza il canale di notifica con la configurazione predefinita.
• NotificationCustomizer(String channelId): inizializza il canale di notifica con l'ID canale specificato. Il parametro channelId è l'ID del canale di notifica tramite il quale vengono inviate le notifiche.
• NotificationCustomizer(String channelId, String channelName, String description, String title): inizializza il canale di notifica con i parametri specificati:

  • channelID: l'ID del canale di notifica tramite il quale vengono inviate le notifiche.
  • channelName: il nome del canale di notifica attraverso il quale vengono inviate le notifiche.
  • description: descrizione del canale di notifica tramite il quale vengono inviate le notifiche.
  • title: il titolo visualizzato nelle notifiche.

Ad esempio:

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