メインコンテンツへスキップ
@capgo/capacitor-proximity デバイス API オープンソース

近接 Capacitor プラグイン

ネイティブの近接センサー監視を有効にし、デバイスが顔や手、表面に近づいた際にアプリが反応できるようにします

インストール

bun add @capgo/capacitor-proximity bunx cap sync
npm、pnpm、または yarn
  • npm install @capgo/capacitor-proximity
  • pnpm add @capgo/capacitor-proximity
  • yarn add @capgo/capacitor-proximity

ガイド

Capacitor で Proximity を使う方法

実機でテストする

Capgo アプリをダウンロードして、QR code をスキャンしてください。

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

@capgo/capacitor-proximity の使い方

モバイルアプリで近接監視を有効にするための Capacitor プラグイン。

インストール

bun add @capgo/capacitor-proximity
bunx cap sync

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

インポート

import { CapacitorProximity } from '@capgo/capacitor-proximity';

API の概要

メソッド 説明
enable 近接センサーの監視を有効にします。
disable 近接センサーの監視を無効にします。
getStatus 現在のセンサーの利用可否とプラグインの有効状態を取得します。

例

enable()

近接センサーの監視を有効にします。

import { CapacitorProximity } from '@capgo/capacitor-proximity';

await CapacitorProximity.enable();

disable()

近接センサーの監視を無効にします。

import { CapacitorProximity } from '@capgo/capacitor-proximity';

await CapacitorProximity.disable();

getStatus()

現在のセンサーの利用可否とプラグインの有効状態を取得します。

import { CapacitorProximity } from '@capgo/capacitor-proximity';

const status = await CapacitorProximity.getStatus();

完全なリファレンス

@capgo/capacitor-proximity の使い方から続ける

使用している場合 @capgo/capacitor-proximity の使い方 ネイティブプラグインの作業を計画するには、次と連携してください: @capgo/capacitor-proximity @capgo/capacitor-proximity の実装の詳細については、 スタートガイド スタートガイドの実装詳細については、 Capgo プラグインディレクトリ Capgo プラグインディレクトリのプロダクトワークフローについては、 Capgo による Capacitor プラグイン Capgo による Capacitor Plugins の実装詳細、および プラグインの追加または更新 プラグインの追加または更新に関する実装詳細についてはこちら。

よくある質問

Proximity プラグインの FAQ

Capacitor アプリに Proximity プラグインをインストールするには?

"bun add @capgo/capacitor-proximity" (または "npm install @capgo/capacitor-proximity") を実行し、次に "bunx cap sync" を実行して、iOS と Android のプロジェクトがネイティブ code を認識するようにします。アプリの code から "@capgo/capacitor-proximity" をインポートします。

@capgo/capacitor-proximity は React、Vue、Angular で動作しますか?

はい。Proximity は Capacitor パッケージなので、Ionic、React、Vue、Angular、Svelte、プレーン JavaScript を含む、Capacitor 内で動作するすべての Web フレームワークで動作します。

@capgo/capacitor-proximity はどの Capacitor バージョンをサポートしていますか?

Capgo プラグインは Capacitor のメジャーバージョンに合わせています。使用している Capacitor のメジャーバージョンに一致するプラグインのメジャーバージョンを使ってください (例: Capacitor 8 ならプラグイン v8)。GitHub の README にある互換性テーブルに、メンテナンス中のバージョンが記載されています。

@capgo/capacitor-proximity は無料かつオープンソースですか?

はい。ソース code は https://github.com/Cap-go/capacitor-proximity/ の GitHub で公開されており、npm から無料でインストールできます。バグレポートやプルリクエストをお待ちしています。

App Store のレビューなしで、Proximity を使用している code を更新できますか?

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

アプリ審査を待たずに Proximity の変更をリリース

プラグインをストア用ビルドに組み込めば、Capgo live updates で JavaScript、HTML、CSS の変更を数分でユーザーに配信できます

Capgo から始める