Classe NowPushService - Android

. NowPushService A classe fornece funções que permitem a interação com o serviço de Notificação por push.

Tabela 1. Propriedades

Nome	Descrição
configuração	Configuração de serviço a ser associada ao serviço. Tipo de dados: NowServiceConfiguration

NowPushService - handlePush(remoteMessage: RemoteMessage, successCallback: Consumer<NowPushPayload>, errorCallback: Consumer<Throwable>)

Processa uma solicitação de notificação por push.

Nota:

No momento, o único tipo de notificação por push implementado é AgoraPushVirtualAgent . Qualquer outro tipo de notificação por push aprovado retorna um Erro PushSupportedPushError objeto.

Tabela 2. Parâmetros

Nome	Tipo	Descrição
Mensagem remota	Mensagem remota	Notificação como recebida por com.google.firebase.messaging.FirebaseMessagingService.onMessageReceived . Para obter informações adicionais, consulte Receba mensagens em um app para Android .
Retorno de chamada de sucesso	Consumidor Menos de NowPushPayload >	Retorno de chamada para retornar o processado NowPushPayloadpara.
Retorno de chamada de erro	Consumidor Menos de Throwable >	Retorno de chamada para retornar o erro lançado. Se o erro Erro PushSupportedPushError For lançado, o tipo de notificação não é compatível com o SDK para celular e deve ser processado fora da estrutura do SDK para celular.

Tabela 3. Retornos

Tipo	Descrição
Nenhum(a)

Este exemplo mostra como substituir OnMessageReceived() e passar o. RemoteMessageaté o. NowPushService . . NowPushService reconhece o tipo de notificação, processa a solicitação e retorna o objeto de notificação para a aplicação processar. Caso contrário, ele lança o. Erro PushSupportedPushError .

override fun onMessageReceived(remodeeMessage: RemoteMessage){
  pushService.handlePush(remoteMessage, { push ->
    when (push) {
      is NowPushVirtualAgent → handleVirtualAgentPush(push)
    }, { error ->
        Log.e(TAG, "Unknown push", error)
        handleAppPushNotification(remoteMessage)
    })
}

NowPushService - registerPushToken(pushToken: Cadeia de caracteres, pushApp: Cadeia de caracteres, successCallback: Runnable, errorCallback: Consumer<Throwable>)

Registra um exclusivo Firebasetoken com ServiceNowinstância usada para identificar as notificações por push do atual Androiddispositivo e aplicação especificada.

Para ServiceNowinstância para gerar notificações Androidpara receber notificações da aplicação, este token deve ser registrado.

Tabela 4. Parâmetros

Nome	Tipo	Descrição
PushToken	Cadeia de caracteres	Firebasetoken recuperado por qualquer um com.google.firebase.messaging.FirebaseMessaging.getToken ou com.google.firebase.messaging.FirebaseMessagingService.onNewToken .
Push App	Cadeia de caracteres	Nome da aplicação de envio conforme especificado na tabela Aplicação de envio no associado ServiceNowinstância.
Retorno de chamada de sucesso	Executável	Retorno de chamada executado quando o registro do token é bem-sucedido.
Retorno de chamada de erroRetorno	Consumidor Menos de Throwable >	Retorno de chamada executado quando o registro do token falha.

Tabela 5. Retornos

Tipo	Descrição
Nenhum(a)

Este exemplo registra um token de push para o atual AndroidE a aplicação "PushAppName".

FirebaseMessaging.getInstance().token.addOnCompleteListener { task ->
  val token = task.result

  if (!task.isSuccessful || token == null) {
    throw Exception("Unable to fetch token"))
  }

  pushService.registerPushToken(token, "PushAppName", {
    Log.v(TAG, "Successfully registered push token")
  }, { e ->
    Log.e(TAG, "Error registering push", e)
  })
}

NowPushService - unregisterPushToken(pushToken: Cadeia de caracteres, pushApp: Cadeia de caracteres, successCallback: Runnable, errorCallback: Consumer<Throwable>)

Cancela o registro especificado Firebasetoken de push com o associado ServiceNowinstância.

Tabela 6. Parâmetros

Nome	Tipo	Descrição
PushToken	Cadeia de caracteres	Firebase token para cancelar o registro. Recuperado por qualquer um com.google.firebase.messaging.FirebaseMessaging.getToken ou com.google.firebase.messaging.FirebaseMessagingService.onNewToken .
Push App	Cadeia de caracteres	Nome da aplicação de push associada ao token para cancelar o registro. Essas informações são armazenadas na tabela da aplicação de push no associado ServiceNowinstância.
Retorno de chamada de sucesso	Executável	Retorno de chamada executado quando o cancelamento do registro do token é bem-sucedido.
Erro de retorno de chamada	Consumidor Menos de Throwable >	Retorno de chamada executado quando o cancelamento do registro do token falha.

Tabela 7. Retornos

Tipo	Descrição
Nenhum(a)

Este exemplo de código mostra como cancelar o registro de um token de push, por exemplo, quando o usuário faz logout da aplicação.

pushService.unregisterPushtoken(token, "PushAppName", {
  Log.v(TAG, "Successfully unregistered push token")
},  { e ->
  Log.e(TAG, "Error unregistering push", e)
})