深链可让您将用户发送到体验中的特定位置，这可以使加入过程更顺畅，帮助用户找到朋友，并提供交通分配。这些链接中的可选启动数据让你在有人加入时自定义用户体验。
构建深链关联
深链接 URL 由 URL 格式以及您指定的参数组成。以下部分描述了如何构建每个格式。
URL参数
深链支持以下 URL 参数。除非另有说明，所有都是可选的。
参数 | 描述 :--- | :--- placeId | 加入的地点ID。除非 userId 被指定，否则必须要求。userId|用户ID加入。如果用户离开了体验或者处于离线状态，将导致“跟随用户已离开体验”错误。|私服访问代验证码。|私服链接代验证码。gameInstanceId | 加入游戏实例的唯一标识符，也称为DataModel.JobId。launchData|您想要包含在深关联中的额外信息，例如促销代码或坐标。使用 Player:GetJoinData() 方法进行处理。请参阅包含发射数据。
需求和指南
- 你必须使用 URL 编码特殊字符，例如空格。这些字符在用户加入你的体验时自动解码。
- 解码的启动数据不能超过 200 字节。
- 您可以将更复杂的数据存储为 JSON 字符串，并在服务器上使用 HttpService:JSONDecode() 进行解码。
- 不要在 launchData 参数中发送机密信息；它在 URL 上完全可见。此外，用户可以修改 URL，因此数据可能不是真实的。
网页列表到应App
这种格式将用户发送到网页上的 Roblox 体验页面，然后启动 Roblox 应用程App。提供的示例提供了一个地点ID和一个编码的URL启动数据字符串。
| 格式 | https://www.roblox.com/games/start?placeId=<id>&launchData=<string> |
| 例子 | 示例链接 |
直接到应App
该格式将用户直接发送到 Roblox 应用程App。提供的示例提供了一个地点 ID 和一个编码的启动数据字符串。
| 格式 | 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%26launchData%3D%257B%2522roomId%2522%253A%25202%257D&af_web_dp=https%3A%2F%2Fwww.roblox.com%2Fgames%2Fstart%3FplaceId%3D6900305353%26launchData%3D%257B%2522roomId%2522%253A%25202%257D |
处理深链关联
在你的体验中，使用 Player:GetJoinData() 方法获取发射数据，该方法返回一个 词典。在那个词典中，LaunchData 键包含你在深关联接参数 launchData 中指定的字符串。
查看 Player:GetJoinData() 参考文档，了解如何处理发射数据的代码示例。