iOSのセットアップ

インストール手順と、このプラグインの完全なMarkdownガイドを含むセットアッププロンプトをコピーします。

使用されるiOSネイティブシステム

iOSでは、このプラグインは以下を使用します： Nearby Interaction を NearbyInteraction フレームワーク。

要件

iOS 15+
UWBハードウェア搭載の実機
XcodeでNearby Interactionが有効であること

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 他のピアと共有します。このプラグインは、デバイスの検出やネットワーク通信自体は行いません。

イベント

rangingUpdate 利用可能な際に、距離と方向の更新をエミットします。
sessionStateChanged 以下のようなライフサイクル状態をエミットします： running, suspended, invalidatedや peerDisconnected.

備考

getDiscoveryToken() と startPeerSession() これらはiOS専用のAPIです。
デバイスが対応している場合、iOS 16以降でカメラアシストが利用可能です。