第17章项目实战

课程目录第17章项目实战

项目实战：智能磁吸支架检测

好，咱们今天来做点实在的。前面讲了那么多霍尔传感器的原理、API、数据滤波，是时候把它们串起来了。

这个项目我特别喜欢，因为它很贴近生活。你想想看，现在很多车载支架、桌面支架都是磁吸式的。手机吸上去，自动进入导航模式或桌面模式；拿下来，自动熄屏或回到主界面。这个体验，背后就是霍尔传感器在干活。

说白了，我们要做的，就是让App能感知到：“嘿，我被吸住了！” 或者 “嘿，我被拿下来了！”

项目需求分析

先别急着写代码，咱们捋一捋需求。我个人习惯，做任何功能前先画个简单的逻辑图，把脑子里的想法倒出来。

核心需求： 实时检测手机是否被吸附在磁吸支架上，并触发相应的UI反馈。

具体来说，我们需要做到这几点：

检测吸附状态： 当磁场强度超过某个阈值，判定为“已吸附”。
检测脱离状态： 当磁场强度低于某个阈值，判定为“已脱离”。
防抖动处理： 避免因为磁场波动导致状态频繁切换。嗯，这里要注意，磁铁靠近时磁场变化很快，不加滤波的话，状态会像开关灯一样闪个不停。
UI反馈： 吸附时显示一个“已连接”的动画或图标，脱离时显示“待吸附”。

下面这张图，是我画的项目核心逻辑流程图。你看一眼，基本就明白整个程序怎么跑了。

阈值怎么定？

这是个大问题。不同的手机、不同的磁铁，磁场强度差别很大。我记得有一次帮客户调试，他的支架磁铁特别猛，传感器直接爆表了。而有些弱磁支架，数据又跟环境磁场差不多。

我的建议是：不要写死一个固定值。

我们可以做一个“自适应阈值”或者“可配置阈值”。但为了入门项目简单，我们先采用一个经验值。根据我测试过的几款主流手机（Pixel、小米、三星），当磁铁紧贴手机背面时，磁场强度通常在 200 μT ~ 800 μT 之间。而环境磁场一般只有 30 μT ~ 60 μT。

所以，我选了一个中间值：150 μT 作为吸附阈值。低于 80 μT 判定为脱离。中间留一段缓冲区间，这就是防抖动的关键。

💡 小技巧： 你可以把阈值放到 SharedPreferences 里，让用户在设置页面自己微调。不同支架的磁力不一样，给用户一个调节旋钮，体验会好很多。

代码实现：核心逻辑

好，咱们直接上代码。这部分我封装成了一个工具类 MagneticMountDetector。你拿去就能用。

public class MagneticMountDetector {
    private SensorManager sensorManager;
    private Sensor magneticSensor;
    private OnMountStateChangeListener listener;

    // 阈值定义
    private static final float THRESHOLD_ATTACH = 150.0f;  // 吸附阈值 (μT)
    private static final float THRESHOLD_DETACH = 80.0f;   // 脱离阈值 (μT)

    private boolean isAttached = false;
    private boolean isInitialized = false;

    public interface OnMountStateChangeListener {
        void onAttached();
        void onDetached();
    }

    public MagneticMountDetector(Context context, OnMountStateChangeListener listener) {
        sensorManager = (SensorManager) context.getSystemService(Context.SENSOR_SERVICE);
        this.listener = listener;
        magneticSensor = sensorManager.getDefaultSensor(Sensor.TYPE_MAGNETIC_FIELD);
    }

    public void start() {
        if (magneticSensor == null) {
            // 我曾经遇到过一些低端平板没有磁传感器，这里一定要做判空
            if (listener != null) listener.onDetached();
            return;
        }
        sensorManager.registerListener(sensorEventListener, magneticSensor, SensorManager.SENSOR_DELAY_NORMAL);
    }

    public void stop() {
        sensorManager.unregisterListener(sensorEventListener);
        isInitialized = false;
    }

    private final SensorEventListener sensorEventListener = new SensorEventListener() {
        @Override
        public void onSensorChanged(SensorEvent event) {
            if (event.sensor.getType() != Sensor.TYPE_MAGNETIC_FIELD) return;

            // 取三个轴的合成强度，这样不管手机怎么放，都能检测到
            float x = event.values[0];
            float y = event.values[1];
            float z = event.values[2];
            float magnitude = (float) Math.sqrt(x * x + y * y + z * z);

            // 第一次数据不处理，用于初始化状态
            if (!isInitialized) {
                isAttached = (magnitude > THRESHOLD_ATTACH);
                isInitialized = true;
                return;
            }

            // 状态判断：带迟滞区间，防止抖动
            if (!isAttached && magnitude > THRESHOLD_ATTACH) {
                isAttached = true;
                if (listener != null) listener.onAttached();
            } else if (isAttached && magnitude < THRESHOLD_DETACH) {
                isAttached = false;
                if (listener != null) listener.onDetached();
            }
        }

        @Override
        public void onAccuracyChanged(Sensor sensor, int accuracy) {
            // 精度变化一般不用处理，但可以打日志调试
        }
    };
}

代码解读：为什么这么写？

这段代码有几个关键点，我跟你聊聊我的设计思路。

合成强度： 我用了 sqrt(x² + y² + z²)。为什么？因为手机吸附在支架上时，角度可能是任意的。如果只取Z轴，手机横着放就检测不到了。合成强度是标量，跟方向无关，最靠谱。
迟滞区间： 吸附阈值150，脱离阈值80。中间这70 μT的区间就是缓冲区。你想想看，如果只有一个阈值，比如150，那么磁场在149和151之间波动时，状态就会疯狂切换。加了迟滞，就像开关里的“咔哒”手感，干脆利落。
第一次数据初始化： 传感器刚启动时，第一个数据可能不准。我选择跳过第一次判断，只用来初始化当前状态。这个小坑，我早期做项目时踩过，当时状态一直不对，排查了半天才发现是初始数据的问题。

UI反馈：让用户“看见”磁场

光有逻辑还不够，用户需要视觉反馈。我设计了一个简单的UI，包含一个状态图标和一段文字。

<!-- activity_main.xml 中的关键布局 -->
<LinearLayout
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:gravity="center"
    android:orientation="vertical">

    <ImageView
        android:id="@+id/iv_status_icon"
        android:layout_width="120dp"
        android:layout_height="120dp"
        android:src="@drawable/ic_mount_off" />

    <TextView
        android:id="@+id/tv_status_text"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="等待吸附..."
        android:textSize="20sp"
        android:layout_marginTop="24dp" />

    <TextView
        android:id="@+id/tv_magnetic_value"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="0 μT"
        android:textSize="14sp"
        android:textColor="#888"
        android:layout_marginTop="8dp" />
</LinearLayout>

在Activity里，我们这样更新UI：

public class MainActivity extends AppCompatActivity {
    private ImageView ivStatus;
    private TextView tvStatus, tvValue;
    private MagneticMountDetector detector;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        ivStatus = findViewById(R.id.iv_status_icon);
        tvStatus = findViewById(R.id.tv_status_text);
        tvValue = findViewById(R.id.tv_magnetic_value);

        detector = new MagneticMountDetector(this, new MagneticMountDetector.OnMountStateChangeListener() {
            @Override
            public void onAttached() {
                runOnUiThread(() -> {
                    ivStatus.setImageResource(R.drawable.ic_mount_on);
                    tvStatus.setText("已吸附");
                    tvStatus.setTextColor(getColor(R.color.green));
                });
            }

            @Override
            public void onDetached() {
                runOnUiThread(() -> {
                    ivStatus.setImageResource(R.drawable.ic_mount_off);
                    tvStatus.setText("待吸附");
                    tvStatus.setTextColor(getColor(R.color.gray));
                });
            }
        });
    }

    @Override
    protected void onResume() {
        super.onResume();
        detector.start();
    }

    @Override
    protected void onPause() {
        super.onPause();
        detector.stop();
    }
}

⚠️ 注意： 别忘了在 onPause() 里注销传感器监听。我曾经见过有人忘记注销，导致App切到后台后传感器还在跑，电量哗哗地掉。用户骂娘是小事，应用被系统杀后台就麻烦了。

调试与验证

代码写完了，怎么测？我一般用两种方法：

真机+磁铁： 找个冰箱贴或者磁吸支架，靠近手机背面摄像头附近（那里通常是霍尔传感器的位置）。观察UI变化和日志输出。
模拟器调试： Android模拟器支持模拟传感器数据。你可以通过ADB命令发送虚拟磁场值：adb shell sensor_service --set magnetic_field 200 0 0。这样没有磁铁也能调试。

我个人更推荐第一种，真实环境才能暴露问题。比如，有些手机壳带磁吸扣，会干扰检测。这些情况，模拟器是模拟不出来的。

总结一下

这个项目虽然小，但五脏俱全。它涵盖了传感器监听、数据处理、状态机设计、UI反馈这几个核心环节。你把这个吃透了，以后做任何基于霍尔传感器的功能，比如智能皮套、翻盖唤醒、磁吸配件识别，思路都是一样的。

嗯，代码不多，但每一行都有它的道理。你拿去跑一跑，改一改阈值，看看不同磁铁的反应。动手试试，比看十遍文章都管用。

📚 课程目录

项目实战：智能磁吸支架检测

项目需求分析

阈值怎么定？

代码实现：核心逻辑

代码解读：为什么这么写？

UI反馈：让用户“看见”磁场

调试与验证

总结一下