@ capgo/ 电容- 光感应器

从您的 Capacitor app 中的设备传感器读取环境光度, 以适应主题, 亮度或相机提示到房间 .

🤖 建筑与AI编码代理? 安装 Capgo 技能 所以克劳德代码,代码,光标,副驾驶,或双子座CLI知道如何安装和使用 @capgo/capacitor-light-sensor 在您的电容应用程序中: npx skills add Cap-go/capgo-skills。然后问你的经纪人: 添加@capgo/电容-光感应器到我的Capacitor应用上并把它接上" 代理设置指南 • 妇女 主机磁共振

主要特点

• 现场阅读数字 : start() 流经 lightSensorChange 活动.
• 取样控制: 将更新间隔传递给 start()。 。 。 .
• 可用性数字 : isAvailable() 先检查光感应器.
• 停下来数字 : stop() 结束更新以保存电池.
• 权限数字 : checkPermissions() 财务报告和审定财务报表 requestPermissions() aPI 均等。 两人总是报告 highSamplingRate 已经同意.
• 平台:Android (英语). 仅限Android. iOS没有公共环境光传感器API,也没有网络.

为什么是光传感器?

• 真实环境光数据: 在豪华中获取准确的光等值读取
• 高效传感器访问: 使用原生Android传感器 API进行最佳性能
• 可配置的更新间隔: 控制多久收到传感器更新
• 电池意识: 启动和停止用于保存电池的传感器
• 类型脚本支持: 大型开发者经验的完整类型定义

平台支持

兼容性

说明: 此插件的主要版本沿用了Capacitor的主要版本. 使用匹配您的 Capacitor 安装的版本( 如 Capacitor 8 的插件 v8) 。 只有最新的主要版本得到积极维护.

安装

您可以使用我们的 AI 辅助设置安装插件 。 使用以下命令将 Capgo 技能添加到您的 AI 工具 :

npx skills add https://github.com/cap-go/capacitor-skills --skill capacitor-plugins

然后使用下列提示:

Use the `capacitor-plugins` skill from `cap-go/capacitor-skills` to install the `@capgo/capacitor-light-sensor` plugin in my project.

如果您更喜欢手动设置,请通过运行以下命令来安装插件,并遵循下面的平台特定指令:

npm install @capgo/capacitor-light-sensor
npx cap sync

所需资源

机器人

• 最低SDK: 24 (Android 7.0) (中文(简体) )
• 目标SDK:36
• 设备必须有一个光感应器(大多数Android手机都是这样)

高采样率(Android 12+)

对于在Android 12和以上200ms以下的更新间隔,请在您 AndroidManifest.xml数字 :

<uses-permission android:name="android.permission.HIGH_SAMPLING_RATE_SENSORS" />

使用量

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

// Check if sensor is available
const { available } = await LightSensor.isAvailable();

if (available) {
  // Start listening with 500ms update interval
  await LightSensor.start({ updateInterval: 500 });

  // Add listener for sensor data
  const handle = await LightSensor.addListener('lightSensorChange', (data) => {
    console.log(`Light level: ${data.illuminance} lux`);
    console.log(`Timestamp: ${data.timestamp}`);
  });

  // Later, stop the sensor
  await LightSensor.stop();
  await handle.remove();
}

轻等参考

API 密码

• isAvailable()
• start(...)
• stop()
• addListener('lightSensorChange', ...)
• removeAllListeners()
• checkPermissions()
• requestPermissions()
• getPluginVersion()
• 接口
• 类型异名

用于访问设备环境光传感器的电容插件.

易读 ()

isAvailable() => Promise<IsAvailableResult>

检查当前设备是否有光传感器可用 . 在尝试使用之前,你应该先检查传感器的可用性.

回返情况: Promise<IsAvailableResult>

自: 0.0.1 资源

启动(...)

start(options?: StartOptions | undefined) => Promise<void>

开始听光传感器的更新. 这将在指定的间隔开始传感器测量. 使用 addListener 接收传感器数据.

自: 0.0.1 资源

停止( )

stop() => Promise<void>

停止听光传感器更新. 这将停止传感器 并保存电池.

自: 0.0.1 资源

添加Listener('LightSensor Change', ...) 输入器

addListener(eventName: 'lightSensorChange', listenerFunc: LightSensorCallback) => Promise<PluginListenerHandle>

为光传感器变化事件添加一个收听器. 只要有新的传感器数据,就会调用听众.

回返情况: Promise<PluginListenerHandle>

自: 0.0.1 资源

删除所有收听器( )

removeAllListeners() => Promise<void>

清除所有用于光感应事件的听众.

自: 0.0.1 资源

检查( )

checkPermissions() => Promise<PermissionStatus>

请检查access-date=中的日期值 (帮助) 高采样率传感器当前许可状态. 在Android 12+上,需要High SAMPLING RATE SENSERS许可 用于传感器更新间隔在200米以下.

回返情况: Promise<PermissionStatus>

自: 0.0.1 资源

请求( )

requestPermissions() => Promise<PermissionStatus>

申请高采样率传感器许可. 在Android 12+上,这需要High SAMPLING RATE SENOS授权.

回返情况: Promise<PermissionStatus>

自: 0.0.1 资源

获取 PluginVersion ()

getPluginVersion() => Promise<VersionResult>

获取当前版本的插件 .

回返情况: Promise<VersionResult>

自: 0.0.1 资源

接口

易伤性结果

结果表明传感器是否可用.

开始选项

启动光感应听器的选项 .

插件听筒

灯光传感器计量

单光感应测量.

权限状态

许可请求或检查的结果.

版本结果

插件版本信息 .

类型异名

灯感应器回叫

用于光传感器更新的回调功能.

(measurement: LightSensorMeasurement): void

捐款

见 捐款额 关于如何为此插件贡献的详细信息.

许可证

MPL - 2.0 导弹

贷项

这个SDK的灵感来自 曝光光传感器。 。 。 .