mcpField
H
hz-platform-sdk

hz-platform-sdk

github.com/meta-quest開発241190 回インストール5 週間前に更新
リポジトリ

hz-platform-sdk について

Horizon Platform SDK を使って Meta VR アプリを Android/Kotlin で開発する方向けの API リファレンススキルです。セットアップ、初期化、トラブルシューティング、公開 API を機能別に参照できます。Unity/C# 開発には別のスキルを案内します。

主な機能

  1. 01Android/Kotlin の SDK 統合リファレンス
  2. 02実績、IAP、ユーザーなどの API を網羅
  3. 03共通セットアップと初期化の説明
  4. 04機能別のリファレンス構成
  5. 05API インデックスと詳細の検索

活用シーン

  1. 01Meta VR アプリへのプラットフォーム機能の統合
  2. 02API 操作やデータ型の確認
  3. 03SDK のエラーやステータスコードの調査

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/meta-quest/agentic-tools --skill hz-platform-sdk

インストール後、Claude Code で/hz-platform-sdkを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

references/
abuse-report.md
achievements.md
application-lifecycle.md
application.md
asset-file.md
common-setup.md
consent.md
device-application-integrity.md
entitlements.md
group-presence.md
iap.md
language-pack.md
leaderboards.md
notifications.md
rate-and-review.md
rich-presence.md
user-age-category.md
users.md

詳細

Horizon Platform SDK - Android/Kotlin 統合ガイド

これは、Standard Android および Meta Spatial SDK の Android/Kotlin ビルドパス向けの API リファレンススキルです。 コードベースの分析と統合をガイド付きで進める場合は、 hz-psdk-integration を使用してください。Unity/C# の場合は、代わりに hz-unity-platform-sdk を使用してください。

使用する場面

開発者が次のことを行う場合に、このスキルを使用してください。

  • Meta VR Android/Kotlin アプリケーションに Horizon Platform SDK の機能を統合したい
  • SDK のセットアップ、初期化、または依存関係について質問している
  • 特定の公開プラットフォーム API（実績、IAP、ユーザーなど）のサポートが必要
  • SDK パッケージのエラーやステータスコードのトラブルシューティングをしている
  • HorizonServiceConnection、エンタイトルメント、または HzPlatformService について質問している

クイックスタート

利用可能な API

機能リファレンス説明
不正行為の報告abuse-reportシステムパネルの報告ボタンのイベントをリッスンします
実績achievementsシンプル、カウント、ビットフィールド形式の実績を解除し、進行状況を追跡して照会します
アプリケーションapplicationアプリのバージョンを取得し、ほかのアプリを起動して、セルフアップデートのダウンロードを管理します
アプリケーションのライフサイクルapplication-lifecycle起動の種類を検出し、ディープリンクを処理して、ディープリンクの結果を記録します
アセットファイルasset-fileダウンロード可能なアセットファイル（DLC）を一覧表示、ダウンロード、キャンセル、削除します
同意consentユーザーの同意フローを確認して開始します
デバイスとアプリケーションの整合性device-application-integrityデバイスとアプリの整合性トークンを検証します
エンタイトルメントentitlementsアプリの購入の正当性とユーザー認証を検証します
グループプレゼンスgroup-presenceプレゼンスの設定と解除、セッションの管理、招待の送信、パネルの起動を行います
アプリ内購入（IAP）iap商品と購入履歴の取得、チェックアウトフロー、購入の消費を行います
言語パックlanguage-pack言語パックの取得と設定を行い、ローカライズのダウンロードを追跡します
リーダーボードleaderboardsリーダーボード情報を取得し、フィルタリングしてエントリーを取得・書き込みます
通知notificationsアクションとアイコン付きのデバイス通知を送信します
評価とレビューrate-and-review評価とレビューの UI を利用できるか確認し、起動します
リッチプレゼンスrich-presenceリッチプレゼンスのステータスと遷移先を設定・解除します（非推奨。代わりに group-presence を推奨）
ユーザーの年齢カテゴリuser-age-categoryユーザーの年齢層を照会し、年齢カテゴリを報告します
ユーザーusersユーザープロフィール、友達、アクセストークン、本人確認情報を取得します

使用方法

  1. まず、すべての API に適用される共通のセットアップ手順、初期化コード、一般的なステータスコードについて、references/common-setup.md を読んでください。
  2. 次に、必要な API のリファレンスファイルを読んでください（例：アプリ内購入については references/iap.md）。
  3. 正確なシグネチャを確認するには、推測せずに API インデックスを検索してください：metavr docs api-search "<feature> <operation>" を実行し、続けて metavr docs api-details <entry> を実行すると、エントリー全体を確認できます。

各リファレンスファイルには、API 操作、データ型、例、パッケージ固有の注意事項など、パッケージ固有の内容のみが記載されています。重複を避けるため、共通のセットアップとエラーコードは common-setup.md に集約されています。

コメント

Markdown 対応