Pular para o conteúdo principal
O plug-in do PlayFab Party Unity SDK é um wrapper em C# do Unity sobre uma biblioteca nativa do Party em C++, criado para a conveniência dos desenvolvedores de jogos do Unity. Ele permite que você use o Party e os Serviços Cognitivos do Party no seu jogo do Unity, incluindo:
  • Rede multijogador
  • Mensagens de chat e troca de dados
  • Conversa e jogo entre plataformas (cross-talk e cross-play)
  • Recursos de acessibilidade, como tradução de chat de texto e transcrição de voz em tempo real
Ele foi projetado para o desenvolvimento de jogos em várias plataformas. O plug-in do PlayFab Party para Unity funciona junto com o plug-in “principal” do PlayFab Unity SDK, que fornece outras funcionalidades do PlayFab, como economia, placares de líderes e muito mais. Para obter mais informações, confira PlayFab Unity SDK e a documentação do PlayFab Unity SDK. O plug-in do Party para Unity está disponível para download como um pacote de ativos do Unity. Atualmente, ele tem suporte para o desenvolvimento de jogos nas seguintes plataformas: “PlayStation” é uma marca registrada ou marca comercial da Sony Interactive Entertainment Inc. “PS4” é uma marca registrada ou marca comercial da Sony Interactive Entertainment Inc. “PS5” é uma marca registrada ou marca comercial da Sony Interactive Entertainment Inc. *- As bibliotecas subjacentes do Party para o GDK não estão incluídas no plug-in. Confira a seção de controle de versão para obter detalhes. “PlayStation” é uma marca registrada ou marca comercial da Sony Interactive Entertainment Inc.

Quais recursos de API são fornecidos pelo plug-in do Party para Unity?

  • Rede para jogos
  • VoIP
  • Suporte para as seguintes plataformas:
    • GDK:
      • XBOX Series X|S
      • XBOX One
      • PC
    • Windows
    • iOS
    • Android
    • PS4™
    • PS5™
    • Switch
  • Suporte a cross-play e cross-talk entre as plataformas acima
  • Serviços Cognitivos do Party
    • Tradução de chat de texto em tempo real
    • Transcrição de chat de voz em tempo real
    • Tradução de chat de voz em tempo real
    • Síntese de texto em fala
“PS4” é uma marca registrada ou marca comercial da Sony Interactive Entertainment Inc. “PS5” é uma marca registrada ou marca comercial da Sony Interactive Entertainment Inc.

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

  • API do Party simplificada de nível superior, escrita em C# do Unity e fornecida pela classe e pelo prefab PlayFabMultiplayerManager, para facilitar a integração do jogo do Unity do usuário com os principais recursos da biblioteca do Party
  • Camada de interoperabilidade em C# que fornece uma interface de código gerenciado para a API subjacente da biblioteca nativa (C++) do Party. Ela é usada pela API C# de nível superior.
  • Binários nativos (C++) subjacentes do Party para cada plataforma com suporte:
    • Bibliotecas DLL do Party para Windows
    • Bibliotecas iOS Framework do Party para iOS (dispositivo e simulador)
    • Arquivo de biblioteca AAR do Party para Android
    • As bibliotecas DLL do Party para Microsoft Game Core NÃO estão incluídas. Elas são distribuídas com o GDK e devem ser copiadas para o plug-in antes de compilar seu projeto do Unity (confira os detalhes no arquivo README incluído com o plug-in)
    • Bibliotecas dinâmicas do Party para PS4 e PS5
    • Bibliotecas estáticas do Party para Switch
  • Plug-in “principal” do PlayFab Unity SDK (pode ser atualizado de forma independente, se necessário)
  • API de autenticação e de provedor de políticas do XBOX Live, atualmente com suporte apenas na plataforma GDK

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

O plug-in do Party para Unity é 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 e requer uma solicitação ao seu representante da Microsoft. O plug-in do Party para Unity usa um esquema de controle de versão personalizado para esclarecer a compatibilidade entre versões baixadas de diferentes pontos de distribuição e para referenciar uma versão específica da biblioteca nativa subjacente.

Esquema de controle de versão do plug-in do Party para Unity

Por exemplo, 1.5.0.3-main.0 (uma versão baixada do repositório público principal do GitHub) ou 1.5.0.3-ps5.0 (uma versão com binários do Party apenas para PS5, baixada de um repositório com acesso restrito). Componentes da versão:
  • X.X.X - a versão mais baixa da biblioteca subjacente do Party entre todas as plataformas com suporte. Esse valor fornece consistência de referência com a versão da biblioteca C++ subjacente. No exemplo acima, a biblioteca do Party incluída para cada plataforma é a versão 1.5.0 ou superior.
  • Y - um índice incremental de quaisquer modificações na camada C# do Party para Unity, para qualquer parte X.X.X da versão.
  • (distribution-point-indicator) - um código mnemônico para controlar de qual ponto de distribuição um determinado pacote do plug-in do Party para Unity foi baixado. Ele varia de acordo com o ponto de distribuição, por exemplo, main (repositório público principal de distribuição no GitHub), ps5 (repositório do Microsoft Azure DevOps com acesso restrito para desenvolvedores de PS5) e assim por diante.
  • Z - um índice incremental de quaisquer modificações exclusivas do ponto de distribuição (por exemplo, binários do Party atualizados ou corrigidos apenas para uma plataforma específica).
Um número maior em qualquer componente da versão significa uma versão mais recente, por ordem de significância da esquerda para a direita.

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

Independentemente do ponto de distribuição, um plug-in do Party para Unity tem garantia de ser totalmente compatível com um plug-in do Party para Unity de qualquer outro ponto de distribuição se os quatro primeiros números (X.X.X.Y) de suas versões forem iguais. Você pode importar versões compatíveis para o seu projeto do Unity em qualquer ordem, sem que uma substitua ou quebre a outra, pois o código compartilhado delas é idêntico. Cada versão pode ter arquivos extras específicos da plataforma que não se sobrepõem. Por exemplo, você pode importar todas as seguintes versões do plug-in do Party para Unity no seu projeto do Unity, em qualquer ordem sequencial, se o seu destino for iOS, PS5 e Switch:
  • 1.5.0.3-main.0 (importa os binários do Party para iOS, entre outros arquivos)
  • 1.5.0.3-ps5.0 (importa os binários do Party para PS5, entre outros arquivos)
  • 1.5.0.3-sw.0 (importa os binários do Party para Switch, entre outros arquivos)
O código C# do Unity compartilhado (multiplataforma) incluído em cada um desses plug-ins é o mesmo.

Quais versões do Unity têm suporte?

Damos 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. Confira a documentação correspondente do Unity para obter detalhes. Isso, por sua vez, também pode limitar sua escolha de SDK da plataforma. Em geral, testamos o plug-in do Party para Unity com uma das versões mais recentes dos complementos de desenvolvimento do Unity disponíveis para cada plataforma. Incentivamos nossos clientes a relatar quaisquer problemas de build ou de tempo de execução com qualquer nova versão do Unity Editor, de complemento do Unity ou de SDK de plataforma.

Preços

A rede e o chat de voz do Party estão incluídos sem custo adicional para desenvolvedores qualificados do ecossistema XBOX por meio do Foundation Mode. Os Serviços Cognitivos do Party e outros serviços podem ter custos associados. Para obter detalhes, confira Cobrança do PlayFab Party ou entre em contato com seu representante da Microsoft.
Última modificação em 8 de outubro de 2026