发布

用于增强社交互动和关系网络的 API

更新时间: 2026年2月18日

想要在您的应用中为受众提供更多竞技、创作或结交新朋友的方式吗？通过实施下面一组社交类 API，您可以最大限度地增强社交关系网络和参与度，同时减少与社交 VR 相关的许多摩擦。

请参阅下文，了解每项 API 功能的概览、用例示例以及相关技术文档，帮助您轻松上手。

通过实施目标位置、组队模拟以及深度链接功能，您无需多费多少力气，就能帮助受众加强在应用内外的联系。上述功能可实现以下效果：

通过唯一的网址远程启动您的应用，并进行跨渠道分享，比如在 Meta Horizon 移动应用、Discord、Twitter、Facebook、您的网站、邮件简报或者任何其他支持网址超链接的渠道/界面上分享。

帮助您的受众结识对您的应用同样感兴趣的新朋友。使用我们的“公开派对”查找器，您还可以在应用之外联系用户。

允许用户通过“派对” 或 Messenger 以群组方式同时启动您的应用。

让用户能够邀请好友一同参与体验，或是加入其他用户已经开启的体验中。

一旦用户的得分被超越，他们会在手机上收到通知，Meta Horizon 主控室动态中的玩家成绩窗口上也会显示。他们可以在此窗口中查看排行榜或挑战菜单，然后启动应用，尝试重新夺回自己的领先位置。

所有这些功能均可通过平台 SDK 实现，我们会继续开发新的开发者产品和功能，从而扩大这类用例。请参阅下文，了解有关这些社交类 API 的更详细概述。如果您想上手使用，请查阅以下适用于 Unity、Unreal 以及原生开发的有关目标位置和组队模拟的技术文档。

目标位置

目标位置是指一组由您定义的位置，比如某个关卡或游戏模式。该功能使得相关位置信息可以从头戴设备内部、Meta Horizon 移动应用、您的产品详情页面、“派对”页面、“挑战”页面、Facebook 以及 oculus.com 上展示和分享。

对于每个目标位置，您可以加入以下背景信息来提升终端用户体验：

目标位置标题

文字说明

富媒体

同时启动时群组的最小和最大容量（可选）

文本描述和目标位置标题应根据您的应用支持的每种语言进行翻译，而容量数字则帮助各组玩家在不启动应用的情况下，浏览和发现派对中正在开展的活动。

组队模拟

通过经常设置组队模拟，您可以让用户分享他们在您应用中的位置和当前状态，从而方便其他人加入体验。这些数据会显示在我们的平台上，方便我们实施邀请和加入系统，为用户推荐在特定时刻 VR 中比较热门的地点，以及提供邀请功能（包括补充有关您的应用或对应具体实例详情的元数据）。

您可以为 GroupPresenceOptions 结构设置 4 项功能，但这些功能最终要方便您的受众了解以下信息：

用户在您的应用中正在体验的目标位置。

他们正在参与的活动（玩多玩家游戏、单玩家游戏等）。

当前活动的结束时间。

深度链接 API

您的应用使用深度链接 API 来确认用户在启动应用时打算访问的目标位置或实例。这可能是特定的排行榜级别，或是一群朋友所在的房间。当我们引导用户从平台进入您的应用时，深度链接 API 是确保他们能够到达预期位置的方法。

应用还可能在会话期间通过深度链接 API 获取更新，例如当用户通过系统用户界面悬窗启动进入到您应用中的其他位置时。

我们推荐通过三种场景最大限度提升用户参与度：

加入用户：在头戴设备中，用户从好友名单、“派对”窗口或主控室动态中轻触另一位用户的前往按钮。

直接启动：您的等级或实例标题会出现在人数众多的热门目标位置。用户可从深度链接网址访问目标位置，远程启动应用。

组队启动：两位用户为一组从可选的地点列表中挑选一个特定级别，随后两人都轻触**启动**按钮，接着便被引导至您应用中的相应实例。

深度链接网址和远程启动

实施深度链接 API 后，您就可以利用远程启动的端到端功能，允许用户通过网址直接从手机或笔记本电脑上的移动应用或网页浏览器启动 VR 体验。用户可以邀请其他人并分享有关网址，帮助其他人到达他们所在的应用内位置。作为开发者，您还可以利用这些网址开展 VR 活动的宣传和协调工作。

每个目标位置都有自己的网址，并且这些网址会显示在开发者面板中。您只需在开发者面板中点击省略号和前往目标位置即可生成网址并开始分享该目标位置。更多信息请参阅管理和分享目标位置一节中有关目标位置和组队模拟的文档（适用于 Unity、Unreal 以及原生开发）。

我们的互动系统旨在通过组织社群比赛、支持高分共享、增强成就感等多种途径，为用户提供更多重返 VR 并与他人建立联系的动力。当您实施这些功能时，由于其中许多功能会与目标位置、详细状态和深度链接 API 直接集成，所以上述目标均可实现。

用户身份与好友

用户对象和相关 API 可确保用户分享合适的数据，进而实现社交体验。这些功能有助于您更好地了解用户及其关系网络以及他们最近在您应用中的互动情况，从而促进各种多玩家游戏/社交互动。

用户、好友以及关系文档：Unity、Unreal 以及原生开发。

排行榜互动系统与通知

通过设置排行榜，您不仅能为受众提供一种全新的竞技方式，还能通过通知机制，在好友超过最高分时提醒用户，从而让受众持续互动。

排行榜还可以对深度链接框架和目标位置功能加以利用。如果您已经实施了深度链接和目标位置，当用户在 Meta Horizon 移动应用中收到排名通知或在主控室动态中看到排名更新时，就能直接预览自己在排行榜上的具体级别，然后再启动进入您的应用体验中，重新夺回自己的领先位置（参阅下方截图示例）。用户甚至可以直接从 Meta Horizon 移动应用内远程启动您的应用。

User home feed with recent score updates

如果您的应用支持跨平台使用，您还可以利用新的联合用户模式，让您的开发者挑战和全球排行榜能够在各个平台上通用。注意：用户挑战是平台级别的功能，因此目前不涉及联合用户模式。

排行榜文档：Unity、Unreal 以及原生开发。

挑战：用户生成或开发者生成

挑战是一种有时限性的个人排行榜，可以与特定的好友群组、社群共享，或者通过可分享的网址对外公开。如果您的应用同时集成了排行榜和深度链接，用户便能在排行榜的基础上自动创建挑战，而无需您和您的团队进行额外操作。应用在更新排行榜的同时也会同步更新挑战，我们已对玩家成绩应用、动态以及通知进行了更新，以突显这些挑战，增强您应用中竞技活动的相关性。

Developer challenges example from Beat Saber

为了更好地与您的受众建立联系并鼓励竞争或协作，您可以利用“开发者挑战”功能创建自定义挑战和排位赛，由您和您的团队进行管理。无论是让您的社群成员向团队中的开发者还是有影响力的社群成员发起挑战，此功能可以结合唯一的网址、各种通知并通过多个渠道推广，以多种方式助力加强社交互动。

除了在系统层面展示这些开发者挑战，这些挑战还能够直接集成进您的应用中，为那些寻求下一步操作指引的用户提供一种吸引人的全新体验。每日或每周挑战可以很好地吸引用户回到您的应用中，同时利用我们的 VR 和移动应用中面向用户的渠道，提醒用户回来参与比拼。

请参阅下文，了解 Kluge Interactive⁠ 公司旗下 Synth Riders⁠ 游戏的挑战屏幕示例。

Example UI screen for challenge within Synth Riders VR application.

挑战相关文档：Unity、Unreal 以及原生开发。

成就

您可以通过多种灵活选项设计平台成就，包括（但不限于）完成特定级别、收集一定数量的某种资源以及在限定时间内击败某个 Boss 等。

这些成就会显示在用户的 Meta 个人主页上、Meta Quest 移动应用中以及各种 VR 界面上。它们不仅是让用户获得成就感的绝佳途径，也是向社群展示荣誉的象征，同时还是激励用户与您的应用持续互动的一系列新目标。

成就相关文档：Unity、Unreal 以及原生开发。

活动

您可以通过在应用中举办限时活动，增加您的同时在线用户人数和月活跃用户数。这些活动可以包括竞技比赛、媒体观影活动或社交聚会。

要创建新活动，只需在开发者面板中填写必填字段。此外，您可以为活动上传一个 2D 宣传片，以便在用户主控室动态的“Horizon 动态”部分显示。

活动相关文档：Unity、Unreal 以及原生开发。

开发者帖文

您可以借助开发者帖文功能，向受众介绍最新的挑战、比赛、排行榜、应用动态、DLC 等信息。此类内容可以在您的商品详情页面以及用户的主控室动态中展示，同时您还可以通过开发者帖文分析提供有关日后更新的信息。

创建和发布开发者帖文的过程非常简单，只需在开发者面板中输入文字并提供图片内容。此外，这项功能还支持深度链接网址，有助于简化用户从动态跳转到您应用中的过程。有关创建和管理帖文的完整指南，请参阅开发者帖文。

开发者帖文相关文档：Unity、Unreal 以及原生开发。