StudioService

Afficher les obsolètes

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

Création impossible
Service
Non répliqué

StudioService fournit l'accès à la configuration de Roblox Studio, permet d'importer des fichiers du système de fichiers de l'utilisateur et d'autres informations diverses.Il est destiné à être utilisé par Plugins afin de fournir une expérience utilisateur cohérente.

  • Les plugins qui permettent à l'utilisateur de déplacer des objets peuvent trouver GridSize , RotateIncrement et UseLocalSpace utiles.
  • Les plugins qui nécessitent que l'utilisateur importe des fichiers doivent utiliser PromptImportFile ou PromptImportFiles afin de recevoir des objets File.
  • Les plugins qui affichent des icônes de classes d'instance peuvent utiliser GetClassIcon .
  • Les plugins qui se soucient du script qui est actuellement en cours d'édition (le cas échéant) peuvent le lire à partir de ActiveScript .

Résumé

Propriétés

  • Lecture uniquement
    Non répliqué
    Lecture parallèle

    Renvoie la LuaSourceContainer actuellement en cours d'édition (si elle existe).

  • Lecture uniquement
    Non répliqué
    Lecture parallèle
  • Lecture uniquement
    Non répliqué
    Lecture parallèle

    Détermine la distance en studs par laquelle les outils de glissement et de déplacement de Studio déplacent les objets à chaque tick.

  • Lecture uniquement
    Non répliqué
    Lecture parallèle

    Détermine les degrés par lesquels l'outil de rotation de Studio fera pivoter les objets sélectionnés à chaque tick.

  • Sécurité des scripts Roblox
    Lecture parallèle
  • Lecture uniquement
    Non répliqué
    Lecture parallèle
  • Lecture uniquement
    Non répliqué
    Sécurité des scripts Roblox
    Lecture parallèle
  • Lecture uniquement
    Non répliqué
    Lecture parallèle

    La locale actuellement utilisée par Studio, par exemple en_US.

  • Non répliqué
    Lecture parallèle

    Détermine si les outils de Studio utilisent l'espace local d'un objet ou l'espace global.

Méthodes

Propriétés

ActiveScript

Lecture uniquement
Non répliqué
Lecture parallèle

ActiveScript fait référence au LuaSourceContainer actuellement en cours d'édition par l'utilisateur.Si l'utilisateur n'édite pas un script, ce sera nil .Ci-dessous est un exemple qui montre comment vous pouvez utiliser cette propriété pour mesurer la durée pendant laquelle un script était actif.


local StudioService = game:GetService("StudioService")
local startTime = os.time()
local activeScript
local function onActiveScriptChanged()
local newActiveScript = StudioService.ActiveScript
if activeScript and newActiveScript ~= activeScript then
local deltaTime = os.time() - startTime
print(("You edited %s for %d:%2.d"):format(activeScript.Name, deltaTime // 60, deltaTime % 60))
end
startTime = os.time()
activeScript = newActiveScript
end
StudioService:GetPropertyChangedSignal("ActiveScript"):Connect(onActiveScriptChanged)

DraggerSolveConstraints

Lecture uniquement
Non répliqué
Lecture parallèle

GridSize

Lecture uniquement
Non répliqué
Lecture parallèle

Taille de grille détermine la distance en points par lesquels les outils de glissement et de déplacement de Studio déplacent les objets à chaque tick.Cela est défini dans l'onglet modèle de la barre d'outils de l'utilisateur.

RotateIncrement

Lecture uniquement
Non répliqué
Lecture parallèle

RotateIncrement détermine l'angle en degrés par lequel l'outil de rotation de Studio fera pivoter les objets sélectionnés à chaque tick.Cela est défini dans l'onglet modèle de la barre d'outils de l'utilisateur.

Secrets

Sécurité des scripts Roblox
Lecture parallèle

ShowConstraintDetails

Lecture uniquement
Non répliqué
Lecture parallèle

ShowWeldDetails

Lecture uniquement
Non répliqué
Sécurité des scripts Roblox
Lecture parallèle

StudioLocaleId

Lecture uniquement
Non répliqué
Lecture parallèle

La propriété StudioLocaleId contient l'ID de local actuellement utilisé par Studio, par exemple en_US. Elle est utile lors de la localisation des plugins.

Ci-dessous est un exemple trivial de localisation basé sur la valeur renvoyée par cette fonction.


local locale = game:GetService("StudioService").StudioLocaleId
if locale == "en_US" then
print("Howdy, ya'll")
elseif locale == "en_GB" then
print("'Ello, gov'na")
elseif locale:sub(1, 2) == "en" then
print("Hello")
elseif locale == "fr_FR" then
print("Bonjour")
end

UseLocalSpace

Non répliqué
Lecture parallèle

UseLocalSpace détermine si les outils de mouvement/de rotation du studio manipuleront la partie CFrame en utilisant l'espace local d'un objet ou l'espace global.Par défaut, ce paramètre est basculé avec CtrlL ou L .Les plugins peuvent lire cette propriété s'ils implémentent leurs propres outils de déplacement d'objets.

Méthodes

GetClassIcon

Sécurité des plugins

GetClassIcon fournit un dictionnaire qui permet l'affichage d'une icône de fenêtre Explorateur de classe, par exempleL'appel de cette fonction avec « Part » renvoie des valeurs de propriété qui affichent l'icône de partie dans la fenêtre Explorateur.

Ci-dessous, une représentation littérale de la table de la valeur retournée lorsque cette fonction est appelée avec "Part".


{
Image = "rbxasset://textures/ClassImages.png",
ImageRectOffset = Vector2.new(16, 0),
ImageRectSize = Vector2.new(16, 16)
}

La fonction d'utilité ci-dessous peut s'avérer utile lors de l'affichage des icônes de classe :


local StudioService = game:GetService("StudioService")
local imageLabel = script.Parent
local function displayClassIcon(image, className)
for k, v in StudioService:GetClassIcon(className) do
image[k] = v -- Définir la propriété
end
end
displayClassIcon(imageLabel, "Part")

Paramètres

className: string
Valeur par défaut : ""

Retours

GetUserId

Sécurité des plugins

Renvoie l'ID d'utilisateur du studio s'il est connecté, sinon renvoie 0.


Retours

Échantillons de code

The example prints the currently logged in user's ID.

StudioService:GetUserId

-- Can only be used in a plugin
local StudioService = game:GetService("StudioService")
local Players = game:GetService("Players")
local loggedInUserId = StudioService:GetUserId()
local loggedInUserName = Players:GetNameFromUserIdAsync(loggedInUserId)
print("Hello,", loggedInUserName)

GizmoRaycast

Sécurité des plugins

Paramètres

origin: Vector3
Valeur par défaut : ""
direction: Vector3
Valeur par défaut : ""
raycastParams: RaycastParams
Valeur par défaut : "RaycastParams{IgnoreWater=false, BruteForceAllSlow=false, RespectCanCollide=false, CollisionGroup=Default, FilterDescendantsInstances={}}"

Retours

PromptImportFile

Rendement
Sécurité des plugins

Cette fonction demande à l'utilisateur actuel de Studio de sélectionner un fichier, qui sera ensuite chargé en tant que File.

Voir aussi :

Paramètres

fileTypeFilter: Array

Une liste des types de fichiers que l'utilisateur est autorisé à selectionner.Les types de fichiers sont formatés sans période.Par exemple, "jpg", "png" ne permettrait de sélectionner qu'un fichier JPG ou PNG.Si aucun filtre n'est fourni, le filtre est nil et permet à l'utilisateur de sélectionner n'importe quel type de fichier.

Valeur par défaut : "{}"

Retours

L'importé File . Retourne nil si aucun fichier n'a été sélectionné, ou si le fichier sélectionné était trop grand (la taille du fichier supérieure à 100 mégaoctets).

PromptImportFiles

Instances
Rendement
Sécurité des plugins

Cette fonction invite l'utilisateur actuel de Studio à sélectionner un ou plusieurs fichiers, qui seront ensuite chargés en tant que Files.

Lance une erreur si le filtre de type de fichier était une liste vide.

Voir aussi :

Paramètres

fileTypeFilter: Array

Une liste des types de fichiers que l'utilisateur est autorisé à selectionner.Les types de fichiers sont formatés sans période.Par exemple, "jpg", "png" ne permettrait de sélectionner que des fichiers JPG et PNG.Si aucun filtre n'est fourni, le filtre est nil et permet à l'utilisateur de sélectionner n'importe quel type de fichier.

Valeur par défaut : "{}"

Retours

Instances

L'importé Files .Retourne une liste vide si aucun fichier n'a été sélectionné.Renvoie nil si l'utilisateur a sélectionné un ou plusieurs fichiers trop grands (la taille du fichier est supérieure à 100 mégaoctets).

Évènements