uniapp app 端调用 Native.js 实现安卓陀螺仪数据采集与实战解析-CSDN博客

1. 为什么我们需要 Native.js？uniapp 获取陀螺仪的“无奈”与“破局”

如果你正在用 uniapp 开发一个需要用到陀螺仪的应用，比如一个手机 AR 试戴眼镜的功能，或者一个体感控制的小游戏，你大概率会兴冲冲地去翻看 uni-app 的官方 API 文档，然后找到 uni.startGyroscope 这个方法。但很快，你就会发现一个让人有点沮丧的事实：这个方法在 App 端 是不被支持的。文档里通常会标注“H5 支持，App 端不支持”或者类似的话。这就像你拿到了一把万能钥匙，却发现最重要的那扇门打不开。

为什么会出现这种情况？这其实和 uniapp 的跨平台特性有关。uniapp 的 API 设计目标是“一套代码，多端运行”，它优先保证的是那些在各平台（H5、小程序、App）上都有高度一致实现的功能。像陀螺仪这类硬件传感器，在不同操作系统（尤其是 iOS 和 Android）上的底层调用方式、权限管理、甚至数据格式都可能存在差异。为了保持框架的简洁和通用性，uniapp 官方暂时没有在 App 端封装一个统一的陀螺仪 API。但这绝不意味着在 uniapp 的 App 里就用不了陀螺仪了，这只是意味着我们需要换一条路走。

这条路，就是 Native.js。你可以把它理解成 uniapp 留给开发者的一个“后门”或者“超级桥梁”。它允许我们在 JavaScript 代码里，直接调用 Android 的原生 Java API 或 iOS 的 Objective-C API。对于前端开发者来说，这简直是个神器——我们不需要去完整地学习 Java 或 Swift 开发，也不需要去改动原生工程，就能在熟悉的 Vue/JS 环境里，直接操作手机底层的硬件能力。所以，当 uni.startGyroscope 此路不通时，Native.js 就是我们实现安卓陀螺仪数据采集的“破局”关键。接下来，我就带你从零开始，手把手搭建这座桥，把陀螺仪的数据稳稳地拿到我们自己的应用里来。

2. 实战第一步：搭建环境与理解核心 Java 类

在开始写代码之前，我们得先把“工具箱”准备好，并搞清楚我们要用到的几个核心“零件”是什么。别担心，这个过程一点也不复杂。

首先，确保你的开发环境是 OK 的。你需要安装好 HBuilderX（这是 uniapp 的官方 IDE），并且已经创建了一个 uni-app 项目，运行到安卓 App 基座是没问题的。这些是基础，我就不赘述了。我们重点来看 Native.js 需要接触的安卓原生部分。

陀螺仪属于安卓传感器框架的一部分，我们要打交道的主要是四个 Java 类，我会用最直白的话解释它们分别是干嘛的：

android.content.Context (上下文)：这是安卓应用的“环境信息”提供者。几乎所有获取系统服务的操作都需要一个 Context 对象。在 uniapp 里，我们可以通过 plus.android.runtimeMainActivity() 拿到当前页面的 Activity（它是 Context 的一种），这就是我们的入口点。
android.hardware.SensorManager (传感器管理器)：顾名思义，它是所有传感器的“大总管”。我们需要通过 Context 拿到这个管理器的实例，然后才能去问它：“喂，把陀螺仪传感器给我用用。”
android.hardware.Sensor (传感器对象)：这个就是具体的传感器了，比如陀螺仪、加速度计、光线传感器等。我们从 SensorManager 那里获取到的就是一个 Sensor 对象，它包含了传感器的类型、名称、精度等信息。
android.hardware.SensorEvent (传感器事件)：当传感器数据发生变化时，系统会产生一个 SensorEvent 对象。这个对象里就包裹着我们最关心的东西——实时数据。它是一个数组，对于陀螺仪来说，通常包含三个值，分别代表绕 X、Y、Z 轴旋转的角速度（单位一般是弧度/秒）。

理解这四个类的关系至关重要：Context -> SensorManager -> Sensor -> SensorEvent。我们的代码流程也将严格遵循这个路径。在 Native.js 中，我们不需要自己写 Java 代码，而是用 plus.android.importClass 方法把这些类“引入”到我们的 JavaScript 运行环境里，让 JS 能认识并操作它们。这就好比给你的 JS 引擎安装了一个“Java 类翻译器”。

3. 核心代码拆解：从初始化到数据获取的每一步

光说不练假把式，我们现在就进入最核心的编码环节。我会把代码拆成几大块，并配上详细的解释，保证你能看懂每一行是干什么的。

3.1 初始化与传感器检测

我们通常在 Vue 组件的 mounted 生命周期里初始化陀螺仪。第一步，就是引入必要的类并检查设备是否支持。

async initGyroscope() {
  try {
    // 1. 获取安卓主Activity（作为Context）
    const main = plus.android.runtimeMainActivity();

    // 2. 导入关键的Java类
    const Context = plus.android.importClass("android.content.Context");
    const SensorManager = plus.android.importClass("android.hardware.SensorManager");
    const Sensor = plus.android.importClass("android.hardware.Sensor");
    // SensorEvent 类在创建监听器时也会用到，这里可以先导入
    const SensorEvent = plus.android.importClass("android.hardware.SensorEvent");

    // 3. 获取传感器管理服务
    const sensorManager = main.getSystemService(Context.SENSOR_SERVICE);

    // 4. 获取默认的陀螺仪传感器
    const gyroSensor = sensorManager.getDefaultSensor(Sensor.TYPE_GYROSCOPE);

    // 5. 关键！判断设备是否支持陀螺仪
    if (!gyroSensor) {
      uni.showToast({
        title: "当前设备不支持陀螺仪功能",
        icon: "none"
      });
      return; // 不支持就直接返回，避免后续错误
    }

    // ... 如果支持，继续往下走创建监听器
  } c