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

光センサー

周囲光を認識して、実時間で明るさを測定します

ガイド

ライト センサーのチュートリアル

デバイスでテスト

Download the Capgo app, then scan the QR code.

Light Sensor プラグインのプレビュー QR code

「@capgo/capacitor-light-sensor」を使用

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

インストール

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

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

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

Install

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+では、センサの更新間隔が 200ms 未満の場合、HIGH_SAMPLING_RATE_SENSORS 許可が必要です。

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

const status = await LightSensor.checkPermissions();

詳細なドキュメント

Keep going from Using @capgo/capacitor-light-sensor

Capacitor Light Sensor を使用している場合 Using @capgo/capacitor-light-sensor 計画ダッシュボードとAPIの運用を計画し、 @capgo/capacitor-light-sensor Capacitor Light Sensorの実装詳細については@capgo/capacitor-light-sensorを参照してください。 Getting Started Capacitor Light Sensorの実装詳細についてはGetting Startedを参照してください。 API Overview for the implementation detail in API Overview, Introduction Capacitor Light Sensorの実装詳細についてはIntroductionを参照してください。 API Keys for the implementation detail in API Keys.