Proximity Events

proximity events は、ユーザがデバイスの近くにいるときを知るのに便利な手段です。これらのイベントは近接度の変化への対応、例えばユーザがスマートフォンを耳の近くに持ってきて電話をしているときにスクリーンを休止することを可能にします。

Proximity Event

デバイスの近接センサーがデバイスと物体との距離の変化を検出すると、それをブラウザに通知します。ブラウザが通知を受けると、あらゆる変化について DeviceProximityEvent イベントが、またよりおおざっぱな変化の場合に UserProximityEvent イベントが発生します。

このイベントは addEventListener メソッド (イベント名 deviceproximity または userproximity を使用) を使用するか、イベントハンドラを window.ondeviceproximity プロパティまたは window.onuserproximity プロパティに接続することにより、window オブジェクトレベルで取得できます。

イベントを取得すると、イベントオブジェクトでさまざまな種類の情報にアクセスできます:

• DeviceProximityEvent イベントは、デバイスと物体との距離に一致する値を value プロパティで提供します。また、デバイスが何らかの物体を検出できる最短距離および最長距離を、min プロパティおよび max プロパティで提供します。
• UserProximityEvent イベントは、距離の大まかな近さを真偽値で表します。UserProximityEvent.near は物体が近いときに true に、また物体が遠いときに false になります。

例

window.addEventListener('userproximity', function(event) {
  if (event.near) {
    // スクリーンの電源を切る
    navigator.mozPower.screenEnabled = false;
  } else {
    // スクリーンの電源を入れる
    navigator.mozPower.screenEnabled = true;
  }
});

仕様

ブラウザ実装状況

関連情報

• DeviceProximityEvent
• UserProximityEvent
• deviceproximity
• userproximity