Przewodnik użytkowania dla publikacji miejsca

Interfejs publikowania miejsc oferuje podobną funkcjonalność do publikowania do Roblox w Studio, z dodatkową kontrolą uprawnień i automatyzacją w ciągłym przepływie pracy uwalniania.Możesz użyć tego API, aby zaktualizować istniejące miejsca doświadczenia do nowej wersji, co czyni go użytecznym do automatyzacji procesu publikowania.Na przykład możesz wezwać tę API z akcji GitHub i automatycznie przesłać plik binarny do Roblox po udanym testowaniu integracji.

Ograniczenia

• Ta API wspiera tylko prośby HTTPS.
• Aplikacja publikowania miejsc nie aktualizuje niektórych typów instancji.Jeśli twoje doświadczenie zawiera EditableImage, EditableMesh, PartOperation, SurfaceAppearance lub BaseWrap instancje, opublikuj z Studio po ich zmodyfikowaniu.

Miejsca na Roblox

Doświadczenia na Roblox mogą mieć wiele miejsc, z jednym początkowym miejscem jako punkt wejścia użytkownika do twojego doświadczenia i opcjonalnymi innymi miejscami, które możesz teleportować użytkowników między.Możesz użyć API, aby opublikować miejsce startowe lub inne miejsca swojego doświadczenia z kontrolą wersji.

Zanim będziesz mógł zaktualizować istniejące miejsce w doświadczeniu, potrzebujesz ID miejsca i ID wszechświata doświadczenia .ID miejsca identyfikuje miejsce, a ID wszechświata identyfikuje doświadczenie.Każdy jest unikalny, nawet jeśli twoje doświadczenie ma tylko jedno miejsce.

Opublikuj miejsce

Aby opublikować istniejące miejsce doświadczenia z API publikacji miejsc :

1. Stwórz klucz API na panelu twórcy . Upewnij się, że wykonasz następujące ustawienia:

   1. Dodaj miejsca wszechświata do uprawnień dostępu .
   2. Dodaj operację Pisz do wybranego doświadczenia.

2. Zdobądź ID wszechświata doświadczenia, w którym chcesz opublikować miejsce.

   1. Przejdź do Pulpitu nawigacyjnego twórcy.

   2. Znajdź doświadczenie z miejscem, które chcesz aktualizacja.

   3. Najedź kursorem na miniaturę miniatura, kliknij przycisk ⋯ i wybierz Kopiuj ID wszechświata .

      

3. Zdobądź identyfikator miejsca z miejsca, które chcesz aktualizacja.

   1. Pozostań na stronie Tworzenia na panelu twórcy i kliknij miniaturkę docelowego doświadczenia.
   2. W menu nawigacji po lewej stronie kliknij zakładkę Miejsca .
   3. Znajdź miejsce, które chcesz zaktualizować, i kliknij jego miniatura.
   4. ID miejsca jest w przekierowanej URL. Na przykład w URL https://create.roblox.com/dashboard/creations/experiences/0000000/places/111111/configure ID miejsca jest 111111.

4. Dodaj klucz API w nagłówku x-api-key w żądaniu POST API.Następujące dwa przykładowe żądania odwołują się do pliku miejsca XML Roblox ( .rbxlx ) i pliku miejsca binarnego ( .rbxl ).

   Prośba o umieszczenie pliku 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

   Żądanie umieszczenia pliku binarnego
   $ 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

   Aby wykonać polecenia, zastąp {universeId} i {placeId} rzeczywistym ID wszechświata i ID miejsca doświadczenia, a umieść to, które chcesz opublikować.

5. Jeśli wysłałeś poprawnie swoją prośbę, otrzymasz ciało odpowiedzi o sukcesie z numerem wersji miejsca w następującym formacie:

   Przykładowe ciało odpowiedzi
   { "versionNumber": 7 }

6. (Opcjonalnie) Zweryfikuj przesłanie w Studio lub na Pulpicie nawigacyjnym twórcy.