目标位置概览 Apps for children can't use Platform SDK features
如果您自我证明 您的应用主要用于未满 13 岁的儿童,则必须避免使用平台 SDK 功能。这一限制确保遵守特定于年龄的守则。为确保合规性,已为您的应用禁用数据使用情况检查。 目标位置 是沉浸式 应用中的日常聚会场所。它们可以采用多种形式,包括多玩家服务器、匹配池或活动的特定配置。您可以将图片、翻译说明和元数据(即玩家限制)等富媒体与这些目标位置关联起来。每个目标位置都有一个关联的网址,您可以用它通过社交媒体分享新的游戏关卡或游戏模式。Meta Horizon 商店可以将这些目标位置作为推荐活动显示在您的应用商店页面和派对页面上,使用户只需点击一下即可进入有趣的体验。
目标位置对
多玩家游戏功能 而言至关重要,任何多玩家游戏体验的第一步都是通过各自的 API 集成目标位置、组队模拟和深度链接。这些 API 协同工作来推动社交和分享体验,为您的应用带来更多用户。每个 API 都会让您的游戏更具可操作性,允许用户单独或与好友一起前往目标位置。这些功能共同使用时,可以在平台、应用的实体店公共主页甚至社交媒体上分享位置。
为您的应用创建目标位置需要创建一个应用并将其上传到开发者面板。
深度链接 可在应用启动时提供更多结构化数据。借助深度链接,开发者能够引导一位或多位用户进入特定的体验。
每当用户启动您的应用加入某人或导航至某个目标位置时,深度链接都会包含所需目标位置的相关信息。此外,还提供可选的深度链接消息字段,用于包含更多数据。用户只需点击一下,即可从您的应用商店页面跳转到应用中的人员或地点。深度链接可以跨社交平台分享,从而推动 VR 之外的应用程序互动。
用户选择分享其
组队模拟 时,其好友可以看到他们是否在应用中,是否在玩特定的地图,或者是否参加了某个活动。用户可以通过活动隐私设置来控制其在线状态。用户可以看到好友的状态,加入他们,并被传送到与好友相同的目标位置。
例如,想象一下您在游戏中添加新地图的场景。通过组队模拟、目标位置和深度链接:
用户可以看到其好友正在玩新地图,并启动应用到新地图以加入 其好友一同游戏。 用户可以看到新地图的营销活动,并直接启动 应用前往新地图的目标位置。 两个好友可以同时小组启动 进入您的应用,前往新地图的目标位置一起玩。 可以根据用户的活动和是否可加入来配置目标位置,从而提供最相关的上下文。例如,目标位置可以帮助用户在 1v1 游戏中寻找匹配,或者提供一个中心引导用户进入应用大厅。
为您的应用定义一个或多个目标位置可让您实现组队模拟功能,然后您可以深度链接到该功能。
您的应用代码会为用户设置目标位置,用户可以选择将其作为自己的在线状态与好友或任何人分享。
当用户选择通过其组队模拟加入其他用户或直接启动到特定目标位置时,深度链接将用于启动该应用。您提供的应用代码可检查启动状态,并将用户传送到正确的目标位置。
您可以通过开发者面板创建目标位置,还可以通过批量上传功能一次创建多个目标位置。
打开 Meta Horizon 开发者面板 并选择您的应用。 在左侧导航栏中,选择互动 > 目标位置 。 在目标位置 页面上,选择创建单个目标位置 。 在新目标位置 页面中,输入以下信息:
显示名称 - 您的目标位置的名称。该名称将通过用户的组队模拟显示。描述 - 详细描述用户到达目标位置后期待的体验。API 名称 - 引用目标位置时将在代码中使用的唯一名称。可以包含字母数字和下划线 (_) 字符。不能包含空格或其他特殊字符。
注意 :API 名称应始终将用户带到该位置。
深度链接消息 - 输入任何额外数据,以帮助用户导航到应用中的正确位置。可以按您希望的方式进行格式设置,但不得包含空格。仅在使用 API 名称和大厅/比赛会话编号的数据不足时才添加此项。深度链接类型 - 用于设置目标位置是否可进行外部深度链接的选项。
启用 (默认)- 如果此目标位置可以在目标位置没有特定用户存在的情况下启动,并且您的应用可以正确地将用户路由到此目标位置,请选择“启用”。例如,深度链接大厅目标位置应将用户带到应用的大厅。此外,如果启用,则可以根据目标位置的相关性或受欢迎程度在应用中展示该目标位置。禁用 - 如果应用无法解析指向此目标位置的深度链接,或者您不希望展示该目标位置,请选择“禁用”。例如,私人房间目标位置允许好友相互加入,但不应推广,不应启用直接深度链接。教程 - 如果是教程目标位置且支持直接深度链接,请选择“教程”作为目标位置类型。分享对象 - 定义在目标位置获得批准后可以查看的人员。
所有人 - 目标位置应可供所有人使用仅限开发者 - 目标位置仅可供团队内的开发者访问。使用此项可测试正在开发的目标位置。目标位置发布后,切换为“所有人”。最小支持小组启动 (可选)- 对于小组启动,一起启动所需的最小用户数量。最大支持小组启动 (可选)- 指定可一起启动的最大用户数量。如果您设置了此值,应用将显示为对各方的建议。
注意 :小组启动需要此设置。如果未设置此值或“深度链接类型”并非“启用”,将不会显示您的目标位置。
输入目标位置详情后,您可以使用管理语言 按钮为您的应用添加语言。每增加一种语言,您都需要在提交前输入目标位置本地化的详情。
选择语言类别,然后输入该语言本地化的显示名称。此名称用于显示目的(如用户的状态)以及平台语音命令(如“在 [应用] 中打开 [目标位置]”)。
要想让位置拥有优质语音命令体验,需要为您的位置注册一个便于称呼的显示名称,这样用户就可以通过语音命令轻松请求直接瞬移到该位置。 如果目标位置有难度级别或游戏模式等修饰词,请使用连字符。例如,如果目标位置是“Combat”,游戏模式是“Public”,则显示名称就是“Combat-Public”。
您可以向显示名称添加多个修饰词。如果位置是“Crab Rave”,修饰词是难度“Hard”和条件“No Arrows”,则完整的位置就是“Crab Rave-Hard-No Arrows”。 连字符不会出现在每个单词之间,只会出现在显示名称和每个修饰词之间。 您还需要为该语言输入本地化的描述。输入内容包含人员到达此目标位置后可期待体验的详细描述。对您输入的每种语言重复上述步骤。 最后,您可以上传目标位置的图片 。您上传的图片必须是 2560 x 1440 PNG,宽高比为 16 x 9,位深为 24 位。图片可能会被裁剪,因此您应该在边缘留出空白。 完成后,点击提交审核 。您的目标位置必须获得批准才能添加到您的应用。您可以在提交状态 列中追踪目标位置的审核状态。 通过开发者面板可创建目标位置。您可以一次创建多个目标位置。
打开 Meta Horizon 开发者面板 。 在左侧导航栏中,选择互动 > 目标位置 ,然后选择您的应用。 在目标位置 页面上,选择创建多个目标位置 。对话框将打开,并显示一个可供下载的模板。仅支持 TSV 文件格式。 该 TSV 文件应有以下标头:
api_name :引用目标位置时将在代码中使用的唯一名称。可以包含字母数字和下划线 (_) 字符。不能包含空格或其他特殊字符。display_name_en_us :目标位置的显示名称。可以包含字母数字和下划线 (_) 字符。不能包含空格或其他特殊字符。为不同语言的显示名称添加新列(如“display_name_enGB”)。请参阅下文了解支持的语言。description_en_US :添加目标位置的描述,帮助用户了解其前往的位置。可以包含字母数字和下划线 (_) 字符。不能包含空格或其他特殊字符。为不同语言的显示名称添加新列(如“description_en_GB”)。请参阅下文了解支持的语言。deeplink_type (默认值:启用)
启用 :如果此目标位置可以在目标位置没有特定用户存在的情况下启动,并且您的应用可以正确地将用户路由到此目标位置,请选择启用 。例如,深度链接大厅目标位置应将用户带到应用的大厅。此外,如果启用,则可以根据目标位置的相关性或受欢迎程度在应用中展示该目标位置。禁用 :如果应用无法解析指向此目标位置的深度链接,或者您不希望展示该目标位置,请选择禁用 。例如,私人房间目标位置允许好友相互加入,但不应推广,不应启用直接深度链接。教程 :如果是教程目标位置且支持直接深度链接,请选择教程 作为目标位置类型。deeplink_message (可选):放置任何额外数据,以帮助用户导航到应用中的正确位置。可以按您希望的方式进行格式设置,但不得包含空格。仅在使用 API 名称和大厅/比赛会话编号的数据不足时才添加此项。audience (默认值:所有人)定义在目标位置获得批准后可以查看的人员。
所有人 :目标位置应可供所有人使用开发者 :目标位置仅可供团队内的开发者访问。使用此项可测试正在开发的目标位置。目标位置发布后,切换为所有人 。min_supported_group_launch (可选):对于小组启动,一起启动所需的最小用户数量。max_supported_group_launch (可选):指定可一起启动的最大用户数量。如果您设置了此值,应用将显示为对各方的建议。创建的目标位置获得批准后,您可以通过访问上下文菜单编辑或检索目标位置的可分享网址。要编辑或分享目标位置,请使用以下流程:
打开 Meta Horizon 开发者面板 。 在左侧导航栏中,选择互动 > 目标位置 ,然后选择您的应用。找到您要分享或编辑的目标位置,然后点击最右侧列中的省略号 (...) 。 选择前往目标位置 以访问该目标位置,并从浏览器的地址栏检索该网址。您可以在社交媒体平台和应用的营销材料中分享该目标位置的网址。该目标位置网址的格式为:https://oculus.com/vr/[app_id]/[destination_api_name] 。 选择查看/编辑 可查看和编辑目标位置的字段。您还可以选择删除 来删除您的目标位置。 目标位置在提供给用户之前必须提交进行审核。
提交审核后,您可以通过开发者面板中目标位置表“提交状态”列的值追踪该提交的状态。
如果目标位置有之前已批准的版本,则原来的版本将仍然有效,并可供您为目标位置配置的分享对象访问。新的提交内容获得批准后,用户就会被重定向到新批准的目标位置。请记住,最新提交内容可能是当前审核中的内容,与其他分享对象看到的内容会略有不同。
下图显示了与新提交内容相关的“提交状态”和“发布状态”字段示例。
如果目标位置已获审核团队批准并发布,则发布状态 和提交状态 均应设置为已发布 (请参阅上文的“匹配”目标位置) 更新之前已批准的目标位置时,该目标位置的提交状态 将设置为待审核 。发布状态 应仍显示为“已发布”(请参阅上文的“大厅”目标位置) 对于审核团队尚未进行审核的新添加目标位置,提交状态 和发布状态 都将设置为“待审核”(请参阅上文的“魔王关卡”目标位置) 所有标题、描述和图像都必须符合 Meta Quest 社群标准守则 。 如果启用了外部深度链接,预计用户最终会到达应用内的目标位置。如果设置为教程,则预计用户最终会到达教程。 如果启用了小组启动,则预计当最小/最大小组规模范围内的一组用户启动到目标位置时,他们最终都会到达该目标位置,并位于同一个实例中。