核心要點

• 近距離 API 利用近距離傳感器測量設(shè)備與物體之間的距離，提供距離信息。該 API 并非傳感器 API 的一部分，而是獨立的 API。
• 該 API 應(yīng)用廣泛，例如手機在靠近耳朵時自動關(guān)閉屏幕的功能，以及物體（例如手）靠近設(shè)備時暫停音樂播放器。
• 近距離 API 定義了兩個事件：deviceproximity 提供設(shè)備與附近物體之間距離的信息；userproximity 指定設(shè)備是否檢測到附近物體?？梢员O(jiān)聽并響應(yīng)這些事件。
• 目前，近距離 API 的支持度較低，僅 Firefox（桌面版和移動版，15 版及以上）支持，盡管它已達到 W3C 候選推薦標準。

移動設(shè)備已成為生活中不可或缺的一部分，適度使用它們能幫助我們完成許多日常任務(wù)，例如查詢公交信息、查找最近的地鐵站或意大利餐廳等等。

移動設(shè)備也為 Web 開發(fā)者開辟了新的天地。為了滿足移動設(shè)備的使用需求，一系列專門為其設(shè)計的 API 應(yīng)運而生。

在過去的幾個月里，我已經(jīng)向大家介紹了一些 API，例如 Web Notifications API 和 Web Speech API。本文將介紹一個簡單但實用的 API：近距離 API。

簡介

近距離 API 定義了事件，這些事件提供關(guān)于設(shè)備與物體之間距離的信息，這些信息由近距離傳感器測量得出。該 API 最初是傳感器 API 的一部分，后來被拆分出來成為一個獨立的 API。近距離 API 的規(guī)范被認為是穩(wěn)定的，因為它在 2013 年 10 月 1 日達到了 W3C 候選推薦標準。

如果您使用過智能手機，那么您一定已經(jīng)體驗過這個 API 的功能。

舉個例子：想想您上次打電話的過程。您解鎖智能手機，輸入要撥打的號碼，然后點擊“呼叫”按鈕。完成之后，您將手機靠近耳朵，這時神奇的事情發(fā)生了，屏幕關(guān)閉了。

許多智能手機都具備此功能以節(jié)省電池電量，而這項功能正是由近距離 API 提供支持的。當您將移動設(shè)備靠近耳朵時，近距離傳感器會觸發(fā)一個事件，該事件會被您的智能手機監(jiān)聽，從而關(guān)閉屏幕。

在 Web 上，我們還有其他有趣的用例。您是否曾在開車時使用 Web 服務(wù)收聽音樂，然后需要暫停播放？

手動暫停播放器有多麻煩？答案一定是“非常麻煩！”。借助此 API，Web 開發(fā)者現(xiàn)在可以添加一個功能，如果物體（在本例中為手）靠近設(shè)備，播放器將暫停。

現(xiàn)在我們知道了近距離 API 是什么以及它的用例，我們可以深入了解它公開的事件。

事件

近距離 API 定義了兩個事件，我們可以根據(jù)物體的接近程度來監(jiān)聽和響應(yīng)這兩個事件。第一個事件是 deviceproximity，它提供有關(guān)主機設(shè)備與附近物體之間距離的信息。第二個事件是 userproximity，它指定設(shè)備是否檢測到附近物體。這兩個事件都在 window 對象上觸發(fā)，因此要監(jiān)聽它們，我們需要向其附加一個處理程序。

下面是一個如何附加 deviceproximity 事件處理程序的示例：

window.addEventListener('deviceproximity', function(event) {
   console.log('An object is ' + event.value + ' centimeters far away');
});

附加的處理程序接收一個對象作為其第一個參數(shù)，其中包含我們需要的信息。deviceproximity 事件傳遞的對象提供三個屬性：value、min 和 max。value 是一個數(shù)字，表示設(shè)備與物體之間的距離（以厘米為單位）。min 和 max 屬性描述傳感器可以檢測到的最小和最大距離（以厘米為單位）。userproximity 事件傳遞的對象公開了 near 屬性。這是一個布爾值，它指定物體是否足夠靠近設(shè)備（true）或不是（false）。在這種情況下，“足夠近”意味著物體在特定設(shè)備的可檢測范圍內(nèi)。

瀏覽器兼容性

目前，近距離 API 的支持度非常低。唯一支持它的瀏覽器是 Firefox（桌面版和移動版，從 15 版開始）。考慮到它已經(jīng)達到了 W3C 候選推薦標準，這一點令人驚訝，但目前就是這樣。

由于此 API 僅在 Firefox 中實現(xiàn)，因此了解如何測試其支持至關(guān)重要。我們可以使用一種眾所周知的方法來實現(xiàn)，您在處理其他 API 時可能已經(jīng)遇到過這種方法。此方法如下所示：

if ('ondeviceproximity' in window) {
   // API supported. Don't get too close, I can feel you
} else {
   // API not supported
}

如上所示，我們可以測試 userproximity 事件的支持情況。此時，我們知道了近距離 API 是什么以及它公開的事件。為了完成我們的旅程，我們將開發(fā)一個簡單的演示來查看它的實際效果。

(后續(xù)內(nèi)容，例如Demo和結(jié)論部分，由于篇幅限制，建議您參考原文進行閱讀和理解。 我已對原文進行了精簡和改寫，保留了核心信息和圖片。)

以上是引入接近API的詳細內(nèi)容。更多信息請關(guān)注PHP中文網(wǎng)其他相關(guān)文章！