Yer yayını için kullanım kılavuzu

yer yayın API, Studio'da Roblox'a yayın yapma iş akışında ekstra izin kontrolü ve sürekli serbest bırakma otomasyonu ile benzer işlevsellik sunar.Bu API'yi kullanarak bir deneyimin mevcut yerlerini yeni bir sürüme güncelleyebilir ve yayın iş akışınızı otomatikleştirmek için yararlı hale getirebilirsiniz.Örneğin, bu API'yi bir GitHub eyleminden çağırabilir ve başarılı entegrasyon testinden sonra otomatik olarak bir ikili yer dosyasını Roblox'a itebilirsiniz.

Sınırlar

• Bu API yalnızca HTTPS isteklerini destekler.
• Yayın API'si belirli istisna türlerini güncellemez.Deneyiminiz EditableImage , EditableMesh , PartOperation , SurfaceAppearance veya BaseWrap örnekleri içeriyorsa, onları değiştirdikten sonra Studio'dan yayınlayın.

Roblox'taki Yerler

Roblox'taki deneyimlerin birden fazla yeri olabilir, bir başlangıç ​​yeri kullanıcı deneyiminizin giriş noktası olarak ve deneyiminiz arasında kullanıcıları ışınlayabileceğiniz diğer isteğe bağlı yerler olarak.API'yi kullanarak başlangıç ​​yerini veya deneyiminizin diğer yerlerini sürüm kontrolü ile yayınlayabilirsiniz.

Bir deneyimin mevcut bir yerini güncellemeden önce, dünya Yer Kimliği ve deneyimin Evren Kimliği gerekir.The Yer Kimliği yeri tanımlar ve Evren Kimliği deneyimi tanımlar.Deneyiminiz sadece bir dünyasahip olsa bile her biri benzersizdir.

Bir dünyayayınla

Bir deneyimin mevcut bir yerini Yer Yayın API'si ile yayınlamak için:

1. Bir API anahtarı oluşturun Yaratıcı Panosu üzerinde. Aşağıdaki ayarları yaptığınızdan emin olun:

   1. Ekleyin evrensel yerler Erişim İzinlerine .
   2. Seçili deneyime Yaz operasyonunu ekleyin.

2. Yayınlamak istediğiniz dünyayayınlamak istediğiniz deneyimin Evren Kimliğini alın

   1. Navigate to the Yaratıcı Panosuna.

   2. Güncelletmek istediğiniz yerle deneyimi bulun.

   3. Deneyimin küçük küçük resimüzerine gelin, ⋯ düğmesine tıklayın ve Evren ID'sini kopyala seçin.

      

3. Güncelleştirmek istediğiniz yerin yer kimliğini güncelle.

   1. Yaratımlar sayfasında Yaratıcı Panosu üzerinde kalın ve hedef deneyimin küçük resmini tıklayın.
   2. Sol navigasyon menüsünde, Yerler sekmesine tıklayın.
   3. Güncellelemek istediğiniz yeri bulun ve küçük resimtıklayın.
   4. Yer ID'si yönlendirilen URL'de bulunur. Örneğin, URL'de , Yer ID'si dir.

4. API anahtarını x-api-key başlığına bir POST API isteğine ekleyin.Aşağıdaki iki örnek istek, bir Roblox XML yer dosyası referansına ( .rbxlx ) ve bir ikili yer dosyasına ( .rbxl ) işaret eder.

   XML Yer Dosyası İsteği
   $ 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

   Kod Yeri Dosya İsteği
   $ 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

   Komutları çalıştırmak için, ve 'yi gerçek Evren ID'si ile ve yayınlamak istediğiniz deneyimin Yer ID'si ile değiştirin ve yayınlamak istediğiniz yeri yerleştirin.

5. Talebinizi doğru gönderdiyseniz, aşağıdaki formatla bir başarı yanıtı gövdesi alırsınız: yer sürüm numarası ile

   Örnek Yanıt Vücudu
   { "versionNumber": 7 }

6. (Opsiyonel) Yüklemeyi Studio'da veya Yaratıcı Panosu üzerinde doğrula.