Jogo de demonstração: Winter Starfall

O Winter Starfall é um jogo desenvolvido pelo PlayFab para apresentar nossos diferentes recursos e oferecer uma forma de explorar como eles são implementados em um jogo ao vivo. O jogo está disponível para jogar em WinterStarfall.com. Se você já tem uma conta de desenvolvedor do PlayFab, também pode acessá-lo pelo portal do desenvolvedor na página My Studios and Titles.

página inicial do Game Manager mostrando os jogos de demonstração

O jogo foi criado como um aplicativo web e usa APIs do SDK do PlayFab junto com a integração do PlayFab com o Azure Functions para implementar funcionalidades personalizadas. Atualmente, o jogo usa os seguintes recursos do PlayFab:

Economy V2 (catálogo, moeda, pacotes, lojas)
Dados de título, dados de jogador e outras funções principais do PlayFab
Notícias do título para comunicação com os jogadores
Cloud Script com Azure Functions

Recursos adicionais da demonstração

O Winter Starfall vem com recursos que facilitam ver o que está acontecendo “nos bastidores” com o PlayFab. O jogo está disponível para qualquer pessoa jogar, mas para aproveitar ao máximo esses recursos, você precisa se inscrever para uma conta de desenvolvedor gratuita. Ao lado do ícone de perfil no canto superior direito, há um ícone do PlayFab que abre a barra lateral de atividades do PlayFab quando selecionado.

A barra lateral de atividades mostra uma lista de chamadas de API que é atualizada conforme você joga. Cada chamada de API é marcada e codificada por cores para indicar a qual SDK do PlayFab ela está relacionada.
Você pode selecionar uma das chamadas de API na lista para ver a solicitação e a resposta completas da API.
Selecionar View title F8941 abre o título no Game Manager, onde você pode ver como os diferentes recursos estão configurados. Nesta etapa, será solicitado que você entre com uma conta de desenvolvedor do PlayFab.
Clear remove todas as notificações atuais da barra de atividades.

Você pode jogar o jogo de demonstração a qualquer momento, mas para acessar o Game Manager, você precisa se inscrever para uma conta de desenvolvedor gratuita.

Recursos do PlayFab incluídos

A seção a seguir detalha os diferentes recursos do PlayFab usados no jogo.

Autenticação

A primeira coisa que acontece em qualquer jogo do PlayFab é o login de um jogador, que retorna um token de autenticação necessário para todas as chamadas de API subsequentes. O Winter Starfall oferece suporte a várias formas de entrada recuperável com email, Microsoft (via OpenID), Google e Facebook. O tutorial de código-fonte e cenários apresenta um passo a passo detalhado do fluxo de entrada e das práticas recomendadas para autenticação de jogadores. Saiba mais sobre a autenticação do PlayFab

Economy

Como um jogo de RPG de fantasia, o Winter Starfall inclui um sistema de economia para que o jogador visite lojas, compre itens e ganhe moeda por meio de batalhas. O serviço de economia mais recente do PlayFab lida com tudo relacionado a inventário e comércio no jogo. O tutorial de código-fonte e cenários apresenta um passo a passo detalhado do fluxo de compra que ocorre no jogo. Saiba mais sobre o Economy V2

Dados do jogador

Os jogadores no PlayFab têm dados associados que são armazenados no serviço por diferentes recursos. Os dados do jogador, como recurso, permitem armazenar informações relacionadas ao jogador em pares chave/valor ou em objetos e arquivos que podem ser compartilhados entre vários jogos e dispositivos. No Winter Starfall, os dados do jogador são usados para armazenar o estado do jogo e informações como quais personagens entraram no grupo do jogador. Quando o jogador avança pela história, sua posição é registrada no perfil do jogador por meio de uma chamada à API UpdateUserData. Esses dados são então acessados com GetUserData quando ele entra, para carregar o jogador no ponto certo da história com todo o progresso anterior.

Por exemplo, estes são os corpos da solicitação e da resposta da API da chamada a GetUserData durante o fluxo de login. GetUserData - Solicitação

{
  "Keys": [
    "stats",
    "location",
    "party",
    "notifications",
    "cinematicProgression",
    "enemyGroupProgression"
  ]
}

GetUserData - Resposta

{
  "code": 200,
  "status": "OK",
  "data": {
    "Data": {
      "location": {
        "Value": "{\"id\":\"intro\",\"map\":[\"intro\",\"intro-village\"]}",
        "LastUpdated": "2024-09-20T18:16:13.68Z",
        "Permission": "Private"
      },
      "party": {
        "Value": "{\"characters\":[{\"id\":1,\"armor\":\"dfae3ef9-92a0-493b-9bb8-f88a09718d26\",\"weapon\":\"32e1f684-43b0-4fe6-982e-b0829ff0d6f3\",\"spells\":null}],\"guests\":[]}",
        "LastUpdated": "2024-09-20T18:16:13.68Z",
        "Permission": "Private"
      }
    },
    "DataVersion": 20
  },
  "CallBackTimeMS": 97
}

Saiba mais sobre o recurso de dados do jogador

Dados do título

Os dados do título são semelhantes aos dados do jogador, pois armazenam pares chave-valor, mas os dados se referem ao título do jogo em vez de a um jogador específico. O Winter Starfall usa dados do título com o sistema Economy para calcular o preço ao vender um item, armazenando o valor multipliers com um valor de sell, 0.5. Para obter mais informações sobre como funciona o fluxo de venda, confira o tutorial de código-fonte e cenários.

Saiba mais sobre os dados do título

CloudScript com Azure Functions

O CloudScript é um recurso flexível que permite implementar funcionalidades personalizadas do lado do servidor, o que possibilita soluções quase ilimitadas quando combinado com outros recursos do PlayFab. O jogo usa esse recurso para resolver vários cenários:

CombatVictory - Depois que o jogador vence uma batalha, executa uma série de ações para conceder experiência, itens e adicionar membros ao grupo.
PlayerCreated - Equipa um novo jogador com itens e estatísticas iniciais.
ProgressCheckpoint - Executa ações para desbloquear itens e personagens depois de alcançar pontos-chave da história.
ResetPlayer - Apaga dados do usuário, itens e estatísticas para uma redefinição completa.
SellItem - Permite vender itens com desconto, o que não é um recurso inerente do sistema de economia. O fluxo de compra/venda é abordado com mais detalhes no tutorial de código-fonte e cenários.

Saiba mais sobre o CloudScript com Azure Functions

As funções do CloudScript do Winter Starfall são escritas em C#, mas você pode usar qualquer linguagem compatível com o Azure Functions.

Notícias do título

As notícias do título são usadas para se comunicar com todos os jogadores no escopo de um título. O Winter Starfall as implementa como um sistema de notificação para exibir dicas de jogabilidade e avisos.

Além das notícias do título, o PlayFab oferece outros recursos de comunicação, como modelos para email e notificações por push. Saiba mais sobre os métodos de comunicação do título

Limitações da demonstração

Como o Winter Starfall é alimentado por dados reais de jogadores, alguns recursos têm escopo limitado na exibição do Game Manager. Esta seção oferece uma visão geral de como os recursos limitados seriam no Game Manager. Para explorar essas páginas com mais detalhes, você pode baixar o código-fonte e executar uma instância local do jogo, ou criar seu próprio título do zero.

Para obter um guia completo dos recursos no portal do desenvolvedor, confira a documentação do Game Manager

Jogadores

A seção Players do Game Manager fica oculta no título Winter Starfall para proteger as informações dos jogadores. Normalmente, você poderia consultar a lista completa de jogadores do seu jogo e selecionar uma conta individual para atualizar os dados dela pelo Game Manager. Na página de visão geral do jogador, você pode ver todas as informações relacionadas ao jogador, incluindo itens de inventário, um registro de todos os logins, dados do jogador e muito mais.

Dados e análise

Alguns dos recursos da seção Analyze também são limitados para proteger as informações do título e dos jogadores. Essa limitação inclui as seções Data e Audit History. A seção Data contém recursos como o Data Explorer, que permite consultar e exibir um registro de eventos do PlayFab, que mostra eventos (chamadas de API), como quando um jogador específico fez login.

O histórico de auditoria oferece uma visão do histórico de alterações feitas no título por qualquer pessoa com acesso de edição. Para obter uma visão completa de quais outros recursos fazem parte da seção Data, confira a documentação de dados e análise.

Outros

Nas configurações do título, a guia Secret keys fica oculta. Confira a documentação de gerenciamento de chaves secretas.

Interface do Game Manager mostrando a página Secret Keys

Próximas etapas

Depois de experimentar a demonstração, recomendamos começar com estes artigos para saber mais sobre como o PlayFab funciona:

Saiba mais sobre o Game Manager
Saiba mais sobre o modelo de entidade
Saiba mais sobre o SDK do PlayFab Services

XBOX Services

PlayFab

Visão geral do jogo de demonstração Winter Starfall do PlayFab

Jogo de demonstração: Winter Starfall

Recursos adicionais da demonstração