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 la importación de archivos desde el sistema de archivos del usuario y otra información miscelánea.Está destinado a ser utilizado por Plugins para proporcionar una experiencia de usuario consistente.

Resumen

Propiedades

  • Solo lectura
    No replicado
    Leer paralelo

    Refleja el LuaSourceContainer que está siendo editado actualmente (si es que hay alguno).

  • Solo lectura
    No replicado
    Leer paralelo
  • Solo lectura
    No replicado
    Leer paralelo

    Determina la distancia en studs por la cual las herramientas de arrastre y movimiento de Studio mueven objetos en cada tic.

  • Solo lectura
    No replicado
    Leer paralelo

    Determina los grados en los que la herramienta de rotación de Studio rotará los objetos seleccionados en cada tic.

  • Seguridad de scripts Roblox
    Leer paralelo
  • Solo lectura
    No replicado
    Leer paralelo
  • Solo lectura
    No replicado
    Seguridad de scripts Roblox
    Leer paralelo
  • Solo lectura
    No replicado
    Leer paralelo

    El idioma actualmente en uso por Studio, por ejemplo en_US .

  • No replicado
    Leer paralelo

    Determina si las herramientas de Studio usarán el espacio local de un objeto o el espacio global.

Métodos

Propiedades

ActiveScript

Solo lectura
No replicado
Leer paralelo

ActiveScript se refiere al LuaSourceContainer que actualmente está siendo editado por el usuario.Si el usuario no está editando un script, este será nil .A continuación, se muestra un ejemplo que muestra cómo puede usar esta propiedad para medir cuánto tiempo estuvo activo un script.


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

Tamaño de la cuadrícula determina la distancia en studs por la cual las herramientas de arrastrar y mover de Studio mueven objetos en cada tic.Esto se establece en la pestaña Modelo de la barra de herramientas del usuario.

RotateIncrement

Solo lectura
No replicado
Leer paralelo

Incremento de rotación determina el ángulo en grados con el cual la herramienta de rotación de Studio rotará los objetos seleccionados en cada tic.Esto se establece en la pestaña Modelo de la barra de herramientas del usuario.

Secrets

Seguridad de scripts Roblox
Leer paralelo

ShowConstraintDetails

Solo lectura
No replicado
Leer paralelo

ShowWeldDetails

Solo lectura
No replicado
Seguridad de scripts Roblox
Leer paralelo

StudioLocaleId

Solo lectura
No replicado
Leer paralelo

La propiedad StudioLocaleId contiene el idioma actualmente en uso por Studio, por ejemplo en_US. Es útil al traducir plugins.

A continuación se muestra un ejemplo trivial de localización basado en el valor devuelto por 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 el CFrame de una parte usando el espacio local de un objeto o el espacio global.Por defecto, esta configuración se alterna con CtrlL o L .Los plugins pueden leer de esta propiedad si implementan sus propias herramientas de movimiento de objetos.

Métodos

GetClassIcon

Seguridad del plugin

GetClassIcon proporciona un diccionario que permite la visualización de un íconode ventana de explorador de clase, por ejemploLlamar a esta función con "Parte" devuelve valores de propiedad que muestran el icono de parte desde la ventana del explorador.

A continuación se muestra una representación literal de la tabla del valor devuelto cuando se llama esta función 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
Valor predeterminado: ""

Devuelve

GetUserId

Seguridad del plugin

Devuelve el ID de usuario de Studio si está iniciado sesión, de lo contrario devuelve 0.


Devuelve

Muestras de código

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

Seguridad del plugin

Parámetros

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

Devuelve

PromptImportFile

Proporciona
Seguridad del plugin

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

Vea 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 período.Por ejemplo, "jpg", "png" permitiría que solo se seleccionara un archivo JPG o PNG.Si no se proporciona un filtro, el filtro es nil y permite al usuario seleccionar cualquier tipo de archivo.

Valor predeterminado: "{}"

Devuelve

El importado File . Regresa nil si no se seleccionaron archivos o si el archivo seleccionado era demasiado grande (FileSize mayor a 100 megabytes).

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.

Vea 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 período.Por ejemplo, "jpg", "png" permitiría que solo se seleccionaran archivos JPG y PNG.Si no se proporciona un filtro, el filtro es nil y permite al usuario seleccionar cualquier tipo de archivo.

Valor predeterminado: "{}"

Devuelve

Instances

El importado Files .Devuelve una lista vacía si no se seleccionaron archivos.Devuelve nil si el usuario seleccionó uno o más archivos que eran demasiado grandes (FileSize mayor que 100 megabytes).

Eventos