StudioService

Mostrar obsoleto

*Este contenido se traduce usando la IA (Beta) y puede contener errores. Para ver esta página en inglés, haz clic en aquí.

No creable
Servicio
No replicado

StudioService proporciona acceso a la configuración de Roblox Studio, permite importar archivos del sistema de archivos del usuario y otra información. Se destinan a ser usados por Plugins para proporcionar una experiencia de usuario consistente.

Resumen

Propiedades

Métodos

Propiedades

ActiveScript

Solo lectura
No replicado
Leer paralelo

ActiveScript se refiere a la LuaSourceContainer que se está editando activamente por el usuario. Si el usuario no está editando un script, esto será nil . Abajo está un ejemplo que muestra cómo puede usar esta propiedad para medir durante cuánto tiempo un script estuvo activo.


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

Solo lectura
No replicado
Leer paralelo

GridSize

Solo lectura
No replicado
Leer paralelo

GridSize determina la distancia en studs por la cual las herramientas de Studio mueven los objetos cada tick. Esto se establece en la pestaña Modelo del usuario debajo de la sección Ajustar a la cuadrícula .

Transform snapping tools indicated in Model tab

RotateIncrement

Solo lectura
No replicado
Leer paralelo

RotateIncrement determina el ángulo en grados en que se girará la herramienta de rotación de Studio seleccionados objetos cada toque. Esto se establece en la pestaña Modelo del usuario debajo de la sección Ajustar a la cuadrícula .

Transform snapping tools indicated in Model tab

Secrets

Leer paralelo
Seguridad de scripts Roblox

ShowConstraintDetails

Solo lectura
No replicado
Leer paralelo

ShowWeldDetails

Solo lectura
No replicado
Leer paralelo
Seguridad de scripts Roblox

StudioLocaleId

Solo lectura
No replicado
Leer paralelo

La propiedad StudioLocalId contiene el idioma actualmente en uso por Studio, por ejemplo, en_US . Es útil cuando se localizan plugins.

A continuación, se muestra un ejemplo trivial de localización basado en el valor que devuelve esta función.


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

No replicado
Leer paralelo

UseLocalSpace determina si las herramientas de movimiento / rotación de Studio manipularán un parte's Class.BasePart.CFrame|CFrame usando el espacio local de un objeto o el espacio global. Por defecto, esta configuración se alterna con CFrameL o 0> ⌘ 0> 3> L

Métodos

GetClassIcon

Seguridad del plugin

GetClassIcon proporciona un diccionario que permite la visualización de un íconode ventana Explorador de clase, por ejemplo, al llamar esta función con "Parte" se devuelven valores de propiedad que muestran el icono de la parte desde la ventana Explorador.

A continuación, se muestra una representación literal de la tabla cuando esta función se llama con "Part" .


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

La función de utilidad a continuación puede ser útil al mostrar iconos de clase:


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 -- Establecer propiedad
end
end
displayClassIcon(imageLabel, "Part")

Parámetros

className: string

Devuelve

GetUserId

Seguridad del plugin

Devuelve el ID de usuario de Studio si está conectado, de lo contrario devuelve 0.


Devuelve

Muestras de código

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

Seguridad del plugin

Parámetros

origin: Vector3
direction: Vector3
raycastParams: RaycastParams
Valor predeterminado: "RaycastParams{IgnoreWater=false, BruteForceAllSlow=false, RespectCanCollide=false, CollisionGroup=Default, FilterDescendantsInstances={}}"

Devuelve

PromptImportFile

Proporciona
Seguridad del plugin

Esta función solicita al usuario actual de Studio que seleccione un archivo, que luego se cargará como un File .

Véase también:

Parámetros

fileTypeFilter: Array

Una lista de tipos de archivos que el usuario está autorizado a elegir. Los tipos de archivos se formatean sin un signo de interrogación. Por ejemplo, "jpg", "png" solo permitiría seleccionar un archivo JPG o PNG. Si no se proporciona ningún filtro, el filtro es nulo y permite al usuario seleccionar cualquier tipo de archivo.

Valor predeterminado: "{}"

Devuelve

El File importado. Muestra nulo si no se seleccionaron archivos, o si el archivo seleccionado era demasiado grande (FileSize mayor a 100 MB).

PromptImportFiles

Instances
Proporciona
Seguridad del plugin

Esta función solicita al usuario actual de Studio que seleccione uno o más archivos, que luego se cargarán como Files .

Lanza un error si el filtro de tipo de archivo era una lista vacía.

Véase también:

Parámetros

fileTypeFilter: Array

Una lista de tipos de archivo que el usuario está autorizado a elegir. Los tipos de archivo se formatean sin un signo de interrogación. Por ejemplo, "jpg", "png" solo permitiría archivos JPG y PNG para ser seleccionados. Si no se proporciona ningún filtro, el filtro es nulo y permite al usuario seleccionar cualquier tipo de archivo.

Valor predeterminado: "{}"

Devuelve

Instances

El Files importado. Muestra una lista vacía si no se seleccionaron archivos. Muestra nulo si el usuario seleccionó uno o más archivos que son demasiado grandes (FileSize mayor a 100 MB).

Eventos