*Ce contenu est traduit en utilisant l'IA (Beta) et peut contenir des erreurs. Pour consulter cette page en anglais, clique ici.

Universe

Représente une expérience Roblox.

Attributs

pathstring

Le chemin de ressource de l'univers.

Format : universes/{universe_id}.

createTimestring

Sortie seule

La date et l'heure de création de l'univers. Ce string est formatée en tant que Timestamp.

updateTimestring

Sortie seule

La date et l'heure de la dernière mise à jour de l'univers. Ce string est formatée en tant que Timestamp.

displayNamestring

Sortie seule

Le nom de l'univers.

Ce champ peut être mis à jour en mettant à jour le nom du lieu d'origineracine.

descriptionstring

Sortie seule

La description de l'univers.

Ce champ peut être mis à jour en mettant à jour la description du lieu d'origineracine.

Un des éléments suivants pour owner:

userstring

Sortie seule

L'univers est possédé par l'utilisateur.

groupstring

Sortie seule

L'univers est détenu par un groupe.

visibilityEnum<string>

Sortie seule

Si l'univers est ou non accessible publiquement.

Valeurs possibles :

| Valeur | Description | | --- | --- | | VISIBILITY_UNSPECIFIED | Les mises à jour utilisant cette valeur provoqueront une erreur sur le backend.| | PUBLIC | L'univers est public/publique.| | PRIVÉ | L'univers est privé.Si la visibilité d'un univers est réglée sur PRIVÉ, tous les joueurs actifs seront immédiatement retirés de tous les serveurs en cours d'exécution. |. Valeurs possibles :

facebookSocialLinkobject

Le liersocial Facebook.

twitterSocialLinkobject

Le liersocial Twitter.

youtubeSocialLinkobject

Le liersocial YouTube.

twitchSocialLinkobject

Le liersocial Twitch.

discordSocialLinkobject

Le liersocial Discord.

robloxGroupSocialLinkobject

Le liersocial du groupe Roblox.

guildedSocialLinkobject

Le liersocial Guilded.

voiceChatEnabledboolean

Si oui ou non le chat vocal est activé pour les utilisateurs dans l'expérience.

Mettre à jour cette valeur n'affectera pas les serveurs actifs.

ageRatingEnum<string>

Sortie seule

Le classement par âge de cet univers.

Valeurs possibles :

| Valeur | Description | | --- | --- | | AGE_RATING_UNSPECIFIED | Le classement d'âge n'est pas configurer.| | AGE_RATING_ALL | Soutenu pour tous les utilisateurs.| | AGE_RATING_9_PLUS | Soutenu pour les utilisateurs âgés de 9 ans et plus.| | AGE_RATING_13_PLUS | Soutenu pour les utilisateurs âgés de 13 ans et plus.| | AGE_RATING_17_PLUS | Soutenu pour les utilisateurs âgés de 17 ans et plus. |. Valeurs possibles :

privateServerPriceRobuxnumber

Représente le prix en Robux des serveurs privés.

Si désactivé, les serveurs privés ne sont pas pris en charge pour cet univers.

Ne peut être désactivé qu'en utilisant un masque de champ.

La définition à null désactivera tous les serveurs privés actifs.

Changer le prix annulera tous les abonnements de serveur privé.

desktopEnabledboolean

Si les joueurs peuvent ou non rejoindre l'expérience via le bureau.

mobileEnabledboolean

Si les joueurs peuvent ou non rejoindre l'expérience via mobile.

tabletEnabledboolean

Si les joueurs peuvent ou non rejoindre l'expérience via une tablette.

consoleEnabledboolean

Si les joueurs peuvent ou non rejoindre l'expérience via la console.

vrEnabledboolean

Si les joueurs peuvent ou non rejoindre l'expérience via VR.

URL de base

https://apis.roblox.com

La ressource 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}

Obtient l'univers spécifié.

RequêteParamètres du chemin

universe_idstring

Requis

L'ID de l'univers.

RéponseUniverse

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

Réponse

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

Mise à jour de l'univers spécifié.

Cette méthode est garantie pour retourner tous les champs mis à jour. Cette méthode peut également retourner la ressource entière.

Périmètres d'application

universe:write

RequêteParamètres du chemin

universe_idstring

Requis

L'ID de l'univers.

Paramètres de requête

updateMaskstring

La liste des champs à mettre à mise à jour. Cette chaîne est formatée comme un FieldMask.

Corps de la requêteUniverse

RéponseUniverse

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

Réponse

{
  "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
Bêta

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

Publie un message sur les serveurs en direct de l'univers.

Les serveurs peuvent consommer des messages via MessagingService.

Périmètres d'application

universe-messaging-service:publish

RequêteParamètres du chemin

universe_idstring

Requis

L'ID de l'univers.

Corps de la requête

topicstring

Le sujet sur lequel publier le message.

messagestring

Le message à publier.

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

Redémarre tous les serveurs actifs pour un univers spécifique si et seulement si une nouvelle version de l'expérience a été publiée.Utilisé pour publier des mises à jour d'expérience.

Périmètres d'application

universe:write

RequêteParamètres du chemin

universe_idstring

Requis

L'ID de l'univers.

Corps de la requête

Réponse

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

Réponse

{}

Universe

Attributs

Universe

Get Universe

Universe

Update Universe

Universe

Publish Universe MessageBêta

Universe

Restart Universe Servers

Publish Universe Message
Bêta