整理網上資料並加上自己的驗證後,寫成這份 HTML5 搖一搖功能的入門筆記,作為技術備份。
DeviceMotionEvent 是 HTML5 支援的重力感應事件。相關有三個:
deviceorientation:提供裝置的物理方向資訊,以一連串本地座標系的旋轉角表示。
devicemotion:提供裝置的加速度資訊,以裝置座標系中的笛卡兒座標表示,並包含自轉速率。若可行,事件應提供裝置重心處的加速度資料。
compassneedscalibration:用於通知網頁需要以羅盤校正上述事件。
註冊接收器:
window.addEventListener("deviceorientation", function (event) {
// 處理 event.alpha、event.beta 及 event.gamma
}, true);
回傳的參數形如:
{ alpha: 90, beta: 0, gamma: 0 };
若要取得羅盤指向,可以簡單地用 360 度減去 alpha。若裝置平行於水平表面,其羅盤指向即為 (360 - alpha)。
若使用者手持裝置、螢幕處於垂直平面且頂端朝上,beta 的值為 90,alpha 與 gamma 無關。若使用者面向 alpha 角度、螢幕處於垂直面且頂端朝右,則方向資訊如下:
{ alpha: 270 - alpha, beta: 0, gamma: 90 };
註冊接收器:
window.addEventListener("devicemotion", function (event) {
// 處理 event.acceleration、event.accelerationIncludingGravity、
// event.rotationRate 和 event.interval
}, true);
舉個例子:把裝置放在車輛上,螢幕處於垂直平面、頂端朝上、面向車尾。車輛以速度 v 向右側進行半徑為 r 的轉彎,裝置在位置 x 處記錄到的資料為:
{
acceleration: { x: v^2/r, y: 0, z: 0 },
accelerationIncludingGravity: { x: v^2/r, y: 0, z: 9.81 },
rotationRate: { alpha: 0, beta: 0, gamma: -v/r*180/pi }
};
這裡有個重要區分:acceleration 是「不含重力」的純加速度,而 accelerationIncludingGravity 則把重力加速度疊加進去(靜止時 z 軸約為 9.81)。做搖一搖偵測時,通常採用後者,因為它在裝置靜止時仍有穩定的基準值可供比較。
if (window.DeviceMotionEvent) {
window.addEventListener('devicemotion', YaoYiYao, false);
}
var speed = 30;
var x = y = z = lastX = lastY = lastZ = 0;
function YaoYiYao(eventData) {
var acceleration = eventData.accelerationIncludingGravity;
x = acceleration.x;
y = acceleration.y;
z = acceleration.z;
if (Math.abs(x - lastX) > speed || Math.abs(y - lastY) > speed || Math.abs(z - lastZ) > speed) {
// 簡單的搖一搖觸發程式碼
alert(1);
}
lastX = x;
lastY = y;
lastZ = z;
}
首先判斷瀏覽器是否支援該事件,避免在不支援的環境中白做工。YaoYiYao 負責偵測搖動:每次事件觸發時取得三軸的加速度值,與上一次記錄的值相比較。若任一軸的變化量超過門檻 speed,就判定為搖動狀態,在 if 區塊中放入要執行的邏輯即可。
最後記得把目前值複製給 last 系列變數,作為下一次比較的基準。
門檻值 30 只是示例,實際部署時需要依裝置與使用情境調整:設太低會被走路、搭車的正常晃動誤觸;設太高則需要很用力搖才觸發。
更穩健的做法是加入連續性判斷——要求在短時間內(例如 500 毫秒)偵測到三到四次超過門檻的變化,才算一次有效搖動。單次樣本很容易因手抖而誤判。
另外必須提醒兩點限制。第一,這些感測 API 在 iOS 上需要使用者明確授權,自 iOS 13 起必須呼叫 DeviceMotionEvent.requestPermission(),且該呼叫必須發生在使用者的點擊事件中,無法在頁面載入時自動取得。第二,桌面瀏覽器多半不支援或不回傳有效資料,因此務必做好不支援時的降級方案,例如改提供一個可點擊的按鈕。
搖一搖的實作骨架就是「監聽加速度變化、超過門檻即觸發」,技術門檻並不高。真正需要花心思的是門檻調校、誤觸過濾,以及跨平台的權限處理——這些細節決定了功能在真實環境中好不好用。