深鏈可讓您將使用者帶到體驗中的特定位置，這可以使加入過程更順暢，幫助使用者找到朋友，並提供交通分配。這些鏈接中的可選啟動資料讓您在某人加入時自定義使用者體驗。
建立深鏈綁定
深鏈接 URL 包括 URL 格式以及您指定的參數。以下部分描述如何構建每種格式。
URL 參數
深鏈支持以下 URL 參數。所有都是可選的，除非另有說明。
參數 | 說明 :--- | :--- placeId | 加入的地點ID。除非 userId 指定，否則必須。userId如果使用者離開了體驗或離線，將導致「跟隨使用者已離開體驗」錯誤。accessCode``linkCode``gameInstanceId | 加入遊戲實例的唯一標識符，也稱為DataModel.JobId。launchData|您想要包含在深綁定中的額外資訊，例如促銷代碼或座標。使用 Player:GetJoinData() 方法進行處理。請參閱包含啟動資料。
需求和指引
- 您必須使用 URL 編碼特殊字符，例如空格。這些字符會在使用者加入您的體驗時自動解碼。
- 解碼的啟動資料不能超過 200 字元。
- 您可以將更複雜的資料存儲為 JSON 字串，並使用服務伺服器上的 HttpService:JSONDecode() 來解碼它。
- 不要在 launchData 參數中傳送機密資訊；它在 URL 上完全可見。此外，使用者可以修改 URL，因此資料可能不是真實的。
網頁列表到應用程App
這種格式將使用者帶到網頁上的 Roblox 體驗頁面，然後啟動 Roblox App用程式。提供的範例提供一個地點標識和一個用 URL 編碼的啟動資料字串。
| 格式 | https://www.roblox.com/games/start?placeId=<id>&launchData=<string> |
| 範例 | 範例鏈接 |
直接到應用程App
這種格式會將使用者直接導向到 Roblox 應用程App。提供的範例提供了一個地點標識和一個 URL 編碼的啟動資料字串。
| 格式 | roblox://placeId=<id>&launchData=<string> |
| 範例 | 範例鏈接 |
已延遲
對於沒有在移動設備上安裝 Roblox 的用戶，使用 AppsFlyer 版本的深鏈讓用戶下載 Roblox 應用程式，然後跟隨深綁定。要構建這種深綁定類型，請指定 https://ro.blox.com/Ebh5? 前缀。提供「直接傳送到應用程式」深鏈接的 af_dp 參數和「網頁列表傳送到應用程式」深鏈接的 af_web_dp 參數，這些參數在上一節中已述及。
| 格式 | 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() 參考文件，了解如何處理發射數據的代碼樣本。