跳转至正文

加速度计 Capacitor 插件

读取设备加速度计,用于运动检测和方向追踪

安装

bun add @capgo/capacitor-accelerometer bunx cap sync
npm、pnpm 或 yarn
  • npm install @capgo/capacitor-accelerometer
  • pnpm add @capgo/capacitor-accelerometer
  • yarn add @capgo/capacitor-accelerometer

指南

如何在 Capacitor 中使用 Accelerometer

在设备上测试

下载 Capgo App,然后扫描二维码 code。

加速度计插件预览二维码 code

使用 @capgo/capacitor-accelerometer

Capacitor 插件契约,用于访问设备加速度计。

安装

bun add @capgo/capacitor-accelerometer
bunx cap sync

bunx cap sync 将插件的原生 code 复制到你的原生项目中。每次升级插件后都要重新运行。

导入

import { CapacitorAccelerometer } from '@capgo/capacitor-accelerometer';

API 概览

方法 描述
getMeasurement 获取原生层记录的最新加速度计采样数据。
isAvailable 检查当前设备是否包含加速度计传感器。
startMeasurementUpdates 开始向 JavaScript 层流式传输加速度计更新。
stopMeasurementUpdates 停止通过 . 启动的加速度计更新流。
checkPermissions 返回当前访问运动数据的权限状态。
requestPermissions 如果平台支持,则请求访问运动数据的权限。

示例

getMeasurement()

获取原生层记录的最新加速度计采样数据。

import { CapacitorAccelerometer } from '@capgo/capacitor-accelerometer';

const result = await CapacitorAccelerometer.getMeasurement();
console.log(result);

isAvailable()

检查当前设备是否包含加速度计传感器。

import { CapacitorAccelerometer } from '@capgo/capacitor-accelerometer';

const result = await CapacitorAccelerometer.isAvailable();
console.log(result);

startMeasurementUpdates()

开始向 JavaScript 层流式传输加速度计更新。

import { CapacitorAccelerometer } from '@capgo/capacitor-accelerometer';

await CapacitorAccelerometer.startMeasurementUpdates();

stopMeasurementUpdates()

停止通过 . 启动的加速度计更新流。

import { CapacitorAccelerometer } from '@capgo/capacitor-accelerometer';

await CapacitorAccelerometer.stopMeasurementUpdates();

checkPermissions()

返回当前访问运动数据的权限状态。

import { CapacitorAccelerometer } from '@capgo/capacitor-accelerometer';

const result = await CapacitorAccelerometer.checkPermissions();
console.log(result);

requestPermissions()

如果平台支持,则请求访问运动数据的权限。

import { CapacitorAccelerometer } from '@capgo/capacitor-accelerometer';

const result = await CapacitorAccelerometer.requestPermissions();
console.log(result);

监听事件

addListener 会返回一个句柄。调用 handle.remove() 在屏幕卸载时,或者调用 CapacitorAccelerometer.removeAllListeners() 以清除所有监听器。

完整参考文档

从“使用 @capgo/capacitor-accelerometer”继续

如果你正在使用 使用 @capgo/capacitor-accelerometer 要规划 dashboard 和 API 操作,请将其连接到 @capgo/capacitor-accelerometer 关于 @capgo/capacitor-accelerometer 中的实现细节, 快速入门 有关“入门指南”中的实现细节, API 概览 关于 API Overview 中的实现细节, 简介 关于简介中的实现细节,以及 API 密钥 关于 API Keys 中的实现细节。

常见问题

加速度计插件常见问题

如何在 Capacitor 应用中安装 Accelerometer 插件?

运行 "bun add @capgo/capacitor-accelerometer"(或 "npm install @capgo/capacitor-accelerometer"),然后运行 "bunx cap sync",让 iOS 和 Android 项目拉取到原生 code。再在应用的 code 中从 "@capgo/capacitor-accelerometer" 导入。

@capgo/capacitor-accelerometer 支持 React、Vue 和 Angular 吗?

支持。Accelerometer 是一个 Capacitor 包,因此任何运行在 Capacitor 中的 Web framework 都能用,包括 Ionic、React、Vue、Angular、Svelte 和纯 JavaScript。

@capgo/capacitor-accelerometer 支持哪个 Capacitor 版本?

Capgo 插件遵循 Capacitor 的主版本号:请使用与 Capacitor 主版本号一致的插件主版本(例如插件 v8 对应 Capacitor 8)。GitHub README 中的兼容性表列出了仍在维护的版本。

@capgo/capacitor-accelerometer 是免费开源的吗?

是的。code 的源码已在 GitHub 上公开,地址是 https://github.com/Cap-go/capacitor-accelerometer/,该包可在 npm 免费安装。欢迎提交 bug 报告和 pull request。

我可以在不经过 App Store 审核的情况下更新使用了 Accelerometer 的 code 吗?

安装或升级插件会改动原生 code,因此需要重新做一次商店构建。之后,调用该插件的 JavaScript、HTML 和 CSS 改动就能通过 Capgo live updates 立即发布。

无需等待 App 审核即可发布 Accelerometer 变更

只要插件已包含在你的商店版本中,Capgo live updates 就能在几分钟内把 JavaScript、HTML 和 CSS 的改动推送给用户。

开始使用 Capgo