Bluetooth デバイスのスキャン、接続、読み取り、書き込み、通知受信が可能なフル機能の BLE プラグイン
まずは initialize() および以下に示すその他のコアメソッド。
プラットフォーム対応
「プラットフォーム対応」という見出しのセクション| プラットフォーム | サポート | 備考 |
|---|---|---|
| iOSと | はい | ネイティブ |
| Androidでは | はい | ネイティブ |
| Web | いいえ | Capacitor.getPlatform() でガード |
コア機能
「コア機能」セクションinitialize- BLE プラグインを初期化します。他のメソッドを呼び出す前に実行する必要があります。shimWebBluetooth- Capacitor Web Bluetooth シムをインストールしますnavigator.bluetooth. Capacitor ネイティブアプリから Web Bluetooth API を使用する前に、手動でこれを呼び出してください。isAvailable- デバイスでBluetoothが利用可能か確認します。isEnabled- デバイスでBluetoothが有効か確認します。
公開 API
「Public API」セクション| メソッド | 説明 |
|---|---|
initialize | BLEプラグインを初期化します。他のメソッドを呼び出す前に必ず実行してください。 |
shimWebBluetooth | Capacitor Web Bluetooth shimをインストールします navigator.bluetooth. Capacitor ネイティブアプリから Web Bluetooth API を使用する前に、手動でこれを呼び出してください。 |
isAvailable | デバイスでBluetoothが利用可能か確認します。 |
isEnabled | デバイスでBluetoothが有効か確認します。 |
isLocationEnabled | 位置情報サービスが有効か確認します(Androidのみ)。 |
openAppSettings | アプリの設定ページを開きます。 |
openBluetoothSettings | Bluetooth設定画面を開きます(Androidのみ)。 |
openLocationSettings | 位置情報設定画面を開きます(Androidのみ)。 |
checkPermissions | 現在の権限ステータスを確認します。 |
requestPermissions | Bluetoothの権限をリクエストします。 |
startScan | BLE デバイスのスキャンを開始します。 |
stopScan | BLE デバイスのスキャンを停止します。 |
connect | BLE デバイスに接続します。 |
disconnect | BLE デバイスから切断します。 |
createBond | BLEデバイスとボンディングします(Androidのみ)。 |
isBonded | デバイスがボンディング済みか確認します(Androidのみ)。 |
discoverServices | 接続済みデバイスのサービスを検出します。 |
getServices | デバイスの検出済みサービスを取得します。 |
getConnectedDevices | 接続済みデバイスの一覧を取得します。 |
readCharacteristic | キャラクタリスティックの値を読み取ります。 |
writeCharacteristic | キャラクタリスティックに値を書き込みます。 |
startCharacteristicNotifications | キャラクタリスティックの通知を開始します。 |
stopCharacteristicNotifications | キャラクタリスティックの通知を停止します。 |
readDescriptor | ディスクリプタの値を読み取ります。 |
writeDescriptor | ディスクリプタに値を書き込みます。 |
readRssi | 接続済みデバイスのRSSI(信号強度)を読み取ります。 |
requestMtu | MTUサイズの変更をリクエストします(Androidのみ)。 |
requestConnectionPriority | 接続優先度の変更をリクエストします(Androidのみ)。 |
startAdvertising | ペリフェラル(BLEサーバー)としてアドバタイズを開始します。 |
stopAdvertising | アドバタイズを停止します。 |
startForegroundService | フォアグラウンドサービスを開始して、バックグラウンドでもBLE接続を維持します(Androidのみ)。 |
stopForegroundService | フォアグラウンドサービスを停止します(Androidのみ)。 |
getPluginVersion | ネイティブの Capacitor プラグインのバージョンを取得します。 |
addListener | デバイスのスキャンイベント用リスナーを追加します。 |
addListener | デバイスの接続イベント用リスナーを追加します。 |
addListener | デバイスの切断イベント用リスナーを追加します。 |
addListener | キャラクタリスティック変更イベント用リスナーを追加します。 |
removeAllListeners | このプラグインのすべてのリスナーを削除します。 |
Source of Truth
「Source Of Truth」セクションこのリファレンスは以下から同期されています: src/definitions.ts における capacitor-bluetooth-low-energy.
@capgo/capacitor-bluetooth-low-energyから続ける
セクション「@capgo/capacitor-bluetooth-low-energyから続ける」使用している場合 @capgo/capacitor-bluetooth-low-energy 移行とエンタープライズ運用を計画するには、次と連携してください @capgo/capacitor-bluetooth-low-energy の使い方 @capgo/capacitor-bluetooth-low-energy でネイティブ機能を使うには、 Capgo エンタープライズ Capgo Enterprise のプロダクトワークフロー向けに、 Ionic Enterprise プラグインの代替案 Ionic Enterprise Plugin Alternatives のプロダクトワークフロー向けに、 Capgo の代替案 Capgo Alternatives のプロダクトワークフロー向け、および Capgo コンサルティング Capgo Consulting のプロダクトワークフロー向けに。