This example creates a new anchored `BasePart` named _Part_ at the position
`{0, 0, 0}`.

It then creates a new surface light with `brightness` of 1, `Color3` `color`
of `{255/255, 255/255, 255/255}` (white) and `range` of 16 studs. The surface
light's parent is set to the BasePart we created. To view the light, navigate
to the part at `{0, 0, 0}` or move the _Part_ created to a location visible to
the player.

Please note that the properties of the created surface light can easily be
changed by modifying the property values in the code sample below.
Additionally, if you have an existing surface light, you can also create a
similar script that modifies that surface light instead of creating a new
BasePart and light.


SurfaceLight

SurfaceLight.Angle

SurfaceLight.Face

SurfaceLight.Range

Light

Light.Brightness

Light.Color

Light.Enabled

Light.Shadows

Demonstrates detecting changes to an instance's ancestry by connecting to the `Class.Instance.AncestryChanged` event.

The ChangingPart's Parent is set to different values overtime. The parent of the part is the part's ancestor, so the `Class.Instance.AncestryChanged` event will fire whenever it changes.


Instance.AncestryChanged

child

parent

Instance.AttributeChanged

attribute

This snippet prints the names of objects as they are added to the Workspace:


Instance.ChildAdded

This snippet prints the names of objects as they are removed from the
Workspace:


Instance.ChildRemoved

This following example will print the name of any object that is added to the
Workspace:


Instance.DescendantAdded

descendant

The following example prints the name of any descendant as it is being removed
from the Workspace:


Instance.DescendantRemoving

This sample demonstrates how, when using Immediate signal behavior, an Instance being destroyed remains in place until the connected function yields.


This sample demonstrates how, when using Deferred signal behavior,
an Instance is destroyed before the signal fires.


Instance.Destroying

Instance.childAdded

Instance:AddTag

This example creates a Part and adds a few sparkle objects to the part. Then
it calls Part:ClearAllChildren() to remove all of the children.


Instance:ClearAllChildren

Demonstrates cloning a model using `Class.Instance:Clone()`.

Instance:Clone

Demonstrates destroying a Part using the `Class.Instance:Destroy()` function.

This function is the correct way to dispose of objects that are no longer required.


Instance:Destroy

Instance:FindFirstAncestor

name

Instance:FindFirstAncestorOfClass

className

Instance:FindFirstAncestorWhichIsA

The below would look in Workspace for an object name "Brick". If found, it
will change the name of the object to "Foo".


Instance:FindFirstChild

recursive

Instance:FindFirstChildOfClass

Instance:FindFirstChildWhichIsA

Instance:FindFirstDescendant

Instance:GetActor

Instance:GetAttribute

Instance:GetAttributeChangedSignal

Instance:GetAttributes

The below would print the name of all objects currently in Workspace when ran.


Instance:GetChildren

Instance:GetDebugId

scopeLength

GetDescendants is often used to do something to all the descendants that are a
particular type of object. The code in this example uses GetDescendants and
`Class.Instance:IsA()` to find all of the parts in the workspace and turns
them green.


Instance:GetDescendants

This code sample demonstrates the behavior of `Class.Instance:GetFullName()`.
It shows how the function behaves when called on an object not in the
`DataModel` hierarchy, and it also shows how the return value does not escape
special characters.


This code sample re-implements the `Class.Instance:GetFullName()` function in
Lua.


Instance:GetFullName

Instance:GetStyled

Instance:GetTags

Instance:HasTag

Demonstrates determining if one instance is the ancestor of another using `Class.Instance:IsAncestorOf()`

Workspace and SpawnLocation are ancestors of the SpawnLocation's decal.
Workspace is an ancestor of SpawnLocation.

SpawnLocation and its decal are descendants of Workspace, not ancenstors.
Decal is a descendant to SpawnLocation, not an ancestor.


Instance:IsAncestorOf

Instance:IsDescendantOf

ancestor

The following code demonstrates how a part can be re-added to the DataModel
after being removed:


Instance:Remove

Instance:RemoveTag

Instance:SetAttribute

value

The following code waits for an instance named "Part" to be added to
Workspace.


Instance:WaitForChild

childName

timeOut

Instance:children

Instance:clone

Instance:destroy

Instance:findFirstChild

Instance:getChildren

Instance:isDescendantOf

Instance:remove

Instance

Instance.Archivable

Instance.Capabilities

Instance.Name

Instance.Parent

Instance.RobloxLocked

Instance.Sandboxed

Instance.UniqueId

Instance.archivable

This sample demonstrates the subtleties of the Changed event on normal objects
and "-Value" objects.


This code sample demonstrates the Changed event firing within a parent object.


Object.Changed

property

This code sample demonstrates how to save a value before a changed event fires
on it in order to get more information about a change.


This code sample demonstrates the equivalence of the `Changed` event and event
returned by `GetPropertyChangedSignal`.


Object:GetPropertyChangedSignal

Demonstrates determining the class of Workspace using `Class.Instance:IsA()`

Workspace is of class 'Workspace', so the first statement is true.
Workspace is not of class 'BasePart', so the second statement is false.
Workspace inherits from Instance and therefore is of class 'Instance', so the third statement is true.


Object:IsA

Object:isA

Object

Object.ClassName

Object.className

/reference/engine/classes/SurfaceLight.yaml

Una fuente de luz que emite iluminación de un color y brillo específicos de una cara para un rango específico.

Un `Class.Actor` es un contenedor para el código que se puede dividir con seguridad en sus propios subproceso.

Class

Actor

Luau

Array

Un valor de color que está compuesto por componentes rojos, verdes y azules.

Data Type

Color3

Dictionary

O NormalId Enum define qual lado/rosto de uma Peça é usado.

Enum

Enum.NormalId

Um objeto que executa funções conectadas em uma ocorrência específica.

RBXScriptSignal

Variant

Tipo de dado tendo um valor de verdadeiro ou falso.

bool

Um número de ponto flutuante de precisão dupla.

number

Uma sequência de caracteres, como letras, números e símbolos.

string

void

Visão geral

Guias

Tutoriais

Referência

Recursos

Arte

Design

Motor

Avatar

Legado

Nuvem

Este método é assíncrono e retorna uma "Operação", que representa o estado atual da operação. Ele contém um caminho de endpoint que você pode solicitar para obter a resposta real e os metadados aplicáveis. Veja o [documentation]({longRunningOperationsLink}) em operações de longo prazo para obter mais informações.
            
As seções a seguir descrevem os objetos de resposta e metadados que são fornecidos quando uma operação se completa.

Pontos de extremidade beta estão prontos para uso público. Alterações  danosas são possíveis mas raras.

Este campo pode ser definido ao criar um recurso, mas não pode ser modificado por solicitações subsequentes.

Este campo pode ser fornecido em solicitações, mas nunca será incluído em respostas.

Por chave de API: {maxInPeriod} solicitações a cada {periodInSeconds} segundos por endereço IP

Este campo pode ser definido como respostas, mas será ignorado em solicitações.

As seguintes permissões de chave API são requeridas para chamar este endpoint. Para mais informações sobre gerar chaves apropriadas, veja [Gerenciando chaves API]({apiKeyReferenceDocLink}).

Os seguintes endpoints estão disponíveis em caminhos relativos à URL base.

Esta cadeia de caracteres está formatada como um [FieldMask](/cloud/reference/types#fieldmask).

Um valor JSON pode ser `null`, `boolean`, `string`, `number`, `array`, ou `object`.

Os seguintes escopos são necessários para que sua aplicação OAuth 2.0 use este endpoint. Para obter mais informações sobre como registrar um aplicativo OAuth 2.0, consulte [Registro do aplicativo e revisão]({oauth2ReferenceDocLink}).

Os seguintes objetos descrevem payloads que são aceitos ou retornados. Veja cada endpoint para mais informações sobre quando esses objetos são usados.

Esta cadeia de caracteres é formatada como um [Timestamp](/cloud/reference/types#timestamp).

Os seguintes escopos são necessários para que sua aplicação OAuth 2.0 use este endpoint. Para obter mais informações sobre como registrar um aplicativo OAuth 2.0, consulte [Registro e revisão do aplicativo]({oauth2ReferenceDocLink}).

Isto permite visualizar informações sobre seus ativos.

Isto permite enviar e atualizar ativos para a Roblox.

Concede a capacidade de atualizar emblemas de propriedade do usuário.

Isso permite visualizar informações sobre seus itens de comércio.

Isso permite editar suas conexões de comerciante.

Isso permite que você visualize informações sobre seus produtos da Loja do Criador.

Isso permite que você modifique informações sobre seus produtos da Loja de Criadores.

Isso permite visualizar informações sobre suas comunidades

Isso permite que você gerencie solicitações de participação da comunidade e atualizações de funções para sua conta.

Isto permite visualizar informações sobre seu inventário.

Concede acesso para gerenciar seus emblemas.

Concede acesso para gerenciar seus emblemas e gastar Robux.

Concede acesso para gerenciar seus produtos de desenvolvedor.

Concede acesso para ler informações sobre as experiências que você segue.

Concede acesso para seguir e deixar de seguir experiências em seu nome.

Concede acesso para gerenciar seus passes.

Concede acesso para gerenciar suas comunidades.

Concede permissão para ler informações da comunidade.

Concede permissões de gerenciamento de comunidade.

Concede acesso para ler e escrever suas tabelas de localização

Concede acesso para gerenciar a colaboração de equipe para todas as experiências que você possui.

Concede acesso para gerenciar suas experiências e certas informações associadas a suas experiências (por exemplo, informações de localização).

Concede acesso para ler as informações de localização das suas experiências.

Concede acesso para modificar as preferências de localização das suas experiências.

Concede acesso para gerenciar sua conta de usuário.

Concede acesso para modificar as preferências de localização do usuário.

Isto permite publicar mensagens em nome de um usuário.

Isto permite o envio de notificações da sua experiência aos usuários.

Isto permite listar segredos aliados à sua experiência.

Isto permite criar e atualizar segredos relacionados à sua experiência.

Concede acesso para ler sobre seus produtos de assinatura.

Concede a capacidade de ler informações do local.

Concede a capacidade de editar as informações do local.

Esta operação permite acesso para publicar novas versões de experiências para a Roblox.

Concede a capacidade de ler informações da experiência.

Concede a capacidade de editar informações da experiência.

Permite que você veja restrições de usuário na experiência.

Permite que você edite restrições de usuário na experiência.

Concede a capacidade de ler o status Premium e verificado do usuário.

Isso permite que você veja as contas sociais de um usuário.

Isto habilita a funcionalidade de entrada única.

Isso permite acesso à leitura das informações do seu perfil.

Valor padrão: {defaultValueStart}{defaultValueEnd}

Um array é uma lista ordenada de valores. Arrays são úteis para armazenar coleções de dados.

Um conjunto de pares chave-valor, onde as chaves podem ser qualquer número, string ou objeto.

Essa função retorna imediatamente, se possível, mas pode gerar a sequência que a chamou até que possa retornar um valor.

{nameStart}nome{nameEnd} não é mais suportado ou mantido pela Roblox.

Essa operação matemática não é mais suportada ou mantida pela Roblox.

Este membro não aparece no navegador de objetos e não é para uso geral.

Este membro só é acessível somente através da barra de comandos. Tentar acessar este membro a partir de scripts causa um erro.

Esta função não pode pausar o tópico Lua que a chamou.

Tentar acessar este membro em scripts causa um erro. Você pode ser capaz de acessar este membro na janela de propriedades do Roblox Studio.

Este membro não aparece no Navegador de Objetos do Roblox Studio.

Não é possível criar uma instância desta classe com o construtor Instance.new.

A Roblox não replica este membro além do limite do seu servidor-cliente.

O código Lua não pode acessar este membro. Você pode ser capaz de alterar o valor dele na janela de propriedades do Roblox Studio.

Este membro está acessível a partir das tarefas de execução do OpenCloud Luau.

O comportamento de replicação do objeto depende do jogador que o possui.

Este membro é acessível somente através da barra de comandos e plugins. Tentar acessar este membro a partir de scripts causa um erro.

Este membro é somente leitura. Tentar escrever para este membro causa um erro.

Esta propriedade é somente leitura e é segura para ler em tópicos não sincronizados. Tentar escrever nela causa um erro.

Esta propriedade é somente leitura e é segura para ler em threads não sincronizadas. Tentar escrever nela causa um erro.

Este membro é acessível somente no CoreScripts.

Somente o Roblox CoreScripts pode acessar este membro e ele não é utilizável por jogadores.

Você pode ler e escrever para esta propriedade com segurança a partir de várias threads.

Esta classe é uma singleton de alto nível. Recupere uma instância desta classe com a função GetService.

Várias threads podem potencialmente escrever para esta propriedade, então não é seguro ler a partir de threads não sincronizadas.

Você pode ler e escrever para esta propriedade com segurança a partir de vários tópicos.

Esta função pausa a thread Lua que a chamou até que ela retorne um resultado. Isto não interrompe outros scripts.

SurfaceLight

Ver también

Amostras de código

Resumo

Propriedades

Métodos

Eventos

Propriedades

Angle

Face

Range

Métodos

Eventos