keyboard_virtual_show()

Game Maker Language リファレンス > 組み込み関数 用途別 > ユーザインターフェース > keyboard_virtual_show()

keyboard_virtual_show() †

この関数を使用すると、ゲームを実行しているデバイスの仮想キーボードを表示できます。 この関数を呼び出すときは、最初の3つの引数のそれぞれに次の定数のいずれかを指定する必要があります。

1. Keyboard type

この定数は、仮想キーボードで使用できるキーセットを設定するために使用されます。 使用可能なキーボードの種類は次のとおりです。

Keyboard Type	Description
kbv_type_default	現在のシステムのデフォルトのキーボードタイプ
kbv_type_ascii	ASCII文字のみのキーボード
kbv_type_url	URL入力用に最適化された通常のキーボード。 通常、".com" または他のドメインキー、および "/" と"." キーを備えています
kbv_type_email	電子メール入力用に最適化された通常のキーボード。 通常は "@" と "." の文字を使用します
kbv_type_numbers	数字専用キーボード。通常はテンキーとして表示されます
kbv_type_phone	電話パッドキーボード。 通常は数字、"*" キーと "#" キーのみです
kbv_type_phone_name	電話番号と名前の両方を入力するために最適化されたキーボード。 通常はASCIIキーボードに似ていますが、特殊文字の選択が制限されています

2. Return type

この定数は、仮想キーボードのリターン/アクションキーに表示される内容を設定するために使用されます。 利用可能な返品タイプは次のとおりです

Return Type	Description
kbv_returnkey_default	現在のシステムのデフォルトのリターンキータイトル
kbv_returnkey_go	リターンキーのタイトルを "Go" に設定します
kbv_returnkey_google	リターンキーのタイトルを "Google" に設定するか、場合によっては一般的な検索アイコンに設定します
kbv_returnkey_join	リターンキーのタイトルを "Join" に設定します
kbv_returnkey_next	リターンキーのタイトルを "Next" に設定します
kbv_returnkey_route	リターンキーのタイトルを "Route" に設定します
kbv_returnkey_search	リターンキーのタイトルを"Search" に設定するか、場合によっては一般的な検索アイコンに設定します
kbv_returnkey_send	リターンキーのタイトルを "Send" に設定します
kbv_returnkey_yahoo	リターンキーのタイトルを"Yahoo" に設定するか、場合によっては一般的な検索アイコンに設定します
kbv_returnkey_done	リターンキーのタイトルを "Done" に設定します
kbv_returnkey_continue	リターンキーのタイトルを "Continue" に設定します
kbv_returnkey_emergency	リターンキーのタイトルを "Emergency Call" に設定します

3. Autocapitalization type

この定数は、仮想キーボードを介して入力された単語を自動大文字化する方法を決定するために使用されます。 使用可能な自動資本化タイプは次のとおりです

Autocapitalization Type	Description
kbv_autocapitalize_none	自動大文字化を無効
kbv_autocapitalize_words	単語で自動大文字化する
kbv_autocapitalize_sentences	文節で自動大文字化する
kbv_autocapitalize_characters	すべての文字で自動大文字化する

最後の引数は予測テキストを有効/無効にすることであり、これは許可する場合はtrueに設定され、それ以外の場合はfalseに設定されますが、許可されているからといって、設定に応じて使用されるわけではないことに注意してください。 デバイス上のユーザーの。 予測テキストモードの場合、仮想キーボードは通常のGameMaker Studio2キー押下イベントを生成しません。 代わりに、最後に押された文字とキーボードの文字列変数のみが更新されます。 これは、キーの押下を検出するために使用される内部テキストフィールドの変更が、実際の仮想キーボードキーによるものなのか、テキストの提案によるものなのかを検出できないためです。 このような場合、生のキー入力を読み取るのではなく、keyboard_string入力を読み取る必要があります。

プラットフォームOSに応じて、ユーザーはさまざまな機能を備えたさまざまなキーボードを入手することに注意することも重要です。ターゲットごとに使用する場合は、次の注意事項があります。

• UWP：UWP実装は、"return_key_type"、"autocapitalization_type"、または "predictive_text_enabled" をサポートしていません。 これらのパラメータを関数に渡してもエラーは発生せず、キーボードに影響を与えることはありません
• Android / Amazon Fire：Androidでは、キーボードタイプ "kbv_type_phone_name" はサポートされておらず、代わりにASCIIキーボードが表示されます。リターンキータイプは、"kbv_returnkey_go"、"kbv_returnkey_search"、"kbv_returnkey_next"、"kbv_returnkey_send"、または "kbv_returnkey_done" のみです。 そのプラットフォームで他のリターンキータイプが使用されている場合、システムはデフォルトで以下にリストされている交換用リターンキーになります

  使用できない リターンキー	置き換えするキー
  kbv_returnkey_google	kbv_returnkey_search
  kbv_returnkey_yahoo	kbv_returnkey_search
  kbv_returnkey_join	kbv_returnkey_go
  kbv_returnkey_route	kbv_returnkey_go
  kbv_returnkey_emergency	kbv_returnkey_go
  kbv_returnkey_continue	kbv_returnkey_next

• AndroidTV / FireTV：カスタムリターンキータイプはASCIIキーボードではサポートされていません。デフォルトのリターンキーが常に表示されます
• tvOS：予測テキストと自動大文字化はtvOSでサポートされておらず、システムイベントと関数 keyboard_virtual_height() によって返されるキーボードの高さは、画面全体に広がり、キーボードの四角形の寸法関数が無効になっているため、デフォルトで画面の高さになります。 tvOSで。 また、仮想キーボードが開かれていない限り、物理（Bluetooth）キーボードイベントはブロードキャストされないことに注意してください

この関数を呼び出すと、システム非同期イベントが生成されます。このイベントでは、async_load DS_Mapに次のキーと値のペアが入力されます

• event_type：これは、仮想キーボード機能によってトリガーされると "仮想キーボードステータス" になります
• screen_height：仮想キーボードの高さ（ピクセル単位）。 キーボードが表示されていない場合、これは0になります
• keyboard_status：キーボードの現在のステータス。次の文字列のいずれかとして返されます
  • "hiding"
  • "hidden"
  • "showing"
  • "visible"

構文 †

keyboard_virtual_show(keyboard_type, return_key_type, autocapitalization_type, predictive_text_enabled);

keyboard_type

仮想キーボードで使用可能なキーセットを決定します

return_key_type

仮想キーボードのリターン/アクションキーに何を表示するかを決定します

autocapitalization_type

仮想キーボードを介して入力された単語を自動大文字化する方法/かどうかを決定します

predictive_text_enabled

予測テキスト入力を有効/無効にするには、true / falseに設定します

戻り値 †

N/A

なし

例 †

if input == false
{
   input = true;
   keyboard_virtual_show(kbv_type_numbers, kbv_returnkey_default, kbv_autocapitalize_none, false);
}

上記のコードは、指定された変数がtrueに設定されていない場合、OS仮想キーボードを起動します。