深链接允许您将用户发送到体验中的特定位置,这可以使加入过程更顺滑,帮助用户找到其朋友,并提供交通属性。 在这些链接中的选项启动数据允许您定制用户体验,当有人加入。
构建深链接
深链接 URL 由 URL 格式和您指定的参数组成。下面的部分描述了如何构建每个格式。
需求和指南
当构建深链接时,请考虑以下要求和指导方针:
- 您必须为特殊字符,例如空格,进行 URL 编码。当用户加入您的体验时,这些字符会自动解码。
- 解码的发射数据不能超过 200 字节。
- 您可以将更复杂的数据存储为 JSON 字符串,并使用 HttpService:JSONDecode() 在服务器上解码。
- 不要在 launchData 参数中发送机密信息;它在 URL 上完全可见。此外,用户可以修改 URL,因此数据可能不是真实的。
网站列表到应用
此格式将用户发送到网站上的 Roblox 体验页面,然后启动 Roblox 应用程App。 提供的示例提供一个位置 ID 和一个 URL 编码的启动数据字符串。
格式 | https://www.roblox.com/games/start?placeId=<id>&launchData=<string> |
示例 | 示例链接 |
直接到应用
此格式将用户直接发送到 Roblox App用。 提供的示例提供一个位置 ID 和一个 URL 编码的启动数据字符串。
格式 | roblox://placeId=<id>&launchData=<string> |
示例 | 示例链接 |
推迟
对于没有Roblox安装在移动设备上的用户,请使用深度链接的AppsFlyer版本来让用户下载Roblox应用,然后跟随深度链关联。 要构建此类深度链关联,请指定 https://ro.blox.com/Ebh5?
格式 | ro.blox.com/Ebh5?af_dp=<direct_to_app_link>&af_web_dp=<web_listing_to_app_link> |
示例 | ro.blox.com/Ebh5?af_dp=roblox%3A%2F%2FplaceId%3D6900305353 |
处理深链接
在您的体验中,使用 Player:GetJoinData() 方法获取发射数据,该方法返回一个 字典。在那个字典中,LaunchData 键包含您在深关联接的 2>launchData2> 参数中指定的字符串。
参阅Player:GetJoinData(),了解有关如何处理发射数据的代码示例。