Głębokie linki pozwalają wysyłać użytkowników do konkretnego miejsca w grze, co może uczynić proces dołączania bardziej płynnym, pomóc użytkownikom odnaleźć znajomych i zapewnić przypisanie ruchu. Opcjonalne dane uruchamiające w tych linkach pozwalają dostosować doświadczenie użytkownika, gdy ktoś dołącza.
Ten proces jest przestarzały. Aby stworzyć publiczne głębokie linki, użyj linków do udostępniania.
Konstruowanie głębokiego linku
Adres URL głębokiego linku składa się z formatu URL oraz parametrów, które określasz. Poniższe sekcje opisują, jak skonstruować każdy format.
Parametry URL
Głębokie linki obsługują następujące parametry URL. Wszystkie są opcjonalne, chyba że zaznaczone inaczej.
| Parametr | Opis |
|---|---|
| placeId | Identyfikator miejsca, do którego należy dołączyć. Wymagany, chyba że określono userId. |
| userId | Identyfikator użytkownika, do którego należy dołączyć. Wywołuje błąd "śledzony użytkownik opuścił grę", jeśli użytkownik opuścił grę lub jest offline. |
| accessCode | Kod dostępu do prywatnego serwera. |
| linkCode | Kod linku do prywatnego serwera. |
| gameInstanceId | Unikalny identyfikator instancji gry, do której należy dołączyć, zwany również DataModel.JobId. |
| launchData | Dodatkowe informacje, które chcesz zawrzeć w głębokim linku, takie jak kody promocyjne lub współrzędne. Przetwarzaj za pomocą metody Player:GetJoinData(). Zobacz Dodaj dane uruchamiające. |
Wymagania i wytyczne
- Musisz kodować URL specjalne znaki, takie jak spacje. Te znaki są automatycznie dekodowane, gdy użytkownik dołącza do Twojej gry.
- Dekodowane dane uruchamiające nie mogą przekraczać 200 bajtów.
- Możesz przechowywać bardziej złożone dane jako ciąg JSON i dekodować je za pomocą HttpService:JSONDecode() na serwerze.
- Nie wysyłaj poufnych informacji w parametrze launchData; są one w pełni widoczne w adresie URL. Ponadto użytkownicy mogą modyfikować adres URL, więc dane mogą nie być autentyczne.
Z listy webowej do aplikacji
Ten format kieruje użytkowników na stronę gry Roblox w internecie, a następnie uruchamia aplikację Roblox. Podany przykład zawiera identyfikator miejsca i zakodowany w URL ciąg danych uruchamiających.
| Format | https://www.roblox.com/games/start?placeId=<id>&launchData=<string> |
| Przykład | Przykładowy link |
Bezpośrednio do aplikacji
Ten format kieruje użytkowników bezpośrednio do aplikacji Roblox. Podany przykład zawiera identyfikator miejsca i zakodowany w URL ciąg danych uruchamiających.
| Format | roblox://placeId=<id>&launchData=<string> |
| Przykład | Przykładowy link |
Oczekiwany
Dla użytkowników, którzy nie mają zainstalowanej aplikacji Roblox na swoich urządzeniach mobilnych, użyj wersji głębokiego linku AppsFlyer, aby pozwolić użytkownikom pobrać aplikację Roblox, a następnie podążyć za głębokim linkiem. Aby skonstruować ten typ głębokiego linku, określ prefiks https://ro.blox.com/Ebh5?. Podaj "bezpośredni do aplikacji" głęboki link z parametrem af_dp oraz "lista webowa do aplikacji" głęboki link z parametrem af_web_dp, które zostały opisane w poprzednich sekcjach.
| Format | ro.blox.com/Ebh5?af_dp=<direct_to_app_link>&af_web_dp=<web_listing_to_app_link> |
| Przykład | 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 |
Przetwarzanie głębokiego linku
W swojej grze uzyskaj dane uruchamiające za pomocą metody Player:GetJoinData(), która zwraca słownik. W tym słowniku klucz LaunchData zawiera ciąg, który określiłeś w parametrze launchData swojego głębokiego linku.
Zobacz dokumentację referencyjną Player:GetJoinData(), aby uzyskać przykłady kodu dotyczące przetwarzania danych uruchamiających.