`Class.PhysicsService` contém principalmente métodos para trabalhar com **grupos de colisão** que definem se um conjunto de partes pode ou não colidir com partes em outros grupos de colisão. Você pode registrar um grupo de colisão através de `Class.PhysicsService:RegisterCollisionGroup()|RegisterCollisionGroup()` e atribuir partes a ele definindo a propriedade `Class.BasePart.CollisionGroup|CollisionGroup` dessas partes para o **nome** do grupo de colisão.

Criar, deletar e modificar relacionamentos de colisão entre grupos de colisão é limitado ao `Class.Script|Scripts` do lado do servidor.

Veja [Filtragem de Colisão](/workspace/collisions#collision-filtering) para detalhes de uso no Studio e dentro de scripts.

Retorna se a parte especificada está no grupo de colisão especificado.
Este método lançará um erro em tempo de execução nas seguintes circunstâncias:

- O grupo especificado não existe.
- A parte especificada não é uma `Class.BasePart`.

PhysicsService:CollisionGroupContainsPart

name

O nome do grupo de colisão a ser verificado.

part

O `BasePart` a ser verificado para a associação no grupo de colisão.

`true` se a parte pertence ao grupo de colisão especificado, `false`
caso contrário.

Retorna se a parte está no grupo de colisão.

Retorna se os dois grupos de colisão especificados irão colidir. Este método também retornará verdadeiro se algum dos grupos estiver não registrado, já que a máscara de colisão padrão colide com todos os grupos.

PhysicsService:CollisionGroupsAreCollidable

name1

name2

`true` se os dois grupos estão configurados para colidir, `false` caso contrário. Também
retorna `true` se algum dos grupos não estiver registrado.

Define o status de colisão entre dois grupos. Este método lançará um erro se algum dos grupos estiver não registrado, então é recomendado que você confirme o registro de cada grupo através de `Class.PhysicsService:IsCollisionGroupRegistered()` antes de fazer esta chamada.

PhysicsService:CollisionGroupSetCollidable

collidable

Se os dois grupos devem colidir entre si.

Define o status de colisão entre dois grupos.

Cria um novo grupo de colisão com o nome dado e retorna o ID do grupo criado.

PhysicsService:CreateCollisionGroup

O nome do novo grupo de colisão a ser criado.

O ID inteiro atribuído ao novo grupo de colisão criado.

Este método retorna o ID do grupo de colisão com o nome especificado. Ele lançará um erro se nenhum grupo com o nome dado existir.

PhysicsService:GetCollisionGroupId

O nome do grupo de colisão sendo recuperado.

O ID do grupo de colisão recuperado, ou `nil` se nenhum grupo desse tipo existir.

Retorna o ID do grupo de colisão com o nome especificado.

Retorna o nome do grupo de colisão com o ID correspondente, ou uma
string vazia se esse ID (`0`–`31`) não foi atribuído a um grupo. O
método lança um erro se o ID estiver fora do intervalo válido.

PhysicsService:GetCollisionGroupName

O ID inteiro do grupo de colisão a ser pesquisado.

O nome do grupo de colisão com o ID dado, ou uma string vazia
se o ID não foi atribuído a um grupo.

Retorna o nome do grupo com o ID correspondente.

Retorna uma tabela com informações sobre todos os grupos de colisão do local. Cada valor na tabela retornada é, ele mesmo, uma tabela contendo três membros:

<table>
  <thead>
    <tr>
      <th>Membro</th>
      <th>Tipo</th>
      <th>Descrição</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td>id</td>
      <td>integer</td>
      <td>O ID do grupo.</td>
    </tr>
    <tr>
      <td>mask</td>
      <td>integer</td>
      <td>A máscara do grupo de colisão; apenas para uso interno.</td>
    </tr>
    <tr>
      <td>name</td>
      <td>string</td>
      <td>O nome do grupo de colisão.</td>
    </tr>
  </tbody>
</table>

PhysicsService:GetCollisionGroups

Um array de tabelas, cada uma contendo os campos `name` (string), `id` (inteiro),
e `mask` (inteiro) para um grupo de colisão registrado.

Retorna uma tabela com informações sobre todos os grupos de colisão do local.

Retorna o número máximo de grupos de colisão que o motor suporta. Este valor atualmente é 32.

PhysicsService:GetMaxCollisionGroups

O número máximo de grupos de colisão suportados, atualmente 32.

Retorna o número máximo de grupos de colisão.

Retorna uma tabela com informações sobre todos os grupos de colisão do local. Cada valor na tabela retornada é, ele mesmo, uma tabela e contém dois membros:

<table>
  <thead>
    <tr>
      <th>Membro</th>
      <th>Tipo</th>
      <th>Descrição</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td>mask</td>
      <td>integer</td>
      <td>A máscara do grupo de colisão; apenas para uso interno.</td>
    </tr>
    <tr>
      <td>name</td>
      <td>string</td>
      <td>Nome do grupo de colisão.</td>
    </tr>
  </tbody>
</table>

PhysicsService:GetRegisteredCollisionGroups

Um array de tabelas, cada uma contendo os campos `name` (string) e `mask`
(inteiro) para um grupo de colisão registrado.

Verifica se um grupo de colisão está registrado. É recomendado que você chame este método antes de chamar métodos que lançam erros para grupos de colisão não registrados, como `Class.PhysicsService:CollisionGroupSetCollidable()`.

PhysicsService:IsCollisionGroupRegistered

`true` se um grupo de colisão com o nome dado está registrado, `false`
caso contrário.

Verifica se um grupo de colisão está registrado.

Este exemplo demonstra um uso básico de grupos de colisão. Ele atribui
**BallPart** a `"CollisionGroupBall"` e **DoorPart** a
`"CollisionGroupDoor"`, e então torna os dois grupos não colidíveis usando
`Class.PhysicsService:CollisionGroupSetCollidable()`.


Registra um novo grupo de colisão com o nome dado. O nome não pode ser `"Default"`.

Observe que este método tem uma leve sobrecarga de desempenho com base no número de `Class.BasePart|BaseParts` no workspace, então é recomendado que você registre todos os grupos de colisão no tempo de edição através do [editor](/workspace/collisions#collision-groups) do Studio e chame `Class.PhysicsService:UnregisterCollisionGroup()|UnregisterCollisionGroup()` e `Class.PhysicsService:RenameCollisionGroup()|RenameCollisionGroup()` o menos possível.

PhysicsService:RegisterCollisionGroup

O nome do grupo de colisão a ser registrado.

Registra um novo grupo de colisão com o nome dado.

Remove o grupo de colisão com o nome dado. Se um nome inválido for fornecido, este método não fará nada, embora se o nome reservado `"Default"` for fornecido, ele lançará um erro. Se houver partes no grupo de colisão quando ele for removido, essas partes ainda manterão o mesmo ID do grupo de colisão. O comportamento físico das partes em um grupo removido é indefinido, então é recomendado mover quaisquer partes em um grupo removido para outro grupo. Este método lançará um erro em tempo de execução nas seguintes circunstâncias:

- O nome `"Default"` é fornecido.
- O método é chamado a partir de um cliente.

PhysicsService:RemoveCollisionGroup

O nome do grupo de colisão a ser removido.

Remove o grupo de colisão com o nome dado.

Renomeia o grupo de colisão registrado especificado, mas **não** renomeia a propriedade `Class.BasePart.CollisionGroup|CollisionGroup` das partes que utilizam o grupo. O primeiro argumento deste método é o nome do grupo a ser renomeado, o segundo argumento é o novo nome para o grupo. Se o grupo especificado não existir, este método não fará nada. As convenções de nomenclatura para o novo nome seguem as mesmas regras como se o grupo estivesse sendo criado com `Class.PhysicsService:RegisterCollisionGroup()|RegisterCollisionGroup()`.

Este método lançará um erro em tempo de execução nas seguintes circunstâncias:

- Nome inválido ou vazio fornecido para algum dos argumentos.
- O método é chamado a partir de um cliente.

Observe que este método tem uma leve sobrecarga de desempenho com base no número de `Class.BasePart|BaseParts` no workspace, então é recomendado que você registre todos os grupos de colisão no tempo de edição através do [editor](/workspace/collisions#collision-groups) do Studio e os renomeie o menos possível.

PhysicsService:RenameCollisionGroup

from

O nome atual do grupo de colisão a ser renomeado.

Renomeia o grupo de colisão especificado.

Este método define o grupo de colisão da parte especificada para o grupo com o nome especificado. É equivalente a definir o `Class.BasePart.CollisionGroupId`, embora chamar este método seja a abordagem recomendada.

Este método lançará um erro em tempo de execução nas seguintes circunstâncias:

- O parâmetro parte não é uma instância de `Class.BasePart`.
- O grupo especificado não existe.

PhysicsService:SetPartCollisionGroup

O nome do grupo de colisão que está sendo configurado para a parte.

Remove o registro do grupo de colisão para o nome dado, com os seguintes comportamentos:

- Se um nome inválido for fornecido, o método não fará nada.
- Se o nome reservado `"Default"` for fornecido **ou** se o método for chamado a partir de um cliente, ele lançará um erro.
- Se houver partes no grupo de colisão quando ele for removido, essas partes ainda manterão o mesmo nome do grupo de colisão. O comportamento físico das partes em um grupo removido é indefinido, então é recomendado mover quaisquer partes em um grupo removido para outro grupo, como o grupo `"Default"`.

Observe que este método tem uma leve sobrecarga de desempenho com base no número de `Class.BasePart|BaseParts` no workspace, então é recomendado que você registre todos os grupos de colisão no tempo de edição através do [editor](/workspace/collisions#collision-groups) do Studio e chame este método o menos possível.

PhysicsService:UnregisterCollisionGroup

O nome do grupo de colisão a ser desregistrado.

Remove o registro do grupo de colisão para o nome dado.

PhysicsService

Serviço que fornece métodos para criar e gerenciar grupos de colisão,
que controlam se conjuntos de `Class.BasePart|BaseParts` colidem entre si.

`Instance` é a classe base para todas as classes na hierarquia de classes do Roblox
que podem fazer parte da árvore `Class.DataModel`.

Não é possível criar objetos `Instance` raiz diretamente, mas o construtor especial
`Datatype.Instance.new()` cria objetos via código, recebendo o
nome da classe como parâmetro e retornando o objeto criado.


Demonstra como detectar mudanças na ancestralidade de uma instância conectando-se ao
`Class.Instance.AncestryChanged` evento.

O Parent do ChangingPart é definido para valores diferentes ao longo do tempo. O pai da
peça é o ancestral da peça, então o evento `Class.Instance.AncestryChanged`
será acionado sempre que mudar.

Dispara quando esta instância é reparentada ou quando qualquer um de seus ancestrais é
reparentado.

Você pode usar este evento para rastrear a exclusão de uma instância no Studio,
such as exclusão manual no Explorer ou através de um plugin. Se você precisar
detectar quando uma instância é destruída usando `Class.Instance:Destroy()`,
use o evento `Class.Instance.Destroying` em vez disso.


Instance.AncestryChanged

child

A instância cuja propriedade `Class.Instance.Parent|Parent` mudou,
que pode ser esta instância ou um ancestral mais distante, **não**
necessariamente a instância à qual o manipulador está conectado.


parent

Dispara quando a propriedade `Class.Instance.Parent` deste objeto ou de um de
seus ancestrais é alterada.


Este evento dispara sempre que qualquer atributo é alterado na instância,
 incluindo quando um atributo é definido como `nil`. O nome do atributo alterado
 é passado para a função conectada.

Por exemplo, o seguinte trecho de código conecta a função `attributeChanged()`
para disparar sempre que um dos atributos da parte muda:

```lua
local Workspace = game:GetService("Workspace")

local part = Workspace.Part

local function attributeChanged(attributeName)
	print(attributeName, "mudou")
end

part.AttributeChanged:Connect(attributeChanged)
```
Veja também `Class.Instance:GetAttributeChangedSignal()` que retorna um
evento que dispara quando um atributo específico dado muda.


Instance.AttributeChanged

attribute

Dispara sempre que um atributo é alterado na `Class.Instance`.


Este trecho imprime os nomes dos objetos à medida que são adicionados ao Espaço de Trabalho:


Dispara após um objeto ser parentado a esta `Class.Instance`.

Note que, ao usar este método em um cliente para detectar objetos criados pelo
servidor, é necessário usar `Class.Instance:WaitForChild()` ao
indexar os descendentes desses objetos. Isso ocorre porque o objeto e seus
descendentes não são garantidos para replicar do servidor para o cliente
simultaneamente. Por exemplo:

```
local Workspace = game:GetService("Workspace")

Workspace.ChildAdded:Connect(function(child)
	-- Use WaitForChild() já que os descendentes podem não ter replicado ainda
	local head = child:WaitForChild("Head")
end)
```
Note que este evento opera apenas para filhos imediatos da
`Class.Instance`. Para um evento que captura todos os descendentes, use
`Class.Instance.DescendantAdded`.

Veja também `Class.Instance.ChildRemoved`.


Instance.ChildAdded

Dispara após um objeto ser parentado a esta `Class.Instance`.


Instance.childAdded

Este trecho imprime os nomes dos objetos à medida que são removidos do
Workspace:


Dispara após um filho ser removido desta `Class.Instance`.

Removido refere-se a quando o pai de um objeto é alterado de esta
`Class.Instance` para algo diferente desta `Class.Instance`. Note que este
evento também será disparado quando um filho for destruído (usando
`Class.Instance:Destroy()`) uma vez que a função de destruição define o pai de um objeto
como `nil`.

Este evento opera apenas para filhos imediatos da `Class.Instance`.
Para um evento que captura todos os descendentes, use
`Class.Instance.DescendantRemoving`.

Veja também `Class.Instance.ChildAdded`.


Instance.ChildRemoved

Dispara após um filho ser removido desta `Class.Instance`.


Este exemplo a seguir imprimirá o nome de qualquer objeto que for adicionado ao
Espaço de Trabalho:

Este evento dispara após um descendente ser adicionado à `Class.Instance`.

Como ele dispara para cada descendente, parentar um objeto à
`Class.Instance` disparará o evento para este objeto e todos os seus
descendentes individualmente.

Se você está apenas preocupado com os **filhos diretos** da
`Class.Instance`, use `Class.Instance.ChildAdded` em vez disso.

Veja também `Class.Instance.DescendantRemoving`.


Instance.DescendantAdded

descendant

Dispara após um descendente ser adicionado à `Class.Instance`.


O seguinte exemplo imprime o nome de qualquer descendente enquanto está sendo removido
do Workspace:

Este evento dispara **imediatamente antes** que o pai `Class.Instance`
mude de forma que uma instância **descendente** não será mais um
descendente. `Class.Instance:Destroy()|Destroy()` muda o `Class.Instance.Parent|Parent` de uma instância para `nil`, então chamar esse método em um
descendente do pai fará com que este evento dispare.

Como este evento dispara **antes** da remoção do descendente, o pai do
descendente não será alterado no momento em que este evento disparar. Se o
descendente também for um **filho direto** do pai, este evento disparará
antes de `Class.Instance.ChildRemoved`.

Se um descendente tiver filhos, este evento dispara com o descendente primeiro,
seguido por seus descendentes.

#### Aviso

Este evento dispara com o objeto descendente que está sendo removido.
Tentar definir o `Class.Instance.Parent|Parent` do descendente para
algo diferente falhará. Abaixo está um exemplo que demonstra isso:

```
local Workspace = game:GetService("Workspace")

Workspace.DescendantRemoving:Connect(function(descendant)
	-- Não manipule o pai do descendente nesta função!
	-- Este evento dispara PORQUE o pai foi manipulado, e a mudança ainda não aconteceu
	-- Portanto, é problemático mudar o pai assim:
	descendant.Parent = game
end)

local part = Instance.new("Part")
part.Parent = Workspace
part.Parent = nil
```
Veja também `Class.Instance.DescendantAdded|DescendantAdded`.


Instance.DescendantRemoving

O `Class.Instance` que está sendo removido.


Dispara imediatamente antes de um descendente da `Class.Instance` ser removido.


Este exemplo demonstra como, ao usar o comportamento de sinal Imediato, uma
Instância sendo destruída permanece no lugar até que a função conectada faça yield.

Este exemplo demonstra como, ao usar o comportamento de sinal Deferred, uma Instância
é destruída antes que o sinal seja acionado.

O `Class.Instance` nunca será deletado da memória enquanto uma função conectada
estiver ainda usando-o. No entanto, se a função suspender em algum ponto,
o `Class.Instance` e seus descendentes serão parentados a `nil`.

Se a propriedade `Class.Workspace.SignalBehavior` estiver definida como
`Enum.SignalBehavior.Immediate`, este evento dispara imediatamente antes do
`Class.Instance` ou um de seus ancestrais ser destruído com
`Class.Instance:Destroy()`.

Se a propriedade `Class.Workspace.SignalBehavior` estiver definida como
`Enum.SignalBehavior.Deferred`, este evento dispara no próximo ponto de retoma,
que será após o `Class.Instance` ou um de seus ancestrais ser destruído com
`Class.Instance:Destroy()`.

Com o comportamento `Enum.SignalBehavior.Deferred|Deferred`, conectar um script
ao seu próprio evento `Class.Instance.Destroying` é problemático, pois o script
será destruído antes que o callback possa ser chamado (o que significa que não
será executado).

Ao deletar um `Class.Instance` no Studio, como excluir manualmente
através do [Explorer](/studio/explorer) ou através de um plugin,
o `Class.Instance` não é destruído. Em vez disso, o pai é definido como `nil`
que você pode rastrear com `Class.Instance.AncestryChanged`.


Instance.Destroying

Dispara imediatamente antes (ou é adiado até depois) que a instância é
destruída via `Class.Instance:Destroy()`.


Demonstra `Class.Instance.StyledPropertiesChanged`.


Este evento dispara sempre que qualquer propriedade de estilo é alterada na instância,
 incluindo quando uma propriedade é definida como `nil`.


Instance.StyledPropertiesChanged

Dispara sempre que qualquer propriedade de estilo é alterada na instância, incluindo
quando uma propriedade é definida como `nil`.


Este método aplica uma tag à instância, sem efeito se a tag já estiver
aplicada. Adicionar uma tag com sucesso acionará um sinal criado por
`Class.CollectionService:GetInstanceAddedSignal()` com a tag dada.

#### Avisos

- As tags de uma instância que foram adicionadas do lado do cliente serão descartadas se o
  servidor adicionar ou remover uma tag nessa instância posteriormente, pois o servidor
  replica todas as tags juntas e sobrescreve as tags anteriores.

- Ao marcar uma instância, é comum que alguns recursos sejam usados para
dar funcionalidade à tag, por exemplo, conexões de eventos ou tabelas.
  Para evitar vazamentos de memória, é uma boa ideia limpar esses recursos
  (desconectar, definir como `nil`, etc.) quando não forem mais necessários para uma tag. Faça isso ao
  chamar `Class.Instance:RemoveTag()`, chamando
  `Class.Instance:Destroy()`, ou em uma função conectada a um sinal
  retornado por `Class.CollectionService:GetInstanceRemovedSignal()`.


Instance:AddTag

A função filhos retorna um array dos filhos do objeto.


Instance:children

Este método destrói todos os filhos e descendentes de uma instância.

```
local part = Instance.new("Part")

-- Adiciona algumas faíscas
for i = 1, 3 do
	local sparkles = Instance.new("Sparkles")
	sparkles.Parent = part

  local sc = Instance.new("Sparkles")
  sc.Parent = sparkles
end

print("Filhos:", #part:GetChildren())  --> Filhos: 3

part:ClearAllChildren()

print("Filhos:", #part:GetChildren())  --> Filhos: 0
```
Se você não deseja destruir **todos** os filhos e descendentes, use
`Class.Instance:GetChildren()` ou `Class.Instance:GetDescendants()` para
percorrer esses filhos/descendentes e selecionar o que destruir. Por
exemplo, o seguinte exemplo de código destruirá todos os
`Class.BasePart|BaseParts` descendentes de um `Class.Model`:

```
local Workspace = game:GetService("Workspace")

local model = Workspace:FindFirstChild("TestModel")

for _, descendant in model:GetDescendants() do
	if descendant:IsA("BasePart") then
		descendant:Destroy()
	end
end
```


Instance:ClearAllChildren

Este método destrói todos os filhos de uma instância.


Demonstra como clonar um modelo usando `Class.Instance:Clone()`.

`Clone()` cria uma cópia de uma instância e todos os seus descendentes,
ignorando todas as instâncias que não são
`Class.Instance.Archivable|Archivable`. A cópia da instância raiz é
retornada por este método e seu `Class.Instance.Parent|Parent` é definido como
`nil`. Note que se a própria instância tiver
`Class.Instance.Archivable|Archivable` definido como `false`, este método
retornará `nil`.

Se uma propriedade de referência, como `Class.ObjectValue.Value`, for definida em uma
instância clonada, o valor da propriedade da cópia depende do
valor do original:

- Se uma propriedade de referência se referir a uma instância que foi **também** clonada,
  a cópia se referirá à cópia.
- Se uma propriedade de referência se referir a uma instância que **não** foi clonada,
  o mesmo valor é mantido na cópia.


Instance:Clone

Uma cópia da instância, ou `nil` se a instância não for
`Class.Instance.Archivable|Archivable`.


Cria uma cópia de uma instância e todos os seus descendentes, ignorando instâncias
que não são `Class.Instance.Archivable|Archivable`.


Instance:clone

Demonstra a destruição de uma Parte usando a função `Class.Instance:Destroy()`.

Esta função é a maneira correta de descartar objetos que não são mais
necessários.

Define a propriedade `Class.Instance.Parent` como `nil`, bloqueia a
propriedade `Class.Instance.Parent`, desconecta todas as conexões e chama
`Destroy()` em todos os filhos. Este método é a maneira correta de descartar
objetos que não são mais necessários.

Descartar objetos desnecessários é importante, pois objetos e
conexões desnecessárias em um lugar consomem memória, o que pode levar a sérios problemas de desempenho ao longo do tempo.

Como uma boa prática, após chamar `Destroy()` em um objeto, defina quaisquer
variáveis que referenciam o objeto (ou seus descendentes) como `nil`. Isso
impede que seu código acesse qualquer coisa relacionada ao objeto.

```lua
local part = Instance.new("Part")
part.Name = "Olá, mundo"
part:Destroy()
-- Não faça isso:
print(part.Name)  --> "Olá, mundo"
-- Faça isso para evitar que a linha acima funcione:
part = nil
```
Uma vez que um `Class.Instance` foi destruído por este método, não pode ser
reutilizado porque a propriedade `Class.Instance.Parent` está bloqueada. Para
**remover temporariamente** um objeto em vez de destruí-lo, defina
`Class.Instance.Parent|Parent` como `nil`. Por exemplo:

```
local Workspace = game:GetService("Workspace")

object.Parent = nil
task.wait(2)
object.Parent = Workspace
```
Para destruir um objeto após um determinado período de tempo, use
`Class.Debris:AddItem()`.


Instance:Destroy

Define a propriedade `Class.Instance.Parent` como `nil`, bloqueia a
propriedade `Class.Instance.Parent`, desconecta todas as conexões e chama
`Destroy()` em todos os filhos.


Instance:destroy

Retorna o primeiro ancestral do `Class.Instance` cujo
`Class.Instance.Name` é igual ao nome dado.

Este método funciona para cima, ou seja, começa no `Class.Instance.Parent`
imediato da instância e trabalha em direção ao `Class.DataModel`. Se nenhum
ancestral correspondente for encontrado, retorna `nil`.

O seguinte trecho de código encontraria o primeiro ancestral do objeto
chamado `Car`.

```
local car = object:FindFirstAncestor("Car")
```
Para variantes deste método que encontram ancestrais de uma classe específica,
veja `Class.Instance:FindFirstAncestorOfClass()` e
`Class.Instance:FindFirstAncestorWhichIsA()`.


Instance:FindFirstAncestor

O `Class.Instance.Name` a ser procurado.


Retorna o primeiro ancestral do `Class.Instance` cujo
`Class.Instance.Name` é igual ao nome dado.


Retorna o primeiro ancestral do `Class.Instance` cujo
`Class.Object.ClassName` é igual ao className dado.

Este método funciona para cima, ou seja, começa no `Class.Instance.Parent`
imediato da instância e trabalha em direção ao `Class.DataModel`. Se nenhum
ancestral correspondente for encontrado, retorna `nil`.

Um uso comum deste método é encontrar o `Class.Model` ao qual um
`Class.BasePart` pertence. Por exemplo:

```
local model = part:FindFirstAncestorOfClass("Model")
```
Este método é uma variante de `Class.Instance:FindFirstAncestor()` que
verifica a propriedade `Class.Object.ClassName` em vez de
`Class.Instance.Name`. `Class.Instance:FindFirstAncestorWhichIsA()` também
existe, usando o método `Class.Object:IsA()` em vez disso para respeitar a
herança de classe.


Instance:FindFirstAncestorOfClass

className

O `Class.Object.ClassName` a ser procurado.


Retorna o primeiro ancestral do `Class.Instance` cujo
`Class.Object.ClassName` é igual ao className dado.


Retorna o primeiro ancestral do `Class.Instance` para o qual
`Class.Object:IsA()` retorna verdadeiro para o className dado.

Este método funciona para cima, ou seja, começa no `Class.Instance.Parent`
imediato da instância e trabalha em direção ao `Class.DataModel`. Se nenhum
ancestral correspondente for encontrado, retorna `nil`.

Diferente de `Class.Instance:FindFirstAncestorOfClass()`, este método usa
`Class.Object:IsA()` que respeita a herança de classe. Por exemplo:

```
print(part:IsA("Part"))  --> true
print(part:IsA("BasePart"))  --> true
print(part:IsA("Instance"))  --> true
```
Portanto, o seguinte exemplo de código retornará o primeiro
ancestral `Class.BasePart`, independentemente de ser um `Class.WedgePart`,
`Class.MeshPart` ou `Class.Part`.

```
local part = object:FindFirstAncestorWhichIsA("BasePart")
```
Veja também `Class.Instance:FindFirstAncestor()`.


Instance:FindFirstAncestorWhichIsA

Retorna o primeiro ancestral do `Class.Instance` para o qual
`Class.Object:IsA()` retorna verdadeiro para o className dado.


O abaixo procurará no Workspace por um objeto chamado "Brick". Se encontrado, ele
mudará o nome do objeto para "Foo".

Retorna o primeiro filho do `Class.Instance` com o nome dado, ou
`nil` se nenhum filho desse tipo existir. Se o argumento opcional `recursive` for
`true`, este método pesquisa todos os descendentes em vez de apenas os
filhos imediatos do `Class.Instance`.

#### Verificando a Existência de um Objeto

`FindFirstChild()` é necessário se você precisar verificar se um objeto existe
antes de continuar. Tentar indexar um filho pelo nome usando o operador de ponto
lança um erro se o filho não existir.

```lua
local Workspace = game:GetService("Workspace")

-- A linha a seguir gera um erro se a parte não existir no espaço de trabalho
Workspace.Part.Transparency = 0.5
```
Uma abordagem melhor é usar `FindFirstChild()` para primeiro verificar por `Part`,
então usar uma declaração `if` para executar o código que precisa dele.

```lua
local Workspace = game:GetService("Workspace")

local part = Workspace:FindFirstChild("Part")
if part then
	part.Transparency = 0.5
end
```

#### Encontrando um Filho cujo Nome Corresponde a uma Propriedade

Às vezes, o `Class.Instance.Name|Name` de um objeto é o mesmo que o
propriedade de seu `Class.Instance.Parent|Parent`. Ao usar o operador de ponto,
as propriedades têm precedência sobre os filhos se compartilharem um nome.

No exemplo a seguir, uma `Class.Folder` chamada `Color` é adicionada a um
`Class.Part`, que também possui a propriedade `Class.Part.Color`. Note que
`part.Color` se refere ao valor da propriedade `Datatype.Color3`, não à instância
filho `Class.Folder`. Um benefício de usar
`Class.Instance:FindFirstChild()|FindFirstChild()` é que a
introdução de novas propriedades não impõe um risco ao seu código.

```lua
local part = Instance.new("Part")
local folder = Instance.new("Folder")
folder.Name = "Color"
folder.Parent = part
local c1 = part.Color  -- A propriedade
local c2 = part:FindFirstChild("Color")  -- A pasta filho
```

#### Notas de Desempenho

`Class.Instance:FindFirstChild()|FindFirstChild()` leva cerca de 20% mais
tempo do que usar o operador de ponto e quase 8 vezes mais do que simplesmente armazenar
uma referência a um objeto. Portanto, você deve evitar chamá-lo em
código dependente de desempenho, como em loops apertados ou funções conectadas
a `Class.RunService.Heartbeat` e `Class.RunService.PreRender`. Em vez disso,
estou o resultado em uma variável, ou considere usar
`Class.Instance.ChildAdded|ChildAdded` ou
`Class.Instance:WaitForChild()|WaitForChild()` para detectar quando um filho de um
dado nome se torna disponível.


Instance:FindFirstChild

O `Class.Instance.Name` a ser pesquisado.


recursive

Se a pesquisa deve ser realizada recursivamente ou não.


Retorna o primeiro filho do `Class.Instance` encontrado com o nome dado.


Instance:findFirstChild

Retorna o primeiro filho do `Class.Instance` cujo
`Class.Object.ClassName|ClassName` é igual ao `className` dado.
Diferente de `Class.Instance:FindFirstChildWhichIsA()`, este método só retorna
objetos cuja classe corresponde a `className`, ignorando a herança de classe. Se nenhum
filho correspondente for encontrado, este método retorna `nil`.


Instance:FindFirstChildOfClass

Retorna o primeiro filho do `Class.Instance` cujo
`Class.Object.ClassName|ClassName` é igual ao nome da classe dada.


Retorna o primeiro filho do `Class.Instance` para o qual
`Class.Object:IsA()` retorna verdadeiro para o className dado.

Se nenhum filho correspondente for encontrado, este método retorna `nil`. Se o argumento
opcional recursivo for verdadeiro, este método pesquisa todos os descendentes em vez de apenas os filhos imediatos do `Class.Instance`.

Diferente de `Class.Instance:FindFirstChildOfClass()`, este método usa
`Class.Object:IsA()` que respeita a herança de classe. Por exemplo:

```lua
print(part:IsA("Part")) --> true
print(part:IsA("BasePart")) --> true
print(part:IsA("Instance")) --> true
```
Portanto, o seguinte exemplo de código retornará o primeiro
filho `Class.BasePart`, independentemente de ser um `Class.WedgePart`,
`Class.MeshPart` ou `Class.Part`.

```
local part = object:FindFirstChildWhichIsA("BasePart")
```
Desenvolvedores que procuram um filho pelo nome, devem usar
`Class.Instance:FindFirstChild()` em vez disso.


Instance:FindFirstChildWhichIsA

Retorna o primeiro filho do `Class.Instance` para o qual
`Class.Object:IsA()` retorna verdadeiro para o className dado.


Retorna o primeiro descendente encontrado com o dado `Class.Instance.Name`.

Este método está desativado e não pode ser usado. Para encontrar o primeiro descendente
 de uma instância, considere usar o parâmetro `recursive` em
`Class.Instance:FindFirstChild()` em vez disso.


Instance:FindFirstDescendant

Retorna o primeiro descendente encontrado com o dado `Class.Instance.Name`.


Se o `Class.Instance` for um `Class.Actor`, o próprio `Class.Actor` é
retornado. Caso contrário, seu ancestral mais próximo `Class.Actor` é retornado. Se nenhum
ancestral for um `Class.Actor`, o resultado é `nil`.


Instance:GetActor

Retorna o `Class.Actor` associado à Instância, se houver.


Este método retorna o valor que foi atribuído ao nome do
atributo dado. Se nenhum atributo foi atribuído, `nil` é retornado.

Por exemplo, o seguinte trecho de código define e depois obtém o valor do
atributo `InitialPosition` da instância:

```lua
local Workspace = game:GetService("Workspace")

local part = Workspace.Part
part:SetAttribute("InitialPosition", part.Position)

local initialPosition = instance:GetAttribute("InitialPosition")
print(initialPosition)
```

#### Veja Também

- `Class.Instance:SetAttribute()` que define o atributo com o nome dado
  para o valor dado.
- `Class.Instance:GetAttributes()` que retorna um dicionário de pares chave-valor
  para cada um dos atributos da instância.


Instance:GetAttribute

O valor que foi atribuído ao nome do atributo dado. Se nenhum
atributo foi atribuído, `nil` é retornado.


Retorna o valor que foi atribuído ao nome do atributo dado.


Este método retorna um evento que se comporta exatamente como o
evento `Class.Object.Changed|Changed`, exceto que ele só é acionado quando o
atributo específico muda; efetivamente é semelhante a
`Class.Object:GetPropertyChangedSignal()|GetPropertyChangedSignal()` mas
para atributos.

É geralmente uma boa ideia usar este método em vez de uma conexão para
`Class.Object.Changed|Changed` com uma função que verifica o nome do atributo. Chamadas subsequentes a este método no mesmo objeto com o mesmo
nome de atributo retornam o mesmo evento.

O seguinte exemplo de código retorna um sinal que aciona a função
`attributeChanged()` quando o atributo `InitialPosition` da parte muda:

```lua
local Workspace = game:GetService("Workspace")

local part = Workspace.Part
part:SetAttribute("InitialPosition", part.Position)

local function attributeChanged()
	print("Atributo mudado")
end

part:GetAttributeChangedSignal("InitialPosition"):Connect(attributeChanged)
```
Veja também `Class.Instance.AttributeChanged` que é acionado sempre que qualquer
atributo é mudado na instância.


Instance:GetAttributeChangedSignal

O nome do atributo especificado para o qual o sinal de mudança está
sendo retornado.


Um evento que é acionado quando o atributo dado muda.


Retorna um evento que é acionado quando o atributo dado muda.


Este método retorna um dicionário de pares chave-valor para cada atributo
onde a chave é o nome do atributo e o valor é um valor não-nulo.

Por exemplo, o seguinte trecho de código exibe os atributos e valores de uma instância:

```lua
local Workspace = game:GetService("Workspace")

local part = Workspace.Part
part:SetAttribute("InitialPosition", part.Position)
part:SetAttribute("CanUse", true)

for name, value in part:GetAttributes() do
	print(name .. " = " .. value)
end
```
Veja também `Class.Instance:GetAttribute()` que retorna o valor que foi
atribuído ao nome do atributo dado.


Instance:GetAttributes

Um dicionário de pares string → variante para cada atributo onde a
string é o nome do atributo e a variante é um valor não-nulo.


Retorna um dicionário dos atributos da instância.


O abaixo imprimiria o nome de todos os objetos atualmente no Workspace quando executado.

Retorna um array (uma tabela indexada numericamente) contendo todos os
filhos diretos da instância, ou cada `Class.Instance` cujo
`Class.Instance.Parent|Parent` é igual ao objeto. O array pode ser
iterado usando um loop numérico ou genérico:

```lua
local Workspace = game:GetService("Workspace")

-- Exemplo de loop numérico
local children = Workspace:GetChildren()
for i = 1, #children do
	local child = children[i]
	print(child.Name .. " é o filho número " .. i)
end
```

```lua
local Workspace = game:GetService("Workspace")

-- Exemplo de loop genérico
local children = Workspace:GetChildren()
for i, child in children do
	print(child.Name .. " é o filho número " .. i)
end
```
Note que o array retornado **não** é ordenado em nenhuma ordem particular, então
uma ordenação manual (por exemplo, usando `Library.table.sort()`) é aconselhada para
ordenar os filhos retornados por este método.

Veja também o método `Class.Instance:GetDescendants()|GetDescendants()`.


Instance:GetChildren

Um array contendo os filhos da instância.


Retorna um array contendo todos os filhos da instância.


Instance:getChildren

Retorna uma string codificada do ID de depuração usado internamente pelo Roblox. Note
que:

- Este item é protegido. Tentar usá-lo em um `Class.Script` ou
  `Class.LocalScript` causará um erro.
- Um ID de depuração é um ID usado em processos de depuração. Ele permite que um depurador
  leia cada instrução antes que um aplicativo a processe. Todos os objetos no
  Roblox agem como processos e cada execução de instruções (ou 'código') que pode
  ser depurado se necessário.
- Isso pode ser útil para plugins que precisam distinguir objetos semelhantes
  uns dos outros (como objetos que compartilham o mesmo nome).


Instance:GetDebugId

scopeLength

Retorna uma string codificada do ID de depuração usado internamente pelo Roblox.


GetDescendants é frequentemente usado para fazer algo com todos os descendentes que são de um
tipo específico de objeto. O código neste exemplo usa GetDescendants e
`Class.Instance:IsA()` para encontrar todas as partes no workspace e as torna
verdes.

Este método de objeto retorna um array que contém todos os descendentes
desse objeto. Diferente de `Class.Instance:GetChildren()`, que só retorna
os filhos imediatos de um objeto, este método encontra cada filho do
objeto, cada filho desses filhos, e assim por diante.

Note que o array retornado **não** é ordenado em nenhuma ordem particular, então
uma ordenação manual (por exemplo, usando `Library.table.sort()`) é aconselhada para
ordenar os descendentes retornados por este método. Também considere o
método `Class.Instance:QueryDescendants()|QueryDescendants()` para consultar
descendentes por uma combinação de seletores e combinadores.


Instance:GetDescendants

Um array contendo os descendentes da instância.


Retorna um array contendo todos os descendentes da instância.


Este exemplo de código demonstra o comportamento de `Class.Instance:GetFullName()`.
Ele mostra como a função se comporta ao ser chamada em um objeto que não está na
hierarquia `DataModel`, e também mostra como o valor de retorno não escapa
caracteres especiais.

Este exemplo de código reimplementa a função `Class.Instance:GetFullName()` em
Lua.


Retorna uma string descrevendo a ancestralidade da instância. A string é uma
concatenação do `Class.Instance.Name|Name` do objeto e seus
ancestrais, separados por pontos. O `Class.DataModel` (`game`) não é
considerado. Por exemplo, um `Class.Part` no `Class.Workspace` pode
retornar `Class.Workspace.Part`.

Quando chamado em um `Class.Instance` que não é um descendente do
`Class.DataModel`, este método considera todos os ancestrais até e incluindo
o mais alto que não tem um `Class.Instance.Parent|Parent`.

Este método é útil para registro e depuração. Você não deve tentar
analisar a string retornada para qualquer operação útil; este método não
escapa pontos (ou qualquer outro símbolo) nos nomes dos objetos. Em outras palavras,
embora sua saída frequentemente pareça ser um identificador Luau válido, não é
garantido.


Instance:GetFullName

Retorna uma string descrevendo a ancestralidade da instância.


Este método retorna o valor estilizado ou explicitamente modificado da
propriedade especificada, ou então o valor padrão da propriedade se não tiver sido
estilizado/modificado. Isso difere ligeiramente de acessar o valor da propriedade
diretamente, como `[GuiObject].Rotation`, que retorna o valor padrão ou
modificado da propriedade.


Instance:GetStyled

selector

Selecionador opcional para a pseudo instância que você está mirando na
instância.


O valor estilizado ou explicitamente modificado da propriedade especificada, ou
então o valor padrão da propriedade se não tiver sido estilizado/modificado.


Retorna o valor estilizado ou explicitamente modificado da propriedade especificada,
ou então o valor padrão da propriedade se não tiver sido estilizado/modificado.


Demonstra `Class.Instance:GetStyledPropertyChangedSignal()`.


Este método retorna um evento que se comporta exatamente como o
evento `Class.Instance.StyledPropertiesChanged|StyledPropertiesChanged`,
exceto que ele só é acionado quando a propriedade de estilo dada muda. É
geralmente uma boa ideia usar este método em vez de uma conexão para
`Class.Instance.StyledPropertiesChanged|StyledPropertiesChanged` com uma
função que verifica o nome da propriedade. Chamadas subsequentes a este método no
mesmo objeto com o mesmo nome de propriedade retornam o mesmo evento.

Note que este evento não passará nenhum argumento para uma função conectada,
portanto o valor da propriedade alterada deve ser lido diretamente dentro de um
script.


Instance:GetStyledPropertyChangedSignal

Retorna um evento que é acionado quando a propriedade de estilo dada muda na
instância.


Instance

`Instance` é a classe base para todas as classes na hierarquia de classes do Roblox
que podem fazer parte da árvore `Class.DataModel`.


/reference/engine/classes/PhysicsService.yaml