iOS設定

このプラグインのインストール手順とフルマークダウンガイドをコピーします。

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

iOSでは、このプラグインは 近接インタラクション 近接インタラクションから NearbyInteraction フレームワーク。

要件

iOS 15+
UWBハードウェアを搭載した物理デバイス
Xcodeで近接インタラクション機能を有効にします。

Xcodeの設定

Xcodeで
署名 & 能力 クリック.
Open your iOS app target in Xcode.__CAPGO_KEEP_0__. Go to __CAPGO_KEEP_1__. Click __CAPGO_KEEP_2__. + 能力 と追加 近接インタラクション.
使用説明を追加 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 __CAPGO_KEEP_0__.が利用可能な場合に距離と方向の更新を発行します。
sessionStateChanged __CAPGO_KEEP_0__.のライフサイクル状態として、 running, suspended, invalidated, peerDisconnected.

Notes

getDiscoveryToken() 、 startPeerSession() はiOSのみのAPIです。
iOS 16+でサポートされるデバイスによっては、カメラのアシストが利用可能です。