Hướng dẫn sử dụng cho Việc xuất bản địa

*Nội dung này được dịch bằng AI (Beta) và có thể có lỗi. Để xem trang này bằng tiếng Anh, hãy nhấp vào đây.

API Đăng nơi chỗ đứng đáp ứng cùng một chức năng như Đăng nơi Roblox ở Studio plus các khối lượng kiểm soát và tự động hóa tiếp tục đổi mới trong workflow đăng nơi. Bạn có thể sử d

Nơi trên Roblox

Trên Roblox, các trải nghiệm có thể có nhiều nơi, với một nơi bắt đầu như người dùng điểm dừng chân của trải nghiệm của bạn và các nơi khác bạn có thể dịch chuyển người . Bạn có thể sử dụng API để xuất bản một nơi xuất phát

Trước khi bạn có thể cập nhật một nơi hiện tại của một trải nghiệm, bạn cần ID chỗ đứng của địa điểmđóID trải nghiệm của trải nghiệm . The ID chỗ đứng identifies nơi và the 1> ID địa điểmnghiệm

Xuất Bản một Nơi

Để xuất bản một nơi hiện tại của một trải nghiệm với API Xuất Bản Nơi :

  1. Tạo một chìa khóa API trên Bảng điều khiển của người dùng . Hãy đảm bảo thực hiện các cài đặt sau:

    1. Thêm all-places vào Access Permissions .
    2. Thêm Viết hoạt động vào trải nghiệm bạn chọn.
  2. Nhận ID Thế giới của trải nghiệm mà bạn muốn xuất bản địa điểm.

    1. Tìm trải nghiệm với nơi bạn muốn cập nhật.

    2. Bỏ chuột lên bản xem trước của trải nghiệm mục tiêu và nhấp vào nút ⋯ để hiển thị một danh sách các tùy chọn, sau đó chọn Nhân bản ID Universe từ danh sách.

      Copy Universe ID option from Creator Dashboard
  3. Nhận ID địa điểm của nơi bạn muốn cập nhật.

    1. Trang ở trên Creations trên Creator Dashboard và nhấp vào hình ảnh minh họa của trải nghiệm mục tiêu.
    2. Trong menu navigazione bên trái, click the Places tab.
    3. Tìm nơi bạn muốn cập nhật và nhấp vào hình ảnh hình nhỏcủa nó.
    4. ID nơi được đặt trong URL được chuyển hướng. Ví dụ, trong URL https://create.roblox.com/dashboard/creations/experiences/0000000/places/111111/configure, ID nơi được đặt trong 1> 1111111> .
  4. Thêm chìa khóa API vào x-api-key header của một yêu cầu POST đến API. Hai ví dụ sau đây tham khảo vào hồ sơ nơi Roblox XML ( .rbxlx ) và một hồ sơ nơi Roblox Binary ( 1> .rbxl1> ).

    Yêu cầu định dạng file

    $ 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
    Yêu cầu tập tin nơi này

    $ 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

    Để thiết lập các command, thay thế {universeId}{placeId} bằng thực tế ID Universe và 1>ID Place1> của trải nghiệm và nơi bạn muốn phát sóng.

  5. Nếu bạn gửi yêu cầu của bạn đúng cách, bạn nhận được một cơ thể phản hồi thành công với số phiên bản nơi địa điểm được đưa ra dưới dạng sau:

    Ví dụ về thân hồi

    { "versionNumber": 7 }
  6. (Tùy chọn) Xác minh tải trên Studio hoặc trên Bảng điều khiển của người sáng tạo.