XGameStreamingGetTouchBundleVersion
Obtém a versão do pacote de adaptação de toque que está sendo utilizado no momento no dispositivo especificado.Sintaxe
Parâmetros
client _In_Tipo: XGameStreamingClientId O cliente de streaming que está sendo consultado. version _Out_opt_
Tipo: XVersion* O número de versão do pacote que está sendo usado no momento no cliente especificado. Se nenhum número de versão for especificado no pacote, 0.0.0.0 será retornado. versionNameSize _In_
Tipo: size_t O tamanho máximo, em bytes, do
versionName a ser retornado. O tamanho a ser especificado pode ser obtido chamando XGameStreamingGetTouchBundleVersionNameSize.
versionName _Out_writes_opt_z_Tipo: char* O nome de versão do pacote que está sendo usado no momento no cliente especificado. Se nenhum nome de versão for especificado no pacote,
null será retornado.
Valor retornado
Tipo: HRESULT Retornará S_OK se for bem-sucedido; caso contrário, retornará um código de erro.Erros potenciais
Para obter uma lista de códigos de erro, consulte Códigos de erro.
Comentários
Os layouts de toque apresentados ao jogador durante o streaming de jogos usam layouts predefinidos que são carregados na Microsoft como parte de um pacote de adaptação de toque.XGameStreamingGetTouchBundleVersion permite que o jogo tome decisões em runtime com base no conjunto de controles de toque que estão sendo utilizados em um cliente específico. Alguns exemplos de onde isso pode ser utilizado:
- Para remover um elemento do HUD se o jogador estiver usando toque e o elemento estiver disponível por meio dos controles de sobreposição de toque.
- Para decidir quais dicas gráficas exibir no jogo com base nos layouts de toque que serão exibidos.
version será exclusiva para cada versão carregada no serviço. Cada atualização exigirá um novo número de versão.
O versionName pode ser usado para fornecer uma versão semântica (por exemplo, este é um conjunto de layouts que dá suporte ao DLC2) em vez de ficar preso a um número de versão específico. Por exemplo, se os números de versão forem atribuídos automaticamente pelo seu sistema de build, pode ser difícil para o código do jogo saber o número de versão exato dos pacotes de adaptação de toque que aparecerão em runtime. Para permitir que o código detecte a presença de um pacote sem precisar saber sua versão exata, você pode optar por usar um nome de versão em vez de fazer comparações com base em um número de versão.
Exemplo
Requisitos
Cabeçalho: XGameStreaming.h Biblioteca: xgameruntime.lib Plataformas com suporte: Windows, consoles da família XBOX One e consoles XBOX SeriesConfira também
XGameStreamingXGameStreamingGetTouchBundleVersionNameSize
