Flag de recurso: timestampType: TimestampMode.RELATIVE

Você pode ativar timestamps absolutos ou relativos para mensagens de chat. Os timestamps absolutos exibem a hora exata de cada mensagem. Os timestamps relativos só são exibidos na mensagem mais recente e expressam o tempo em termos de segundos, dias, horas, meses ou anos atrás em relação à mensagem anterior. A precisão fornecida por timestamps absolutos os torna ideais para tarefas de arquivamento, mas dentro do contexto limitado de uma sessão de chat, essa precisão é extraída da experiência do usuário porque os usuários devem comparar os timestamps para descobrir a passagem de tempo entre as mensagens. Os timestamps relativos permitem que os usuários rastreiem a conversa facilmente por meio de termos como Há Pouco e Há alguns momentos que podem ser imediatamente compreendidos. Os timestamps relativos melhoram a experiência do usuário de outra forma, além de também simplificar suas tarefas de desenvolvimento: como os timestamps relativos marcam as mensagens em termos de segundos, dias, horas, meses ou anos atrás, você não precisa convertê-las em fusos horários.

Flag do recurso: actionsLayout

actionsLayout define a direção do layout para as ações local, global, de cartão e de formulário. Quando você define isso como LayoutOrientation.HORIZONTAL, esses botões são dispostos horizontalmente e serão encapsulados se o conteúdo transbordar.

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

(Obrigatório) <Digite uma descrição curta aqui.>

Flag do recurso: shareMenuItems

ArrayList<Object> customItems = new ArrayList<>();
        ShareMenuCustomItem shareMenuCustomItem1  = new ShareMenuCustomItem("pdf bin", "Label1", 1024, R.drawable.odaas_menuitem_share_file);
        ShareMenuCustomItem shareMenuCustomItem2  = new ShareMenuCustomItem("doc", "Label2", R.drawable.odaas_menuitem_share_file);
        ShareMenuCustomItem shareMenuCustomItem3  = new ShareMenuCustomItem("csv");
        ArrayList<Object> customItems = new ArrayList<>(Arrays.asList(shareMenuCustomItem1,shareMenuCustomItem2,shareMenuCustomItem3,ShareMenuItem.CAMERA));
        BotsConfiguration botsConfiguration = new BotsConfiguration.BotsConfigurationBuilder(sharedPreferences.getString(getString(R.string.pref_name_chat_server_host), Settings.CHAT_SERVER_URL), false, getApplicationContext())
        .channelId(<CHANNEL_ID>)
        .userId(<USER_ID>)
        .shareMenuItems(customItems)
        .enableAttachment(true)
        .build();

Quando um campo tem a propriedade autoSubmit definida como true, o cliente envia um FormSubmissionMessagePayload com o mapa submittedField contendo os valores de campo válidos que foram informados até o momento. Todos os campos que ainda não foram definidos (independentemente de serem obrigatórios) ou campos que violam uma validação do cliente não são incluídos no mapa submittedField. Se o próprio campo enviado automaticamente contiver um valor que não seja válido, a mensagem de envio não será enviada e a mensagem de erro do cliente será exibida para esse campo específico. Quando um envio automático for bem-sucedido, o partialSubmitField na mensagem de envio do formulário será definido como id do campo autoSubmit.

Flag de recurso: enableDefaultClientResponse: true (padrão: false)

Use enableDefaultClientResponse: true para fornecer respostas padrão do cliente acompanhadas por um indicador de digitação quando a resposta da habilidade tiver sido atrasada ou quando não houver resposta da habilidade. Se o usuário enviar a primeira mensagem/consulta, mas a habilidade não responder com o número de segundos definido pelo flag odaas_default_greeting_timeout, a habilidade poderá exibir uma mensagem de saudação configurada usando a string de tradução odaas_default_greeting_message. Em seguida, o cliente verifica novamente a resposta da habilidade. O cliente exibirá a resposta da habilidade se ela tiver sido recebida, mas se não tiver sido recebida, o cliente exibirá uma mensagem de espera (configurada com a string de tradução odaas_default_wait_message) em intervalos definidos pelo flag odaas_default_wait_message_interval. Quando a espera pela resposta da habilidade excede o limite definido pelo flag typingIndicatorTimeout, o cliente exibe uma resposta lamentável ao usuário e interrompe o indicador de digitação. Você pode configurar a resposta de desculpas usando a string de tradução odaas_default_sorry_message.

Configuração de recurso: messageModifierDelegate

private MessageDelegate implements MessageModifierDelegate {
    @Override
    public Message beforeSend(Message message) {
        // Handle before send delegate here
    }

    @Override
    public Message beforeDisplay(Message message) {
        if (message != null && message.getPayload() != null && message.getPayload().getType() == MessagePayload.MessageType.CARD) {
            ((CardMessagePayload)message.getPayload()).setLayout(CardLayout.VERTICAL);
        }
        return message;
    }

    @Override
    public Message beforeNotification(Message message) {
        // Handle before notification delegate here
    }
}
    @Override
    public void beforeEndConversation(CompletionHandler completionHandler) {
        // Handle before end conversation end delegate here
        // Trigger completionHandler.onSuccess() callback after successful execution of the task.
        // Trigger completionHandler.onFailure() callback when the task is unsucessful.
        }
        }

Você pode ativar ou exibir o histórico de conversas locais de um usuário depois que o SDK foi reinicializado, definindo displayPreviousMessages como true ou false na configuração de bots. Quando definido como false, as mensagens anteriores não são exibidas para o usuário, após a reinicialização do SDK.

FeatureFlag: enableEndConversation: true

enableEndConversation: true adiciona um botão de fechamento à exibição de cabeçalho que permite aos usuários encerrar explicitamente a sessão de chat atual. Uma caixa de diálogo de prompt de confirmação é aberta quando os usuários clicam nesse botão de fechamento e, quando confirmam a ação de fechamento, o SDK envia uma mensagem de evento para a habilidade que marca o fim da sessão de chat. O SDK, em seguida, desconecta a habilidade da instância, recolhe o widget de chat e apaga o histórico de conversas do usuário atual. O SDK aciona um delegado em beforeEndConversation(CompletionHandler completionHandler) que pode ser usado para executar uma tarefa antes de enviar a solicitação de fechamento da sessão ao servidor. Ele também gera um evento OnChatEnd() no qual você pode se registrar.

A abertura do widget de chat inicia uma nova sessão de chat.

O SDK pode ser usado sem sua interface de usuário. Para usá-lo nesse modo, importe apenas o pacote com.oracle.bots.client.sdk.android.core-24.12.aar para o projeto, conforme descrito em Adicionar o SDK do Cliente Oracle Android ao Projeto.

O SDK mantém a conexão com o servidor e fornece APIs para enviar mensagens, receber mensagens e obter atualizações para o status da rede e para outros serviços. Você pode usar as APIs para interagir com o SDK e atualizar a interface do usuário.

Você pode enviar uma mensagem usando qualquer uma das APIs send*() disponíveis na classe Bots. Por exemplo, public static void sendMessage(String text) envia uma mensagem de texto para a habilidade ou o assistente digital.

Flag do recurso: linkHandler

Você pode configurar o comportamento do link em mensagens de chat para permitir que os usuários acessem páginas web dentro do widget de chat. Em vez de ter que alternar da conversa para exibir uma página em uma guia ou em outra janela do browser, um usuário pode permanecer no chat porque o widget de chat abre o link em uma Webview.

Flag do recurso: multiLangChat

O suporte ao idioma nativo do Android SDK permite que o widget de chat detecte o idioma de um usuário e permita que o usuário selecione o idioma da conversa em um menu drop-down no cabeçalho. Os usuários podem alternar entre os idiomas, mas apenas entre as conversas, não durante, porque a conversa é redefinida sempre que um usuário seleciona um novo idioma.

Ao transmitir um ArrayList de Objetos para shareMenuItems shareMenuItems(Arraylist<Object>), você pode restringir ou filtrar o tipo de itens disponíveis no menu, personalizar os ícones e labels do menu e limitar o tamanho do arquivo de upload (como 1024 no trecho de código a seguir). Esses objetos podem ser um objeto de valores de enumeração shareMenuCustomItem ou ShareMenuItem que são mapeados para os itens de menu de compartilhamento: ShareMenuItem.CAMERA para o item de menu de câmera (se suportado pelo dispositivo), ShareMenuItem.VISUAL para compartilhar um item de imagem ou vídeo, ShareMenuItem.AUDIO para compartilhar um item de áudio e ShareMenuItem.FILE para compartilhar um item de arquivo. A transmissão de um valor vazio ou nulo exibe todos os itens de menu que podem ser transmitidos como valores de enumeração ShareMenuItem.

ArrayList<Object> customItems = new ArrayList<>();
ShareMenuCustomItem shareMenuCustomItem1  = new ShareMenuCustomItem("pdf bin", "Label1", 1024, R.drawable.odaas_menuitem_share_file);
ShareMenuCustomItem shareMenuCustomItem2  = new ShareMenuCustomItem("doc", "Label2", R.drawable.odaas_menuitem_share_file);
ShareMenuCustomItem shareMenuCustomItem3  = new ShareMenuCustomItem("csv");
ArrayList<Object> customItems = new ArrayList<>(Arrays.asList(shareMenuCustomItem1,shareMenuCustomItem2,shareMenuCustomItem3,ShareMenuItem.CAMERA));
BotsConfiguration botsConfiguration = new BotsConfiguration.BotsConfigurationBuilder(sharedPreferences.getString(getString(R.string.pref_name_chat_server_host), Settings.CHAT_SERVER_URL), false, getApplicationContext())
         .channelId(<CHANNEL_ID>)
         .userId(<USER_ID>)
        .shareMenuItems(customItems)
        .enableAttachment(true)
        .build();

Flag do recurso: enableSpeechRecognition

A definição do flag do recurso enableSpeechRecognition como true permite que o botão do microfone seja exibido junto com o botão Enviar sempre que o campo de entrada do usuário estiver vazio.

A definição dessa propriedade como true também suporta a funcionalidade ativada pela propriedade enableSpeechRecognitionAutoSend, que quando também está definida como true, permite que a resposta de fala do usuário seja enviada ao servidor de chat automaticamente enquanto exibe a resposta como uma mensagem enviada na janela de chat. Você pode permitir que os usuários editem (ou excluam) primeiro suas mensagens ditadas antes de enviá-las manualmente, definindo enableSpeechRecognitionAutoSend como false.

• Flag do recurso: enableSpeechSynthesis
• Configuração da funcionalidade: speechSynthesisVoicePreferences

Flag do recurso : ttsService

O flag do recurso speechSynthesisService permite que você injete qualquer serviço de conversão de texto em fala (TTS) - seu próprio serviço ou fornecido por um fornecedor de terceiros - no SDK. Para injetar um serviço TTS, primeiro defina o flag do recurso enableSpeechSynthesis como true e, em seguida, informe uma instância da interface SpeechSynthesisService para o flag speechSynthesisService.

Flag do recurso: enableSendTypingStatus

Quando ativado, o SDK envia um evento de digitação RESPONDING junto com o texto que está sendo digitado no momento pelo usuário para . Isso mostra um indicador de digitação no console do agente. Quando o usuário terminar de digitar, o SDK enviará um evento LISTENING para o Oracle B2C Service ou o Oracle Fusion Service. Isso oculta o indicador de digitação no console do agente.

Da mesma forma, quando o agente está digitando, o SDK recebe um evento RESPONDING do serviço. Ao receber este evento, o SDK mostra um indicador de digitação para o usuário. Quando o agente está ocioso, o SDK recebe o evento LISTENING do serviço. Ao receber este evento, o SDK oculta o indicador de digitação mostrado ao usuário.

public void sendUserTypingStatus(TypingStatus status, String text)

Você pode ativar a atualização dinâmica do avatar do usuário no runtime.

Use essas APIs para modificar o nome do agente, a cor do texto, o avatar, as iniciais do nome do agente, a cor do texto e o plano de fundo do avatar.

Quando o suporte a voz está ativado (enableSpeechRecognition(true)), o rodapé do widget de chat exibe um visualizador de voz, um gráfico de visualizador dinâmico que indica o nível de frequência da entrada de voz. O visualizador responde à modulação da voz do usuário, indicando se o usuário está falando muito baixo ou muito alto. Este visualizador é criado usando o stream de bytes que são gravados enquanto o usuário está falando, que também é exposto no método IBotsSpeechListener#onActiveSpeechUpdate(byte[]) para uso no modo sem interface do usuário.

Quando enableSpeechRecognitionAutoSend(true), o texto reconhecido é enviado automaticamente para a habilidade depois que o usuário termina de ditar a mensagem. Em seguida, o modo é revertido para entrada de texto. Quando enableSpeechRecognitionAutoSend(false), o modo também é revertido para entrada de texto, mas nesse caso, os usuários podem modificar o texto reconhecido antes de enviar a mensagem para a habilidade.