@capgo/capacitor-ibeaconを使用
Capacitor iBeacon プラグイン - 近接検知とビーコン地域監視
インストール
bun add @capgo/capacitor-ibeacon
bunx cap sync
bunx cap sync プラグインのネイティブcodeをプロジェクトにコピー
インポート
import { CapacitorIbeacon } from '@capgo/capacitor-ibeacon';
APIの概要
| 方法 | 概要 |
|---|---|
startMonitoringForRegion |
指定されたビーコン領域を監視する。領域内/外に入ったときにイベントが発生します。 |
stopMonitoringForRegion |
ビーコン領域の監視を停止します。 |
startRangingBeaconsInRegion |
指定されたビーコン領域内でビーコンを範囲検出します。領域内での距離の更新が継続的に行われます。 |
stopRangingBeaconsInRegion |
ビーコン領域内でのビーコンを範囲検出を停止します。 |
startAdvertising |
iOS専用機能: このデバイスをiBeaconとして広告します。 |
stopAdvertising |
iOS専用機能: このデバイスをiBeaconとして広告を停止します。 |
requestWhenInUseAuthorization |
範囲検出/監視のために必要な場合、位置情報の「使用中」許可を要求します。 |
requestAlwaysAuthorization |
背景監視のために必要な場合、位置情報の「常に」許可を要求します。 |
getAuthorizationStatus |
現在の位置情報許可の状態を取得します。 |
isBluetoothEnabled |
このデバイスでBluetoothが有効かどうかを確認します。 |
isRangingAvailable |
このデバイスで範囲検出が利用可能かどうかを確認します。 |
enableARMAFilter |
距離計算 (Android 限定) に対して ARMA フィルタを有効にします。 |
enableBackgroundMode |
距離計算 (Android 限定) に対してバックグラウンド スキャン モードを有効または無効にします。この機能は、常に位置情報の許可を要求した後でしか呼び出すことができません。 |
setBackgroundScanPeriod |
距離計算 (Android 限定) に対してバックグラウンド スキャン パーミッションを設定します。この機能は、常に位置情報の許可を要求した後でしか呼び出すことができません。 |
例
startMonitoringForRegion()
ビーコン リージョンを監視するために開始します。リージョンに入ったり出たりしたときにイベントが発生します。
import { CapacitorIbeacon } from '@capgo/capacitor-ibeacon';
await CapacitorIbeacon.startMonitoringForRegion({
identifier: 'MyBeaconRegion',
uuid: 'B9407F30-F5F8-466E-AFF9-25556B57FE6D'
});
stopMonitoringForRegion()
ビーコン リージョンを監視するために停止します。
import { CapacitorIbeacon } from '@capgo/capacitor-ibeacon';
await CapacitorIbeacon.stopMonitoringForRegion({
identifier: 'MyBeaconRegion',
uuid: 'B9407F30-F5F8-466E-AFF9-25556B57FE6D'
});
startRangingBeaconsInRegion()
ビーコン リージョン内でビーコンを範囲測定します。距離の更新が継続的に行われます。
import { CapacitorIbeacon } from '@capgo/capacitor-ibeacon';
await CapacitorIbeacon.startRangingBeaconsInRegion({
identifier: 'MyBeaconRegion',
uuid: 'B9407F30-F5F8-466E-AFF9-25556B57FE6D'
});
stopRangingBeaconsInRegion()
ビーコン リージョン内でビーコンを範囲測定するために停止します。
import { CapacitorIbeacon } from '@capgo/capacitor-ibeacon';
await CapacitorIbeacon.stopRangingBeaconsInRegion({
identifier: 'MyBeaconRegion',
uuid: 'B9407F30-F5F8-466E-AFF9-25556B57FE6D'
});
startAdvertising()
iOS 限定) に対してデバイスを iBeacon として広告します。
import { CapacitorIbeacon } from '@capgo/capacitor-ibeacon';
await CapacitorIbeacon.startAdvertising({
uuid: 'B9407F30-F5F8-466E-AFF9-25556B57FE6D',
major: 1,
minor: 2,
identifier: 'MyBeacon'
});
stopAdvertising()
iOS 限定) に対してデバイスを iBeacon として広告するために停止します。
import { CapacitorIbeacon } from '@capgo/capacitor-ibeacon';
await CapacitorIbeacon.stopAdvertising();
上の表には、14 のコア メソッドがリストされています。リスナーとバージョン ヘルパー、各メソッドのフル コントラクトは、 GitHub リポジトリ.
イベントを聞く
addListener ハンドルを返します。画面をアンマウントしたり、すべてのリスナーをクリアしたりするには handle.remove() 画面をアンマウントしたり、すべてのリスナーをクリアしたりするには CapacitorIbeacon.removeAllListeners() すべてのリスナーをクリアするには
フルリファレンス
@capgo/capacitor-ibeaconを継続して使用
__CAPGO_KEEP_0__-ibeaon を使用している場合 @capgo/capacitor-iBeacon native plugin の作業を計画するには、__CAPGO_KEEP_0__-ibeacon を接続する @capgo/capacitor-ibeacon @capgo/capacitor-ibeacon Getting Started Getting Started Capgo プラグインディレクトリ Capgo Plugin Directory Capacitor Capgo Capacitor Plugins by Capgo プラグインの追加または更新 Adding or Updating Plugins