Configuración de desarrollo de aplicaciones

Aquí hay una referencia a la configuración que puede utilizar en el desarrollo de la aplicación para su canal Android.

Configuración de Red

Nombre de la propiedad Descripción ¿Obligatoria? Valor por Defecto
channelId ID del canal Android de Oracle. N/D
userId Identificador único para el usuario. Este valor lo inicializa el SDK si no se proporciona. No Valor generado aleatoriamente
authTokenProvider Instancia de AuthenticationTokenProvider que se utiliza para generar un nuevo token cada vez que el SDK necesite establecer una nueva conexión utilizando un canal activado para autenticación de cliente y cuando hay caducado el token existente. N/D

Indicadores de función

Propiedad Descripción ¿Obligatoria? Valor por Defecto
actionsLayout Objeto de tipo ActionsLayout que define la orientación de diseño de acciones locales, globales, de tarjeta y de formulario. No new ActionsLayout(LayoutOrientation.VERTICAL, LayoutOrientation.VERTICAL, LayoutOrientation.VERTICAL, LayoutOrientation.VERTICAL)
disablePastActions Campo para desactivar los clics en el botón en los mensajes con los que ya haya interactuado un usuario. Los valores permitidos son all, none y postback. El comportamiento activado por esta propiedad es independiente de la configuración de nivel de asistente digital para desactivar la selección de las acciones anteriores. Debe definir los dos por separado. No all
displayPreviousMessages Activa o desactiva la visualización de mensajes anteriores después de que se haya reinicializado el SDK. Cuando se define en false, los mensajes anteriores no se muestran para el usuario después de la reinicialización del SDK. No true
enableAgentSneakPreview Envía el texto introducido por el usuario junto con el estado de escritura al agente. No false
enableArrowsForHorizontalCards activa las flechas de navegación para la vista de tarjeta horizontal cuando se define en true, pero las desactiva cuando se define en false. No false
enableAttachment Permite el uso compartido de anexos en la vista de chat. Si se define en true, puede restringir los elementos que están disponibles en la ventana emergente del menú Compartir mediante shareMenuItems.

Esta configuración está en desuso en la versión 22.02. Utilice timeStampType en su lugar.

No true
enableAttachmentSecurity Cuando se define en true, las cabeceras adicionales se transfieren a las solicitudes de carga de anexos para garantizar que no se puedan descargar sin transferir un token JWT firmado válido como cabecera de autorización.

Nota: No active este valor si la aptitud se conecta a una instancia de ODA versión 20.08 o se ejecuta en cualquier versión anterior a la 20.08. Esta propiedad solo se aplica a las conexiones activadas por autenticación de cliente a las versiones 20.12 y superiores de la plataforma ODA.

No false
enableClearMessage Activa el botón Borrar mensaje en la cabecera de la vista de chat. No false
enableDefaultClientResponse Cuando se define en true, el cliente muestra respuestas por defecto cuando la respuesta de la aptitud se ha retrasado o cuando no hay respuesta de la aptitud. No false
enableEndConversation Permite al usuario finalizar la conversación y restablecer la sesión de chat. También borra el historial de conversaciones locales, se desconecta del servidor de chat y cierra la actividad No true
enableNotification Activa o desactiva las nuevas notificaciones de mensajes del SDK cuando la aplicación de chat se ejecuta en segundo plano. El SDK no proporcionará ninguna notificación cuando defina este indicador en false. No true
enableNotificationSound Activa el sonido de notificación en los mensajes de aptitud nuevos mientras la vista de chat está abierta. Esta función solo se aplica cuando enableNotificationSoundSetting está definido en false. No true
enableNotificationSoundSetting Activa el botón de configuración de sonido de notificación en la cabecera de la vista de chat. No false
enableSendTypingStatus Envía el estado de escritura del usuario al agente activo. No false
enableSpeechRecognition Permite al servicio de reconocimiento de voz convertir mensajes de voz del usuario en mensajes de texto. Defina esta propiedad en true para utilizar la propiedad enableSpeechRecognitionAutoSend. No false
enableSpeechRecognitionAutoSend Cuando enableSpeechRecognitionAutoSend se define en true (valor por defecto), la respuesta de voz del usuario se envía automáticamente al servidor de chat (y se muestra como un mensaje enviado en la ventana de chat). Si se define en false, la respuesta de voz del usuario se presenta en el campo de texto del mensaje antes de enviarla al servidor de chat para que el usuario pueda modificarla antes de enviarla manualmente o suprimirla

Esta funcionalidad solo está disponible cuando enableSpeechRecognition está definido en true.

No true
enableSpeechSynthesis Activa el botón de respuesta de audio de la aptitud en la cabecera de la vista de chat. Cuando el botón se encuentra en el estado Reactivar, las respuestas de la aptitud se leen en voz alta. No false
enableTimestamp Activa el registro de hora de los mensajes. No true
googleMapsApiKey Clave de API de Google Maps que se usa para mostrar una imagen de vista previa de ubicación para los mensajes de ubicación. No N/D
initSpeechSynthesisMuted Este indicador, que solo es aplicable cuando el valor de enableSpeechSynthesis es true, determina si el botón de respuesta de audio de la aptitud estará activo (reactivar) por defecto al principio o silenciado. Por defecto, está definido en true, donde el botón está silenciado. No true
initUserHiddenMessage Mensaje de texto de usuario que se utiliza para iniciar una conversación. Este mensaje, que se envía cuando la vista de chat está lista, no se muestra realmente en el chat. No N/D
initUserProfile Inicializa el perfil de usuario antes de que se inicie la conversación. La carga útil del perfil debe ser de tipo User. El perfil se actualiza antes de enviar el valor en initUserHiddenMessage. No N/D
linkHandler Campo utilizado para definir el manejador de enlaces para abrir enlaces, ya sea en una vista web o en un explorador. WebviewLinkHandlerType es una enumeración con dos valores: BROWSER y WEBVIEW. No WebviewLinkHandlerType.BROWSER
messageModifierDelegate Instancia de tipo MessageModifierDelegate que se utiliza para recibir devoluciones de llamada antes de determinados eventos de la conversación. No N/D
multiLangChat Activa el widget de chat tanto para detectar el idioma de un usuario como para permitir al usuario seleccionar un idioma preferido en un menú desplegable de la cabecera. En Chat multilingüe se describe cómo crear este menú. No  
notificationCustomizer Instancia de la clase NotificationCustomizer que se utiliza para personalizar las notificaciones recibidas del SDK. No N/D
reconnectMaxAttempts Número de intentos realizados por el widget de chat para volver a conectarse cuando falla la conexión inicial. No 5
saveClickedImagesInGallery Cuando se define en true (valor por defecto), una imagen capturada por los usuarios de la aptitud que utilizan la cámara se guardará en la galería y se cargará directamente en la aptitud como anexo. Si no desea que las imágenes se guarden en la galería, defina saveClickedImagesInGallery en false. No true
shareMenuItems Restringe los elementos que se muestran en la opción de menú de recursos compartidos y personaliza los iconos y las etiquetas del menú. Para configurar estos elementos, transfiera un ArrayList de objetos a shareMenuItems. Los objetos Arraylist pueden ser valores de enumeración ShareMenuItem asignados a las opciones de menú de recursos compartidos o un objeto ShareMenuCustomItem. Para utilizar este indicador, debe definir enableAttachment en true. No N/D
showBotAvatar Permite mostrar el icono del avatar de la aptitud junto a los mensajes de la aptitud. No false
showConnectionStatus Permite mostrar el estado de conexión en la cabecera de vista de chat. No false
showPersonAvatar Permite mostrar el icono del avatar de la aptitud junto a los mensajes de la aptitud y en las notificaciones. Si la aptitud dispone de integración de agente en directo, si define este indicador en true, se muestra el icono del avatar del agente junto a los mensajes del agente y en las notificaciones. No false
showTypingIndicator Permite que el indicador de escritura se muestre mientras se espera la respuesta de la aptitud. No true
showUserAvatar Permite mostrar el icono del avatar del usuario junto a los mensajes del usuario. No false  
speechLocale Configuración regional esperada del habla del usuario que se utiliza para el reconocimiento de voz. Las configuraciones regionales soportadas son Australia-Inglés (en-au), Reino Unido-Inglés (en-gb), Francés (fr-fr), Alemán (de-de), Índico-Hindi (hi-in), Índico-Inglés (en-in), Italiano (it-it), Portugués Brasileño (pt-br), Español (es-es) y el valor por defecto, US-Inglés (en-us). Llame a la API Bots.setSpeechLocale(<locale>) para definir la configuración regional de voz de forma dinámica. El reconocimiento de voz no funcionará si se ha transferido una configuración regional no soportada. No "en-us"
speechSynthesisService Instancia de SpeechSynthesisService que se utiliza para inyectar un servicio de texto a voz (TTS). Solo se aplica si enableSpeechSynthesis está definido en true. No N/D
speechSynthesisVoicePreferences Configura el idioma y la voz que leen los mensajes de la aptitud en voz alta tomando una lista de instancias del tipo SpeechSynthesisSetting como parámetro. Si el dispositivo no soporta la voz preferida, se utilizará en su lugar la voz por defecto del idioma preferido. Si no están soportados el idioma o la voz preferidos, se utilizan el idioma y la voz por defecto. No N/D
subtitle Define el subtitle de la vista de chat, que aparece debajo del título en la cabecera de la vista de chat. Si se define el indicador subtitle y (o ambos) el valor showConnectionStatus, showTypingIndicator se definen en true, se muestra el subtítulo en lugar del estado de conexión o el indicador de escritura. No N/D
timestampFormat Formatea los registros de hora que se muestran en los mensajes. Puede aceptar una cadena de tokens de formato como 'mm:ss:a'. Consulte la documentación de Android para obtener información sobre los patrones de registro de hora válidos No N/D
timestampType Si activa los registros de hora configurando enableTimestamp en true, puede definir un registro de hora relativo que solo aparezca en el último mensaje configurando timestampType: 'relative'. N/D  
title Permite definir el título en la cabecera de la vista de chat. No N/D
typingIndicatorTimeout Define el número de segundos después de los cuales el indicador de escritura se elimina automáticamente si la vista de chat aún no ha recibido la respuesta. No 30
typingStatusInterval Define el intervalo, en segundos, para limitar el estado de escritura que se envía al agente activo. No 3
WebViewConfig Define los atributos de la vista web en widget, como su tamaño (parcial o completo) o las personalizaciones en el botón Borrar. También pueden hacerse personalizaciones para borrar el botón dentro de la vista web. No Define los valores de configuración para la vista web.
youtubeApiKey Soporta el streaming de vídeos de YouTube mediante la definición de la clave de la API de YouTube. No N/D

Colores personalizados

Puede modificar los colores de la vista de chat para darle un aspecto personalizado. Para configurar estos colores, defina atributos name para los elementos <color> en el archivo res/values/colors.xml (ubicado en los recursos de aplicación del proyecto) mediante las siguientes claves. En el siguiente fragmento se muestra una modificación del color que se utiliza para el fondo del mensaje de la aptitud (odaas_primary) y el color de texto que se utiliza en el mensaje de la aptitud (odaas_on_primary), mientras que se mantienen los colores por defecto para otros recursos.
<resources>
    <color name="odaas_primary">#6699FF</color>
    <color name="odaas_on_primary">#000000</color>
</resources>
Nota

La versión 20.8.1 del SDK restablece los colores de las versiones anteriores. Por ejemplo, si el color de fondo de los botones de acción de la implantación existente es #418980, este se cambiará al color por defecto odaas_action_background (introducido en la versión 20.8.1), que es #FFFFFF. Para las implantaciones creadas con versiones anteriores a la 20.8.1, puede definir colores personalizados actualizando el archivo res/values/colors.xml en la aplicación. Por ejemplo:
<resources>
        <color name="odaas_action_background">#418980</color>
    </resources>
Clave Descripción Valor por defecto
odaas_action_background Color de fondo de los botones de acción y acción global. #FFFFFF
odaas_agent_avatar_background_color Color de fondo utilizado para el diseño del avatar cuando el avatar del agente no está disponible y se muestran las iniciales del nombre del agente en su lugar. #A890B6
odaas_agent_avatar_text_color Color de texto utilizado para las iniciales del nombre del agente que se muestran dentro del diseño del avatar del agente. #FFFFFF
odaas_agent_name_text_color Color de texto utilizado para el nombre del agente que se muestra encima de los mensajes del agente. #A6161513
odaas_background Color del fondo de la vista. #F5F4F2
odaas_bot_avatar_background Color de fondo utilizado para el avatar de la aptitud. #bdbdbd
odaas_bot_avatar_background El color del fondo del avatar de la habilidad. #bdbdbd
odaas_card_background Color de fondo de los mensajes de la tarjeta y sus botones de acción. FFFFFF
odaas_dialog_accent Color que se utiliza para los botones y las barras de progreso en la ventana de diálogo que se muestra antes de borrar mensajes y durante la carga de anexos. 161513
odaas_dialog_background Color de fondo de la ventana de diálogo que se muestra antes de borrar mensajes y durante la carga de anexos. #FFFFFF
odaas_dialog_box_negative_button_background Color de fondo del botón de rechazo que aparece en el cuadro de diálogo de alerta. @android:color/transparent
odaas_dialog_box_negative_button_text_color Color de texto del botón de rechazo que aparece en el cuadro de diálogo de alerta. #161513
odaas_dialog_box_positive_button_background Color de fondo del botón Confirmar que aparece en el cuadro de diálogo de alerta. #161513
odaas_dialog_box_positive_button_text_color Color de texto del botón de confirmación que aparece en el cuadro de diálogo de alerta. #FFFFFF
odaas_error Color de texto utilizado en los mensajes de error. @android:color/white
odaas_footer_accent Color del borde y del cursor del campo de entrada en el pie de página. #01579B
odaas_footer_attach_button Color del botón de anexo. #161513
odaas_footer_background Color de fondo del pie de página. #FFFFFF
odaas_footer_buttons Color de fondo de los botones interactivos en el pie de página, excepto el botón Enviar. 161513
odaas_footer_inline_send_button Color del botón de envío en línea que aparece en el campo de entrada cuando enableSpeechRecognitionAutoSend está definido en true. #161513
odaas_footer_input_background Color de fondo del campo de entrada en el pie de página. #FFFFFF
odaas_footer_mic_button Color del botón de micrófono. #161513
odaas_footer_send_button Color del botón de envío. #FFFFFF
odaas_footer_send_button_background El color de fondo del botón de envío. #161513
odaas_header_buttons Color de fondo de los botones interactivos de la cabecera. #FFFFFF
odaas_on_action_background Color de texto que se utiliza con el color odaas_action_background. @android:color/black
odaas_on_background Color de texto utilizado con el color odaas_background. @android:color/black
odaas_on_card_action_text Color de texto de los botones de acción de la tarjeta. @android:color/black
odaas_on_card_description_text Color de texto que se utiliza para la descripción de la tarjeta. @android:color/white
odaas_on_card_title_text Color de texto que se utiliza para el título de la tarjeta. @android:color/white
odaas_on_dialog_background Color de texto que se utiliza con odaas_dialog_background color en las ventanas de diálogo. @android:color/black
odaas_on_footer_input_background Color de texto que se utiliza con el color odaas_footer_input_background en el pie de página. @android:color/black
odaas_on_multichat_spinner_background Color de fondo del menú desplegable de chat en varios idiomas antes de que se abra la ventana emergente. #F1EFED
odaas_on_multichat_spinner_popup_background Color de fondo del menú desplegable de chat en varios idiomas después de abrir la ventana emergente. #FFFFFF
odaas_on_multichat_spinner_popup_border Color del borde de las opciones del menú desplegable de chat en varios idiomas después de abrir la ventana emergente. #BDBDBD
odaas_on_multichat_spinner_popup_text_color Color de texto utilizado para las opciones del menú desplegable de chat en varios idiomas. @android:color/black
odaas_on_multichat_spinner_text_color Color de texto para un elemento seleccionado en el menú desplegable de chat en varios idiomas. #161513
odaas_on_primary Color de texto utilizado con el color odaas_primary #161513
odaas_on_primary_variant_dark Color de texto utilizado con el color odaas_primary_variant_dark. #161513
odaas_on_primary_variant_light Color de texto utilizado con el color odaas_primary_variant_light. @android:color/black
odaas_on_secondary Color de texto utilizado con el color odaas_secondary. #161513
odaas_on_secondary_variant_light Color de texto utilizado con el color odaas_secondary_variant_light. @android:color/black
odaas_on_speech_view_background Color de texto que se utiliza con el color odaas_speech_view_background en el modo de voz. @android:color/white
odaas_on_status_bar_transparent Color de fondo de la barra de estado cuando se abre la vista web. @android:color/transparent
odaas_on_webview_header_background_redwood Color de fondo de la cabecera de vista web en widget en modo de tema Redwood #201E1C
odaas_person_avatar_background El color de fondo del avatar del usuario. #bdbdbd
odaas_primary Color de marca principal que se utiliza para el fondo del mensaje de la aptitud y para el fondo de los botones interactivos en el pie de página. #FFFFFF
odaas_primary_status_bar Color utilizado en la barra de estado. #DCD7D1
odaas_primary_variant_dark Variante oscura del color principal que se utiliza en la barra de aplicaciones y en las notificaciones. #F1EFED
odaas_primary_variant_light Variante clara del color principal que se utiliza en el fondo para los mensajes anexos de la aptitud. #E4E1DD
odaas_rating_star Color que indica que un usuario aún no ha seleccionado un botón de comentarios de calificación. @android:color/white
odaas_rating_star_fill Color que indica que un usuario ha seleccionado un botón de comentarios de calificación. #DAA520
odaas_secondary Color de marca secundario que se utiliza para el fondo de los mensajes de usuario y para el fondo de los botones de acción de la aptitud. #E4E1DD
odaas_secondary_variant_dark Variante oscura del color secundario que se utiliza para el fondo de los mensajes anexos del usuario. #CCCCCC
odaas_secondary_variant_light Variante de luz del color secundario que se utiliza en el fondo para los botones de acción que se han desactivado. #BDBDBD
odaas_selected_text_highlighted_color Color del texto resaltado para una operación de copia o uso compartido. #B6AFAF
odaas_speech_view_background Color de fondo del pie de página en el modo de voz. #FFFFFF
odaas_speech_view_button Color del botón Cancelar en el modo de voz. #161513
odaas_speech_visualizer_background Color de fondo del visualizador de voz en el modo de voz. #12000000
odaas_speech_visualizer_color Color de la barra del visualizador de voz en el modo de voz. #5C926D
odaas_timestamp_font_color Color de texto utilizado con el color odaas_timestamp_header_background en el modo de registro de hora relativo. #5b5652
odaas_timestamp_header_background Color de fondo utilizado con la cabecera de registro de hora en el modo de registro de hora relativo. #d3d3d3

Texto personalizado

Puede personalizar el texto por defecto mostrado en la vista de chat modificando las siguientes cadenas. Puede configurar estas cadenas definiendo los atributos name para los elementos <string> del archivo res/value/strings.xml del recurso de la aplicación utilizando las siguientes claves. Por ejemplo, para cambiar el título de la vista de chat, defina la clave odaas_bot_chat_title:
<resources>
    <string name="odaas_bot_chat_title">Support</string>
</resources>
En este ejemplo, solo se ha cambiado el título del chat. Los demás recursos de cadena mantienen sus valores por defecto.
Clave Descripción Valor por Defecto
odaas_bot_chat_title Título de la vista de chat que se muestra en la cabecera de la vista de chat. Este recurso solo se utiliza cuando el indicador de la función title no está definido. Digital Assistant
odaas_bot_status_connected Texto de estado que se muestra cuando se ha establecido la conexión entre la vista de chat y el servidor de chat de Oracle. Connected
odaas_bot_status_connecting Texto de estado que se muestra mientras la vista de chat se conecta al servidor de chat de Oracle. Connecting
odaas_bot_status_disconnected Texto de estado que se muestra cuando se ha cerrado la conexión entre la vista de chat y el servidor de chat de Oracle. Disconnected
odaas_bot_status_responding Texto de estado que se muestra mientras el usuario espera la respuesta de la aptitud.

Esta cadena está en desuso en la versión 22.06.

Responding...
odaas_button_clear_label Texto del botón Borrar de la vista web. DONE
odaas_capture_photo Texto de la opción de menú en la ventana emergente de anexos que se utiliza para enviar fotos capturadas por la cámara del dispositivo que se van a cargar en el servidor como anexos. Capture Photo
odaas_captured_image_folder Nombre de la carpeta dentro del directorio Pictures donde se guardarán las imágenes en las que se ha hecho clic. Si no se han proporcionado personalizaciones, las imágenes en las que se ha hecho clic se guardan de forma predeterminada en la carpeta Cámara de DCIM. N/D
odaas_clear_messages_dialog_button_no Texto de la acción que aparece en un elemento emergente Borrar mensajes de una acción negativa. No
odaas_clear_messages_dialog_button_yes Texto de la acción que aparece en el elemento emergente Borrar mensajes de una acción positiva. Yes
odaas_content_desc_attachment_loaded Descripción del contenido del mensaje de anexo después de cargar el anexo correctamente. Open attachment
odaas_content_desc_attachment_loading Descripción del contenido del mensaje de anexo mientras se carga el anexo. Loading attachment
odaas_content_desc_attachment_loading_error Descripción del contenido del mensaje del anexo cuando el anexo no se carga. Error in loading attachment
odaas_content_desc_audio_pause Descripción del contenido del botón de pausa del reproductor de audio. Pause audio
odaas_content_desc_audio_play Descripción del contenido del botón de reproducción del reproductor de audio. Play audio
odaas_content_desc_button_attach Pista que aparece cuando se ha detectado un gesto de presión larga en el botón de anexo. Además, la descripción del contenido del botón de anexos. Upload Attachment
odaas_content_desc_button_audio_response_off Pista que aparece cuando se ha detectado un gesto de pulsación larga en el botón Silenciar para la respuesta de audio. Además, descripción del contenido del botón Silenciar de la respuesta de audio. Unmute
odaas_content_desc_button_audio_response_on Pista que aparece cuando se ha detectado un gesto de pulsación larga en el botón Reactivar para la respuesta de audio. Además, descripción del contenido del botón Reactivar de la respuesta de audio. Mute
odaas_content_desc_button_back Pista que aparece cuando se ha detectado un gesto de presión larga en el botón Atrás de la cabecera de la vista de chat. Además, la descripción del contenido del botón Atrás. Navigate Up
odaas_content_desc_button_cancel Pista que aparece cuando se detecta un gesto de pulsación larga en el botón del teclado que se muestra mientras se graba el mensaje de voz del usuario. Además, es la descripción del contenido del botón del teclado. Cancel
odaas_content_desc_button_clear Pista que aparece cuando se ha detectado un gesto de presión larga en el botón Borrar. Además, descripción del contenido del botón Borrar. Clear Chat
odaas_content_desc_button_download Pista que aparece cuando se ha detectado un gesto de presión larga en el botón Descargar. Además, descripción del contenido del botón Descargar. Download
odaas_content_desc_button_end_conversation Descripción del contenido del botón Finalizar conversación. End Conversation
odaas_content_desc_button_notification_sound_off Pista que aparece cuando se ha detectado un gesto de pulsación larga en el botón Silenciar para el sonido de notificación. Además, la descripción del contenido del botón Silenciar del sonido de notificación. Turn On Notification Sound
odaas_content_desc_button_notification_sound_on Pista que aparece cuando se ha detectado un gesto de pulsación larga en el botón Reactivar del sonido de notificación. Además, la descripción del contenido del botón Reactivar del sonido de notificación. Turn Off Notification Sound
odaas_content_desc_button_send Pista que aparece cuando se ha detectado un gesto de pulsación larga en el botón Enviar. Además, descripción del contenido del botón Enviar. Send
odaas_content_desc_button_speak Pista que aparece cuando se ha detectado un gesto de presión larga en el botón Micrófono. Además, descripción del contenido del botón Micrófono. Speak
odaas_content_desc_location_loaded Descripción del contenido del mensaje de ubicación después de cargar correctamente la imagen de vista previa de ubicación. Open Location in Maps
odaas_content_desc_location_loading Descripción del contenido del mensaje de ubicación mientras se carga la imagen de vista previa de ubicación. Loading location preview image
odaas_content_desc_location_loading_error Descripción del contenido del mensaje de ubicación cuando falla la carga de la imagen de vista previa de ubicación. Error in loading location preview image. Tap to reload image.
odaas_content_desc_multi_lang_chat Texto que aparece junto con el icono de detección de idioma en el menú de desbordamiento. Select Language
odaas_content_desc_read_status Descripción de contenido de la marca ('✓') para los mensajes leídos. Esta cadena solo aparece cuando enableTimestamp está definido en true. Read
odaas_content_desc_video_pause Descripción del contenido del botón Pausa del reproductor de vídeo. Pause video
odaas_content_desc_video_play Descripción del contenido del botón de reproducción del reproductor de vídeo. Play video
odaas_content_timestamp_a_few_moments_ago Registro de hora relativo que se muestra diez segundos después de que se haya recibido el mensaje y antes de que transcurran 60 segundos desde que se haya recibido el último mensaje. a few moments ago
odaas_content_timestamp_day Registro de hora relativo que aparece cada día desde que se ha recibido el mensaje anterior. %1$s se sustituye por el número de días transcurridos. %1$sd ago
odaas_content_timestamp_hour El registro de hora relativo que se muestra cada hora durante las primeras 24 horas posteriores a la recepción del mensaje anterior. %1$s se sustituye por el número de horas transcurridas. %1$shr ago
odaas_content_timestamp_min Registro de hora relativo que aparece cada minuto desde que se ha recibido el último mensaje. %1$s se sustituye por el número de minutos transcurridos. %1$smin ago
odaas_content_timestamp_month Registro de hora relativo que aparece cada mes desde que se ha recibido el mensaje anterior. %1$s se sustituye por el número de meses transcurridos. %1$smth ago
odaas_content_timestamp_now Registro de hora relativo que se muestra para un mensaje nuevo. Now
odaas_content_timestamp_year Registro de hora relativo que aparece cada año desde que se ha recibido el mensaje anterior. %1$s se sustituye por el número de años transcurridos. %1$syr ago
odaas_default_greeting_message Respuesta de saludo de cliente por defecto que se muestra cuando la respuesta de aptitud no se ha recibido en el número de segundos definido por defaultGreetingTimeout. Hey, Nice to meet you! Allow me a moment to get back to you.
odaas_default_greeting_timeout Timeout por defecto, en segundos, tras el cual se muestra un mensaje de saludo por defecto. 5
odaas_default_sorry_message Respuesta de cliente por defecto cuando la respuesta de aptitud no ha recibido un mensaje en el número de segundos definido por typingIndicatorTimeout. `I'm sorry, but I can't get the right content right now. Please try again.`
odaas_default_wait_message Respuesta por defecto que se muestra en el intervalo en el que no se ha recibido una respuesta de aptitud real. Este intervalo se define, en segundos, por defaultWaitMessageInterval. I'm still working on your request. Thank you for your patience!
odaas_default_wait_message_interval el intervalo por defecto, en segundos, que muestra el mensaje de espera por defecto. 5
odaas_dialog_text_clear_messages Texto mostrado en un elemento emergente que solicita confirmación al usuario antes de borrar los mensajes. Clear messages?
odaas_download_dialog_message Mensaje del cuadro de diálogo emergente de descarga que se muestra cuando un usuario inicia una descarga desde la vista web del widget. Do you want to save
odaas_download_dialog_negative_button Texto del botón negativo del cuadro de diálogo de descarga que cancela una descarga que un usuario ha iniciado desde la vista web en el widget. Cancel
odaas_download_dialog_positive_button Texto del botón negativo del cuadro de diálogo de descarga que confirma una descarga que un usuario ha iniciado desde la vista web en el widget. Yes
odaas_download_dialog_title Título del cuadro de diálogo emergente de descarga que se muestra cuando un usuario inicia una descarga desde la vista web del widget. Download
odaas_end_conversation_action_yes Texto del botón Confirmar en la petición de confirmación de sesión final. Yes
odaas_end_conversation_alert_message Cuerpo del mensaje del campo de confirmación de fin de conversación. This will also clear your conversation history.
odaas_end_conversation_alert_no Texto del botón Rechazar en la petición de confirmación de sesión final. No
odaas_end_conversation_alert_title Título del campo de confirmación de fin de conversación. Are you sure you want to end the conversation?
odaas_error_in_capturing_photo Mensaje de error que se muestra cuando se produce un error al capturar una foto de la cámara del dispositivo. Error in capturing photo.
odaas_error_in_recording_audio Mensaje de error que se muestra cuando se produce un error al establecer la conexión con el servidor de voz de Oracle. Error in recording audio. Please try again later.
odaas_error_in_speech_recognition Mensaje de error que se muestra cuando no se proporciona ninguna entrada o hay demasiadas entradas en la voz. Speech Recognition Error.
odaas_error_speech_unsupported_locale Mensaje de error que se muestra cuando se intenta realizar una grabación de voz y se ha configurado una configuración regional de voz no soportada para el reconocimiento de voz. The set speech locale is not supported. Can not start recording.
odaas_file_uploading_in_progress Texto que se muestra en la ventana emergente mientras se carga el anexo de un usuario en el servidor de Oracle. Uploading file to server.....
odaas_hint_edit_text_user_message Texto del marcador de posición que aparece en el campo de entrada del usuario. Type your message
odaas_hint_text_view_speech_mode Texto del marcador de posición que aparece en la vista de texto del modo de voz antes de que el usuario empiece a hablar. Speak your message
odaas_no_messages_to_clear Mensaje que se muestra cuando no hay mensajes que borrar. No messages to clear
odaas_no_speech_error Texto de estado que se muestra cuando el servidor de chat no puede reconocer una voz porque no se ha detectado ningún dato del usuario. Could not detect the voice, no message sent.
odaas_notification_attachment_message Mensaje que se muestra en la notificación para un mensaje de anexo que se recibe de la aptitud. El texto para %1$s se define en Notification title que se define mediante la clase NotificationCustomizer, descrita en el SDK (disponible en la página de descarga de ODA y OMC). %1$s has sent you an Attachment Message.
odaas_notification_card_message Mensaje que se muestra en la notificación de un mensaje de tarjeta que se recibe de la aptitud. El texto para %1$s se define en Notification title que se define mediante la clase NotificationCustomizer, descrita en el SDK (disponible en la página de descarga de ODA y OMC). %1$s has sent you a Card Message.
odaas_notification_card_message Mensaje que se muestra en la notificación de un mensaje de tarjeta recibido de la aptitud.  
odaas_notification_fallback_message Mensaje de reserva que se muestra en la notificación de un mensaje recibido de la aptitud. El texto para %1$s se define en Notification title que se define mediante la clase NotificationCustomizer, descrita en el SDK (disponible en la página de descarga de ODA y OMC). %1$s has sent you a Message.
odaas_notification_fallback_message Mensaje de reserva que se muestra en la notificación de un mensaje recibido de la aptitud.  
odaas_notification_intent Actividad que se va a abrir, cuando el usuario la toca, en las notificaciones recibidas del SDK. El texto para %1$s se define en Notification title que se define mediante la clase NotificationCustomizer, descrita en el SDK (disponible en la página de descarga de ODA y OMC). oracle.cloud.bots.mobile.ui.ConversationActivity
odaas_notification_location_message Mensaje que se muestra en la notificación de un mensaje de ubicación recibido de la aptitud. El texto para %1$s se define en Notification title que se define mediante la clase NotificationCustomizer, descrita en el SDK (disponible en la página de descarga de ODA y OMC). %1$s has sent you a Location Message.
odaas_page_loading Texto dentro de la ventana emergente mientras se carga una página dentro de una vista web. Please Wait...Page is Loading.
odaas_require_audio_recording_permission Mensaje de error que se muestra cuando los usuarios deniegan el permiso para grabar el audio. Audio recording permission is needed to record audio
odaas_require_download_to_storage_access_permission Mensaje de error que se muestra cuando los usuarios deniegan el permiso de acceso de almacenamiento para guardar el archivo descargado. Storage access permission is needed to download file
odaas_require_location_permission Mensaje de error que se muestra cuando los usuarios deniegan el permiso para acceder a sus ubicaciones. Location access permission is needed to track location
odaas_require_storage_access_permission Mensaje de error que se muestra cuando se ha denegado el acceso al almacenamiento. Storage access permission is needed to attach files
odaas_share_audio Texto de la opción de menú de la ventana emergente del anexo que se utiliza para compartir el archivo de audio. Share Audio
odaas_share_file Texto de la opción de menú de la ventana emergente del anexo que se utiliza para compartir un archivo genérico. Share File
odaas_share_message_chooser_title Título del selector de aplicaciones que se muestra cuando el usuario hace clic en la acción Compartir. Share using:
odaas_share_visual Texto de la opción de menú de la ventana emergente del anexo que se utiliza para compartir un archivo de imagen o de vídeo. Share Image/Video
odaas_skill_message Indicador de mensaje de aptitud para lectores de pantalla. Lo leen los lectores de pantalla antes que la respuesta de la aptitud. El texto no se muestra en la vista de chat. Skill says:
odaas_speech_to_text_dialog_placeholder Texto del marcador de posición que se muestra en el elemento emergente de reconocimiento de voz antes de que el usuario empiece a hablar. Esta propiedad está en desuso en la versión 20.8.1. A partir de esa versión, se ignorará la configuración de esta propiedad. Listening.....
odaas_star_rating Mensaje que se lee en voz alta cuando se hace clic en un botón de calificación de usuario mientras el usuario está en modo de accesibilidad. Rate %1$s star
odaas_too_much_speech_error Mensaje de error que se muestra cuando un usuario proporciona un mensaje de voz que es demasiado largo para ser reconocido. Too much voice input to recognize. Can not generate recognized text.
odaas_user_message Indicador de mensaje de usuario para lectores de pantalla. Lo hablan los lectores de pantalla antes que los mensajes de usuario. I say:

Localización

Para localizar estas cadenas, defina los atributos name para los elementos <string> del archivo res/values-<your-language-code>/strings.xml del recurso de la aplicación con las claves. Por ejemplo, para localizar el título de la vista de chat en inglés, defina lo siguiente en un archivo denominado res/value-en/strings.xml:
<resources>
    <string name="odaas_bot_chat_title">Support</string>
</resources>
Para localizar el título en francés, debe agregar lo siguiente a un archivo denominado res/value-fr/strings.xml:
<resources>
    <string name="odaas_bot_chat_title">Soutien</string>
</resources>
Los valores de res/value/strings.xml se utilizan por defecto para las claves que no se encuentran en res/values-<your-language-code>/strings.xml. Para estos dos ejemplos, se utilizarían los valores por defecto para los recursos que no están definidos en los archivos res/value-fr/strings.xml o res/value-en/strings.xml.

Iconos personalizados

Configure los elementos de dibujo agregando las imágenes o los activos de vector necesarios a la carpeta res/drawable del recurso de la aplicación que tengan los siguientes nombres.
Nombre Descripción
ic_odaas_agent_avatar Icono del avatar para los mensajes del agente en directo. Este icono solo se muestra en las notificaciones cuando el indicador de la función showBotAvatar se define en true.
ic_odaas_bot_avatar Icono de avatar para los mensajes de la aptitud. Este icono solo se muestra en las notificaciones cuando el indicador de la función showBotAvatar se define en true.
ic_odaas_download Icono de descarga que aparece en el mensaje de anexo que envía la aptitud.
ic_odaas_image_zoom Icono del control de zoom que aparece en un mensaje de anexo de imagen enviado por la aptitud.
ic_odaas_notification_app_icon Icono de aplicación que se muestra en la barra de estado y en las notificaciones recibidas de la biblioteca de SDK.
ic_odaas_person_avatar Icono de avatar para los mensajes de usuario.
ic_odaas_rating Icono utilizado para el botón de calificación de comentarios.

Definición de indicadores de funciones

Utilice la clase BotsConfiguration.BotsConfigurationBuilder para inicializar la clase BotsConfiguration.

Utilice estos constructores:
  • BotsConfiguration.BotsConfigurationBuilder(String chatServerUrl, boolean clientAuthEnabled, Context context)
    Parámetros:
    • chatServerUrl: URL al servidor de chat y anexos de Oracle. Esto no puede ser nulo.
    • clientAuthEnabled: determina si la configuración de autenticación del cliente del canal está activada o desactivada.
    • context: contexto de aplicación. Esto no puede ser nulo.
    BotsConfiguration botsConfiguration = new BotsConfiguration.BotsConfigurationBuilder(<SERVER_URI>, false, getApplicationContext())
  • BotsConfiguration.BotsConfigurationBuilder(String chatServerUrl, Context context): se puede utilizar para establecer una conexión con el canal con la autenticación de cliente activada.
    Parámetros:
    • chatServerUrl: URL al servidor de chat y anexos de Oracle. Esto no puede ser nulo.
    • context: contexto de aplicación. Esto no puede ser nulo.
    BotsConfiguration botsConfiguration = new BotsConfiguration.BotsConfigurationBuilder(<SERVER_URI>, getApplicationContext())

Inicialización del SDK

Utilice los siguientes métodos para inicializar el SDK:
  • public static void init(Application application, BotsConfiguration botsConfiguration)
  • public static void init(Application application, BotsConfiguration botsConfiguration, BotsCallback botsCallback)
  • public static void init(Application application, String chatServerUrl, String channelId, String userId, BotsCallback botsCallback)
  • public static void init(Application application, String chatServerUrl, AuthenticationTokenProvider authTokenProvider, BotsCallback botsCallback)

public static void init(Application application, BotsConfiguration botsConfiguration)

El método public static void init(Application application, BotsConfiguration botsConfiguration) inicializa todos los servicios según la instancia BotsConfiguration transferida por el usuario y establece la conexión WebSocket al servidor de chat de Oracle.

Parámetros:
  • application: instancia de la aplicación. Esto no puede ser nulo.
  • botsConfiguration: objeto BotsConfiguration utilizado para controlar las funciones de la biblioteca. Esto no puede ser nulo.
Bots.init(getApplication(),
      botsConfiguration);

public static void init(Application application, BotsConfiguration botsConfiguration, BotsCallback botsCallback)

El método public static void init(Application application, BotsConfiguration botsConfiguration, BotsCallback botsCallback) inicializa todos los servicios según la instancia BotsConfiguration transferida por el usuario y establece la conexión de WebSocket al servidor de chat de Oracle.

Parámetros:
  • application: instancia de la aplicación. Esto no puede ser nulo.
  • botsConfiguration: objeto BotsConfiguration utilizado para controlar las funciones de la biblioteca. Esto no puede ser nulo.
  • botsCallback: devolución de llamada recibida al establecer la conexión.
Bots.init(getApplication(), botsConfiguration, new BotsCallback() {
    @Override
    public void onSuccess(Response paramResponse) {}
 
    @Override
    public void onFailure(Response paramResponse) {}
});

public static void init(Application application, String chatServerUrl, String channelId, String userId, BotsCallback botsCallback)

El método public static void init(Application application, String chatServerUrl, String channelId, String userId, BotsCallback botsCallback) inicializa todos los servicios con la configuración por defecto. Se puede llamar a este método para conectarse a un canal con la autenticación de cliente desactivada.

Parámetros:
  • application: instancia de la aplicación. Esto no puede ser nulo.
  • chatServerUrl: URL del servidor de chat de Oracle. Esto no puede ser nulo.
  • channelId: ID de canal que pertenece al canal de Oracle Android que se enruta a la aptitud o al asistente digital. Esto no puede ser nulo.
  • userId: identificador único para el usuario. El SDK inicializa este valor cuando no se proporciona.
  • botsCallback: devolución de llamada recibida al establecer la conexión con el servidor de chat de Oracle.
Bots.init(getApplication(), chatServerUrl, authTokenProvider, new BotsCallback() {
    @Override
    public void onSuccess(Response paramResponse) {}
 
    @Override
    public void onFailure(Response paramResponse) {}
});

public static void init(Application application, String chatServerUrl, AuthenticationTokenProvider authTokenProvider, BotsCallback botsCallback

Llame al método public static void init(Application application, String chatServerUrl, AuthenticationTokenProvider authTokenProvider, BotsCallback botsCallback para conectar a un canal que tenga activada la autenticación de cliente. Este método inicializa todos los servicios con la configuración por defecto.

Parámetros:
  • application: instancia de la aplicación. Esto no puede ser nulo.
  • chatServerUrl: URL del servidor de chat de Oracle. Esto no puede ser nulo.
  • authTokenProvider: instancia de AuthenticationTokenProvider, que se utiliza para generar el token de autenticación siempre que sea necesario.
  • botsCallback: devolución de llamada recibida al establecer la conexión.
BotsConfiguration botsConfiguration = new BotsConfiguration.BotsConfigurationBuilder(<SERVER_URI>, getApplicationContext())

Interfaz AuthenticationTokenProvider

El método public String getAuthToken devuelve la cadena del token generado.

Se puede transferir una instancia de esta interfaz a la propiedad authTokenProvider para permitir que el SDK genere un nuevo token de autenticación cuando sea necesario para establecer una conexión de canal autenticado. Al implantar esta interfaz, sustituya el método public String getAuthToken.
private class AuthTokenProvider implements AuthenticationTokenProvider {
    @Override
    public String getAuthToken() {
        // Generate a new JWT Token and return
    }
}

Interfaz BotsCallback

Esta interfaz actúa como una devolución de llamada durante la inicialización de la biblioteca.
  • void onSuccess(Response paramResponse): se llama a este método cuando la conexión al socket web se establece correctamente.
  • void onFailure(Response paramResponse): este método se llama cuando se produzca cualquier fallo al inicializar la biblioteca.

Mostrar actividad de conversación

Después de inicializar el SDK, muestre la vista de conversación llamando a public static void show(Context context). El parámetro context de este método es el contexto desde el que se inicia la actividad.
ConversationActivity.show(getApplicationContext())

Personalizar notificaciones

Puede personalizar las notificaciones recibidas para los mensajes de la aptitud mediante la creación de instancias de la clase NotificationCustomizer y la transferencia de la instancia a la propiedad notificationCustomizer. Los constructores son:
  • NotificationCustomizer(): inicializa el canal de notificación con la configuración por defecto.
  • NotificationCustomizer(String channelId): inicializa el canal de notificación con el ID de canal especificado. El parámetro channelId es el ID del canal de notificación a través del cual se envían las notificaciones.
  • NotificationCustomizer(String channelId, String channelName, String description, String title): inicializa el canal de notificación con los parámetros especificados:
    • channelID: ID del canal de notificación a través del que se envían las notificaciones.
    • channelName: nombre del canal de notificación a través del que se envían las notificaciones.
    • description: descripción del canal de notificación a través del cual se envían las notificaciones.
    • title: título mostrado en las notificaciones.
Por ejemplo:
new BotsConfiguration.NotificationCustomizer(<NOTIFICATION_CHANNEL_ID>,
    <NOTIFICATION_CHANNEL_NAME>, <NOTIFICATION_CHANNEL_DESCRIPTION>, <NOTIFICATION_TITLE>);