ジャイロスコープ

1. はじめに

Gyroscope APIは、Generic Sensor API [GENERIC-SENSOR] を拡張し、デバイスのローカルX、Y、Z軸まわりの角速度（ラジアン毎秒単位）に関する情報を提供します。

2. ユースケースおよび要件

ユースケースおよび要件は、Motion Sensors Explainer ドキュメントで扱われています。

3. 例

let sensor = new Gyroscope();
sensor.start();

sensor.onreading = () => {
    console.log("X軸回りの角速度 " + sensor.x);
    console.log("Y軸回りの角速度 " + sensor.y);
    console.log("Z軸回りの角速度 " + sensor.z);
};

sensor.onerror = event => console.log(event.error.name, event.error.message);

4. セキュリティとプライバシーに関する考慮事項

センサー 読み取り値は、ジャイロスコープなどの慣性センサーによって提供され、攻撃者によって様々なセキュリティ脅威（例：キーロギング、 位置追跡、フィンガープリンティング、ユーザー識別、さらには盗聴）に悪用される可能性があります。

たとえば[KEYSTROKEDEFENSE]など、セキュリティコミュニティにより発表された研究論文によれば、 周波数を絞ることで成功率を完全に排除できるわけではなく、逆にセンサー利用に正当な理由があるウェブアプリにとっては実用性が大きく損なわれることがあります。

[TOUCHSIGNATURES] では、慣性センサーの利用中に視覚的インジケーターを表示したり、センサー読み取り値へのアクセスに明示的なユーザー同意を要求する実装が提案されています。 これらの緩和策は、Generic Sensor API [GENERIC-SENSOR]で定義されている一般的な緩和策を補完します。

5. パーミッションポリシー統合

この仕様はポリシー管理機能として"gyroscope"を利用します。これは[DEVICE-ORIENTATION]で定義されています。

6. モデル

ジャイロスコープ センサータイプには以下のデータがあります：

拡張センサーインターフェース

Gyroscope

センサー許可名

"gyroscope"

センサー機能名

"gyroscope"

許可取り消しアルゴリズム

Generic Sensor permission revocation algorithm を "gyroscope" で呼び出します。

デフォルトセンサー

デバイスのメインジャイロセンサー。

仮想センサータイプ

"gyroscope"

最新読み取り値は、Sensor のジャイロスコープ センサータイプに対し "x", "y", "z" の3つのエントリを持ち、そのキーは "x", "y", "z" であり、対応する値には現在の角速度が含まれます。

角速度 は、デバイスが指定軸のまわりを回転する速度であり、デバイスによって定義される ローカル座標系 のもとで計測されます。 単位はラジアン毎秒（rad/s）[SI] です。

現在の角速度の符号は、回転方向に依存し、デバイスで定義されたローカル座標系で右手系規則に従うものとします。すなわち、軸の正方向から見て時計回りの回転を正とします（下図参照）。

6.1. 参照フレーム

ローカル座標系は、Gyroscope 読み取り値の参照フレームであり、デバイス座標系またはスクリーン座標系のいずれかです。

7. API

7.1. ジャイロスコープインターフェース

[SecureContext, Exposed=Window]
interface Gyroscope : Sensor {
  constructor(optional GyroscopeSensorOptions sensorOptions = {});
  readonly attribute double? x;
  readonly attribute double? y;
  readonly attribute double? z;
};

enum GyroscopeLocalCoordinateSystem { "device", "screen" };

dictionary GyroscopeSensorOptions : SensorOptions {
  GyroscopeLocalCoordinateSystem referenceFrame = "device";
};

Gyroscopeでサポートされるセンサーオプションは "frequency" および "referenceFrame" です。

7.1.1. Gyroscope.x

x 属性は、Gyroscope インターフェースの現在のX軸まわりの角速度を示します。 すなわち、この属性は、最新読み取り値から値を取得をthisと"x"を引数にして呼び出した値を返します。

7.1.2. Gyroscope.y

y 属性は、Gyroscope インターフェースの現在のY軸まわりの角速度を示します。 すなわち、この属性は、最新読み取り値から値を取得をthisと"y"を引数にして呼び出した値を返します。

7.1.3. Gyroscope.z

z 属性は、Gyroscope インターフェースの現在のZ軸まわりの角速度を示します。 すなわち、この属性は、最新読み取り値から値を取得をthisと"z"を引数にして呼び出した値を返します。

8. 抽象オペレーション

8.1. ジャイロスコープオブジェクトの構築

9. 自動化

このセクションはGeneric Sensor API § 9 Automationを拡張し、Gyroscope固有の仮想センサメタデータを提供します。

gyroscope virtual sensor typeおよび per-type virtual sensor metadata mapの対応するエントリは Device Orientation and Motion § automation で定義されています。

10. 謝辞

Generic Sensor API に関する作業について Tobie Langel に感謝します。

11. 適合性

適合性要件は、記述的な記述と RFC 2119 用語の組み合わせで表現されます。規範的部分で使われている "MUST"、 "MUST NOT"、"REQUIRED"、"SHALL"、"SHALL NOT"、"SHOULD"、"SHOULD NOT"、 "RECOMMENDED"、"MAY"、"OPTIONAL" というキーワードは RFC 2119 に記載された通りに解釈されます。 ただし、可読性のために、これらの語句は本仕様ではすべて大文字では記載されていません。

本仕様の本文は、例示や注記、非規範的と明示されたセクションを除き、すべて規範的な内容です。[RFC2119]

適合ユーザーエージェントは、 ユーザーエージェントに該当する、本仕様に記載されたすべての要件を実装しなければなりません。

本仕様の IDL 断片は、「Web IDL」仕様に記載された通り、適合する IDL 断片として必須であると解釈されます。[WEBIDL]