虛擬鍵盤支援

雖然在 PC 上通常會假設連接了實體鍵盤，但遊戲台和觸控等新的輸入模式挑戰了這項假設。這對掌上型裝置和主機玩家而言尤其重要。視平台而定，有不同的解決方案可叫出虛擬鍵盤。雖然遊戲可以實作並建立自己的虛擬鍵盤，但系統提供了自己的虛擬鍵盤替代方案，這些方案針對平台進行最佳化，並在所有遊戲中提供一致的使用者體驗。在 Windows 上，可以搭配新的 CoreInputViewKind::Gamepad 選項運用 TryShow API。然後可以使用 TryHide API 在不需要時關閉鍵盤。下列程式碼範例示範了這一點：

#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();

在主機上，GDK 提供兩種不同的解決方案，可使用虛擬鍵盤處理文字輸入。對於大多數遊戲，最佳解決方案是使用 XGameUiShowTextEntryAsync。對於需要轉譯多行文字或輸入超過 1024 個字元的遊戲，可以使用 XGameUiTextEntryOpen。下表提供這兩種解決方案的比較。

描述	XGameUiShowTextEntryAsync	XGameUiTextEntryOpen
多行支援	否	是
字元數上限	1024	1024 * 32
輸入焦點	虛擬鍵盤取得輸入焦點	虛擬鍵盤取得輸入焦點
位置	固定位置	由遊戲決定位置
文字轉譯	由虛擬鍵盤處理	由遊戲處理
雲端串流行為	運用用戶端上的虛擬鍵盤	由串流伺服器轉譯

另請參閱

Windows 掌上型裝置上 GDK 遊戲的檢查清單 - 檢查 3：文字輸入 XGameUiShowTextEntryAsync XGameUiTextEntryOpen

Introduction

Onboarding & Access

Setup & Install

Build Your First Title

另請參閱

​另請參閱

另請參閱