ลิงก์ลึกช่วยให้คุณส่งผู้ใช้ไปยังสถานที่เฉพาะในประสบการณ์ซึ่งสามารถทำให้กระบวนการเข้าร่วมเป็นไปอย่างราบรื่นยิ่งขึ้นช่วยให้ผู้ใช้ค้นหาเพื่อนของพวกเขาและให้การโยนความสนใจของการจราจรข้อมูลเปิดตัวทางเลือกในลิงก์เหล่านี้ช่วยให้คุณปรับแต่งประสบการณ์ผู้ใช้เมื่อมีคนเข้าร่วม
เชื่อมโยง
ลิงก์ลึก URL ประกอบด้วยรูปแบบ URL พร้อมกับพารามิเตอร์ที่คุณระบุ ส่วนต่อไปอธิบายวิธีการสร้างแต่ละรูปแบบ
พารามิเตอร์ URL
ลิงก์ลึกสนับสนุนพารามิเตอร์ URL ต่อไปนี้ ทั้งหมดเป็นตัวเลือกเว้นแต่ระบุไว้เป็นอย่างอื่น
พารามิเตอร์ | คําอธิบาย :--- | :--- placeId | รหัสสถานที่ที่จะเข้าร่วมจำเป็นต้องใช้เว้นแต่ userId จะระบุไว้userId | รหัสผู้ใช้ที่จะเข้าร่วมผลลัพธ์ในข้อผิดพลาด "ผู้ใช้ที่ติดตามได้ออกจากประสบการณ์แล้ว" หากผู้ใช้ออกจากประสบการณ์หรือออฟไลน์accessCode|linkCode|โค้ดลิงค์เซิร์ฟเวอร์ส่วนตัว gameInstanceId | ตัวระบุเฉพาะของตัวอย่างเกมที่จะเข้าร่วมซึ่งเรียกว่า Class.DataModel.JobId``launchData | เชื่อมโยงเช่นรหัสโปรโมชันหรือพิกัดกระบวนการโดยใช้วิธี Player:GetJoinData()ดู รวมข้อมูลการเปิดตัว
ข้อกําหนดและแนวทาง
- คุณต้องเข้ารหัส URL ตัวอักษรพิเศษเช่นช่องว่าง ตัวอักษรเหล่านี้จะถูกถอดรหัสโดยอัตโนมัติเมื่อผู้ใช้เข้าร่วมประสบการณ์ของคุณ
- ข้อมูลการเปิดตัวที่ถูกถอดรหัสไม่สามารถเกิน 200 ไบต์
- คุณสามารถเก็บข้อมูลที่ซับซ้อนมากขึ้นเป็นสตริง JSON และถอดรหัสด้วย HttpService:JSONDecode() บนเซิร์ฟเวอร์
- อย่าส่งข้อมูลลับในพารามิเตอร์ launchData มันสามารถมองเห็นได้อย่างเต็มที่ใน URLนอกจากนี้ผู้ใช้สามารถแก้ไข URL ดังนั้นข้อมูลอาจไม่ถูกต้อง
รายการเว็บไปยังแอป
รูปแบบนี้ส่งผู้ใช้ไปยังหน้าประสบการณ์ Roblox บนเว็บแล้วเปิดตัวแอป Roblox ขึ้นตัวอย่างที่ให้มามีรหัสสถานที่และสตริงข้อมูลการเปิดตัวที่เข้ารหัสด้วย URL
| รูปแบบ | https://www.roblox.com/games/start?placeId=<id>&launchData=<string> |
| ตัวอย่าง | ลิงก์ตัวอย่าง |
เชื่อมโยงโดยตรงกับแอป
รูปแบบนี้ส่งผู้ใช้ไปยังแอป Roblox โดยตรง ตัวอย่างที่ให้มามีรหัสสถานที่และสตริงข้อมูลเปิดตัวที่เข้ารหัสด้วย 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() สำหรับตัวอย่างโค้ดเกี่ยวกับวิธีการประมวลผลข้อมูลการเปิดตัว