*이 콘텐츠는 AI(베타)를 사용해 번역되었으며, 오류가 있을 수 있습니다. 이 페이지를 영어로 보려면 여기를 클릭하세요.

Universe

Roblox 경험을 대표합니다.

특성

pathstring

우주의 리소스 경로.

형식: universes/{universe_id}.

createTimestring

출력 전용

우주가 생성된 시점의 타임스탬프. 이 문자열은 Timestamp 형식으로 지정됩니다.

updateTimestring

출력 전용

우주가 마지막으로 업데이트된 시간戳. 이 문자열은 Timestamp 형식으로 지정됩니다.

displayNamestring

출력 전용

우주의 이름.

이 필드는 루트 플레이스이름을 업데이트하여 업데이트할 수 있습니다.

descriptionstring

출력 전용

우주의 설명.

이 필드는 루트 플레이스설명을 업데이트하여 업데이트할 수 있습니다.

owner에 대해 다음 중 하나 선택 가능:

userstring

출력 전용

우주는 사용자 소유입니다.

groupstring

출력 전용

우주는 그룹 소유입니다.

visibilityEnum<string>

출력 전용

우주가 공개적으로 액세스할 수 있는지 여부.

가능한 값:

| 값 | 설명 | | --- | --- | | VISIBILITY_UNSPECIFIED | 이 값을 사용하여 업데이트하면 백엔드에서 오류가 발생합니다.| | 공개 | 우주는 공개입니다.| | 개인 | 우주는 비공개.우주의 가시성이 개인으로 설정되면 모든 활성 플레이어가 실행 중인 모든 서버에서 즉시 제거됩니다. |. 가능한 값:

facebookSocialLinkobject

Facebook의 소셜 연결.

twitterSocialLinkobject

Twitter의 소셜 연결.

youtubeSocialLinkobject

Youtube 소셜 연결.

twitchSocialLinkobject

Twitch 소셜 연결.

discordSocialLinkobject

Discord 소셜 연결.

robloxGroupSocialLinkobject

Roblox 그룹 소셜 연결.

guildedSocialLinkobject

Guilded 소셜 연결.

voiceChatEnabledboolean

경험의 사용자에게 음성 채팅이 활성화되었는지 여부.

이 값을 업데이트하면 활성 서버에 영향을 주지 않습니다.

ageRatingEnum<string>

출력 전용

이 우주의 연령 평가.

가능한 값:

| 값 | 설명 | | --- | --- | | AGE_RATING_UNSPECIFIED | 나이 등급이 설정되지 않습니다.| | AGE_RATING_ALL | 모든 사용자에 대해 지원됩니다.| | AGE_RATING_9_PLUS | 9세 이상의 사용자를 위해 지원됩니다.| | AGE_RATING_13_PLUS | 13세 이상의 사용자를 위해 지원됩니다.| | AGE_RATING_17_PLUS | 17세 이상의 사용자를 위해 지원됩니다. |. 가능한 값:

privateServerPriceRobuxnumber

개인 서버의 Robux 가격을 나타냅니다.

해제되지 않으면 이 우주에서 개인 서버는 지원되지 않습니다.

필드 마스크를 사용할 때만 비활성화할 수 있습니다.

null로 설정하면 모든 활성 개인 서버가 비활성화됩니다.

가격을 변경하면 모든 개인 서버 구독이 취소됩니다.

desktopEnabledboolean

플레이어가 데스크톱을 통해 경험에 참여할 수 있는지 여부.

mobileEnabledboolean

플레이어가 모바일을 통해 경험에 참여할 수 있는지 여부.

tabletEnabledboolean

플레이어가 태블릿을 통해 경험에 참여할 수 있는지 여부.

consoleEnabledboolean

플레이어가 콘솔을 통해 경험에 참여할 수 있는지 여부.

vrEnabledboolean

플레이어가 VR을 통해 경험에 참여할 수 있는지 여부.

기본 URL

https://apis.roblox.com

Universe 리소스

{
  "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

Get Universe

GET /cloud/v2/universes/{universe_id}

지정된 우주를 가져옵니다.

요청경로 매개 변수

universe_idstring

필수

유니버스 ID.

응답Universe

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}'

응답

{
  "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

Update Universe

PATCH /cloud/v2/universes/{universe_id}

지정된 유니버스를 업데이트합니다.

이 메서드는 업데이트된 모든 필드를 반환하도록 보장됩니다. 이 메서드는 전체 리소스도 반환할 수 있습니다.

범위

universe:write

요청경로 매개 변수

universe_idstring

필수

유니버스 ID.

쿼리 매개 변수

updateMaskstring

업데이트할 필드 목록. 이 문자열은 FieldMask 형식으로 지정됩니다.

요청 본문Universe

응답Universe

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
}'

응답

{
  "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

Publish Universe Message
베타

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

유니버스의 라이브 서버에 메시지를 게시합니다.

서버는 메시징 서비스를 통해 메시지를 소비할 수 있습니다.

범위

universe-messaging-service:publish

요청경로 매개 변수

universe_idstring

필수

유니버스 ID.

요청 본문

topicstring

메시지를 게시할 주제.

messagestring

게시할 메시지.

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

Restart Universe Servers

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

경험의 새 버전이 게시된 경우에만 특정 우주에 대한 모든 활성 서버를 다시 시작하고 모든 활성 서버가 중지되지 않습니다.경험 업데이트 릴리스에 사용됩니다.

범위

universe:write

요청경로 매개 변수

universe_idstring

필수

유니버스 ID.

요청 본문

응답

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 '{}'

응답

{}

Universe

특성

Universe

Get Universe

Universe

Update Universe

Universe

Publish Universe Message베타

Universe

Restart Universe Servers

Publish Universe Message
베타