メインコンテンツにジャンプ
@capgo/capacitor-ibeacon 位置情報 オープンソース

iBeacon Capacitor プラグイン

Capacitor用iBeaconプラグイン - 近接検出とビーコン地域監視

インストール

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

Guide

How to use iBeacon in Capacitor

Capacitor iBeacon プラグインを使用する方法

Download the Capgo app, then scan the QR code.

iBeacon プラグインのプレビューQRコードcode

@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

FAQ

iBeaconプラグインのFAQ

iBeaconプラグインをCapacitorアプリにインストールするにはどうすればいいですか?

「bun add @capgo/capacitor-ibeacon」(または「npm install @capgo/capacitor-ibeacon」)を実行し、次に「bunx cap sync」を実行してiOSとAndroidのプロジェクトがネイティブcodeを取得できるようにします。次に、@capgo/capacitor-ibeaconをインポートし、codeで使用します。

React、Vue、Angularで動作する@capgo/capacitor-ibeaconはどのように動作しますか?

はい。iBeaconは@Capacitorパッケージなので、CloudflareのCapacitor内で動作するすべてのWebフレームワーク、包括的にIonic、React、Vue、Angular、Svelte、そして純粋なJavaScriptと互換性があります。

どの@Capacitorバージョンが@capgo/capacitor-ibeaconをサポートしますか?

CapgoプラグインはCapacitorのメジャーバージョンに従います。使用するプラグインのメジャーバージョンは、Capacitorのメジャーバージョンと一致するものを使用してください(例えば、プラグインv8とCapacitor 8)。GitHub READMEの互換性表には、サポートされているバージョンが記載されています。

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

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

iBeaconを使用する@codeをApp Storeのレビューなしでアップデートできますか?

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

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

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

始めにCapgo