Indicador de función: timestampType: TimestampMode.RELATIVE

Puede activar registros de hora absolutos o relativos para los mensajes de chat. Los registros de hora absolutos muestran la hora exacta de cada mensaje. Los registros de hora relativos solo se muestran en el último mensaje y expresan el tiempo en términos de cuántos segundos, días, horas, meses o años han transcurrido con respecto al mensaje anterior. La precisión que ofrecen los registros de hora absolutos los convierten en ideales para tareas de archivado, pero dentro del contexto limitado de una sesión de chat, esta precisión empeora la experiencia de usuario porque los usuarios deben comparar los registros de hora para averiguar el paso del tiempo entre los mensajes. Los registros de hora relativos permiten a los usuarios realizar un seguimiento de la conversación fácilmente con términos como Ahora mismo y Hace unos momentos que se pueden comprender inmediatamente. Los registros de hora relativos mejoran la experiencia del usuario de otra forma, al tiempo que simplifican las tareas de desarrollo: debido a que los registros de hora relativos marcan los mensajes en términos de segundos, días, horas, meses o años transcurridos, no es necesario convertirlos para las zonas horarias.

Indicador de función: actionsLayout

actionsLayout define la dirección de diseño para las acciones locales, globales, de tarjeta y de formulario. Cuando se define como LayoutOrientation.HORIZONTAL, estos botones se presentan horizontalmente y se ajustan si el contenido se desborda.

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

(Necesario) <Introduzca una descripción breve aquí.>

Indicador de función: 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();

Cuando un campo tiene la propiedad autoSubmit definida en true, el cliente envía un valor FormSubmissionMessagePayload con la asignación submittedField que contiene los valores de campo válidos que se han introducido hasta ahora. Los campos que aún no se hayan definido (independientemente de si son obligatorios) o los campos que violan una validación del lado del cliente no se incluyen en la asignación submittedField. Si el campo de envío automático en sí contiene un valor que no es válido, el mensaje de envío no se envía y se muestra el mensaje de error del cliente para ese campo en particular. Cuando un envío automático se realiza correctamente, el valor partialSubmitField del mensaje de envío de formulario se definirá en id del campo autoSubmit.

Indicador de función: enableDefaultClientResponse: true (valor por defecto: false)

Utilice enableDefaultClientResponse: true para proporcionar respuestas por defecto del lado del cliente acompañadas de un indicador de escritura cuando la respuesta de la aptitud se haya retrasado o cuando no haya ninguna respuesta de aptitud. Si el usuario envía el primer mensaje/consulta, pero la aptitud no responde con el número de segundos definido por el indicador odaas_default_greeting_timeout, la aptitud puede mostrar un mensaje de saludo que se configura mediante la cadena de traducción odaas_default_greeting_message. A continuación, el cliente vuelve a comprobar la respuesta de la aptitud. El cliente muestra la respuesta de la aptitud si se ha recibido, pero si no, muestra un mensaje de espera (configurado con la cadena de traducción odaas_default_wait_message) en intervalos definidos por el indicador odaas_default_wait_message_interval. Cuando la espera de la respuesta de la aptitud supera el umbral definido por el indicador typingIndicatorTimeout, el cliente muestra una respuesta de disculpa al usuario y detiene el indicador de escritura. Puede configurar la respuesta de disculpa mediante la cadena de traducción odaas_default_sorry_message.

Configuración de función: 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.
        }
        }

Puede activar o mostrar el historial de conversaciones local de un usuario después de que el SDK se haya reinicializado definiendo displayPreviousMessages en true o false en la configuración de los bots. Cuando se define en false, los mensajes anteriores no se muestran para el usuario después de la reinicialización del SDK.

FeatureFlag: enableEndConversation: true

enableEndConversation: true agrega un botón de cierre a la vista de cabecera que permite a los usuarios finalizar explícitamente la sesión de chat actual. Se abre un cuadro de diálogo de petición de confirmación cuando los usuarios hacen clic en este botón de cierre y cuando confirman la acción de cierre, el SDK envía un mensaje de evento a la aptitud que marca el final de la sesión de chat. A continuación, el SDK desconecta la aptitud de la instancia, reduce el widget de chat y borra el historial de conversaciones del usuario actual. El SDK dispara un delegado en beforeEndConversation(CompletionHandler completionHandler) que se puede utilizar para realizar una tarea antes de enviar una solicitud de cierre de sesión al servidor. También genera un evento OnChatEnd() para el que puede registrarse.

Al abrir el widget de chat después, se inicia una nueva sesión de chat.

El SDK se puede utilizar sin su interfaz de usuario. Para utilizarlo en este modo, importe solo el paquete com.oracle.bots.client.sdk.android.core-24.12.aar en el proyecto tal y como se describe en Adición del SDK del cliente Android de Oracle al proyecto.

El SDK mantiene la conexión con el servidor y proporciona las API para enviar mensajes, recibir mensajes y obtener actualizaciones para el estado de la red y para otros servicios. Puede utilizar las API para interactuar con el SDK y actualizar la interfaz de usuario.

Puede enviar un mensaje utilizando cualquiera de las API send*() disponibles en la clase Bots. Por ejemplo, public static void sendMessage(String text) envía un mensaje de texto a una aptitud o asistente digital.

Indicador de función: linkHandler

Puede configurar el comportamiento del enlace en los mensajes de chat para permitir a los usuarios acceder a páginas web desde dentro del widget de chat. En lugar de tener que cambiar de la conversación para ver una página en un separador o en una ventana del explorador independiente, un usuario puede permanecer en el chat porque el widget de chat abre el enlace dentro de una vista web.

Indicador de función: multiLangChat

El soporte de idioma nativo del SDK de Android permite al widget de chat tanto detectar el idioma de un usuario como permitir al usuario seleccionar el idioma de conversación en un menú desplegable de la cabecera. Los usuarios pueden cambiar entre idiomas, pero solo entre conversaciones, no durante una conversación porque la conversación se restablece cada vez que un usuario selecciona un nuevo idioma.

Al transferir un ArrayList de objetos a shareMenuItems shareMenuItems(Arraylist<Object>), puede restringir, o filtrar, el tipo de elementos disponibles en el menú, personalizar los iconos y las etiquetas del menú y limitar el tamaño del archivo de carga (como 1024 en el siguiente fragmento). Estos objetos pueden ser un objeto de valores de enumeración shareMenuCustomItem o ShareMenuItem asignados a las opciones de menú de recursos compartidos: ShareMenuItem.CAMERA para la opción de menú de cámara (si está soportada por el dispositivo), ShareMenuItem.VISUAL para compartir una imagen o un elemento de vídeo, ShareMenuItem.AUDIO para compartir un elemento de audio y ShareMenuItem.FILE para compartir un elemento de archivo. Al transferir un valor vacío o un valor nulo, se muestran todas las opciones de menú que se pueden transferir como valores de enumeración 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();

Indicador de función: enableSpeechRecognition

Al definir el indicador de la función enableSpeechRecognition en true, se activa el botón Micrófono que se mostrará junto con el botón Enviar cada vez que el campo de entrada de usuario esté vacío.

La definición de esta propiedad en true también soporta la funcionalidad activada por la propiedad enableSpeechRecognitionAutoSend, que cuando se define también en true, permite que la respuesta de voz del usuario se envíe al servidor de chat automáticamente mientras se muestra la respuesta como un mensaje enviado en la ventana de chat. Puede permitir que los usuarios en primer lugar editen (o supriman) sus mensajes determinados antes de enviarlos manualmente definiendo enableSpeechRecognitionAutoSend en false.

• Indicador de función: enableSpeechSynthesis
• Configuración de funcionalidad: speechSynthesisVoicePreferences

Indicador de función: ttsService

El indicador de función speechSynthesisService le permite inyectar cualquier servicio de texto a voz (TTS) (propio o proporcionado por un proveedor externo) en el SDK. Para inyectar un servicio TTS, primero debe definir el indicador de función enableSpeechSynthesis en true y, a continuación, transferir una instancia de la interfaz SpeechSynthesisService al indicador speechSynthesisService.

Indicador de función: enableSendTypingStatus

Cuando está activado, el SDK envía un evento de escritura RESPONDING junto con el texto que el usuario está escribiendo actualmente en . Muestra un indicador de escritura en la consola del agente. Cuando el usuario haya terminado de escribir, el SDK envía un evento LISTENING a Oracle B2C Service u Oracle Fusion Service. Esto oculta el indicador de escritura en la consola del agente.

Del mismo modo, cuando el agente está escribiendo, el SDK recibe un evento RESPONDING del servicio. Al recibir este evento, el SDK muestra un indicador de escritura al usuario. Cuando el agente está inactivo, el SDK recibe el evento LISTENING del servicio. Al recibir este evento, el SDK oculta el indicador de escritura que se muestra al usuario.

public void sendUserTypingStatus(TypingStatus status, String text)

Puede activar la actualización dinámica del avatar del usuario en tiempo de ejecución.

Utilice estas API para modificar el nombre del agente, el color del texto, el avatar, las iniciales del nombre del agente, el color del texto y el fondo del avatar.

Cuando el soporte de voz está activado (enableSpeechRecognition(true)), el pie de página del widget de chat muestra un visualizador de voz, un gráfico de visualizador dinámico que indica el nivel de frecuencia de la entrada de voz. El visualizador responde a la modulación de la voz del usuario indicando si el usuario habla demasiado bajo o demasiado alto. Este visualizador se crea mediante el flujo de bytes que se registran mientras el usuario habla, el cual también se muestra en el método IBotsSpeechListener#onActiveSpeechUpdate(byte[]) para su uso en el modo sin cabecera.

Con enableSpeechRecognitionAutoSend(true), el texto reconocido se envía automáticamente a la aptitud después de que el usuario haya terminado de dictar el mensaje. El modo vuelve a la entrada de texto. Si enableSpeechRecognitionAutoSend(false), el modo también se revierte a la entrada de texto, pero en este caso, los usuarios pueden modificar el texto reconocido antes de enviar el mensaje a la aptitud.