Meta Wearables DAT iOS
facebook/meta-wearables-dat-ios — Device Access Toolkit for iOS
Meta Wearables Device Access Toolkit (DAT) は、Meta の AI グラス(Ray-Ban Meta など)と iOS アプリを接続し、映像ストリーミングや写真撮影などのハンズフリー体験を組み込むための SDK だ。Swift Package Manager で配布され、開発者プレビュー段階にある。
アプリは Meta AI コンパニオンアプリ経由でグラスとペアリングし、MWDATCore / MWDATCamera などのモジュールでセッション管理やカメラ機能にアクセスする。物理デバイスが無い開発では MockDeviceKit でエミュレートできる。
| パス | 役割 |
|---|---|
plugins/mwdat-ios/ | Claude / Codex 向けプラグイン本体。9 本の Agent Skill と plugin.json を含む。 |
samples/CameraAccess/ | カメラストリーミング・写真撮影のサンプル Xcode プロジェクト。 |
samples/DisplayAccess/ | ディスプレイアクセス(グラス側 UI)のサンプル。 |
.cursor/rules/ | Cursor 向け glob トリガー付きルール(リポジトリ clone 時に自動読み込み)。 |
.github/copilot-instructions.md | GitHub Copilot 向けの DAT 開発ガイド(VS Code で自動ロード)。 |
AGENTS.md | AGENTS.md 対応ツール向けのポータブルなフォールバック。 |
install-skills.sh | Claude / Codex / Copilot / Cursor / AGENTS.md への一括インストールヘルパー。 |
リポジトリは 1 つの DAT ナレッジベースを、エディタごとに最適な形式(プラグイン、ルールファイル、MCP)で配布する設計になっている。
- Xcode で File > Add Package Dependencies...
- URL に
https://github.com/facebook/meta-wearables-dat-iosを指定 - タグからバージョン(例: 0.7.0)を選択
- ターゲットに
MWDATCoreとMWDATCameraを追加
Info.plist の必須設定
getting-started スキルが示す最低限の構成は次のとおり。
CFBundleURLTypes— Meta AI からのコールバック用 URL スキーム- クエリスキームに
fb-viewappを許可 UISupportedExternalAccessoryProtocolsにcom.meta.ar.wearableUIBackgroundModes—bluetooth-peripheral/external-accessoryNSBluetoothAlwaysUsageDescriptionMWDAT辞書 —AppLinkURLScheme/MetaAppID(開発時は0と Developer Mode)
アプリ起動時に Wearables.configure() を一度呼び出す。詳細は Wearables Developer Center の API リファレンス(iOS Swift DAT 0.7)を参照。
アナリティクスオプトアウト
Info.plist の MWDAT > Analytics > OptOut を YES にするとデータ収集を無効化できる。キーが無いか NO の場合は収集が有効(オプトイン)となる。
| ツール | 成果物 | セットアップ |
|---|---|---|
| Claude Code | .claude-plugin/marketplace.json + プラグイン |
claude plugin marketplace add facebook/meta-wearables-dat-ios のあと claude plugin install mwdat-ios@mwdat-ios-marketplace |
| Codex | plugins/mwdat-ios/.codex-plugin/plugin.json |
リポジトリを clone し codex plugin install ./plugins/mwdat-ios |
| GitHub Copilot | .github/copilot-instructions.md |
リポジトリをワークスペースに開く(自動ロード) |
| Cursor | .cursor/rules/*.mdc |
リポジトリをワークスペースに開く(glob トリガー) |
| AGENTS.md 系 | AGENTS.md |
エージェントがルートの AGENTS.md を読む設定 |
| MCP 対応エディタ | リモート MCP https://mcp.facebook.com/wearables_dat |
search_dat_docs でライブドキュメント検索 |
# ヘルパースクリプト(リポジトリ内)
./install-skills.sh claude
./install-skills.sh codex
./install-skills.sh all
# リモート実行
curl -sL https://raw.githubusercontent.com/facebook/meta-wearables-dat-ios/main/install-skills.sh | bash
静的リファレンスには llms.txt(full) を指定できる。
Claude / Codex プラグイン mwdat-ios(v0.7.0)に同梱される Agent Skill。いずれも DAT iOS 開発の特定領域をカバーする。
getting-started
SPM 導入、Info.plist、Wearables.configure()、初回接続。
camera-streaming
ストリーム、フレーム解像度・FPS、写真キャプチャ。
display-access
グラス側ディスプレイへの UI 表示とアクセスパターン。
mockdevice-testing
物理グラス無しで MockDeviceKit を使ったテスト。
session-lifecycle
デバイスセッション状態、一時停止・再開、可用性。
permissions-registration
アプリ登録、カメラ権限フロー。
debugging
よくある不具合、Developer Mode、バージョン互換。
dat-conventions
DAT プロジェクトの命名・構成の慣習。
sample-app-guide
サンプルを起点にした DAT アプリの組み立て方。
エンドユーザー視点での典型的な流れ。実装詳細は session-lifecycle / permissions-registration スキルを参照。
flowchart TD
A[iOS アプリ起動] --> B[Wearables.configure]
B --> C[Meta AI 経由ペアリング]
C --> D{セッション確立}
D -->|成功| E[カメラ / ディスプレイ API]
D -->|未接続| F[MockDeviceKit または再試行]
E --> G[ストリーム / 写真 / UI]
C --> H[権限・App 登録]
H --> D
| サンプル | 目的 |
|---|---|
CameraAccess |
カメラストリーミングと写真取得の UI・権限フローの参照実装。sample-app-guide スキルと対応。 |
DisplayAccess |
グラスディスプレイへのコンテンツ表示。display-access スキルと対応。 |
いずれも Xcode プロジェクトとして開き、上記 SPM 手順で SDK を解決してビルドする。