手機搖一搖很酷,但直接照抄範例程式碼上專案,很快就會遇到兩個問題:同一個手勢被觸發十幾次,以及動畫還沒播完就又被打斷。本文記錄把 DeviceMotionEvent 重新封裝,並用一個開關旗標解決重複觸發的完整過程。
if (window.DeviceMotionEvent) {
var speed = 25; // 觸發門檻
var x = y = z = lastX = lastY = lastZ = 0;
window.addEventListener('devicemotion', function () {
var acceleration = event.accelerationIncludingGravity;
x = acceleration.x;
y = acceleration.y;
z = acceleration.z;
if (Math.abs(x - lastX) > speed || Math.abs(y - lastY) > speed) {
// 在這裡放搖一搖之後要執行的邏輯
donghua();
}
lastX = x; lastY = y; lastZ = z;
}, false);
}
原理很單純:accelerationIncludingGravity 是「含重力的加速度」,靜止時三軸量到的就是重力本身。取前後兩帧的差值,若某軸變化超過門檻,就判定為一次搖動。
實際上線後發現,一次自然的搖晃會觸發 devicemotion 事件好幾十次(這個事件的頻率通常在每秒 60 次上下),於是 donghua() 被連續呼叫,動畫瘋狂重疊。更糟的是「動畫沒播完就又被觸發」,畫面直接錯亂。
解法很直覺——宣告一個全域旗標 f,動畫開始時設為 0 鎖住,動畫的 callback 裡再設回 1 解鎖。
var f = 1;
function donghua() {
// 動畫事件
$(".img").animate({ left: '0', opacity: '1' }, 700, function () { f = 1; });
}
if (window.DeviceMotionEvent) {
var speed = 25;
var x = y = z = lastX = lastY = lastZ = 0;
window.addEventListener('devicemotion', function () {
var acceleration = event.accelerationIncludingGravity;
x = acceleration.x;
y = acceleration.y;
z = acceleration.z;
if (Math.abs(x - lastX) > speed || Math.abs(y - lastY) > speed) {
if (f == 1) {
donghua();
f = 0;
}
}
lastX = x; lastY = y; lastZ = z;
}, false);
}
旗標法解決了核心問題,但如果要寫進正式專案,建議再補強這幾點:
一、改用 debounce 加冷卻時間。旗標只在動畫期間鎖住,動畫結束後若使用者仍持續晃動,會立刻再觸發一次。加上時間冷卻更穩:
var last = 0, COOLDOWN = 1500;
function onMotion(e) {
var now = Date.now();
if (now - last < COOLDOWN) { return; }
var a = e.accelerationIncludingGravity;
var force = Math.abs(a.x) + Math.abs(a.y) + Math.abs(a.z);
if (force > 30) {
last = now;
donghua();
}
}
window.addEventListener('devicemotion', onMotion, false);
二、記得 requestPermission。iOS 13 以後,Safari 要求必須在使用者點擊手勢中主動呼叫 DeviceMotionEvent.requestPermission() 才能取得感測資料,否則事件永遠不會觸發:
document.getElementById('btn').addEventListener('click', async function () {
if (typeof DeviceMotionEvent.requestPermission === 'function') {
var res = await DeviceMotionEvent.requestPermission();
if (res !== 'granted') { return; }
}
window.addEventListener('devicemotion', onMotion, false);
});
三、必須在 HTTPS 下執行。與地理位置一樣,感測器 API 在不安全內容中是被瀏覽器封鎖的。
四、桌面端要給替代方案。桌機沒有重力感測器,devicemotion 完全不會觸發。務必保留一個點擊或鍵盤可達的按鈕走同一條 donghua() 流程,這既是相容性問題,也是可無障礙的基本要求。
把 accelerationIncludingGravity 換成 acceleration(不含重力)也值得一試,後者在裝置靜止時接近 0,判斷「晃動」有時更乾淨,但部分 Android 瀏覽器不會提供這個欄位,使用前要做特性偵測。