iOSのセットアップ
インストール手順と、このプラグインの完全なMarkdownガイドを含むセットアッププロンプトをコピーします。
使用するiOSネイティブシステム
セクション「使用するiOSネイティブシステム」iOSでは、このプラグインは次を使用します Nearby Interaction を NearbyInteraction フレームワーク。
- iOS 15以降
- UWBハードウェア搭載の実機
- XcodeでNearby Interactionが有効であること
Xcodeの設定
「Xcodeの設定」というセクション- XcodeでiOSアプリのターゲットを開きます。
- 以下に移動します: Signing & Capabilities.
- クリック + Capability 以下を追加します: Nearby Interaction.
- に使用説明を追加します
Info.plist:
<key>NSNearbyInteractionUsageDescription</key><string>This app uses Ultra Wideband to measure distance to nearby devices.</string>クライアントフロー
「クライアントフロー」セクションimport { CapacitorUwb } from '@capgo/capacitor-uwb';
const { discoveryToken } = await CapacitorUwb.getDiscoveryToken();
await CapacitorUwb.startPeerSession({ peerDiscoveryToken: '<peer-token-base64>', isCameraAssistanceEnabled: false,});各デバイスの discoveryToken を独自のトランスポートレイヤーで他のピアと共有します。このプラグインは、ディスカバリーやネットワーク処理は行いません。
イベント
「Events」セクションrangingUpdateは、利用可能な場合に距離と方向の更新をemitします。sessionStateChangedは、などのライフサイクル状態をemitしますrunning,suspended,invalidatedやpeerDisconnected.
getDiscoveryToken()とstartPeerSession()は iOS 専用の API です。- デバイスがサポートしている場合、iOS 16 以降でカメラ支援が利用できます。