Guida all'uso per la pubblicazione di luoghi

*Questo contenuto è tradotto usando AI (Beta) e potrebbe contenere errori. Per visualizzare questa pagina in inglese, clicca qui.

L'API di pubblicazione del luogo offre una funzionalità simile a la pubblicazione su Roblox in Studio, con controllo e automazione dei permessi aggiuntivi nel flusso di lavoro di rilascio continuo.Puoi usare questa API per aggiornare i luoghi esistenti di un'esperienza a una nuova versione, rendendola utile per automatizzare il tuo flusso di lavoro di pubblicazione.Ad esempio, puoi chiamare questa API da un'azione di GitHub e farla spingere automaticamente un file di posizione binario su Roblox dopo un test di integrazione riuscito.

Limitazioni

Posti su Roblox

Le esperienze su Roblox possono avere più luoghi, con un luogo di partenza come punto di ingresso dell'utente della tua esperienza e altri luoghi opzionali che puoi teletrasportare gli utenti tra .Puoi usare l'API per pubblicare sia il luogo di partenza che altri luoghi della tua esperienza con il controllo della versione.

Prima di poter aggiornare un luogo esistente di un'esperienza, hai bisogno dell'ID luogo del Postoe dell'ID universo dell'esperienza.L'ID luogo identifica il luogo e l'ID universo identifica l'esperienza.Ognuno è unico anche se la tua esperienza ha solo un Posto.

Pubblica un Posto

Per pubblicare un luogo esistente di un'esperienza con API di pubblicazione luogo :

  1. Crea una chiave API sulla Dashboard del creatore . Assicurati di eseguire le seguenti impostazioni:

    1. Aggiungi luoghi dell'universo a Permessi di accesso .
    2. Aggiungi Scrivi operazione alla tua esperienza selezionata.

  2. Ottieni l'ID Universo dell'esperienza in cui vuoi pubblicare il Posto.

    1. Naviga alla Dashboard del Creatore.

    2. Trova l'esperienza con il luogo che vuoi Aggiornarmento.

    3. Passa il mouse sulla miniatura dell'esperienza, fai clic sul pulsante ⋯ e seleziona Copia ID Universo .

  3. Ottieni l'ID luogo Place ID del luogo che vuoi Aggiornarmento.

    1. Rimani sulla pagina Creazioni sulla Dashboard del creatore e fai clic sulla miniatura dell'esperienza target.
    2. Nel menu di navigazione a sinistra, fai clic sulla scheda Luoghi .
    3. Trova il posto che vuoi aggiornare e clicca sulla sua Miniatura.
    4. L'ID luogo è nell'URL reindirizzato. Ad esempio, nell'URL , l'ID luogo è .

  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 posizione XML di Roblox ( .rbxlx ) e a un file di posizione binario ( .rbxl ).

    Richiesta del file di posizione 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 del file di posizione binaria
    $ 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 e con l'ID dell'universo reale e l'ID del luogo della esperienza e posiziona quella che vuoi Pubblicare.

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

    Corpo di risposta esempio
    { "versionNumber": 7 }

  6. (Opzionale) Verifica l'upload in Studio o su Dashboard del creatore.