Wéi benotzen ech Orientéierungssensoren a JavaScript mat Gyro.js

Léiert an dësem Artikel wéi mir einfach den In-Browser Gyroskop an den Accelerometer fir de Site Header benotzt hunn JS Republik (ënner Handy natierlech) merci un Gyro.js.

Kleng Erënnerung

Telefon XNUMXd Landmark
(Quell: http://www.alsacreations.com/tuto/lire/1501-api-device-orientation-motion-acceleration.html)
 
Ier Dir d'Erklärungen iwwer hir Benotzung am Browser starten, kucke mer séier wat dës Sensoren sinn.
Ären Handy benotzt der eng fir seng Orientéierung am Weltraum ze kennen, gëtt dës Orientéierung no Alpha, Beta a Gamma ausgedréckt, dräi Rotatiounswinkelen a Grad ëm d'Z, X an Y Achs.accelerometer gëtt benotzt fir d'Beweegunge vun Ärem Telefon a Meter / Sekonn² ze moossen (Beschleunigungsmessung). Kombinéiert kënnen dës zwee Sensoren dofir d'Beschleunigung vun den Rotatiounen vum Apparat moossen.
 
 

Fall (net sou) einfach

An HTML5 ginn et zwou APIen fir Miessunge vun dëse Sensoren ofzeruffen: d' deviceorientation API an d' devicemotion API . Déi éischt liest d'Orientéierung vum Telefon of (Alpha, Beta, Gamma), an déi zweet liest och d'Bewegungsbeschleunigung of. Ufanks kënnen all néideg Informatioune mat e puer Zeilen JavaScript kritt ginn:

window.addEventListener('devicemotion', (eventData) => {
    console.log(`
        Angle Alpha : ${eventData.rotationRate.alpha}
        Angle Beta : ${eventData.rotationRate.beta}
        Angle Gamma : ${eventData.rotationRate.gamma}
        Accélération en X : ${eventData.accelerationIncludingGravity.x}
        Accélération en Y : ${eventData.accelerationIncludingGravity.Y}
        Accélération en Z : ${eventData.accelerationIncludingGravity.Z}
    `);
}, false);

Am Hibléck vun der Einfachheet vun der API, et schéngt also net néideg eng Bibliothéik ze benotzen! Gutt, et ass net sou einfach well seng Notzung e puer Subtletien erfuerdert déi op den éischte Bléck net offensichtlech sinn.
Déi éischt a wahrscheinlech déi wichtegst ass d'Kalibrierung. Tatsächlech fënnt den "neutralen" Zoustand vun Äre Sensoren statt wann den Telefon stationär ass a flaach op enger horizontaler Uewerfläch plazéiert ass. Wéi och ëmmer, meeschtens benotzt Dir Ären Telefon am Portrait méi oder manner mat Ärem Gesiicht. Et ass also néideg eng Kalibrierung auszeféieren, fir ze berücksichtegen datt déi "neutral" Positioun déi ass déi den Telefon beim Luede vun der Säit huet an déi naiv Approche wier einfach eng Subtraktioun wéi dës ze maachen:

let initialOrientation = null;
window.addEventListener('devicemotion', (eventData) => {
    const r = eventData.rotationRate;
    initialOrientation = initialOrientation || Object.assign({}, r); // first time
    console.log(`
        Angle calibré Alpha : ${r.alpha - initialOrientation.alpha }
        Angle calibré Beta : ${r.beta - initialOrientation.beta}
        Angle calibré Gamma : ${r.gamma -initialOrientation.gamma}
    `);
}, false);

Awer wéi gesot @yvt dans Jong Fro am Gyro.js Projet ass dës Approche falsch!
Hien erkläert, datt de Euler Wénkel benotzt fir d'Orientéierung vum Telefon ze ginn, kënnen net kombinéiert ginn wann se op zwou verschidden Achsen duerch eng einfach Zousatz oder Subtraktioun handelen. An datt wa mir wëllen dës Manipulatioun ze maachen, eng elegant Manéier et ze maachen ass de Quaterniounen. Ech loossen Iech d'Ëmsetzung vun der Kalibrierung genéissen fir déi manner mathematesch: Fusioun d'Pull Ufro
Gyro.js geréiert och d'Präsenz Detektioun vun HTML5 APIs fir Iech, a füügt e "Pull" API uewen op, wat Iech erlaabt Iech déi lescht bekannte Miessunge vun de Sensoren op Ufro ze recuperéieren. Ganz praktesch Saach wann Dir benotzt der requestAnimationFrame wéi mir an der Fortsetzung.

Benotzt Gyro.js

Gyro.js ass éischter e Skript wéi eng Bibliothéik, erstallt vum Tom Gallacher ; den Utility enthält nëmmen e puer Methoden an Eegeschaften:

  • gyro.frequency = 500 // Periodizitéit bei där de Skript den Event Callback rifft
  • gyro.getOrientation() // gëtt déi aktuell Miessunge zréck
  • gyro.calibrate () // calibrate der zréck Miessunge
  • gyro.startTracking(function(o){...}) // Start de periodesche Uruff un den Event-Réckruff
  • gyro.stopTracking () // stoppen periodesch Uruff un Event Callback
  • gyro.hasFeature('devicemotion') // kontrolléiert ob de Browser MozOrientation, devicemotion oder deviceorientation ënnerstëtzt
  • gyro.getFeatures() // gëtt d'APIs vun dësen ënnerstëtzt Sensoren zréck

No verschiddene Versich hu mir déi bescht Resultater erreecht andeems mir net de periodesche Callback vun der Gyro.js API benotzt hunn, mä éischter den ` requestAnimationFrame` . Dëst erméiglecht eng reibungslos Associatioun vun der Bewegung mat der Orientéierung vum Telefon. Eng vereinfacht Ëmsetzung vun dësem Konzept gesäit sou aus:

gyro.stopTracking(); // Stop periodic calls
gyro.calibrate(); // Calibrate measurement during the page loading
const speed = 0.01; // A arbitrary speed ...
let lastTimestamp = null;
const refresh = function(timestamp) {
    if (lastTimestamp !== null) { // execute only if timestamp is valued
        const delay = timestamp - lastTimestamp; // duration since the last call
        const o = gyro.getOrientation(); // retrieves the last measures
        const step = speed * delay;
        // Apply step on the background-position in our example, but
        // you can use directly the angles for a CSS rotation property
        // for instance.
    }
    lastTimestamp = timestamp; // save current timestamp for the next call
    window.requestAnimationFrame(refresh); // call for the next refresh (max 60 times per seconde)
};
window.requestAnimationFrame(refresh); // first call

Ech recommandéieren déi zréck Miessunge ofzeschléissen well se déi ganzen Zäit wesentlech änneren,
och wann den Telefon stationär ass. Dëst wäert ongewollt Shake- oder Bewegungseffekter vermeiden.

D'Ennresultat gesäit esou aus:
Plënneren JS-Republik Header op Handy