O suporte para as plataformas XDK e Windows 7 terminou em 1 de agosto de 2023. Nenhuma nova atualização da biblioteca do PlayFab Party será lançada para essas plataformas. Os serviços de rede e voz do PlayFab Party continuam operando sem impacto para os títulos que atualmente usam as versões da biblioteca do PlayFab Party para Windows 7 ou XDK.
O suporte para plataformas Android de 32 bits (arm7 e x86) terminou em 19 de outubro de 2023. Nenhuma nova atualização da biblioteca do PlayFab Party será lançada para essas plataformas. Os serviços de rede e voz do PlayFab Party continuarão operando sem impacto para os títulos que atualmente usam a biblioteca do PlayFab Party em plataformas Android de 32 bits.
1.10.25
24 de julho de 2026Correções de bugs
- GDK: Melhorada a resiliência a falhas na consulta de porta multiplayer preferencial no PC. Falhas recuperáveis recorrerão à seleção de porta efêmera no PC. Títulos que desejam um controle mais rígido sobre a seleção de porta no GDK para PC podem usar a
PartyLocalUdpSocketBindAddressConfigurationpara definir políticas alternativas de seleção de porta. - GDK: Fornecidos valores de
PartyErrormais claros no caso de falhas internas inesperadas do runtime do GDK.
1.10.24
20 de julho de 2026Correções de bugs
- Corrigido um problema em que streams de voz com manipulação de áudio não produziam buffers quando o título ainda não havia configurado uma saída de áudio.
- Android: Corrigido um crash que podia ocorrer durante a criação de threads de trabalho quando a definição da afinidade de CPU da thread falhava.
- Apple: Corrigido um problema em que o microfone e a captura de áudio não se recuperavam depois que o app perdia e recuperava o foco de áudio.
- Linux: Corrigido o travamento de requisições de speech-to-text e outras requisições HTTP.
1.10.23
5 de junho de 2026Correções de bugs
- Linux: Corrigidas as requisições HTTPS para verificar as credenciais TLS do servidor.
- Android: Corrigido um possível vazamento de memória durante PartyCleanup ao usar NDK 25 ou anterior.
- Corrigidas as conexões Websocket para verificar as credenciais TLS do servidor.
1.10.22
15 de maio de 2026Correções de bugs
- Corrigido um problema em que a troca de dispositivo de áudio podia falhar no macOS quando conectado a uma rede Party.
1.10.21
13 de maio de 2026- Atualizado o conjunto de ferramentas da plataforma Windows usado para compilar a biblioteca de v142 para v143.
Correções de bugs
- Corrigida uma possível perda de voz ao fazer a transição entre redes enquanto a manipulação de áudio está ativa.
- Corrigida a ausência da transcrição final de speech-to-text quando um stream de captura com manipulação de áudio está ativo.
- Corrigido um possível crash no desligamento quando a fila de tarefas do processo era excluída antes de o Party concluir o desligamento.
- Android: Corrigido um possível crash ao chamar
PartyManager::Initializeimediatamente apósPartyManager::Cleanup. - Android: Corrigido um vazamento de memória em
PartyManager::Cleanup. - Apple: Restaurado o suporte a arm64 (Apple Silicon) no binário universal do macOS, que havia sido removido acidentalmente em um release anterior.
- Corrigido um possível use-after-free em que objetos internos de rastreamento HTTP podiam ser excluídos antes que a tarefa assíncrona subjacente fosse concluída.
- Linux: Prevenidos possíveis crashes causados por bibliotecas estáticas sendo sobrescritas quando múltiplos objetos compartilhados vinculam a mesma dependência.
1.10.20
29 de abril de 2026- PlayStation®5: Corrigido o parsing de respostas HTTP para propagar corretamente valores JSON nulos.
1.10.19
22 de abril de 2026- Nintendo Switch 2: Atualizada a compatibilidade com o Nintendo SDK 22 removendo APIs de código de idioma descontinuadas e resolvendo um problema de compilação com C++20.
1.10.18
26 de março de 2026- Melhorado o hardening do linker no Linux para o PlayFab Party.
1.10.17
23 de fevereiro de 2026- Android: Corrigido o não funcionamento de microfones Bluetooth.
- Linux: Removido o SafeStack.
- Apple: Ocultados os símbolos OpenSSL do Party.
- Nintendo Switch 2: Resolvido erro de conexão TCP quando o IP muda.
1.10.16
2 de fevereiro de 2026- GDK: Adicionado suporte para ambientes que usam GRTS in-proc.
- GDK: Adicionado suporte para
PartyAudioDeviceSelectionType::SystemDefault.
Correções de bugs
- Corrigido um possível crash em cenários de transição entre múltiplas redes.
1.10.15
17 de dezembro de 2025- Nintendo Switch 2: Adicionado tempo limite de 10 segundos para requisições web.
1.10.14
9 de dezembro de 2025- Alterado o comportamento do PartyStatusChangeResult de
PartyNetwork::CreateEndpointpara retornarPartyServiceErrorpara erros transitórios que ocorrem antes de o token expirar, e para retornarUserNotAuthorizedapenas quando o token expirou. - Android: Adicionado suporte a tamanhos de página de 16-KB para atender aos novos requisitos de tamanho de página do Android.
1.10.13
14 de outubro de 2025- Corrigido um problema que fazia o microfone não funcionar corretamente no iOS 26.
- Apple: Adicionado suporte para Arm64.xcframework no iOS.
1.10.12
6 de outubro de 2025- Alterado o comportamento do PartyStatusChangeResult de
PartyNetwork::CreateEndpointpara retornarPartyServiceErrorpara erros transitórios que ocorrem antes de o token expirar, e para retornarUserNotAuthorizedapenas quando o token expirou. - Android: Adicionado suporte a tamanhos de página de 16-KB para atender aos novos requisitos de tamanho de página do Android.
- Apple: Adicionado suporte a builds de simulador Arm64 no iOS.
Correções de bugs
- Corrigido um problema em que a biblioteca podia crashar quando PartyManager::Cleanup era chamado.
- Apple: Adicionada lógica de retry para recuperação do foco do microfone após interrupções no iOS.
- Apple: Corrigido um vazamento de memória que podia ocorrer durante o chat de voz e a transcrição do Party.
- Apple: Corrigido um possível congelamento em PartyLocalChatControl quando vários jogadores remotos estão conectados em diferentes plataformas.
- Apple: Adicionado suporte a builds de simulador Arm64 no iOS.
1.10.9
11 de março de 2025- Nintendo Switch: Correção de bug tratando um crash ao carregar DLLs da variante de shipping da biblioteca com logging habilitado.
1.10.8
24 de janeiro de 2025- PlayStation®4 e PlayStation®5: Resolvido um crash relacionado ao mascaramento de profanidade nas plataformas PlayStation.
1.10.6
10 de dezembro de 2024- PlayStation®4 e PlayStation®5: Resolvidos avisos e erros de build para integração com C++14 e versões posteriores.
1.10.5
18 de novembro de 2024- Corrigido um problema em que o chat de voz às vezes não funcionava para usuários que permaneciam em uma rede Party depois que outros usuários entravam novamente e saíam várias vezes.
- Corrigido um problema em que PartyLocalEndpoint::GetEndpointStatistics reportava valores incorretos para PartyEndpointStatistic::CurrentlyQueuedSendMessages e PartyEndpointStatistic::CurrentlyQueuedSendMessageBytes quando usada com conexões peer diretas.
- Corrigidos symlinks quebrados do framework no macOS.
- Melhorado o tratamento de exceções de log em plataformas não-Windows durante a coleta de logs do SDK.
1.10.4
12 de novembro de 2024- PlayStation®4 e PlayStation®5: Resolvidos crashes relacionados a operações de mutex e mudanças de estado de endpoint durante criação e destruição.
1.10.3
14 de outubro de 2024- Adicionado suporte para até 128 dispositivos por rede. Para mais informações, veja Redes escaláveis.
- Aumentado
c_maxNetworkConfigurationMaxDeviceCountde 32 para 128. - Atualizados os diagnósticos internos.
- Atualizadas as configurações de build para hardening de segurança.
- Corrigido um problema com símbolos OpenSSL expostos na plataforma macOS.
1.10.2
18 de setembro de 2024Correções de bugs
- Corrigido um problema em que a biblioteca podia crashar ao estabelecer conexões peer diretas em redes com três ou mais dispositivos.
1.10.0
5 de agosto de 2024- Adicionado suporte para entidades
game_server, de forma que servidores podem se conectar a redes Party via SDK e ser identificados com segurança pelos clientes do jogo. Após autenticar uma entidadegame_serverviaAuthenticateGameServerWithCustomId, ela pode ser adicionada como um usuário local via PartyManager::CreateLocalUserWithEntityType. - Adicionados métodos para determinar o tipo de entidade associado a cada entidade na biblioteca. Para mais informações, veja PartyLocalUser::GetEntityType, PartyEndpoint::GetEntityType e PartyChatControl::GetEntityType.
- Adicionada uma opção de conectividade peer direta que habilita conexões peer diretas entre entidades
title_playeregame_serverenquanto desabilita conexões peer diretas entre entidadestitle_playere outras entidadestitle_player. Para mais informações, veja PartyDirectPeerConnectivityOptions::OnlyServers. - Adicionados métodos para recuperar uma lista conveniente de endpoints com base em filtros. Para mais informações, veja PartyNetwork::GetEndpointsByUserType.
- Atualizadas as alocações de memória de bibliotecas de terceiros usadas no PlayFab Party no PlayStation®4 e PlayStation®5 que usavam alocadores padrão para usar os callbacks de memória do Party. Títulos que usam PartyManager::SetMemoryCallbacks para configurar funções de alocação de memória específicas do título agora verão e terão controle sobre essas alocações.
Correções de bugs
- Corrigido um problema em que a biblioteca podia crashar no Windows ou XBOX enquanto o processo estava sendo encerrado.
- Tratadas falhas espúrias de conexão peer direta após uma tentativa de conexão anterior falhar em certos casos em plataformas não Windows.
- Corrigido um problema em que o evento DestroyNetwork não era disparado durante criações e destruições repetidas de redes Party.
Problemas conhecidos
- A biblioteca pode ocasionalmente crashar ao estabelecer conexões peer diretas em redes com três ou mais dispositivos.
1.9.5
3 de maio de 2024- Tratados erros fatais intermitentes reportados em PartyRegionsChangedStateChange e outras operações por dispositivos Windows que usam recursos como compartilhamento de conexão.
- Corrigido um possível crash no Windows e XBOX se o processo fosse encerrado logo após começar a usar o Party.
- Corrigido um bug em que os recursos de
PartyChatControlàs vezes não eram liberados após chamar PartyLocalDevice::DestroyChatControl e só eram liberados após chamar PartyManager::Cleanup. - Android: Resolvido erro de classe duplicada quando Party e Multiplayer são usados no mesmo app.
1.9.4
20 de março de 2024- Corrigido um bug em que
PartyLocalDevice::CreateChatControlfalhava no PlayStation®4 e PlayStation®5 quando o ucraniano estava definido como o idioma do console.
1.9.3
14 de março de 2024- Corrigido um possível bug de use-after-free quando speech-to-text está habilitado.
- Corrigido um possível crash quando conexões peer diretas estão habilitadas.
- Melhorados os diagnósticos internos.
1.9.2
5 de março de 2024- Corrigido bug de renderização de áudio na plataforma Linux. Clientes Linux agora podem ouvir totalmente os clientes de outras plataformas.
1.9.1
5 de fevereiro de 2024- Adicionadas
PartyOption::RegionUpdateConfigurationePartyOption::RegionQualityMeasurementConfigurationpara controle avançado sobre quando e como a biblioteca do Party realiza a descoberta automática de regiões e as medições de qualidade de conexão.
1.8.11
13 de novembro de 2023- Corrigido um bug em que um crash podia ocorrer quando um cliente tentava sair de uma rede no Nintendo Switch.
1.8.10
19 de outubro de 2023 Este release atualiza a versão mínima do SDK e a versão de SDK de destino para as plataformas Apple e Android do PlayFab Party. Para as plataformas Apple, seguimos as diretrizes do Xcode da Apple com o lançamento do Xcode 15.- iOS
- O Minimum Deployment Target foi aumentado de iOS 10 para iOS 12.
- A Target Deployment Version foi aumentada de iOS 16 para iOS 17.
- macOS
- A Target Deployment Version foi aumentada de macOS 13.3 para macOS 14.
- O Minimum Deployment Target foi reduzido de macOS 12.3 para macOS 10.13 no release v.1.8.8.
- Android
- A Minimum SDK Version foi aumentada de Android API 19 para Android API 21.
- A Target SDK Version foi aumentada de Android API 28 para Android API 34.
- A Compile SDK Version foi aumentada de Android API 28 para Android API 34.
- O suporte para plataformas Android de 32 bits (arm7 e x86) terminou em 19 de outubro de 2023. Nenhuma nova atualização da biblioteca do PlayFab Party será lançada para essas plataformas. Os serviços de rede e voz do PlayFab Party continuarão operando sem impacto para os títulos que atualmente usam a biblioteca do PlayFab Party em plataformas Android de 32 bits.
1.8.9
20 de outubro de 2023- Implementadas propriedades compartilhadas para endpoints. Propriedades compartilhadas podem ser definidas ao criar um endpoint via
PartyNetwork::CreateEndpoint. Uma propriedade compartilhada pode ser recuperada usandoPartyEndpoint::GetSharedProperty. - Melhorado o enfileiramento de pacotes de áudio para reduzir a latência percebida do áudio de chat em alguns cenários.
- Atualizada a versão interna do codec Opus.
- Corrigido um crash de baixa frequência.
- Melhorados os diagnósticos internos.
- Removido o suporte para Windows 7.
1.8.5
28 de junho de 2023Correções de bugs
- Corrigido um bug em que
PartyLocalChatControl::SetAudioRenderVolumenão funcionava corretamente no Nintendo Switch, PlayStation®4 e PlayStation®5.
1.8.3
2 de junho de 2023- PlayFab Party versão 1.8 lançado para Nintendo Switch com todas as correções de bugs e novos recursos desde o último release para Nintendo Switch (versão 1.7.15).
1.8.2
30 de maio de 2023Correções de bugs
- Corrigido um bug em que a biblioteca do PlayFab Party exigia que a versão do macOS fosse pelo menos 13.1. O novo release define a versão mínima do macOS como 12.3.
1.8.0
8 de maio de 2023- Adicionada uma opção para configurar o número máximo de conexões peer diretas que o dispositivo tenta estabelecer com outros dispositivos. Para mais informações, veja
PartyOption::LocalDeviceMaxDirectPeerConnections. - iOS, Android: Adicionado suporte para habilitar a supressão de ruído no áudio capturado de um chat control local. Para mais informações, veja
PartyLocalChatControl::SetVoiceAudioOptions.
Correções de bugs
- Corrigido um bug em que a biblioteca podia vazar memória devido ao rastreamento de diagnóstico interno quando o token de entidade do usuário expira.
1.7.23
1 de abril de 2023- Adicionado suporte para Real-Time Audio Manipulation na plataforma PlayStation®5.
1.7.22
30 de março de 2023Correções de bugs
- Corrigido um bug em que o Party podia crashar se não fosse limpo antes de o processo host começar a encerrar.
- Alterado o comportamento da conexão peer-to-peer para recorrer a uma conexão relayed se o link for desconectado inesperadamente. O comportamento anterior desconectava ambos os dispositivos da rede.
1.7.20
8 de fevereiro de 2023Correções de bugs
- Corrigido um bug em que o áudio de microfones de 44,1 kHz podia soar distorcido.
- Melhoradas as mensagens de erro de diagnóstico para erros de rede reportados por PartyManager::GetErrorMessage().
1.7.19
11 de novembro de 2022Correções de bugs
- Corrigido um bug que fazia falhar a abertura de uma requisição web após um certo momento no Linux.
1.7.17
7 de outubro de 2022Correções de bugs
- Corrigido um bug em que um crash podia ocorrer quando um chat control estava conectado a uma rede no iOS.
- Corrigido um bug em que um crash podia ocorrer ao habilitar o log no iOS.
1.7.16
27 de setembro de 2022Novo release de Bundle para macOS
- Adicionado .bundle para carregamento de plug-in do Unity e desenvolvimento nativo no macOS.
Correções de bugs
- Corrigido um bug em que um crash podia ocorrer ao habilitar o log no macOS.
1.7.14
12 de agosto de 2022Novos SDKs para Linux e macOS
- Adicionado suporte nativo para o PlayFab Party no Linux e macOS, permitindo que desenvolvedores de jogos criem experiências multiplayer em tempo real cross-platform ou multiplataforma em ainda mais plataformas. Para links para esses e outros releases de SDK, veja SDKs do PlayFab Party.
- Apresenta o PlayFab Party para Linux
1.7.11
24 de junho de 2022Correções de bugs
- Corrigido um problema em que uma única alocação de memória ainda permanecia após uma chamada a
PartyManager::Cleanup().
1.7.8
21 de abril de 2022Correções de bugs
- Corrigido um problema em que a memória não era totalmente limpa quando
PartyManager::Cleanup()era chamado. - Corrigido um problema em que chamar
PartyLocalChatControl::SetAudioInput()ouPartyLocalChatControl::SetAudioOutput()com a mesma seleção de dispositivo de áudio resultava desnecessariamente na reinicialização do dispositivo de áudio pela biblioteca.
1.7.7
16 de março de 2022Correções de bugs
- PlayStation®4, PlayStation®5: Corrigido um crash que ocorria quando não havia dispositivo de áudio depois que os dispositivos de áudio eram removidos.
- Switch: Corrigido um problema que fazia requisições web falharem quando múltiplas transações do PlayFab eram disparadas.
1.7.6
8 de fevereiro de 2022Melhorias de desempenho
- Windows, XDK, Nintendo Switch, PlayStation 4, PlayStation 5: Removidas duas threads de trabalho, com o trabalho relevante realizado em uma thread de trabalho pré-existente de frequência mais baixa. A versão da biblioteca para o Microsoft Game Development Kit (GDK) já tinha esse comportamento de trabalho consolidado.
Correções de bugs
- iOS, Android, Switch, PlayStation 4, PlayStation 5 e Stadia: Corrigida uma pequena quantidade de memória alocada durante a inicialização que não era liberada corretamente durante a limpeza.
- Evitado reportar o flag PartyChatTextReceivedOptions::FilteredDueToError em PartyChatTextReceivedStateChange quando a moderação de texto não está habilitada.
1.7.5
30 de setembro de 2021Correções de bugs
- Corrigido um problema em que alguns microfones de 16 kHz não funcionavam.
- Corrigido um problema em que mudanças de permissão do microfone não eram tratadas no Windows.
- Corrigido um vazamento de memória em algumas condições de falha de
PartyManager::CreateNewNetwork(). - Corrigido um crash ocasional em
PartyLocalEndpoint::GetEndpointStatistics().
1.7.0
29 de junho de 2021Novos hooks de profiling e indicadores de chat control
- Desenvolvedores interessados em onde o tempo é gasto em funções internas da biblioteca agora podem configurar callbacks opcionais de entrada e saída de métodos para se conectar ao seu método de instrumentação de alto desempenho preferido. Para mais informações, veja
PartyManager::SetProfilingCallbacksForMethodEntryExit. Neste release, os callbacks são suportados apenas nas plataformas Windows, XBOX One XDK e Microsoft Game Core. - Os novos indicadores de chat control NoRemoteInput e RemoteAudioInputMuted fornecem mais granularidade sobre o estado de áudio atualmente silencioso. Para mais informações, veja
PartyChatControlChatIndicator.
Melhorias no comportamento de mensagens de endpoint
- O campo
timeoutInMillisecondsde ‘PartySendMessageQueuingConfiguration’ agora também é avaliado pelo relay de nuvem transparente se ele for forçado a enfileirar mensagens antes de encaminhá-las devido a condições de rede diferentes ou à responsividade dos destinos remotos. - Quando totalmente autenticado em uma rede, o envio para um array de 0 entradas agora direciona corretamente para o conjunto exato de todos os endpoints remotos que a biblioteca atualmente reporta na rede naquele momento. Endpoints sendo criados enquanto a mensagem está em processo de transmissão não são mais potencialmente incluídos.
1.6.1
Correções de bugs
- Corrigido um bug em que um crash podia ocorrer quando um chat control se conectava a uma rede enquanto esse mesmo chat control estava se desconectando de outra rede.
1.6.0
12 de abril de 2021Novos recursos de controle de threads e moderação de texto
- O trabalho da biblioteca agora pode ser executado manualmente em threads controladas pelo jogo. Para mais informações, veja
PartyManager::SetWorkMode. - O chat de texto ofensivo agora pode opcionalmente ser filtrado. Para mais informações, veja Usando moderação de texto.
Numeração explícita de enums no header
- Os valores de enum no header agora têm numeração explícita.
1.5.13
26 de março de 2021Correções de bugs
- Corrigido um bug em que o áudio era cortado em dispositivos iOS usando headsets Bluetooth.
- Corrigido um bug em que um código de erro incorreto era gerado quando o app não tinha permissão para ativar um microfone em plataformas Windows.
- Corrigido um bug em que um dispositivo não íntegro não era atualizado a menos que algo mais forçasse uma atualização.
- Corrigido um bug em que um crash podia ocorrer ao desreferenciar os dados de usuário de um canal de envio depois que o endpoint de origem associado a esse canal se tornava inválido.
- Corrigido um bug em que clientes experimentavam falhas silenciosas se um chat control remoto não tivesse um código de idioma.
1.5.10
Correções de bugs
- Corrigido um bug em que a biblioteca podia falhar ao inicializar em alguns dispositivos Windows devido a uma incompatibilidade entre a afinidade de processador do processo e a afinidade de thread padrão da biblioteca.
- Corrigido um bug em que a biblioteca podia não fornecer erros quando uma operação falhava devido a uma falha interna de requisição web.
- Corrigido um bug em que um crash podia ocorrer quando a conectividade peer direta está habilitada e a biblioteca tenta estabelecer conectividade peer direta com outro dispositivo.
- Corrigido um bug que podia resultar em áudio com estalos ou distorcido.
1.5.1
5 de setembro de 2020Correção de bug
- Corrigido um bug em que a biblioteca falhava ao ativar o microfone no iOS.
1.5.0
Novos recursos de conectividade peer-to-peer direta, latência e speech-to-text
- A conectividade peer-to-peer direta agora é suportada nas versões Windows 10 e Microsoft Game Core da biblioteca. Para mais informações, veja Usando conectividade peer-to-peer direta.
- A latência de ida e volta entre o dispositivo local e um dispositivo remoto agora pode ser consultada pela biblioteca. Para mais informações, veja
PartyEndpointStatistic::AverageDeviceRoundTripLatencyInMilliseconds - O mascaramento de profanidade de speech-to-text agora pode ser desabilitado. Para mais informações, veja
PartyVoiceChatTranscriptionOptions::DisableProfanityMasking.
Correções de bugs de áudio no Android e iOS
- Android: O gerenciador de Bluetooth será inicializado na primeira vez que
PartyLocalDevice::CreateChatControl()for chamado, em vez de quandoPartyManager::Initialize()for chamado. - iOS: Corrigido um pequeno artefato sonoro quando
PartyManager::Initialize()é chamado.
1.4.13
Problema de dependência do Windows 8.1
Este release remove uma dependência desnecessária de api-ms-win-core-version-l1-1-1.dll que impedia versões anteriores de funcionarem no Windows 8.11.4.8
30 de abril de 2020TLS1.2
- A pilha de transcrição foi atualizada para usar TLS1.2 no Windows 7, Android e iOS. Faça upgrade se você usa alguma dessas plataformas, pois o suporte a TLS1.1 será descontinuado pelos Azure Speech Services a partir de setembro de 2020. Todas as outras plataformas já suportam TLS1.2 e nenhum upgrade é necessário.
Correções de bugs
- Corrigido um bug em que o campo
languageCodena structPartyCreateChatControlCompletedStateChangenão era populado. - Corrigido um bug que inflava artificialmente as medições de latência reportadas por
PartyManager::GetRegions(). - Corrigido um bug que permitia que
PartyManager::SetMemoryCallbacks()fosse chamado em momentos inseguros. - Corrigido um bug em que chamar
PartyManager::DestroyLocalUser()com umPartyLocalUserem umaPartyNetworkgerava umPartyLocalUserRemovedStateChangecom um valor incorreto no campo removedReason,PartyLocalUserRemovedReason::RemoveLocalUser, em vez do valor correto,PartyLocalUserRemovedReason::DestroyLocalUser.
Alterações diversas
- A largura de banda usada pelos dados de chat foi reduzida.
- Códigos de erro e mensagens de erro mais descritivos agora são fornecidos quando problemas de sandbox são encontrados no XBOX.
PartyManager::Initialize()agora falha se um PlayFab Title ID vazio for fornecido.- Passar PlayFab Entity Tokens inválidos para
PartyManager::CreateLocalUser()agora resultará em mensagens de erro mais descritivas nos resultados de state change para operações que dependem de um token válido. - Erros de digitação na documentação do header foram corrigidos.
- Um código de erro e uma mensagem de erro mais descritivos agora são fornecidos quando uma região inválida é passada para
PartyManager::CreateNewNetwork(). - A documentação sobre os tempos de vida dos valores
PartyStringfoi esclarecida para as estruturas e interfaces em Party.h. - A documentação de
PartyManager::Cleanup()foi esclarecida para explicar que não é uma chamada thread-safe. - Um código de erro e uma mensagem de erro mais descritivos são fornecidos quando
PartyManager::ConnectToNetwork()falha de forma assíncrona com erros de conectividade de internet.
1.3.0
Alterações da API de chat
- As funções de manipulação de áudio em tempo real, que podem ser usadas para modificar o áudio de chat de voz de saída ou de entrada, estão implementadas para Windows e XBOX. Para mais informações, veja Usando manipulação de áudio em tempo real para aplicar efeitos de voz personalizados.
- As opções de permissão de chat têm mais opções para configurar opcionalmente as permissões de text-to-speech e de áudio de microfone de forma independente. Para mais informações, veja
PartyChatPermissionOptions. - Isso quebra a compatibilidade com releases anteriores da biblioteca XBOX Live Helper. Este release é compatível com a versão 1.2.0 da biblioteca XBOX Live Helper. Para mais informações, veja as notas de versão da XBOX Live Helper Library.
- Cada state change de transcrição agora indica se representa text-to-speech ou áudio de microfone. Para mais informações, veja
PartyVoiceChatTranscriptionReceivedStateChange.
1.2.2
Alterações no iOS
- Adiciona suporte para a API de controle de volume.
1.2.0
Alterações no Android
- Adiciona suporte para a API de controle de volume.
- Remove o tratamento de foco de áudio da biblioteca. Espera-se agora que os aplicativos host implementem sua própria lógica de tratamento de foco.
1.0.2
- Corrigido crash na telemetria em segundo plano.
1.0.1
Alterações da API do Party
Alterações em PartyManager::SetMemoryCallbacks
Este release do Party adiciona correções paraPartyManager::SetMemoryCallbacks() e também restrições sobre quando esta API é segura de chamar. Consulte a documentação de referência da API em Party.h para detalhes.
Remoção de PartyStateChangeResult::TitleCreateNetworkThrottled
O valorTitleCreateNetworkThrottled de PartyStateChangeResult foi removido da API, já que a biblioteca do Party nunca o gera.
0.7.0-prerelease
Alterações de empacotamento no Windows
Este release do Party introduz um novo pacote NuGet, Microsoft.PlayFab.PlayFabParty.Cpp.Windows, que substitui e descontinua os pacotes NuGet específicos do Windows 10 e do Windows 7 (Microsoft.PlayFab.PlayFabParty.Cpp.Win10 e Microsoft.PlayFab.PlayFabParty.Cpp.Win7, respectivamente). O novo pacote NuGet unificado para Windows contém duas novas DLLs, PartyWin.dll (suporta Windows 8.1 e superior) e PartyWin7.dll (apenas para uso no Windows 7). Com o novo pacote NuGet unificado para Windows, a DLL correta do Party é carregada com base na detecção da versão do SO em tempo de execução, portanto tanto PartyWin.dll quanto PartyWin7.dll devem ser incluídas no pacote de distribuição do jogo.Alterações no Android
A variante Android agora usa um objeto compartilhado para o Party (libparty.so) em vez de uma biblioteca estática (libparty.a). Este release também contém correções de bugs específicas do Android para a seleção de dispositivos de áudio.Alterações no iOS
A variante iOS do Party agora tem o pacote de framework incluído para carregar dinamicamente a libparty em vez da libparty.a compilada estaticamente.Alterações de API
API UpdateEntityToken
Este release do Party faz uma alteração relacionada ao tratamento de tokens de entidade do PlayFab. Na versão anterior, o jogo fornecia ao Party o token de entidade de um usuário na APIPartyManager::CreateLocalUser(). Depois disso, o Party atualizava internamente o token de entidade e o mantinha em dia.
Nesta versão, o comportamento interno de atualização de token foi removido e substituído por uma nova API, PartyLocalUser::UpdateEntityToken(). O chamador agora é responsável por monitorar a expiração do token de entidade fornecido a PartyManager::CreateLocalUser() e PartyLocalUser::UpdateEntityToken(). Quando o token estiver perto ou além do tempo de expiração, um novo token deve ser obtido realizando uma operação de login do PlayFab e fornecido à biblioteca do Party chamando PartyLocalUser::UpdateEntityToken(). Recomenda-se adquirir um novo token quando o token fornecido anteriormente estiver na metade do seu período de validade. Em plataformas que entram em estado de baixa energia ou pausam a execução do aplicativo por muito tempo, o token pode ser impedido de ser atualizado antes de expirar. O token deve ser verificado quanto à expiração assim que a execução for retomada.
O fluxo aproximado é o seguinte:
- O jogo chama uma API
LoginWith*do PlayFab - A resposta do PlayFab contém o token de entidade e também o tempo de expiração
- Forneça as informações do token ao Party com a API
PartyManager::CreateLocalUser(), como antes - [Novo] Anote o tempo de expiração para saber quando atualizá-lo
- [Novo] Na metade do tempo de expiração do token (ou na primeira oportunidade após esse momento), adquira um token novo chamando
LoginWith*novamente e acompanhe o tempo de expiração do novo token - [Novo] Chame
PartyLocalUser::UpdateEntityToken()para passar o novo token ao Party
- O ato de adquirir um token de entidade não invalida quaisquer tokens de entidade obtidos anteriormente. Eles permanecem válidos até expirar.
- A funcionalidade interna de atualização foi removida porque espera-se que a maioria dos jogos faça suas próprias chamadas ao PlayFab. Ter tanto o jogo quanto a biblioteca do Party buscando tokens de entidade causa carga desnecessária no serviço para gerenciar dois conjuntos de tokens.
Alterações da API de chat
OPartyVoiceChatTranscriptionReceivedStateChange agora inclui um campo languageCode, que indica o idioma da transcrição.
O PartyChatTextReceivedStateChange agora inclui um campo languageCode, que indica o idioma do texto de chat. O campo languageCode será populado quando a tradução de texto de chat tiver sido habilitada via PartyLocalChatControl::SetTextChatOptions().
0.6.0-prerelease
Adicionado suporte para as plataformas iOS, Android e Nintendo Switch. Para mais informações, veja os links a seguir: iOS/Android0.5.0-prerelease
Alterações de API
Chat acessível
- Adicionado suporte para narração text-to-speech. (veja
PartyLocalChatControl::SetTextToSpeechProfile()) - Adicionadas mais opções para controlar quando o speech-to-text ocorre. (veja
PartyLocalChatControl::SetTranscriptionOptions()) - Adicionada a tradução de texto para texto à API, embora ainda não seja suportada. (veja
PartyLocalChatControl::SetTextChatOptions()) - Reduzido o uso de largura de banda e memória do text-to-speech.
Controle de acesso à rede
PartyNetwork::SetAccessControlList()e métodos relacionados foram removidos da API. Use a nova classePartyInvitatione métodos relacionados para criar convites abertos ou conceder acesso a usuários específicos do PlayFab às suas redes Party.
0.4.6-prerelease
Alterações de API
Adicionada nova API públicaPartyLocalUser::UpdateEntityToken().
0.2.0-prerelease
Alterações de API
PartyManager::Initializeagora exige que um PlayFab Title ID válido seja passado.
