Classe NowChatService - Android

  • Versão de lançamento: Washingtondc
  • Atualizado 1 de fev. de 2024
  • 2 min. de leitura
  • A classe NowChatService fornece funções que permitem iniciar a atividade NowChat e definir configurações de erro.

    NowChatService - launchIntent(context:Context,temeColors:NowChatTheme):intenção

    Inicia a intenção usada para abrir a atividade do NowChat. Normalmente usado para criar um [android.app.PendingIntent].

    Tabela 1. Parâmetros
    Nome Tipo Descrição
    contexto Contexto Contexto usado para criar a intenção.
    themeColors Tema do NowChat Opcional. Cores do tema a serem usadas na IU do NowChat.

    Padrão: cores padrão

    Tabela 2. Retorna
    Tipo Descrição
    Intenção Cores de intenção e tema usadas para iniciar a atividade do NowChat associada.

    Este exemplo mostra como chamar o método launchIntent() e processar a atividade de devolução.

    val intent = nowChatService.launchIntent(this) 
    val pendingIntent = PendingIntent.getActivity( 
        this, 
        REQUEST_CODE,
        intent,
        PendingIntent.FLAG_IMMUTABLE 
    ) 
    
    val notification = createNotification(title, message, pendingIntent)
    notificationManager.notify(push.notificationId, notification) 

    NowChatService - start(activity: Activity, temaColors: NowChatTheme = objeto : NowChatTheme{}, contextData: mapa<String, Any> = mapOf())

    Inicia a atividade do NowChat especificada.

    Tabela 3. Parâmetros
    Nome Tipo Descrição
    atividade Atividade Contexto de atividade a ser usado para iniciar a atividade NowChat e para receber o NowChatConfigCode como um resultCode por meio do onActivityResult.
    themeColors Tema do NowChat Opcional. Cores do tema a serem usadas na IU do NowChat.

    Padrão: cores padrão

    dadoscontexto Mapa<String, Any> Opcional. Variáveis de contexto de bate-papo adicionais que são passadas para a sessão de bate-papo.

    Para obter informações adicionais sobre variáveis de contexto de bate-papo, consulte Live agent chat context variables.

    Tabela 4. Retorna
    Tipo Descrição
    Nenhum

    O exemplo de código a seguir mostra como chamar esta função.

    suspend fun launchChat() {
      val chatService = getNowChatService()
      val chatTheme = object : NowChatTheme{
        override val brand: NowUIAdaptiveColor
          get() = NowUIAdaptiveColor(Color.BLUE)
        override val textPrimary: NowUIAdaptiveColor
          get() = NowUIAdaptiveColor(Color.BLACK)
    
      // Override remaining theme colors
    
      }
      val contextData = mapOf("sys_id" to "123456789", "table" to "wm_task") 
      chatService?.start(activity, chatTheme, contextData)
    }

    NowChatService -subscribeToUnreadMessageCount(pollingInterval: longo, ouvinte: NowChatUnreadMessagesCountListener)

    Assina o ouvinte da contagem de mensagens de bate-papo não lidas.

    Tabela 5. Parâmetros
    Nome Tipo Descrição
    Intervalo de pesquisa Longa Frequência na qual pesquisar o serviço Web para a contagem de mensagens de bate-papo não lidas.

    Unidade: milissegundos

    listener NowChatUnreadMessagesCountListener Ouvinte que você implementa para obter o número de mensagens de bate-papo não lidas. Você também deve cancelar a assinatura deste ouvinte quando não quiser mais obter a contagem de mensagens não lidas usando o método NowChatService - unsubscribeFromUnreadMessageCount(ouvinte: NowChatUnreadMessagesCountListener).
    Tabela 6. Retorna
    Tipo Descrição
    Nenhum

    O exemplo a seguir mostra como assinar e cancelar a assinatura de um ouvinte de contagem de mensagens não lidas do bate-papo.

    private val unreadMessageCountListener = object: NowChatUnreadMessagesCountListener {
      override fun unreadMessagesCountDidChange(unreadMessageCount: Int) {
      }
    }
    
    fun setup() {
      nowChatService.subscribeToUnreadMessageCount(pollingInterval:1000, unreadMessageCountListener)
    }
    
    fun teardown() {
      nowChatService.unsubscribeFromUnreadMessageCount(unreadMessageCountListener)
    }
    

    NowChatService - unsubscribeFromUnreadMessageCount(ouvinte: NowChatUnreadMessagesCountListener)

    Cancela a assinatura do recebimento da contagem de mensagens não lidas.

    Tabela 7. Parâmetros
    Nome Tipo Descrição
    listener NowChatUnreadMessagesCountListener Ouvinte que você implementa para cancelar a assinatura do ouvinte da contagem de mensagens não lidas do bate-papo.
    Tabela 8. Retorna
    Tipo Descrição
    Nenhum

    O exemplo a seguir mostra como assinar e cancelar a assinatura de um ouvinte de contagem de mensagens não lidas do bate-papo.

    private val unreadMessageCountListener = object: NowChatUnreadMessagesCountListener {
      override fun unreadMessagesCountDidChange(unreadMessageCount: Int) {
      }
    }
    
    fun setup() {
      nowChatService.subscribeToUnreadMessageCount(pollingInterval:1000, unreadMessageCountListener)
    }
    
    fun teardown() {
      nowChatService.unsubscribeFromUnreadMessageCount(unreadMessageCountListener)
    }