Sensori per il Web

Utilizza l'API Generic Sensor per accedere ai sensori sul dispositivo come accelerometri, giroscopi e magnetometri.

Alex Shalamov
Alex Shalamov
Mikhail Pozdnyakov
Mikhail Pozdnyakov

Attualmente, i dati dei sensori vengono utilizzati in molte applicazioni specifiche della piattaforma per abilitare casi d'uso come giochi immersivi, monitoraggio dell'attività fisica e realtà virtuale o aumentata. Non sarebbe fantastico colmare il divario tra le applicazioni web e quelle specifiche della piattaforma? Utilizza l'API Generic Sensor per il web.

L'API Generic Sensor è un insieme di interfacce che espongono i dispositivi di rilevamento alla piattaforma web. L'API è composta dall'interfaccia di base Sensor e da un insieme di classi di sensori concrete costruite sopra. Avere un'interfaccia di base semplifica il processo di implementazione e specifica per le classi di sensori concrete. Ad esempio, dai un'occhiata alla classe Gyroscope. È minuscolo! La funzionalità di base è specificata dall'interfaccia di base e Gyroscope la estende semplicemente con tre attributi che rappresentano la velocità angolare.

Alcune classi di sensori si interfacciano con sensori hardware reali, ad esempio le classi di accelerometro o giroscopio. Questi sono chiamati sensori di basso livello. Altri sensori, chiamati sensori di fusione, uniscono i dati di diversi sensori di basso livello per mostrare informazioni che altrimenti uno script dovrebbe calcolare. Ad esempio, il sensore AbsoluteOrientation fornisce una matrice di rotazione quattro per quattro pronta per l'uso in base ai dati ottenuti dall'accelerometro, dal giroscopio e dal magnetometro.

Potresti pensare che la piattaforma web fornisca già i dati dei sensori e hai assolutamente ragione. Ad esempio, gli eventi DeviceMotion e DeviceOrientation espongono i dati dei sensori di movimento. Allora perché abbiamo bisogno di una nuova API?

Rispetto alle interfacce esistenti, l'API Generic Sensor offre numerosi vantaggi:

  • L'API Generic Sensor è un framework per i sensori che può essere facilmente esteso con nuove classi di sensori e ciascuna di queste classi manterrà l'interfaccia generica. Il codice client scritto per un tipo di sensore puoi essere riutilizzato per un altro con pochissime modifiche.
  • Puoi configurare il sensore. Ad esempio, puoi impostare la frequenza di campionamento adatta alle esigenze della tua applicazione.
  • Puoi rilevare se un sensore è disponibile sulla piattaforma.
  • Le letture dei sensori hanno timestamp ad alta precisione, che consentono una migliore sincronizzazione con altre attività nella tua applicazione.
  • I modelli di dati dei sensori e i sistemi di coordinate sono chiaramente definiti, consentendo ai fornitori di browser di implementare soluzioni interoperabili.
  • Le interfacce basate su sensori generici non sono legate al DOM (ovvero non sono oggetti navigator o window), il che apre opportunità future per l'utilizzo dell'API all'interno di service worker o per la sua implementazione in runtime JavaScript headless, come i dispositivi embedded.
  • Gli aspetti relativi a sicurezza e privacy sono la massima priorità per l'API Generic Sensor e offrono una sicurezza molto migliore rispetto alle API di sensori precedenti. È presente l'integrazione con l'API Permissions.
  • La sincronizzazione automatica con le coordinate dello schermo è disponibile per Accelerometer, Gyroscope, LinearAccelerationSensor, AbsoluteOrientationSensor, RelativeOrientationSensor e Magnetometer.

API di sensori generici disponibili

Al momento della stesura di questo articolo, sono disponibili diversi sensori con cui puoi fare esperimenti.

Sensori di movimento:

  • Accelerometer
  • Gyroscope
  • LinearAccelerationSensor
  • AbsoluteOrientationSensor
  • RelativeOrientationSensor
  • GravitySensor

Sensori ambientali:

  • AmbientLightSensor (dietro il flag #enable-generic-sensor-extra-classes in Chromium).
  • Magnetometer (dietro il flag #enable-generic-sensor-extra-classes in Chromium).

Rilevamento di funzionalità

Il rilevamento delle funzionalità delle API hardware è complicato, poiché devi rilevare sia se il browser supporta l'interfaccia in questione, sia se il dispositivo è dotato del sensore corrispondente. Verificare se il browser supporta un'interfaccia è semplice. Sostituisci Accelerometer con una qualsiasi delle altre interfacce menzionate sopra.

if ('Accelerometer' in window) {
  // The `Accelerometer` interface is supported by the browser.
  // Does the device have an accelerometer, though?
}

Per un risultato di rilevamento delle funzionalità effettivamente significativo, devi anche provare a connetterti al sensore. Questo esempio illustra come procedere.

let accelerometer = null;
try {
  accelerometer = new Accelerometer({ frequency: 10 });
  accelerometer.onerror = (event) => {
    // Handle runtime errors.
    if (event.error.name === 'NotAllowedError') {
      console.log('Permission to access sensor was denied.');
    } else if (event.error.name === 'NotReadableError') {
      console.log('Cannot connect to the sensor.');
    }
  };
  accelerometer.onreading = (e) => {
    console.log(e);
  };
  accelerometer.start();
} catch (error) {
  // Handle construction errors.
  if (error.name === 'SecurityError') {
    console.log('Sensor construction was blocked by the Permissions Policy.');
  } else if (error.name === 'ReferenceError') {
    console.log('Sensor is not supported by the User Agent.');
  } else {
    throw error;
  }
}

Polyfill

Per i browser che non supportano l'API Generic Sensor, è disponibile un polyfill. Il polyfill ti consente di caricare solo le implementazioni dei sensori pertinenti.

// Import the objects you need.
import { Gyroscope, AbsoluteOrientationSensor } from './src/motion-sensors.js';

// And they're ready for use!
const gyroscope = new Gyroscope({ frequency: 15 });
const orientation = new AbsoluteOrientationSensor({ frequency: 60 });

Che cosa sono tutti questi sensori? Come faccio a utilizzarli?

I sensori sono un'area che potrebbe richiedere una breve introduzione. Se hai dimestichezza con i sensori, puoi saltare direttamente alla sezione di programmazione pratica. In caso contrario, diamo un'occhiata a ciascun sensore supportato nel dettaglio.

Accelerometro e sensore di accelerazione lineare

Misurazioni del sensore di accelerazione

Il sensore Accelerometer misura l'accelerazione di un dispositivo che lo ospita su tre assi (X, Y e Z). Questo sensore è un sensore inerziale, il che significa che quando il dispositivo è in caduta libera lineare, l'accelerazione misurata totale sarà pari a 0 m/s2 e quando un dispositivo è appoggiato su un tavolo, l'accelerazione in direzione verso l'alto (asse Z) sarà uguale alla gravità terrestre, ovvero g ≈ +9, 8 m/s2 poiché misura la forza del tavolo che spinge il dispositivo verso l'alto. Se spingi il dispositivo verso destra, l'accelerazione sull'asse X sarà positiva o negativa se il dispositivo viene accelerato da destra verso sinistra.

Gli accelerometri possono essere utilizzati per, ad esempio, conteggio dei passi, rilevamento dei movimenti o semplice orientamento del dispositivo. Molto spesso, le misurazioni dell'accelerometro vengono combinate con i dati di altre fonti per creare sensori di fusione, come i sensori di orientamento.

Il LinearAccelerationSensor misura l'accelerazione applicata al dispositivo che ospita il sensore, escludendo il contributo della gravità. Quando un dispositivo è a riposo, ad esempio appoggiato sul tavolo, il sensore misura un'accelerazione di ≈ 0 m/s2 su tre assi.

Sensore di gravità

È già possibile per gli utenti ricavare manualmente letture simili a quelle di un sensore di gravità controllando manualmente le letture di Accelerometer e LinearAccelerometer, ma questo può essere complicato e dipende dalla precisione dei valori forniti da questi sensori. Piattaforme come Android possono fornire letture della gravità all'interno del sistema operativo, il che dovrebbe essere più economico in termini di calcolo, fornire valori più accurati a seconda dell'hardware dell'utente ed essere più facile da usare in termini di ergonomia dell'API. GravitySensor restituisce l'effetto dell'accelerazione lungo gli assi X, Y e Z del dispositivo a causa della gravità.

Giroscopio

Misurazioni del sensore giroscopio

Il sensore Gyroscope misura la velocità angolare in radianti al secondo attorno agli assi X, Y e Z locali del dispositivo. La maggior parte dei dispositivi consumer è dotata di giroscopi meccanici (MEMS), ovvero sensori inerziali che misurano la velocità di rotazione in base alla forza di Coriolis inerziale. I giroscopi MEMS sono soggetti a derive causate dalla sensibilità gravitazionale del sensore che deforma il sistema meccanico interno del sensore. I giroscopi oscillano a frequenze relativamente alte, ad esempio 10 kHz e quindi potrebbe consumare più energia rispetto ad altri sensori.

Sensori di orientamento

Misurazioni del sensore di orientamento assoluto

AbsoluteOrientationSensor è un sensore di fusione che misura la rotazione di un dispositivo rispetto al sistema di coordinate della Terra, mentre RelativeOrientationSensor fornisce dati che rappresentano la rotazione di un dispositivo che ospita sensori di movimento rispetto a un sistema di coordinate di riferimento stazionario.

Tutti i moderni framework JavaScript 3D supportano i quaternioni e le matrici di rotazione per rappresentare la rotazione; tuttavia, se usi direttamente WebGL, OrientationSensordispone convenientemente sia una proprietàquaternion che un populateMatrix()metodo. Ecco alcuni snippet:

three.js

let torusGeometry = new THREE.TorusGeometry(7, 1.6, 4, 3, 6.3);
let material = new THREE.MeshBasicMaterial({ color: 0x0071c5 });
let torus = new THREE.Mesh(torusGeometry, material);
scene.add(torus);

// Update mesh rotation using quaternion.
const sensorAbs = new AbsoluteOrientationSensor();
sensorAbs.onreading = () => torus.quaternion.fromArray(sensorAbs.quaternion);
sensorAbs.start();

// Update mesh rotation using rotation matrix.
const sensorRel = new RelativeOrientationSensor();
let rotationMatrix = new Float32Array(16);
sensor_rel.onreading = () => {
  sensorRel.populateMatrix(rotationMatrix);
  torus.matrix.fromArray(rotationMatrix);
};
sensorRel.start();

BABYLON

const mesh = new BABYLON.Mesh.CreateCylinder('mesh', 0.9, 0.3, 0.6, 9, 1, scene);
const sensorRel = new RelativeOrientationSensor({ frequency: 30 });
sensorRel.onreading = () => mesh.rotationQuaternion.FromArray(sensorRel.quaternion);
sensorRel.start();

WebGL

// Initialize sensor and update model matrix when new reading is available.
let modMatrix = new Float32Array([1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1]);
const sensorAbs = new AbsoluteOrientationSensor({ frequency: 60 });
sensorAbs.onreading = () => sensorAbs.populateMatrix(modMatrix);
sensorAbs.start();

// Somewhere in rendering code, update vertex shader attribute for the model
gl.uniformMatrix4fv(modMatrixAttr, false, modMatrix);

I sensori di orientamento consentono vari casi d'uso, come giochi immersivi, realtà virtuale e realtà aumentata.

Per saperne di più sui sensori di movimento, sui casi d'uso avanzati e sui requisiti, consulta il documento spiegativo sui sensori di movimento.

Sincronizzazione con le coordinate dello schermo

Per impostazione predefinita, le letture dei sensori spaziali vengono risolte in un sistema di coordinate locale associato al dispositivo e non tengono conto dell'orientamento dello schermo.

Sistema di coordinate del dispositivo
Sistema di coordinate del dispositivo

Tuttavia, molti casi d'uso, come i giochi o la realtà virtuale e aumentata, richiedono che le letture dei sensori vengano risolte in un sistema di coordinate vincolato all'orientamento dello schermo.

Sistema di coordinate dello schermo
Sistema di coordinate dello schermo

In precedenza, la rimappatura delle letture del sensore alle coordinate dello schermo doveva essere implementata in JavaScript. Questo approccio non è efficiente e aumenta anche in modo significativo la complessità del codice dell'applicazione web. L'applicazione web deve monitorare le variazioni dell'orientamento dello schermo ed eseguire trasformazioni delle coordinate per le letture del sensore, il che non è un'operazione banale per gli angoli di Eulero o i quaternioni.

L'API Generic Sensor fornisce una soluzione molto più semplice e affidabile. Il sistema di coordinate locale è configurabile per tutti i classi di sensori spaziali definiti: Accelerometer, Gyroscope, LinearAccelerationSensor, AbsoluteOrientationSensor, RelativeOrientationSensor e Magnetometer. Passando l'opzione referenceFrame al costruttore dell'oggetto sensore, l'utente definisce se le letture restituite verranno risolte nelle coordinate del dispositivo o dello schermo.

// Sensor readings are resolved in the Device coordinate system by default.
// Alternatively, could be RelativeOrientationSensor({referenceFrame: "device"}).
const sensorRelDevice = new RelativeOrientationSensor();

// Sensor readings are resolved in the Screen coordinate system. No manual remapping is required!
const sensorRelScreen = new RelativeOrientationSensor({ referenceFrame: 'screen' });

Iniziamo a programmare.

L'API Generic Sensor è molto semplice e facile da usare. L'interfaccia del sensore include metodi start() e stop() per controllare lo stato dei sensori e diversi gestori di eventi per ricevere notifiche sull'attivazione dei sensori, sugli errori e sulle nuove letture disponibili. Le classi dei sensori in cemento di solito aggiungono i loro attributi di lettura specifici alla classe base.

Ambiente di sviluppo

Durante lo sviluppo potrai utilizzare i sensori tramite localhost. Se stai sviluppando per dispositivi mobili, configura il port forwarding per il tuo server locale e sei pronto per iniziare.

Quando il codice è pronto, esegui il deployment su un server che supporta HTTPS. GitHub Pages vengono pubblicate tramite HTTPS, il che le rende un ottimo posto per condividere le tue demo.

Rotazione del modello 3D

In questo semplice esempio, utilizziamo i dati di un sensore di orientamento assoluto per modificare il quaternione di rotazione di un modello 3D. model è un'istanza della classe three.js Object3D che ha una proprietà quaternion. Il seguente snippet di codice della demo dello smartphone con orientamento illustra come il sensore di orientamento assoluto può essere utilizzato per ruotare un modello 3D.

function initSensor() {
  sensor = new AbsoluteOrientationSensor({ frequency: 60 });
  sensor.onreading = () => model.quaternion.fromArray(sensor.quaternion);
  sensor.onerror = (event) => {
    if (event.error.name == 'NotReadableError') {
      console.log('Sensor is not available.');
    }
  };
  sensor.start();
}

L'orientamento del dispositivo verrà applicato alla rotazione model 3D all'interno della scena WebGL.

Il sensore aggiorna l'orientamento del modello 3D
Il sensore aggiorna l'orientamento di un modello 3D

Punchmeter

Il seguente snippet di codice è estratto dalla demo del punchmeter, che mostra come il sensore di accelerazione lineare può essere utilizzato per calcolare la velocità massima di un dispositivo supponendo che sia inizialmente fermo.

this.maxSpeed = 0;
this.vx = 0;
this.ax = 0;
this.t = 0;

/* … */

this.accel.onreading = () => {
  let dt = (this.accel.timestamp - this.t) * 0.001; // In seconds.
  this.vx += ((this.accel.x + this.ax) / 2) * dt;

  let speed = Math.abs(this.vx);

  if (this.maxSpeed < speed) {
    this.maxSpeed = speed;
  }

  this.t = this.accel.timestamp;
  this.ax = this.accel.x;
};

La velocità attuale viene calcolata come approssimazione dell'integrale della funzione di accelerazione.

Applicazione web demo per la misurazione della velocità del pugno
Misurazione della velocità di un pugno

Debug e override dei sensori con Chrome DevTools

In alcuni casi non occorre un dispositivo fisico per utilizzare l'API Generic Sensor. Chrome DevTools offre un'ottima assistenza per la simulazione dell'orientamento del dispositivo.

Chrome DevTools veniva utilizzato per eseguire l&#39;override dei dati sull&#39;orientamento personalizzato di uno smartphone virtuale
Simulare l'orientamento del dispositivo con Chrome DevTools

Privacy e sicurezza

Le letture del sensore sono dati sensibili che possono essere soggetti a vari attacchi da pagine web dannose. Le implementazioni delle API di sensori generici applicano alcune limitazioni per ridurre i possibili rischi per la sicurezza e la privacy. Queste limitazioni devono essere prese in considerazione dagli sviluppatori che intendono utilizzare l'API, quindi elenchiamole brevemente.

Solo HTTPS

Poiché l'API Generic Sensor è una funzionalità potente, il browser la consente solo in contesti sicuri. In pratica significa che per utilizzare l'API Generic Sensor dovrai accedere alla tua pagina tramite HTTPS. Durante lo sviluppo puoi farlo tramite http://localhost, ma per la produzione dovrai avere HTTPS sul tuo server. Consulta la raccolta Sicuro e protetto per consultare le best practice e le linee guida.

Integrazione dei criteri relativi alle autorizzazioni

L'integrazione dei criteri di autorizzazione nell'API Generic Sensor controlla l'accesso ai dati dei sensori per un frame.

Per impostazione predefinita, gli oggetti Sensor possono essere creati solo all'interno di un frame principale o di frame secondari dello stesso dominio, impedendo così agli iframe cross-origin di leggere i dati dei sensori senza autorizzazione. Questo comportamento predefinito puoi essere modificato attivando o disattivando esplicitamente le corrispondente funzionalità controllate dai criteri.

Lo snippet riportato di seguito mostra la concessione dell'accesso ai dati dell'accelerometro a un iframe cross-origin, il che significa che ora è possibile creare oggetti Accelerometer o LinearAccelerationSensor.

<iframe src="https://third-party.com" allow="accelerometer" />

L'invio delle letture del sensore può essere sospeso

Le letture dei sensori sono accessibili solo da una pagina web visibile, ovvero quando l'utente interagisce effettivamente con essa. Inoltre, i dati del sensore non verrebbero forniti al frame principale se l'attenzione dell'utente passa a un frame secondario cross-origin. Questo impedisce al frame principale di dedurre l'input dell'utente.

Passaggi successivi

Nel prossimo futuro sarà disponibile una serie di classi di sensori già specificate, ad esempio il sensore di luce ambientale o il sensore di prossimità. Tuttavia, grazie alla grande estensibilità del framework dei sensori generici, possiamo anticipare la comparsa di altre nuove classi che rappresentano vari tipi di sensori.

Un altro aspetto importante per il lavoro futuro è il miglioramento dell'API Generic Sensor. La specifica del sensore generico è attualmente una Candidate Recommendation, il che significa che c'è ancora tempo per apportare correzioni e introdurre nuove funzionalità di cui gli sviluppatori hanno bisogno.

Puoi aiutarci.

Le specifiche del sensore hanno raggiunto il livello di maturità Candidato per la raccomandazione, pertanto il feedback degli sviluppatori web e di browser è molto apprezzato. Facci sapere quali funzionalità vorresti aggiungere o se c'è qualcosa che vorresti modificare nell'API attuale.

Non esitare a segnalare problemi relativi alle specifiche, nonché bug per l'implementazione di Chrome.

Risorse

Ringraziamenti

Questo articolo è stato esaminato da Joe Medley e Kayce Basques.