Przewodnik po użyciu dla publikacji miejsca

*Ta zawartość została przetłumaczona przy użyciu narzędzi AI (w wersji beta) i może zawierać błędy. Aby wyświetlić tę stronę w języku angielskim, kliknij tutaj.

API miejscem publikacji wypełnia tę samą funkcjonalność co Publish to Roblox w Studio plus dodatkową kontrolę uprawnień i automatyzację w workflowie ciągłego uwalniania. Możesz użyć tego API, aby aktualizować istniejące miejsca doświadczenia do nowej wersji, czyniąc go użytecznym do automatyzacji

Miejsce na Roblox

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

Przed aktualizacją istniejącego miejsca w wersji doświadczenia, potrzebujesz identyfikatora miejsca i identyfikatora uniwersum dla doświadczenia. identyfikator miejsca identyfikuje miejsce i 2>identyfikator uniwersum2> identyfikuje doświadczenie. Każdy jest unikalny, nawet jeśli Twoja doświadczenie ma t

Opublikuj miejsce

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

  1. Utwórz klucz API na Dashboardu twórcy . Upewnij się, że wykonujesz następujące ustawienia:

    1. Dodaj miejsce w wielowym świecie do dostępnych uprawnień .
    2. Dodaj Napisz operację do swojego wybranego doświadczenia.

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

    1. Przejdź do Panelu twórcy.

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

    3. Przytrzymajте myszkę na miniaturze celu i kliknijте przycisk ⋯ , aby wyświetlić listę opcji, a następnie wybierz Kopuj ID wszechświata z listy.

      Copy Universe ID option from Creator Dashboard

  3. Zdobądź Idź miejsce ID z miejsca, które chcesz aktualizacja.

    1. Pozostań na stronie Twórcy na Panelu głównym i kliknij na miniaturę celu.
    2. W menu po lewej stronie, kliknij Miejsce tab.
    3. Znajdź miejsce, które chcesz zaktualizować, i kliknij jego miniatura.
    4. ID Miejsce znajduje się w przekierowanej URL. Na przykład, w URL https://create.roblox.com/dashboard/creations/experiences/0000000/places/111111/configure , ID Miejsce znajduje się 1> 1111111> .

  4. Dodaj klucz API w x-api-key nagłówku żądania POST do API. Następne dwa przykładowe wnioski odsyłają się do pliku Roblox XML ( .rbxlx ) i pliku miejscowego binarnego ( 2> .rbxl2> ).

    Zgłaszanie zmian w plikach miejsca 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
    Prośba o plik binarny
    $ 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ć komendy, zastąp {universeId} i {placeId} aktualnym Uniwersalnym ID i 1>Miejsce ID1> doświadczenia i miejsca, które chcesz opublikować.

  5. Jeśli wysłałeś właściwie wysłane pytanie, otrzymujesz ciało odpowiedzi na pytanie z numerem miejsca w następującej formie:

    Przykładowy korpus odpowiedzi
    { "versionNumber": 7 }

  6. (Opcjonalnie) Zweryfikuj użycie w Studio lub na Panelu twórcy.