Pular para o conteúdo principal

Início rápido de ações e regras

Uma regra do PlayStream permite que você reaja a um subconjunto de um tipo de evento do PlayStream em tempo real.

Requisitos

Um glossário rápido de termos relevantes:
  • PlayStream: o grupo de recursos que compõe o pipeline de Eventos do PlayFab.
    • Um Evento do PlayStream é uma cadeia de caracteres no formato JSON que descreve um evento sobre um Jogador ou Título.
    • Os Eventos do PlayStream têm um tamanho máximo com base no nível do seu recurso de Automação.
  • Regra: executa lógica extra em resposta a um tipo de Evento do PlayStream em tempo real.
    • A soma de: um Gatilho de Evento, uma lista opcional de Condições e uma lista opcional de Ações.
  • Gatilho: o nome do Evento que ativa esta Regra.
  • Condição: um filtro de conteúdo para Regras e outros recursos do PlayStream.
    • Executa uma avaliação muito leve do objeto JSON do evento do PlayStream e ignora os eventos que não atendem aos requisitos.
  • Ação: o trabalho contextual a ser feito na entidade apropriada.
Uma regra consiste em exatamente um Gatilho, uma lista opcional de Condições e normalmente pelo menos uma Ação (não é obrigatória, mas a regra é bastante inútil sem ela). Gatilhos, Condições e Ações também fazem parte de outros sistemas: ações em massa e placares de torneio (preterido).

Caso de exemplo: contar eventos personalizados do cliente

No exemplo apresentado abaixo, publicamos o seguinte evento personalizado do cliente.
Neste caso, o cliente está relatando manualmente um ForumPostEvent personalizado (isso atualmente não corresponde a nenhum Evento Automático no PlayFab ou em parceiros compatíveis) Usaremos uma Regra do PlayStream para contar o número de vezes que um Jogador relata uma postagem no fórum dessa forma. Requisito: seu jogo já deve estar publicando Eventos desse tipo antes que a interface gráfica do Game Manager permita que você crie uma Regra disparada por eles. Acesse o seu Game Manager:
  • Navegue até o seu Title.
  • Selecione Automation.
  • Vá para Rules.
  • Selecione New Rule.
Game Manager - automação - nova regra Vamos avaliar a New Rule deste exemplo parte por parte:
  • title.6195.ForumPostEvent
    • 6195 é o título usado neste tutorial. Seu titleId corresponderá ao seu próprio Título.
    • ForumPostEvent é o nome do evento usado no código deste caso de exemplo.
    • Esta linha só estará disponível se você tiver publicado recentemente pelo menos um ForumPostEvent no seu Título.
  • As Conditions usadas especificamente neste exemplo têm uso mínimo.
    • No entanto, elas demonstram a filtragem do nosso Evento Personalizado se a chave Body estiver mapeada para Invalid string no nosso dicionário Body.
    • Os filtros são opcionais e devem remover jogadores irrelevantes da sua Regra.
  • As Actions escolhidas neste caso incrementam um contador de estatística em um.
    • Requisito: a estatística Forum Posts deve estar definida em Leaderboards no Game Manager.
No PlayStream Debugger do Game Manager (mostrado abaixo), você pode observar o gatilho entrar em vigor. Game Manager - PlayStream - depurador - gatilho de evento Como você pode ver, o ForumPostEvent personalizado dispara automaticamente a estatística que definimos em Actions para a nossa nova Regra.

Avançado: Ações do CloudScript

Muitas das ações integradas do PlayFab são bastante simples e podem não oferecer todo o poder de que você precisa. É por isso que permitimos que você personalize totalmente a lógica da ação com o CloudScript. Vamos editar a Regra.
  • Remova a Condition.
  • Defina a Action como Execute CloudScript.
  • Selecione o botão Save Action.
Game Manager - automação - editar regra Agora, se publicarmos um novo ForumPostEvent, veremos uma execução do CloudScript. Game Manager - PlayStream - depurador - execução do CloudScript Escrever seu CloudScript para reagir a Regras do PlayStream é um tópico avançado abordado no nosso tutorial: usando ações do CloudScript com o PlayStream.
Última modificação em 6 de outubro de 2026