*เนื้อหานี้แปลโดยใช้ AI (เวอร์ชัน Beta) และอาจมีข้อผิดพลาด หากต้องการดูหน้านี้เป็นภาษาอังกฤษ ให้คลิกที่นี่

Universe

แทนที่ประสบการณ์ Roblox

คุณลักษณะ

pathstring

เส้นทางทรัพยากรของจักรวาล

รูปแบบ: universes/{universe_id}.

createTimestring
เอาต์พุตเท่านั้น

เวลาที่สร้างจักรวาล เมื่อสร้างแล้ว. สตริงนี้มีรูปแบบประทับเวลา

updateTimestring
เอาต์พุตเท่านั้น

เวลาที่เครือข่ายได้รับการปรับปรุงล่าสุด. สตริงนี้มีรูปแบบประทับเวลา

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 ของเซิร์ฟเวอร์ส่วนตัว

หากไม่ได้ตั้งค่า เซิร์ฟเวอร์ส่วนตัวจะไม่สนับสนุนสําหรับจักรวาลนี้

สามารถปิดใช้งานได้เมื่อใช้หน้ากากฟิลด์เท่านั้น

การตั้งค่าเป็นโมฆะจะปิดใช้งานเซิร์ฟเวอร์ส่วนตัวทั้งหมดที่ใช้งานอยู่

การเปลี่ยนราคาจะยกเลิกการสมัครใช้เซิร์ฟเวอร์ส่วนตัวทั้งหมด.

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
เวอร์ชัน Beta

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

เผยแพร่ข้อความไปยังเซิร์ฟเวอร์สดของจักรวาล

เซิร์ฟเวอร์สามารถรับข้อความผ่าน MessagingService ได้

ขอบเขต
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 '{}'
การตอบกลับ

{}