Tiefenlinks ermöglichen es Ihnen, Benutzer zu einem bestimmten Ort in einem Spiel zu senden, was den Beitrittsprozess nahtloser machen, Benutzern helfen kann, ihre Freunde zu finden, und eine Verkehrszuweisung bieten kann. Die optionalen Startdaten in diesen Links ermöglichen es Ihnen, das Benutzererlebnis anzupassen, wenn jemand beitritt.
Dieser Prozess ist veraltet. Um öffentliche Tiefenlinks zu erstellen, verwenden Sie Freigabelinks.
Erstellen eines Tiefenlinks
Eine Tiefenlink-URL besteht aus einem URL-Format zusammen mit den von Ihnen angegebenen Parametern. Die folgenden Abschnitte beschreiben, wie man jedes Format erstellt.
URL-Parameter
Tiefenlinks unterstützen die folgenden URL-Parameter. Alle sind optional, es sei denn, es ist etwas anderes angegeben.
| Parameter | Beschreibung |
|---|---|
| placeId | Die Platz-ID, die beigetreten werden soll. Erforderlich, es sei denn, userId ist angegeben. |
| userId | Die Benutzer-ID, der beigetreten werden soll. Führt zu einem Fehler "Der gefolgte Benutzer hat das Spiel verlassen", wenn der Benutzer das Spiel verlassen hat oder offline ist. |
| accessCode | Der Zugriffscode für den privaten Server. |
| linkCode | Der Linkcode für den privaten Server. |
| gameInstanceId | Der eindeutige Bezeichner der Spielinstanz, der beigetreten werden soll, auch DataModel.JobId genannt. |
| launchData | Zusätzliche Informationen, die Sie im Tiefenlink einfügen möchten, wie z. B. Werbecodes oder Koordinaten. Verarbeitung mit der Methode Player:GetJoinData(). Siehe Launchdaten einfügen. |
Anforderungen und Richtlinien
- Sie müssen Sonderzeichen wie Leerzeichen URL-encodieren. Diese Zeichen werden automatisch dekodiert, wenn der Benutzer Ihrem Spiel beitritt.
- Die dekodierten Startdaten dürfen 200 Bytes nicht überschreiten.
- Sie können komplexere Daten als JSON-Zeichenfolge speichern und mit HttpService:JSONDecode() auf dem Server dekodieren.
- Senden Sie keine vertraulichen Informationen im launchData-Parameter; sie sind vollständig in der URL sichtbar. Darüber hinaus können Benutzer die URL ändern, sodass die Daten möglicherweise nicht authentisch sind.
Webliste zur App
Dieses Format sendet Benutzer zur Roblox-Spielseite im Web und startet dann die Roblox-App. Das bereitgestellte Beispiel enthält eine Platz-ID und eine URL kodierte Startdatenzeichenfolge.
| Format | https://www.roblox.com/games/start?placeId=<id>&launchData=<string> |
| Beispiel | Beispiel-Link |
Direkt zur App
Dieses Format sendet Benutzer direkt zur Roblox-App. Das bereitgestellte Beispiel enthält eine Platz-ID und eine URL kodierte Startdatenzeichenfolge.
| Format | roblox://placeId=<id>&launchData=<string> |
| Beispiel | Beispiel-Link |
Ausgesetzt
Für Benutzer, die Roblox nicht auf ihren mobilen Geräten installiert haben, verwenden Sie die AppsFlyer-Version eines Tiefenlinks, um Benutzern zu ermöglichen, die Roblox-App herunterzuladen und dann dem Tiefenlink zu folgen. Um diesen Typ von Tiefenlink zu konstruieren, geben Sie das https://ro.blox.com/Ebh5?-Präfix an. Stellen Sie den "Direkt zur App"-Tiefenlink mit dem Parameter af_dp und den "Weblistung zur App"-Tiefenlink mit dem af_web_dp-Parameter bereit, die in den vorherigen Abschnitten beschrieben wurden.
| Format | ro.blox.com/Ebh5?af_dp=<direct_to_app_link>&af_web_dp=<web_listing_to_app_link> |
| Beispiel | 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 |
Verarbeiten eines Tiefenlinks
In Ihrem Spiel erhalten Sie die Startdaten mit der Methode Player:GetJoinData(), die ein Dictionary zurückgibt. In diesem Dictionary enthält der Schlüssel LaunchData die Zeichenfolge, die Sie im launchData Parameter Ihres Tiefenlinks angegeben haben.
Siehe die Referenzdokumentation zu Player:GetJoinData() für Codebeispiele, wie man Startdaten verarbeitet.