6、磁力计与方向传感器：地磁场原理、电子罗盘实现、getOrientation()方法详解、磁干扰校准。
各位同学，今天我们来聊聊手机里那个看不见摸不着，却一直在默默工作的传感器——磁力计。说白了，它就是手机的“指南针”。你打开地图App，那个小箭头能指向北，靠的就是它。
我刚开始做Android传感器开发时，觉得磁力计不就是读个数据嘛，简单。结果第一次做电子罗盘，手机转了一圈，指针乱跳，差点把测试同事转晕了。嗯，这里面的坑，我今天一次性给你讲透。
6.1 地磁场原理：地球本身就是个大磁铁
先说说地磁场。地球内部有液态的铁镍合金，它们流动起来，产生了磁场。这个磁场从地理南极附近出来，从地理北极附近进去。所以，磁针的N极指向地理北极附近——注意，是“磁北极”，不是“地理北极”。
地磁场强度大概在25到65微特斯拉之间，具体看你在地球哪个位置。我当年在深圳测过，大概是45微特斯拉左右。到了北京出差，数值就变了。这个差异，在做高精度定位时得考虑进去。
关键点：地磁场方向是三维的。水平分量指向磁北，垂直分量指向地面（北半球向下，南半球向上）。手机里的磁力计，测的就是这三个轴的分量。
6.2 电子罗盘实现：从原始数据到方向角
电子罗盘的核心，就是把磁力计的原始数据转换成方位角。怎么做？我习惯分三步走：
- 读取磁力计数据：从SensorManager获取TYPE_MAGNETIC_FIELD的原始值。
- 结合加速度计：用加速度计数据做姿态补偿，把手机倾斜的影响去掉。
- 计算方位角：用getOrientation()得到最终的方向。
你想想看，如果手机平放，磁力计的X和Y轴就能直接算出角度。但手机是拿在手里的，总有倾斜。这时候加速度计就派上用场了——它告诉我们手机的姿态，然后我们就能把磁力计数据“投影”到水平面上。
// 获取磁力计和加速度计数据
SensorManager.getRotationMatrix(R, I, gravityValues, magneticValues);
// R是旋转矩阵，I是倾斜矩阵
float[] orientation = new float[3];
SensorManager.getOrientation(R, orientation);
// orientation[0]是方位角，单位弧度
float azimuth = (float) Math.toDegrees(orientation[0]);这段代码看起来简单，但实际项目中我踩过坑。getRotationMatrix()要求两个数组的长度至少是9和3，而且数据必须是经过低通滤波的。我曾经直接拿原始数据往里塞，结果方位角跳得像心电图。
我的习惯：在调用getRotationMatrix()之前，先对磁力计和加速度计数据做滑动平均滤波。窗口大小取5到10个样本，效果就很好了。
6.3 getOrientation()方法详解：别被弧度坑了
getOrientation()这个方法，说白了就是把旋转矩阵转换成三个欧拉角：方位角（azimuth）、俯仰角（pitch）、横滚角（roll）。返回值是弧度，范围分别是：
| 角度 | 范围（弧度） | 范围（度） | 说明 |
|---|---|---|---|
| azimuth | -π 到 π | -180° 到 180° | 0°是正北，顺时针为正 |
| pitch | -π/2 到 π/2 | -90° 到 90° | 手机顶部抬起为正 |
| roll | -π 到 π | -180° 到 180° | 手机左侧抬起为正 |
注意，azimuth返回的是-180到180度。如果你需要0到360度的值，记得做转换：
if (azimuth < 0) {
azimuth += 360;
}嗯，这里要注意。getOrientation()的坐标系是Y轴指向磁北，X轴指向东。跟地图上常用的“北向上”坐标系不一样。我刚开始做地图叠加时，发现箭头方向总差90度，查了半天才发现是坐标系理解错了。
6.4 磁干扰校准：别让手机壳毁了你的罗盘
磁干扰是电子罗盘最大的敌人。干扰源分两种：
- 硬铁干扰：来自手机内部的永磁体，比如扬声器、马达、摄像头模组。这些干扰是固定的，可以校准掉。
- 软铁干扰：来自铁磁性材料，比如手机中框、电池。这些干扰会改变磁场方向，校准起来麻烦一些。
我曾经遇到一个案例：用户反馈罗盘不准，排查了半天，发现是他用的手机壳带磁吸支架。拆掉手机壳，数据立马正常。所以，做电子罗盘的产品，一定要在说明里提醒用户远离磁源。
避坑指南：Android系统自带的校准方法是让用户画“8”字。但这个方法对硬铁干扰有效，对软铁干扰效果有限。如果你的产品对精度要求高，建议自己做校准算法。
校准的数学原理很简单：理想情况下，磁力计三个轴的数据在三维空间里应该落在一个球面上。硬铁干扰会让球心偏移，软铁干扰会把球面压成椭球。校准的目标就是找到球心偏移量和椭球参数，然后做补偿。
我常用的校准流程：
- 让用户拿着手机，在空间里转几圈，采集足够多的样本。
- 用最小二乘法拟合球面或椭球，得到校准参数。
- 把校准参数保存到SharedPreferences，下次启动直接加载。
// 硬铁校准：减去偏移量
float calibratedX = rawX - hardIronOffsetX;
float calibratedY = rawY - hardIronOffsetY;
float calibratedZ = rawZ - hardIronOffsetZ;
// 软铁校准：乘以缩放矩阵
float finalX = calibratedX * softIronScaleX;
float finalY = calibratedY * softIronScaleY;
float finalZ = calibratedZ * softIronScaleZ;这段代码看起来简单，但实际项目中，校准参数的采集时机和用户交互设计很重要。我建议在App首次启动时引导用户做一次校准，之后每隔一段时间提示用户重新校准。
核心总结：磁力计开发，说白了就是三件事——读懂地磁场、算对方向角、搞定校准。其中校准是最容易出问题的环节，也是最能体现工程师水平的地方。
好了，这一章的内容就到这里。磁力计开发，说难不难，说简单也不简单。关键是把原理吃透，把校准做好。下次你打开地图App，看到那个稳稳指向北的箭头，就知道背后有多少门道了。