Pular para o conteúdo principal

Notificações por push para iOS

Pré-requisitos

Este tutorial pressupõe que você esteja familiarizado com os conceitos abordados no nosso Início rápido de notificações por push.

Configurar o canal de notificação da Apple

  1. Verifique se você tem um certificado ativo de desenvolvimento (APNS_SANDBOX) ou de produção (APNS) do iOS. Se não tiver, crie um no Apple Developer Portal, em Certificates, Identities and Profiles.
Solicitar certificado APNS da Apple
  1. Exporte o certificado de sua escolha (desenvolvimento ou produção):
    • Comece baixando uma cópia do seu certificado no Apple Developer Portal, em Certificates, Identities and Profiles. Isso criará um arquivo .cer.
    • Abra e instale o certificado no Keychain Access.
    • Exiba o certificado instalado na subcategoria Certificates.
    • Exporte o Keychain Access Certificate para o formato .p12. Exportar o Keychain Access Certificate da Apple
    • Converta o arquivo .p12 em um arquivo .pem usando o seguinte comando de console:
      • openssl pkcs12 -in apns-dev-cert.p12 -out apns-dev-cert.pem -nodes -clcerts
    • Depois de obter o arquivo .pem, você pode fazer upload dele diretamente pelo Game Manager do PlayFab em Title’s settings > Push Notifications.
    • Como alternativa, use o gerador abaixo para criar uma solicitação JSON para SetupPushNotification.

Gerador de solicitação JSON para SetupPushNotification

O gerador de solicitações usa as seguintes informações para criar uma solicitação JSON:
  • Platform: use um dos seguintes valores: APNS (iOS), APNS_SANDBOX (iOS), GCM (Android)
  • Application Name: insira o nome do aplicativo que está enviando a mensagem.
Os nomes de aplicativo devem ser compostos apenas por letras ASCII maiúsculas e minúsculas, números, sublinhados, hifens e pontos, e devem ter entre 1 e 256 caracteres. Eles também devem ser exclusivos.
  • PEM Certificate / API Key: para iOS (APNS ou APNS_SANDBOX), use o conteúdo completo do seu arquivo PEM.
Depois que o JSON for gerado, use-o para executar uma chamada a SetupPushNotification. A resposta deverá ser semelhante ao exemplo a seguir.
Parabéns! Você configurou o canal de mensagens do iOS do seu título.

Registrar seu cliente iOS para push

Para o iOS, você precisa contar com o comportamento padrão do iOS para lidar com notificações por push, pois o PlayFab não oferece uma implementação nativa no Unity no momento. Por padrão, as notificações recebidas enquanto o jogo está em segundo plano serão encaminhadas para a área de Notificações. Por outro lado, as notificações recebidas enquanto o jogo é o aplicativo ativo serão recebidas silenciosamente e não ficarão visíveis na área de Notificações.
  • O código a seguir do exemplo é executado em client Start().
  • Se nenhum erro ocorrer, parabéns! Seu cliente iOS foi vinculado com êxito ao canal de notificações da Apple do seu título.

Solução de problemas do iOS

  • Verifique se você tem arquivos .pem válidos.
  • Verifique se o mesmo certificado usado em SetupPushNotification é usado pelo XCode para assinar seu aplicativo.
  • Verifique se a API Push Notification está habilitada para o seu build no XCode.
  • Verifique se o certificado de assinatura corresponde à plataforma do PlayFab. Ao executar SetupPushNotification, use OverwriteOldARN = true para vincular novamente o canal a uma nova plataforma. Somente um ambiente iOS (APNS ou APNS_SANDBOX) pode estar ativo em um título por vez.

Suporte adicional

Para obter ajuda, exemplos de bugs e perguntas relacionadas, escreva para nós nos nossos fóruns.
No momento, só oferecemos suporte aos nossos serviços para o fluxo padrão descrito neste documento. Se sua equipe estiver procurando funcionalidades adicionais com outros serviços ou plug-ins de push comuns, informe-nos! Adoramos receber feedback da nossa comunidade de desenvolvedores.
Última modificação em 8 de outubro de 2026