Indicateur de fonctionnalité : timestampType: TimestampMode.RELATIVE

Vous pouvez activer les horodatages absolus ou relatifs pour les messages de discussion. Les horodatages absolus affichent l'heure exacte de chaque message. Les horodatages relatifs sont affichés uniquement sur le dernier message et expriment le temps en secondes, jours, heures, mois ou années écoulé par rapport au message précédent. La précision fournie par les horodatages absolus les rend idéaux pour les tâches d'archivage, mais dans le contexte limité d'une session de discussion, ils détournent l'attention de l'utilisateur, car celui-ci doit comparer les horodatages pour connaître le temps écoulé entre les messages. Les horodatages relatifs permettent aux utilisateurs de suivre facilement la conversation par le biais de termes tels que A l'instant et Il y a quelques instants, qui peuvent être immédiatement compris. Les horodatages relatifs améliorent l'expérience utilisateur d'une autre manière qui simplifie vos tâches de développement : étant donné que les horodatages relatifs marquent les messages en secondes, jours, heures, mois ou années écoulés, il n'est pas nécessaire de les convertir selon les fuseaux horaires.

Indicateur de fonctionnalité : actionsLayout

actionsLayout définit la direction de mise en page des actions locales, globales, de carte et de formulaire. Lorsque vous définissez ce paramètre sur LayoutOrientation.HORIZONTAL, ces boutons sont disposés horizontalement et seront renvoyés à la ligne si le contenu déborde.

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

(Requis) <Saisissez une brève description ici.>

Indicateur de fonctionnalité : 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();

Lorsqu'un champ a la propriété autoSubmit définie sur true, le client envoie une adresse FormSubmissionMessagePayload avec la correspondance submittedField contenant les valeurs de champ valides qui ont été entrées jusqu'à présent. Les champs qui ne sont pas encore définis (qu'ils soient obligatoires ou non) ou qui enfreignent une validation côté client ne sont pas inclus dans la carte submittedField. Si le champ soumis automatiquement contient lui-même une valeur non valide, le message de soumission n'est pas envoyé et le message d'erreur client s'affiche pour ce champ particulier. Lorsqu'une soumission automatique réussit, partialSubmitField dans le message de soumission de formulaire est défini sur id du champ autoSubmit.

Indicateur de fonctionnalité : enableDefaultClientResponse: true (valeur par défaut : false)

Utilisez enableDefaultClientResponse: true pour fournir des réponses côté client par défaut accompagnées d'un indicateur de saisie lorsque la réponse de brique a été retardée ou lorsqu'il n'y a aucune réponse de brique. Si l'utilisateur envoie le premier message/requête, mais que la brique ne répond pas avec le nombre de secondes défini par l'indicateur odaas_default_greeting_timeout, la brique peut afficher un message d'accueil configuré à l'aide de la chaîne de traduction odaas_default_greeting_message. Ensuite, le client vérifie à nouveau la réponse de la brique. Le client affiche la réponse de la brique si elle a été reçue, mais si ce n'est pas le cas, il affiche un message d'attente (configuré avec la chaîne de traduction odaas_default_wait_message) à des intervalles définis par l'indicateur odaas_default_wait_message_interval. Lorsque l'attente de la réponse de la brique dépasse le seuil défini par l'indicateur typingIndicatorTimeout, le client affiche une réponse désolée à l'utilisateur et arrête l'indicateur de saisie. Vous pouvez configurer la réponse désolée à l'aide de la chaîne de traduction odaas_default_sorry_message.

Configuration des fonctionnalités : 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.
        }
        }

Vous pouvez activer ou afficher l'historique de conversation local d'un utilisateur après la réinitialisation du kit SDK en définissant displayPreviousMessages sur true ou false dans la configuration des bots. Lorsque la valeur est false, les messages précédents ne sont pas affichés pour l'utilisateur après la réinitialisation du kit SDK.

FeatureFlag: enableEndConversation: true

enableEndConversation: true ajoute un bouton de fermeture à la vue d'en-tête qui permet aux utilisateurs de mettre fin explicitement à la session de discussion en cours. Une boîte de dialogue d'invite de confirmation s'ouvre lorsque les utilisateurs cliquent sur ce bouton de fermeture et lorsqu'ils confirment l'action de fermeture, le kit SDK envoie un message d'événement à la brique qui marque la fin de la session de discussion. Le kit SDK déconnecte ensuite la brique de l'instance, réduit le widget de discussion et efface l'historique de conversation de l'utilisateur en cours. Le kit SDK déclenche un délégué sur beforeEndConversation(CompletionHandler completionHandler) qui peut être utilisé pour effectuer une tâche avant d'envoyer une demande de fermeture de session au serveur. Il déclenche également un événement OnChatEnd() auquel vous pouvez vous inscrire.

L'ouverture du widget de discussion démarre ensuite une nouvelle session de discussion.

Vous pouvez utiliser le kit SDK sans son interface utilisateur. Pour l'utiliser dans ce mode, importez uniquement le package com.oracle.bots.client.sdk.android.core-24.12.aar dans le projet, comme décrit dans Ajout du kit SDK client Oracle Android au projet.

Le kit SDK gère la connexion au serveur et fournit des API permettant d'envoyer des messages, d'en recevoir, d'obtenir des mises à jour du statut du réseau et d'autres services. Vous pouvez utiliser les API pour interagir avec le kit SDK et mettre à jour l'interface utilisateur.

Vous pouvez envoyer un message à l'aide de l'une des API send*() disponibles dans la classe Bots. Par exemple, public static void sendMessage(String text) envoie un message texte à la brique ou à l'assistant numérique.

Indicateur de fonctionnalité : linkHandler

Vous pouvez configurer le comportement des liens dans les messages de discussion pour permettre aux utilisateurs d'accéder aux pages Web à partir du widget de discussion. Au lieu d'avoir à abandonner la conversation pour afficher une page dans un onglet ou dans une fenêtre de navigateur distincte, l'utilisateur peut rester dans la conversation, car le widget de discussion ouvre le lien dans une vue Web.

Indicateur de fonctionnalité : multiLangChat

La prise en charge des langues natives du kit SDK Android permet au widget de discussion de détecter la langue de l'utilisateur et de laisser l'utilisateur sélectionner la langue de la conversation dans un menu déroulant de l'en-tête. Les utilisateurs peuvent changer de langue, mais uniquement entre différentes conversations et pas au cours d'une conversation, car la conversation est réinitialisée chaque fois qu'un utilisateur sélectionne une nouvelle langue.

En transmettant la liste ArrayList des objets à shareMenuItems shareMenuItems(Arraylist<Object>), vous pouvez restreindre ou filtrer le type des éléments disponibles dans le menu, personnaliser les icônes et les libellés du menu, et limiter la taille du fichier de téléchargement (par exemple, 1 024 dans le fragment de code suivant). Ces objets peuvent être des objets shareMenuCustomItem ou des valeurs d'énumération ShareMenuItem mises en correspondance avec les options du menu de partage : ShareMenuItem.CAMERA pour l'option de menu Appareil photo (si elle est prise en charge par l'appareil), ShareMenuItem.VISUAL pour le partage d'une image ou d'une vidéo, ShareMenuItem.AUDIO pour le partage d'un élément audio et ShareMenuItem.FILE pour le partage d'un fichier. La transmission d'une valeur vide ou NULL affiche toutes les options de menu pouvant être transmises en tant que valeurs d'énumération 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();

Indicateur de fonctionnalité : enableSpeechRecognition

La définition de l'indicateur de fonctionnalité enableSpeechRecognition sur true permet d'afficher le bouton de microphone avec le bouton d'envoi lorsque le champ d'entrée utilisateur est vide.

Lorsque cette propriété a pour valeur true, elle prend également en charge la fonctionnalité activée par la propriété enableSpeechRecognitionAutoSend qui, lorsqu'elle est également définie sur true, permet d'envoyer automatiquement la réponse vocale de l'utilisateur au serveur de discussion tout en affichant la réponse sous forme de message envoyé dans la fenêtre de discussion. Vous pouvez permettre aux utilisateurs de modifier (ou de supprimer) les messages qu'ils ont dictés avant de les envoyer manuellement en définissant enableSpeechRecognitionAutoSend sur false.

• Indicateur de fonctionnalité : enableSpeechSynthesis
• Configuration des fonctionnalités : speechSynthesisVoicePreferences

Indicateur de fonctionnalité : ttsService

L'indicateur de fonctionnalité speechSynthesisService vous permet d'injecter n'importe quel service de synthèse vocale (TTS) - le vôtre ou fourni par un fournisseur tiers - dans le kit SDK. Pour injecter un service TTS, vous devez d'abord définir l'indicateur de fonctionnalité enableSpeechSynthesis sur true, puis transmettre une instance de l'interface SpeechSynthesisService à l'indicateur speechSynthesisService.

Indicateur de fonctionnalité : enableSendTypingStatus

Lorsque cette option est activée, le kit SDK envoie un événement de saisie RESPONDING avec le texte actuellement saisi par l'utilisateur à . Un indicateur de saisie s'affiche sur la console de l'agent. Lorsque l'utilisateur a terminé la saisie, le kit SDK envoie un événement LISTENING à Oracle B2C Service ou Oracle Fusion Service. Cela masque l'indicateur de saisie sur la console de l'agent.

De même, lorsque l'agent saisit, le kit SDK reçoit un événement RESPONDING du service. A la réception de cet événement, le kit SDK affiche un indicateur de saisie à l'utilisateur. Lorsque l'agent est inactif, le kit SDK reçoit l'événement LISTENING du service. A la réception de cet événement, le kit SDK masque l'indicateur de saisie affiché pour l'utilisateur.

public void sendUserTypingStatus(TypingStatus status, String text)

Vous pouvez activer la mise à jour dynamique de l'avatar utilisateur lors de l'exécution.

Utilisez ces API pour modifier le nom de l'agent, la couleur du texte, l'avatar, les initiales du nom de l'agent, la couleur du texte et l'arrière-plan de l'avatar.

Lorsque la prise en charge vocale est activée (enableSpeechRecognition(true)), le pied de page du widget de discussion affiche un visualiseur vocal, c'est-à-dire un graphique de visualiseur dynamique qui indique le niveau de fréquence de l'entrée vocale. Le visualiseur réagit à la modulation de la voix de l'utilisateur en indiquant si ce dernier parle trop doucement ou trop fort. Ce visualiseur est créé à l'aide du flux d'octets enregistrés pendant que l'utilisateur parle, qui est également exposé dans la méthode IBotsSpeechListener#onActiveSpeechUpdate(byte[]) pour un usage en mode sans interface utilisateur.

Avec enableSpeechRecognitionAutoSend(true), le texte reconnu est automatiquement envoyé à la brique une fois que l'utilisateur a terminé de dicter le message. Le mode revient ensuite à la saisie de texte. Avec enableSpeechRecognitionAutoSend(false), le mode revient également à la saisie de texte, mais dans ce cas, les utilisateurs peuvent modifier le texte reconnu avant d'envoyer le message à la brique.