hz-unity-platform-sdk について
hz-unity-platform-sdkは、Unity製VRアプリにMeta Horizon Platform SDKを統合する開発者向けのガイドです。共通設定と機能別APIリファレンスを分け、C#での利用を扱います。
主な機能
- 01Unity SDKの設定と初期化ガイド
- 02プラットフォームAPIのC#リファレンス
- 03実績、IAP、ユーザーなどの機能案内
- 04Unity SDKのエラーとステータスコードの調査
活用シーン
- 01UnityプラットフォームSDKの設定
- 02実績やアプリ内購入の実装
- 03プラットフォームメッセージと初期化の処理
- 04UnityでのSDKエラーの調査
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ meta-quest/ agentic-tools --skill hz-unity-platform-sdkインストール後、Claude Code で/hz-unity-platform-sdkを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
references/abuse-report.mdachievements.mdapplication-lifecycle.mdapplication.mdasset-file.mdchallenges.mdcommon-setup.mdconsent.mddevice-application-integrity.mdentitlements.mdgroup-presence.mdiap.mdlanguage-pack.mdleaderboards.mdnotifications.mdrate-and-review.mdrich-presence.mduser-age-category.mdusers.md詳細
Horizon Platform SDK - Unity/C# 連携ガイド
使用する場面
開発者が次のことを行う場合に、このスキルを使用します。
- Unity の Meta VR アプリケーションに Horizon Platform SDK の機能を統合したい
- Unity SDK パッケージ(
com.meta.xr.sdk.platform)のセットアップ、初期化、依存関係について質問する - C# で特定の公開プラットフォーム API(実績、IAP、ユーザーなど)を利用するためのサポートが必要
- Unity のいずれかの SDK パッケージで発生するエラーやステータスコードのトラブルシューティングが必要
Core.AsyncInitialize、Oculus.Platform、またはプラットフォームのメッセージ処理について質問する
Android/Kotlin アプリには、代わりに hz-platform-sdk スキルを使用してください。
クイックスタート
- セットアップガイド:https://developers.meta.com/horizon/documentation/unity/ps-platform-intro/
- UPM パッケージ:Unity Package Manager 経由で
com.meta.xr.sdk.platform - 名前空間:
Oculus.Platform(従来の LibOVRPlatform SDK との下位互換性があります)
利用可能な API
| 機能 | リファレンス | 説明 |
|---|---|---|
| 不正行為の報告 | abuse-report | システムの報告ボタンイベントを監視し、アプリ内フローで対応します |
| 実績 | achievements | シンプル、カウント、ビットフィールド形式の実績を解除し、進行状況を追跡して照会します |
| アプリケーション | application | アプリのバージョンを取得し、他のアプリを起動し、セルフアップデートのダウンロードを管理します |
| アプリケーションのライフサイクル | application-lifecycle | 起動の種類を検出し、ディープリンクや招待を処理して、結果を記録します |
| アセットファイル | asset-file | ダウンロード可能なアセットファイル(DLC)の一覧表示、ダウンロード、キャンセル、削除を行います |
| チャレンジ | challenges | リーダーボードを基盤とした、期間限定のスコア競争です |
| 同意 | consent | バージョン更新を伴うユーザー同意フローを確認して開始します |
| デバイスとアプリケーションの整合性 | device-application-integrity | JWT アテステーションを通じて、デバイスとアプリの整合性を検証します |
| エンタイトルメント | entitlements | すべての Store アプリで必須となる海賊版対策チェックです |
| グループプレゼンス | group-presence | プレゼンスの設定/解除、セッション管理、招待の送信、参加インテントの処理を行います |
| アプリ内購入(IAP) | iap | 商品、購入履歴、チェックアウトフローの取得と、購入の消費を行います |
| 言語パック | language-pack | 言語パックを取得/設定し、自動ダウンロードを行います |
| リーダーボード | leaderboards | リーダーボード情報を取得し、フィルタリングしてエントリーを取得/書き込みます |
| 通知 | notifications | トースト、フィードへの保存、アクションボタンを使ってデバイス通知を送信します |
| 評価とレビュー | rate-and-review | 対象条件を確認し、システムの評価/レビュー UI を起動します |
| リッチプレゼンス | rich-presence | リッチプレゼンスを設定/解除します(非推奨です。group-presence の使用を推奨します) |
| ユーザーの年齢カテゴリ | user-age-category | ユーザーの年齢グループを照会し、コンプライアンス対応のため年齢カテゴリを報告します |
| ユーザー | users | ユーザープロフィール、友達、アクセストークン、本人確認情報を取得します |
使用方法
- まず、
references/common-setup.mdを読み、すべての API に共通するセットアップ手順、初期化コード、エディターでのテスト、一般的なパターンを確認します。 - 次に、使用する API のリファレンスファイルを読みます(例:アプリ内購入の場合は
references/iap.md)。 - 正確なシグネチャを確認するには、推測せずに API インデックスを検索します。
metavr docs api-search "<feature> <operation>"を実行し、続いてmetavr docs api-details <entry>を実行すると、エントリー全体を確認できます。
各リファレンスファイルには、そのパッケージ固有の内容である API 操作、データ型、例、パッケージ固有の注意事項のみが記載されています。重複を避けるため、共通のセットアップ、初期化パターン、コーディング規約は common-setup.md にまとめられています。
コメント
Markdown 対応