Verwendungsanleitung für Platzveröffentlichung

Platzieren der Veröffentlichungs-API erfüllt die gleiche Funktionalität wie Publish to Roblox in Studio plus zusätzliche Berechtigungskontrolle und Automatisierung in der kontinuierlichen Veröffentlichungsprozess. Sie können diese API verwenden, um bestehende Orte eines Erlebnisses auf eine neue Version zu aktualisieren, wodurch es sinnvoll ist, Ihren Veröffentlichungsprozess automatisiert zu

Orte auf Roblox

Erlebnisse auf Roblox können mehrere Orte haben, mit einem Startplatz als Zielpunkt des Benutzereintrags und optionalen anderen Orten, die Sie benutzerweit teleportieren können. Sie können die API verwenden, um den Startplatz oder andere Orte Ihres Erlebnisses mit der Versionsteuerung zu veröffentlichen.

Bevor du einen bestehenden Ort eines Erlebnisses aktualisieren kannst, brauchst du die Platz-ID des Ortes und die Universum-ID des Erlebnisses. Die Platz-ID identifiziert den Ort und die Universum-ID identifiziert das Erlebnis. Jeder ist einzigartig, auch wenn dein Erlebnis nur einen Ort hat.

Veröffentlichen eines Ortes

Um einen bestehenden Ort eines Erlebnisses mit Platzveröffentlichungs-API zu veröffentlichen:

1. Erstellen Sie einen API-Key auf dem Creator-Dashboard . Stellen Sie sicher, dass Sie die folgenden Einstellungen ausführen:

2. Füge Universum-Plätze zu Zugriffsberechtigungen hinzu.

3. Füge Schreiben Operation zu deiner ausgewählten Erlebnishinzu.

4. Erhalte die Universum-ID des Erlebnisses, in dem du den Ort veröffentlichen möchtest.

   1. Navigiere zum Creator-Dashboard.

   2. Finde die Erfahrung mit dem Ort, den du Updatemöchtest.

   3. Bewegen Sie den Mauszeiger über die Miniaturansicht des Ziels und klicken Sie auf die Schaltfläche ⋯ , um eine Liste von Optionen anzuzeigen, und wählen Sie dann Kopieren Sie die Universe ID aus der Liste.

      

5. Erhalte die Platz-ID des Ortes, den du Updatemöchtest.

   1. Bleiben Sie auf der Kreationen Seite auf Creator-Dashboard und klicken Sie auf die Miniaturansicht der Ziel-Erlebniss.
   2. In dem linken Navigationsmenü, klicken Sie auf die Orte -Registerkarte.
   3. Finden Sie den Ort, den Sie aktualisieren möchten, und klicken Sie auf seine Miniaturansicht.
   4. Die Platz-ID befindet sich in der umgeleiteten URL. Zum Beispiel, in der URL https://create.roblox.com/dashboard/creations/experiences/0000000/places/111111/configure , die Platz-ID ist 1> 1111111> .

6. Fügen Sie den API-Key in den x-api-key -Header einer POST-Anfrage an die API. Die folgenden zwei Beispielanfragen beziehen sich auf einen Roblox-XML-Platz ( .rbxlx ) und einen Binär-Platz ( 1> .rbxl1> ).

   XML-Platz-Datei-Anfrage
   $ curl --verbose --location POST 'https://apis.roblox.com/universes/v1/{universeId}/places/{placeId}/versions?versionType=Published' \
   --header 'x-api-key: <your-api-key>' \
   --header 'Content-Type: application/xml' \
   --data-binary @/home/placefiles/place1.rbxlx

   Binärer Platz-Datei-Anfrage
   $ curl --verbose --location POST 'https://apis.roblox.com/universes/v1/{universeId}/places/{placeId}/versions?versionType=Published' \
   --header 'x-api-key: <your-api-key>' \
   --header 'Content-Type: application/octet-stream' \
   --data-binary @/home/placefiles/place1.rbxl

   Um die Befehle auszuführen, ersetzen Sie {universeId} und {placeId} durch die aktuelle Universe-ID und 1>Platz-ID1> des Erlebnisses und des Ortes, den Sie veröffentlichen möchten.

7. Wenn Sie Ihre Anfrage richtig senden, erhalten Sie einen Erfolg-Antwort-Körper mit der Platz-Version in der folgenden Format:

   Beispiel-Antwortskörper
   { "versionNumber": 7 }

8. (Optional) Überprüfen Sie den Upload in Studio oder auf Creator-Dashboard.