iOS-Einrichtung

iOS-native System verwendet

Auf iOS verwendet dieses Plugin Nahbereichsinteraktion aus der NearbyInteraction Framework.

Anforderungen

• iOS 15+
• Physisches Gerät mit UWB-Hardware
• Nahbereichsinteraktion in Xcode aktiviert

Xcode-Einrichtung

1. Öffnen Sie Ihr iOS-App-Ziel in Xcode.
2. Gehe zu Zertifizierung und Fähigkeiten.
3. Klicken Sie + Fähigkeit hinzufügen und fügen Sie Nahbereichsinteraktion.
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-Flow

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. Die Erweiterung führt keine Entdeckung oder Netzwerkarbeit für Sie durch.

Events

• rangingUpdate emittiert Entfernungs- und Richtungsaktualisierungen, wenn verfügbar.
• sessionStateChanged emittiert Lebenszyklustaten wie running, suspended, invalidated, und peerDisconnected.

Hinweise

• getDiscoveryToken() und startPeerSession() sind nur für iOS verfügbar.
• Kameraunterstützung ist auf iOS 16+ verfügbar, wenn sie vom Gerät unterstützt wird.