facebook/meta-wearables-dat-ios/getting-started

Claude Code and agent skill by facebook/meta-wearables-dat-ios

Trust tier 2
  • community
LLM review pending
Source check pending

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-started

SKILL.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 CameraAccess and DisplayAccess sample 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

  1. In Xcode, select File > Add Package Dependencies...
  2. Enter https://github.com/meta/meta-wearables-dat-ios
  3. Select a version
  4. Add MWDATCore and MWDATCamera to your target

Step 2: Configure Info.plist

Add these required entries to your Info.plist:

xml
<!-- URL scheme for Meta AI callbacks -->
<key>CFBundleURLTypes</key>
<array>
<dict>
<key>CFBundleTypeRole</key>
<string>Editor</string>
<key>CFBundleURLName</key>
<string>$(PRODUCT_BUNDLE_IDENTIFIER)</string>
<key>CFBundleURLSchemes</key>
<array>
<string>myexampleapp</string>
</array>
</dict>
</array>
<!-- DAT configuration -->
<key>MWDAT</key>
<dict>
<key>AppLinkURLScheme</key>
<string>myexampleapp://</string>
<key>MetaAppID</key>
<string>$(META_APP_ID)</string>
<key>ClientToken</key>
<string>$(CLIENT_TOKEN)</string>
<key>TeamID</key>
<string>$(DEVELOPMENT_TEAM)</string>
</dict>
<!-- Background modes and Bluetooth LE access -->
<key>UIBackgroundModes</key>
<array>
<string>processing</string>
<string>bluetooth-central</string>
<string>bluetooth-peripheral</string>
</array>
<key>NSBluetoothAlwaysUsageDescription</key>
<string>Needed to connect to Meta AI Glasses</string>
<!-- Local network access for Wi-Fi camera streaming -->
<key>NSLocalNetworkUsageDescription</key>
<string>This lets your phone find and connect to your glasses over Wi-Fi.</string>
<key>NSBonjourServices</key>
<array>
<string>_bonjour._tcp</string>
</array>

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:

ConnectionRequired Info.plist entriesUsed for
Bluetooth LEbluetooth-central background mode, non-empty NSBluetoothAlwaysUsageDescriptionSession setup and control, and Display content
Wi-Finon-empty NSLocalNetworkUsageDescription, _bonjour._tcp in NSBonjourServicesCamera 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:

swift
import MWDATCore
@main
struct MyApp: App {
init() {
do {
try Wearables.configure()
} catch {
assertionFailure("Failed to configure Wearables SDK: \(error)")
}
}
var body: some Scene {
WindowGroup {
ContentView()
}
}
}

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:

swift
.onOpenURL { url in
guard
let components = URLComponents(url: url, resolvingAgainstBaseURL: false),
components.queryItems?.contains(where: { $0.name == "metaWearablesAction" }) == true
else {
return
}
Task {
do {
_ = try await Wearables.shared.handleUrl(url)
} catch {
// Surface the failure; `handleUrl` throws `WearablesHandleURLError`
}
}
}

Step 5: Register with Meta AI

swift
func startRegistration() async throws {
try await Wearables.shared.startRegistration()
}

Observe registration state:

swift
Task {
for await state in Wearables.shared.registrationStateStream() {
// Update UI based on registration state
}
}

Step 6: Start streaming

swift
import MWDATCore
import MWDATCamera
// Create a DeviceSession — device selection is configured here
let wearables = Wearables.shared
let deviceSelector = AutoDeviceSelector(wearables: wearables)
let deviceSession = try wearables.createSession(deviceSelector: deviceSelector)
let states = deviceSession.stateStream()
try deviceSession.start()
// Wait for the device session to reach the started state
for await state in states {
if state == .started { break }
}
// Check camera permission before adding the camera
if try await wearables.checkPermissionStatus(.camera) != .granted {
// Confirm with the user, then:
guard try await wearables.requestPermission(.camera) == .granted else { return }
}
let config = StreamConfiguration(
videoCodec: .raw,
resolution: .low,
frameRate: 24
)
guard let camera = try deviceSession.addCamera(config: config) else {
return
}
let stream = camera.stream
// Observe frames
let frameToken = stream.videoFramePublisher.listen { frame in
guard let image = frame.makeUIImage() else { return }
Task { @MainActor in
self.currentFrame = image
}
}
// Start the stream capability
stream.start()

Next steps

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

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
vskill VERIFIED badge
[![vskill VERIFIED](https://verified-skill.com/api/v1/skills/facebook/meta-wearables-dat-ios/getting-started/badge)](https://verified-skill.com/skills/facebook/meta-wearables-dat-ios/getting-started)

Something wrong with this skill or its page? Tell us.