Notas de versão do SDK C++ do PlayFab Multiplayer

​

1.9.5

13 de agosto de 2026

​

Correções de bugs

• GDK: Corrigido um bug em que o encerramento prolongado de uma conexão PubSub podia bloquear a thread de trabalho em segundo plano de fazer progresso em trabalhos de conexão independentes.
• GDK: Corrigido um bug em que requisições HTTP ativas bloqueavam a suspensão do título no XBOX.
• Plataforma PlayStation®: Corrigido um vazamento de memória durante o ciclo de vida da assinatura PubSub do lobby.

​

1.9.3

23 de junho de 2026

​

Correções de bugs

• Corrigido um problema em que um membro do lobby que saiu durante uma interrupção de rede podia reaparecer incorretamente como conectado ao dono do lobby depois que a conexão se recuperava.
• Corrigido um crash que podia ocorrer durante operações de lobby, matchmaking ou notificação se o título limpasse a fila de tarefas do processo atual.
• Corrigida uma condição de corrida durante a finalização que podia causar corrupção de memória ou crash se uma requisição HTTP fosse concluída enquanto o SDK estava desligando.
• Corrigido um deadlock durante a limpeza que podia travar um título que usasse uma fila de tarefas de processo com dispatch manual.
• Corrigida uma falha de recuperação de sessão PubSub que podia ocorrer ao reconectar sem assinaturas ativas de lobby ou matchmaking.
• Corrigido um problema em que o SDK não enviava seu cabeçalho User-Agent nas requisições HTTP.
• As funções públicas das APIs PFLobby, PFMatchmaking e PFMultiplayer agora validam parâmetros de ponteiro e retornam E_POINTER quando recebem um ponteiro nulo, em vez de potencialmente causar crash.

​

1.9.2

1 de junho de 2026

​

Correções de bugs

• Corrigido um travamento quando os websockets são desconectados inesperadamente pela rede nas versões Nintendo Switch e Nintendo Switch 2 da biblioteca.

​

1.9.0

26 de março de 2026

​

Novos recursos

• Adicionada PFLobbyGetRestrictInvitesToLobbyOwner para recuperar a política atual do lobby que indica se apenas o dono do lobby pode enviar convites para entrar no lobby.
• Adicionado o campo restrictInvitesToLobbyOwner às structs PFLobbyArrangedJoinConfiguration, PFLobbyCreateConfiguration e PFLobbyDataUpdate para controlar se apenas o dono do lobby ou qualquer membro pode enviar convites para entrar no lobby. Se você usa inicializadores padrão para essas structs, nenhuma alteração de código é necessária. Se você não usa inicializadores padrão, certifique-se de inicializar os novos campos.

​

Correções de bugs

• Corrigido um problema em que o SDK não gerava automaticamente uma state change de desconexão depois que uma conexão era perdida e o SDK não conseguia restabelecê-la.

​

1.8.8

23 de março de 2026

​

Correções de bugs

• Corrigida uma referência indefinida a DeriveWorkQueue no Linux.
• Melhorado o hardening do linker no Linux para o PlayFab Multiplayer.

​

1.8.7

26 de fevereiro de 2026

​

Correções de bugs

• Corrigido um problema em que a biblioteca podia crashar após perder uma conexão WebSocket enquanto pausada em um depurador.

​

1.8.6

13 de fevereiro de 2026

​

Correções de bugs

• Corrigido um problema em que, 24 horas após a primeira tentativa de lobby ou matchmaking, se a biblioteca não fosse limpa, ela podia falhar em criar lobbies subsequentes, entrar em lobbies subsequentes, assinar convites de lobby ou criar tickets de matchmaking subsequentes.
• Corrigido um problema em que falhas do serviço PlayFab Lobby podiam fazer com que a biblioteca PlayFabMultiplayer não conseguisse criar novos lobbies até que ela chamasse PFMultiplayerUninitialize() e a biblioteca fosse reinicializada com PFMultiplayerInitialize.
• Corrigido um problema em plataformas não-GDK em que a biblioteca mantinha memória interna da fila de tarefas do processo alocada após a biblioteca ser limpa usando PFMultiplayerUninitialize().
• Corrigido um problema em que vários erros do serviço PubSub eram agrupados em uma mensagem genérica de erro HTTP 4XX, 0x89236409. Agora, a biblioteca fornece diferentes códigos de erro para diferentes erros de serviço, o que facilita o diagnóstico e a solução de problemas.

​

1.8.5

21 de janeiro de 2026

​

Correções de bugs

• Ocultados símbolos na plataforma iOS para evitar conflitos de símbolos. Esta versão é um release apenas para iOS.

​

1.8.4

5 de novembro de 2025

​

Correções de bugs

• Corrigido um problema em que símbolos U expostos causavam crashes em tempo de execução no Android. Todos os símbolos exceto os fornecidos pela Microsoft foram ocultados. Este é um release apenas para Android.

​

1.8.3

10 de outubro de 2025

​

Correções de bugs

• Corrigido um problema em que símbolos expostos do libHttpClient causavam conflitos de símbolos no Android. Adicionada uma opção que permite que jogos que requerem uma versão específica do libHttpClient forneçam seu próprio libHttpClient dinâmico e usem o pacote .dynLHC para evitar conflitos de símbolos. O pacote .dynLHC substitui o pacote .hideLHC da versão 1.8.2. Este é um release apenas para Android.

​

1.8.2

5 de setembro de 2025

​

Correções de bugs

• Corrigido um problema em que símbolos expostos do libHttpClient causavam conflitos de símbolos no Android. Adicionada uma opção que permite que jogos que requerem uma versão específica do libHttpClient forneçam seu próprio libHttpClient dinâmico e usem o pacote .hideLHC para evitar conflitos de símbolos. Este é um release apenas para Android.

​

Novo suporte

• Adicionado suporte a tamanhos de página de 16-KB para atender aos novos requisitos de tamanho de página do Android.

​

1.8.1

20 de agosto de 2025

​

Correções de bugs

• Switch: Corrigido um crash que ocorria durante a inicialização de threads.

​

1.8.0

11 de junho de 2025

​

Novos recursos

• Adicionada a nova função PFMultiplayerConnectToLobby.
• Adicionado um campo lobbyId à struct PFLobbyInviteReceivedStateChange para suportar entrada usando apenas o ID do lobby.

​

Correções de bugs

• Corrigido um bug em que falhas de conexão PubSub podiam fazer a biblioteca crashar.

​

1.7.16

7 de maio de 2025

​

Correções de bugs

• Corrigido um problema em que símbolos expostos causavam conflitos de símbolos na plataforma Android. Esta versão suporta apenas Android.

​

1.7.15

2 de maio de 2025

​

Correções de bugs

• Corrigido um problema em que o arquivo Info.plist para iOS e macOS não tinha campos obrigatórios, garantindo conformidade com os requisitos da Apple.

​

1.7.14

28 de abril de 2025

​

Correções de bugs

• Corrigido um problema em que o segundo usuário local falhava em entrar no lobby criado pelo primeiro usuário após uma reconexão de rede.

​

Alterações de threading

• O SDK substitui suas threads de rede personalizadas por uma implementação de thread pool, o que permite utilização de CPU mais eficiente.

​

1.7.13

22 de abril de 2025

​

Correções de bugs

• Corrigido um problema nas versões do SDK Sony (PlayStation®4 e PlayStation®5) em que o segundo usuário local falhava em entrar no lobby criado pelo primeiro usuário após uma reconexão de rede.

​

1.7.12

15 de abril de 2025

​

Correções de bugs

• Corrigido um crash que ocorria quando uma reconexão de rede acontecia após uma desconexão inesperada, seguindo a criação e entrada em um lobby multiusuário.
• Corrigido um problema em que chamar PFLobbyPostUpdate em um lobby inexistente não gerava automaticamente uma state change de desconexão.
• Corrigido um crash e a exposição de libc++_shared.so ao carregar a biblioteca no Android.
• Incluído libHttpClient no pacote de release no Android. Para detalhes de uso, veja Introdução ao PlayFab Multiplayer no Android.
• Corrigido um problema com exposição de símbolos na plataforma Apple.

​

1.7.11

9 de abril de 2025

​

Correções de bugs

• Corrigido um crash nas versões do SDK Sony (PlayStation®4 e PlayStation®5) que ocorria quando uma reconexão de rede acontecia após uma desconexão inesperada, seguindo a criação e entrada em um lobby multiusuário.

​

1.7.10

6 de março de 2025

​

Correções de bugs

• Corrigido um problema em que a biblioteca podia crashar se o app suspendesse ao mesmo tempo em que um usuário local estava desconectando. Esta correção é para um release apenas do GDK.

​

1.7.9

11 de fevereiro de 2025

​

Correções de bugs

• Corrigido um problema em que a biblioteca tentava incorretamente novamente algumas operações associadas ao serviço de mensagens em tempo real quando recebia HTTP 401.
• Corrigida uma regressão introduzida na versão 1.7.8 que atribuía o valor PFMultiplayerServerDetails::region a PFMultiplayerServerDetails::fqdn.
• Corrigido um problema em que as propriedades associadas a um novo membro não estavam imediatamente disponíveis até uma state change Updated subsequente. Agora, assim que uma state change MemberAdded é fornecida ao jogo, PFLobbyGetMemberConnectionStatus(), PFLobbyGetMemberPropertyKeys() e PFLobbyGetMemberProperty() fornecem as informações mais atualizadas associadas ao membro. Para preservar a compatibilidade para jogos que dependiam do comportamento anterior, a primeira state change Updated após o membro ser adicionado continua a fornecer essa lista inicial de chaves de propriedade como se fossem novas propriedades.
• Corrigidos alguns problemas em que a biblioteca podia crashar quando PFMultiplayerUninitialize() era chamado enquanto se limpavam recursos internos de requisições web.
• Corrigido um problema no GDK XBOX em que a biblioteca podia crashar durante a suspensão enquanto limpava o estado interno associado ao listener de convites.
• Corrigido um problema no Android em que a biblioteca podia crashar quando PFMultiplayerUninitialize() era chamado enquanto se limpavam threads anexadas ao JavaVM.
• Corrigido um problema no macOS em que a biblioteca estava com symlink incorreto, o que podia se manifestar como quebras de build ao integrar a biblioteca.

​

1.7.8

5 de novembro de 2024

​

Correções de bugs

• Corrigido um problema em que chamar PFMatchmakingTicketCancel para um ticket de backfill criado com PFMultiplayerCreateServerBackfillTicket falhava.
• Corrigido um problema em que o SDK tratava todos os valores em PFMultiplayerServerDetails como obrigatórios.
• Corrigido um problema em que as versões Sony (PlayStation®4 e PlayStation®5) do SDK não tratavam corretamente falhas intermitentes de requisições HTTP da biblioteca HTTP Sony (PlayStation®4 e PlayStation®5). Além disso, um reporte de erros aprimorado agora fornece informações mais detalhadas para esses casos.

​

1.7.7

25 de outubro de 2024

​

Correções de bugs

• Corrigido um problema com símbolos OpenSSL expostos na plataforma macOS. Este release suporta apenas macOS.

​

1.7.6

12 de agosto de 2024

​

Correções de bugs

• Corrigido um problema no GDK XBOX em que alguns eventos não eram enfileirados após suspender e retomar um título.
• Corrigido um crash no GDK XBOX após suspender e retomar um título.
• Atualizada PFMultiplayerCreateServerBackfillTicket para lidar automaticamente com falhas quando um membro da partida já é membro de tickets demais. Nessa situação, o SDK cancela automaticamente tickets existentes para membros do ticket de backfill e tenta novamente a criação do ticket.

​

1.7.5

17 de julho de 2024

​

Correções de bugs

• Corrigido problema potencial com PFMultiplayerUninitialize causando um crash quando usado com hooks de memória personalizados no sistema Unix.

​

1.7.4

17 de junho de 2024

​

Correções de bugs

• Corrigido um problema em que o SDK não fazia parsing corretamente das mensagens recebidas por WebSockets no PlayStation®4 e PlayStation®5 se as mensagens continham o caractere '\0'. A falha em fazer parsing dessas mensagens podia levar a problemas de conectividade PubSub. Esta correção aplica-se apenas a PlayStation®4 e PlayStation®5.

​

1.7.3

23 de abril de 2024

​

Correções de bugs

• Resolvido erro de classe duplicada quando Party e Multiplayer são usados no mesmo app. Esta correção aplica-se apenas ao Android.

​

1.7.2

7 de março de 2024

​

Correções de bugs

• Corrigido um problema em que o WebSocket interno de notificação PubSub era lento para detectar e reagir a desconexões. Este problema podia levar a erros ao criar ou entrar em lobbies e tickets de matchmaking.
• Corrigido um problema em que a falha do PubSub em estabelecer conexão com o serviço SignalR não disparava uma state change de falha e não permitia que chamadas subsequentes da API Multiplayer assinassem o PubSub.
• Melhorados os diagnósticos internos.

​

1.7.1

14 de fevereiro de 2024

​

Novos recursos

• Adicionadas novas APIs que permitem que entidades PlayFab GameServer entrem e interajam com lobbies de propriedade do cliente:
  • PFMultiplayerJoinLobbyAsServer
  • PFLobbyServerPostUpdateAsServer
  • PFLobbyServerLeaveAsServer
  • PFLobbyGetServer
  • PFLobbyGetServerPropertyKeys
  • PFLobbyGetServerProperty
  • PFLobbyGetServerConnectionStatus

​

1.6.5

15 de novembro de 2023

​

Novos recursos

• Adicionadas novas APIs PFMatchmakingTicketGetCustomContext e PFMatchmakingTicketSetCustomContext para associar um contexto personalizado a um ticket de matchmaking.

​

Correções de bugs

• Melhorados os diagnósticos internos.

​

1.6.4

16 de agosto de 2023

​

Correções de bugs

• Corrigido um bug em que a DLL do GDK não estava sendo assinada com code-sign. Esta correção é para um release apenas do GDK.

​

1.6.3

14 de agosto de 2023

​

Correções de bugs

• Corrigido um problema em que a biblioteca podia crashar ao tratar uma notificação de mudança.
• Adicionada nova constante PFLobbyMemberCountRemainingSearchKey para facilitar a busca e ordenação de lobbies com base em suas contagens restantes de membros.

​

1.6.2

14 de julho de 2023

​

Correções de bugs

• Corrigido um problema em que operações de matchmaking iniciadas por PFMultiplayerJoinMatchmakingTicketFromId expiravam prematuramente.
• Corrigido um problema em que PFMatchmakingTicketGetTicketId podia retornar um valor nulo se chamado logo após iniciar uma operação de matchmaking. Agora, retorna uma string vazia como esperado.
• Corrigido um problema em que a biblioteca macOS se identificava como iOS pelos cabeçalhos de requisição web. Essa identificação é usada principalmente para diagnósticos.
• Melhorados os diagnósticos internos.

​

1.6.1

14 de junho de 2023

• No PlayStation®4 e PlayStation®5, o PlayFab Multiplayer limpa todos os recursos a ele associados e se reinicializa se o título entrar e permanecer em modo de segundo plano por mais de 10 minutos.

​

1.6.0

14 de junho de 2023

​

Novos recursos

• Adicionado um campo membershipLock à struct PFLobbySearchResult para que você possa ler o estado de bloqueio dos lobbies fornecidos nos resultados de busca de PFMultiplayerFindLobbies().

​

1.5.3

25 de abril de 2023

​

Correções de bugs

• Corrigido um erro de linker específico do iOS e macOS em que HttpClient.framework não era encontrado durante o runtime.

​

1.5.2

4 de abril de 2023

​

Correções de bugs

• Introduzido o header PFMultiplayerPal.h, que fornece suporte para compiladores não-MSVC. Este header define SAL e HRESULTs para plataformas compiladas por não-MSVC.

​

1.5.1

20 de março de 2023

​

Novos recursos

• O PlayFab Multiplayer v1.5.1 traz suporte para Linux e Windows Subsystem for Linux (WSL).

​

1.5.0

16 de março de 2023

​

Novos recursos

• Adicionadas novas APIs e suporte para lobbies de propriedade do servidor:
  • PFMultiplayerCreateAndClaimServerLobby
  • PFMultiplayerClaimServerLobby
  • PFLobbyServerPostUpdate
  • PFLobbyServerDeleteLobby
• Adicionado novo suporte para criar tickets de backfill de servidor de matchmaking com PFMultiplayerCreateServerBackfillTicket.
• Adicionada nova constante PFLobbyMembershipLockSearchKey para facilitar a busca apenas por lobbies bloqueados ou desbloqueados ao chamar PFMultiplayerFindLobbies().

Para mais informações sobre o uso de lobbies de propriedade do servidor, veja Servidores de jogo e lobbies.

​

Correções de bugs

• Adicionada uma correção que reduz desconexões PubSub inesperadas devido à contenção de threads em segundo plano.

​

1.4.3

15 de novembro de 2022

​

Novos recursos

• O PlayFab Multiplayer v1.4.3 traz suporte para iOS e macOS.

​

1.4.2

26 de outubro de 2022

​

Correções de bugs

• Corrigido um bug em que reconexões PubSub podiam fazer com que futuras requisições de unsubscribe do PubSub falhassem.

​

1.4.1

25 de outubro de 2022

​

Correções de bugs

• Corrigido um bug em que a biblioteca criava threads desnecessárias e de curta duração.
• No Windows, XBOX e Android, corrigido um bug em que a biblioteca podia tentar requisições web antes que um período retry-after previamente registrado expirasse.
• Melhorada a mensagem de erro se um servidor web não puder ser alcançado.

​

1.4.0

11 de outubro de 2022

​

Novos recursos

• O PlayFab Multiplayer versão 1.4.0 adiciona suporte para Android.

​

1.3.1

20 de setembro de 2022

​

Correções de bugs

• Corrigido um bug que fazia com que recursos WebSocket vazassem memória ao chamar PFMultiplayerUninitialize ou quando a biblioteca tratava internamente a suspensão do app em consoles XBOX.

​

1.3.0

9 de setembro de 2022

​

Novos recursos

• Adicionada uma nova função, PFLobbyGetMemberConnectionStatus, que você pode usar para detectar se um usuário está conectado ao serviço de notificação PubSub. Quando o status de conexão de um usuário muda, você recebe um PFLobbyUpdatedStateChange com um PFLobbyMemberUpdateSummary em que o campo connectionStatusUpdated é true.
• Atualizado o protocolo usado para trocar mensagens com o serviço de notificação PubSub, de JSON para MessagePack, o que diminui o tamanho das mensagens. Esta mudança não afeta a superfície da API.

​

Correções de bugs

• Melhorada a mensagem reportada por PFMultiplayerGetErrorCode para vários erros relacionados a limitação de taxa.

​

1.2.0

17 de agosto de 2022

​

Novos recursos

• Os detalhes da partida agora reportam detalhes do servidor associados ao servidor multiplayer alocado quando uma partida é encontrada, se a fila de matchmaking estiver configurada para alocar servidores multiplayer. Para mais informações, veja PFMatchmakingMatchDetails.
• Uma nova constante, PFLobbyAmOwnerSearchKey, foi definida para a chave de busca lobby/amOwner. Para mais informações sobre o uso de chaves de busca, veja PFLobbySearchConfiguration.

​

Correções de bugs

• Melhorada a mensagem reportada por PFMultiplayerGetErrorCode para vários códigos de erro.
• Corrigido um bug em que o serviço de notificação não desinscrevia entidades sob algumas condições de falha.

​

1.1.5

13 de julho de 2022

​

Correções de bugs

• Corrigidos valores incorretos de string constante para PFLobbyMemberCountSearchKey e PFLobbyAmMemberSearchKey no header PFLobby.h.
• Corrigido um bug que podia fazer com que PFMultiplayerUninitialize() bloqueasse indefinidamente se um WebSocket fosse fechado inesperadamente.
• Corrigido um bug que fazia com que notificações PubSub se tornassem inutilizáveis e operações da API Lobby/Matchmaking travassem indefinidamente após uma desconexão inesperada do WebSocket.

​

1.1.4

24 de junho de 2022

​

Correções de bugs

• GDK: Corrigido um bug em que operações envolvendo comunicação de rede falhavam silenciosamente se as operações iniciavam cedo demais após suspend ou resume.
• Corrigido um bug em que o SDK crashava ao retomar a execução após ficar parado no depurador por mais de 10 segundos.

​

1.1.3

10 de junho de 2022

​

Novos recursos

• O SDK agora é mais responsivo a desconexões inesperadas (detecta-as 2-3 vezes mais rápido que antes).
• Desconexões inesperadas de Lobby agora resultam em tentativas automáticas de reconexão. O cliente aprende sobre a desconexão apenas depois que essas tentativas de reconexão falham.
• GDK/Win32: Respostas de falha do serviço web (429, 503 e respostas similares) agora disparam retries automáticos. O cliente aprende sobre a falha apenas depois que esses retries falham.

​

Correções de bugs

• Corrigido um bug em que o matchmaking falhava após 10 partidas consecutivas.
• Corrigido um bug em que GetErrorMessage(...) não fornecia mensagens de erro relacionadas ao matchmaking.
• Corrigido um bug em que dois campos na struct LobbySearchResult não eram populados corretamente (maxMemberCount e currentMemberCount).
• Corrigidos vários bugs relacionados a comportamento e confiabilidade após suspend e resume.

​

1.1.1

13 de abril de 2022

​

Correções de bugs

• Switch: Fornece um novo header PAL necessário para compilar contra o PlayFab Multiplayer.

​

1.1.0

4 de março de 2022

​

Alterações de API

• Alterada a assinatura da API de PFMultiplayerGetErrorMessage. Anteriormente, esta função retornava um HRESULT e usava um parâmetro de saída para retornar a string de mensagem de erro. Agora, a função retorna a string diretamente.

​

Novos recursos

• GDK: Adicionado suporte para tratar automaticamente suspend e resume no XBOX.

​

Correções de bugs

• Corrigido um bug em que a API ignorava os dados iniciais do membro passados para PFMultiplayerJoinLobby se o jogador estivesse entrando novamente em um lobby.

​

1.0.0

23 de novembro de 2021 O PlayFab Multiplayer agora está disponível em preview. Para uma visão geral dos recursos de Matchmaking e Lobby, confira:

• Visão geral do PlayFab Lobby
• Quickstart do PlayFab Multiplayer Lobby
• Visão geral do PlayFab Matchmaking
• Quickstart do PlayFab Multiplayer Matchmaking

‘PlayStation’ é uma marca registrada ou marca comercial da Sony Interactive Entertainment Inc.