使用 @capgo/capacitor-light-sensor
Capacitor 插件，用于访问设备的环境光传感器。
安装
bun add @capgo/capacitor-light-sensor
bunx cap sync
bunx cap sync 将插件的原生 code 复制到你的原生项目中。每次升级插件后都要重新运行。
导入
import { LightSensor } from '@capgo/capacitor-light-sensor';
API 概览
| 方法 | 描述 |
|---|---|
isAvailable |
检查当前设备是否支持光传感器。在尝试使用传感器之前，务必先检查其可用性。 |
start |
开始监听光传感器更新。这将按照指定的间隔开始传感器测量。使用 addListener 来接收传感器数据。 |
stop |
停止监听光传感器更新。这将关闭传感器以节省电量。 |
checkPermissions |
检查高采样率传感器的当前权限状态。在 Android 12+ 上，若传感器更新间隔低于 200ms，则需要 HIGH_SAMPLING_RATE_SENSORS 权限。 |
requestPermissions |
请求高采样率传感器的权限。在 Android 12+ 上，这将请求 HIGH_SAMPLING_RATE_SENSORS 权限。 |
示例
isAvailable()
检查当前设备是否支持光传感器。在尝试使用传感器之前，务必先检查其可用性。
import { LightSensor } from '@capgo/capacitor-light-sensor';
const { available } = await LightSensor.isAvailable();
start()
开始监听光传感器更新。这将按照指定的间隔开始传感器测量。使用 addListener 来接收传感器数据。
import { LightSensor } from '@capgo/capacitor-light-sensor';
await LightSensor.start({ updateInterval: 500 });
stop()
停止监听光传感器更新。这将关闭传感器以节省电量。
import { LightSensor } from '@capgo/capacitor-light-sensor';
await LightSensor.stop();
checkPermissions()
检查高采样率传感器的当前权限状态。在 Android 12+ 上，若传感器更新间隔低于 200ms，则需要 HIGH_SAMPLING_RATE_SENSORS 权限。
import { LightSensor } from '@capgo/capacitor-light-sensor';
const status = await LightSensor.checkPermissions();
requestPermissions()
请求高采样率传感器的权限。在 Android 12+ 上，这将请求 HIGH_SAMPLING_RATE_SENSORS 权限。
import { LightSensor } from '@capgo/capacitor-light-sensor';
const status = await LightSensor.requestPermissions();
监听事件
addListener 会返回一个句柄。调用 handle.remove() 在屏幕卸载时，或者调用 LightSensor.removeAllListeners() 以清除所有监听器。
完整参考文档
继续使用 @capgo/capacitor-light-sensor
如果你正在使用 使用 @capgo/capacitor-light-sensor 要规划 dashboard 和 API 操作，请将其连接到 @capgo/capacitor-light-sensor 有关 @capgo/capacitor-light-sensor 的实现细节， 快速入门 有关“入门指南”中的实现细节， API 概览 关于 API Overview 中的实现细节， 简介 关于简介中的实现细节，以及 API 密钥 关于 API Keys 中的实现细节。