iOS-Setup
Kopiere einen Setup-Prompt mit den Installationsschritten und dem vollständigen Markdown-Guide für dieses Plugin.
Verwendetes iOS-natives System
Abschnitt mit dem Titel „Verwendetes natives iOS-System“Auf iOS verwendet dieses Plugin Nearby Interaction vom NearbyInteraction Framework.
Anforderungen
Abschnitt „Voraussetzungen“- iOS 15+
- Physisches Gerät mit UWB-Hardware
- Nearby Interaction-Fähigkeit in Xcode aktiviert
Xcode-Setup
Abschnitt mit dem Titel „Xcode-Einrichtung“- Öffnen Sie Ihr iOS-App-Target in Xcode.
- Gehe zu Signing & Capabilities.
- Klicken + Capability und hinzufügen Nearby Interaction.
- Füge eine Nutzungserklärung zu
Info.plist:
<key>NSNearbyInteractionUsageDescription</key><string>This app uses Ultra Wideband to measure distance to nearby devices.</string>Client-Flow
Abschnitt mit dem Titel „Client-Flow“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.
Events
Abschnitt „Events“rangingUpdateliefert Distanz- und Richtungs-Updates, wenn verfügbar.sessionStateChangedlöst Lifecycle-Zustände aus wierunning,suspended,invalidated, undpeerDisconnected.
getDiscoveryToken()undstartPeerSession()sind iOS-spezifische APIs.- Kameraunterstützung ist auf iOS 16+ verfügbar, sofern das Gerät dies unterstützt.