StudioService
*Ce contenu est traduit en utilisant l'IA (Beta) et peut contenir des erreurs. Pour consulter cette page en anglais, clique ici.
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
Renvoie la LuaSourceContainer actuellement en cours d'édition (si elle existe).
Détermine la distance en studs par laquelle les outils de glissement et de déplacement de Studio déplacent les objets à chaque tick.
Détermine les degrés par lesquels l'outil de rotation de Studio fera pivoter les objets sélectionnés à chaque tick.
La locale actuellement utilisée par Studio, par exemple en_US.
Détermine si les outils de Studio utilisent l'espace local d'un objet ou l'espace global.
Méthodes
Fournit un dictionnaire qui permet l'affichage d'une icône de fenêtre Explorateur de classe.
Renvoie l'ID d'utilisateur du studio s'il est connecté, sinon renvoie 0.
Demande à l'utilisateur actuel de Studio de sélectionner un fichier à ajouter en tant que File.
Demande à l'utilisateur actuel de Studio de sélectionner des fichiers à ajouter comme Files.
Propriétés
ActiveScript
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
GridSize
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
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
ShowConstraintDetails
ShowWeldDetails
StudioLocaleId
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").StudioLocaleIdif locale == "en_US" thenprint("Howdy, ya'll")elseif locale == "en_GB" thenprint("'Ello, gov'na")elseif locale:sub(1, 2) == "en" thenprint("Hello")elseif locale == "fr_FR" thenprint("Bonjour")end
UseLocalSpace
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
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
Retours
GetUserId
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.
-- 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
Paramètres
Retours
PromptImportFile
Cette fonction demande à l'utilisateur actuel de Studio de sélectionner un fichier, qui sera ensuite chargé en tant que File.
Voir aussi :
- StudioService:PromptImportFiles() , la même fonction mais pour charger une liste de fichiers au lieu d'un seul fichier
Paramètres
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.
Retours
PromptImportFiles
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 :
- StudioService:PromptImportFile() , la même fonction mais pour le chargement d'un seul fichier au lieu d'une liste de fichiers
Paramètres
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.
Retours
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).