Pular para o conteúdo principal
Este tutorial orienta você pelas etapas necessárias para criar uma tarefa que execute uma ou mais ações em todos os jogadores de um segmento. As tarefas são uma parte vital das operações ao vivo de qualquer jogo. Elas oferecem um conjunto avançado de ferramentas para interagir com seus jogadores. Alguns exemplos:
  • Dar um presente especial de Ano-Novo a todos os jogadores que entraram nas últimas 2 semanas.
  • Recompensar os jogadores que gastaram dinheiro na última semana (com base em níveis de gastos), em que quanto mais dinheiro gastaram, mais valioso é o presente.
  • Corrigir o estado corrompido do Jogador para todos os jogadores afetados por um bug recente do jogo.
Neste tutorial, baseado no nosso Aplicativo de Exemplo Unicorn Battle, concederemos um presente especial a todos os jogadores com mais de 2.725 XP.

Pré-requisitos

Você precisará instalar o Aplicativo de Exemplo Unicorn Battle para executar este tutorial. Você pode ler mais sobre ele no nosso blog ou ir diretamente para o repositório do GitHub e seguir as instruções. Unicorn Battle - Tela inicial Você precisará jogar várias batalhas para subir seu personagem até pelo menos o Nível 2, que você alcança com 2.725 XP. Unicorn Battle - Nível 2

Etapa 1 - Criar o segmento

A primeira etapa é criar o segmento que define o grupo de jogadores que serão afetados por esta ação. Neste caso, precisamos criar o Segmento de XP Alto, definido como todos os jogadores que têm mais de 2.725 XP:
  • Selecione PlayStream no menu à esquerda.
  • Escolha a guia Segments.
  • Em seguida, selecione o botão New Segment.
  • Defina o Segment Name como: High XP Players.
  • Defina-o como Player, em que o Statistic Value chamado Total_XP Gained é maior que 2725.
OBSERVAÇÃO: o sistema atual de tarefas agendadas pode processar de 10 a 15 tarefas por segundo por segmento. Ao projetar seus segmentos, planeje com antecedência o tamanho que eles terão e quanto tempo a execução da tarefa levará. Não há limite para quanto tempo uma tarefa pode ser executada, mas se a tarefa precisar ser executada em um período específico, o segmento precisará ser dimensionado adequadamente.
Game Manager - PlayStream - Segmentos - Jogadores com XP alto

Etapa 2 - Criar uma tarefa para este segmento

  • Selecione a guia Segments.
  • Em seguida, selecione RUN TASK …
Game Manager - PlayStream - Segmentos - Executar tarefa Isso levará você à exibição Create Task na guia Servers->Tasks e preencherá previamente vários campos com base no segmento selecionado. Game Manager - Servidores - Tarefa - Criar tarefa

Etapa 3 - Adicionar ações à tarefa

Em seguida, você pode concluir a configuração da tarefa.
  • Altere o nome para Reward High XP Players
  • Adicione esta descrição: Give a gift to Players who are level 2 or higher.
  • Selecione ADD ACTION
    • Digite Grant virtual currency no campo fornecido.
    • Código da Virtual Currency: GM (abreviação de Gems).
    • Quantidade: 20
  • Deixe o agendamento definido como Manually por enquanto.
  • Selecione o botão SAVE AND RUN para executar a tarefa.
Game Manager - Servidores - Tarefa - Adicionar ação - Salvar e executar

Etapa 4 - Monitorar sua tarefa

A exibição Tasks mostrará sua tarefa em execução. Inicialmente, o status da tarefa será InProgress, mas mudará rapidamente para Succeeded, pois o segmento é pequeno. Game Manager - Servidores - Tarefas - Tarefa bem-sucedida Agora, vamos conferir os detalhes da execução da tarefa. Selecione a tarefa concluída na lista de Tasks executadas anteriormente. Você verá informações importantes, como:
  • Quantos jogadores foram processados.
  • Quando a tarefa foi iniciada.
  • Quanto tempo levou para ser concluída.
  • Os parâmetros que ela tinha quando foi iniciada.
  • Quem a executou.
  • Se ela foi agendada manualmente etc.
Se a tarefa ainda estiver em andamento, você poderá verificar o progresso na exibição Task Instance Detail e ver o tempo restante estimado. Game Manager - Servidores - Tarefas - Detalhes da instância da tarefa Para verificar se a tarefa foi executada com êxito:
  • Navegue até a guia Players.
  • Selecione seu Player.
  • Em seguida, escolha a guia Event History.
  • O evento mais recente na lista deve ser um player_virtual_currency_balance_changed, que deve mostrar as gemas do seu Player aumentando em 20.
Você pode expandir esse evento para ver os detalhes.
Game Manager - Histórico de eventos - Detalhes do evento

Próximas etapas

Este tutorial apresentou as etapas envolvidas na execução de uma ação para todos os jogadores de um segmento, mas há muito mais que você pode fazer com as tarefas. Aqui estão algumas ideias de outras coisas que você pode experimentar…

Agendar suas tarefas

Você não precisa executar as tarefas manualmente: é possível agendar uma tarefa para ser executada automaticamente de forma recorrente. Por exemplo, você pode criar um segmento de todos os jogadores que jogaram nas últimas 24 horas e, em seguida, executar uma tarefa agendada todos os dias para dar a esses jogadores um bônus de XP. Game Manager - PlayStream - Segmentos - Jogadores nas últimas 24 horas Game Manager - Servidores - Tarefas - Tarefa agendada

Executar o CloudScript para cada jogador

O uso mais poderoso das ações em massa é executar uma função arbitrária do CloudScript para cada jogador. Esse CloudScript pode fazer qualquer coisa que a API de servidor do PlayFab possa fazer: conceder itens, moeda, inspecionar e alterar dados do jogador e assim por diante. Por exemplo, imagine que você tenha um placar de evento que é redefinido toda semana e queira percorrer todos os jogadores e dar uma recompensa com base no valor do último evento antes da redefinição. O exemplo fornecido abaixo usa o Unicorn Battle.
  1. Crie uma nova estatística Event_QuestsCompleted, que é redefinida semanalmente e usa o método de agregação Last. Jogadores - Placares - Editar placar
  2. Crie uma nova ação do PlayStream que incrementa a estatística Event_QuestsCompleted sempre que Total_QuestsCompleted é alterada. PlayStream - Ações de evento - Editar ação de evento
  3. Escreva uma função do CloudScript a ser chamada por uma tarefa de Ação em Massa, que percorrerá os jogadores e dará recompensas com base no último valor.
  1. Defina a nova versão do CloudScript como Live e crie uma nova tarefa que chame a função GiveTieredReward para todos os jogadores. Não se esqueça de selecionar Save e Run na tarefa. Servidores - Tarefas - Nova tarefa agendada
  2. Você deverá notar os eventos dessa tarefa aparecendo no depurador de eventos do PlayStream. PlayStream - Painel - Depurador de eventos
  3. Você pode selecionar qualquer evento de CloudScript executado por ação disparada pelo jogador (selecionando o carimbo de data/hora) e ver o resultado detalhado da execução do CloudScript para cada jogador. Isso inclui informações de diagnóstico úteis, como o instantâneo do perfil do jogador no momento da execução do CloudScript. PlayStream - Painel - JSON bruto do evento
Última modificação em 6 de outubro de 2026