Um diese Zeichenfolgen zu lokalisieren, definieren Sie die name-Attribute für die <string>-Elemente in der Datei res/values-<your-language-code>/strings.xml der App-Ressource mit den Schlüsseln. Beispiel: Um den Titel der Chatansicht auf Englisch zu lokalisieren, definieren Sie in einer Datei namens res/value-en/strings.xml Folgendes:

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

Um den Titel auf Französisch zu lokalisieren, fügen Sie der Datei res/value-fr/strings.xml Folgendes hinzu:

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

Die Werte für res/value/strings.xml werden standardmäßig für die Schlüssel verwendet, die nicht in res/values-<your-language-code>/strings.xml gefunden werden. In diesen beiden Beispielen würden die Standardwerte für die Ressourcen verwendet, die nicht in der Datei res/value-fr/strings.xml oder res/value-en/strings.xml definiert sind.

Parameter:

• application: Die Anwendungsinstanz. Dieser Wert darf nicht Null sein.
• botsConfiguration: Das BotsConfiguration-Objekt, das zur Steuerung der Library-Features verwendet wird. Dieser Wert darf nicht Null sein.

Bots.init(getApplication(),
      botsConfiguration);

Parameter:

• application: Die Anwendungsinstanz. Dieser Wert darf nicht Null sein.
• botsConfiguration: Das BotsConfiguration-Objekt, das zur Steuerung der Library-Features verwendet wird. Dieser Wert darf nicht Null sein.
• botsCallback: Der Callback, der beim Aufbau der Verbindung empfangen wird.

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

Parameter:

• application: Die Anwendungsinstanz. Dieser Wert darf nicht Null sein.
• chatServerUrl: Die URL des Oracle-Chatservers. Dieser Wert darf nicht Null sein.
• channelId: Die Kanal-ID, die zum Oracle-Android-Kanal gehört, der an den Skill oder den digitalen Assistenten weitergeleitet wird. Dieser Wert darf nicht Null sein.
• userId: Eine eindeutige ID für den Benutzer. Das SDK initialisiert diesen Wert, wenn er nicht angegeben wird.
• botsCallback: Der Callback, der beim Aufbau der Verbindung zum Oracle-Chatserver empfangen wird.

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

Parameter:

• application: Die Anwendungsinstanz. Dieser Wert darf nicht Null sein.
• chatServerUrl: Die URL des Oracle-Chatservers. Dieser Wert darf nicht Null sein.
• authTokenProvider: Die Instanz von AuthenticationTokenProvider, mit der das Authentifizierungstoken generiert wird, wenn es benötigt wird.
• botsCallback: Der Callback, der beim Aufbau der Verbindung empfangen wird.

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

Eine Instanz dieser Schnittstelle kann an die Eigenschaft authTokenProvider übergeben werden, damit das SDK ein neues Authentifizierungstoken generieren kann, wenn eines für den Aufbau einer authentifizierten Kanalverbindung erforderlich ist. Setzen Sie beim Implementieren dieser Schnittstelle die Methode public String getAuthToken außer Kraft.

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

Diese Schnittstelle dient als Callback beim Initialisieren der Library.

• void onSuccess(Response paramResponse): Diese Methode wird aufgerufen, wenn die Web-Socket-Verbindung erfolgreich hergestellt wurde.
• void onFailure(Response paramResponse): Diese Methode wird bei Fehlern aufgerufen, die beim Initialisieren der Library auftreten.

Nach der Initialisierung des SDK zeigen Sie die Unterhaltungsansicht an, indem Sie public static void show(Context context) aufrufen. Der Parameter context dieser Methode ist der Kontext, aus dem die Aktivität gestartet werden soll.

ConversationActivity.show(getApplicationContext())

Sie können die bei den Skillnachrichten empfangenen Benachrichtigungen anpassen, indem Sie die Klasse NotificationCustomizer instanziieren und die Instanz an die Eigenschaft notificationCustomizer übergeben. Konstruktoren:

• NotificationCustomizer(): Initialisiert den Benachrichtigungskanal mit der Standardkonfiguration.
• NotificationCustomizer(String channelId): Initialisiert den Benachrichtigungskanal mit der angegebenen Kanal-ID. Der Parameter channelId ist die ID des Benachrichtigungskanals, über den die Benachrichtigungen gesendet werden.
• NotificationCustomizer(String channelId, String channelName, String description, String title): Initialisiert den Benachrichtigungskanal mit den angegebenen Parametern:

  • channelID: Die ID des Benachrichtigungskanals, über den Benachrichtigungen gesendet werden.
  • channelName: Der Name des Benachrichtigungskanals, über den die Benachrichtigungen gesendet werden.
  • description: Eine Beschreibung des Benachrichtigungskanals, über den die Benachrichtigungen gesendet werden.
  • title: Der in den Benachrichtigungen angezeigte Titel.

Beispiel:

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