Classe NowPushService - iOS

. 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	Definições de configuração fornecidas quando o serviço foi inicializado. Tipo de dados: NowServiceConfiguration

NowPushService - registerPushToken(_token: Dados, pushAppName: Cadeia de caracteres, ambiente: NowPushEnvironment, conclusão: Escape (<Data, NowPushError>) -> Vazio)

Registra um token exclusivo com ServiceNow instância usada para identificar as notificações por push do atual iOS dispositivo e aplicação especificada.

Tabela 2. Parâmetros

Nome	Tipo	Descrição
_token	Dados	Objeto de dados do token de push a ser registrado. Este é o token obtido do Apple Site do desenvolvedor. Para obter mais informações, consulte Mobile SDK Guia do desenvolvedor - iOS.
PushAppName	Cadeia de caracteres	Nome da aplicação de envio para a qual este token está sendo registrado.
ambiente	NowPushEnvironment	Ambiente para o qual o token está sendo registrado. Valores válidos: produção Área de testes
conclusão	Escaping (Result​<Data, NowPushError>) → Vazio	Manipulador de conclusão a ser executado após a tentativa de registro do token. Certificado de notificação por push do iOS. NowPushError - Informações sobre o erro que ocorreu ao tentar registrar o token. Valores possíveis: Decodificação: Ocorreu um erro de decodificação. HTTRequestFailure: Erro genérico que é retornado sempre que a chamada http não é um sucesso (2xx). NotAuthorized: O solicitante não está autorizado a executar a operação de notificação por push especificada. UnsupportedData: A carga de envio é inválida.

Tabela 3. Retornos

Tipo	Descrição
Nenhum(a)

Este exemplo mostra como registrar um token de notificação por push para a aplicação TestPushApp.

func registerForPushNotifications(deviceToken: Data) {
  pushService.registerPushToken(deviceToken,
      pushAppName: "TestPushApp",
      environment: environment) { [weak self] result in
    guard let self = self else { return }
    switch result {
      case .success:
        UserDefaults.standard.set(true, forKey: "pushNotificationsRegistered")
        self.pushRegistrationState = .registrationSuccess
      case .failure:
        UserDefaults.standard.set(false, forKey: "pushNotificationsRegistered")
        self.pushRegistrationState = .registrationFailed
    }
  }
}

NowPushService - unregisterPushToken(_token: Data, pushAppName: Cadeia de caracteres, ambiente: NowPushEnvironment, conclusão: Escape (<Data, NowPushError>) -> Vazio)

Cancela o registro de um token de push registrado anteriormente.

Tabela 4. Parâmetros

Nome	Tipo	Descrição
_token	Dados	Objeto de dados do token de push para cancelar o registro.
PushAppName	Cadeia de caracteres	Nome da aplicação de push para a qual este token está sendo cancelado.
ambiente	NowPushEnvironment	Ambiente para o qual o token está sendo registrado. Valores válidos: produção Área de testes
conclusão	Escaping (Result​<Data, NowPushError>) → Vazio	Manipulador de conclusão a ser executado após a tentativa de cancelar o registro do token. Sucesso: Dados de resposta da API . Erro: NowPushError - Informações sobre o erro que ocorreu ao tentar cancelar o registro do token. Valores possíveis: Decodificação: Ocorreu um erro de decodificação. HTTRequestFailure: Erro genérico que é retornado sempre que a chamada http não é um sucesso (2xx). NotAuthorized: O solicitante não está autorizado a executar a operação de notificação por push especificada. UnsupportedData: A carga de envio é inválida.

Tabela 5. Retornos

Tipo	Descrição
Nenhum(a)

Este exemplo mostra como cancelar o registro do token de notificação por push associado à aplicação TestPushApp.

func unregisterFromPushNotifications(deviceToken: Data) {
  pushService.unregisterPushToken(deviceToken, pushAppName: "TestPushApp", environment: environment) { [weak self] result in
    guard let self = self else { return }
    switch result {
      case .success:
        UserDefaults.standard.set(false, forKey: "pushNotificationsRegistered")
        self.pushRegistrationState = .unregisterSuccess
      case .failure:
        self.pushRegistrationState = .unregisterFailed
    }
  }
}

NowPushService - payloadFromUserInfo(_userinfo: [AnyHashable: Any])

Analisa o. Userinfo pares de chave-valor em um NowPushPayload objeto.

Tabela 6. Parâmetros

Nome	Tipo	Descrição
_Userinfo	[AnyHashable: Qualquer]	Conteúdo de carga de push recebido como parte da notificação por push.

Tabela 7. Retornos

Tipo

Descrição

<NowPushPayload, NowPushError>

Retorna os resultados da análise de carga. Analisado NowPushPayload objeto. Falha: NowPushError - Informações sobre o erro encontrado ao analisar a carga do usuário especificada. Valores possíveis: Decodificação: Ocorreu um erro de decodificação. HTTRequestFailure: Erro genérico que é retornado sempre que a chamada http não é um sucesso (2xx). NotAuthorized: O solicitante não está autorizado a executar a operação de notificação por push especificada. UnsupportedData: A carga de envio é inválida.

Este exemplo mostra como analisar a carga útil de um usuário.

func userNotificationCenter(_ center: UNUserNotificationCenter,
    didReceive response: UNNotificationResponse,
    withCompletionHandler completionHandler: @escaping () -> Void) {
  guard let pushService = pushService else {
    completionHandler()
    return
  }
  let userInfo = response.notification.request.content.userInfo
  _ = pushService.payloadFromUserInfo(userInfo)
    .flatMap(handleNowPushPayload)
}


func handleNowPushPayload(_ payload: NowPushPayload) -> Result<Void, NowPushError> {
  guard payload is NowPushVirtualAgent else {
    return .failure(NowPushError.unsupportedData)
  }
  launchVirtualAgent()
  return .success(())
}