uni-app传感器API：陀螺仪与加速度计

在移动应用开发中，传感器API提供了对设备硬件（如陀螺仪和加速度计）的访问，使得开发者能够创建具有交互性和实时反馈的应用程序。在uni-app框架下，通过集成uni-sensor库，可以方便地在微信小程序、支付宝小程序等场景中利用陀螺仪和加速度计的功能。

1. 陀螺仪与加速度计简介

陀螺仪是一种测量设备，用于检测设备的角速度和旋转运动。它对于游戏开发、虚拟现实（VR）、增强现实（AR）应用以及导航系统来说至关重要。加速度计则用于检测设备的线性加速度，通常用于确定设备的倾斜角度或方向变化。

2. uni-sensor库使用

2.1 安装uni-sensor库

首先，确保你的uni-app项目已经配置好npm环境。在项目根目录下运行以下命令来安装uni-sensor库：

npm install --save @dcloudio/uni-sensor

2.2 引入并初始化

在你的小程序页面或组件中引入uni-sensor库，并在页面的生命周期函数中初始化传感器权限：

import { initSensor } from '@dcloudio/uni-sensor';

uni.ready(() => {
  initSensor({
    type: 'gyroscope', // 或者 'accelerometer'
    success: () => {
      console.log('Sensor initialized successfully.');
    },
    fail: (error) => {
      console.error('Failed to initialize sensor:', error);
    }
  });
});

2.3 监听数据

一旦传感器初始化成功，你可以监听陀螺仪或加速度计的数据变化：

陀螺仪数据监听

const gyroscopeData = [];

uni.onGyroscopeChange((event) => {
  const { x, y, z } = event;
  gyroscopeData.push({ x, y, z });
  console.log(`Gyroscope data: (${x}, ${y}, ${z})`);
});

// 每次获取前10条数据
uni.offGyroscopeChange();
uni.onGyroscopeChange((event) => {
  if (gyroscopeData.length > 10) {
    gyroscopeData.shift();
  }
  const { x, y, z } = event;
  gyroscopeData.push({ x, y, z });
  console.log(`Gyroscope data: (${x}, ${y}, ${z})`);
});

加速度计数据监听

const accelerometerData = [];

uni.onAccelerometerChange((event) => {
  const { x, y, z } = event;
  accelerometerData.push({ x, y, z });
  console.log(`Accelerometer data: (${x}, ${y}, ${z})`);
});

// 每次获取前10条数据
uni.offAccelerometerChange();
uni.onAccelerometerChange((event) => {
  if (accelerometerData.length > 10) {
    accelerometerData.shift();
  }
  const { x, y, z } = event;
  accelerometerData.push({ x, y, z });
  console.log(`Accelerometer data: (${x}, ${y}, ${z})`);
});

3. 示例应用：倾斜感应游戏

下面是一个简单的倾斜感应游戏示例，玩家可以通过倾斜手机控制角色移动：

import { initSensor } from '@dcloudio/uni-sensor';
import { addEventListener } from 'lodash';

uni.ready(() => {
  initSensor({
    type: 'accelerometer',
    success: () => {
      console.log('Sensor initialized successfully.');
      startGame();
    },
    fail: (error) => {
      console.error('Failed to initialize sensor:', error);
    }
  });
});

function startGame() {
  let xAccel = 0;
  let yAccel = 0;

  const handleAccelerometerChange = (event) => {
    xAccel = event.x;
    yAccel = event.y;
    movePlayer();
  };

  uni.onAccelerometerChange(handleAccelerometerChange);

  function movePlayer() {
    // 根据x轴和y轴的加速度值调整玩家的位置或速度
    // 这里只是一个示例，实际实现可能更复杂
    console.log(`Moving player with acceleration: (${xAccel}, ${yAccel})`);
  }

  // 游戏结束时清理事件监听器
  setTimeout(() => {
    uni.offAccelerometerChange(handleAccelerometerChange);
  }, 5000);
}

通过上述示例，你可以看到如何利用uni-app中的传感器API实现基本的陀螺仪和加速度计功能。这为开发者提供了丰富的可能性，包括但不限于游戏控制、导航应用、健康监测等多种应用场景。