案例需求
知识点:
- 罗盘:
wx.startCompass()/wx.onCompassChange()/wx.offCompassChange()/wx.stopCompass()- 加速度计:
wx.startAccelerometer({interval})/wx.onAccelerometerChange()/wx.stopAccelerometer()- 陀螺仪:
wx.startGyroscope({interval})/wx.onGyroscopeChange()/wx.stopGyroscope()- Canvas2D 动态清屏重绘波形;
setData实时刷新页面数据;onHide生命周期释放传感器监听。
- 页面从上到下依次排列三组按钮:【启动罗盘监听】/【停止罗盘监听】、【启动加速度计】/【停止加速度计】、【启动陀螺仪】/【停止陀螺仪】。
- 每组按钮下方对应数据展示区域:
- 罗盘:方位角
direction、精度accuracy - 加速度计:X/Y/Z 三轴加速度
x、y、z - 陀螺仪:X/Y/Z 三轴角速度
x、y、z
- 罗盘:方位角
- 点击启动 / 停止按钮,页面顶部标题同步显示当前操作状态。
- ✨作业扩展:页面底部增加 Canvas 画布,启动加速度计后晃动手机,实时绘制三轴加速度波形曲线(红 X、绿 Y、蓝 Z)。
完整代码
1.app.json(webview 引擎,规避 skyline 兼容问题)

2.pages/index/index.wxml


3.pages/index/index.wxss


4.pages/index/index.js








5.app.wxss 全局样式

核心知识点
1. 传感器 API 总览
表格
| 传感器 | 启动 | 监听事件 | 注销监听 | 停止硬件 | 返回字段 |
|---|---|---|---|---|---|
| 罗盘 | wx.startCompass() | wx.onCompassChange(cb) | wx.offCompassChange() | wx.stopCompass() | direction方位角、accuracy精度 |
| 加速度计 | wx.startAccelerometer({interval}) | wx.onAccelerometerChange(cb) | wx.offAccelerometerChange() | wx.stopAccelerometer() | x/y/z三轴加速度 |
| 陀螺仪 | wx.startGyroscope({interval}) | wx.onGyroscopeChange(cb) | wx.offGyroscopeChange() | wx.stopGyroscope() | x/y/z三轴角速度 |
interval采样频率三档:
'ui'界面刷新频率(本案例使用,最平滑)'normal'普通频率,默认值'game'游戏级高频,耗电大
2. 三个 API 区别(初学最容易混)
| 调用 | 作用 |
|---|---|
startXXX | 真正打开硬件传感器,开始采集数据 |
onXXXChange | 注册监听回调,数据变化时把数据传给你 |
offXXXChange | 注销监听回调,不再收数据 |
stopXXX | 关闭硬件传感器,彻底停止采集 |
正确流程:
poststop → start → on;停止流程:stop → off。 只off不stop,硬件仍在耗电;只stop不off,回调还挂着容易重复触发。
3. 加速度波形绘制原理(作业扩展核心)
- 加速度范围约
-1 ~ +1,画布需要把数值映射到像素高度:py = 画布中心Y - 加速度值 × 缩放系数; - 用数组缓存最近 80 个采样点,超出就
shift()删掉最老的点,形成横向滚动波形; - 每次回调先
clearRect清屏,再把三个数组各画成一条折线,红 / 绿 / 蓝分别对应 X/Y/Z; - 片段式
onReady里通过createSelectorQuery拿到 canvas 节点,才能调用getContext('2d')。
4. 页面生命周期与传感器释放
onHide:页面切后台、跳到别的页面时触发,此处必须stop+off全部传感器。否则微信在小程序后台仍持续采集,手机发热、耗电飞快,是真机实测最明显的问题。
踩坑实录
坑 1:模拟器点启动,数据永远为空
模拟器是电脑软件,没有罗盘、加速度计、陀螺仪硬件,onXXXChange永不触发。传感器案例必须真机。
坑 2:真机上点启动,页面提示 “启动 XXX 功能失败”
只写fail:()=>{...}看不到原因,必须在 fail 回调里打印err.errMsg并显示到页面:
fail:(err)=>{
console.log("陀螺仪启动失败",err.errMsg);
this.setData({title:"陀螺仪失败:"+err.errMsg})
}
常见errMsg对照:
表格
| errMsg 包含 | 原因 |
|---|---|
auth deny / authorize | 权限被拒绝,系统未授权微信传感器权限 |
not support | 手机没有该传感器硬件 |
system error | 系统层限制 / 其他应用占用 |
坑 3:安卓中低端机没有陀螺仪硬件
大量千元机(红米、荣耀、OPPO 部分机型)只有加速计和方向传感器,没有真陀螺仪。表现为罗盘、加速度计正常,陀螺仪一直 fail。这属于硬件限制,代码无法解决,写博客备注即可。
坑 4:iOS / 安卓权限没有授予微信
- iOS:设置 → 微信 → 打开「运动与健身」;
- 安卓 10+:设置 → 应用管理 → 微信 → 权限 → 允许「身体传感器 / 身体活动」;
- 国产 ROM(小米 / 华为 / OPPO)还有单独「传感器权限」开关,在隐私→权限管理里。
权限被拒时,加速度计、陀螺仪会 fail,罗盘(方向)可能仍然正常。
坑 5:用「真机调试」而不是「预览」
开发者工具点【真机调试】走的是远程调试通道,部分机型 / 基础库版本在真机调试模式下会屏蔽传感器接口,返回 fail。 ✅正确做法:点工具栏【预览】扫码,或上传体验版,在手机微信里正常打开。
坑 6:重复点启动,数据异常、内存升高
多次点击 “启动” 会重复绑定onXXXChange,回调叠加上去数据翻倍。 ✅修复:启动前先off注销 + stop关闭,再start(本案例代码已做)。
坑 7:切页面后传感器还在耗电
onHide里没有关闭传感器,手机发热、电量狂掉。必须在onHide统一stop+off。
坑 8:波形画布不出线
onReady里createSelectorQuery没拿到 canvas 节点就直接跳过绘图逻辑;或drawWave里this.waveCtx为 undefined。加if(!this.waveCtx) return;保护,确认 canvas 的 id 与 wxml 一致。
坑 9:低版本基础库语法报错
res[0]?.node可选链在低版本基础库可能编译报错,改为if(!res[0] || !res[0].node) return;。
坑 10:复制 PPT 代码出现unexpected character
粘贴带入中文全角横线、括号,全部替换英文半角符号。
1956



被折叠的 条评论
为什么被折叠?



