`Class.PhysicsService` głównie zawiera metody do pracy z **grupami kolizji**, które definiują, czy zestaw części może lub nie może kolidować z częściami w innych grupach kolizji. Możesz zarejestrować grupę kolizji za pomocą
`Class.PhysicsService:RegisterCollisionGroup()|RegisterCollisionGroup()` i przypisać do niej części, ustawiając właściwość `Class.BasePart.CollisionGroup|CollisionGroup` tych części na **nazwę** grupy kolizji.

Tworzenie, usuwanie i modyfikowanie relacji kolizji między grupami kolizji jest ograniczone do skryptów po stronie serwera `Class.Script|Scripts`.

Zobacz
[Filtracja kolizji](/workspace/collisions#collision-filtering)
aby uzyskać szczegóły dotyczące użycia w Studio i w skryptach.

Zwraca, czy określona część znajduje się w określonej grupie kolizji.
Ta metoda zwróci błąd w czasie działania w następujących okolicznościach:

- Określona grupa nie istnieje.
- Określona część nie jest `Class.BasePart`.

PhysicsService:CollisionGroupContainsPart

name

Nazwa grupy kolizji, którą należy sprawdzić.

part

Obiekt `BasePart`, którego przynależność do grupy kolizji należy sprawdzić.

`true`, jeśli część należy do określonej grupy kolizji, `false`
w przeciwnym razie.

Zwraca, czy część znajduje się w grupie kolizji.

Zwraca, czy dwie określone grupy kolizji będą kolidować. Ta metoda zwróci również true, jeśli którakolwiek z grup nie jest zarejestrowana, ponieważ domyślny mask kolizji koliduje ze wszystkimi grupami.

PhysicsService:CollisionGroupsAreCollidable

name1

name2

`true`, jeśli dwie grupy są ustawione na kolizję, `false` w przeciwnym razie. Również
zwraca `true`, jeśli którakolwiek z grup jest niezarejestrowana.

Zwraca, czy dwie grupy będą kolidować.

Ustawia status kolizji między dwiema grupami. Ta metoda zwróci błąd, jeśli którakolwiek z grup nie jest zarejestrowana, dlatego zaleca się, aby potwierdzić rejestrację każdej grupy przez `Class.PhysicsService:IsCollisionGroupRegistered()` przed dokonaniem tego wywołania.

PhysicsService:CollisionGroupSetCollidable

collidable

Czy dwie grupy powinny kolidować ze sobą.

Ustawia status kolizji między dwiema grupami.

Tworzy nową grupę kolizji o podanej nazwie i zwraca ID utworzonej grupy.

PhysicsService:CreateCollisionGroup

Całkowita liczba ID przypisana do nowo utworzonej grupy kolizji.

Ta metoda zwraca ID grupy kolizji o podanej nazwie.
Zwróci błąd, jeśli nie istnieje grupa o podanej nazwie.

PhysicsService:GetCollisionGroupId

Nazwa grupy kolizji, która jest pobierana.

ID pobranej grupy kolizji lub `nil`, jeśli taka grupa nie istnieje.

Zwraca ID grupy kolizji o podanej nazwie.

Zwraca nazwę grupy kolizji z odpowiadającym ID, lub pusty
ciąg, jeśli to ID (`0`–`31`) nie zostało przypisane do grupy. Metoda
zgłasza błąd, jeśli ID jest poza dozwolonym zakresem.

PhysicsService:GetCollisionGroupName

Całkowita liczba ID grupy kolizji do wyszukania.

Nazwa grupy kolizji z danym ID, lub pusty ciąg,
jeśli ID nie zostało przypisane do grupy.

Zwraca nazwę grupy o odpowiadającym ID.

Zwraca tabelę z informacjami o wszystkich grupach kolizji w miejscu. Każda wartość w zwróconej tabeli jest samą tabelą zawierającą trzy członki:

<table>
  <thead>
    <tr>
      <th>Członek</th>
      <th>Typ</th>
      <th>Opis</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td>id</td>
      <td>integer</td>
      <td>ID grupy.</td>
    </tr>
    <tr>
      <td>mask</td>
      <td>integer</td>
      <td>Maska grupy kolizji; tylko do użytku wewnętrznego.</td>
    </tr>
    <tr>
      <td>name</td>
      <td>string</td>
      <td>Nazwa grupy kolizji.</td>
    </tr>
  </tbody>
</table>

PhysicsService:GetCollisionGroups

Tablica tabel, z których każda zawiera pola `name` (ciąg), `id` (liczba całkowita),
i `mask` (liczba całkowita) dla zarejestrowanej grupy kolizji.

Zwraca tabelę z informacjami o wszystkich grupach kolizji w miejscu.

Zwraca maksymalną liczbę grup kolizji, które silnik obsługuje. Ta wartość wynosi obecnie 32.

PhysicsService:GetMaxCollisionGroups

Maksymalna liczba obsługiwanych grup kolizji, obecnie 32.

Zwraca tabelę z informacjami o wszystkich grupach kolizji w miejscu. Każda wartość w zwróconej tabeli jest sama tabelą i zawiera dwa członki:

<table>
  <thead>
    <tr>
      <th>Członek</th>
      <th>Typ</th>
      <th>Opis</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td>mask</td>
      <td>integer</td>
      <td>Maska grupy kolizji; tylko do użytku wewnętrznego.</td>
    </tr>
    <tr>
      <td>name</td>
      <td>string</td>
      <td>Nazwa grupy kolizji.</td>
    </tr>
  </tbody>
</table>

PhysicsService:GetRegisteredCollisionGroups

Tablica tabel, z których każda zawiera pola `name` (ciąg) i `mask`
(liczba całkowita) dla zarejestrowanej grupy kolizji.

Sprawdza, czy grupa kolizji jest zarejestrowana. Zaleca się, aby wywołać tę metodę przed wywołaniem metod, które zwracają błędy dla niezarejestrowanych grup kolizji, takich jak `Class.PhysicsService:CollisionGroupSetCollidable()`.

PhysicsService:IsCollisionGroupRegistered

`true`, jeśli grupa kolizji o podanej nazwie jest zarejestrowana, `false`
w przeciwnym razie.

Sprawdza, czy grupa kolizji jest zarejestrowana.

Ten przykład demonstruje jedno podstawowe użycie grup kolizji. Przypisuje
**BallPart** do `"CollisionGroupBall"` i **DoorPart** do
`"CollisionGroupDoor"`, a następnie sprawia, że obie grupy są niekolizyjne za pomocą
`Class.PhysicsService:CollisionGroupSetCollidable()`.


Rejestruje nową grupę kolizji o podanej nazwie. Nazwa nie może być `"Default"`.

Zauważ, że ta metoda ma niewielkie obciążenie wydajnościowe w zależności od liczby `Class.BasePart|BaseParts` w schowku, dlatego zaleca się, aby rejestrować wszystkie grupy kolizji podczas edytowania przez Studio
[edytor](/workspace/collisions#collision-groups) i wywoływać `Class.PhysicsService:UnregisterCollisionGroup()|UnregisterCollisionGroup()` oraz `Class.PhysicsService:RenameCollisionGroup()|RenameCollisionGroup()` tak rzadko, jak to możliwe.

PhysicsService:RegisterCollisionGroup

Rejestruje nową grupę kolizji o podanej nazwie.

Usuwa grupę kolizji o podanej nazwie. Jeśli podana jest nieprawidłowa nazwa, ta metoda nie zrobi nic, chociaż jeśli podana jest zastrzeżona nazwa `"Default"`, to zwróci błąd. Jeśli w grupie kolizji znajdują się jakiekolwiek części w momencie jej usunięcia, te części nadal będą miały to samo ID grupy kolizji. Fizyczne zachowanie części w usuniętej grupie jest nieokreślone, dlatego zaleca się przeniesienie wszelkich części w usuniętej grupie do innej grupy. Ta metoda zwróci błąd w czasie działania w następujących okolicznościach:

- Podana jest nazwa `"Default"`.
- Metoda jest wywoływana z klienta.

PhysicsService:RemoveCollisionGroup

Zmienia nazwę określonej zarejestrowanej grupy kolizji, ale **nie** zmienia nazwy właściwości `Class.BasePart.CollisionGroup|CollisionGroup` części, które korzystają z grupy. Pierwszym argumentem tej metody jest nazwa grupy do zmiany nazwy, a drugim argumentem jest nowa nazwa dla grupy. Jeśli określona grupa nie istnieje, ta metoda nie zrobi nic. Konwencje nazewnicze dla nowej nazwy są takie same, jak gdyby grupa była tworzona za pomocą `Class.PhysicsService:RegisterCollisionGroup()|RegisterCollisionGroup()`.

Ta metoda zwróci błąd w czasie działania w następujących okolicznościach:

- Podana jest nieprawidłowa lub pusta nazwa dla któregokolwiek argumentu.
- Metoda jest wywoływana z klienta.

Zauważ, że ta metoda ma niewielkie obciążenie wydajnościowe w zależności od liczby `Class.BasePart|BaseParts` w schowku, dlatego zaleca się, aby rejestrować wszystkie grupy kolizji podczas edytowania przez Studio
[edytor](/workspace/collisions#collision-groups) i zmieniać ich nazwy tak rzadko, jak to możliwe.

PhysicsService:RenameCollisionGroup

from

Obecna nazwa grupy kolizji do zmiany nazwy.

Zmienia nazwę określonej grupy kolizji.

Ta metoda ustawia grupę kolizji określonej części na grupę o podanej nazwie. Jest to równoważne ustawieniu `Class.BasePart.CollisionGroupId`, chociaż wywołanie tej metody jest polecanym podejściem.

Ta metoda zwróci błąd w czasie działania w następujących okolicznościach:

- Parametr część nie jest instancją `Class.BasePart`.
- Określona grupa nie istnieje.

PhysicsService:SetPartCollisionGroup

Nazwa grupy kolizji, którą ustawiana jest grupa kolizji części.

Wyrejestrowuje grupę kolizji o podanej nazwie, z następującymi zachowaniami:

- Jeśli podana jest nieprawidłowa nazwa, metoda nic nie zrobi.
- Jeśli zastrzeżona nazwa `"Default"` jest podana **lub** jeśli metoda jest wywoływana z klienta, zwróci błąd.
- Jeśli w grupie kolizji znajdują się jakiekolwiek części w momencie jej usunięcia, te części nadal będą miały tę samą nazwę grupy kolizji. Fizyczne zachowanie części w usuniętej grupie jest nieokreślone, dlatego zaleca się przeniesienie wszelkich części w usuniętej grupie do innej grupy, takiej jak grupa `"Default"`.

Zauważ, że ta metoda ma niewielkie obciążenie wydajnościowe w zależności od liczby `Class.BasePart|BaseParts` w schowku, dlatego zaleca się, aby rejestrować wszystkie grupy kolizji podczas edytowania przez Studio
[edytor](/workspace/collisions#collision-groups) i wywoływać tę metodę tak rzadko, jak to możliwe.

PhysicsService:UnregisterCollisionGroup

Wyrejestrowuje grupę kolizji o podanej nazwie.

PhysicsService

Usługa, która zapewnia metody do tworzenia i zarządzania grupami kolizji,
które kontrolują, czy zestawy `Class.BasePart|BaseParts` kolidują ze sobą.

`Instance` jest klasą bazową dla wszystkich klas w hierarchii klas Roblox
które mogą być częścią drzewa `Class.DataModel`.

Nie jest możliwe bezpośrednie tworzenie obiektów `Instance` jako korzeni, ale specjalny
konstruktor `Datatype.Instance.new()` tworzy obiekty za pomocą kodu, przyjmując
nazwę klasy jako parametr i zwracając utworzony obiekt.


Demonstruje wykrywanie zmian w przodkach instancji przez podłączenie do
`Class.Instance.AncestryChanged` event.

Rodzic ChangingPart jest ustawiany na różne wartości w czasie. Rodzicem
tej części jest przodek części, więc event `Class.Instance.AncestryChanged`
wyzwoli się za każdym razem, gdy się zmieni.

Wywołuje się, gdy ta instancja jest przenoszona lub gdy którykolwiek z jej przodków jest przenoszony.

Możesz użyć tego zdarzenia, aby śledzić usunięcie instancji w Studio, na przykład ręczne usunięcie w Eksploratorze lub za pomocą wtyczki. Jeśli musisz wykryć, kiedy instancja jest niszczona za pomocą `Class.Instance:Destroy()`, użyj zdarzenia `Class.Instance.Destroying` zamiast tego.


Instance.AncestryChanged

child

Instancja, której właściwość `Class.Instance.Parent|Parent` została zmieniona, która może być tą instancją lub bardziej odległym przodkiem, **nie**koniecznie instancją, do której podłączony jest handler.


parent

Wywołuje się, gdy właściwość `Class.Instance.Parent` tego obiektu lub jednego z jego przodków zostaje zmieniona.


To zdarzenie wywołuje się, gdy jakikolwiek atrybut na instancji zostaje zmieniony, w tym gdy atrybut jest ustawiany na `nil`. Nazwa zmienionego atrybutu jest przekazywana do podłączonej funkcji.

Na przykład, poniższy fragment kodu łączy funkcję `attributeChanged()` do wywołania, gdy zmienia się jeden z atrybutów części:

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

local part = Workspace.Part

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

part.AttributeChanged:Connect(attributeChanged)
```
Zobacz także `Class.Instance:GetAttributeChangedSignal()`, które zwraca zdarzenie, które wywołuje się, gdy zmienia się dany atrybut.


Instance.AttributeChanged

attribute

Nazwa atrybutu, który został zmieniony.


Wywołuje się, gdy atrybut na `Class.Instance` zostaje zmieniony.


Ten fragment kodu wypisuje nazwy obiektów, które są dodawane do Workspace:

Wywołuje się po dodaniu obiektu do tego `Class.Instance`.

Uwaga, podczas używania tej metody na kliencie do wykrywania obiektów tworzonych przez serwer, konieczne jest użycie `Class.Instance:WaitForChild()`, gdy indeksujesz potomków tych obiektów. Dzieje się tak, ponieważ obiekt i jego potomkowie nie są gwarantowani do replikacji z serwera do klienta jednocześnie. Na przykład:

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

Workspace.ChildAdded:Connect(function(child)
	-- Użyj WaitForChild(), ponieważ potomkowie mogą jeszcze nie zostać zreplikowani
	local head = child:WaitForChild("Head")
end)
```
Uwaga, to zdarzenie działa tylko dla bezpośrednich dzieci `Class.Instance`. Aby uzyskać zdarzenie, które uchwyci wszystkie potomków, użyj `Class.Instance.DescendantAdded`.

Zobacz także `Class.Instance.ChildRemoved`.


Instance.ChildAdded

Wywołuje się po dodaniu obiektu do tego `Class.Instance`.


Instance.childAdded

Ten fragment kodu drukuje nazwy obiektów, gdy są one usuwane z
Workspace:

Wywołuje się po usunięciu dziecka z tego `Class.Instance`.

Usunięcie odnosi się do sytuacji, gdy rodzic obiektu zmienia się z tego `Class.Instance` na coś innego niż ten `Class.Instance`. Uwaga, to zdarzenie również wywoła się, gdy dziecko zostanie zniszczone (używając `Class.Instance:Destroy()`), ponieważ funkcja zniszczenia ustawia rodzica obiektu na `nil`.

To zdarzenie działa tylko dla bezpośrednich dzieci `Class.Instance`. Aby uzyskać zdarzenie, które uchwyci wszystkich potomków, użyj `Class.Instance.DescendantRemoving`.

Zobacz także `Class.Instance.ChildAdded`.


Instance.ChildRemoved

Instancja `Class.Instance`, która została usunięta.


Wywołuje się po usunięciu dziecka z tego `Class.Instance`.


Ten przykład wydrukuje nazwę obiektu, który zostanie dodany do
Workspace:

To zdarzenie wywołuje się po dodaniu potomka do `Class.Instance`.

Ponieważ wywołuje się dla każdego potomka, przeniesienie obiektu do `Class.Instance` wywoła zdarzenie dla tego obiektu i wszystkich jego potomków indywidualnie.

Jeśli interesują cię tylko **bezpośrednie dzieci** `Class.Instance`, użyj `Class.Instance.ChildAdded` zamiast tego.

Zobacz także `Class.Instance.DescendantRemoving`.


Instance.DescendantAdded

descendant

Instancja `Class.Instance`, która została dodana.


Wywołuje się po dodaniu potomka do `Class.Instance`.


Poniższy przykład wypisuje nazwę każdego potomka w momencie, gdy jest usuwany
z Workspace:

To zdarzenie wywołuje się **natychmiast przed** zmianą rodzica `Class.Instance`, tak że instancja **potomka** nie będzie już potomkiem. `Class.Instance:Destroy()|Destroy()` zmienia `Class.Instance.Parent|Parent` instancji na `nil`, więc wywołanie tej metody na potomku rodzica spowoduje wywołanie tego zdarzenia.

Ponieważ to zdarzenie wywołuje się **przed** usunięciem potomka, rodzic potomka pozostanie niezmieniony w momencie wywołania tego zdarzenia. Jeśli potomek jest również **bezpośrednim dzieckiem** rodzica, to zdarzenie wywoła się przed `Class.Instance.ChildRemoved`.

Jeśli potomek ma dzieci, to zdarzenie wywoła się najpierw z potomkiem, a następnie z jego potomkami.

#### Ostrzeżenie

To zdarzenie wywołuje się z obiektem potomka, który jest usuwany. Próba ustawienia `Class.Instance.Parent|Parent` potomka na coś innego zakończy się niepowodzeniem. Poniżej znajduje się przykład, który to demonstruje:

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

Workspace.DescendantRemoving:Connect(function(descendant)
	-- Nie manipuluj rodzicem potomka w tej funkcji!
	-- To zdarzenie wywołuje się, ponieważ rodzic został zmieniony, a zmiana jeszcze się nie wydarzyła
	-- Dlatego problematyczne jest zmienianie rodzica w ten sposób:
	descendant.Parent = game
end)

local part = Instance.new("Part")
part.Parent = Workspace
part.Parent = nil
```
Zobacz także `Class.Instance.DescendantAdded|DescendantAdded`.


Instance.DescendantRemoving

Instancja `Class.Instance`, która jest usuwana.


Wywołuje się natychmiast przed usunięciem potomka `Class.Instance`.


Ten przykład pokazuje, jak w przypadku używania zachowania sygnału natychmiastowego, obiekt
instancji, który jest niszczony, pozostaje w miejscu, aż połączona funkcja zrealizuje.

Ten przykład demonstruje, jak podczas używania zachowania sygnału opóźnionego, instancja
zostaje zniszczona przed wywołaniem sygnału.

Instancja `Class.Instance` nigdy nie zostanie usunięta z pamięci, gdy podłączona funkcja nadal jej używa. Jednak jeśli funkcja wstrzyma się w dowolnym momencie, `Class.Instance` i jego potomkowie zostaną przeniesieni do `nil`.

Jeśli właściwość `Class.Workspace.SignalBehavior` jest ustawiona na `Enum.SignalBehavior.Immediate`, to zdarzenie wywołuje się natychmiast przed zniszczeniem `Class.Instance` lub jednego z jego przodków za pomocą `Class.Instance:Destroy()`.

Jeśli właściwość `Class.Workspace.SignalBehavior` jest ustawiona na `Enum.SignalBehavior.Deferred`, to zdarzenie wywołuje się w następnym punkcie wznowienia, co będzie po zniszczeniu `Class.Instance` lub jednego z jego przodków za pomocą `Class.Instance:Destroy()`.

Przy zachowaniu `Enum.SignalBehavior.Deferred|Deferred`, podłączenie skryptu do własnego zdarzenia `Class.Instance.Destroying` jest problematyczne, ponieważ skrypt zostanie zniszczony przed wywołaniem zwrotnego (co oznacza, że nie zostanie wykonane).

Podczas usuwania `Class.Instance` w Studio, na przykład ręcznie usuwając przez [Eksplorator](/studio/explorer) lub przez wtyczkę, `Class.Instance` nie jest niszczone. Zamiast tego rodzic jest ustawiany na `nil`, co możesz śledzić za pomocą `Class.Instance.AncestryChanged`.


Instance.Destroying

Wywołuje się natychmiast przed (lub jest opóźnione do po) zniszczenia instancji za pomocą `Class.Instance:Destroy()`.


Demonstruje `Class.Instance.StyledPropertiesChanged`.


To zdarzenie wywołuje się, gdy jakakolwiek właściwość stylu jest zmieniana na instancji, w tym gdy właściwość jest ustawiana na `nil`.


Instance.StyledPropertiesChanged

Wywołuje się, gdy jakakolwiek właściwość stylu jest zmieniana na instancji, w tym gdy właściwość jest ustawiana na `nil`.


Ta metoda stosuje tag do instancji, nie mając efektu, jeśli tag jest
już zastosowany. Pomyślne dodanie tagu wywoła sygnał utworzony przez
`Class.CollectionService:GetInstanceAddedSignal()` z danym tagiem.

#### Ostrzeżenia

- Tag instancji, który został dodany po stronie klienta, zostanie usunięty, jeśli
  serwer później doda lub usunie tag na tej instancji, ponieważ serwer
  replikuje wszystkie tagi razem i nadpisuje poprzednie tagi.

- Podczas tagowania instancji, powszechnie używane są pewne zasoby do
  nadania tagowi jego funkcjonalności, na przykład połączenia zdarzeń lub tabele.
  Aby zapobiec wyciekom pamięci, dobrze jest je oczyścić (rozłączyć,
  ustawić na `nil`, itp.) gdy nie są już potrzebne dla tagu. Zrób to podczas
  wywoływania `Class.Instance:RemoveTag()`, wywołując
  `Class.Instance:Destroy()`, lub w funkcji połączonej z sygnałem
  zwróconym przez `Class.CollectionService:GetInstanceRemovedSignal()`.


Instance:AddTag

Funkcja dzieci zwraca tablicę dzieci obiektu.


Instance:children

Ta metoda niszczy wszystkie dzieci i potomków instancji.

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

-- Dodaj trochę iskier
for i = 1, 3 do
	local sparkles = Instance.new("Sparkles")
	sparkles.Parent = part

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

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

part:ClearAllChildren()

print("Dzieci:", #part:GetChildren())  --> Dzieci: 0
```
Jeśli nie chcesz zniszczyć **wszystkich** dzieci i potomków, użyj albo
`Class.Instance:GetChildren()` albo `Class.Instance:GetDescendants()`, aby
przejść przez te dzieci/potomków i wybrać, co zniszczyć. Na przykład,
poniższy fragment kodu zniszczy wszystkie
`Class.BasePart|BaseParts` pochodzące z `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

Ta metoda niszczy wszystkie dzieci instancji.


Demonstracja klonowania modelu za pomocą `Class.Instance:Clone()`.

`Clone()` tworzy kopię instancji i wszystkich jej potomków,
ignorując wszystkie instancje, które nie są
`Class.Instance.Archivable|Archivable`. Kopia instancji korzenia jest
zwracana przez tę metodę, a jej `Class.Instance.Parent|Parent` jest ustawiane na
`nil`. Zauważ, że jeśli sama instancja ma
`Class.Instance.Archivable|Archivable` ustawione na `false`, ta metoda
zwróci `nil`.

Jeśli właściwość referencyjna, taka jak `Class.ObjectValue.Value`, jest ustawiona w
sklonowanej instancji, wartość właściwości kopii zależy od wartości
oryginału:

- Jeśli właściwość referencyjna odnosi się do instancji, która została **również** sklonowana,
  kopia będzie odnosić się do kopii.
- Jeśli właściwość referencyjna odnosi się do instancji, która **nie** została sklonowana,
  ta sama wartość jest utrzymywana w kopii.


Instance:Clone

Kopia instancji, lub `nil`, jeśli instancja nie jest
`Class.Instance.Archivable|Archivable`.


Tworzy kopię instancji i wszystkich jej potomków, ignorując instancje,
które nie są `Class.Instance.Archivable|Archivable`.


Instance:clone

Demonstruje niszczenie elementu za pomocą funkcji `Class.Instance:Destroy()`.

Ta funkcja jest prawidłowym sposobem na pozbycie się obiektów, które nie są już
potrzebne.

Ustawia właściwość `Class.Instance.Parent` na `nil`, blokuje
właściwość `Class.Instance.Parent`, rozłącza wszystkie połączenia i wywołuje
`Destroy()` na wszystkich dzieciach. Ta metoda jest poprawnym sposobem na pozbycie się
obiektów, które nie są już potrzebne.

Pozbycie się niepotrzebnych obiektów jest ważne, ponieważ niepotrzebne obiekty i
połączenia w miejscu zużywają pamięć, co może prowadzić do poważnych problemów z wydajnością
w dłuższym czasie.

Jako najlepsza praktyka po wywołaniu `Destroy()` na obiekcie, ustaw wszelkie
zmienne odnoszące się do obiektu (lub jego potomków) na `nil`. Zapobiega to
uzyskiwaniu dostępu do czegokolwiek związanego z obiektem.

```lua
local part = Instance.new("Part")
part.Name = "Hello, world"
part:Destroy()
-- Nie rób tego:
print(part.Name)  --> "Hello, world"
-- Zrób to, aby zapobiec działaniu powyższej linii:
part = nil
```
Gdy `Class.Instance` zostanie zniszczona przez tę metodę, nie może być
ponownie użyta, ponieważ właściwość `Class.Instance.Parent` jest zablokowana. Aby
**tymczasowo** usunąć obiekt zamiast go zniszczyć, ustaw
`Class.Instance.Parent|Parent` na `nil`. Na przykład:

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

object.Parent = nil
task.wait(2)
object.Parent = Workspace
```
Aby zniszczyć obiekt po określonym czasie, użyj
`Class.Debris:AddItem()`.


Instance:Destroy

Ustawia właściwość `Class.Instance.Parent` na `nil`, blokuje
właściwość `Class.Instance.Parent`, rozłącza wszystkie połączenia i wywołuje
`Destroy()` na wszystkich dzieciach.


Instance:destroy

Zwraca pierwszego przodka `Class.Instance`, którego
`Class.Instance.Name` jest równy danej nazwie.

Ta metoda działa w górę, co oznacza, że zaczyna od bezpośredniego
`Class.Instance.Parent` instancji i działa w kierunku `Class.DataModel`. Jeśli nie
zostanie znaleziony pasujący przodek, zwraca `nil`.

Poniższy fragment kodu znajdzie pierwszego przodka obiektu
nazywanego `Car`.

```
local car = object:FindFirstAncestor("Car")
```
Dla wariantów tej metody, które znajdują przodków konkretnej klasy,
proszę zobaczyć `Class.Instance:FindFirstAncestorOfClass()` i
`Class.Instance:FindFirstAncestorWhichIsA()`.


Instance:FindFirstAncestor

Nazwa `Class.Instance.Name`, której należy szukać.


Zwraca pierwszego przodka `Class.Instance`, którego
`Class.Instance.Name` jest równy danej nazwie.


Zwraca pierwszego przodka `Class.Instance`, którego
`Class.Object.ClassName` jest równy danej className.

Ta metoda działa w górę, co oznacza, że zaczyna od bezpośredniego
`Class.Instance.Parent` instancji i działa w kierunku `Class.DataModel`. Jeśli nie
zostanie znaleziony pasujący przodek, zwraca `nil`.

Powszechnym użyciem tej metody jest znalezienie `Class.Model`, do którego
należy `Class.BasePart`. Na przykład:

```
local model = part:FindFirstAncestorOfClass("Model")
```
Ta metoda jest wariantem `Class.Instance:FindFirstAncestor()`, która
sprawdza właściwość `Class.Object.ClassName` zamiast
`Class.Instance.Name`. `Class.Instance:FindFirstAncestorWhichIsA()` również
istnieje, używając metody `Class.Object:IsA()` zamiast tego, aby respektować dziedziczenie klas.


Instance:FindFirstAncestorOfClass

className

Nazwa `Class.Object.ClassName`, której należy szukać.


Zwraca pierwszego przodka `Class.Instance`, którego
`Class.Object.ClassName` jest równy danej className.


Zwraca pierwszego przodka `Class.Instance`, dla którego
`Class.Object:IsA()` zwraca prawdę dla danej className.

Ta metoda działa w górę, co oznacza, że zaczyna od bezpośredniego
`Class.Instance.Parent` instancji i działa w kierunku `Class.DataModel`. Jeśli nie
zostanie znaleziony pasujący przodek, zwraca `nil`.

W przeciwieństwie do `Class.Instance:FindFirstAncestorOfClass()`, ta metoda używa
`Class.Object:IsA()`, co respektuje dziedziczenie klas. Na przykład:

```
print(part:IsA("Part"))  --> true
print(part:IsA("BasePart"))  --> true
print(part:IsA("Instance"))  --> true
```
Dlatego poniższy fragment kodu zwróci pierwszego
przodka `Class.BasePart`, niezależnie od tego, czy jest to `Class.WedgePart`,
`Class.MeshPart` czy `Class.Part`.

```
local part = object:FindFirstAncestorWhichIsA("BasePart")
```
Zobacz także `Class.Instance:FindFirstAncestor()`.


Instance:FindFirstAncestorWhichIsA

Zwraca pierwszego przodka `Class.Instance`, dla którego
`Class.Object:IsA()` zwraca prawdę dla danej className.


Poniższy kod będzie szukał obiektu o nazwie "Brick" w Workspace. Jeśli go znajdzie,
zamieni nazwę obiektu na "Foo".

Zwraca pierwsze dziecko `Class.Instance` z daną nazwą, lub
`nil`, jeśli takie dziecko nie istnieje. Jeśli opcjonalny argument `recursive` jest
`true`, ta metoda przeszukuje wszystkie potomki, a nie tylko bezpośrednie dzieci
`Class.Instance`.

#### Sprawdzanie istnienia obiektu

`FindFirstChild()` jest konieczne, jeśli musisz zweryfikować, że obiekt istnieje
przed kontynuowaniem. Próba indeksowania dziecka według nazwy za pomocą operatora kropki
wyrzuca błąd, jeśli dziecko nie istnieje.

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

-- Poniższa linia wywołuje błąd, jeśli część nie istnieje w workspace
Workspace.Part.Transparency = 0.5
```
Lepszym podejściem jest użycie `FindFirstChild()`, aby najpierw sprawdzić `Part`,
a następnie użyć instrukcji `if`, aby uruchomić kod, który go potrzebuje.

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

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

#### Znajdowanie dziecka, którego nazwa pasuje do właściwości

Czasami `Class.Instance.Name|Name` obiektu jest taki sam jak
właściwość jego `Class.Instance.Parent|Parent`. Podczas używania operatora kropki,
właściwości mają pierwszeństwo przed dziećmi, jeśli mają tę samą nazwę.

W poniższym przykładzie, `Class.Folder` o nazwie `Color` jest dodawany do
`Class.Part`, który również ma właściwość `Class.Part.Color`. Zauważ, że
`part.Color` odnosi się do wartości właściwości `Datatype.Color3`, a nie do instancji
dzieci `Class.Folder`. Korzyścią z używania
`Class.Instance:FindFirstChild()|FindFirstChild()` jest to, że wprowadzenie nowych
właściwości nie stwarza ryzyka dla twojego kodu.

```lua
local part = Instance.new("Part")
local folder = Instance.new("Folder")
folder.Name = "Color"
folder.Parent = part
local c1 = part.Color  -- Właściwość
local c2 = part:FindFirstChild("Color")  -- Dziecko folderu
```

#### Uwagi dotyczące wydajności

`Class.Instance:FindFirstChild()|FindFirstChild()` zajmuje około 20% dłużej
niż użycie operatora kropki i prawie 8 razy dłużej niż po prostu przechowywanie
odniesienia do obiektu. Dlatego powinieneś unikać wywoływania go w
kodzie zależnym od wydajności, takim jak w ciasnych pętlach lub funkcjach połączonych
z `Class.RunService.Heartbeat` i `Class.RunService.PreRender`. Zamiast tego,
przechowuj wynik w zmiennej lub rozważ użycie
`Class.Instance.ChildAdded|ChildAdded` lub
`Class.Instance:WaitForChild()|WaitForChild()`, aby wykryć, kiedy dziecko o danej nazwie staje się dostępne.


Instance:FindFirstChild

recursive

Czy wyszukiwanie powinno być przeprowadzone rekurencyjnie.


Zwraca pierwsze dziecko `Class.Instance` znalezione z daną nazwą.


Instance:findFirstChild

Zwraca pierwsze dziecko `Class.Instance`, którego
`Class.Object.ClassName|ClassName` jest równy danej `className`.
W przeciwieństwie do `Class.Instance:FindFirstChildWhichIsA()`, ta metoda zwraca
tylko obiekty, których klasa pasuje do `className`, ignorując dziedziczenie klas. Jeśli nie
zostanie znalezione pasujące dziecko, ta metoda zwraca `nil`.


Instance:FindFirstChildOfClass

Zwraca pierwsze dziecko `Class.Instance`, którego
`Class.Object.ClassName|ClassName` jest równy danej nazwie klasy.


Zwraca pierwsze dziecko `Class.Instance`, dla którego
`Class.Object:IsA()` zwraca prawdę dla danej className.

Jeśli nie zostanie znalezione pasujące dziecko, ta metoda zwraca `nil`. Jeśli opcjonalny
argument rekurencyjny jest prawdziwy, ta metoda przeszukuje wszystkie potomków,
a nie tylko bezpośrednie dzieci `Class.Instance`.

W przeciwieństwie do `Class.Instance:FindFirstChildOfClass()`, ta metoda używa
`Class.Object:IsA()`, co respektuje dziedziczenie klas. Na przykład:

```lua
print(part:IsA("Part")) --> true
print(part:IsA("BasePart")) --> true
print(part:IsA("Instance")) --> true
```
Dlatego poniższy fragment kodu zwróci pierwsze
dziecko `Class.BasePart`, niezależnie od tego, czy jest to `Class.WedgePart`,
`Class.MeshPart` czy `Class.Part`.

```
local part = object:FindFirstChildWhichIsA("BasePart")
```
Deweloperzy szukający dziecka według nazwy powinni używać
`Class.Instance:FindFirstChild()` zamiast tego.


Instance:FindFirstChildWhichIsA

Zwraca pierwsze dziecko `Class.Instance`, dla którego
`Class.Object:IsA()` zwraca prawdę dla danej className.


Zwraca pierwszego potomka znalezionego z daną `Class.Instance.Name`.

Ta metoda jest wyłączona i nie może być używana. Aby znaleźć pierwszego potomka
instancji, rozważ użycie parametru `recursive` w
`Class.Instance:FindFirstChild()` zamiast tego.


Instance:FindFirstDescendant

Zwraca pierwszego potomka znalezionego z daną `Class.Instance.Name`.


Jeśli `Class.Instance` jest `Class.Actor`, zwracany jest sam `Class.Actor`. W przeciwnym razie zwracany jest jego najbliższy przodek `Class.Actor`. Jeśli żaden
przodek nie jest `Class.Actor`, wynik to `nil`.


Instance:GetActor

Zwraca `Class.Actor` powiązany z instancją, jeśli taki istnieje.


Ta metoda zwraca wartość, która została przypisana do danej
nazwy atrybutu. Jeśli żaden atrybut nie został przypisany, zwracane jest `nil`.

Na przykład, poniższy fragment kodu ustawia, a następnie uzyskuje wartość
atrybutu `InitialPosition` instancji:

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

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

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

#### Zobacz także

- `Class.Instance:SetAttribute()`, która ustawia atrybut o danej
  nazwie na daną wartość.
- `Class.Instance:GetAttributes()`, która zwraca słownik par klucz-wartość
  dla każdego z atrybutów instancji.


Instance:GetAttribute

Wartość, która została przypisana do danej nazwy atrybutu. Jeśli żaden
atrybut nie został przypisany, zwracane jest `nil`.


Zwraca wartość, która została przypisana do danej nazwy atrybutu.


Ta metoda zwraca zdarzenie, które działa dokładnie jak
zdarzenie `Class.Object.Changed|Changed`, z tą różnicą, że wywołuje się tylko,
gdy dany atrybut się zmienia; w efekcie jest podobne do
`Class.Object:GetPropertyChangedSignal()|GetPropertyChangedSignal()`, ale
dla atrybutów.

Zazwyczaj dobrze jest używać tej metody zamiast połączenia z
`Class.Object.Changed|Changed` z funkcją, która sprawdza nazwę atrybutu. Kolejne wywołania tej metody na tym samym obiekcie z tą samą
nazwą atrybutu zwracają to samo zdarzenie.

Poniższy przykład kodu zwraca sygnał, który wywołuje funkcję
`attributeChanged()`, gdy atrybut `InitialPosition` części się zmienia:

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

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

local function attributeChanged()
	print("Atrybut zmieniony")
end

part:GetAttributeChangedSignal("InitialPosition"):Connect(attributeChanged)
```
Zobacz także `Class.Instance.AttributeChanged`, które wywołuje się, gdy jakikolwiek
atrybut jest zmieniany na instancji.


Instance:GetAttributeChangedSignal

Nazwa określonego atrybutu, dla którego zwracany jest sygnał zmiany.


Zdarzenie, które wywołuje się, gdy dany atrybut się zmienia.


Zwraca zdarzenie, które wywołuje się, gdy dany atrybut się zmienia.


Ta metoda zwraca słownik par klucz-wartość dla każdego atrybutu,
gdzie klucz to nazwa atrybutu, a wartość to wartość różna od `nil`.

Na przykład, poniższy fragment kodu wyświetla atrybuty instancji
i ich wartości:

```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
```
Zobacz także `Class.Instance:GetAttribute()`, która zwraca wartość, która została
przypisana do danej nazwy atrybutu.


Instance:GetAttributes

Słownik par string → wariant dla każdego atrybutu, gdzie
string to nazwa atrybutu, a wariant to wartość różna od nil.


Poniżej znajduje się kod, który wydrukuje nazwę wszystkich obiektów znajdujących się obecnie w Workspace, gdy zostanie wykonany.

Zwraca tablicę (numerowo indeksowaną tabelę) zawierającą wszystkie
bezpośrednie dzieci instancji, lub każdą `Class.Instance`, której
`Class.Instance.Parent|Parent` jest równy obiektowi. Tablica może być
iterowana za pomocą pętli numerycznej lub ogólnej:

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

-- Przykład pętli numerycznej
local children = Workspace:GetChildren()
for i = 1, #children do
	local child = children[i]
	print(child.Name .. " jest dzieckiem numer " .. i)
end
```

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

-- Przykład pętli ogólnej
local children = Workspace:GetChildren()
for i, child in children do
	print(child.Name .. " jest dzieckiem numer " .. i)
end
```
Zauważ, że zwrócona tablica **nie** jest posortowana w żadnym szczególnym porządku, więc
ręczne sortowanie (na przykład za pomocą `Library.table.sort()`) jest zalecane do
sortowania dzieci zwróconych przez tę metodę.

Zobacz także metodę `Class.Instance:GetDescendants()|GetDescendants()`.


Instance:GetChildren

Zwraca tablicę zawierającą wszystkie dzieci instancji.


Instance:getChildren

Zwraca zakodowany ciąg identyfikatora debugowania używanego wewnętrznie przez Roblox. Zauważ,
że:

- Ten element jest chroniony. Próba użycia go w `Class.Script` lub
  `Class.LocalScript` spowoduje błąd.
- Identyfikator debugowania to identyfikator używany w procesach debugowania. Pozwala
  debuggerowi odczytać każdą instrukcję przed przetworzeniem jej przez aplikację. Wszystkie obiekty w
  Roblox działają jak procesy i każda uruchamia instrukcje (lub 'kod'), które mogą
  być debugowane w razie potrzeby.
- Może to być pomocne dla wtyczek, które muszą odróżnić podobne
  obiekty od siebie (na przykład obiekty, które mają tę samą nazwę).


Instance:GetDebugId

scopeLength

Zwraca zakodowany ciąg identyfikatora debugowania używanego wewnętrznie przez Roblox.


GetDescendants jest często używane, aby zrobić coś ze wszystkimi potomkami, które są
określonym rodzajem obiektu. Kod w tym przykładzie używa GetDescendants oraz
`Class.Instance:IsA()`, aby znaleźć wszystkie części w workspace i zmienia je
na zielone.

Ta metoda obiektu zwraca tablicę, która zawiera wszystkich potomków
tego obiektu. W przeciwieństwie do `Class.Instance:GetChildren()`, która zwraca tylko
bezpośrednie dzieci obiektu, ta metoda znajduje każde dziecko obiektu, każde dziecko tych dzieci,
i tak dalej.

Zauważ, że zwrócona tablica **nie** jest posortowana w żadnym szczególnym porządku, więc
ręczne sortowanie (na przykład za pomocą `Library.table.sort()`) jest zalecane do
sortowania potomków zwróconych przez tę metodę. Rozważ także metodę
`Class.Instance:QueryDescendants()|QueryDescendants()`, aby zapytać o potomków za pomocą
kombinacji selektorów i kombinatorów.


Instance:GetDescendants

Tablica zawierająca potomków instancji.


Zwraca tablicę zawierającą wszystkie potomki instancji.


Ten przykład kodu demonstruje działanie `Class.Instance:GetFullName()`.
Pokazuje, jak funkcja zachowuje się, gdy jest wywoływana na obiekcie, który nie znajduje się w
hierarchii `DataModel`, a także pokazuje, że wartość zwracana nie ucieka
znakom specjalnym.

Ten przykład kodu ponownie implementuje funkcję `Class.Instance:GetFullName()` w
Lua.


Zwraca ciąg opisujący rodowód instancji. Ciąg jest konkatenacją
`Class.Instance.Name|Name` obiektu i jego przodków, oddzielonych kropkami. `Class.DataModel`
(`game`) nie jest brane pod uwagę. Na przykład, `Class.Part` w `Class.Workspace` może
zwrócić `Class.Workspace.Part`.

Gdy jest wywoływana na `Class.Instance`, która nie jest potomkiem
`Class.DataModel`, ta metoda bierze pod uwagę wszystkich przodków aż do
najwyższego, który nie ma `Class.Instance.Parent|Parent`.

Ta metoda jest przydatna do logowania i debugowania. Nie powinieneś próbować
analizować zwróconego ciągu w celu wykonania jakiejkolwiek użytecznej operacji; ta metoda nie
ucieka kropek (ani żadnych innych symboli) w nazwach obiektów. Innymi słowy,
chociaż jej wynik często wydaje się być ważnym identyfikatorem Luau, nie jest to
gwarantowane.


Instance:GetFullName

Zwraca ciąg opisujący rodowód instancji.


Demonstruje `Class.Instance:GetStyled()`.


Ta metoda zwraca stylizowaną lub jawnie zmodyfikowaną wartość
określonej właściwości, lub domyślną wartość właściwości, jeśli nie została
stylizowana/zmodyfikowana. Różni się to nieco od bezpośredniego dostępu do wartości
właściwości, takiej jak `[GuiObject].Rotation`, która zwraca domyślną lub
zmodyfikowaną wartość właściwości.


Instance:GetStyled

selector

Opcjonalny selektor dla pseudo instancji, na którą celujesz w
instancji.


Stylizowana lub jawnie zmodyfikowana wartość określonej właściwości, lub
domyślna wartość właściwości, jeśli nie została stylizowana/zmodyfikowana.


Zwraca stylizowaną lub jawnie zmodyfikowaną wartość określonej właściwości,
lub domyślną wartość właściwości, jeśli nie została stylizowana/zmodyfikowana.


Demonstruje `Class.Instance:GetStyledPropertyChangedSignal()`.


Ta metoda zwraca zdarzenie, które działa dokładnie jak
zdarzenie `Class.Instance.StyledPropertiesChanged|StyledPropertiesChanged`,
z tą różnicą, że wywołuje się tylko, gdy dany styl właściwości się zmienia. Zazwyczaj
jest to dobry pomysł, aby używać tej metody zamiast połączenia z
`Class.Instance.StyledPropertiesChanged|StyledPropertiesChanged` z funkcją, która sprawdza
nazwę właściwości. Kolejne wywołania tej metody na tym samym obiekcie z tą samą
nazwą właściwości zwracają to samo zdarzenie.

Zauważ, że to zdarzenie nie przekaże żadnych argumentów do połączonej funkcji,
więc wartość zmienionej właściwości musi być odczytana bezpośrednio w
skrypcie.


Instance:GetStyledPropertyChangedSignal

property

Nazwa stylu właściwości, dla której należy nasłuchiwać zmiany.


Zwraca zdarzenie, które wywołuje się, gdy dany styl właściwości zmienia się na
instancji.


Instance

`Instance` jest klasą bazową dla wszystkich klas w hierarchii klas Roblox
które mogą być częścią drzewa `Class.DataModel`.


/reference/engine/classes/PhysicsService.yaml