Joystick
ジョイスティックのように動作するアナログ コントロール。プロパティ
type - “joystick”
axis - object または array。このジョイスティック コントロールのマッピングを記述する単一の axis、または axes の配列。
action - object、省略可。axis マッピングに加えて呼び出す action。
actionThreshold - number、省略可。アクションを呼び出すのに必要な正規化されたジョイスティックの最小値 (radial)。既定値は 0 です。
enabled - boolean、省略可。既定値は true です。コントロールの視覚的な状態を有効/無効に設定します。無効なコントロールは引き続きプレイヤーからの入力を受け取りますが、入力に基づいて視覚スタイルは変更されません。
expand - boolean、省略可。既定値は true です。センター コントロール ソケットに配置された場合、ユーザーの人間工学的な好みに合わせてジョイスティックの範囲を拡張します。標準化された固定サイズのジョイスティックを使用するには false に設定します。
relative - boolean、省略可。
既定 (true) では、ジョイスティックはユーザーの最初のタッチに基づく相対計算を使用してその値を計算します。この値を false に設定すると、代わりにコントロールの中心点に基づいてその値を計算します。
visible - boolean、省略可。既定値は true です。プレイヤーが操作できるようにコントロールを表示するかどうかを決定します。ゲーム プレイ中に変更するには、ゲーム状態を使用したタッチ レイアウトの変更 を参照してください。
styles - object、省略可。コントロールの視覚的表現のカスタマイズ。スタイルは、スタイル設定可能な状態ごとのオブジェクトとして表されます。
button コントロールは次の状態のスタイルを設定できます:
default- 基本スタイル。disabled- コントロールが無効な場合のスタイル。指定されていない場合、コントロールが無効になると、既定のスタイルに変換が適用されて無効に見えるようになります。idle- プレイヤーがコントロールを操作していないときに適用されます。moving- 定義された deadzone に関係なく、ジョイスティックのノブが操作されているときに適用されます。activated-actionが定義されており、アクションを実行するためにノブがしきい値を超えて動かされたときに適用されます。
opacity - number、省略可。コントロールに適用される不透明度。disabled を除くすべての状態で既定値は 1.0 です。
background - object、省略可。color または image asset のいずれかを指定できます。
knob - object、省略可。knob オブジェクトは、プレイヤーが操作できるジョイスティックのボタン状部分のスタイルを指定します。
outline - object、省略可。outline オブジェクトは、ジョイスティックが操作されているときに表示される輪郭とインジケーターのスタイルを指定します。
アセットの寸法
画像アセットを受け入れる各スタイル オブジェクトについて、指定されたアセットはベース解像度と、そのベース解像度の 1.5x、2.0x、3.0x、4.0x のスケールで提供されます。指定された画像の解像度は、次の最大解像度以下である必要があります:
補足
joystick コントロールは、異なる物理コントローラーのジョイスティックにマッピングされるアナログ制御を提供するために使用できます。
joystick が主要な移動方法である場合、プレイヤーに最適な体験を提供するために、左センター スロットに配置し、expand を true に設定することをお勧めします。
faceImage をカスタマイズして、ジョイスティックが何を制御するかをプレイヤーに示すヒントを提供することを検討してください (ゲームで複数のジョイスティックを使用する場合は特に重要です)。
1 軸のみに依存する動きの場合、プレイアビリティを最大化するために単一軸ジョイスティックを利用してください。
スタイル設定に関する補足
background アセットを使用しており、expand が true の場合、background アセットはセンター ソケットの完全なサイズまでスケーリングされません。
既定では、outline はプレイヤーがコントロールを操作している間のみ表示されます。
カスタムの background アセットを使用しており、expand が true に設定されている場合、アセットはプレイヤーのコントロール カスタマイズに合わせて拡張されないことに注意してください。
サンプル
例 1: シンプルなジョイスティック
わずかな deadzone を持つジョイスティックへの基本的な 1:1 マッピング。物理コントローラーのサムスティックは回転を通じて値を計算します。 図 1. ジョイスティック コントロール
例 2: しきい値を超えると walk から sprint に切り替わるジョイスティック。
しきい値 (0.75) を超えると、ジョイスティックの動きと共に leftTrigger が送信されます。アイコンは ‘walk’ から ‘sprint’ に変わります。 図 1. アクション しきい値付きジョイスティック コントロール
例 3: ステアリング ホイールのように見える単一軸 (水平) ジョイスティック
図 1. 水平ステアリング ホイール ジョイスティック コントロール
例 4: カスタマイズされた色を持つジョイスティック
図 1. カスタマイズされたジョイスティック コントロール