HTML5 有個常被低估的特性叫 DeviceOrientation。它把底層的方向感測器與運動感測器做了一層高階封裝,並以 DOM 事件的形式暴露出來,讓我們用幾行 JavaScript 就能讀取手機的姿態與加速度。
deviceOrientation——封裝方向感測器的資料。手機靜止時,它能告訴你機身所處的角度、方位與朝向。做成電子指南針、水平儀很合適。
deviceMotion——封裝運動感測器的資料。手機在動的時候,它能給你加速度與旋轉速率。重力感應球、抽獎轉盤、以及本文要做的搖一搖,都靠它。Opera 早期的 H5 體驗版裡那個重力感應球範例,就是監聽 DeviceOrientation API 做出來的。
這個事件回傳設備的加速度與旋轉資訊。加速度資料分成三個軸:
由於部分裝置沒有硬體能濾除重力,事件會提供兩個屬性:accelerationIncludingGravity(含重力的加速度)與 acceleration(排除重力後的加速度)。做搖一搖時抓前者即可,因為我們要的量的是「手機被甩動的劇烈程度」,重力本身就是一個穩定的參考基準。
先做一次能力偵測,不支援的裝置要有降級處理:
if (window.DeviceMotionEvent) {
window.addEventListener('devicemotion', deviceMotionHandler, false);
}
function deviceMotionHandler(eventData) {
var acceleration = eventData.accelerationIncludingGravity;
}
var SHAKE_THRESHOLD = 3000; // 搖動閾值
var last_update = 0; // 上次取樣時間
var x, y, z, last_x, last_y, last_z;
function deviceMotionHandler(eventData) {
var acceleration = eventData.accelerationIncludingGravity;
if (!acceleration) return;
var curTime = new Date().getTime();
// 固定時間窗取樣,避免每個感測器 tick 都計算
if ((curTime - last_update) > 100) {
var diffTime = curTime - last_update;
last_update = curTime;
x = acceleration.x;
y = acceleration.y;
z = acceleration.z;
// 三軸加速度變化量的絕對值總和,換算為速度
var speed = Math.abs(x + y + z - last_x - last_y - last_z) / diffTime * 10000;
if (speed > SHAKE_THRESHOLD) {
alert("shaked!");
// TODO: 在此接上真正的業務邏輯
}
last_x = x;
last_y = y;
last_z = z;
}
}
一、取樣間隔。devicemotion 的觸發頻率可達每秒 60 次以上,若每次都算,除了浪費效能也容易被雜訊誤觸。用 100 毫秒的時間窗做降頻,是兼顧反應速度與穩定度的折衷。
二、速度公式。Math.abs(x + y + z - last_x - last_y - last_z) / diffTime * 10000 這行的意思是:把三軸目前的加速度加總,減去上一次的加總,取絕對值後除以經過的時間,再乘上一個放大係數。它衡量的是「加速度變得多快」。使用者真正甩動手機時,這個值會瞬間暴增;而走路、放在口袋裡的規律晃動,變化率則溫和得多。
三、閾值。SHAKE_THRESHOLD 需要依實機調整。設太高會搖不出來,設太低則走路就觸發。建議先在目標機型上實測,印出 speed 的分布,取一個明顯高於日常活動、又低於刻意甩動的數值。註意力 also 要放在「不能把走路的正常運動誤判成搖一搖」這一點上。
必須走 HTTPS。感測器 API 已被歸類為需要安全內容的功能,HTTP 頁面完全不會觸發。
iOS 13 以後要主動請求授權。而且必須在使用者點擊手勢的同步流程中呼叫,否則會被瀏覽器攔下:
if (typeof DeviceMotionEvent.requestPermission === 'function') {
DeviceMotionEvent.requestPermission()
.then(function (state) {
if (state === 'granted') {
window.addEventListener('devicemotion', deviceMotionHandler, false);
}
})
.catch(console.error);
}
記得移除監聽。頁面切到背景時應該取消綁定,避免持續消耗電量:
document.addEventListener('visibilitychange', function () {
if (document.hidden) {
window.removeEventListener('devicemotion', deviceMotionHandler);
} else {
window.addEventListener('devicemotion', deviceMotionHandler, false);
}
});
把這三件事處理好,再將 alert("shaked!") 換成真正的業務邏輯,一個可用的網頁版搖一搖就完成了。