メインコンテンツにジャンプ
@capgo/capacitor-light-sensor デバイスAPI オープンソース

光センサー Capacitor プラグイン

周囲の光を測定して明るさを実時間で計測する

インストール

bun add @capgo/capacitor-light-sensor bunx cap sync
npm、pnpm、yarn
  • npm install @capgo/capacitor-light-sensor
  • pnpm add @capgo/capacitor-light-sensor
  • yarn add @capgo/capacitor-light-sensor

ガイド

Capacitorを使用する方法

デバイスでテスト

Download the Capgo app, then scan the QR code.

光センサプラグインのプレビューQRcode

@capgo/capacitor-light-sensorを使用

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

インストール

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

bunx cap sync Capacitor Light Sensorプラグインのネイティブcodeをあなたのネイティブプロジェクトにコピーします。プラグインのアップグレード後は再度実行してください。

インポート

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

APIの概要

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

サンプルコード

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();

requestPermissions()

高サンプリングレートセンサの許可を要求します。Android 12+では、このHIGH_SAMPLING_RATE_SENSORS許可を要求します。

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

const status = await LightSensor.requestPermissions();

イベントをリスンする

addListener リスナーを取得します。画面がアンマウントされたときや、 handle.remove() を呼び出してリスナーをすべてクリアします。 LightSensor.removeAllListeners() 詳細なドキュメント

Capacitor Light Sensor プラグインのリポジトリ

@capgo/capacitor-light-sensorを継続して使用

Capacitor Light Sensor を使用している場合 Using @capgo/capacitor-light-sensor Capacitor Light Sensor を使用して、ダッシュボードの計画と API の実行を接続する @capgo/capacitor-light-sensor @capgo/capacitor-lightセンサー実装詳細 Capacitor Light Sensor を使用して、Capacitor Light Sensor の実装詳細を参照する Capacitor Light Sensor を使用して、Capacitor Light Sensor の実装詳細を参照する API まとめ APIの実装詳細について 概要 概要の実装詳細について API キー API キーの実装詳細について

FAQ

Light SensorプラグインのFAQ

Capacitor Light Sensor プラグインを Capacitor アプリにインストールする方法は何ですか。

Run "bun add @capgo/capacitor-light-sensor" (or "npm install @capgo/capacitor-light-sensor"), then run "bunx cap sync" so the iOS and Android projects pick up the native code. Import it from "@capgo/capacitor-light-sensor" in your app code.

Does @capgo/capacitor-light-sensor work with React, Vue and Angular?

Yes. Light Sensor is a Capacitor package, so it works with any web framework that runs inside Capacitor, including Ionic, React, Vue, Angular, Svelte and plain JavaScript.

Which Capacitor version does @capgo/capacitor-light-sensor support?

Capgo plugins follow Capacitor's major version: use the plugin major version that matches your Capacitor major version (for example plugin v8 with Capacitor 8). The compatibility table in the GitHub README lists the maintained versions.

Is @capgo/capacitor-light-sensor free and open source?

Yes. The source code is public on GitHub at https://github.com/Cap-go/capacitor-light-sensor/ and the package is free to install from npm. Bug reports and pull requests are welcome.

Capacitor Light Sensor を使用するアプリを code でアップデートできますか?

code のインストールまたはアップグレードはネイティブ コードを変更するため、ストアのビルドが必要になります。その後、プラグインを呼び出す JavaScript、HTML、CSS の変更は Capgo のライブ更新で即時配信できます。

アプリレビューの待たずにLight Sensorの変更を配信

プラグインがストアビルドに追加されたら、Capgoライブアップデートは、JavaScript、HTML、CSSの変更をユーザーに数分で反映します。

Capgoから始めましょう