Feature-Flag: timestampType: TimestampMode.RELATIVE

Sie können absolute oder relative Zeitstempel für Chatnachrichten aktivieren. Absolute Zeitstempel zeigen die genaue Zeit für jede Nachricht an. Relative Zeitstempel werden nur in der letzten Nachricht angezeigt und geben die Zeit in Bezug auf die Sekunden, Tage, Stunden, Monate oder Jahre seit der vorherigen Nachricht an. Aufgrund der durch absolute Zeitstempel gebotenen Genauigkeit sind diese ideal für Archivierungsaufgaben. Im begrenzten Kontext einer Chatsession beeinträchtigt diese Genauigkeit aber die Benutzererfahrung, da Benutzer Zeitstempel vergleichen müssen, um die Zeitspanne zwischen Nachrichten zu ermitteln. Mit relativen Zeitstempeln können Benutzer die Unterhaltung einfach durch leicht verständliche Begriffe wie Jetzt gerade und Vor wenigen Minuten verfolgen. Relative Zeitstempel verbessern die Benutzererfahrung auch auf andere Weise und vereinfachen gleichzeitig die Entwicklungsaufgaben: Da relative Zeitstempel die Nachrichten in Sekunden, Tagen, Stunden, Monaten oder Jahren kennzeichnen, müssen Sie sie nicht für andere Zeitzonen konvertieren.

Feature-Flag: actionsLayout

actionsLayout legt die Layoutrichtung für die lokalen, globalen, Karten- und Formularaktionen fest. Wenn Sie diesen Wert auf LayoutOrientation.HORIZONTAL setzen, sind diese Schaltflächen horizontal ausgerichtet und werden umgebrochen, wenn der Inhalt überläuft.

BotsConfiguration botsConfiguration = new BotsConfiguration.BotsConfigurationBuilder(<Server_URI>, false, getApplicationContext())
        .channelId(<CHANNEL_ID>)
        .userId(<USER_ID>)
        .actionsLayout(actionsLayout)
        .build();

(Erforderlich) <Geben Sie hier eine kurze Beschreibung ein.>

Feature-Flag: shareMenuItems

ArrayList<Object> customItems = new ArrayList<>();
        ShareMenuCustomItem shareMenuCustomItem1  = new ShareMenuCustomItem("pdf bin", "Label1", 1024, R.drawable.odaas_menuitem_share_file);
        ShareMenuCustomItem shareMenuCustomItem2  = new ShareMenuCustomItem("doc", "Label2", R.drawable.odaas_menuitem_share_file);
        ShareMenuCustomItem shareMenuCustomItem3  = new ShareMenuCustomItem("csv");
        ArrayList<Object> customItems = new ArrayList<>(Arrays.asList(shareMenuCustomItem1,shareMenuCustomItem2,shareMenuCustomItem3,ShareMenuItem.CAMERA));
        BotsConfiguration botsConfiguration = new BotsConfiguration.BotsConfigurationBuilder(sharedPreferences.getString(getString(R.string.pref_name_chat_server_host), Settings.CHAT_SERVER_URL), false, getApplicationContext())
        .channelId(<CHANNEL_ID>)
        .userId(<USER_ID>)
        .shareMenuItems(customItems)
        .enableAttachment(true)
        .build();

Wenn für ein Feld die Eigenschaft autoSubmit auf true gesetzt ist, sendet der Client eine FormSubmissionMessagePayload mit der Zuordnung submittedField, die entweder die gültigen Feldwerte enthält, die bisher eingegeben wurden. Felder, die noch nicht festgelegt sind (unabhängig davon, ob sie erforderlich sind) oder Felder, die eine clientseitige Validierung verletzen, werden nicht in die submittedField-Map aufgenommen. Wenn das automatisch weitergeleitete Feld selbst einen ungültigen Wert enthält, wird die Weiterleitungsnachricht nicht gesendet, und die Clientfehlermeldung wird für dieses Feld angezeigt. Wenn eine automatische Weiterleitung erfolgreich ist, wird die partialSubmitField in der Formularweiterleitungsnachricht auf id des Feldes autoSubmit gesetzt.

Feature-Flag: enableDefaultClientResponse: true (Standard: false)

Verwenden Sie enableDefaultClientResponse: true, um standardmäßige clientseitige Antworten mit einem Typisierungsindikator anzugeben, wenn die Skillantwort verzögert wurde oder wenn keine Skillantwort vorhanden ist. Wenn der Benutzer die erste Nachricht/Abfrage sendet, der Skill jedoch nicht mit der durch das Kennzeichen odaas_default_greeting_timeout festgelegten Anzahl von Sekunden antwortet, kann der Skill eine Begrüßungsnachricht anzeigen, die mit dem Übersetzungsstring odaas_default_greeting_message konfiguriert ist. Als Nächstes sucht der Client erneut nach der Antwort des Skills. Der Client zeigt die Antwort des Skills an, wenn sie empfangen wurde. Andernfalls zeigt der Client in durch das Flag odaas_default_wait_message_interval festgelegten Intervallen eine Wartemeldung (konfiguriert mit dem odaas_default_wait_message-Übersetzungsstring) an. Wenn die Wartezeit auf die Skillantwort den durch das Flag typingIndicatorTimeout festgelegten Schwellenwert überschreitet, zeigt der Client eine bedauernde Antwort an den Benutzer an und stoppt den Eingabeindikator. Sie können die Entschuldigungsantwort mit dem Übersetzungsstring odaas_default_sorry_message konfigurieren.

Featurekonfiguration: messageModifierDelegate

private MessageDelegate implements MessageModifierDelegate {
    @Override
    public Message beforeSend(Message message) {
        // Handle before send delegate here
    }

    @Override
    public Message beforeDisplay(Message message) {
        if (message != null && message.getPayload() != null && message.getPayload().getType() == MessagePayload.MessageType.CARD) {
            ((CardMessagePayload)message.getPayload()).setLayout(CardLayout.VERTICAL);
        }
        return message;
    }

    @Override
    public Message beforeNotification(Message message) {
        // Handle before notification delegate here
    }
}
    @Override
    public void beforeEndConversation(CompletionHandler completionHandler) {
        // Handle before end conversation end delegate here
        // Trigger completionHandler.onSuccess() callback after successful execution of the task.
        // Trigger completionHandler.onFailure() callback when the task is unsucessful.
        }
        }

Sie können die lokale Unterhaltungshistorie eines Benutzers aktivieren oder anzeigen, nachdem das SDK erneut initialisiert wurde, indem Sie in der Botkonfiguration displayPreviousMessages auf true oder false setzen. Wenn dieser Wert auf false gesetzt ist, werden vorherige Nachrichten für den Benutzer nach der erneuten Initialisierung des SDK nicht angezeigt.

FeatureFlag: enableEndConversation: true

enableEndConversation: true fügt der Headeransicht eine Schaltfläche "Schließen" hinzu, mit der Benutzer die aktuelle Chatsession explizit beenden können. Ein Bestätigungsdialogfeld wird geöffnet, wenn Benutzer auf diese Schaltfläche "Schließen" klicken und wenn sie die Schließungsaktion bestätigen, sendet das SDK eine Ereignisnachricht an den Skill, der das Ende der Chatsession markiert. Das SDK trennt dann den Skill von der Instanz, minimiert das Chatwidget und löscht die Unterhaltungshistorie des aktuellen Benutzers. Das SDK löst einen Delegierten auf beforeEndConversation(CompletionHandler completionHandler) aus, der zum Ausführen einer Aufgabe verwendet werden kann, bevor eine Anforderung zum Schließen der Session an den Server gesendet wird. Außerdem wird ein OnChatEnd()-Ereignis ausgelöst, für das Sie sich registrieren können.

Nach dem Öffnen des Chatwidgets wird eine neue Chatsession gestartet.

Das SDK kann ohne die zugehörige UI verwendet werden. Um es in diesem Modus zu verwenden, importieren Sie nur das Package com.oracle.bots.client.sdk.android.core-24.12.aar in das Projekt, wie in Oracle-Android-Client-SDK zum Projekt hinzufügen beschrieben.

Das SDK verwaltet die Verbindung zum Server und stellt APIs für das Senden von Nachrichten, das Empfangen von Nachrichten und das Abrufen von Aktualisierungen für den Netzwerkstatus und für andere Services bereit. Mit den APIs können Sie mit dem SDK interagieren und die UI aktualisieren.

Sie können eine Nachricht mit den in der Klasse Bots verfügbaren send*()-APIs senden. Beispiel: public static void sendMessage(String text) sendet eine Textnachricht an den Skill oder digitalen Assistenten.

Feature-Flag: linkHandler

Sie können das Linkverhalten in Chatnachrichten konfigurieren, damit Benutzer über das Chatwidget auf Webseiten zugreifen können. Anstatt die Unterhaltung zu verlassen, um eine Seite auf einer Registerkarte oder in einem separaten Browserfenster anzuzeigen, kann ein Benutzer im Chat verbleiben, da das Chatwidget den Link in einer Webansicht öffnet.

Feature-Flag: multiLangChat

Mit der nativen Sprachunterstützung des Android-SDK kann das Chatwidget sowohl die Sprache eines Benutzers erkennen als auch ermöglichen, dass der Benutzer die Konversationssprache aus einem Dropdown-Menü im Header auswählt. Benutzer können zwischen Sprachen wechseln, aber nur zwischen Unterhaltungen und nicht während einer Unterhaltung, da die Unterhaltung zurückgesetzt wird, wenn ein Benutzer eine neue Sprache wählt.

Indem Sie eine ArrayList von Objekten an shareMenuItems shareMenuItems(Arraylist<Object>) übergeben, können Sie den Typ der im Menü verfügbaren Elemente einschränken oder filtern, die Symbole und Labels des Menüs anpassen und die Größe von Uploaddateien einschränken (wie 1024 im folgenden Snippet). Bei diesen Objekten kann es sich entweder um ein Objekt von shareMenuCustomItem oder um ShareMenuItem-Enum-Werte handeln, die den Elementen im Menü "Teilen" zugeordnet sind: ShareMenuItem.CAMERA für die Kameramenüoption (sofern vom Gerät unterstützt), ShareMenuItem.VISUAL für das Teilen eines Bild- oder Videoelements, ShareMenuItem.AUDIO für das Teilen eines Audioelements und ShareMenuItem.FILE für das Teilen eines Dateielements. Wenn Sie einen leeren Wert oder einen Nullwert übergeben, werden alle Menüoptionen angezeigt, die als ShareMenuItem-Enum-Werte übergeben werden können.

ArrayList<Object> customItems = new ArrayList<>();
ShareMenuCustomItem shareMenuCustomItem1  = new ShareMenuCustomItem("pdf bin", "Label1", 1024, R.drawable.odaas_menuitem_share_file);
ShareMenuCustomItem shareMenuCustomItem2  = new ShareMenuCustomItem("doc", "Label2", R.drawable.odaas_menuitem_share_file);
ShareMenuCustomItem shareMenuCustomItem3  = new ShareMenuCustomItem("csv");
ArrayList<Object> customItems = new ArrayList<>(Arrays.asList(shareMenuCustomItem1,shareMenuCustomItem2,shareMenuCustomItem3,ShareMenuItem.CAMERA));
BotsConfiguration botsConfiguration = new BotsConfiguration.BotsConfigurationBuilder(sharedPreferences.getString(getString(R.string.pref_name_chat_server_host), Settings.CHAT_SERVER_URL), false, getApplicationContext())
         .channelId(<CHANNEL_ID>)
         .userId(<USER_ID>)
        .shareMenuItems(customItems)
        .enableAttachment(true)
        .build();

Feature-Flag: enableSpeechRecognition

Wenn Sie das Featurekennzeichen enableSpeechRecognition auf true setzen, kann die Schaltfläche "Mikrofon" zusammen mit der Schaltfläche "Senden" angezeigt werden, wenn das Benutzereingabefeld leer ist.

Wenn Sie diese Eigenschaft auf true setzen, wird auch die von der Eigenschaft enableSpeechRecognitionAutoSend aktivierte Funktionalität unterstützt. Wenn diese Eigenschaft auf true gesetzt wird, kann die Sprachantwort des Benutzers automatisch an den Chatserver gesendet werden, während die Antwort als gesendete Nachricht im Chatfenster angezeigt wird. Sie können es Benutzern ermöglichen, die diktierten Nachrichten zunächst zu bearbeiten (oder zu löschen), bevor sie sie manuell senden. Dazu setzen Sie enableSpeechRecognitionAutoSend auf false.

• Feature-Flag: enableSpeechSynthesis
• Funktionskonfiguration: speechSynthesisVoicePreferences

Featurekennzeichen: ttsService

Mit dem Feature-Flag speechSynthesisService können Sie jeden Text-to-Speech-(TTS-)Service - Ihren eigenen oder einen von einem Drittanbieter bereitgestellten - in das SDK einfügen. Um einen TTS-Service zu injizieren, müssen Sie zuerst das Feature-Flag enableSpeechSynthesis auf true setzen und dann eine Instanz der SpeechSynthesisService-Schnittstelle an das Flag speechSynthesisService übergeben.

Feature-Flag: enableSendTypingStatus

Wenn diese Option aktiviert ist, sendet das SDK ein RESPONDING-Eingabeereignis zusammen mit dem Text, der derzeit vom Benutzer eingegeben wird, an . Zeigt einen Tippindikator auf der Agent-Konsole an. Wenn der Benutzer die Eingabe abgeschlossen hat, sendet das SDK ein LISTENING-Ereignis an Oracle B2C Service oder Oracle Fusion Service. Dadurch wird die Eingabeanzeige in der Agent-Konsole ausgeblendet.

Wenn der Agent eingibt, empfängt das SDK ebenfalls ein RESPONDING-Ereignis vom Service. Nach Erhalt dieses Ereignisses zeigt das SDK dem Benutzer einen Tippindikator an. Wenn der Agent im Leerlauf ist, empfängt das SDK das Ereignis LISTENING vom Service. Nach Erhalt dieses Ereignisses blendet das SDK den Eingabeindikator aus, der dem Benutzer angezeigt wird.

public void sendUserTypingStatus(TypingStatus status, String text)

Sie können die dynamische Aktualisierung des Benutzeravatars zur Laufzeit aktivieren.

Mit diesen APIs können Sie den Agent-Namen, die Textfarbe, den Avatar, die Initialen des Agent-Namens, die Textfarbe und den Avatarhintergrund ändern.

Wenn Sprachunterstützung aktiviert ist (enableSpeechRecognition(true)), zeigt der Footer des Chatwidgets eine Sprachvisualisierung an. Dabei handelt es sich um ein dynamisches Visualisierungsdiagramm, das die Frequenzebene der Spracheingabe angibt. Die Visualisierung reagiert auf die Modulation der Benutzerstimme, indem sie angibt, ob der Benutzer zu leise oder zu laut spricht. Diese Visualisierung wird mit dem Bytestream erstellt, der aufgezeichnet wird, während der Benutzer spricht. Dies wird auch in der IBotsSpeechListener#onActiveSpeechUpdate(byte[])-Methode zur Verwendung im Headless-Modus angezeigt.

Wenn enableSpeechRecognitionAutoSend(true) angegeben ist, wird der erkannte Text automatisch an den Skill gesendet, nachdem der Benutzer die Nachricht diktiert hat. Anschließend wird der Modus auf die Texteingabe zurückgesetzt. Wenn enableSpeechRecognitionAutoSend(false) angegeben ist, wird der Modus ebenfalls auf die Texteingabe zurückgesetzt. In diesem Fall können Benutzer jedoch den erkannten Text ändern, bevor sie die Nachricht an den Skill senden.