跳过主要内容

光线传感器 Capacitor插件

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

安装

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

指南

如何使用Capacitor

在设备上测试

下载Capgo应用,扫描QR code

光线传感器插件预览QR code

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

停止监听光感应器更新。该操作将停止感应器并节省电池。

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

const status = await LightSensor.checkPermissions();

requestPermissions()

检查当前高采样率感应器的权限状态。Android 12+ 上,需要 HIGH_SAMPLING_RATE_SENSORS 权限才能在 200ms 以下的间隔内更新感应器。

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

const status = await LightSensor.requestPermissions();

请求高采样率感应器的权限。Android 12+ 上,请求 HIGH_SAMPLING_RATE_SENSORS 权限。

addListener 监听事件 handle.remove() 返回句柄。调用 LightSensor.removeAllListeners() 当屏幕卸载时,或者

来清除所有监听器。

继续使用@capgo/capacitor-light-sensor

如果您正在使用 使用@capgo/capacitor-light-sensor 为了计划仪表板和API操作,连接它到 @capgo/capacitor-光线传感器 为了@capgo/capacitor-light-sensor的实现细节 开始 为了开始的实现细节 API概述 为了API概述的实现细节 简介 简介中的实现细节 API 键 API 键中的实现细节

FAQ

光感器插件FAQ

如何在Capacitor应用中安装光感器插件?

运行“bun add @capgo/capacitor-light-sensor”(或“npm install @capgo/capacitor-light-sensor”),然后运行“bunx cap sync”,使iOS和Android项目捕获native code。从“@capgo/capacitor-light-sensor”中导入它到您的应用code。

是否@capgo/capacitor-light-sensor与React、Vue和Angular兼容?

是。光感器是一个Capacitor包,因此它与任何在Capacitor中运行的Web框架兼容,包括Ionic、React、Vue、Angular、Svelte和普通JavaScript。

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

Capgo插件遵循Capacitor的主要版本:使用与Capacitor主要版本匹配的插件主要版本(例如插件v8与Capacitor 8)。在GitHub README中列出的维护版本的兼容性表格。

是否@capgo/capacitor-light-sensor免费和开源?

是。code源代码在GitHub上公开,https://github.com/Cap-go/capacitor-light-sensor/,并且该包从npm中免费安装。欢迎bug报告和拉取请求。

是否可以在不经过 App Store 审核的情况下更新使用光线传感器的 code?

code 和 Capgo 的升级或安装会改变原生 code, 因此需要新建一个商店构建。之后,使用 Capgo 实时更新的 JavaScript、HTML 和 CSS 变更可以立即部署。

不必等待应用程序审查就可以将光线传感器的变化推送给用户

一旦插件在您的商店构建中,Capgo即刻推送您的JavaScript、HTML和CSS更改到用户中。

从Capgo开始