深度鏈接

*此內容是使用 AI(Beta 測試版)翻譯,可能含有錯誤。若要以英文檢視此頁面,請按一下這裡

深度鏈接可以將用戶發送到體驗中的特定位置,這可以使加入過程更順滑,幫助用戶找到其朋友,並提供交通屬性。這些鏈接中的可選擇啟動資料讓您可以自訂用戶體驗,當有人加入。

建立深度鏈接

深鏈網址包含參數以及您指定的 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() 參考文件,了解處理啟動資料的方法。