跳过主要内容
返回到插件
@capgo/capacitor-光线传感器
教程
由 github.com/Cap-go

光线传感器

访问环境光线传感器,实时更新光照强度(lux)

指南

关于光线传感器的教程

使用 @capgo/capacitor-light-sensor

Capacitor 插件,用于访问设备的环境光线传感器

安装

bun add @capgo/capacitor-light-sensor
bunx cap sync

此插件暴露的内容

  • isAvailable - 检查当前设备上是否有可用的光线传感器。您应该始终在使用传感器之前检查传感器的可用性。
  • start - 开始监听光线传感器更新。这将在指定的间隔开始传感器测量。使用 addListener 接收传感器数据。
  • stop - 停止监听光线传感器更新。这将停止传感器并节省电池。
  • checkPermissions - 检查高采样率传感器的当前权限状态。 在 Android 12+ 上,需要 HIGH_SAMPLING_RATE_SENSORS 权限才能在 200ms 以下的传感器更新间隔下更新传感器。

Example Usage

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+ 上,需要 HIGH_SAMPLING_RATE_SENSORS 权限才能在 200ms 以下的传感器更新间隔下更新传感器。

import { LightSensor } from '@capgo/capacitor-light-sensor';

const status = await LightSensor.checkPermissions();

Full Reference