メインコンテンツにジャンプ
プラグインに戻る
@capgo/capacitor-light-sensor
チュートリアル
by github.com/Cap-go

光センサー

環境光センサにアクセスして、lux単位の照度をリアルタイムで測定する

ガイド

光センサのチュートリアル

使用方法: @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