Proximity

摘要

近距 (Proximity) 事件可迅速感測出使用者靠近裝置，並迅速做出反應。舉例來說，當使用者接通來電並將裝置靠近耳朵時，智慧型手機隨即關閉螢幕。

近距事件

只要近距感測器測得「裝置」與「物體」之間的距離改變時，就會通知瀏覽器這項變化。而只要瀏覽器獲得通知，隨即啟動 DeviceProximityEvent 以因應任何變化；或啟動 UserProximityEvent 以因應簡單的變化。

透過 addEventListener 函式 (使用 deviceproximity 或 userproximity 事件名稱)；或將事件處理器 (Event handler) 附掛至 window.ondeviceproximity 或 window.onuserproximity 屬性，均可於 window 物件層級就擷取到此事件。

在擷取事件之後，事件物件將可存取不同的資訊：

• DeviceProximityEvent 事件透過本身的 value 屬性，可提供裝置與物體之間的確實距離。另透過本身的 min 與 max 屬性，則能設定「裝置測得某物」的最近與最遠距離。
• UserProximityEvent 事件則提供粗略的距離，並以 Boolean 值呈現。物體靠近時，UserProximityEvent.near 屬性即為 true；物體遠離則為 false。

範例

window.addEventListener('userproximity', function(event) {
  if (event.near) {
    // let's power off the screen
    navigator.mozPower.screenEnabled = false;
  } else {
    // Otherwise, let's power on the screen
    navigator.mozPower.screenEnabled = true;
  }
});

規格

瀏覽器相容性

另可參閱

• DeviceProximityEvent
• UserProximityEvent
• deviceproximity
• userproximity