Pular para o conteúdo principal
As notificações por push do PlayFab são habilitadas pela vinculação de três sistemas principais:
  1. O sistema operacional do dispositivo do jogador (Android, iOS etc.)
  2. O canal específico do fornecedor (Google, Apple etc.)
  3. O roteamento de mensagens entre plataformas (PlayFab por meio do Amazon Simple Notification Service (SNS)).
Se algum desses sistemas for desvinculado, os clientes deixarão de receber notificações. É bastante simples alterar acidentalmente um dos três sistemas e acabar quebrando o vínculo. Além disso, é difícil saber, em qualquer ponto individual do fluxo, se todos os sistemas estão configurados corretamente.

O sistema de roteamento de push do PlayFab

Cada título do PlayFab pode habilitar um canal de notificação do Google (GCM) e um da Apple (APNS, APNS_SANDBOX) por vez. Eles podem ser configurados de uma destas duas formas:
  1. Usando a interface do usuário no Game Manager, em Settings -> Push Notifications.
  2. Usando a PlayFab Admin API: SetupPushNotification.
Para obter informações de configuração mais detalhadas, leia estes tutoriais:

Mensagens de push no jogo

As mensagens de push variam de acordo com o mecanismo/plataforma de desenvolvimento. No entanto, a forma mais fácil de receber notificações por push é usar um projeto do Unity com nosso SDK e o plug-in do Firebase Cloud Messaging (FCM) para Android, ou apenas o Unity para iOS.
  • Receber push no Android: isso exige um plug-in. O plug-in com melhor suporte é o plug-in nativo do FCM.
  • Receber push no iOS: isso não exige um plug-in para mensagens de push básicas.
Consulte a documentação do FCM para obter instruções sobre como configurar o plug-in do FCM para Unity ou o push no Android Studio.

Testar a configuração

Depois de configurar seu título e seu cliente, você pode testar a configuração usando a API de servidor do PlayFab SendPushNotification. Essa API permite enviar quantas notificações por push forem necessárias sem custo adicional. Você pode usar o serviço CloudScript do PlayFab como um ambiente de API de servidor rápido e seguro. A partir dele, as notificações por push podem ser enviadas conforme necessário. Para usar esse método para testar a configuração, faça upload do código do exemplo a seguir ou acrescente-o ao CloudScript do seu título.

Exemplo

Considere o seguinte cenário:
  • Os jogadores do seu título podem acessar um placar de líderes baseado em estatísticas de classificação.
  • Cada jogador pode pagar 1 unidade da moeda CH e desafiar outro jogador que esteja a até 5 posições de distância do jogador atual.
Primeiro, considere uma moeda virtual conforme mostrado na captura de tela de exemplo abaixo (consulte o tutorial Moedas para obter informações sobre como definir uma moeda virtual). PlayFab Economy: Currencies: nova moeda Agora, considere as seguintes estatísticas definidas para cada jogador (consulte o tutorial Acessar resultados de torneios arquivados para obter informações sobre como gerar um placar de líderes de teste). Estatísticas do jogador no PlayFab: Rank Depois de configurar esses pré-requisitos, você poderá configurar um sistema de desafios por notificação por push. O código de cliente a seguir chamará o CloudScript ChallengePlayer.
O código do CloudScript ChallengePlayer manipulará a solicitação, validará o estado do placar de líderes e enviará a notificação por push de desafio ao alvo.

Uso de notificações por push

Ter a capacidade de usar notificações por push é um poder incrível. No entanto, quando usadas em excesso, elas podem fazer com que os usuários desativem notificações futuras ou até abandonem completamente o jogo. Porém, se usadas com critério, as notificações por push podem ser uma das suas melhores ferramentas para criar e manter a comunidade do seu jogo. As notificações por push são um protocolo de mensagens do tipo enviar e esquecer, que não garante a entrega.
Lembre-se de que não há garantia de que seus jogadores receberão, abrirão ou interagirão com sua mensagem. Considerando essa ressalva, é uma boa prática usar as mensagens como funcionalidade bônus, e não como parte crítica do loop de jogo.
Nas plataformas iOS, os aplicativos recebem um prompt único do sistema operacional, permitindo que o usuário determine o status das notificações por push. Depois que o usuário fizer a seleção inicial, essa configuração persistirá até que:
  • O aplicativo seja atualizado ou reinstalado.
  • O usuário faça alterações nas configurações pelo menu de configurações do telefone.
Nos aplicativos Android, as notificações são habilitadas por padrão e podem ser ativadas e desativadas à vontade pelo cliente.
É uma boa prática reinicializar os ouvintes de notificação a cada sessão.

Recursos

Os recursos a seguir fornecem informações adicionais sobre os tópicos deste início rápido:
Última modificação em 8 de outubro de 2026