Flag funzione: timestampType: TimestampMode.RELATIVE

È possibile abilitare indicatori orari assoluti o relativi per i messaggi di chat. Gli indicatori orari assoluti visualizzano l'ora esatta per ogni messaggio. Gli indicatori orari relativi vengono visualizzati solo sul messaggio più recente ed esprimono il tempo in termini di secondi, giorni, ore, mesi o anni fa rispetto alla precisione message.The precedente offerta dagli indicatori orari assoluti. sono ideali per le attività di archiviazione, ma nel contesto limitato di una sessione di chat, questa precisione riduce l'esperienza utente perché gli utenti devono confrontare gli indicatori orari per scoprire il passaggio del tempo tra i messaggi. Gli indicatori orari relativi consentono agli utenti di tenere traccia facilmente della conversazione utilizzando termini quali Just Now e Pochi istanti fa che possono essere compresi immediatamente. Gli indicatori orari relativi migliorano l'esperienza dell'utente in un altro modo, semplificando allo stesso tempo le attività di sviluppo: poiché gli indicatori orari relativi contrassegnano i messaggi in termini di secondi, giorni, ore, mesi o anni fa, non è necessario convertirli per i fusi orari.

Flag funzione: actionsLayout

actionsLayout imposta la direzione del layout per le azioni locali, globali, delle schede e dei moduli. Quando si imposta questa opzione come LayoutOrientation.HORIZONTAL, questi pulsanti vengono disposti orizzontalmente e vengono inseriti a capo se il contenuto si eccede.

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

(Obbligatorio) <Immettere qui una breve descrizione.>

Flag funzione: 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();

Quando la proprietà autoSubmit di un campo è impostata su true, il client invia un valore FormSubmissionMessagePayload con la mappa submittedField contenente i valori di campo validi immessi finora. I campi non ancora impostati (indipendentemente dal fatto che siano obbligatori) o che violino una convalida lato client non sono inclusi nella mappa submittedField. Se il campo inviato automaticamente contiene valori non validi, il messaggio di invio non viene inviato e viene visualizzato il messaggio di errore del client per quel particolare campo. Quando una sottomissione automatica riesce, partialSubmitField nel messaggio di invio del modulo verrà impostato su id nel campo autoSubmit.

Flag funzione: enableDefaultClientResponse: true (impostazione predefinita: false)

Utilizzare enableDefaultClientResponse: true per fornire risposte predefinite sul lato client accompagnate da un indicatore di digitazione quando la risposta dello skill è stata ritardata o quando non vi è alcuna risposta dello skill. Se l'utente invia il primo messaggio o la prima query, ma lo skill non risponde con il numero di secondi impostato dal flag odaas_default_greeting_timeout, lo skill può visualizzare un messaggio di saluto configurato mediante la stringa di traduzione odaas_default_greeting_message. Successivamente, il client verifica di nuovo la risposta dello skill. Il client visualizza la risposta dello skill se è stata ricevuta, ma in caso contrario il client visualizza un messaggio di attesa (configurato con la stringa di traduzione odaas_default_wait_message) a intervalli impostati dal flag odaas_default_wait_message_interval. Quando l'attesa della risposta dello skill supera la soglia impostata dal flag typingIndicatorTimeout, il client visualizza una risposta spiacevole all'utente e interrompe l'indicatore di digitazione. È possibile configurare la risposta Sorry utilizzando la stringa di traduzione odaas_default_sorry_message.

Configurazione funzioni: 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.
        }
        }

È possibile abilitare o visualizzare la cronologia delle conversazioni locali di un utente dopo la reinizializzazione dell'SDK impostando displayPreviousMessages su true o false nella configurazione dei bot. Quando l'opzione è impostata su false, i messaggi precedenti non vengono visualizzati per l'utente dopo la reinizializzazione dell'SDK.

FeatureFlag: enableEndConversation: true

enableEndConversation: true aggiunge un pulsante di chiusura alla vista intestazione che consente agli utenti di terminare in modo esplicito la sessione di chat corrente. Quando gli utenti fanno clic su questo pulsante Chiudi e confermano l'azione di chiusura, viene visualizzata una finestra di dialogo di richiesta di conferma. L'SDK invia un messaggio di evento allo skill che segna la fine della sessione di chat. L'SDK disconnette quindi lo skill dall'istanza, comprime il widget chat e cancella la cronologia delle conversazioni dell'utente corrente. L'SDK attiva un delegato su beforeEndConversation(CompletionHandler completionHandler) che può essere utilizzato per eseguire un task prima di inviare una richiesta di chiusura della sessione al server. Inoltre, genera un evento OnChatEnd() per il quale è possibile registrarsi.

L'apertura del widget chat determina l'avvio di una nuova sessione di chat.

L'SDK può essere utilizzato senza la sua interfaccia utente. Per utilizzarlo in questa modalità, importare nel progetto solo il package com.oracle.bots.client.sdk.android.core-24.12.aar come descritto in Aggiungere l'SDK client Oracle Android al progetto.

L'SDK mantiene la connessione al server e fornisce API per inviare messaggi, ricevere messaggi e ottenere aggiornamenti per lo stato della rete e per altri servizi. È possibile utilizzare le interfacce API per interagire con l'SDK e aggiornare l'interfaccia utente.

È possibile inviare un messaggio utilizzando una qualsiasi delle API send*() disponibili nella classe Bots. Ad esempio, public static void sendMessage(String text) invia un messaggio di testo a skill o assistente digitale.

Flag funzione: linkHandler

È possibile configurare il funzionamento dei collegamenti nei messaggi di chat per consentire agli utenti di accedere alle pagine Web dal widget di chat. Invece di dover passare dalla conversazione per visualizzare una pagina in una scheda o in una finestra separata del browser, un utente può rimanere nella chat perché il widget chat apre il collegamento all'interno di una vista Web.

Flag funzione: multiLangChat

Il supporto della lingua nativa dell'SDK Android consente al widget chat di rilevare sia la lingua di un utente che di selezionare la lingua della conversazione da un menu a discesa nell'intestazione. Gli utenti possono passare da una lingua all'altra, ma solo tra le conversazioni, non durante una conversazione perché la conversazione viene reimpostata ogni volta che un utente seleziona una nuova lingua.

Passando un ArrayList di Oggetti a shareMenuItems shareMenuItems(Arraylist<Object>), è possibile limitare o filtrare il tipo di elementi disponibili nel menu, personalizzare le icone e le etichette del menu e limitare la dimensione del file di caricamento (ad esempio, 1024 nello snippet seguente). Questi oggetti possono essere oggetti di valori di enumerazione shareMenuCustomItem o ShareMenuItem mappati alle voci di menu di condivisione: ShareMenuItem.CAMERA per la voce di menu della fotocamera (se supportata dal dispositivo), ShareMenuItem.VISUAL per la condivisione di un'immagine o di un elemento video, ShareMenuItem.AUDIO per la condivisione di un elemento audio e ShareMenuItem.FILE per la condivisione di un elemento di file. Se si passa un valore vuoto o un valore nullo, vengono visualizzate tutte le voci di menu che possono essere passate come valori di enumerazione ShareMenuItem.

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();

Flag funzione: enableSpeechRecognition

L'impostazione del flag della funzione enableSpeechRecognition su true consente di visualizzare il pulsante del microfono insieme al pulsante di invio ogni volta che il campo di input dell'utente è vuoto.

L'impostazione di questa proprietà su true supporta anche le funzionalità abilitate dalla proprietà enableSpeechRecognitionAutoSend, che, se impostata anche su true, consente di inviare automaticamente la risposta vocale dell'utente al server di chat durante la visualizzazione della risposta come messaggio inviato nella finestra di chat. È possibile consentire agli utenti di modificare o eliminare i messaggi dettati prima di inviarli manualmente impostando enableSpeechRecognitionAutoSend su false.

• Flag funzione: enableSpeechSynthesis
• Configurazione delle funzionalità: speechSynthesisVoicePreferences

Flag funzione: ttsService

Il flag delle funzioni speechSynthesisService consente di inserire nell'SDK qualsiasi servizio TTS (text-to-speech), proprio o fornito da un fornitore di terze parti. Per inserire un servizio TTS, è innanzitutto necessario impostare il flag della funzione enableSpeechSynthesis su true, quindi passare un'istanza dell'interfaccia SpeechSynthesisService al flag speechSynthesisService.

Flag funzione: enableSendTypingStatus

Se abilitato, l'SDK invia un evento di digitazione RESPONDING insieme al testo attualmente digitato dall'utente a . Mostra un indicatore di digitazione nella console dell'agente. Al termine della digitazione, l'SDK invia un evento LISTENING a Oracle B2C Service o Oracle Fusion Service. In questo modo l'indicatore di digitazione viene nascosto nella console dell'agente.

Analogamente, quando l'agente digita, l'SDK riceve un evento RESPONDING dal servizio. Quando si riceve questo evento, l'SDK mostra un indicatore di digitazione all'utente. Quando l'agente è inattivo, l'SDK riceve l'evento LISTENING dal servizio. Quando si riceve questo evento, l'SDK nasconde l'indicatore di digitazione visualizzato all'utente.

public void sendUserTypingStatus(TypingStatus status, String text)

È possibile abilitare l'aggiornamento dinamico dell'avatar utente in runtime.

Utilizzare queste API per modificare il nome dell'agente, il colore del testo, l'avatar, le iniziali del nome dell'agente, il colore del testo e lo sfondo dell'avatar.

Quando il supporto vocale è abilitato (enableSpeechRecognition(true)), nel piè di pagina del widget chat viene visualizzato un visualizzatore vocale, un grafico del visualizzatore dinamico che indica il livello di frequenza dell'input vocale. Il visualizzatore risponde alla modulazione della voce dell'utente indicando se l'utente sta parlando troppo dolcemente o troppo forte. Questo visualizzatore viene creato utilizzando il flusso di byte registrati mentre l'utente parla, che viene esposto anche nel metodo IBotsSpeechListener#onActiveSpeechUpdate(byte[]) per l'uso in modalità headless.

Quando si utilizza enableSpeechRecognitionAutoSend(true), il testo riconosciuto viene inviato automaticamente alla competenza dopo che l'utente ha terminato di dettare il messaggio. La modalità torna quindi all'input di testo. Quando si utilizza enableSpeechRecognitionAutoSend(false), la modalità torna anche all'input di testo, ma in questo caso gli utenti possono modificare il testo riconosciuto prima di inviare il messaggio allo skill.