光センサー

Using @capgo/capacitor-light-sensor

Capacitor プラグインは、デバイスの周囲光センサにアクセスするために使用されます。

インストール

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

このプラグインが公開するもの

• isAvailable - このプラグインは、現在のデバイスで光センサが利用可能であるかどうかを確認します。センサの利用可能性を確認することは常に必要です。
• start - 指定された間隔でセンサ測定を開始するために、光センサの更新を開始します。 addListener を使用して、センサデータを受信します。
• stop - 指定された間隔でセンサ測定を停止するために、光センサの更新を停止します。
• checkPermissions - Android 12+ の高サンプリングレートセンサーの許可状況を確認してください。 Android 12+ では、200ms 未満のセンサーの更新間隔に対して HIGH_SAMPLING_RATE_SENSORS 許可が必要です。

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+ の高サンプリングレートセンサーの許可状況を確認してください。 Android 12+ では、200ms 未満のセンサーの更新間隔に対して HIGH_SAMPLING_RATE_SENSORS 許可が必要です。

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

const status = await LightSensor.checkPermissions();

Full Reference

• GitHub: https://github.com/Cap-go/capacitor-light-sensor/
• Docs: /docs/plugins/light-sensor/