Notas de versão do PlayFab 2020 - XBOX Game Development Documentation

Para notas de versão sobre lançamentos de serviço e atualizações de produto, veja a seção de notas de versão no repositório público do PlayFab no GitHub

201218

Data: 2020-12-18

Pequenas correções de bugs

201207

Data: 2020-12-07 Dá suporte ao release de serviço do PlayFab de 2 de dezembro

Alterações específicas do UnrealMarketplacePlugin

Corrigidos problemas de configurações estáticas. Siga o novo guia de upgrade.

201119

Data: 2020-11-19

Alterações específicas da PostmanCollection

Adicionado um login automático para a entidade de título, quando apropriado

Alterações específicas do UnitySDK

Corrigido um log excessivo no Unity 2020
O Unity 2020 agora tem suporte completo

Alterações específicas do SDK XPlat C++

Corrigida a resposta da pesquisa de QoS quando todos os servidores atingem o tempo limite.

201027

Data: 2020-10-27 Dá suporte ao release de serviço do PlayFab de 2 de setembro Foram feitas pequenas atualizações nas APIs.

201014

Data: 2020-10-14 Dá suporte ao release de serviço do PlayFab de 2 de setembro (Também dá suporte a novos métodos da API Experimentation, que aparecerão em um release de serviço em breve) O PlayFab tem o compromisso de permitir que você use nossos serviços para desenvolver jogos entre plataformas e entre dispositivos usando vários mecanismos de jogo e frameworks. Para nos ajudar a focar melhor na criação dos novos recursos de que você precisa, estamos abrindo os SDKs a seguir para contribuições da comunidade. Se você tiver mais dúvidas ou precisar de suporte, acesse o fórum da comunidade do PlayFab. Esta será nossa última atualização oficial dos seguintes SDKs:

200914

Data: 2020-09-14 Dá suporte ao release de serviço do PlayFab de 2 de setembro

200901

Data: 2020-09-01 Dá suporte ao release de serviço do PlayFab de 26 de agosto

200817

Data: 2020-08-17 Dá suporte ao release de serviço do PlayFab de 12 de agosto

200805

Data: 2020-08-05 Dá suporte ao release de serviço do PlayFab de 5 de agosto

200730

Data: 2020-07-30 Dá suporte ao release de serviço do PlayFab de 15 de julho

200713

Data: 2020-07-13 Dá suporte ao release de serviço do PlayFab de 1º de julho

200615

Data: 2020-06-15 Dá suporte ao release de serviço do PlayFab de 10 de junho

200602

Data: 2020-06-02 Dá suporte ao release de serviço do PlayFab de 27 de maio

200518

Data: 2020-05-18 Dá suporte ao release de serviço do PlayFab de 13 de maio

Alterações específicas do UnitySDK:

O SDK do PlayFab não define mais Application.runInBackground = true
- Os desenvolvedores de jogos são responsáveis por verificar se as chamadas de API durante a mudança de foco do aplicativo ou antes do desligamento são bem-sucedidas

Alterações específicas do SDK XPlat C++

Na implementação HTTP do CURL, mais estados de erro do CURL são monitorados e processados
O recurso Event Pipeline agora usa e dá suporte ao recurso de thread em segundo plano
Quando o TitleId não está definido, os métodos de API agora geram exceções em tempo real de forma síncrona, em vez de relatar o problema em retornos de chamada síncronos ou em threads

200422

Data: 2020-04-22

Atualização do NodeSDK:

Hotfix
- Corrigido um problema em que pacotes NPM recentes não tinham um arquivo crítico e não podiam ser importados
- Corrigido um problema em que algumas definições de tipo estavam definidas incorretamente como “Number” em vez dos tipos adequados

200421

Data: 2020-04-21 Os SDKs dão suporte ao serviço PlayFab a partir de 2020-04-21. Notas de versão do serviço disponíveis aqui

200402

Data: 2020-04-02

Alterações de API

Insights:
- Conheça nosso novo recurso Insights!

200330

Data: 2020-03-30

Alterações de API

Autenticação:
- Adicionados novos LoginIdentityProviders para Apple e Nintendo
Multiplayer Server:
- Adicionadas novas funções de gerenciamento de BuildRegion: DeleteBuildRegion e UpdateBuildRegion
UnrealMarketplacePlugin:
- Adicionados novos scripts auxiliares de build para Mac

Alterações específicas do SDK XPlat C++

Corrigidos alguns problemas de threads no PlayFabEventPipeline

Alterações específicas do UnrealMarketPlacePlugin

Correções de bugs de segurança

200303

Data: 2020-03-03

Alterações de API

server.UnlinkXboxAccountRequest não exige mais o XboxToken para desvincular
O recurso Experiments e sua API foram lançados
- Consulte nossa postagem no blog para obter mais detalhes
Novos métodos
- client.LoginWithApple
- client.LinkApple
- client.UnlinkApple

200220

Data: 2020-02-20

Novidades

Automação - Lançamos uma nova extensão do Visual Studio Code para o PlayFab. Você pode encontrar o código-fonte no GitHub.

CPP Gsdk - Alteração significativa

Devido a preocupações com a segurança de threads, as assinaturas dos seguintes métodos foram modificadas:

Nome do método	Tipo de retorno antigo	Novo tipo de retorno
`GSDK::getConfigSettings()`	`const std::unordered_map <std::string, std::string>&`	`const std::unordered_map <std::string, std::string>`
`GSDK::getLogsDirectory()`	`const std::string&`	`const std::string`
`GSDK::getSharedContentDirectory()`	`const std::string&`	`const std::string`
Consulte nosso guia de upgrade

200218

Data: 2020-02-18

Alterações de API e documentação:

Novos métodos de API:
- admin.CreateInsightsScheduledScalingTask
- multiplayer.GetMultiplayerSessionLogsBySessionId
Novo recurso e métodos:
- Um novo mecanismo para o Cloud Script, o Azure Functions, agora pode ser usado no PlayFab
- Documentação do recurso
- Lista de novos métodos:
  - cloudscript.ExecuteFunction
  - cloudscript.ListFunctions
  - cloudscript.ListHttpFunctions
  - cloudscript.ListQueuedFunctions
  - cloudscript.PostFunctionResultForEntityTriggeredAction
  - cloudscript.PostFunctionResultForFunctionExecution
  - cloudscript.PostFunctionResultForScheduledTask
  - cloudscript.RegisterHttpFunction
  - cloudscript.RegisterQueuedFunction
  - cloudscript.UnregisterFunction
Alterações em métodos de API:
- O parâmetro de solicitação Region não é mais obrigatório em multiplayer.GetMultiplayerServerLogs

Alterações específicas do CSharpSdk:

Reformulação e melhoria do cálculo de ping de QoS para o PlayFab Multiplayer

200213

Data: 2020-02-13 O Multiplayer Servers do PlayFab apresenta um aprimoramento de dimensionamento automático chamado Dynamic Standby, que monitora os níveis de limite dos servidores em espera e ativa dinamicamente o aumento do provisionamento de servidores de jogo para que a demanda possa ser atendida em escala. Este recurso adiciona um novo objeto à interface de programação do Multiplayer, chamado objeto “DynamicStandby”. O objeto Dynamic Standby é uma propriedade opcional do objeto BuildRegionParams. O Dynamic Standby é um recurso avançado de servidor de jogo, e a edição das configurações a partir dos valores padrão deve ser feita com cautela. A configuração do Dynamic Standby pode ser feita no portal de desenvolvedores do Game Manager ou editando programaticamente as propriedades do objeto Dynamic Standby. Para saber mais sobre o Dynamic Standby, acesse o guia do usuário na documentação online do PlayFab Multiplayer Servers.

200128

Data: 2020-01-28

Alterações nos eventos do Multiplayer Server:

Estamos introduzindo uma alteração na convenção de nomenclatura dos eventos do Multiplayer Server para unificar os nomes dos nossos eventos com os demais nomes de eventos do PlayFab. Além disso, estamos fazendo essas alterações antes de o recurso Multiplayer Server entrar em versão prévia pública. As alterações são:

Os nomes dos eventos do Multiplayer Server serão atualizados para usar PascalCasing
Os eventos do Multiplayer Server não serão mais enviados no formato de evento herdado do PlayStream v1; somente o formato de evento do PlayStream v2 terá suporte

Essas duas alterações representam alterações significativas, especialmente para desenvolvedores que dependem da grafia não correta dos nomes ou do PlayStream v1 dos eventos do Multiplayer Server. Essas alterações não são significativas para desenvolvedores que usam nomes de eventos na interface do Game Manager (cloud script, insights, regras ou tarefas agendadas). Esta alteração entrará em vigor na quarta-feira, 26 de fevereiro de 2020, às 10:00 (PST). Ajuste seu código para essas alterações antes da data da mudança. Alterações de formato Em geral, os eventos do PlayFab têm um formato semelhante a:

{
   'Event Name':'my_event'
   'Payload':
   {
      'prop1':1
      'prop2':2
      'camelcase':3
      }
}

A alteração de formato fundamental é que as propriedades no objeto Payload dos eventos serão atualizadas para usar PascalCasing, para manter a consistência com outros eventos do PlayStream. Portanto, os novos nomes de propriedade seguirão o seguinte formato:

{
   'Event Name':'my_event'
   'Payload':
   {
      'Prop1':1
      'Prop2':2
      'CamelCase':3
      }
}

Observe que os nomes de propriedade dos eventos do Multiplayer Server agora estão atualizados para usar PascalCasing. Essa alteração afetará os clientes que processam eventos do Multiplayer Server em (a) consultas Kusto ou (b) cloud scripts do PlayFab. Por fim, se um cliente usar o recurso PlayFab Event Archive (atualmente em versão prévia pública), as propriedades dos eventos do Multiplayer Server exportados também serão formatadas em PascalCasing. Alterações de esquema A segunda alteração introduzida é que os eventos do Multiplayer Server serão entregues somente no formato PlayStream v2, e não mais no formato herdado PlayStream v1. No momento, o PlayFab dá suporte a dois esquemas de eventos.

Formato do esquema	Descrição	Valor do namespace dos eventos de multijogador
PlayStream V1	Projetado em torno de eventos de jogador	com.playfab.events.multiplayer
PlayStream V2	Projetado em torno de eventos de entidade	playfab.servers

Em geral, as APIs do PlayFab geram eventos no formato PlayStream V1 ou PlayStream V2. Por exemplo, as APIs que concedem itens de jogador geravam um evento PlayStream V1. Já as APIs que concedem itens de entidade geravam um evento PlayStream V2. Como o Multiplayer Servers foi lançado em versão prévia pública aproximadamente na mesma época em que o PlayStream V2 foi introduzido, o recurso Multiplayer Server dava suporte aos formatos PlayStream V1 e V2. Ou seja, cada chamada de API do Multiplayer Server gerava dois eventos: um no formato V1 e outro no formato V2. Para remover a duplicação, os eventos do Multiplayer Server no namespace ‘com.playfab.events.multiplayer.servers’ estão sendo preteridos. Os eventos no namespace ‘playfab.servers’ continuarão tendo suporte. Para distinguir entre os eventos do Multiplayer Server nos formatos V1 e V2, examine a propriedade namespace do evento. O namespace é especificado na terceira coluna da tabela acima. A representação JSON se assemelha ao seguinte formato:

{
   'FullName':
   {
      'Namespace':'abc',
      'Name':'xyz'
   }
}

A propriedade a ser procurada se chama Namespace.

200121

Data: 2020-01-21

Alterações de API e documentação:

O site de documentação de API do PlayFab foi totalmente migrado para /gaming/playfab
- A maioria dos links api.playfab.com foi convertida nos links learn.microsoft.com equivalentes
- A maioria dos links originais redireciona corretamente para o novo site
- Informe-nos nos fóruns se algum link antigo não funcionar
Novos métodos de API:
- multiplayer.ListServerBackfillTicketsForPlayer
- multiplayer.GetServerBackfillTicket
- multiplayer.CreateServerBackfillTicket
- multiplayer.CancelServerBackfillTicket
- multiplayer.CancelAllServerBackfillTicketsForPlayer
- server.UnlinkPSNAccount
- server.LinkPSNAccount

Alterações específicas do LuaSdk:

Pequena correção de bug no login

Alterações específicas do PhpSdk:

Pequena correção de sintaxe para correção estrita

Alterações específicas do UnitySDK:

Atualização do repositório do GitHub e da estrutura do projeto.
- O pacote Unity EdEx foi movido de (UnityEditorExtensions)[https://github.com/PlayFab/UnityEditorExtensions] para (UnitySdk)[https://github.com/PlayFab/UnitySDK/blob/master/Packages/PlayFabEditorExtensions.unitypackage]
- No futuro, também descontinuaremos gradualmente o repositório separado UnityEditorExtensions

​201218

​201207

​Alterações específicas do UnrealMarketplacePlugin

​201119

​Alterações específicas da PostmanCollection

​Alterações específicas do UnitySDK

​Alterações específicas do SDK XPlat C++

​201027

​201014

​200914

​200901

​200817

​200805

​200730

​200713

​200615

​200602

​200518

​Alterações específicas do UnitySDK:

​Alterações específicas do SDK XPlat C++

​200422

​Atualização do NodeSDK:

​200421

​200402

​Alterações de API

​200330

​Alterações de API

​Alterações específicas do SDK XPlat C++

​Alterações específicas do UnrealMarketPlacePlugin

​200303

​Alterações de API

​200220

​Novidades

​CPP Gsdk - Alteração significativa

​200218

​Alterações de API e documentação:

​Alterações específicas do CSharpSdk:

​200213

​200128

​Alterações nos eventos do Multiplayer Server:

​200121

​Alterações de API e documentação:

​Alterações específicas do LuaSdk:

​Alterações específicas do PhpSdk:

​Alterações específicas do UnitySDK:

201218

201207

Alterações específicas do UnrealMarketplacePlugin

201119

Alterações específicas da PostmanCollection

Alterações específicas do UnitySDK

Alterações específicas do SDK XPlat C++

201027

201014

200914

200901

200817

200805

200730

200713

200615

200602

200518

Alterações específicas do UnitySDK:

Alterações específicas do SDK XPlat C++

200422

Atualização do NodeSDK:

200421

200402

Alterações de API

200330

Alterações de API

Alterações específicas do SDK XPlat C++

Alterações específicas do UnrealMarketPlacePlugin

200303

Alterações de API

200220

Novidades

CPP Gsdk - Alteração significativa

200218

Alterações de API e documentação:

Alterações específicas do CSharpSdk:

200213

200128

Alterações nos eventos do Multiplayer Server:

200121

Alterações de API e documentação:

Alterações específicas do LuaSdk:

Alterações específicas do PhpSdk:

Alterações específicas do UnitySDK: