iOS-Einrichtung

iOS-native-System verwendet

Bei iOS verwendet dieses Plugin Nahbereichsinteraktion von der NearbyInteraction Framework.

Anforderungen

• iOS 15+
• Physisches Gerät mit UWB-Hardware
• Nahe Interaktion capability in Xcode aktiviert

Xcode-Einstellungen

1. Öffnen Sie Ihr iOS-App-Ziel in Xcode.
2. Gehe zu Zertifizierung und Fähigkeiten.
3. Klicken Sie + Fähigkeit und fügen Sie hinzu Nahe Interaktion.
4. Fügen Sie eine Verwendungsbeschreibung hinzu zu Info.plist:

<key>NSNearbyInteractionUsageDescription</key>
<string>This app uses Ultra Wideband to measure distance to nearby devices.</string>

Client-Fluss

import { CapacitorUwb } from '@capgo/capacitor-uwb';

const { discoveryToken } = await CapacitorUwb.getDiscoveryToken();

await CapacitorUwb.startPeerSession({
  peerDiscoveryToken: '<peer-token-base64>',
  isCameraAssistanceEnabled: false,
});

Teilen Sie jedes Geräts discoveryToken mit dem anderen Peer mithilfe Ihrer eigenen Transportlayer. Der Plugin führt keine Entdeckung oder Netzwerking für Sie durch.

Ereignisse

• rangingUpdate emittiert Entfernungen und Richtungsupdates, wenn verfügbar.
• sessionStateChanged emittiert Lebenszyklustaten wie running, suspended, invalidated, und peerDisconnected.

Hinweise

• getDiscoveryToken() und startPeerSession() sind iOS-only-APIs.
• Die Kameraunterstützung ist auf iOS 16+ verfügbar, wenn sie durch das Gerät unterstützt wird.