ガイド
光センサのチュートリアル
使用方法: @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/