Guida all'uso per la pubblicazione dei luoghi

L'API di pubblicazione dei luoghi offre funzionalità simili alla pubblicazione su Roblox in Studio, con un controllo delle autorizzazioni aggiuntivo e automazione nel flusso di lavoro di rilascio continuo. Puoi utilizzare questa API per aggiornare i luoghi esistenti di un gioco a una nuova versione, rendendola utile per automatizzare il tuo flusso di lavoro di pubblicazione. Ad esempio, puoi chiamare questa API da un'azione GitHub e far sì che carichi automaticamente un file di luogo binario su Roblox dopo un test di integrazione riuscito.

Limitazioni

• Questa API supporta solo richieste HTTPS.
• L'API di pubblicazione dei luoghi non aggiorna determinati tipi di istanze. Se il tuo gioco contiene istanze di EditableImage, EditableMesh, PartOperation, SurfaceAppearance o BaseWrap, pubblica da Studio dopo averle modificate.

Luoghi su Roblox

I giochi su Roblox possono avere più luoghi, con un luogo di partenza come punto di ingresso per l'utente nel tuo gioco e altri luoghi opzionali tra cui puoi teletrasportare gli utenti. Puoi utilizzare l'API per pubblicare sia il luogo di partenza che altri luoghi del tuo gioco con controllo delle versioni.

Prima di poter aggiornare un luogo esistente di un gioco, hai bisogno del Place ID del luogo e del Universe ID del gioco. Il Place ID identifica il luogo e il Universe ID identifica il gioco. Ognuno è unico anche se il tuo gioco ha solo un luogo.

Pubblica un luogo

Per pubblicare un luogo esistente di un gioco con l'API di pubblicazione dei luoghi:

1. Crea una chiave API nel Creator Dashboard. Assicurati di eseguire le seguenti impostazioni:

   1. Aggiungi universe-places a Access Permissions.
   2. Aggiungi l'operazione Write al tuo gioco selezionato.

2. Ottieni il Universe ID del gioco in cui desideri pubblicare il luogo.

   1. Naviga al Creator Dashboard.

   2. Trova il gioco con il luogo che desideri aggiornare.

   3. Passa il mouse sopra la miniatura del gioco, fai clic sul pulsante ⋯ e seleziona Copia Universe ID.

      

3. Ottieni il Place ID del luogo che desideri aggiornare.

   1. Rimani sulla pagina Creations nel Creator Dashboard e fai clic sulla miniatura del gioco target.
   2. Nel menu di navigazione a sinistra, fai clic sulla scheda Places.
   3. Trova il luogo che desideri aggiornare e fai clic sulla sua miniatura.
   4. Il Place ID è nell'URL reindirizzato. Ad esempio, nell'URL https://create.roblox.com/dashboard/creations/experiences/0000000/places/111111/configure,il **Place ID** è111111`.

4. Aggiungi la chiave API nell'intestazione x-api-key di una richiesta POST all'API. Le seguenti due richieste di esempio fanno riferimento a un file di luogo XML (.rbxlx) e a un file di luogo binario (.rbxl).

   Richiesta File di Luogo XML

   $ 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

   Richiesta File di Luogo Binario

   $ 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

   Per eseguire i comandi, sostituisci {universeId} e {placeId} con il reale Universe ID e Place ID del gioco e del luogo che desideri pubblicare.

5. Se invii correttamente la tua richiesta, riceverai un corpo di risposta di successo con il numero di versione del luogo nel seguente formato:

   Esempio di Corpo di Risposta

   { "versionNumber": 7 }

6. OPZIONALE

   Verifica il caricamento in Studio o nel Creator Dashboard.