> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Visão geral do plug-in do Party para Unity

> Visão geral do plug-in do PlayFab Party para Unity, que adiciona chat de voz em tempo real e mensagens de dados de baixa latência a jogos do Unity nas plataformas com suporte.

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](https://github.com/PlayFab/UnitySDK) e a [documentação do PlayFab Unity SDK](/pt-BR/services/playfab/sdks/unity3d).

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:

* Microsoft Game Core (GDK)\*, Windows, iOS, Android: [https://github.com/playfab/PlayFabPartyUnity](https://github.com/playfab/PlayFabPartyUnity) (acesso público)
* Sony PlayStation®:
  * PS4™: [https://dev.azure.com/PlayFabPrivate/PS4/\_git/PlayFabPartyUnityPS4](https://dev.azure.com/PlayFabPrivate/PS4/_git/PlayFabPartyUnityPS4) (acesso restrito mediante solicitação ao representante da Microsoft)
  * PS5™: [https://dev.azure.com/PlayFabPrivate/PS5/\_git/PlayFabPartyUnityPS5](https://dev.azure.com/PlayFabPrivate/PS5/_git/PlayFabPartyUnityPS5) (acesso restrito mediante solicitação ao representante da Microsoft)
* Nintendo Switch™: [https://dev.azure.com/PlayFabPrivate/Switch/\_git/PlayFabPartyUnitySwitch](https://dev.azure.com/PlayFabPrivate/Switch/_git/PlayFabPartyUnitySwitch) (acesso restrito mediante solicitação ao representante da Microsoft)

"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

```text theme={null}
X.X.X.Y-(distribution-point-indicator).Z
```

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](/pt-BR/services/playfab/get-started/mode-overview).**

Os Serviços Cognitivos do Party e outros serviços podem ter custos associados. Para obter detalhes, confira [Cobrança do PlayFab Party](/pt-BR/services/playfab/pricing/meters/meters#party) ou entre em contato com seu representante da Microsoft.


## Related topics

- [Visão geral do plug-in PlayFab Multiplayer para Unity](/pt-BR/services/playfab/multiplayer/lobby/lobby-matchmaking-sdks/multiplayer-unity-overview.md)
- [Visão geral do Unity](/pt-BR/paths/unity/overview.md)
- [SDK do Azure PlayFab Party para Unity](/pt-BR/build/console-features/networking/game-mesh/party-unity-plugin.md)
- [Visão geral do plug-in PlayFab Unreal GSDK](/pt-BR/services/playfab/multiplayer/servers/server-sdks/unreal-gsdk/index.md)
- [Visão geral do PlayFab para Unreal Engine](/pt-BR/services/playfab/sdks/unified-unreal/overview.md)
