Suporte ao teclado virtual

Embora um teclado fisicamente conectado seja uma suposição comum no PC, novas modalidades de entrada, como gamepads e toque, desafiam essa suposição. Isso é especialmente importante para jogadores de dispositivos portáteis e de console. Dependendo da plataforma, há diferentes soluções para exibir o teclado virtual. Embora o título possa implementar e criar seu próprio teclado virtual, o sistema fornece suas próprias alternativas de teclado virtual, otimizadas para a plataforma e que oferecem uma experiência do usuário consistente em todos os jogos. No Windows, a API TryShow pode ser utilizada com a nova opção CoreInputViewKind::Gamepad. A API TryHide pode então ser usada para fechar o teclado quando ele não for necessário. Isso é demonstrado no seguinte exemplo de código:

#include <winrt/windows.ui.viewmanagement.core.h>
using namespace winrt::Windows::UI::ViewManagement::Core;

// CoreInputViewKind::Gamepad enum requires headers from 26100.3624 Windows SDK or greater
// Otherwise, use static_cast<CoreInputViewKind>(7) for earlier SDKs

CoreInputView::GetForCurrentView().TryShow(CoreInputViewKind::Gamepad));

CoreInputView::GetForCurrentView().TryHide();

Para console, o GDK oferece duas soluções diferentes para lidar com a entrada de texto usando um teclado virtual. Para a maioria dos jogos, a melhor solução é usar XGameUiShowTextEntryAsync. Os jogos que precisam renderizar texto de várias linhas ou a entrada de mais de 1024 caracteres podem usar XGameUiTextEntryOpen. A tabela a seguir fornece uma comparação entre essas duas soluções.

Descrição	XGameUiShowTextEntryAsync	XGameUiTextEntryOpen
Suporte a várias linhas	Não	Sim
Número máximo de caracteres	1024	1024 * 32
Foco de entrada	O teclado virtual recebe o foco de entrada	O teclado virtual recebe o foco de entrada
Posicionamento	Posição fixa	Posicionado pelo jogo
Renderização de texto	Realizada pelo teclado virtual	Realizada pelo jogo
Comportamento em streaming na nuvem	Utiliza o teclado virtual no cliente	Renderizado pelo servidor de streaming

Confira também

Lista de verificação para jogos do GDK em dispositivos portáteis Windows - Verificação 3: Entrada de texto XGameUiShowTextEntryAsync XGameUiTextEntryOpen

Porting

Build Paths

Confira também

​Confira também

Confira também