hz-platform-sdk
Horizon Platform SDK - Android/Kotlin Integration Guide
When to Use
Use this skill when a developer:
- Wants to integrate any Horizon Platform SDK feature in a Meta Quest Android/Kotlin application
- Asks about setup, initialization, or dependencies for the SDK
- Needs help with a specific public platform API (achievements, IAP, users, etc.)
- Is troubleshooting errors or status codes from any SDK package
- Asks about HorizonServiceConnection, entitlements, or HzPlatformService
Quick Start
- Setup guide: https://developers.meta.com/horizon/documentation/android-apps/ps-setup-kotlin
- Maven artifacts: https://central.sonatype.com/search?namespace=com.meta.horizon.platform.sdk
Available APIs
| Feature | Reference | Description |
|---|---|---|
| Abuse Report | abuse-report |
Listen for report button events in the system panel |
| 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, log deeplink results |
| Asset File | asset-file |
List, download, cancel, and delete downloadable asset files (DLC) |
| Consent | consent |
Check and launch user consent flows |
| Device Application Integrity | device-application-integrity |
Verify device and app integrity tokens |
| Entitlements | entitlements |
Verify app purchase legitimacy and user authorization |
| Group Presence | group-presence |
Set/clear presence, manage sessions, send invites, launch panels |
| In-App Purchases (IAP) | iap |
Retrieve products, purchase history, checkout flow, consume purchases |
| Language Pack | language-pack |
Get/set language packs, track localization downloads |
| Leaderboards | leaderboards |
Retrieve leaderboard info, fetch/write entries with filtering |
| Notifications | notifications |
Send device notifications with actions and icons |
| Rate and Review | rate-and-review |
Check eligibility and launch the rating/review UI |
| Rich Presence | rich-presence |
Set/clear rich presence status and destinations (deprecated; prefer group-presence) |
| User Age Category | user-age-category |
Query user age group and report age categories |
| Users | users |
Retrieve user profiles, friends, access tokens, identity verification |
How to Use
- First, read
references/common-setup.mdfor shared setup instructions, initialization code, and common status codes that apply to all APIs. - Then, read the specific reference file for the API you need (e.g.,
references/iap.mdfor in-app purchases).
Each reference file contains only the package-specific content: API operations, data types, examples, and package-specific notes. The common setup and error codes are centralized in common-setup.md to avoid duplication.
More from meta-quest/agentic-tools
hz-perfetto-debug
Analyzes Meta Quest and Horizon OS VR performance using Perfetto traces — frame timing, CPU/GPU bottlenecks, render pass analysis. Use when profiling frame drops, jank, or thermal issues on Quest devices.
20hz-iwsdk-webxr
Builds WebXR experiences for Meta Quest and Horizon OS using the Immersive Web SDK (IWSDK) — ECS architecture, Three.js integration, spatial UI. Use when creating web-based VR/MR apps for Quest Browser.
19hz-new-project-creation
Scaffolds new Meta Quest and Horizon OS projects with recommended settings for Unity, Unreal, Android/Spatial SDK, or WebXR. Use when creating a new Quest app from scratch.
17hzdb-cli
>-
16hz-immersive-designer
Guides design of comfortable, intuitive VR/MR experiences for Meta Quest and Horizon OS — comfort guidelines, interaction patterns, spatial layout, accessibility. Use during UX design review or when evaluating comfort and accessibility.
16hz-vr-debug
Debugs Meta Quest and Horizon OS VR/MR applications using the hzdb CLI — view logs, capture screenshots, diagnose common issues. Use when troubleshooting crashes, errors, or unexpected behavior on Quest devices.
15