hz-platform-sdk

Horizon Platform SDK - Android/Kotlin 集成指南

这是适用于标准 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、entitlements 或 HzPlatformService

快速入门

• 设置指南：https://developers.meta.com/horizon/documentation/android-apps/ps-setup-kotlin
• Maven 构件：https://central.sonatype.com/search?namespace=com.meta.horizon.platform.sdk

可用 API

功能	参考	说明
滥用举报	abuse-report	监听系统面板中的举报按钮事件
成就	achievements	解锁、跟踪进度，以及查询简单型、计数型和位域型成就
应用	application	获取应用版本、启动其他应用、管理自更新下载
应用生命周期	application-lifecycle	检测启动类型、处理深层链接、记录深层链接结果
资源文件	asset-file	列出、下载、取消和删除可下载的资源文件（DLC）
用户同意	consent	检查并启动用户同意流程
设备应用完整性	device-application-integrity	验证设备和应用完整性令牌
Entitlements	entitlements	验证应用购买的合法性和用户授权
群组状态	group-presence	设置/清除状态、管理会话、发送邀请、启动面板
应用内购买（IAP）	iap	获取商品、购买历史记录、结账流程、消耗购买项目
语言包	language-pack	获取/设置语言包、跟踪本地化下载
排行榜	leaderboards	获取排行榜信息、筛选并读取/写入条目
通知	notifications	发送带有操作和图标的设备通知
评分和评价	rate-and-review	检查资格并启动评分/评价界面
富状态	rich-presence	设置/清除富状态以及目的地（已弃用；建议使用 group-presence）
用户年龄类别	user-age-category	查询用户年龄组并报告年龄类别
用户	users	获取用户个人资料、好友、访问令牌和身份验证

使用方法

1. 首先，阅读 references/common-setup.md，了解适用于所有 API 的通用设置说明、初始化代码和常见状态码。
2. 然后，阅读所需 API 的具体参考文件（例如，应用内购买请阅读 references/iap.md）。
3. 如需准确的方法签名，请查询 API 索引，不要猜测：metavr docs api-search "<feature> <operation>"，然后运行 metavr docs api-details <entry> 获取完整条目。

每个参考文件仅包含特定软件包的内容：API 操作、数据类型、示例和软件包专属说明。通用设置和错误码集中在 common-setup.md 中，以避免重复。