方向パッド

[アーティクル]
05/09/2023

ゲームパッドの方向パッドを常にマップする方向パッドコントロールです。

プロパティ

type - "directionalPad"。コントロールの種類を指定します。

scale - 数値、省略可能。既定値は 1 です。サイズの乗数。方向パッドはボタンのように配置され、ジョイスティックのように自動的にはスケーリングされないため、これが役立ちます。

deadzone - 数値、省略可能。デッドゾーンのサイズを、コントロールに対する割合として 0 ～ 1 の範囲の値で指定します。ジョイスティックのデッドゾーンとは異なり、方向パッドのデッドゾーンは常に軸を中心とした形状 (正方形) になります。

enabled - ブール値、省略可能。既定値は true です。コントロールの表示状態を有効/無効に設定します。無効なコントロールはプレイヤーからの入力を受け取りますが、入力に基づいてビジュアルスタイルが変更されることはありません。

visible - ブール値、省略可能。既定値は true です。操作するコントロールをプレイヤーに表示するかどうかを決定します。ゲームプレイ中に変更するには「ゲームの状態を使用してタッチレイアウトを変更する」を参照してください。

styles - オブジェクト、省略可能。コントロールの視覚的表現のカスタマイズ。スタイルは、スタイルを設定できる状態ごとのオブジェクトとして表示されます。

interaction - オブジェクト、省略可能。コントロールを使用してのユーザーの相互作用メカニズムを変更できるプロパティの定義

操作

activationType - 文字列、省略可能。方向パッドの操作で任意の方向に許可されるアクティブ化の種類を定義します。既定値は allowNeighboring です。 exclusive に設定すると、方向パッドで一度にアクティブにできるのは 1 つの方向のみです (つまり、'Up'、'Right'、'Down'、または 'Left' のいずれか 1 つだけです)。 allowNeighboring に設定すると、その方向と隣接する方向のいずれかとの間をタップすることにより、その方向と隣を同時にアクティブ化できます (つまり、ユーザーは個々の方向をアクティブ化する機能に加えて、それぞれの間をタップすることで、'Up+Right'、'Right+Down'、'Down+Left'、または 'Left+Up' をアクティブにすることができます)。

状態とスタイルのプロパティ

方向パッドコントロールには、次の状態のスタイルが設定可能です。

default - 基本スタイル。
disabled - コントロールが無効になっている場合のスタイル。指定されていない場合は、コントロールが無効になると、既定のスタイルに変換が適用され、無効として表示されます。
idle - プレイヤーがコントロールを使用していないときに適用されます。
activated - プレイヤーがボタンに触れているときに適用されます。

方向パッドコントロールのスタイルを設定するには、次のプロパティを使用できます。

opacity - 数値、省略可能。コントロールに適用する不透明度。 disabled を除くすべての状態の既定値は 1.0 です。

fill - オブジェクト、省略可能。方向パッドがアクティブ化されるときに使用されるグラデーションに対して定義された色を持つオブジェクト。

gradient - オブジェクト、省略可能。方向パッドがアクティブ化されるときに使用されるグラデーションに対して定義された色を持つオブジェクト。

background - オブジェクト、省略可能。色または画像資産を指定できます。

stroke - オブジェクト、省略可能。方向パッドのアウトラインで使用する色。ストロークオブジェクトである必要があります。

アセットの寸法

画像資産を受け入れるスタイルオブジェクトごとに、特定の資産が基本解像度で、またその基本解像度の 1.5x、2.0x、3.0x、4.0x のスケールで提供されます。特定の画像の解像度は、次の最大解像度以下である必要があります。

Object	@1.0x	@1.5x	@2.0x	@3.0x	@4.0x
background	75x75	112x112	150x150	225x225	300x300

解説

方向パッドは、物理コントローラーの方向パッドと同様のエクスペリエンスを提供するために使用されます。

これがプレイヤーの主要な移動メカニズムとして使用されている場合 (通常は leftinnerスロット)、スケール 2 を使用することをお勧めします。

スタイルに関するコメント

background にカスタムの画像資産を使用する場合、参照される最大解像度は scale=1.0 用です。別のスケールを使用する場合、最大解像度は解像度とスケールの積と同じになります。たとえば、scale=1.5 は、@1.0x DPI 背景画像の最大解像度が 90x90 である可能性があることを意味します。

Warning

Windows バージョンのコンテンツテストアプリケーションを介してストリーミングする場合、すべてのスタイル設定が正しく表示されるわけではありません。

サンプル

例 1: 既定の方向パッド

図 1。方向パッド

方向パッドを操作するユーザー

{
    "type": "directionalPad",
    "scale": 1.0
}

例 2: カスタマイズされた色の大きな方向パッド。

図 1。カスタマイズされた方向パッド

カスタマイズされた方向パッドを操作するユーザー

{
    "type": "directionalPad" ,
    "scale": 2.0,
    "styles" : {
        "default" : {
            "fill" : "#0e7a0d10",
            "gradient" : {
                "color": "#0e7a0d10"
            },
            "stroke" : {
                "type": "solid",
                "color" : "#0e7a0dff"
            }
        }
    }
}

要件

レイアウトバージョン: 1.0 以降(3.0 以降でのスタイル設定のサポート、3.4 以降での対話サポート)。

次の方法で共有

方向パッド

プロパティ

解説

サンプル

例 1: 既定の方向パッド

例 2: カスタマイズされた色の大きな方向パッド。

要件

その他のリソース