Meta Wearables DAT iOS

facebook/meta-wearables-dat-ios — Device Access Toolkit for iOS

1 — 概要

Meta Wearables Device Access Toolkit (DAT) は、Meta の AI グラス(Ray-Ban Meta など)と iOS アプリを接続し、映像ストリーミングや写真撮影などのハンズフリー体験を組み込むための SDK だ。Swift Package Manager で配布され、開発者プレビュー段階にある。

0.7.0SDK バージョン
iOS 16+デプロイターゲット
Xcode 15+ビルド要件
9プラグインスキル

アプリは Meta AI コンパニオンアプリ経由でグラスとペアリングし、MWDATCore / MWDATCamera などのモジュールでセッション管理やカメラ機能にアクセスする。物理デバイスが無い開発では MockDeviceKit でエミュレートできる。

開発者プレビュー: SDK とドキュメントは公開されているが、本番リリース前の段階。Wearables Developer Center で組織・リリースチャネルを登録し、テストユーザーと共有する運用が想定されている。
2 — リポジトリ構成
パス役割
plugins/mwdat-ios/Claude / Codex 向けプラグイン本体。9 本の Agent Skill と plugin.json を含む。
samples/CameraAccess/カメラストリーミング・写真撮影のサンプル Xcode プロジェクト。
samples/DisplayAccess/ディスプレイアクセス(グラス側 UI)のサンプル。
.cursor/rules/Cursor 向け glob トリガー付きルール(リポジトリ clone 時に自動読み込み)。
.github/copilot-instructions.mdGitHub Copilot 向けの DAT 開発ガイド(VS Code で自動ロード)。
AGENTS.mdAGENTS.md 対応ツール向けのポータブルなフォールバック。
install-skills.shClaude / Codex / Copilot / Cursor / AGENTS.md への一括インストールヘルパー。

リポジトリは 1 つの DAT ナレッジベースを、エディタごとに最適な形式(プラグイン、ルールファイル、MCP)で配布する設計になっている。

3 — SDK 導入
  1. Xcode で File > Add Package Dependencies...
  2. URL に https://github.com/facebook/meta-wearables-dat-ios を指定
  3. タグからバージョン(例: 0.7.0)を選択
  4. ターゲットに MWDATCore と MWDATCamera を追加

Info.plist の必須設定

getting-started スキルが示す最低限の構成は次のとおり。

  • CFBundleURLTypes — Meta AI からのコールバック用 URL スキーム
  • クエリスキームに fb-viewapp を許可
  • UISupportedExternalAccessoryProtocols に com.meta.ar.wearable
  • UIBackgroundModes — bluetooth-peripheral / external-accessory
  • NSBluetoothAlwaysUsageDescription
  • MWDAT 辞書 — AppLinkURLScheme / MetaAppID(開発時は 0 と Developer Mode)

アプリ起動時に Wearables.configure() を一度呼び出す。詳細は Wearables Developer Center の API リファレンス(iOS Swift DAT 0.7)を参照。

アナリティクスオプトアウト

Info.plist の MWDAT > Analytics > OptOut を YES にするとデータ収集を無効化できる。キーが無いか NO の場合は収集が有効(オプトイン)となる。

4 — AI ツール連携
ツール成果物セットアップ
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) を指定できる。

5 — プラグインスキル一覧

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 アプリの組み立て方。

6 — 接続フロー(概略)

エンドユーザー視点での典型的な流れ。実装詳細は 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
        
前提: テスト端末に Meta AI アプリが入っていること。実機グラス利用時は Meta AI 内で Developer Mode(Settings > Your glasses)を有効にする。
7 — サンプルアプリ
サンプル目的
CameraAccess カメラストリーミングと写真取得の UI・権限フローの参照実装。sample-app-guide スキルと対応。
DisplayAccess グラスディスプレイへのコンテンツ表示。display-access スキルと対応。

いずれも Xcode プロジェクトとして開き、上記 SPM 手順で SDK を解決してビルドする。