ゲームパッド

ゲームを制御するために設計された外部デバイスとのインターフェイスは、 完全に一般的な方法で取り組むと、 大規模で扱いにくいものになる可能性があります。この仕様では、 広く実装でき、幅広く有用な機能の有用なサブセットを提供するために、 範囲を狭めることを明示的に選択します。

具体的には、ゲームパッドをサポートするために必要な機能のみを サポートすることを選択します。ゲームパッドのサポートには、 ボタンと軸という2種類の入力が必要です。ボタンと軸はいずれもアナログ値として報告され、 ボタンは[0 .. 1]の範囲、軸は[-1 .. 1]の範囲です。

主な目的はゲームパッドデバイスのサポートですが、これら 2種類のアナログ入力をサポートすることで、現在のゲームシステムで一般的な他の類似デバイス、 すなわちジョイスティック、ステアリングホイール、 ペダル、加速度計などもサポートできます。そのため、「gamepad」という名称は、 この仕様が扱うデバイス全体の総称になろうとするものではなく、 例示的なものです。

この仕様では、モーションセンシング、深度センシング、映像解析、 ジェスチャー認識などを行う、ゲームの文脈で使用されることもある より複雑なデバイスのサポートを明示的に除外します。

gamepadは、入力コントロールおよび出力 コントロールの集合です。入力コントロールは、時間とともに更新され得る入力 値の集合を持ちます。入力コントロールには、 gamepadのボタン、トリガー、ジョイスティック、サムスティック、およびタッチ面が含まれます。 出力コントロールは、 gamepadの挙動を変更し、 gamepadを操作するユーザーへフィードバックを提供する機能です。 出力コントロールには、gamepadの触覚アクチュエーターが含まれます。 gamepadは、ユーザーエージェントがその入力コントロールの現在の状態を読み取れる場合、 利用可能です。 gamepadが利用可能でない場合、 それは利用不能です。 入力コントロールおよび出力コントロールは、 gamepadが利用可能である間は 変更できません。

ユーザーエージェントは、次の責任を負います:

• 利用可能なgamepadsを列挙すること、
• gamepadsが利用可能または 利用不能になった時を検出すること、
• 入力コントロールの入力値が更新された時を検出すること、
• 入力値の現在の状態を読み取ること、および
• gamepadに対して、その出力 コントロールを使用するよう命令すること。

gamepadは、gamepad 識別子文字列を持ちます。これは、 gamepadのブランドまたはスタイルを識別する、 人間が読める文字列です。内容はユーザーエージェントによって決定されます。

このインターフェイスは、個々のゲームパッドデバイスを定義します。

WebIDL[Exposed=Window]
interface Gamepad {
  readonly attribute DOMString id;
  readonly attribute long index;
  readonly attribute boolean connected;
  readonly attribute DOMHighResTimeStamp timestamp;
  readonly attribute GamepadMappingType mapping;
  readonly attribute FrozenArray<double> axes;
  readonly attribute FrozenArray<GamepadButton> buttons;
  readonly attribute FrozenArray<GamepadTouch> touches;
  [SameObject] readonly attribute GamepadHapticActuator vibrationActuator;
};

システムと通信するために使用されるアルゴリズムは通常、 非同期に完了し、ゲームパッドタスクソースに作業をキューに入れます。

Gamepadのインスタンスは、次の表で説明される 内部スロットを用いて作成されます:

id属性

ゲームパッドの識別文字列です。この文字列は、接続された ゲームパッドデバイスのブランドまたはスタイルを識別します。

id文字列の正確な形式は未指定のままです。 ユーザーエージェントは、 デバイスを一意に識別することなく製品を識別する文字列を選択することが 推奨されます。たとえば、USBゲームパッドは idVendorおよびidProduct値によって識別されることがあります。 シリアル番号やBluetoothデバイスアドレスのような一意の識別子は、 id文字列に含めてはなりません。

index属性

Navigator内のゲームパッドのインデックスです。 複数のゲームパッドがユーザー エージェントに接続されている場合、インデックスはゼロから始まり、 先着順で割り当てられなければなりません。ゲームパッドが 切断された場合、以前に割り当てられたインデックスを、接続され続けている ゲームパッドに再割り当てしてはなりません。ただし、ゲームパッドが 切断され、その後、同じまたは異なるゲームパッドが接続された場合、 以前に使用された最小のインデックスが再利用されなければなりません。

connected 属性

このオブジェクトによって表される物理デバイスが まだシステムに接続されているかどうかを示します。ゲームパッドが、 物理的に切断された、電源が切られた、またはその他の理由で 使用不能になったことにより利用不能になると、 connected属性は falseに設定されなければなりません。

connected取得子の手順は次のとおりです:

1. this.[[connected]]を返す。

timestamp 属性

timestampにより、作成者は、この ゲームパッドのaxesまたはbuttons属性が最後に更新された時刻を 判断できます。この値は、システムがデバイスから新しいボタンまたは軸入力 値を受信するたびに、現在の高分解能 時刻へ設定されなければなりません。ハードウェアからデータを受信していない場合、 timestampは、 Gamepadが最初にスクリプトへ 利用可能にされた時点の現在の高分解能 時刻でなければなりません。

警告

ユーザーエージェントは、 [HR-TIME]のクロック分解能の推奨に従い、 timestamp属性の最小分解能を 5マイクロ秒に設定するべきです。

timestamp取得子の手順は次のとおりです:

1. this.[[timestamp]]を返す。

mapping 属性

このデバイスで使用されているマッピングです。ユーザーエージェントが デバイスのレイアウトについて知識を持つ場合、対応するGamepadMappingType 値へmappingを設定することで、 マッピングが使用中であることを示すべきです。

ゲームパッドデバイスのマッピングを選択するには、次の手順を実行します:

1. ゲームパッドデバイスのボタンおよび軸レイアウトが Standard Gamepadレイアウトに対応する場合、 "standard"を返す。
2. ""を返す。

axes属性

ゲームパッドのすべての軸の値の配列です。すべての軸値は、 [-1 .. 1]の範囲に線形正規化されなければなりません。 コントローラーが地面に垂直で、方向スティックが上を指している場合、 -1は「前方」または「左」に対応するべきであり、1は 「後方」または「右」に対応するべきです。2D 入力デバイスから得られる軸は、axes配列内で互いに隣接して現れ、X、 次にYの順になるべきです。要素0および1が通常、方向スティックの X軸およびY軸を表すように、軸は重要度の降順に現れることが 推奨されます。ユーザーエージェントが 異なる値（または異なる順序の値）を返す必要があるまで、 同じオブジェクトが返されなければなりません。

axes取得子の手順は次のとおりです:

1. this.[[axes]]を返す。

buttons 属性

ゲームパッドのすべてのボタンのボタン状態の配列です。 主ボタン、副ボタン、第3ボタンなどが buttons配列内の要素0、1、2、...として現れるように、 ボタンは重要度の降順に現れることが 推奨されます。ユーザーエージェントが 異なる値（または異なる順序の値）を返す必要があるまで、 同じオブジェクトが返されなければなりません。

buttons取得子の手順は次のとおりです:

1. this.[[buttons]]を返す。

touches 属性

すべてのタッチ面から生成されるGamepadTouchオブジェクトの listです。

touches取得子の手順は次のとおりです:

1. this.[[touches]]を返す。

vibrationActuator属性

デバイスの主たる振動アクチュエーターを表す GamepadHapticActuatorオブジェクトです。

vibrationActuator取得子の手順は 次のとおりです:

1. this.[[vibrationActuator]]を返す。

このインターフェイスは、ゲームパッドデバイス上の個々のボタンの状態を定義します。

WebIDL[Exposed=Window]
interface GamepadButton {
  readonly attribute boolean pressed;
  readonly attribute boolean touched;
  readonly attribute double value;
};

GamepadButtonのインスタンスは、次の表で説明される内部スロットを用いて作成されます:

pressed 属性

ボタンの押下状態です。このプロパティは、 ボタンが現在押されている場合はtrueでなければならず、押されていない場合はfalseでなければなりません。 純粋な押下状態または解放状態を示すデジタルスイッチを持たないボタンについては、 ユーザーエージェントは、 値が一定量を超えた時にボタンが押されたことを示すため、 ボタン 押下しきい値を選択しなければなりません。 プラットフォームAPIが推奨値を与える場合、ユーザーエージェントはそれを使用するべきです。 その他の場合、ユーザーエージェントは、 他の何らかの妥当な値を選択するべきです。

pressed取得子の手順は次のとおりです:

1. this.[[pressed]]を返す。

touched 属性

ボタンのタッチ状態です。ボタンがタッチを検出できる場合、 ボタンが現在タッチされていれば、このプロパティはtrueでなければならず、 それ以外の場合はfalseでなければなりません。ボタンが タッチを検出できず、アナログ値を報告できる場合、このプロパティは、valueプロパティが 0より大きい場合はtrueでなければならず、 valueが0の場合はfalseでなければなりません。ボタンがタッチを検出できず、 デジタル値のみを報告できる場合、このプロパティはpressed属性を反映しなければなりません。

touched取得子の手順は次のとおりです:

1. this.[[touched]]を返す。

value 属性

アナログセンサーを持つボタンについて、このプロパティは、ボタンが押された量を 表さなければなりません。すべてのボタン値は、[0 .. 1]の範囲に 線形正規化されなければなりません。0は完全に押されていないことを意味しなければならず、 1は完全に押されていることを意味しなければなりません。アナログセンサーを持たないボタンについては、 完全に押されていない状態と完全に押されている状態に対応する値0および1のみが それぞれ提供されなければなりません。

value取得子の手順は次のとおりです:

1. this.[[value]]を返す。

このインターフェイスは、そのような入力をサポートするゲームパッドのタッチ面上の タッチを定義します。このオブジェクトは、入力媒体（例: 指、スタイラスなど）が タッチデバイスに接触した時から、入力媒体がタッチデバイスに接触しなくなる時まで、 タッチ点を一意に識別するタッチ touchIdで構成されます。

WebIDLdictionary GamepadTouch {
  unsigned long touchId;
  octet surfaceId;
  DOMPointReadOnly position;
  DOMRectReadOnly? surfaceDimensions;
};

touchId属性

タッチの一意なidです。範囲は[0 .. 4294967295]です。

surfaceId属性

タッチを生成した面の一意なidです。

position属性

タッチのx、 y座標を保持する DOMPointReadOnlyです。 z値およびw値は現在使用されません。各座標の範囲は[-1 .. 1]に正規化されます。 x軸に沿って、-1は最左端の座標を参照し、1は最右端の座標を参照します。 y軸に沿って、-1は最上端の座標を参照し、1は最下端の座標を参照します。

surfaceDimensions属性

整数単位でのタッチ面のwidth およびheightで 初期化されたDOMRectReadOnlyです。 利用できない場合はnullです。

この列挙型は、Gamepadの既知のマッピングの集合を定義します。

WebIDLenum GamepadMappingType {
  "",
  "standard",
  "xr-standard",
};

""

空文字列は、このgamepadに対してマッピングが使用されていないことを示します。

"standard"

GamepadのコントロールがStandard Gamepad レイアウトにマッピングされています。

"xr-standard"

Gamepadのコントロールが"xr-standard" gamepad mappingにマッピングされています。このマッピングは、 WebXR Gamepads Module - Level 1による使用のために予約されています。 Gamepadオブジェクトが getGamepads()によって返される場合、 "xr-standard"の mappingを報告してはなりません。

GamepadHapticActuatorは、 触覚フィードバックの目的で力を加えることができる、モーターまたは他のアクチュエーターの 構成に対応します。

WebIDL[Exposed=Window]
interface GamepadHapticActuator {
  [SameObject] readonly attribute FrozenArray<GamepadHapticEffectType> effects;
  Promise<GamepadHapticsResult> playEffect(
      GamepadHapticEffectType type,
      optional GamepadEffectParameters params = {}
  );
  Promise<GamepadHapticsResult> reset();
};

GamepadHapticActuatorのインスタンスは、 次の表で説明される内部スロットを用いて作成されます:

effects属性

アクチュエーターがサポートするすべての触覚効果の種類を表す GamepadHapticEffectType値の配列です。 このプロパティは、ユーザーエージェントがその種類の効果の 再生をサポートしない場合を除き、アクチュエーターがサポートする GamepadHapticEffectType値を列挙します。

effects取得子の手順は次のとおりです:

1. this.[[effects]]を返す。

playEffect()メソッド

GamepadHapticEffectType typeおよび GamepadEffectParameters paramsを伴って呼び出される playEffect() メソッドの手順は次のとおりです:

1. paramsが、typeの妥当な効果を記述しない場合、 TypeErrorで拒否されたpromiseを返す。
2. documentを、現在の 設定オブジェクトの 関連する グローバルオブジェクトの関連付けられた Documentとする。
3. documentがnullである、またはdocumentが完全に アクティブでない、またはdocumentの可視性 状態が "hidden"である場合、 "InvalidStateError" DOMExceptionで 拒否されたpromiseを返す。
4. this.[[playingEffectPromise]] がnullでない場合:
   1. effectPromiseを this.[[playingEffectPromise]]とする。
   2. this.[[playingEffectPromise]]を nullに設定する。
   3. グローバルタスクをキューに入れる。 これはゲームパッドタスクソース上で、 thisの関連する グローバルオブジェクトを用いて行い、 effectPromiseを"preempted"で解決する。
5. this GamepadHapticActuatorが、typeの効果を再生できない場合、 NotSupportedErrorを理由として 拒否されたpromiseを返す。
6. [[playingEffectPromise]]を新しいpromiseとする。
7. playEffectTimestampを、documentの関連する グローバルオブジェクトが与えられた現在の高分解能 時刻とする。
8. 次の手順を並列に行う:
   1. type、 params、およびplayEffectTimestampを用いて、 アクチュエーターに触覚効果を発行する。
   2. 効果が完了した時、もし this.[[playingEffectPromise]]が nullでない場合、グローバルタスクをキューに入れる。 これはゲームパッドタスクソース上で、thisの関連する グローバルオブジェクトを用いて行い、 次の手順を実行する:
      1. this.[[playingEffectPromise]] がnullである場合、これらの手順を中止する。
      2. this.[[playingEffectPromise]] を"complete"で 解決する。
      3. this.[[playingEffectPromise]] をnullに設定する。
9. [[playingEffectPromise]]を返す。

reset()メソッド

reset()メソッドの手順は次のとおりです:

1. documentを、現在の 設定オブジェクトの 関連する グローバルオブジェクトの関連付けられた Documentとする。
2. documentがnullである、またはdocumentが完全に アクティブでない、またはdocumentの可視性 状態が "hidden"である場合、 "InvalidStateError" DOMExceptionで 拒否されたpromiseを返す。
3. resetResultPromiseを新しいpromiseとする。
4. this.[[playingEffectPromise]] がnullでない場合、次の手順を並列に行う:
   1. effectPromiseを this.[[playingEffectPromise]]とする。
   2. 触覚効果を停止する。これはthisの gamepadのアクチュエーター上で行う。
   3. 効果が正常に停止された場合、次を行う:
      1. effectPromiseと this.[[playingEffectPromise]] がまだ同じである場合、 this.[[playingEffectPromise]] をnullに設定する。
      2. グローバルタスクをキューに入れる。 これはゲームパッドタスクソース上で、 thisの関連する グローバルオブジェクトを用いて行い、 effectPromiseを "preempted"で 解決する。
   4. resetResultPromiseを "complete"で 解決する
5. resetResultPromiseを返す。

GamepadHapticActuatorは、 typeが [[effects]] list内に見つかる場合、typeの 効果を再生できます。

GamepadHapticEffectType typeおよびGamepadEffectParameters paramsを持つ効果が、妥当な効果を記述するかどうかを確認するには、 次の手順を実行します:

1. GamepadHapticEffectType typeの値が与えられたとして、次で分岐する:

   "dual-rumble"

   paramsが妥当なdual-rumble効果を記述しない場合、 falseを返す。

   "trigger-rumble"

   paramsが妥当なtrigger-rumble効果を記述しない場合、 falseを返す。

2. trueを返す

アクチュエーター上で触覚効果を 発行するには、ユーザーエージェントは、 typeの効果をレンダリングするためのコマンドを デバイスへ送信し、提供されたparamsを使用させようとしなければなりません。 ユーザーエージェントは、 params.startDelayが 0.0でない場合、より正確な再生タイミングのために、提供されたplayEffectTimestampを 使用するべきです。ユーザー エージェントは、互換性を高めるために効果を変更してもよいです。 たとえば、ランブルモーター向けの効果は、波形触覚をサポートするが ランブルモーターを欠くデバイスのために、波形ベースの効果に変換されることがあります。

アクチュエーター上で触覚 効果を停止するには、ユーザーエージェントは、 現在再生中の効果を中止するためのコマンドをデバイスへ送信しなければなりません。 触覚効果が中断された場合、アクチュエーターは可能な限り速やかに静止状態へ戻るべきです。

WebIDLenum GamepadHapticsResult {
  "complete",
  "preempted"
};

complete

触覚効果は再生を完了しました。

preempted

現在の効果は、別の効果によって停止または置換されました（すなわち「preempted」）。

効果の種類は、効果パラメーターがアクチュエーターによってどのように解釈されるかを 定義します。

WebIDLenum GamepadHapticEffectType {
  "dual-rumble",
  "trigger-rumble"
};

"dual-rumble"効果タイプ

"dual-rumble"は、標準ゲームパッドの 各ハンドルに偏心回転質量（ERM）振動モーターを持つ触覚 構成を記述します。この構成では、どちらの モーターもゲームパッド全体を振動させることができます。各モーターによって 作成される振動効果は等しくないため、それぞれの効果を組み合わせて より複雑な触覚効果を作成できます。

"dual-rumble"効果は、この種類の アクチュエーターを対象とした、固定時間で一定強度の振動効果です。 "dual-rumble" 効果は、startDelay、 duration、 strongMagnitude、および weakMagnitudeによって定義されますが、 いずれも既定値が0であるため必須ではありません。

strongMagnitudeおよび weakMagnitudeは、 低周波振動および高周波振動の強度レベルを設定し、 [0 .. 1]の範囲に正規化され、既定値は0です。

GamepadEffectParameters paramsが与えられた場合、 妥当なdual-rumble効果は、妥当なduration、妥当なstartDelayを持ち、かつ strongMagnitudeおよび weakMagnitudeの両方が [0 .. 1]の範囲内になければなりません。

"trigger-rumble"効果タイプ

"trigger-rumble"は、 "dual-rumble"に使用される2つの ハンドルモーターに加えて、Standard Gamepadの下部前面ボタン （標準インデックス6および7のボタン）のそれぞれに 振動モーターを持つ触覚構成を記述します。これらのボタンは 最も一般的にはばね付きトリガーの形を取ります。この 構成では、どちらのモーターもボタン表面に局所的な 触覚フィードバックを提供できます。

"trigger-rumble"効果は、 この種類のアクチュエーターを対象とした、固定時間で一定強度の 振動効果です。"trigger-rumble" 効果は、startDelay、 duration、 strongMagnitude、 weakMagnitude、 leftTrigger、および rightTriggerによって 定義されますが、いずれも既定値が0であるため必須ではありません。

startDelay、 duration、 strongMagnitude、 weakMagnitudeは、 "dual-rumble"と同じ定義を共有します。 leftTriggerおよび rightTriggerは、それぞれ 左右の下部前面ボタン振動の強度レベルを設定し、 [0 .. 1]の範囲に正規化され、既定値は0です。

GamepadEffectParameters paramsが与えられた場合、 妥当なtrigger-rumble効果は、妥当なduration、妥当なstartDelayを持ち、かつ strongMagnitude、 weakMagnitude、 leftTrigger、および rightTriggerが [0 .. 1]の範囲内になければなりません。

GamepadEffectParameters辞書は、触覚効果によって使用される パラメーター用のキーを含みます。各キーの意味は触覚効果によって定義され、 一部のキーは使用されないことがあります。

望ましくない長時間実行効果を緩和するため、ユーザーエージェントは、妥当な効果について、 合計効果時間を何らかの最大時間までに制限してもよいです。 ユーザーエージェントが最大5秒を使用することが 推奨されます。

WebIDLdictionary GamepadEffectParameters {
    unsigned long long duration = 0;
    unsigned long long startDelay = 0;
    double strongMagnitude = 0.0;
    double weakMagnitude = 0.0;
    double leftTrigger = 0.0;
    double rightTrigger = 0.0;
};

duration メンバー

durationは、 振動効果の継続時間をミリ秒で設定します。

startDelay メンバー

startDelayは、 playEffect()が 呼び出されてから振動が開始されるまでの遅延時間をミリ秒で設定します。 遅延間隔の間、アクチュエーターは振動するべきではありません。

strongMagnitudeメンバー

"dual-rumble"または "trigger-rumble"効果における 低周波ランブルの振動強度です。

weakMagnitudeメンバー

"dual-rumble"または "trigger-rumble"効果における 高周波ランブルの振動強度です。

leftTriggerメンバー

"trigger-rumble" 効果における、左下前面ボタン（標準 インデックス6）のランブルの振動強度です。

rightTriggerメンバー

"trigger-rumble"効果における、 右下前面ボタン（標準インデックス7）のランブルの振動強度です。

WebIDL[Exposed=Window]
partial interface Navigator {
  sequence<Gamepad?> getGamepads();
};

Navigatorのインスタンスは、 次の表で説明される内部スロットを用いて作成されます:

WebIDL[Exposed=Window]

interface GamepadEvent: Event {
  constructor(DOMString type, GamepadEventInit eventInitDict);
  [SameObject] readonly attribute Gamepad gamepad;
};

gamepad属性

gamepad属性は、このイベントに関連付けられた ゲームパッドデータへのアクセスを提供します。

WebIDLdictionary GamepadEventInit : EventInit {
  required Gamepad gamepad;
};

各デバイス製造元は多くの異なる製品を作成しており、それぞれが 固有のボタンおよび軸のスタイルとレイアウトを持ちます。 ユーザーエージェントは、 これらを可能な限り多くサポートすることが意図されています。

さらに、ゲームコンソールによって普及したデファクト標準レイアウトが 存在します。ユーザーエージェントが 接続されたデバイスを認識する場合、可能であれば標準順序に再マッピングすることが 推奨されます。認識されないデバイスも、 それらの生の形式で公開されるべきです。

現在、標準レイアウトは1つあり、それがStandard Gamepadです。再マッピング時、axesおよび buttons内のインデックスは、 できるだけ下図の物理的位置に対応するべきです。さらに、 mappingは "standard"に設定されるべきです。

Standard Gamepadのボタンは、4つのボタンからなる左クラスター、 4つのボタンからなる右クラスター、3つのボタンからなる中央 クラスター、およびゲームパッドの左右両側にある前面向きボタンのペアとして 配置されます。"Standard Gamepad"の4つの軸は、 左右に1つずつあるアナログスティックのペアに関連付けられています。次の 表は、ボタン/軸とそれらの物理的位置を説明します。

軸入力は、サムスティック軸の入力値を報告し、そのサムスティックが 対応するStandard Gamepadサムスティックとほぼ同じ位置にあり、 軸の向き（上下または左右）がStandard Gamepad軸の向きと一致する場合、Standard Gamepad軸を表すものとします。同じ Standard Gamepad軸を表す軸が複数ある場合、ユーザーエージェントは、そのうち1つを Standard Gamepad軸として選択し、他の軸には別の インデックスを割り当てるべきです。

ボタン入力は、ボタンまたはトリガーの入力値を報告し、そのボタンまたは トリガーが対応するStandard Gamepadボタンとほぼ同じ位置にある場合、 Standard Gamepadボタンを表すものとします。

軸またはボタン入力がStandard Gamepadの軸または ボタンを表す場合、その標準インデックスは、 対応するStandard Gamepadの軸またはボタンのインデックスです。

ゲームパッドがシステム上で利用可能になった時、次の手順を実行します:

1. documentを、現在のグローバル オブジェクトの 関連付けられた Documentとし、それ以外の場合はnullとする。
2. documentがnullでなく、かつ "gamepad"権限の使用を許可されていない場合、 これらの手順を中止する。
3. グローバルタスクを キューに入れる。これは、ゲームパッドタスクソース上で、 現在のグローバル オブジェクトを用いて行い、次の手順を実行する:
   1. gamepadを、ゲームパッドを表す新しい Gamepadとする。
   2. navigatorを、gamepadの関連する グローバルオブジェクトのNavigator オブジェクトとする。
   3. navigator.[[gamepads]][gamepad.index]を gamepadに設定する。
   4. navigator.[[hasGamepadGesture]]が trueである場合:
      1. gamepad.[[exposed]]をtrueに設定する。
      2. documentがnullでなく、かつ 完全に アクティブである場合、gamepadの関連する グローバルオブジェクトに対して、 gamepadconnectedという名前のイベントを発火する。 その際、GamepadEventを使用し、その gamepad属性を gamepadで初期化する。

この仕様を実装するユーザーエージェントは、 gamepadconnectedという名前の 新しいDOMイベントを提供しなければなりません。対応するイベントは GamepadEvent型でなければならず、 Window オブジェクト上で発火しなければなりません。

ユーザーエージェントは、 ユーザーがゲームパッドを接続したことを示すため、このイベント型をディスパッチしなければなりません。ページが読み込まれた時点でゲームパッドが すでに接続されていた場合、ユーザーがボタンを押すか軸を動かした時に gamepadconnectedイベントが ディスパッチされるべきです。

ゲームパッドがシステム上で利用不能になった時、次の手順を実行します:

1. gamepadを、利用不能なデバイスを表す Gamepad とする。
2. グローバルタスクを キューに入れる。これは、ゲームパッドタスクソース上で、 gamepadの関連する グローバルオブジェクトを用いて行い、次の手順を実行する:
   1. gamepad.[[connected]]をfalseに設定する。
   2. documentを、gamepadの関連する グローバルオブジェクトの関連付けられた Documentとし、それ以外の場合はnullとする。
   3. gamepad.[[exposed]]がtrueであり、かつ documentがnullでなく、かつ 完全に アクティブである場合、gamepadの関連する グローバルオブジェクトに対して、 gamepaddisconnectedという名前のイベントを発火する。これは GamepadEventを用い、その gamepad属性を gamepadで初期化する。
   4. navigatorを、gamepadの関連する グローバルオブジェクトのNavigator オブジェクトとする。
   5. navigator.[[gamepads]][gamepad.index]を nullに設定する。
   6. navigator.[[gamepads]]が空でなく、かつ navigator.[[gamepads]]の最後の項目が nullである間、 navigator.[[gamepads]]の最後の項目を削除する。

この仕様を実装するユーザーエージェントは、 gamepaddisconnectedという名前の 新しいDOMイベントを提供しなければなりません。対応するイベントは GamepadEvent型でなければならず、 Window オブジェクト上で発火しなければなりません。

ゲームパッドがユーザーエージェントから切断された時、 ユーザーエージェントが以前にその ゲームパッドについてgamepadconnectedイベントを Windowへ ディスパッチしていた場合、gamepaddisconnectedイベントは その同じWindowへ ディスパッチされなければなりません。

軸およびボタン変更イベントを含めるか除外するか、またそれらを よりまとめる（"gamepadchanged"?）、多少分離する（"gamepadaxischanged"?）、 あるいは個々の軸およびボタンごとに分離するかについて、さらなる議論が必要です。

この仕様は、HTMLのWindowEventHandlers インターフェイスミックスインを拡張し、 イベントハンドラー登録を容易にするためにイベントハンドラー IDL属性を追加します。

WebIDLpartial interface mixin WindowEventHandlers {
  attribute EventHandler ongamepadconnected;
  attribute EventHandler ongamepaddisconnected;
};

この仕様は、 文字列"gamepad"で識別されるポリシー制御機能を定義します。その 既定の 許可リストは*です。

非規範的と明示された節に加え、この仕様内のすべての著作ガイドライン、図、例、および注は 非規範的です。この仕様内のその他すべては規範的です。

この文書におけるキーワードMAY、MUST、MUST NOT、RECOMMENDED、SHOULD、およびSHOULD NOTは、 ここに示すようにすべて大文字で現れる場合に限り、 BCP 14 [RFC2119] [RFC8174] に記述されているように解釈されます。