Memperkenalkan API Jarak

mata teras

• API jarak dekat Gunakan sensor kedekatan untuk mengukur jarak antara peranti dan objek dan memberikan maklumat jarak jauh. API ini bukan sebahagian daripada API Sensor, tetapi API mandiri.
API ini digunakan secara meluas, seperti keupayaan telefon untuk mematikan skrin secara automatik apabila ia dekat dengan telinga, dan menjeda pemain muzik apabila objek (seperti tangan) dekat dengan peranti.
API jarak dekat mentakrifkan dua peristiwa:
• memberikan maklumat mengenai jarak antara peranti dan objek berdekatan; Peristiwa -peristiwa ini boleh didengarkan dan dijawab. deviceproximity userproximity Pada masa ini, API jarak dekat adalah rendah sokongan, hanya Firefox (desktop dan mudah alih, versi 15 dan ke atas), walaupun ia telah memenuhi kriteria cadangan calon W3C.
Peranti mudah alih telah menjadi sebahagian daripada kehidupan yang penting, dan menggunakannya secara sederhana dapat membantu kami menyelesaikan banyak tugas harian seperti pertanyaan maklumat bas, mencari stesen bawah tanah terdekat atau restoran Itali, dll.

Peranti mudah alih juga telah membuka dunia baru untuk pemaju web. Untuk memenuhi keperluan peranti mudah alih, satu siri API yang direka khusus untuk mereka.

Dalam beberapa bulan yang lalu, saya telah memperkenalkan anda kepada beberapa API, seperti API Pemberitahuan Web dan API Ucapan Web. Artikel ini akan memperkenalkan API yang mudah tetapi praktikal: API jarak dekat.

Pengenalan

API jarak dekat mentakrifkan peristiwa yang memberikan maklumat tentang jarak antara peranti dan objek, diukur oleh sensor jarak dekat. API ini pada asalnya merupakan sebahagian daripada API Sensor dan kemudian dibahagikan kepada API mandiri. Spesifikasi API jarak dekat dianggap stabil kerana ia memenuhi kriteria cadangan calon W3C pada 1 Oktober 2013.

Jika anda telah menggunakan telefon pintar, anda mesti mengalami ciri -ciri API ini.

Sebagai contoh: Fikirkan proses panggilan terakhir anda. Anda membuka kunci telefon pintar anda, masukkan nombor yang anda mahu dail, dan kemudian klik butang "Panggil". Sebaik sahaja anda selesai, anda membawa telefon anda lebih dekat ke telinga anda, dan kemudian sesuatu sihir berlaku dan skrin dimatikan.

Banyak telefon pintar mempunyai ciri ini untuk menjimatkan kuasa bateri, yang dikuasakan oleh API jarak dekat. Apabila anda membawa peranti mudah alih anda lebih dekat ke telinga anda, sensor jarak jauh mencetuskan peristiwa yang didengar oleh telefon pintar anda, mematikan skrin.

Kami mempunyai kes -kes penggunaan menarik lain di web. Pernahkah anda mendengar muzik menggunakan perkhidmatan web semasa memandu dan kemudian perlu menjeda main balik?

Betapa menyusahkannya untuk menjeda pemain secara manual? Jawapannya mestilah "sangat menyusahkan!". Dengan API ini, pemaju web kini boleh menambah ciri yang pemain akan berhenti sebentar jika objek (dalam hal ini tangan) dekat dengan peranti.

Sekarang kita tahu apa API jarak dekat dan kes-kes penggunaannya, kita boleh menggali peristiwa yang ditunjukkannya.

event

API jarak dekat mentakrifkan dua peristiwa, yang boleh kita dengar dan bertindak balas mengikut kedekatan objek. Acara pertama ialah deviceproximity, yang memberikan maklumat tentang jarak antara peranti tuan rumah dan objek berdekatan. Acara kedua ialah userproximity, yang menentukan sama ada peranti mengesan objek berdekatan. Kedua -dua peristiwa itu dipecat pada objek window, jadi untuk mendengar mereka, kita perlu melampirkan pengendali kepadanya.

Berikut adalah contoh bagaimana untuk melampirkan pengendali acara deviceproximity:

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

Pengendali tambahan menerima objek sebagai parameter pertama yang mengandungi maklumat yang kami perlukan. Objek yang diluluskan oleh acara ini menyediakan tiga sifat: deviceproximity, value dan min. max adalah nombor yang menunjukkan jarak antara peranti dan objek (dalam sentimeter). Ciri -ciri value dan min menggambarkan jarak minimum dan maksimum (dalam sentimeter) yang dapat dikesan oleh sensor. Objek max yang diluluskan oleh peristiwa mendedahkan atribut userproximity. Ini adalah nilai boolean yang menentukan sama ada objek itu cukup dekat dengan peranti (benar) atau tidak (palsu). Dalam kes ini, "cukup dekat" bermakna objek itu berada dalam julat peranti tertentu yang dapat dikesan. near

Keserasian penyemak imbas

Pada masa ini, sokongan untuk API jarak dekat sangat rendah. Satu -satunya pelayar yang menyokongnya adalah Firefox (versi desktop dan mudah alih, bermula dengan versi 15). Ini mengejutkan memandangkan ia telah memenuhi kriteria cadangan calon W3C, tetapi itu berlaku.

Kerana API ini hanya dilaksanakan di Firefox, adalah penting untuk mengetahui cara menguji sokongannya. Kita boleh melakukan ini menggunakan kaedah yang terkenal yang mungkin anda temui ketika berurusan dengan API lain. Kaedah ini adalah seperti berikut:

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

Seperti yang ditunjukkan di atas, kita boleh menguji sokongan acara

. Pada ketika ini, kita tahu apa API jarak dekat dan peristiwa-peristiwa yang ditunjukkannya. Untuk menyelesaikan perjalanan kami, kami akan membangunkan demo mudah untuk melihat bagaimana ia berfungsi. userproximity

(kandungan berikutnya, seperti demo dan bahagian kesimpulan, disebabkan oleh batasan ruang, disyorkan agar anda merujuk kepada teks asal untuk membaca dan memahami. Saya telah mempermudah dan menulis semula teks asal, mengekalkan Maklumat dan gambar teras.)

Atas ialah kandungan terperinci Memperkenalkan API Jarak. Untuk maklumat lanjut, sila ikut artikel berkaitan lain di laman web China PHP!