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. | Sí | 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. | Sí | 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 |
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 |
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
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>
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
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
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
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
.
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
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.
application
: instancia de la aplicación. Esto no puede ser nulo.botsConfiguration
: objetoBotsConfiguration
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.
application
: instancia de la aplicación. Esto no puede ser nulo.botsConfiguration
: objetoBotsConfiguration
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.
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.
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 deAuthenticationTokenProvider
, 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.
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
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
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
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ámetrochannelId
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.
new BotsConfiguration.NotificationCustomizer(<NOTIFICATION_CHANNEL_ID>,
<NOTIFICATION_CHANNEL_NAME>, <NOTIFICATION_CHANNEL_DESCRIPTION>, <NOTIFICATION_TITLE>);