Yer yayınlama kullanım kılavuzu | Dokümantasyon

Yer yayınlama API'si, Studio'da Roblox'a yayın yapmaya benzer bir işlevsellik sunar; ek izin kontrolü ve sürekli yayın akışında otomasyon ile birlikte gelir. Bu API'yi mevcut bir oyunun yerlerini yeni bir versiyona güncellemek için kullanabilirsiniz, bu da yayın akışınızı otomatikleştirmek için faydalı hale getirir. Örneğin, bu API'yi bir GitHub eyleminden çağırabilir ve başarılı entegrasyon testlerinden sonra otomatik olarak binary bir yer dosyasını Roblox'a yüklemesini sağlayabilirsiniz.

Sınırlamalar

Bu API yalnızca HTTPS isteklerini destekler.
Yer yayınlama API'si belirli örnek türlerini güncellemiyor. Oyununuz EditableImage, EditableMesh, PartOperation, SurfaceAppearance veya BaseWrap örnekleri içeriyorsa, bunları değiştirdikten sonra Studio'dan yayın yapın.

Roblox'taki Yerler

Roblox'taki oyunlar birden fazla yere sahip olabilir; kullanıcıların oyununuza giriş yaptığı bir başlangıç yeri ve kullanıcıları arasında teleportlayabileceğiniz isteğe bağlı diğer yerler. API'yi, yerlerinizi sürüm kontrolü ile birlikte yayınlamak için başlangıç yerini veya diğer yerleri yayınlamak için kullanabilirsiniz.

Bir oyunun mevcut bir yerini güncelleyebilmek için, yerin Yer ID'sine ve oyunun Evrensel ID'sine ihtiyacınız var. Yer ID'si yeri tanımlar ve Evrensel ID oyunu tanımlar. Her biri benzersizdir, oyununuz yalnızca bir yere sahip olsa bile.

Bir yeri yayınlayın

Bir oyunun mevcut yerini Yer Yayınlama API'si ile yayınlamak için:

Yaratıcı Kontrol Paneli'nde bir API anahtarı oluşturun. Aşağıdaki ayarları yaptığınızdan emin olun:
1. Erişim İzinlerine evren-yerleri ekleyin.
2. Seçilen oyununuz için Yazma işlemi ekleyin.
Yerinizi yayınlamak istediğiniz oyunun Evrensel ID'sini alın.
1. Yaratıcı Kontrol Paneli'ne gidin.
2. Güncellemek istediğiniz yerle birlikte oyunu bulun.
3. Oyunun küçük resminin üzerine gelin, ⋯ butonuna tıklayın ve Evrensel ID'yi Kopyala seçeneğini seçin.
Güncellemek istediğiniz yerin Yer ID'sini alın.
1. Yaratıcı Kontrol Paneli'ndeki Yaratımlar sayfasında kalın ve hedef oyunun küçük resmine tıklayın.
2. Sol navigasyon menüsünde Yerler sekmesine tıklayın.
3. Güncellemek istediğiniz yeri bulun ve küçük resmine tıklayın.
4. Yer ID'si, yönlendirilen URL'de bulunmaktadır. Örneğin, URL'de https://create.roblox.com/dashboard/creations/experiences/0000000/places/111111/configure,**Yer ID'si**111111`'dir.

API'ye POST isteği yapmak için x-api-key başlığına API Anahtarını ekleyin. Aşağıdaki iki örnek istek, bir Roblox XML yer dosyasını (.rbxlx) ve bir binary yer dosyasını (.rbxl) referans alır.

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

Binary 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/octet-stream' \
--data-binary @/home/placefiles/place1.rbxl

Komutları çalıştırmak için, {universeId} ve {placeId} yerini, yayınlamak istediğiniz oyun ve yerin gerçek Evrensel ID'si ve Yer ID'si ile değiştirin.

İsteğinizi doğru bir şekilde gönderirseniz, aşağıdaki formatta yer sürüm numarasının bulunduğu bir başarı yanıtı alırsınız:
```
Örnek Yanıt Gövdesi
{ "versionNumber": 7 }
```
(İsteğe bağlı) Yüklemeyi Studio'da veya Yaratıcı Kontrol Paneli'nde doğrulayın.