Indicateur de fonction : timestampType: TimestampMode.RELATIVE

Vous pouvez activer des horodatages absolus ou relatifs pour les messages de clavardage. Les horodatages absolus affichent l'heure exacte de chaque message. Les horodatages relatifs s'affichent uniquement sur le dernier message et expriment le temps en secondes, jours, heures, mois ou années par rapport au message précédent. La précision fournie par les horodatages absolus les rend idéals pour les tâches d'archivage, mais dans le contexte limité d'une session de clavardage, cette précision nuit à l'expérience utilisateur car les utilisateurs doivent comparer les horodatages pour calculer le temps écoulé entre les messages. Les horodatages relatifs permettent aux utilisateurs de suivre facilement la conversation grâce à des termes comme Just Now (À l'instant) et A few moments ago (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 tout en simplifiant vos tâches de développement : parce que les horodatages relatifs marquent les messages en secondes, jours, heures, mois ou années, vous n'avez pas besoin de les convertir pour les fuseaux horaires.

Indicateur de fonction : actionsLayout

actionsLayout définit la direction de disposition pour les actions locales, globales, de carte et de formulaire. Lorsque vous réglez ce paramètre à LayoutOrientation.HORIZONTAL, ces boutons sont disposés horizontalement et s'encapsuleront si le contenu déborde.

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

(Obligatoire) <Entrez une description abrégée ici.>

Indicateur de fonction : 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 réglée à true, le client envoie un FormSubmissionMessagePayload avec le mappage submittedField contenant les valeurs de champ valides qui ont été entrées jusqu'à présent. Tous les champs qui ne sont pas encore définis (qu'ils soient obligatoires ou non) ou les champs qui violent une validation côté client ne sont pas inclus dans le mappage submittedField. Si le champ auto-soumis contient lui-même une valeur qui n'est pas valide, le message de soumission n'est pas envoyé et le message d'erreur du client s'affiche pour ce champ particulier. Lorsqu'une soumission automatique réussit, partialSubmitField dans le message de soumission de formulaire est réglé à id du champ autoSubmit.

Indicateur de fonction : enableDefaultClientResponse: true (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 la compétence a été retardée ou lorsqu'il n'y a aucune réponse de la compétence. Si l'utilisateur envoie le premier message/interrogation, mais que la compétence ne répond pas avec le nombre de secondes défini par l'indicateur odaas_default_greeting_timeout, la compétence peut afficher un message de salutation configuré à l'aide de la chaîne de traduction odaas_default_greeting_message. Ensuite, le client vérifie à nouveau la réponse de la compétence. Le client affiche la réponse de la compétence si elle a été reçue, mais dans le cas contraire, 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 compétence 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 de fonction : 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 non l'affichage de l'historique de conversation locale d'un utilisateur après que la trousse SDK a été réinitialisée en réglant displayPreviousMessages à true ou false dans la configuration des robots. Lorsque la propriété est réglée à false, les messages précédents ne sont pas affichés pour l'utilisateur, après la réinitialisation de la trousse 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 clavardage courante. 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, la trousse SDK envoie un message d'événement à la compétence qui marque la fin de la session de clavardage. La trousse SDK déconnecte ensuite la compétence de l'instance, réduit le widget de clavardage et efface l'historique de conversation de l'utilisateur courant. La trousse 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() pour lequel vous pouvez vous inscrire.

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

La trousse SDK peut être utilisée sans son interface utilisateur. Pour l'utiliser dans ce mode, importez seulement l'ensemble com.oracle.bots.client.sdk.android.core-24.12.aar dans le projet, comme décrit dans Ajouter la trousse SDK client pour Oracle Android au projet.

La trousse SDK gère la connexion au serveur et fournit des API pour l'envoi et la réception de messages, et pour l'obtention de mises à jour du statut du réseau et d'autres services. Vous pouvez utiliser les API pour interagir avec la trousse 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 à une compétence ou un assistant numérique.

Indicateur de fonction : linkHandler

Vous pouvez configurer le comportement du lien dans les messages de clavardage pour permettre aux utilisateurs d'accéder aux pages Web depuis le widget de clavardage. Au lieu d'avoir à sortir de la conversation pour afficher une page dans un onglet ou une fenêtre de navigateur distincte, un utilisateur peut y rester parce que le widget de clavardage ouvre le lien dans une vue Web.

Indicateur de fonction : multiLangChat

La prise en charge linguistique native de la trousse SDK Android permet au widget de clavardage de détecter la langue d'un utilisateur et de lui permettre de sélectionner la langue de conversation dans un menu déroulant de l'en-tête. Les utilisateurs peuvent passer d'une langue à l'autre, mais seulement d'une conversation à l'autre, et non pendant une conversation, car celle-ci est réinitialisée chaque fois qu'un utilisateur sélectionne une nouvelle langue.

En transmettant des objets ArrayList à shareMenuItems shareMenuItems(Arraylist<Object>), vous pouvez restreindre ou filtrer le type d'éléments disponibles dans le menu, personnaliser les icônes et étiquettes du menu et limiter la taille du fichier de chargement (par exemple, 1024 dans l'extrait suivant). Ces objets peuvent être soit un objet shareMenuCustomItem, soit des valeurs d'énumération ShareMenuItem mappées aux éléments de menu de partage : ShareMenuItem.CAMERA pour l'élément de menu camera (si pris en charge par l'appareil), ShareMenuItem.VISUAL pour le partage d'une image ou d'un élément 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 d'une valeur nulle affiche tous les éléments de menu qui peuvent être transmis sous la forme de 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 fonction : enableSpeechRecognition

Si vous réglez l'indicateur de la fonction enableSpeechRecognition à true, le bouton du microphone s'affiche avec le bouton d'envoi lorsque le champ d'entrée d'utilisateur est vide.

Le réglage de cette propriété à true prend également en charge la fonctionnalité activée par la propriété enableSpeechRecognitionAutoSend qui, lorsque sa valeur est également true, permet l'envoi automatique de la réponse vocale de l'utilisateur au serveur de clavardage et l'affichage de la réponse en tant que message envoyé dans la fenêtre de clavardage. Vous pouvez permettre aux utilisateurs de modifier (ou de supprimer) leurs messages dictés avant de les envoyer manuellement en réglant enableSpeechRecognitionAutoSend à false.

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

Indicateur de fonction : ttsService

L'indicateur de fonction speechSynthesisService vous permet d'injecter tout service de synthèse vocale (TTS) - le vôtre ou fourni par un fournisseur tiers - dans la trousse SDK. Pour injecter un service TTS, vous devez d'abord régler l'indicateur de fonction enableSpeechSynthesis à true, puis transmettre une instance de l'interface SpeechSynthesisService à l'indicateur speechSynthesisService.

Indicateur de fonction : enableSendTypingStatus

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

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

public void sendUserTypingStatus(TypingStatus status, String text)

Vous pouvez activer la mise à jour dynamique de l'avatar de l'utilisateur au moment 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 clavardage affiche un visualiseur vocal, un graphe de visualisation dynamique qui indique le niveau de fréquence de l'entrée vocale. Le visualiseur répond à la modulation de la voix de l'utilisateur en indiquant si l'utilisateur parle trop doucement ou trop fort. Ce visualiseur est créé à l'aide du flux d'octets enregistrés pendant que l'utilisateur parle. Ce flux est également exposé dans la méthode IBotsSpeechListener#onActiveSpeechUpdate(byte[]) pour une utilisation en mode sans interface.

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