Configurações de desenvolvimento de aplicativos

Aqui está uma referência às configurações que você pode usar no desenvolvimento do aplicativo para o seu canal Android.

Configuração de Rede

Nome da Propriedade Descrição 0brigatório? Valor Padrão
channelId O ID do canal Oracle Android. Sim N/A
userId O identificador exclusivo do usuário. Este valor será inicializado pelo SDK se não for fornecido. No Um valor gerado aleatoriamente
authTokenProvider Uma instância do AuthenticationTokenProvider, que é usada para gerar um novo token sempre que o SDK precisar estabelecer uma nova conexão usando um canal ativado para autenticação de cliente e quando o token existente expirar. Sim N/A

Flags de Recurso

Propriedade Descrição 0brigatório? Valor Padrão
actionsLayout Um objeto do tipo ActionsLayout que define a orientação de layout de ações locais, globais, de cartão e de formulário. No new ActionsLayout(LayoutOrientation.VERTICAL, LayoutOrientation.VERTICAL, LayoutOrientation.VERTICAL, LayoutOrientation.VERTICAL)
disablePastActions Um campo para desativar os cliques do botão nas mensagens com as quais um usuário já interagiu. Os valores permitidos são all, none e postback. O comportamento ativado por essa propriedade é independente da configuração no nível do assistente digital para desativar a seleção de ações anteriores. É necessário definir os dois valores separadamente. No all
displayPreviousMessages Ativa ou desativa a exibição de mensagens anteriores depois que o SDK foi reinicializado. Quando definido como false, as mensagens anteriores não são exibidas para o usuário após a reinicialização do SDK. No true
enableAgentSneakPreview Envia o texto inserido pelo usuário junto com o status de digitação para o agente. No false
enableArrowsForHorizontalCards Ativa setas de navegação para a exibição de cartão na horizontal quando definido como true, mas as desativa quando definido como false. No false
enableAttachment Ativa o compartilhamento de anexos na view de chat. Quando definido como true, você pode restringir os itens que estão disponíveis na lista pop-up do menu de compartilhamento usando shareMenuItems.

Esta configuração está obsoleta na Versão 22.02. Em vez disso, use timeStampType.

No true
enableAttachmentSecurity Quando definido como true, cabeçalhos extras são transmitidos às solicitações de upload de anexo para garantir que eles não possam ser baixados sem transmitir um token JWT assinado válido como cabeçalho de autorização.

Observação: Não ative essa definição se a habilidade estabelecer conexão com uma instância do ODA Versão 20.08 ou for executada em qualquer versão anterior à 20.08. Esta propriedade só se aplica a conexões ativadas por autenticação do cliente com as Versões 20.12 e superior da plataforma ODA.

No false
enableClearMessage Ativa o botão Limpar Mensagem no cabeçalho da view de chat. No false
enableDefaultClientResponse Quando definido como true, o cliente exibe respostas padrão quando a resposta da habilidade foi atrasada ou quando não há resposta da habilidade. No false
enableEndConversation Permite que o usuário encerre a conversa e redefina a sessão de chat. Também limpa o histórico de conversas locais, desconecta-se do servidor de chat e fecha a atividade No true
enableNotification Ativa ou desativa novas notificações de mensagem do SDK quando o aplicativo de chat está em execução em segundo plano. O SDK não fornecerá notificações quando você definir esse flag como false. No true
enableNotificationSound Ativa o som de notificação em novas mensagens de habilidade enquanto a exibição de chat está aberta. Esse recurso só se aplica quando a propriedade enableNotificationSoundSetting está definida como false. No true
enableNotificationSoundSetting Ativa o botão de definição do som da notificação no cabeçalho da view de chat. No false
enableSendTypingStatus Envia o status de digitação do usuário para o agente ativo. No false
enableSpeechRecognition Permite que o serviço de reconhecimento de fala converta a voz do usuário em mensagens de texto. Defina essa propriedade como true para usar a propriedade enableSpeechRecognitionAutoSend. No false
enableSpeechRecognitionAutoSend Quando a propriedade enableSpeechRecognitionAutoSend é definida como true (o padrão), a resposta de fala do usuário é automaticamente enviada ao servidor de chat (e é exibida como uma mensagem enviada na janela de chat). Quando definida como false, a resposta de fala do usuário é renderizada no campo de texto da mensagem antes de ser enviada ao servidor de chat para que o usuário possa modificá-la antes de enviá-la manualmente ou excluir a mensagem.

Essa funcionalidade só está disponível quando a propriedade enableSpeechRecognition está definida como true.

No true
enableSpeechSynthesis Ativa o botão de resposta de áudio da habilidade no cabeçalho da view de chat. Quando o botão está no estado de silêncio desativado, as respostas da habilidade são lidas em voz alta. No false
enableTimestamp Ativa o timestamp para mensagens. No true
googleMapsApiKey A chave da API do Google Maps que é usada para exibir uma imagem de visualização de localização para Mensagens de localização. No N/A
initSpeechSynthesisMuted Esse flag, que só é aplicável quando a propriedade enableSpeechSynthesis é true, determina se o botão de resposta de áudio da habilidade estará ativo (silêncio desativado) por padrão inicialmente ou silenciado. Por padrão, ele é definido como true, no qual o botão está silenciado. No true
initUserHiddenMessage Uma mensagem de texto do usuário que é usada para iniciar uma conversa. Essa mensagem, que é enviada quando a view de chat está pronta, não é realmente exibida no chat. No N/A
initUserProfile Inicializa o perfil do usuário antes que a conversa seja iniciada. O payload do perfil deve ser do tipo User. O perfil é atualizado antes do envio do valor em initUserHiddenMessage. No N/A
linkHandler Um campo usado para definir o handler de links para abrir links, em uma webview ou em um browser. WebviewLinkHandlerType é uma enumeração com dois valores: BROWSER e WEBVIEW. No WebviewLinkHandlerType.BROWSER
messageModifierDelegate Uma instância do tipo MessageModifierDelegate que é usada para receber callbacks antes de determinados eventos na conversa. No N/A
multiLangChat Permite que o widget de chat detecte o idioma de um usuário e permita que o usuário selecione um idioma preferencial em um menu drop-down no cabeçalho. O Chat Multilíngue descreve como criar esse menu. No  
notificationCustomizer Uma instância da classe NotificationCustomizer que é usada para personalizar notificações recebidas do SDK. No N/A
reconnectMaxAttempts O número de tentativas feitas pelo widget de chat para reconectar quando a conexão inicial falha. No 5
saveClickedImagesInGallery Quando definida como true (o padrão), uma imagem capturada pelos usuários da habilidade que usam a câmera será salva na galeria e será carregada diretamente na habilidade como um anexo. Se você não quiser que as imagens sejam salvas na galeria, defina saveClickedImagesInGallery como false. No true
shareMenuItems Restringe os itens exibidos no item de menu de compartilhamento e personaliza os ícones e os labels do menu. Para configurar esses itens, informe um ArrayList de Objetos para shareMenuItems. Os objetos Arraylist podem ser valores de enumeração ShareMenuItem que são mapeados para os itens do menu de compartilhamento ou um objeto ShareMenuCustomItem. Para usar esse flag, defina enableAttachment como true. No N/A
showBotAvatar Ativa a exibição do ícone de avatar da habilidade ao lado das mensagens da habilidade. No false
showConnectionStatus Permite que o status da conexão seja exibido no cabeçalho da view de chat. No false
showPersonAvatar Ativa a exibição do ícone de avatar da habilidade ao lado das mensagens da habilidade nas notificações. Se sua habilidade tiver integração de agente ao vivo, a definição desse flag como true exibirá o ícone de avatar do agente ao lado das mensagens do agente e nas notificações. No false
showTypingIndicator Permite que o indicador de digitação seja exibido enquanto aguarda a resposta da habilidade. Número true
showUserAvatar Ativa a exibição de um ícone de avatar do usuário ao lado de mensagens do usuário. Número false  
speechLocale A configuração regional esperada de fala do usuário que é usada para reconhecimento de voz. As configurações regionais suportadas são o inglês australiano (en-au), o inglês britânico (en-gb), o francês (fr-fr), o alemão (de-de), o hindi indiano (hi-in), o inglês indiano (en-in), o italiano (it-it), o português do Brasil (pt-br), o espanhol (es-es) e o inglês americano padrão (en-us). Chame a API Bots.setSpeechLocale(<locale>) para definir a configuração regional de fala dinamicamente. O reconhecimento de voz não funcionará se uma configuração regional não suportada tiver sido informada. Número "en-us"
speechSynthesisService Uma instância do SpeechSynthesisService que é usada para injetar um serviço de texto em fala (TTS). Aplicável somente se enableSpeechSynthesis estiver definido como true. Número N/A
speechSynthesisVoicePreferences Configura o idioma e a voz que leem as mensagens da habilidade em voz alta, usando uma lista de instâncias do tipo SpeechSynthesisSetting como parâmetro. Se o dispositivo não suportar a voz preferencial, será usada a voz padrão do idioma preferencial. Quando não há suporte nem para a voz nem para o idioma preferenciais, a voz e o idioma padrão são usados. Número N/A
subtitle Define o subtitle da view de chat, que é exibido abaixo do título no cabeçalho da view de chat. Se o flag subtitle estiver definido e uma das propriedades showConnectionStatus, showTypingIndicator (ou ambas) estiverem definidas como true, o subtítulo será exibido, em vez do status da conexão ou do indicador de digitação. Número N/A
timestampFormat Formata os timestamps exibidos nas mensagens. Ela pode aceitar uma string de tokens de formato como 'mm:ss:a'. Consulte a documentação do Android para obter informações sobre padrões válidos de timestamp Número N/A
timestampType Se você ativar timestamps definindo enableTimestamp como true, poderá usar um timestamp relativo que apareça apenas na mensagem mais recente, definindo timestampType: 'relative'. N/A  
title Define o título no cabeçalho da view de chat. Número N/A
typingIndicatorTimeout Define o número de segundos após o qual o indicador de digitação será removido automaticamente se a view de chat ainda não tiver recebido a resposta. Número 30
typingStatusInterval Define o intervalo, em segundos, para limitar o status de digitação que é enviado ao agente ativo. No 3
WebViewConfig Define os atributos do webview in-widget, como tamanho (parcial ou completo) ou personalizações para o botão Limpar. Também é possível fazer personalizações do botão Limpar dentro da webview. No Define as configurações da webview.
youtubeApiKey Suporta o streaming de vídeos do YouTube definindo a chave da API do YouTube. No N/A

Cores Personalizadas

Você pode modificar as cores da view de chat para dar a ela uma aparência personalizada. Para configurar essas cores, defina atributos name para os elementos <color> no arquivo res/values/colors.xml (localizado nos recursos do aplicativo do projeto) usando as chaves a seguir. O trecho de código a seguir demonstra uma modificação da cor usada para o segundo plano da mensagem da habilidade (odaas_primary) e da cor do texto usada na mensagem da habilidade (odaas_on_primary), mantendo as cores padrão para outros recursos.
<resources>
    <color name="odaas_primary">#6699FF</color>
    <color name="odaas_on_primary">#000000</color>
</resources>
Observação

A Versão 20.8.1 do SDK redefine as cores das versões anteriores. Por exemplo, se a cor de fundo dos botões de ação na implementação existente for #418980, isso será alterado para a cor padrão odaas_action_background (introduzida na versão 20.8.1), que é #FFFFFF. Para implementações criadas usando versões anteriores à 20.8.1, você pode definir cores personalizadas atualizando o arquivo res/values/colors.xml no seu aplicativo. Por exemplo :
<resources>
        <color name="odaas_action_background">#418980</color>
    </resources>
Chave Descrição Valor Padrão
odaas_action_background A cor de fundo dos botões de ação e ação global. #FFFFFF
odaas_agent_avatar_background_color A cor de fundo usada para o layout do avatar quando o avatar do agente está indisponível e as iniciais do nome do agente são exibidas. #A890B6
odaas_agent_avatar_text_color A cor do texto usada para as iniciais do nome do agente que são exibidas dentro do layout do avatar do agente. #FFFFFF
odaas_agent_name_text_color A cor do texto usada para o nome do agente que é exibido acima das mensagens do agente. #A6161513
odaas_background A cor de fundo da view. #F5F4F2
odaas_bot_avatar_background A cor de fundo usada para o avatar da habilidade. #bdbdbd
odaas_bot_avatar_background A cor do fundo do avatar da habilidade. #bdbdbd
odaas_card_background A cor de fundo das mensagens do cartão e seus botões de ação. FFFFFF
odaas_dialog_accent A cor usada para botões e barras de progressão na janela de caixa de diálogo que é mostrada antes de limpar mensagens e ao fazer upload de anexos. 161513
odaas_dialog_background A cor de fundo da janela de caixa de diálogo que é mostrada antes de limpar mensagens e ao fazer upload de anexos. #FFFFFF
odaas_dialog_box_negative_button_background A cor de fundo do botão Recusar que aparece na caixa de diálogo de alerta. @android:color/transparent
odaas_dialog_box_negative_button_text_color A cor do texto do botão Recusar que aparece na caixa de diálogo de alerta. #161513
odaas_dialog_box_positive_button_background A cor do plano de fundo do botão de confirmação que aparece na caixa de diálogo de alerta. #161513
odaas_dialog_box_positive_button_text_color A cor do texto do botão de confirmação que aparece na caixa de diálogo de alerta. #FFFFFF
odaas_error A cor do texto que é usada em mensagens de erro. @android:color/white
odaas_footer_accent A cor da borda e do cursor do campo de entrada no rodapé. #01579B
odaas_footer_attach_button A cor do botão de anexo. #161513
odaas_footer_background A cor de fundo do rodapé. #FFFFFF
odaas_footer_buttons A cor de fundo dos botões interativos no rodapé, exceto o botão de envio. 161513
odaas_footer_inline_send_button A cor do botão de envio em linha que aparece no campo de entrada quando a propriedade enableSpeechRecognitionAutoSend está definida como true. #161513
odaas_footer_input_background A cor de fundo do campo de entrada no rodapé. #FFFFFF
odaas_footer_mic_button A cor do botão de microfone. #161513
odaas_footer_send_button A cor do botão de envio. #FFFFFF
odaas_footer_send_button_background A cor do plano de fundo do botão enviar. #161513
odaas_header_buttons A cor de fundo dos botões interativos no cabeçalho. #FFFFFF
odaas_on_action_background A cor do texto usada com a cor odaas_action_background. @android:color/black
odaas_on_background A cor do texto usada com a cor odaas_background. @android:color/black
odaas_on_card_action_text A cor do texto dos botões de ação no cartão. @android:color/black
odaas_on_card_description_text A cor do texto usada para a descrição do cartão. @android:color/white
odaas_on_card_title_text A cor do texto usada para o título do cartão. @android:color/white
odaas_on_dialog_background A cor do texto usada com odaas_dialog_background color nas janelas de caixa de diálogo. @android:color/black
odaas_on_footer_input_background A cor do texto usada com a cor odaas_footer_input_background no rodapé. @android:color/black
odaas_on_multichat_spinner_background A cor do plano de fundo do menu drop-down de chat com vários idiomas antes da abertura da janela pop-up. #F1EFED
odaas_on_multichat_spinner_popup_background A cor do plano de fundo do menu drop-down de chat com vários idiomas após a abertura da janela pop-up. #FFFFFF
odaas_on_multichat_spinner_popup_border A cor da borda dos itens do menu drop-down de chat com vários idiomas após a abertura da janela pop-up. #BDBDBD
odaas_on_multichat_spinner_popup_text_color A cor do texto usada nos itens do menu drop-down de chat com vários idiomas. @android:color/black
odaas_on_multichat_spinner_text_color A cor do texto de um item selecionado no menu drop-down de chat com vários idiomas. #161513
odaas_on_primary A cor do texto que é usada com a cor odaas_primary #161513
odaas_on_primary_variant_dark A cor do texto usada com a cor odaas_primary_variant_dark. #161513
odaas_on_primary_variant_light A cor do texto usada com a cor odaas_primary_variant_light. @android:color/black
odaas_on_secondary A cor do texto usada com a cor odaas_secondary. #161513
odaas_on_secondary_variant_light A cor do texto usada com a cor odaas_secondary_variant_light. @android:color/black
odaas_on_speech_view_background A cor do texto usada com a cor odaas_speech_view_background no modo de fala. @android:color/white
odaas_on_status_bar_transparent A cor do plano de fundo da barra de status quando a webview é aberta. @android:color/transparent
odaas_on_webview_header_background_redwood A cor do plano de fundo do cabeçalho da webview in-widget no modo Tema do Redwood #201E1C
odaas_person_avatar_background A cor de fundo do avatar do usuário. #bdbdbd
odaas_primary A cor da marca principal usada para o segundo plano da mensagem da habilidade e para o segundo plano dos botões interativos no rodapé. #FFFFFF
odaas_primary_status_bar A cor usada na barra de status. #DCD7D1
odaas_primary_variant_dark A variante escura da cor principal que é usada na barra de aplicativos e nas notificações. #F1EFED
odaas_primary_variant_light A variante clara da cor principal usada no segundo plano para as mensagens de anexo da habilidade. #E4E1DD
odaas_rating_star A cor que indica que um usuário ainda não selecionou um botão de feedback de classificação. @android:color/white
odaas_rating_star_fill A cor que indica que um usuário selecionou um botão de feedback de classificação. #DAA520
odaas_secondary A cor da marca secundária usada para o segundo plano das mensagens do usuário e para o segundo plano dos botões de ação da habilidade. #E4E1DD
odaas_secondary_variant_dark A variante escura da cor secundária que é usada para o segundo plano das mensagens de anexo do usuário. #CCCCCC
odaas_secondary_variant_light A variante clara da cor secundária que é usada em segundo plano para os botões de ações que foram desativados. #BDBDBD
odaas_selected_text_highlighted_color A cor do texto destacado para uma operação de cópia ou compartilhamento. #B6AFAF
odaas_speech_view_background A cor de fundo do rodapé no modo de fala. #FFFFFF
odaas_speech_view_button A cor do botão de cancelamento no modo de fala. #161513
odaas_speech_visualizer_background A cor de fundo do visualizador de fala no modo de fala. #12000000
odaas_speech_visualizer_color A cor da barra do visualizador de fala no modo de fala. #5C926D
odaas_timestamp_font_color A cor do texto usada com a cor odaas_timestamp_header_background no modo de timestamp relativo. #5b5652
odaas_timestamp_header_background A cor do plano de fundo usada com o cabeçalho de timestamp no modo de timestamp relativo. #d3d3d3

Texto personalizado

Você pode personalizar o texto padrão exibido na view de chat modificando as strings a seguir. Você pode configurar essas strings definindo os atributos name para os elementos <string> no arquivo res/value/strings.xml do recurso do aplicativo usando as seguintes chaves. Por exemplo, para alterar o título da view de chat, defina a chave odaas_bot_chat_title:
<resources>
    <string name="odaas_bot_chat_title">Support</string>
</resources>
Nesse exemplo, apenas o título do chat foi alterado. Os outros recursos de string mantêm seus valores padrão.
Chave Descrição Valor Padrão
odaas_bot_chat_title O título da view de chat exibido no cabeçalho da view de chat. Este recurso só é usado quando o flag da funcionalidade title não está definido. Digital Assistant
odaas_bot_status_connected O texto de status que é exibido quando a conexão entre a view de chat e o Oracle Chat Server foi estabelecida. Connected
odaas_bot_status_connecting O texto de status que é exibido enquanto a view de chat se conecta ao Oracle Chat Server. Connecting
odaas_bot_status_disconnected O texto de status que é exibido quando a conexão entre a view de chat e o Oracle Chat Server é fechada. Disconnected
odaas_bot_status_responding O texto de status que é exibido enquanto o usuário aguarda a resposta da habilidade.

Esta string está obsoleta na Versão 22.06.

Responding...
odaas_button_clear_label O texto do botão Limpar na webview. DONE
odaas_capture_photo O texto do item de menu no pop-up de anexo que é usado para enviar fotos capturadas pela câmera do dispositivo que serão submetidas a upload para o servidor como anexos. Capture Photo
odaas_captured_image_folder O nome da pasta dentro do diretório Fotos onde as imagens que foram clicadas serão salvas. Se nenhuma personalização tiver sido fornecida, por padrão, as imagens clicadas serão salvas dentro da pasta Camera do DCIM. N/A
odaas_clear_messages_dialog_button_no O texto da ação que aparece na janela pop-up Limpar Mensagens para uma ação negativa. No
odaas_clear_messages_dialog_button_yes O texto da ação que aparece na janela pop-up Limpar Mensagens para uma ação positiva. Yes
odaas_content_desc_attachment_loaded A descrição do conteúdo da mensagem de anexo após o carregamento do anexo com êxito. Open attachment
odaas_content_desc_attachment_loading A descrição do conteúdo da mensagem de anexo durante o carregamento do anexo. Loading attachment
odaas_content_desc_attachment_loading_error A descrição do conteúdo da mensagem de anexo quando ocorre falha ao carregar o anexo. Error in loading attachment
odaas_content_desc_audio_pause A descrição do conteúdo do botão de pausa do player de áudio. Pause audio
odaas_content_desc_audio_play A descrição do conteúdo do botão de reprodução do player de áudio. Play audio
odaas_content_desc_button_attach A dica de ferramenta que aparece quando um gesto longo de pressionamento é detectado no botão Anexo. E também a descrição do conteúdo do botão Anexo. Upload Attachment
odaas_content_desc_button_audio_response_off A dica de ferramenta que aparece quando um gesto longo de pressionamento é detectado no botão Silenciar para a resposta de áudio. E também a descrição do conteúdo do botão Silenciar da resposta de áudio. Unmute
odaas_content_desc_button_audio_response_on A dica de ferramenta que aparece quando um gesto longo de pressionamento é detectado no botão Desativar Silêncio para a resposta de áudio. E também a descrição do conteúdo do botão Desativar Silêncio da resposta de áudio. Mute
odaas_content_desc_button_back A dica de ferramenta que aparece quando um gesto longo de pressionamento é detectado no botão Voltar no cabeçalho da view de chat. E também a descrição do conteúdo do botão Voltar. Navigate Up
odaas_content_desc_button_cancel A dica de ferramenta que aparece quando um gesto de pressionamento longo é detectado no botão do teclado que é mostrado enquanto a mensagem de voz do usuário está sendo gravada. E também a descrição do conteúdo do botão de teclado. Cancel
odaas_content_desc_button_clear A dica de ferramenta que aparece quando um gesto longo de pressionamento é detectado no botão Limpar. E também a descrição do conteúdo do botão Limpar. Clear Chat
odaas_content_desc_button_download A dica de ferramenta que aparece quando um gesto longo de pressionamento é detectado no botão Fazer Download. E também a descrição do conteúdo do botão Fazer Download. Download
odaas_content_desc_button_end_conversation A descrição do conteúdo do botão Encerrar conversa. End Conversation
odaas_content_desc_button_notification_sound_off A dica de ferramenta que aparece quando um gesto longo de pressionamento é detectado no botão Silenciar para o som da notificação. E também a descrição do conteúdo do botão Silenciar do som da notificação. Turn On Notification Sound
odaas_content_desc_button_notification_sound_on A dica de ferramenta que aparece quando um gesto longo de pressionamento é detectado no botão Desativar Silêncio para o som de notificação. E também a descrição do conteúdo do botão Desativar Silêncio do som da notificação. Turn Off Notification Sound
odaas_content_desc_button_send A dica de ferramenta que aparece quando um gesto longo de pressionamento é detectado no botão Enviar. Além disso, a descrição do conteúdo do botão Enviar. Send
odaas_content_desc_button_speak A dica de ferramenta que aparece quando um gesto longo de pressionamento é detectado no botão Microfone. E também a descrição do conteúdo do botão Microfone. Speak
odaas_content_desc_location_loaded A descrição do conteúdo da mensagem de localização após o carregamento com sucesso da imagem de visualização de localização. Open Location in Maps
odaas_content_desc_location_loading A descrição do conteúdo da mensagem de localização durante o carregamento da imagem de visualização de localização. Loading location preview image
odaas_content_desc_location_loading_error A descrição do conteúdo da mensagem de localização quando ocorre falha no carregamento da imagem de visualização de localização. Error in loading location preview image. Tap to reload image.
odaas_content_desc_multi_lang_chat O texto que aparece junto com o ícone de detecção de idioma no menu de excesso. Select Language
odaas_content_desc_read_status A descrição do conteúdo da marca de seleção ('✓') para mensagens lidas. Esta string só aparece quando a propriedade enableTimestamp está definida como true. Read
odaas_content_desc_video_pause A descrição do conteúdo do botão Pausar do player de vídeo. Pause video
odaas_content_desc_video_play A descrição do conteúdo do botão Reproduzir do player de vídeo. Play video
odaas_content_timestamp_a_few_moments_ago O timestamp relativo que é exibido dez segundos depois que a mensagem foi recebida e antes de 60 segundos decorridos desde que a última mensagem foi recebida. a few moments ago
odaas_content_timestamp_day O timestamp relativo exibido todos os dias desde o recebimento da mensagem anterior. %1$s é substituído pelo número de dias decorridos. %1$sd ago
odaas_content_timestamp_hour O timestamp relativo exibido a cada hora das primeiras 24 horas após o recebimento da mensagem anterior. %1$s é substituído pelo número de horas decorridas. %1$shr ago
odaas_content_timestamp_min O timestamp relativo exibido a cada minuto desde o recebimento da última mensagem. %1$s é substituído pelo número de minutos decorridos. %1$smin ago
odaas_content_timestamp_month O timestamp relativo exibido todos os meses desde o recebimento da mensagem anterior. %1$s é substituído pelo número de meses decorridos. %1$smth ago
odaas_content_timestamp_now O timestamp relativo exibido para uma nova mensagem. Now
odaas_content_timestamp_year O timestamp relativo exibido a cada ano após o recebimento da mensagem anterior. %1$s é substituído pelo número de anos decorridos. %1$syr ago
odaas_default_greeting_message A resposta de saudação do cliente padrão que é exibida quando a resposta da habilidade não é recebida dentro do 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 O timeout padrão, em segundos, após o qual uma mensagem de saudação padrão é exibida. 5
odaas_default_sorry_message A resposta padrão do cliente quando a resposta da habilidade não recebeu uma mensagem dentro do 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 A resposta padrão que é exibida no intervalo quando uma resposta de habilidade real não é recebida. Esse intervalo é definido, em segundos, por defaultWaitMessageInterval. I'm still working on your request. Thank you for your patience!
odaas_default_wait_message_interval o intervalo padrão, em segundos, que a mensagem de espera padrão é exibida. 5
odaas_dialog_text_clear_messages O texto exibido em uma janela pop-up que solicita ao usuário a confirmação antes de limpar as mensagens. Clear messages?
odaas_download_dialog_message A mensagem no pop-up da caixa de diálogo de download que é exibida quando um usuário inicia um download dentro da webview in-widget. Do you want to save
odaas_download_dialog_negative_button O texto do botão negativo da caixa de diálogo de download que cancela um download iniciado por um usuário na webview in-widget. Cancel
odaas_download_dialog_positive_button O texto do botão negativo da caixa de diálogo de download que confirma um download iniciado por um usuário na webview in-widget. Yes
odaas_download_dialog_title O título do pop-up da caixa de diálogo de download que é exibido quando um usuário inicia um download dentro da webview in-widget. Download
odaas_end_conversation_action_yes O texto do botão de confirmação no prompt de confirmação da sessão final. Yes
odaas_end_conversation_alert_message O corpo da mensagem do prompt de confirmação da conversa final. This will also clear your conversation history.
odaas_end_conversation_alert_no O texto do botão Recusar no prompt de confirmação da sessão final. No
odaas_end_conversation_alert_title O título do prompt de confirmação da conversa final. Are you sure you want to end the conversation?
odaas_error_in_capturing_photo A mensagem de erro exibida quando ocorre um erro ao capturar uma foto da câmera do dispositivo. Error in capturing photo.
odaas_error_in_recording_audio A mensagem de erro exibida quando ocorre um erro ao estabelecer conexão com o servidor de fala da Oracle. Error in recording audio. Please try again later.
odaas_error_in_speech_recognition A mensagem de erro exibida quando nenhuma entrada ou muitas entradas são fornecidas na fala. Speech Recognition Error.
odaas_error_speech_unsupported_locale A mensagem de erro exibida quando há uma tentativa de gravação de voz e uma configuração regional de fala não suportada é configurada para reconhecimento de voz. The set speech locale is not supported. Can not start recording.
odaas_file_uploading_in_progress O texto exibido na janela pop-up ao fazer upload do anexo de um usuário no Oracle Server. Uploading file to server.....
odaas_hint_edit_text_user_message O texto do placeholder que aparece no campo de entrada do usuário. Type your message
odaas_hint_text_view_speech_mode O texto do placeholder que aparece na view de texto do modo de fala antes de o usuário comece a falar. Speak your message
odaas_no_messages_to_clear A mensagem exibida quando não há mensagens a serem limpas. No messages to clear
odaas_no_speech_error O texto de status exibido quando o Servidor de Chat não consegue reconhecer uma voz porque nenhuma entrada do usuário foi detectada. Could not detect the voice, no message sent.
odaas_notification_attachment_message A mensagem exibida na notificação de uma mensagem de anexo recebida da habilidade. O texto de %1$s é definido como o Notification title que é definido usando a classe NotificationCustomizer, descrita no SDK (disponível na página de download do ODA e OMC). %1$s has sent you an Attachment Message.
odaas_notification_card_message A mensagem exibida na notificação de uma mensagem de Cartão recebida da habilidade. O texto de %1$s é definido como o Notification title que é definido usando a classe NotificationCustomizer, descrita no SDK (disponível na página de download do ODA e OMC). %1$s has sent you a Card Message.
odaas_notification_card_message A mensagem exibida na notificação de uma mensagem de cartão recebida da habilidade.  
odaas_notification_fallback_message A mensagem de fallback exibida na notificação de uma mensagem recebida da habilidade. O texto de %1$s é definido como o Notification title que é definido usando a classe NotificationCustomizer, descrita no SDK (disponível na página de download do ODA e OMC). %1$s has sent you a Message.
odaas_notification_fallback_message A mensagem de fallback exibida na notificação de uma mensagem recebida da habilidade.  
odaas_notification_intent A atividade a ser aberta, quando tocada pelo usuário, nas notificações recebidas do SDK. O texto de %1$s é definido como Notification title que é definido usando a classe NotificationCustomizer, descrita no SDK (disponível na página de download ODA e OMC). oracle.cloud.bots.mobile.ui.ConversationActivity
odaas_notification_location_message A mensagem exibida na notificação de uma mensagem de localização recebida da habilidade. O texto de %1$s é definido como Notification title que é definido usando a classe NotificationCustomizer, descrita no SDK (disponível na página de download ODA e OMC). %1$s has sent you a Location Message.
odaas_page_loading O texto dentro do pop-up enquanto uma página está sendo carregada em uma webview. Please Wait...Page is Loading.
odaas_require_audio_recording_permission A mensagem de erro exibida quando os usuários negam permissão para gravar o áudio. Audio recording permission is needed to record audio
odaas_require_download_to_storage_access_permission A mensagem de erro exibida quando os usuários negam a permissão de acesso de armazenamento para salvar o arquivo submetido a download. Storage access permission is needed to download file
odaas_require_location_permission A mensagem de erro exibida quando os usuários negam permissão para acessar suas localidades. Location access permission is needed to track location
odaas_require_storage_access_permission A mensagem de erro exibida quando o acesso ao armazenamento foi negado. Storage access permission is needed to attach files
odaas_share_audio O texto do item de menu na lista pop-up do anexo usado para compartilhar o arquivo de áudio. Share Audio
odaas_share_file O texto do item de menu na lista pop-up do anexo usado para compartilhar um arquivo genérico. Share File
odaas_share_message_chooser_title O título do seletor de aplicativos exibido quando o usuário clica na ação Compartilhar. Share using:
odaas_share_visual O texto do item de menu na lista pop-up de anexo usado para compartilhar uma imagem ou um arquivo de vídeo. Share Image/Video
odaas_skill_message O indicador de mensagem de habilidade para leitores de tela. É falado pelos leitores de tela antes da resposta da habilidade. O texto não é exibido na view de chat. Skill says:
odaas_speech_to_text_dialog_placeholder O texto do placeholder exibido na janela pop-up de reconhecimento de fala antes de o usuário começar a falar. Esta propriedade passou por remoção gradual na Release 20.8.1. A partir dessa release, a definição desta propriedade será ignorada. Listening.....
odaas_star_rating A mensagem que é lida em voz alta quando um botão de classificação do usuário é clicado enquanto o usuário está no modo de acessibilidade. Rate %1$s star
odaas_too_much_speech_error A mensagem de erro exibida quando um usuário fornece uma mensagem de voz muito grande para ser reconhecida. Too much voice input to recognize. Can not generate recognized text.
odaas_user_message O indicador de mensagem do usuário para leitores de tela. É falado por leitores de tela antes das mensagens do usuário. I say:

Localização

Para localizar essas strings, defina os atributos name para os elementos <string> no arquivo res/values-<your-language-code>/strings.xml do recurso do aplicativo com as chaves. Por exemplo, para localizar o título da view de chat em inglês, defina o seguinte em um arquivo chamado res/value-en/strings.xml:
<resources>
    <string name="odaas_bot_chat_title">Support</string>
</resources>
Para localizar o título em francês, adicione o seguinte a um arquivo chamado res/value-fr/strings.xml:
<resources>
    <string name="odaas_bot_chat_title">Soutien</string>
</resources>
Os valores para res/value/strings.xml são usados por padrão para as chaves que não são encontradas em res/values-<your-language-code>/strings.xml. Para esses dois exemplos, os valores padrão seriam usados para os recursos que não estão definidos nem no arquivo res/value-fr/strings.xml, nem no arquivo res/value-en/strings.xml.

Ícones Personalizados

Configure desenhos adicionando as imagens ou os ativos de vetor necessários à pasta res/drawable do recurso do aplicativo que possui os nomes a seguir.
Nome Descrição
ic_odaas_agent_avatar O ícone de avatar das mensagens do agente ao vivo. Este ícone é exibido nas notificações apenas quando o flag do recurso showBotAvatar é definido como true.
ic_odaas_bot_avatar O ícone de avatar para as mensagens da habilidade. Este ícone é exibido nas notificações apenas quando o flag do recurso showBotAvatar é definido como true.
ic_odaas_download O ícone de download que aparece na mensagem de anexo enviada pela habilidade.
ic_odaas_image_zoom O ícone do controle de zoom que aparece em uma mensagem de anexo de imagem enviada pela habilidade.
ic_odaas_notification_app_icon O ícone do aplicativo é exibido na barra de status e nas notificações recebidas da biblioteca de SDK.
ic_odaas_person_avatar O ícone de avatar para mensagens do usuário.
ic_odaas_rating O ícone usado para o botão de classificação de feedback.

Definir Flags de Recursos

Use a classe BotsConfiguration.BotsConfigurationBuilder para inicializar a classe BotsConfiguration.

Use estes construtores:
  • BotsConfiguration.BotsConfigurationBuilder(String chatServerUrl, boolean clientAuthEnabled, Context context)
    Parâmetros:
    • chatServerUrl – O URL para o Servidor de Anexo e Chat da Oracle. O valor não pode ser nulo.
    • clientAuthEnabled - Determina se as definições de autenticação do cliente do canal estão ativadas ou desativadas.
    • context – O contexto do aplicativo. O valor não pode ser nulo.
    BotsConfiguration botsConfiguration = new BotsConfiguration.BotsConfigurationBuilder(<SERVER_URI>, false, getApplicationContext())
  • BotsConfiguration.BotsConfigurationBuilder(String chatServerUrl, Context context) – Pode ser usado para estabelecer uma conexão com o canal com a autenticação do cliente ativada.
    Parâmetros:
    • chatServerUrl – O URL para o Servidor de Anexo e Chat da Oracle. O valor não pode ser nulo.
    • context – O contexto do aplicativo. O valor não pode ser nulo.
    BotsConfiguration botsConfiguration = new BotsConfiguration.BotsConfigurationBuilder(<SERVER_URI>, getApplicationContext())

Inicializar o SDK

Use os seguintes métodos para inicializar o 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)

O método public static void init(Application application, BotsConfiguration botsConfiguration) inicializa todos os serviços com base na instância BotsConfiguration informada pelo usuário e estabelece a conexão WebSocket com o Oracle Chat Server.

Parâmetros:
  • application – A instância do aplicativo. O valor não pode ser nulo.
  • botsConfiguration – O objeto BotsConfiguration usado para controlar os recursos da biblioteca. O valor não pode ser nulo.
Bots.init(getApplication(),
      botsConfiguration);

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

O método public static void init(Application application, BotsConfiguration botsConfiguration, BotsCallback botsCallback) inicializa todos os serviços com base na instância BotsConfiguration informada pelo usuário e estabelece a conexão WebSocket com o Oracle Chat Server.

Parâmetros:
  • application – A instância do aplicativo. O valor não pode ser nulo.
  • botsConfiguration – O objeto BotsConfiguration usado para controlar os recursos da biblioteca. O valor não pode ser nulo.
  • botsCallback – O callback recebido ao estabelecer a conexão.
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)

O método public static void init(Application application, String chatServerUrl, String channelId, String userId, BotsCallback botsCallback) inicializa todos os serviços com a configuração padrão. Este método pode ser chamado para estabelecer conexão com um canal com a autenticação do cliente desativada.

Parâmetros:
  • application – A instância do aplicativo. O valor não pode ser nulo.
  • chatServerUrl – O URL do Oracle Chat Server. O valor não pode ser nulo.
  • channelId – O ID do Canal que pertence ao canal Oracle Android roteado para a habilidade ou o assistente digital. O valor não pode ser nulo.
  • userId – Um identificador exclusivo para o usuário. O SDK inicializa esse valor quando não é fornecido.
  • botsCallback – O callback recebido ao estabelecer a conexão com o Oracle Chat Server.
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)

Chame o método public static void init(Application application, String chatServerUrl, AuthenticationTokenProvider authTokenProvider, BotsCallback botsCallback para se conectar a um canal que tenha a autenticação do cliente ativada. Esse método inicializa todos os serviços com a configuração padrão.

Parâmetros:
  • application – A instância do aplicativo. O valor não pode ser nulo.
  • chatServerUrl – O URL do Oracle Chat Server. O valor não pode ser nulo.
  • authTokenProvider – A instância de AuthenticationTokenProvider, que é usada para gerar o token de autenticação sempre que necessário.
  • botsCallback – O callback recebido ao estabelecer conexão.
BotsConfiguration botsConfiguration = new BotsConfiguration.BotsConfigurationBuilder(<SERVER_URI>, getApplicationContext())

Interface AuthenticationTokenProvider

O método public String getAuthToken retorna a string do token gerado.

Uma instância desta interface pode ser passada para a propriedade authTokenProvider para permitir que o SDK gere um novo token de autenticação quando for necessário estabelecer uma conexão de canal autenticada. Ao implementar essa interface, substitua o método public String getAuthToken.
private class AuthTokenProvider implements AuthenticationTokenProvider {
    @Override
    public String getAuthToken() {
        // Generate a new JWT Token and return
    }
}

Interface BotsCallback

Esta interface atua como um callback ao inicializar a biblioteca.
  • void onSuccess(Response paramResponse) – Este método é chamado quando a conexão do soquete web é estabelecida com sucesso.
  • void onFailure(Response paramResponse) – Este método é chamado em qualquer falha que ocorra durante a inicialização da biblioteca.

Mostrar Atividade da Conversa

Depois de inicializar o SDK, exiba a view de conversa chamando public static void show(Context context). O parâmetro context desse método é o contexto do qual a atividade será iniciada.
ConversationActivity.show(getApplicationContext())

Personalizar Notificações

Você pode personalizar as notificações recebidas para as mensagens da habilidade instanciando a classe NotificationCustomizer e informando a instância para a propriedade notificationCustomizer. Os construtores são:
  • NotificationCustomizer()– Inicializa o canal de notificação com a configuração padrão.
  • NotificationCustomizer(String channelId) – Inicializa o canal de notificação com o ID de canal especificado. O parâmetro channelId é o ID do canal de notificação pelo qual as notificações são enviadas.
  • NotificationCustomizer(String channelId, String channelName, String description, String title) – Inicializa o canal de notificação com os parâmetros fornecidos:
    • channelID – O ID do canal de notificação pelo qual as notificações são enviadas.
    • channelName – O nome do canal de notificação pelo qual as notificações são enviadas.
    • description – Uma descrição do canal de notificação pelo qual as notificações são enviadas.
    • title – O título exibido nas notificações.
Por exemplo :
new BotsConfiguration.NotificationCustomizer(<NOTIFICATION_CHANNEL_ID>,
    <NOTIFICATION_CHANNEL_NAME>, <NOTIFICATION_CHANNEL_DESCRIPTION>, <NOTIFICATION_TITLE>);