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 |
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 |
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
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>
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
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
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
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
.
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
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.
application
– A instância do aplicativo. O valor não pode ser nulo.botsConfiguration
– O objetoBotsConfiguration
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.
application
– A instância do aplicativo. O valor não pode ser nulo.botsConfiguration
– O objetoBotsConfiguration
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.
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.
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 deAuthenticationTokenProvider
, 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.
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
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
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
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âmetrochannelId
é 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.
new BotsConfiguration.NotificationCustomizer(<NOTIFICATION_CHANNEL_ID>,
<NOTIFICATION_CHANNEL_NAME>, <NOTIFICATION_CHANNEL_DESCRIPTION>, <NOTIFICATION_TITLE>);