Pular para o conteúdo principal
O plug-in PlayFab Multiplayer Unity SDK é um wrapper em C# do Unity sobre uma biblioteca nativa PlayFabMultiplayer em C++, criado para a conveniência dos desenvolvedores de jogos do Unity. Ele permite usar os serviços do PlayFab Multiplayer no seu jogo do Unity. No momento, isso inclui o Lobby e o Matchmaking. Ele foi projetado para o desenvolvimento de jogos em várias plataformas. O plug-in PlayFab Multiplayer para Unity funciona em conjunto com o SDK “principal” do PlayFab para Unity. O SDK “principal” do PlayFab para Unity fornece outras funcionalidades do PlayFab, como economia, placares de líderes e muito mais. Para obter mais informações, consulte PlayFab Unity SDK e a documentação do PlayFab Unity SDK. O plug-in PlayFab Multiplayer para Unity está disponível para download como um pacote Unity Asset.

Quais recursos de API são fornecidos pelo plug-in PlayFab Multiplayer para Unity?

  • Lobby
  • Matchmaking
  • Suporte às seguintes plataformas:
    • GDK:
      • XBOX Series X|S
      • XBOX One
      • PC
    • Windows
  • Suporte ao jogo entre plataformas nas plataformas acima

O que está incluído no plug-in PlayFab Multiplayer para Unity?

  • A API Multiplayer de nível superior escrita em C# do Unity, fornecida pela classe PlayFabMultiplayer, e um prefab para a integração do jogo do Unity do usuário com a biblioteca PlayFabMultiplayer
  • Camada de interoperabilidade em C# que fornece uma interface de código gerenciado para a API da biblioteca Multiplayer nativa (C++) subjacente. Ela é usada pela API em C# de nível superior.
  • Binários nativos (C++) subjacentes do PlayFabMultiplayer para cada plataforma compatível:
    • Bibliotecas DLL do Multiplayer para GDK
    • Bibliotecas DLL do Multiplayer para Windows
  • Plug-in do SDK “principal” do PlayFab para Unity (pode ser atualizado de forma independente, se necessário)

Versões do plug-in PlayFab Multiplayer para Unity e compatibilidade entre plataformas

O plug-in PlayFab Multiplayer para Unity será publicado e disponibilizado para download em vários pontos de distribuição (repositórios Git), dependendo da plataforma. O acesso a alguns pontos de distribuição é restrito. Você precisa enviar uma solicitação ao seu representante da Microsoft, e isso pode incluir etapas adicionais. Para fornecer melhores orientações sobre a compatibilidade entre versões baixadas de diferentes pontos de distribuição e refletir uma referência a uma versão específica da biblioteca nativa subjacente, o plug-in PlayFab Multiplayer para Unity segue um esquema de versionamento personalizado.

Esquema de versionamento do plug-in PlayFab Multiplayer para Unity

Por exemplo, 1.2.0.3-gdk.0 (uma versão baixada do repositório do GDK com acesso restrito) ou 1.2.0.3-ps5.0 (uma versão com binários do Multiplayer apenas para PlayStation®5, baixada do repositório do PS5™ com acesso restrito). Componentes da versão:
  • X.X.X: a versão mais baixa da biblioteca PlayFabMultiplayer subjacente entre todas as plataformas compatíveis. Isso é usado para manter a consistência geral de referência com uma versão da biblioteca C++ subjacente. No exemplo acima, a versão da biblioteca PlayFabMultiplayer incluída para cada plataforma é 1.2.0 ou superior.
  • Y: um índice incremental de quaisquer modificações na camada C# do Multiplayer para Unity, para qualquer parte X.X.X da versão.
  • (distribution-point-indicator): um código mnemônico para rastrear de qual ponto de distribuição um determinado pacote do plug-in PlayFab Multiplayer para Unity foi baixado. Ele difere por ponto de distribuição, por exemplo, gdk (repositório do Microsoft Azure DevOps com acesso restrito para desenvolvedores do GDK), ps5 (repositório do Microsoft Azure DevOps com acesso restrito para desenvolvedores do PS5) etc.
  • Z: um índice incremental de quaisquer modificações exclusivas do ponto de distribuição (por exemplo, binários do Multiplayer atualizados/corrigidos apenas para uma plataforma específica).
Um número mais alto em qualquer componente da versão significa uma versão mais recente, por ordem de significância da esquerda para a direita. “PlayStation” é uma marca registrada ou marca comercial da Sony Interactive Entertainment Inc. “PS5” é uma marca registrada ou marca comercial da Sony Interactive Entertainment Inc.

Compatibilidade entre versões de diferentes pontos de distribuição

Independentemente do ponto de distribuição de onde um plug-in PlayFab Multiplayer para Unity for baixado, é garantido que ele será totalmente compatível com um plug-in PlayFab Multiplayer para Unity baixado de qualquer outro ponto de distribuição se os quatro primeiros números (X.X.X.Y) da versão forem iguais. Versões compatíveis de diferentes pontos de distribuição podem ser importadas para o projeto do Unity do usuário em qualquer ordem, sem risco de que uma substitua ou quebre a outra, pois o código compartilhado deve ser idêntico. No entanto, cada uma delas pode ter alguns arquivos adicionais (não compartilhados), específicos de uma plataforma, que não devem se sobrepor. Por exemplo, você pode importar todas as seguintes versões do plug-in PlayFab Multiplayer para Unity no seu projeto do Unity, em qualquer ordem sequencial, se estiver direcionando para GDK, PS5 e Switch:
  • 1.2.0.3-gdk.0 (importa os binários do Multiplayer para GDK, entre outros arquivos)
  • 1.2.0.3-ps5.0 (importa os binários do Multiplayer para PS5, entre outros arquivos)
  • 1.2.0.3-sw.0 (importa os binários do Multiplayer para Switch, entre outros arquivos)
O código C# do Unity compartilhado (multiplataforma) incluído em cada um desses plug-ins será o mesmo.

Quais versões do Unity são compatíveis?

Nós nos esforçamos para oferecer suporte a todas as versões recentes do Unity a partir do Unity 2017; no entanto, sua escolha pode ser limitada pela disponibilidade de um complemento de desenvolvimento do Unity para cada plataforma específica. Consulte a documentação correspondente do Unity. Isso, por sua vez, também pode limitar sua escolha do SDK da plataforma. Em geral, testamos o plug-in PlayFab Multiplayer para Unity com uma das versões mais recentes dos complementos de desenvolvimento do Unity disponíveis para cada plataforma. Recomendamos que você relate quaisquer problemas de build ou de runtime com qualquer nova versão do Unity Editor, de um complemento do Unity ou de um SDK de plataforma.
Última modificação em 8 de outubro de 2026