Tautan mendalam memungkinkan Anda mengirim pengguna ke tempat tertentu dalam pengalaman, yang dapat membuat proses bergabung lebih lancar, membantu pengguna menemukan teman-teman mereka, dan memberikan kontribusi lalu lintas.Data peluncuran opsional dalam tautan ini memungkinkan Anda menyesuaikan pengalaman pengguna saat seseorang bergabung.
Membangun tautan tautkan
URL tautan mendalam terdiri dari format URL bersama dengan parameter yang Anda spesifikasikan. Bagian berikut menjelaskan cara membangun setiap format.
Parameter URL
Tautan mendalam mendukung parameter URL berikut. Semua opsional kecuali dinyatakan lainnya.
Parameter | Deskripsi :--- | :--- placeId | ID tempat untuk bergabung.Diperlukan kecuali jika userId ditentukan.userId | ID pengguna untuk bergabung.Hasil dalam kesalahan "Pengguna yang diikuti telah meninggalkan pengalaman" jika pengguna meninggalkan pengalaman atau offline.accessCode | Kode akses server pribadi.linkCode | Kode tautan server pribadi. gameInstanceId | Pengenal unik dari instansi permainan untuk bergabung, juga disebut DataModel.JobId. launchData | Informasi tambahan yang ingin Anda sertakan dalam tautkanmendalam, seperti kode promosi atau koordinat.Proses menggunakan metode Player:GetJoinData() .Lihat Termasuk data peluncuran .
Persyaratan dan panduan
- Anda harus mengenkode URL karakter khusus, seperti spasi. Karakter-karakter ini secara otomatis didekode saat pengguna bergabung dengan pengalaman Anda.
- Data peluncur yang didekode tidak boleh melebihi 200 bayt.
- Anda dapat menyimpan data yang lebih kompleks sebagai string JSON dan memodekannya dengan HttpService:JSONDecode() di server.
- Jangan kirim informasi rahasia di parameter launchData; itu terlihat penuh di URL.Selanjutnya, pengguna dapat memodifikasi URL, sehingga data mungkin tidak autentik.
Daftar web ke aplikasi
Format ini mengirim pengguna ke halaman pengalaman Roblox di web lalu meluncurkan aplikasi Roblox.Contoh yang disediakan memberikan ID tempat dan string data peluncuran yang dienkode URL.
| Bentuk | https://www.roblox.com/games/start?placeId=<id>&launchData=<string> |
| Contoh | Contoh Tautan |
Langsung ke aplikasi
Format ini mengirim pengguna langsung ke aplikasi Roblox. Contoh yang disediakan memberikan ID tempat dan string data peluncuran yang dienkodekan URL.
| Bentuk | roblox://placeId=<id>&launchData=<string> |
| Contoh | Contoh Tautan |
Tertunda
Bagi pengguna yang tidak memiliki Roblox diinstal di perangkat seluler mereka, gunakan versi AppsFlyer dari tautan dalam untuk membiarkan pengguna mengunduh aplikasi Roblox dan kemudian mengikuti tautkandalam.Untuk membangun jenis tautkanmendalam ini, spesifikasikan prefiks https://ro.blox.com/Ebh5?.Berikan tautan dalam "langsung ke aplikasi" dengan parameter af_dp dan tautan "daftar web ke aplikasi" dengan parameter af_web_dp, yang dijelaskan di bagian sebelumnya.
| Bentuk | 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 tautkan
Dalam pengalaman Anda, dapatkan data peluncuran dengan metode Player:GetJoinData() , yang men返ikan kamus.Di kamus itu, kunci LaunchData berisi string yang Anda spesifikasikan dalam parameter launchData dari tautan tautkanAnda.
Lihat dokumentasi referensi Player:GetJoinData() untuk sampel kode tentang cara memproses data peluncuran.