Skip to main content
Assim que seu título do GDK para PC estiver em execução, adicione os XBOX services opcionais e os recursos do Microsoft Azure PlayFab conforme o seu design exigir. Nenhum deles é obrigatório para publicar na Microsoft Store; escolha o que se adequa ao seu título.

​
Ordem de adoção sugerida

  1. Entrada e identidade: XUser e entrada no PlayFab.
  2. Conquistas e estatísticas: Conquistas do XSAPI e Estatísticas do jogador.
  3. Salvamentos na nuvem: XGameSave.
  4. Social: amigos e jogadores recentes e Rich Presence.
  5. Multijogador: Lobbies, Matchmaking, Multijogador, Convites e Chat.
  6. Comércio: XStore, Compras no jogo e DLC.
  7. Integrações no lado do servidor: Autenticação S2S, Conteúdo gerado pelo usuário e Live ops.

​
Tópicos de serviços opcionais

Cada linha abaixo corresponde a um tópico abordado no guia E2E para PC de origem. As orientações detalhadas de integração estão nos documentos de recursos vinculados.

​
Chat

Use o PlayFab Party para chat de voz e texto síncrono no PC e no XBOX. Principais etapas:
  1. Configure o SDK do PlayFab Party.
  2. Autentique o jogador tanto nos XBOX services quanto no PlayFab.
  3. Crie ou ingresse em uma rede do Party com PartyManager::CreateNewNetwork().
  4. Crie um PartyLocalChatControl por usuário local e conecte-o com PartyNetwork::ConnectChatControl().
  5. Escolha os dispositivos de entrada/saída de áudio por meio de PartyLocalChatControl::SetAudioInput/Output e de um PartyAudioDeviceSelectionType.
  6. Configure as permissões de chat e o estado de mudo entre pares de controles de chat.
  7. Adicione chat de texto por meio de SendText, opcionalmente com tradução por meio de SetTextChatOptions.
  8. Adicione acessibilidade: transcrição de fala em texto e síntese de texto em fala por meio dos Serviços de Fala do Azure.
  9. Habilite a supressão de ruído no áudio capturado do microfone.
Se você também lançar no XBOX, use a Party XBOX Live Helper Library para atender aos requisitos dos XBOX services.

​
Compras no jogo

Use o XStore (por meio de XGameRuntime.h) para fluxos de compra no jogo na Microsoft Store:
  • Consulte o catálogo da loja, os produtos associados (complementos, consumíveis, duráveis) e a coleção de direitos do usuário.
  • Exiba a UI de compra por meio de XStoreShowPurchaseUIAsync.
  • Consuma itens consumíveis por meio de XStoreReportConsumableFulfillmentAsync.
  • Atualize as licenças com XStoreQueryProductForCurrentSkuAsync após alterações nos direitos.
Para economias virtuais orientadas pelo PlayFab (moedas, inventário, pacotes), combine as compras do XStore com o PlayFab Economy v2.

​
Convites

Use o PlayFab Lobby para convites e ingressos entre PC/XBOX:
  1. Integre o SDK do PlayFab Lobby e Matchmaking.
  2. Autentique-se nos XBOX services e no PlayFab.
  3. Escolha a propriedade do lobby: de propriedade do jogador (PFMultiplayerCreateAndJoinLobby), de propriedade do servidor (PFMultiplayerCreateAndClaimServerLobby) ou criado pelo matchmaking.
  4. Escute convites por meio de PFMultiplayerStartListeningForLobbyInvites.
  5. Envie convites pela UI de convite da plataforma para que o destinatário veja uma notificação nativa do XBOX/da Store.
O lobby também serve como a sessão de jogo na qual os jogadores ingressam depois de aceitar um convite.

​
Placares de líderes

Use os placares de líderes gerenciados pelo título do XSAPI para placares de líderes sociais e globais nos XBOX services:
  1. Defina os placares de líderes no Partner Center em XBOX services → Dados do jogador.
  2. Emita eventos de estatísticas vinculados ao placar de líderes usando o Stats Manager.
  3. Consulte os placares de líderes por meio de XblLeaderboardGetLeaderboardAsync (global) ou XblLeaderboardGetLeaderboardForSocialGroupAsync (amigos).
Consulte Placares de líderes.

​
Lobbies

Use o PlayFab Lobby para o estado de sessão compartilhado (lista de membros, propriedades arbitrárias, propriedade):
  • Crie, ingresse, encontre e saia de lobbies com o SDK em C do PlayFab Multiplayer.
  • Armazene metadados de jogabilidade como propriedades do lobby (modo de jogo, mapa, estado de pronto).
  • Combine com o PlayFab Matchmaking para formar lobbies a partir de um grupo correspondido.
  • Combine com o PlayFab Party para adicionar rede e voz além da associação ao lobby.

​
Matchmaking

Use o PlayFab Matchmaking para matchmaking baseado em habilidades/atributos que produz um lobby compartilhado:
  • Defina filas de matchmaking no PlayFab Game Manager com regras sobre os atributos dos jogadores.
  • Envie tíquetes por meio de PFMatchmakingCreateMatchmakingTicket.
  • Quando uma partida for encontrada, os jogadores serão colocados em um lobby compartilhado de sua propriedade.
Para títulos somente do XBOX Live, o SmartMatch por meio do MPSD também é compatível, mas o PlayFab Matchmaking é o caminho recomendado para novos títulos.

​
Multijogador

Duas pilhas multijogador compatíveis no PC/XBOX:
  • PlayFab Multiplayer: multiplataforma, usa o PlayFab Lobby para sessões e o PlayFab Party para transporte. Recomendado para novos títulos.
  • Multijogador dos XBOX services: sessões MPSD + Multiplayer Manager (MPM). Ainda compatível para títulos somente do XBOX.
Ambos os caminhos são descritos na Visão geral do multijogador.

​
Rede

Use o PlayFab Party como transporte de rede para o tráfego de jogabilidade em tempo real:
  • Envie mensagens confiáveis/não confiáveis entre pontos de extremidade conectados.
  • Combine voz, texto e dados de jogabilidade na mesma rede do Party.
  • No XBOX, o Party se integra automaticamente ao caminho de rede da plataforma; no PC, ele usa UDP com fallback.

​
Estatísticas do jogador

Use o Stats Manager do XSAPI para estatísticas do jogador gerenciadas pelo título:
  1. Defina as estatísticas no Partner Center em XBOX services → Dados do jogador.
  2. Adicione a estatística ao jogador com XblStatsManagerSetStatAsNumber / SetStatAsString.
  3. Incremente ou substitua as estatísticas em resposta à jogabilidade.
  4. Libere as atualizações pendentes com XblStatsManagerDoWork a cada quadro.
As estatísticas alimentam os placares de líderes e são mostradas no perfil do jogador.

​
Rich Presence

Use o Presence do XSAPI para transmitir o que o jogador está fazendo:
  1. Defina enumerações de presença e conjuntos de cadeias de caracteres no Partner Center.
  2. Atualize a presença com XblPresenceSetPresenceAsync quando o jogador passar para um novo estado (menu, nível, partida).
  3. Consulte outros jogadores com XblPresenceGetPresenceAsync ou XblPresenceGetPresenceForMultipleUsersAsync.
Consulte Rich Presence.

​
Autenticação S2S

Use o Microsoft Entra ID + IDs da User Store para autenticação serviço a serviço quando seu back-end precisar chamar as APIs da Microsoft Store em nome de um jogador:
  • Dois tipos de ID da User Store:
    • UserCollectionsID: autentica no serviço Collections da Microsoft Store (inventário de direitos).
    • UserPurchaseID: autentica no serviço Purchase da Microsoft Store (verificação de transações).
  • Seu serviço adquire um token de acesso do Entra ID e o usa, junto com o ID da User Store do cliente do jogo, para chamar as APIs REST da Store.
  • Recomendado para novos títulos; a autenticação baseada em X-token é herdada.

​
Conteúdo gerado pelo usuário

Use o PlayFab Economy v2 para catálogos de UGC sobre um pipeline de ativos próprio ou de terceiros:
  1. Autentique o jogador no PlayFab.
  2. Gere URLs de upload assinadas com CreateUploadUrls.
  3. Crie um item de rascunho com CreateDraftItem (Type:ugc).
  4. Enumere os itens de rascunho por meio de GetEntityDraftItems.
  5. Publique com PublishDraftItem: os itens publicados aparecem no catálogo público.
  6. Verifique o status com GetItemPublishStatus.
  7. Consulte o catálogo com SearchItems (OData Filter, OrderBy, Select).
A revisão/moderação opcional é feita pelos Revisores de Catálogo no PlayFab Game Manager.

​
Relacionados

​
Documentação de API relacionada

Last modified on October 6, 2026