深層連結讓您將用戶送到遊戲中的特定位置，這樣可以使加入過程更加順暢，幫助用戶找到朋友，並提供流量歸因。這些連結中的可選啟動數據讓您在某人加入時自訂用戶體驗。
此流程已被廢棄。要創建公共深層連結，請使用 分享連結。
構建深層連結
深層連結 URL 由 URL 格式及您指定的參數組成。以下章節描述如何構建每種格式。
URL 參數
深層連結支持以下 URL 參數。除非另有說明，否則全為可選。
| 參數 | 描述 |
|---|---|
| placeId | 要加入的地點 ID。除非指定了 userId，否則為必填。 |
| userId | 要加入的用戶 ID。如果用戶已離開遊戲或離線，將顯示「被關注的用戶已離開遊戲」的錯誤。 |
| accessCode | 私人伺服器存取碼。 |
| linkCode | 私人伺服器連結碼。 |
| gameInstanceId | 要加入的遊戲實例的唯一識別碼，也稱為 DataModel.JobId。 |
| launchData | 您想要在深層連結中包含的其他信息，例如促銷代碼或座標。使用 Player:GetJoinData() 方法處理。請參閱 包含啟動數據。 |
要求和指導方針
- 您必須對特殊字符進行 URL 編碼，例如空格。當用戶加入您的遊戲時，這些字符會自動解碼。
- 解碼的啟動數據不能超過 200 字元。
- 您可以將更複雜的數據存儲為 JSON 字串，並在伺服器上用 HttpService:JSONDecode() 進行解碼。
- 不要在 launchData 參數中發送機密信息；這些信息在 URL 中是完全可見的。此外，用戶可以修改 URL，因此數據可能不是真實的。
網頁列表到應用
此格式將用戶發送到網頁上的 Roblox 遊戲頁面，然後啟動 Roblox 應用。提供的範例提供了地點 ID 和 URL 編碼的啟動數據字串。
| 格式 | https://www.roblox.com/games/start?placeId=<id>&launchData=<string> |
| 範例 | 範例連結 |
直接到應用
此格式將用戶直接發送到 Roblox 應用。提供的範例提供了地點 ID 和 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() 參考文檔。