meta-quest/hz-unity-platform-sdk

Horizon Platform SDK - Unity/C# Integration Guide

When to Use

Use this skill when a developer:

• Wants to integrate any Horizon Platform SDK feature in a Unity Meta Quest application
• Asks about setup, initialization, or dependencies for the Unity SDK package (com.meta.xr.sdk.platform)
• Needs help with a specific public platform API (achievements, IAP, users, etc.) in C#
• Is troubleshooting errors or status codes from any SDK package in Unity
• Asks about Core.AsyncInitialize, Oculus.Platform, or platform message handling

For Android/Kotlin apps, use the hz-platform-sdk skill instead.

Quick Start

• Setup guide: https://developers.meta.com/horizon/documentation/unity/ps-platform-intro/
• UPM Package: com.meta.xr.sdk.platform via Unity Package Manager
• Namespace: Oculus.Platform (backward compatible with legacy LibOVRPlatform SDK)

Available APIs

| Feature | Reference | Description | |---------|-----------|-------------| | Abuse Report | abuse-report | Listen for system Report button events, respond with in-app flow | | Achievements | achievements | Unlock, track progress, and query simple/count/bitfield achievements | | Application | application | Get app version, launch other apps, manage self-update downloads | | Application Lifecycle | application-lifecycle | Detect launch type, handle deeplinks and invites, log results | | Asset File | asset-file | List, download, cancel, and delete downloadable asset files (DLC) | | Challenges | challenges | Time-bound score competitions on top of leaderboards | | Consent | consent | Check and launch user consent flows with version bumps | | Device Application Integrity | device-application-integrity | Verify device and app integrity via JWT attestation | | Entitlements | entitlements | Mandatory anti-piracy check required for all Store apps | | Group Presence | group-presence | Set/clear presence, manage sessions, send invites, handle join intents | | In-App Purchases (IAP) | iap | Retrieve products, purchase history, checkout flow, consume purchases | | Language Pack | language-pack | Get/set language packs with auto-download | | Leaderboards | leaderboards | Retrieve leaderboard info, fetch/write entries with filtering | | Notifications | notifications | Send device notifications with toast, feed persistence, and action buttons | | Rate and Review | rate-and-review | Check eligibility and launch the system rating/review UI | | Rich Presence | rich-presence | Set/clear rich presence (deprecated; prefer group-presence) | | User Age Category | user-age-category | Query user age group and report age categories for compliance | | Users | users | Retrieve user profiles, friends, access tokens, identity verification |

How to Use

1. First, read references/common-setup.md for shared setup instructions, initialization code, Editor testing, and common patterns that apply to all APIs.
2. Then, read the specific reference file for the API you need (e.g., references/iap.md for in-app purchases).

Each reference file contains only the package-specific content: API operations, data types, examples, and package-specific notes. The common setup, initialization patterns, and coding conventions are centralized in common-setup.md to avoid duplication.