深度鏈接可以將用戶發送到體驗中的特定位置,這可以使加入過程更順滑,幫助用戶找到其朋友,並提供交通屬性。這些鏈接中的可選擇啟動資料讓您可以自訂用戶體驗,當有人加入。
建立深度鏈接
深鏈網址包含參數以及您指定的 URL 格式。下列部分解釋如何構建每個格式。
需求和指南
當建立深度鏈接時,請考慮以下要求和指引:
- 您必須將特殊字符,例如空格,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 和一個 URL 已編碼的啟動資料字串。
格式 | roblox://placeId=<id>&launchData=<string> |
範例 | 範例連結 |
延遲
對於沒有Roblox安裝在其移動設備上的用戶,請使用深鏈的版本來讓用戶下載Roblox應用程式,然後跟隨深綁定。若要建造此類深綁定,請指定 https://ro.blox.com/Ebh
格式 | 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%3D690030 |
處理深度鏈接
在您的體驗中,使用 Player:GetJoinData() 方法,取得發射資料,這會返回一個 字典。在那個字典中, LaunchData 鑰匙包含您在深綁定的 1>launchData1> 參數中指定的字串。
參閱「Player:GetJoinData() 參考文件,了解處理啟動資料的方法。