> ## 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.

# Notas de versão do PlayFab OnlineSubsystem para Unreal Engine

> Histórico de versões e notas de versão do plug-in PlayFab OnlineSubsystem para Unreal Engine 4 e 5, abrangendo atualizações do Party, de multijogador e de lobby.

# Notas de versão do PlayFab Unreal Engine OnlineSubsystem

Consulte [Início rápido: PlayFab Online Subsystem (OSS)](/pt-BR/services/playfab/multiplayer/networking/party-unreal-engine-oss-quickstart) para obter instruções de download e instalação.

## 2.3.8

**A versão 2.3.8 está pronta para uso com o Unreal Engine 5.7.**

Correções da atualização para o UE5.7:

* Removida a chave `SEARCH_PRESENCE` não utilizada do mapeamento de chaves de pesquisa de lobby e da lógica de filtro de consulta relacionada, simplificando o tratamento dos parâmetros de pesquisa de lobby.
* Removido código morto relacionado à pesquisa de sessões no Win64, pois a nova lógica de ingresso não depende mais desse caminho.

Correções de bugs:

* Adicionado um novo método `CleanupFailedJoinSession` a `FOnlineSessionPlayFab` para garantir a limpeza adequada das sessões do PlayFab e do Party, a remoção das referências de sessão locais e a notificação de delegados quando o ingresso em uma sessão nativa falha. Esse método agora é chamado em todos os caminhos de falha relevantes.

* Alterada a lógica para armazenar em cache a sessão desejada (`CachedDesiredSession`) em vez de pesquisá-la a cada ingresso, simplificando e melhorando a confiabilidade dos ingressos em sessões nativas.

## 2.3.7

**A versão 2.3.7 está pronta para uso com o Unreal Engine 5.6.**

Atualizações de bibliotecas:

* Biblioteca C++ do Multiplayer SDK (Windows/GDK): de 1.7.9 para 1.8.0.
* Biblioteca C++ do Party SDK (Windows/GDK): de 1.10.5 para 1.10.12.

Correções da atualização para o UE5.6:

* Atualizado `OnlineSubsystemPlayFab.uplugin` para usar `PlatformAllowList` em vez de `WhitelistPlatforms`, e renomeado `OnlineSubsystemSwitch` para `OnlineSubsystemNintendo` para manter a consistência. A versão do plug-in também foi incrementada.
* No UE 5.6 e posterior, o parâmetro `DriverClassName` exige o prefixo "/Script/". Por exemplo, use `"/Script/OnlineSubsystemPlayFab.PlayFabNetDriver"` em vez de `"OnlineSubsystemPlayFab.PlayFabNetDriver"`.
  Exemplo de uso:
  ```
  [/Script/Engine.GameEngine]
  +NetDriverDefinitions=(DefName="GameNetDriver",DriverClassName="/Script/OnlineSubsystemPlayFab.PlayFabNetDriver",DriverClassNameFallback="OnlineSubsystemUtils.IpNetDriver")
  ```

## 2.3.6

**A versão 2.3.6 está pronta para uso com o Unreal Engine 5.5.**

Atualizações de bibliotecas:

* Biblioteca C++ do Multiplayer SDK (Windows/GDK): de 1.7.2 para 1.7.9.
* Biblioteca C++ do Party SDK (Windows/GDK): de 1.9.5 para 1.10.5.

Correções da atualização para o UE5.5:

* `OnSessionParticipantsChanged` ([preterido](https://dev.epicgames.com/documentation/en-us/unreal-engine/unreal-engine-5.2-release-notes?application_version=5.2#onlinesubsystem-2) no UE5.2) foi removido no UE5.5. O PF OSS foi atualizado para usar os novos `OnSessionParticipantJoined` e `OnSessionParticipantLeft`.
* `GDKUserManager.h` foi movido de `Engine\Platforms\GDK\Source\Runtime\GDKRuntime\Public\GDKUserManager.h` para `Engine\Platforms\GDK\Source\Runtime\GDKRuntime\Private\GDKUserManager.h`. O PF OSS foi atualizado para não depender mais desse cabeçalho.

Correções de bugs:

* Corrigido um problema em que um jogador que perdesse a conectividade inesperadamente poderia não conseguir ingressar em outra sessão ou criá-la.
* Corrigido um problema em que `FindSessionById` e `CreateSession` poderiam ser chamados fora de ordem.

Problema conhecido:

* Ao usar o PlayFab Online Subsystem no UE5.5 GDK, você poderá encontrar o seguinte erro de runtime: `Runtime dependency Party.dll is configured to be staged from C:\Program Files (x86)\Microsoft GDK\<version>\Party.dll and \Engine\Plugins\Online\OnlineSubsystemPlayFab\Platforms\GDK\Redist\Party.dll`.
  Para resolver esse problema, consulte [Início rápido: PlayFab Online Subsystem (OSS)](/pt-BR/services/playfab/multiplayer/networking/party-unreal-engine-oss-quickstart#unreal-engine-installed-builds).
* `NumPrivateConnections` de FOnlineSessionSettings não tem suporte, porque o serviço PlayFab não rastreia conexões privadas.

## 2.3.4

* Suporte ao lançamento do UE5.4.

Atualizadas as seguintes bibliotecas:

* Atualizada a biblioteca C++ do Multiplayer SDK para a versão 1.7.2 para Windows e GDK.
* Atualizada a biblioteca C++ do Party SDK para a versão 1.9.5 para Windows e GDK.

Correções de recursos:

* Corrigida a falha ao criar ou ingressar em uma sessão quando o nome do jogador inclui emojis ou tipos especiais de caracteres.
* Corrigida a falha ao atualizar a política de acesso do lobby.
* Corrigida uma possível falha causada por `GetBytes()` e `GetSize()`.
* Adicionadas funções e interfaces de passagem ausentes para o OSS nativo.
* \[Steam] Corrigida a falha do jogo ao iniciar um jogo da Steam sem antes iniciar o aplicativo Steam.
* \[Steam] Substituído `GetAuthSessionTicket()` por `GetAuthTicketForWebApi()` para o SDK 1.57 da Steam.

Problema conhecido:

* Ao usar o PlayFab Online Subsystem no UE5.4 GDK, você poderá encontrar o seguinte erro de runtime: `Runtime dependency Party.dll is configured to be staged from C:\Program Files (x86)\Microsoft GDK\<version>\Party.dll and \Engine\Plugins\Online\OnlineSubsystemPlayFab\Platforms\GDK\Redist\Party.dll`.
  Para resolver esse problema, consulte [Início rápido: PlayFab Online Subsystem (OSS)](/pt-BR/services/playfab/multiplayer/networking/party-unreal-engine-oss-quickstart#unreal-engine-installed-builds).
* `NumPrivateConnections` de FOnlineSessionSettings não tem suporte, porque o serviço PlayFab não rastreia conexões privadas.

## 2.3.3

Atualizações de recursos:

* Adicionado suporte a cenários de servidor dedicado. Para obter mais informações sobre como configurar servidores dedicados para o seu jogo, consulte o [Guia de configuração de servidor dedicado](/pt-BR/services/playfab/multiplayer/networking/party-unreal-engine-oss-dedicated-servers).
* Adicionada uma integração melhor com o [Plug-in do Marketplace do PlayFab SDK para Unreal Engine (UE)](https://www.unrealengine.com/marketplace/product/playfab-sdk). Para obter mais informações sobre a integração do plug-in do PlayFab, consulte o [Guia de integração do plug-in do Marketplace do PlayFab SDK para UE](/pt-BR/services/playfab/multiplayer/networking/party-unreal-engine-oss-playfab-plugin-integration).
* Introduzido um novo booliano de configuração, `bForceAutoLogin`.
  * Anteriormente, nas plataformas Win64 e PlayStation, o comportamento padrão era sempre tentar chamar `AutoLogin()` para o usuário local principal.
  * Esse novo booliano de configuração permite que `AutoLogin()` seja desabilitado nas plataformas Win64 e PlayStation, caso você queira chamar `Login()` em outro lugar.
  * O comportamento padrão permanece o mesmo com `bForceAutoLogin` definido como `true`. Você pode configurar `bForceAutoLogin` no arquivo `<Windows|PS4|PS5>Engine.ini`, na seção `OnlineSubsystemPlayFab`.
    ```ini theme={null}
    [OnlineSubsystemPlayFab]
    bForceAutoLogin=<true|false>
    ```
  * O comportamento de logon de todas as outras plataformas permanece inalterado.

## 2.3.2

Atualizadas as seguintes bibliotecas:

* Atualizada a biblioteca C++ do Multiplayer SDK para a versão 1.6.5 para Windows e GDK.
* Atualizada a biblioteca C++ do Party SDK para a versão 1.8.9 para Windows e GDK.

## 2.3.1

* Suporte ao UE5.3 e a versões anteriores do UE (UE4.27+, UE5.0, UE5.1 e UE5.2. Consulte [Início rápido: quais versões do Unreal Engine têm suporte](/pt-BR/services/playfab/multiplayer/networking/party-unreal-engine-oss-overview#which-versions-of-unreal-engine-are-supported)).

Problema conhecido:

* A versão WinGDK do UE5.3 tem um problema conhecido relacionado a solicitações HTTP. A Epic Games reconheceu esse problema e o corrigiu na versão 5.4. Para contornar esse problema no UE5.3, inicie o jogo usando o argumento de linha de comando `-UseWinHttpGDK` para alternar para o WinHTTP em vez do xCurl. Para obter mais informações, consulte a postagem do fórum do Unreal Engine sobre o [problema de execução do HTTP do WinGDK 5.3 com o xCurl](https://udn.unrealengine.com/s/question/0D54z00009l9fK0CAI/53-wingdk-http-module-wont-compile-with-xcurl).

## 2.3.0

* Suporte ao UE5.2 e a versões anteriores do UE (UE4.27+, UE5.0 e UE5.1. Consulte [Início rápido: quais versões do Unreal Engine têm suporte](/pt-BR/services/playfab/multiplayer/networking/party-unreal-engine-oss-overview#which-versions-of-unreal-engine-are-supported)).

Correções de recursos:

* Implementados `FOnlineSessionPlayFab::SendSessionInviteToFriends` e `FOnlineExternalUIPlayFab::ShowInviteUI` para GDK, Steam e PlayStation com convites nativos da plataforma
* Corrigida a exibição da ID de plataforma do jogador
* Corrigida a falha ao atualizar propriedades de membros e chaves de pesquisa de lobby
* Corrigida a falha ao jogar um novo jogo após suspender e retomar na plataforma XBOX
* Corrigido um problema de áudio do microfone no GDK
* Corrigida a modificação em `bIsDedicated` em `OnlineSessionInterfacePlayFab`

Correções de compilação:

* XboxOne foi preterido e substituído por XB1 para o Unreal Engine 5.2
* Resolvidos avisos de build, erros de build não unity e problemas de compilação quando os usuários não têm acesso ao Unreal Engine em todas as plataformas

Problema conhecido:

* Para convidar um jogador da Steam ou do PlayStation, o host deve estar na mesma plataforma.

## 2.0.0

* O OSS PlayFab do mecanismo UE4 foi atualizado para usar os recursos multijogador oferecidos pelo PlayFab, como Lobby e Matchmaking, junto com o PlayFab Party.
  Esta atualização substitui o MPSD fornecido pelo XBOX pelo PlayFab Lobby e o XBL Smart Match pelo serviço Azure Matchmaking.
* O XDK não tem mais suporte nesta versão do OSS.

## 1.0.7

* A versão 4.26 do mecanismo UE4 é a versão recomendada para uso com esta versão do OnlineSubsystemPlayfab.

### Observações:

* OnlineSubsystemPlayFabParty foi renomeado para OnlineSubsystemPlayfab.


## Related topics

- [Azure PlayFab Party Online Subsystem para Unreal](/pt-BR/build/console-features/networking/game-mesh/party-unreal-online-subsystem.md)
- [Notas de versão do PlayFab 2017](/pt-BR/services/playfab/release-notes/2017.md)
- [Visão geral do PlayFab para Unreal Engine](/pt-BR/services/playfab/sdks/unified-unreal/overview.md)
- [Configuração de servidor dedicado do PlayFab Online Subsystem (OSS)](/pt-BR/services/playfab/multiplayer/networking/party-unreal-engine-oss-dedicated-servers.md)
- [Integrar o plug-in do PlayFab do Unreal Engine Marketplace](/pt-BR/services/playfab/multiplayer/networking/party-unreal-engine-oss-playfab-plugin-integration.md)
