hz-unity-platform-sdk

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	所有商店应用都必须进行的反盗版检查
群组状态	group-presence	设置/清除状态、管理会话、发送邀请并处理加入意图
应用内购买（IAP）	iap	获取商品和购买记录、完成结账流程，以及消耗购买项
语言包	language-pack	获取/设置语言包并自动下载
排行榜	leaderboards	获取排行榜信息，并通过筛选获取/提交排行榜记录
通知	notifications	发送设备通知，支持 Toast、动态消息持久化和操作按钮
评分与评论	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 中，以避免重复。