*Bu içerik, yapay zekâ (beta) kullanılarak çevrildi ve hatalar içerebilir. Sayfayı İngilizce görüntülemek için buraya tıkla.

Universe

Bir Roblox deneyimini temsil eder.

Nitelikler

pathstring

Evrenin kaynak yolu.

Biçim: universes/{universe_id}.

createTimestring

Yalnızca Çıkış

Evren yaratıldığındaki zaman damgası. Bu dizi Timestamp olarak biçimlendirilmiş.

updateTimestring

Yalnızca Çıkış

Evrenin son kez güncellendiği tarih ve saat. Bu dizi Timestamp olarak biçimlendirilmiş.

displayNamestring

Yalnızca Çıkış

Evrenin adı.

Bu alan, kök yerin adını güncelleyerek güncellenebilir.

descriptionstring

Yalnızca Çıkış

Evrenin açıklaması.

Bu alan, kök yerin açıklamasını güncelleyerek güncellenebilir.

owner için şunlardan biri:

userstring

Yalnızca Çıkış

Evren kullanıcıya aittir.

groupstring

Yalnızca Çıkış

Evren grup tarafından aittir.

visibilityEnum<string>

Yalnızca Çıkış

Evrenin halka açık olup olmadığı.

Olası değerler:

| Değer | Açıklama | | --- | --- | | VISIBILITY_UNSPECIFIED | Bu değeri kullanarak yapılan güncellemeler arka planda bir hata verecek.| | PUBLIC | Evren geneldir.| | ÖZEL | Evren özeldir.Bir evrenin görünürlüğü ÖZEL olarak ayarlanırsa, tüm aktif oyuncular hemen tüm çalışan sunuculardan kaldırılacaktır. |. Olası değerler:

facebookSocialLinkobject

Facebook sosyal bağlantısı.

twitterSocialLinkobject

Twitter sosyal bağlantısı.

youtubeSocialLinkobject

Youtube sosyal bağlantı.

twitchSocialLinkobject

Twitch sosyal bağlantısı.

discordSocialLinkobject

Discord sosyal bağlantısı.

robloxGroupSocialLinkobject

Roblox grubunun sosyal bağlantısı.

guildedSocialLinkobject

Guilded sosyal bağlantı.

voiceChatEnabledboolean

Deneyimdeki kullanıcılar için sesli sohbetin etkinleştirilip etkinleştirilmediği.

Bu değeri güncelleştirmek aktif sunucuları etkilemeyecektir.

ageRatingEnum<string>

Yalnızca Çıkış

Bu evrenin yaş değerlendirmesi.

Olası değerler:

| Değer | Açıklama | | --- | --- | | AGE_RATING_UNSPECIFIED | Yaş değeri belirlenmedi.| | AGE_RATING_ALL | Tüm kullanıcılar için desteklenir.| | AGE_RATING_9_PLUS | 9 yaş ve üzeri kullanıcılar için desteklenir.| | AGE_RATING_13_PLUS | 13 yaş ve üzeri kullanıcılar için desteklenir.| | AGE_RATING_17_PLUS | 17 yaş ve üzeri kullanıcılar için desteklenir. |. Olası değerler:

privateServerPriceRobuxnumber

Özel sunucuların Robux fiyatını temsil eder.

Eğer etkin değilse, bu evren için özel sunucular desteklenmez.

Sadece bir alan maskesi kullanırken devre dışı bırakılabilir.

Sıfıra ayarlandığında, tüm aktif özel sunucular devre dışı bırakılır.

Fiyatı değiştirmek tüm özel sunucu aboneliklerini iptal edecektir.

desktopEnabledboolean

Oyuncuların Deneyime Masaüstü aracılığıyla katılabilecekleri veya olmayacakları.

mobileEnabledboolean

Oyuncuların deneyime mobil aracılığıyla katılabilmesi veya katılamaması.

tabletEnabledboolean

Oyuncuların Tablet aracılığıyla Deneyime katılabilmesi veya katılamaması.

consoleEnabledboolean

Oyuncuların deneyime konsol aracılığıyla katılabilecekleri veya olmayacakları.

vrEnabledboolean

Oyuncuların VR aracılığıyla Deneyime katılabilmesi veya katılamaması.

Taban URL

https://apis.roblox.com

Universe Kaynağı

{
  "path": "universes/123",
  "createTime": "2023-07-05T12:34:56Z",
  "updateTime": "2023-07-05T12:34:56Z",
  "displayName": "ROBLOX Battle [OPEN]",
  "description": "OPEN SOURCE! \n Feel free to check out how we made this game and ask us about it!",
  "user": "string",
  "visibility": "VISIBILITY_UNSPECIFIED",
  "facebookSocialLink": {
    "title": "string",
    "uri": "string"
  },
  "twitterSocialLink": {
    "title": "string",
    "uri": "string"
  },
  "youtubeSocialLink": {
    "title": "string",
    "uri": "string"
  },
  "twitchSocialLink": {
    "title": "string",
    "uri": "string"
  },
  "discordSocialLink": {
    "title": "string",
    "uri": "string"
  },
  "robloxGroupSocialLink": {
    "title": "string",
    "uri": "string"
  },
  "guildedSocialLink": {
    "title": "string",
    "uri": "string"
  },
  "voiceChatEnabled": true,
  "ageRating": "AGE_RATING_UNSPECIFIED",
  "privateServerPriceRobux": "integer",
  "desktopEnabled": true,
  "mobileEnabled": true,
  "tabletEnabled": true,
  "consoleEnabled": true,
  "vrEnabled": true
}

Universe

Evreni Alın

GET /cloud/v2/universes/{universe_id}

Belirtilen evreni alır.

TalepYol Parametreleri

universe_idstring

Gerekli

Evren kimliği.

YanıtUniverse

GET /cloud/v2/universes/{universe_id}

curl -L -X GET 'https://apis.roblox.com/cloud/v2/universes/{universe_id}' \
  -H 'x-api-key: {your-api-key}'

Yanıt

{
  "path": "universes/123",
  "createTime": "2023-07-05T12:34:56Z",
  "updateTime": "2023-07-05T12:34:56Z",
  "displayName": "ROBLOX Battle [OPEN]",
  "description": "OPEN SOURCE! \n Feel free to check out how we made this game and ask us about it!",
  "user": "string",
  "visibility": "VISIBILITY_UNSPECIFIED",
  "facebookSocialLink": {
    "title": "string",
    "uri": "string"
  },
  "twitterSocialLink": {
    "title": "string",
    "uri": "string"
  },
  "youtubeSocialLink": {
    "title": "string",
    "uri": "string"
  },
  "twitchSocialLink": {
    "title": "string",
    "uri": "string"
  },
  "discordSocialLink": {
    "title": "string",
    "uri": "string"
  },
  "robloxGroupSocialLink": {
    "title": "string",
    "uri": "string"
  },
  "guildedSocialLink": {
    "title": "string",
    "uri": "string"
  },
  "voiceChatEnabled": true,
  "ageRating": "AGE_RATING_UNSPECIFIED",
  "privateServerPriceRobux": "integer",
  "desktopEnabled": true,
  "mobileEnabled": true,
  "tabletEnabled": true,
  "consoleEnabled": true,
  "vrEnabled": true
}

Universe

Evreni Güncelle

PATCH /cloud/v2/universes/{universe_id}

Belirtilen evreni günceller.

Bu yöntem tüm güncellenmiş alanları iade etmeyi garanti eder. Bu yöntem ayrıca tüm kaynağı iade edebilir.

Kapsamlar

universe:write

TalepYol Parametreleri

universe_idstring

Gerekli

Evren kimliği.

Sorgu Parametreleri

updateMaskstring

Güncellenmesi gereken alanların listesi. Bu dizi FieldMask olarak biçimlendirilmiş.

Talep GövdesiUniverse

YanıtUniverse

PATCH /cloud/v2/universes/{universe_id}

curl -L -X PATCH 'https://apis.roblox.com/cloud/v2/universes/{universe_id}?updateMask={string}' \
  -H 'x-api-key: {your-api-key}' \
  -H 'Content-Type: application/json' \
  --data '{
  "facebookSocialLink": {
    "title": "string",
    "uri": "string"
  },
  "twitterSocialLink": {
    "title": "string",
    "uri": "string"
  },
  "youtubeSocialLink": {
    "title": "string",
    "uri": "string"
  },
  "twitchSocialLink": {
    "title": "string",
    "uri": "string"
  },
  "discordSocialLink": {
    "title": "string",
    "uri": "string"
  },
  "robloxGroupSocialLink": {
    "title": "string",
    "uri": "string"
  },
  "guildedSocialLink": {
    "title": "string",
    "uri": "string"
  },
  "voiceChatEnabled": true,
  "privateServerPriceRobux": "integer",
  "desktopEnabled": true,
  "mobileEnabled": true,
  "tabletEnabled": true,
  "consoleEnabled": true,
  "vrEnabled": true
}'

Yanıt

{
  "path": "universes/123",
  "createTime": "2023-07-05T12:34:56Z",
  "updateTime": "2023-07-05T12:34:56Z",
  "displayName": "ROBLOX Battle [OPEN]",
  "description": "OPEN SOURCE! \n Feel free to check out how we made this game and ask us about it!",
  "user": "string",
  "visibility": "VISIBILITY_UNSPECIFIED",
  "facebookSocialLink": {
    "title": "string",
    "uri": "string"
  },
  "twitterSocialLink": {
    "title": "string",
    "uri": "string"
  },
  "youtubeSocialLink": {
    "title": "string",
    "uri": "string"
  },
  "twitchSocialLink": {
    "title": "string",
    "uri": "string"
  },
  "discordSocialLink": {
    "title": "string",
    "uri": "string"
  },
  "robloxGroupSocialLink": {
    "title": "string",
    "uri": "string"
  },
  "guildedSocialLink": {
    "title": "string",
    "uri": "string"
  },
  "voiceChatEnabled": true,
  "ageRating": "AGE_RATING_UNSPECIFIED",
  "privateServerPriceRobux": "integer",
  "desktopEnabled": true,
  "mobileEnabled": true,
  "tabletEnabled": true,
  "consoleEnabled": true,
  "vrEnabled": true
}

Universe

Evren Mesajını Yayınla
Beta

POST /cloud/v2/universes/{universe_id}:publishMessage

Evrenin canlı sunucularına bir mesaj yayınlar.

Sunucular, iletileri Mesajlaşma Hizmeti aracılığıyla tüketebilir.

Kapsamlar

universe-messaging-service:publish

TalepYol Parametreleri

universe_idstring

Gerekli

Evren kimliği.

Talep Gövdesi

topicstring

Mesajı yayınlayacak konu.

messagestring

Yayınlanacak mesaj.

POST /cloud/v2/universes/{universe_id}:publishMessage

curl -L -X POST 'https://apis.roblox.com/cloud/v2/universes/{universe_id}:publishMessage' \
  -H 'x-api-key: {your-api-key}' \
  -H 'Content-Type: application/json' \
  --data '{
  "topic": "my-topic",
  "message": "Hello, world!"
}'

Universe

Evren Sunucularını Yeniden Başlat

POST /cloud/v2/universes/{universe_id}:restartServers

Belirli bir evren için tüm aktif sunucuları yeniden başlatır, ancak yalnızca yeni bir deneyim sürümü yayınlandıysa.Deneyim güncellemelerinin yayınlanması için kullanılır.

Kapsamlar

universe:write

TalepYol Parametreleri

universe_idstring

Gerekli

Evren kimliği.

Talep Gövdesi

Yanıt

POST /cloud/v2/universes/{universe_id}:restartServers

curl -L -X POST 'https://apis.roblox.com/cloud/v2/universes/{universe_id}:restartServers' \
  -H 'x-api-key: {your-api-key}' \
  -H 'Content-Type: application/json' \
  --data '{}'

Yanıt

{}

Universe

Nitelikler

Universe

Evreni Alın

Universe

Evreni Güncelle

Universe

Evren Mesajını YayınlaBeta

Universe

Evren Sunucularını Yeniden Başlat

Evren Mesajını Yayınla
Beta