facebook/meta-wearables-dat-ios/getting-started
Claude Code and agent skill by facebook/meta-wearables-dat-ios
- community
Checking that the SKILL.md file is still in the repository.
SDK setup, Swift Package Manager integration, Info.plist configuration, and first connection to Meta glasses
Install
npx vskill@latest install facebook/meta-wearables-dat-ios/getting-startedSKILL.md
The same SKILL.md was published earlier as facebook/meta-wearables-dat-ios/getting-started.
Getting Started with DAT SDK (iOS)
Set up the Meta Wearables Device Access Toolkit in an iOS app.
Prerequisites
- Xcode 26.4+, Swift 6.3+, iOS 17.2+ deployment target — this matches the public
CameraAccessandDisplayAccesssample apps - Meta AI companion app installed on test device
- Ray-Ban Meta glasses or Meta Ray-Ban Display glasses (or use MockDeviceKit for development)
- Developer Mode enabled in Meta AI app (Settings > Your glasses > Developer Mode)
Step 1: Add the SDK via Swift Package Manager
- In Xcode, select File > Add Package Dependencies...
- Enter
https://github.com/meta/meta-wearables-dat-ios - Select a version
- Add
MWDATCoreandMWDATCamerato your target
Step 2: Configure Info.plist
Add these required entries to your Info.plist:
Replace myexampleapp with your app's URL scheme and keep MWDAT > AppLinkURLScheme in sync with it — the SDK sends that scheme to Meta AI so it can call your app back.
MetaAppID, ClientToken, and TeamID come from build settings in the sample apps. With Developer Mode you can leave MetaAppID empty, set it to 0, or leave the $(META_APP_ID) placeholder unexpanded; the SDK treats all three as "no app ID" and skips attestation. For production, set MetaAppID and ClientToken from your app in the Wearables Developer Center and set TeamID to your Apple Developer Team ID (Xcode > Signing & Capabilities).
The SDK uses a connection only when Info.plist has that connection's entries:
| Connection | Required Info.plist entries | Used for | |
|---|---|---|---|
| Bluetooth LE | bluetooth-central background mode, non-empty NSBluetoothAlwaysUsageDescription | Session setup and control, and Display content | |
| Wi-Fi | non-empty NSLocalNetworkUsageDescription, _bonjour._tcp in NSBonjourServices | Camera streaming, including capturePhoto(format:) |
With these entries, the camera stream runs over Wi-Fi and never over Bluetooth LE. Without the Wi-Fi entries, it fails with StreamError.deviceNotConnected. The SDK applies the same checks to MockDeviceKit devices.
To stream over Wi-Fi, the phone joins a Wi-Fi network that the glasses host, so the app target also needs the Hotspot Configuration capability (com.apple.developer.networking.HotspotConfiguration). Add it under Signing & Capabilities in Xcode, which sets it to true in the target's .entitlements file, as in CameraAccess. If the user denies Local Network access or declines to join the glasses' network, the camera stream fails with StreamError.deviceNotConnected and the session continues over Bluetooth LE.
Match CameraAccess by also enabling Access Wi-Fi Information (com.apple.developer.networking.wifi-info) in the app's entitlements.
Use Bluetooth LE + Wi-Fi by default. When migrating an existing app, remove external-accessory from UIBackgroundModes and remove com.meta.ar.wearable from UISupportedExternalAccessoryProtocols (remove the key if no protocols remain). Those entries enable the optional Bluetooth Classic path, not Bluetooth LE or Wi-Fi, and can cause App Review to request an MFi PPID that Meta cannot provide. Keep them only if you intentionally use Bluetooth Classic and can satisfy that requirement.
Only add the audio background mode and NSMicrophoneUsageDescription if you record glasses-microphone audio, as CameraAccess does.
Step 3: Initialize the SDK
Call Wearables.configure() once at app launch:
Step 4: Handle URL callbacks
Your app must handle the URL callback from Meta AI after registration and permission flows. Both sample apps filter on the metaWearablesAction query item so unrelated deep links are not forwarded to the SDK:
Step 5: Register with Meta AI
Observe registration state:
Step 6: Start streaming
Next steps
- Camera Streaming — Resolution, frame rate, photo capture
- MockDevice Testing — Test without hardware
- Session Lifecycle — Handle pause/resume/stop
- Permissions — Camera permission flows
- Full documentation
Security
- Security scanPassed, 100 of 100Pattern checks on the skill's files.
- Model reviewNot runA model review is scheduled for the next rescan.
Quality evaluation
- Task evaluationNot runNo evaluation yet. Run one in Skill Studio.
Source
- SKILL.md in the repositoryCheckingplugins/mwdat-ios/skills/getting-started/SKILL.md
Popularity
- Repository stars
- 529
- Repository forks
- 119
- 7-day trend score
- 31
Stars and forks are for the whole GitHub repository, not this skill alone. Not refreshed yet.
Works with
Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.
- Claude Code
- Cursor
- GitHub Copilot
- Windsurf
- Codex
- Gemini CLI
- Cline
- Amp
- Roo Code
- Goose
- Continue
- Kilo Code
- Junie
- Trae
- OpenHands
- Qwen Code
- AI Agent
- Tabnine Chat
- Sourcegraph Cody
- Amazon Q
- Firebase Genkit
- Sweep
- Devin
- Phind
- Mentat
- Claude Desktop
- Aider
- GPT Pilot
- Plandex
- bolt.new
- v0
- Replit Agent
- Anse
- TypingMind
- BetterChatGPT
- LibreChat
- Warp AI
- Pieces
- Fig AI
Embed badge
[](https://verified-skill.com/skills/facebook/meta-wearables-dat-ios/getting-started)