核心要點(diǎn)

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

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

移動(dòng)設(shè)備也為 Web 開(kāi)發(fā)者開(kāi)闢了新的天地。為了滿足移動(dòng)設(shè)備的使用需求，一系列專門(mén)為其設(shè)計(jì)的 API 應(yīng)運(yùn)而生。

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

簡(jiǎn)介

近距離 API 定義了事件，這些事件提供關(guān)於設(shè)備與物體之間距離的信息，這些信息由近距離傳感器測(cè)量得出。該 API 最初是傳感器 API 的一部分，後來(lái)被拆分出來(lái)成為一個(gè)獨(dú)立的 API。近距離 API 的規(guī)範(fàn)被認(rèn)為是穩(wěn)定的，因?yàn)樗?2013 年 10 月 1 日達(dá)到了 W3C 候選推薦標(biāo)準(zhǔn)。

如果您使用過(guò)智能手機(jī)，那麼您一定已經(jīng)體驗(yàn)過(guò)這個(gè) API 的功能。

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

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

在 Web 上，我們還有其他有趣的用例。您是否曾在開(kāi)車時(shí)使用 Web 服務(wù)收聽(tīng)音樂(lè)，然後需要暫停播放？

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

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

事件

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

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

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

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

瀏覽器兼容性

目前，近距離 API 的支持度非常低。唯一支持它的瀏覽器是 Firefox（桌面版和移動(dòng)版，從 15 版開(kāi)始）?？紤]到它已經(jīng)達(dá)到了 W3C 候選推薦標(biāo)準(zhǔn)，這一點(diǎn)令人驚訝，但目前就是這樣。

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

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

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

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

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