WebXR 手部输入模块 - 第一级

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 为 key、XRJointSpace 为 value 的 有序映射。

[[joints]] 内部槽的顺序由 关节列表（见骨骼关节）给出。

[[joints]] 在会话期间不得发生变化。

用于遍历的值对，对于一个 XRHand 对象，就是 以XRHandJoint 作为 key、XRJointSpace 为 value 的 值对， 顺序同 关节列表（见骨骼关节）。

get(jointName) 方法在 XRHand this 上被调用时，应执行以下步骤：

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) 方法提供joint相对于baseSpace的姿态，类型为XRJointPose， 与XRFrame的 时间一致。

该方法调用时，用户代理必须执行以下步骤：

1. 设frame为this。

2. 设session为frame的session 对象。

3. 如果frame的active为false，抛出InvalidStateError并中止。

4. 如果baseSpace或joint的session不同于 this session，抛出InvalidStateError并中止。

5. 设pose为 new XRJointPose ，构造于session的相关领域。

6. 以force emulation为false， 填充（Populate） joint 在 baseSpace、frame时刻的姿态到pose。

7. 若pose为null，返回null。

8. 设pose的radius 为joint（如需可模拟）的半径。

9. 返回pose。

fillJointRadii(sequence<XRJointSpace> jointSpaces, Float32Array radii) 方法将jointSpaces的半径填充到radii，返回布尔值指示所有空间是否都有有效姿态。

该方法在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. 设radii[offset] 浮点值：

      若用户代理能获取joint所属手所有关节姿态：

      设值为半径

      否则

      设值为NaN

      allValid设为false

   2. offset加1。

9. 返回allValid。

fillPoses(sequence<XRSpace> spaces, XRSpace baseSpace, Float32Array transforms) 方法将spaces相对于baseSpace的姿态矩阵填入transforms，返回布尔值表示所有空间是否都有有效姿态。

该方法在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()，用户代理可：

   令pose与上次同对象。

   否则

   令pose为 new XRPose 构造于session的相关领域

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;
};