Zum Inhalt springen

iOS-Setup

GitHub

Auf iOS verwendet dieses Plugin Nearby Interaction vom NearbyInteraction Framework.

  • iOS 15+
  • Physisches Gerät mit UWB-Hardware
  • Nearby Interaction-Fähigkeit in Xcode aktiviert
  1. Öffnen Sie Ihr iOS-App-Target in Xcode.
  2. Gehe zu Signing & Capabilities.
  3. Klicken + Capability und hinzufügen Nearby Interaction.
  4. Füge eine Nutzungserklärung zu 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,
});

Teile die Daten jedes Geräts discoveryToken des jeweiligen Geräts mit dem anderen Peer über deine eigene Transport-Schicht. Das Plugin führt keine Discovery oder Netzwerkoperationen für dich aus.

  • rangingUpdate liefert Distanz- und Richtungs-Updates, wenn verfügbar.
  • sessionStateChanged löst Lifecycle-Zustände aus wie running, suspended, invalidated, und peerDisconnected.
  • getDiscoveryToken() und startPeerSession() sind iOS-spezifische APIs.
  • Kameraunterstützung ist auf iOS 16+ verfügbar, sofern das Gerät dies unterstützt.