Tautan dalam memungkinkan Anda mengirim pengguna ke tempat tertentu di dalam game, yang dapat membuat proses bergabung lebih lancar, membantu pengguna menemukan teman mereka, dan memberikan atribusi lalu lintas. Data peluncuran opsional dalam tautan ini memungkinkan Anda menyesuaikan pengalaman pengguna ketika seseorang bergabung.
Proses ini sudah tidak digunakan lagi. Untuk membuat tautan dalam publik, gunakan tautan berbagi.
Membangun tautan dalam
URL tautan dalam terdiri dari format URL bersama dengan parameter yang Anda tentukan. Bagian-bagian berikut menjelaskan cara membangun masing-masing format.
Parameter URL
Tautan dalam mendukung parameter URL berikut. Semua bersifat opsional kecuali jika dicatat sebaliknya.
| Parameter | Deskripsi |
|---|---|
| placeId | ID tempat yang ingin bergabung. Diperlukan kecuali userId ditentukan. |
| userId | ID pengguna yang ingin bergabung. Menghasilkan kesalahan "Pengguna yang diikuti telah keluar dari game" jika pengguna keluar dari game atau sedang offline. |
| accessCode | Kode akses server pribadi. |
| linkCode | Kode tautan server pribadi. |
| gameInstanceId | Pengidentifikasi unik dari instansi game yang ingin bergabung, juga disebut sebagai DataModel.JobId. |
| launchData | Informasi tambahan yang ingin Anda sertakan dalam tautan dalam, seperti kode promosi atau koordinat. Diproses menggunakan metode Player:GetJoinData(). Lihat Sertakan data peluncuran. |
Persyaratan dan pedoman
- Anda harus mengkodekan karakter khusus dalam URL, seperti spasi. Karakter ini secara otomatis didekodekan saat pengguna bergabung dengan game Anda.
- Data peluncuran yang didekodekan tidak boleh melebihi 200 byte.
- Anda dapat menyimpan data yang lebih kompleks sebagai string JSON dan mendekodenya dengan HttpService:JSONDecode() di server.
- Jangan mengirim informasi rahasia dalam parameter launchData; itu sepenuhnya terlihat dalam URL. Selanjutnya, pengguna dapat memodifikasi URL, sehingga datanya mungkin tidak otentik.
Daftar web ke aplikasi
Format ini mengirim pengguna ke halaman game Roblox di web dan kemudian meluncurkan aplikasi Roblox. Contoh yang diberikan menyediakan ID tempat dan string data peluncuran yang terkodekan dalam URL.
| Format | https://www.roblox.com/games/start?placeId=<id>&launchData=<string> |
| Contoh | Tautan Contoh |
Langsung ke aplikasi
Format ini mengirim pengguna langsung ke aplikasi Roblox. Contoh yang diberikan menyediakan ID tempat dan string data peluncuran yang terkodekan dalam URL.
| Format | roblox://placeId=<id>&launchData=<string> |
| Contoh | Tautan Contoh |
Tertunda
Untuk pengguna yang tidak memiliki Roblox terinstal di perangkat seluler mereka, gunakan versi AppsFlyer dari tautan dalam untuk membiarkan pengguna mengunduh aplikasi Roblox dan kemudian mengikuti tautan dalam tersebut. Untuk membangun jenis tautan dalam ini, tentukan prefix https://ro.blox.com/Ebh5?. Berikan tautan dalam "langsung ke aplikasi" dengan parameter af_dp dan tautan dalam "daftar web ke aplikasi" dengan parameter af_web_dp, yang dijelaskan dalam bagian sebelumnya.
| Format | ro.blox.com/Ebh5?af_dp=<direct_to_app_link>&af_web_dp=<web_listing_to_app_link> |
| Contoh | 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 |
Memproses tautan dalam
Dalam game Anda, peroleh data peluncuran dengan metode Player:GetJoinData(), yang mengembalikan sebuah kamus. Dalam kamus itu, kunci LaunchData berisi string yang Anda tentukan dalam parameter launchData tautan dalam Anda.
Lihat dokumentasi referensi Player:GetJoinData() untuk contoh kode tentang cara memproses data peluncuran.