跳过主要内容
返回插件
@capgo/capacitor-light-sensor
教程
@capgo/capacitor-light-sensor

光线传感器

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

指南

环境光线传感器教程

使用 @capgo/capacitor-light-sensor

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

Install

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

该插件暴露的内容

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

示例用法

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

检查高采样率传感器的当前权限状态。

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

const status = await LightSensor.checkPermissions();

Android 12+ 需要 HIGH_SAMPLING_RATE_SENSORS 权限,才能在 200ms 以下的传感器更新间隔下更新传感器。

Keep going from Using @capgo/capacitor-light-sensor

继续使用 @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-light-sensor Using @capgo/capacitor-light-sensor 使用 @API/__CAPGO_KEEP_1__-light-sensor @capgo/capacitor-light-sensor @capgo/capacitor-light-sensor 了解 @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-light-sensor 的实现细节, 为 Getting Started 中的实现细节, API 概述 为 API 概述 中的实现细节, 介绍 为介绍中实现细节,和 API 密钥 为 API 密钥 中的实现细节。