WebXRハンド入力モジュール - レベル1

partial interface XRInputSource {
   [SameObject] readonly attribute XRHand? hand;
};

enum XRHandJoint {
  "wrist",

  "thumb-metacarpal",
  "thumb-phalanx-proximal",
  "thumb-phalanx-distal",
  "thumb-tip",

  "index-finger-metacarpal",
  "index-finger-phalanx-proximal",
  "index-finger-phalanx-intermediate",
  "index-finger-phalanx-distal",
  "index-finger-tip",

  "middle-finger-metacarpal",
  "middle-finger-phalanx-proximal",
  "middle-finger-phalanx-intermediate",
  "middle-finger-phalanx-distal",
  "middle-finger-tip",

  "ring-finger-metacarpal",
  "ring-finger-phalanx-proximal",
  "ring-finger-phalanx-intermediate",
  "ring-finger-phalanx-distal",
  "ring-finger-tip",

  "pinky-finger-metacarpal",
  "pinky-finger-phalanx-proximal",
  "pinky-finger-phalanx-intermediate",
  "pinky-finger-phalanx-distal",
  "pinky-finger-tip"
};

[Exposed=Window]
interface XRHand {
    iterable<XRHandJoint, XRJointSpace>;

    readonly attribute unsigned long size;
    XRJointSpace get(XRHandJoint key);
};

各XRHandオブジェクトには[[joints]]内部スロットがあり、キーがXRHandJoint型、値がXRJointSpace型の順序付きマップです。

[[joints]]の順序はスケルトンジョイントの下のジョイントリストによります。

[[joints]]はセッション中に変化してはいけません。

反復する値ペアはXRHandオブジェクトにとって、キーがXRHandJoint、値がそのXRJointSpaceであり、スケルトンジョイント下のジョイントリスト順になります。

get(jointName)メソッドをXRHandで呼び出すと、次の手順を実行します:

1. jointsを、thisの[[joints]]内部スロット値とする。

2. joints[jointName]を返す。（未知のjointNameの場合、undefinedとなることを意味します。）

[Exposed=Window]
interface XRJointSpace: XRSpace {
  readonly attribute XRHandJoint jointName;
};

partial interface XRFrame {
    XRJointPose? getJointPose(XRJointSpace joint, XRSpace baseSpace);
    boolean fillJointRadii(sequence<XRJointSpace> jointSpaces, Float32Array radii);

    boolean fillPoses(sequence<XRSpace> spaces, XRSpace baseSpace, Float32Array transforms);
};

getJointPose(XRJointSpace joint, XRSpace baseSpace)メソッドは、XRFrameのtime時点で、jointのbaseSpaceに対する姿勢をXRJointPoseで返します。

このメソッドが呼び出されると、ユーザーエージェントは以下の手順を実行します:

1. frameをthisとする。

2. sessionをframeのsessionオブジェクトとする。

3. frameのactiveがfalseなら、InvalidStateErrorを投げる。

4. baseSpaceまたはjointのsessionがsessionと異なれば、InvalidStateErrorを投げる。

5. poseを、sessionのrelevant realmで新しいXRJointPoseとする。

6. jointのbaseSpaceでframe時点の姿勢情報を投入し、force emulationはfalseにする。

7. poseがnullなら、nullを返す。

8. poseのradiusをjointの半径（必要に応じエミュレート）でセットする。

9. poseを返す。

fillJointRadii(sequence<XRJointSpace> jointSpaces, Float32Array radii)メソッドはjointSpacesの半径値をradiiに格納し、すべてのspaceに有効な姿勢があるかどうかを示すブール値を返します。

このメソッドをXRFrameインスタンスframeで呼ぶと、ユーザーエージェントは以下を実行します:

1. frameをthisとする。

2. sessionをframeのsessionオブジェクトとする。

3. frameのactiveがfalseであれば、InvalidStateErrorを投げる。

4. jointSpaces内の各jointについて:

   1. jointのsessionとsessionが異なれば、InvalidStateErrorを投げる。

5. jointSpacesの長さがradiiの要素数より大きければ、TypeErrorを投げる。

6. offsetを0とする。

7. allValidをtrueとする。

8. jointSpaces内の各jointについて:

   1. offset番目のradiiの値を以下でセット:

      UAがそのjointの手のすべての関節姿勢を取得できる場合:

      そのjointの半径でセット。

      それ以外

      radiiのoffsetにNaNをセット。

      allValidをfalseに。

   2. offsetを1増やす。

9. allValidを返す。

fillPoses(sequence<XRSpace> spaces, XRSpace baseSpace, Float32Array transforms)メソッドは、spacesの各姿勢行列をbaseSpaceに対してtransformsに格納し、すべてのspaceに有効な姿勢があるかどうかのブール値を返します。

このメソッドをXRFrameインスタンスframeで呼ぶと、ユーザーエージェントは以下を実行:

1. frameをthisとする。

2. sessionをframeのsessionオブジェクトとする。

3. frameのactiveがfalseであれば、InvalidStateErrorを投げる。

4. spaces内の各spaceについて:

   1. spaceのsessionがsessionと異なれば、InvalidStateErrorを投げる。

5. baseSpaceのsessionがsessionと異なれば、InvalidStateErrorを投げる。

6. spacesの長さに16かけた値がtransformsの要素数より大きければTypeErrorを投げる。

7. offsetを0とする。

8. poseを次のように初期化:

   fillPoses()が以前に呼ばれていれば、UAは:

   poseを前回と同じオブジェクトとできる。

   それ以外

   poseをsessionのrelevant realm内の新しいXRPoseとする。

9. allValidをtrueとする。

10. spaces内の各spaceについて:

    1. 姿勢情報を投入し、spaceのbaseSpaceに対するframe時点のposeにセット。

    2. poseがnullなら次を行う:

    3. transforms配列のoffsetから16要素連続にNaNをセット。

    4. allValidをfalseに。

    5. poseがnullでなければ、そのposeのmatrixメンバー全要素をtransformsのoffsetからコピー。

    6. offsetを16増やす。

11. allValidを返す。

[Exposed=Window]
interface XRJointPose: XRPose {
    readonly attribute float radius;
};