`Class.AudioStreamWriter` schreibt Audiosamples aus Luau-Puffern in einen Audiostream,
was benutzerdefinierte Synthese oder Effektverarbeitung ermöglicht. Es bietet einen einzigen
**Output**-Pin und akzeptiert keine Eingabeströme.

Der Writer verwaltet einen internen Ringpuffer, dessen Größe durch
`Class.AudioStreamWriter.WindowSize|WindowSize` gesteuert wird. Samples, die mit
`Class.AudioStreamWriter:Write|Write()` geschrieben werden, werden gepuffert und vom Audio
Engine mit der Abtastrate verarbeitet. Verwenden Sie `Class.AudioStreamWriter:Space|Space()`, um
zu überprüfen, wie viele Frames geschrieben werden können, ohne Samples zu verlieren.

Für die Verarbeitung von Lese-Änderungs-Schreib-Effekten kombinieren Sie einen
`Class.AudioStreamReader` mit einem `Class.AudioStreamWriter`, um eingehendes Audio zu lesen,
es in Luau zu transformieren und das Ergebnis zurück in das Audiograph zu schreiben.

Beachten Sie, dass `Class.AudioStreamWriter` nur in Roblox Studio verwendet werden kann und
nicht in Team Create-Sitzungen.


Ereignis, das ausgelöst wird, nachdem ein `Class.Wire` verbunden oder getrennt wurde,
und dass `Class.Wire` jetzt oder zuvor mit einem Pin auf dem
`Class.AudioStreamWriter` und mit einer anderen verdrahtbaren Instanz verbunden war.


AudioStreamWriter.WiringChanged

connected

Ob die Instanz verbunden oder getrennt wurde.


Der Pin auf dem `Class.AudioStreamWriter`, den das `Class.Wire`
anspricht.


wire

Das `Class.Wire` zwischen dem `Class.AudioStreamWriter` und der anderen
Instanz.


instance

Die andere Instanz, die über das `Class.Wire` verbunden ist oder war.


Wird ausgelöst, wenn eine andere Instanz über ein `Class.Wire` mit dem
`Class.AudioStreamWriter` verbunden oder davon getrennt wird.


Gibt ein Array von `Class.Wire|Wires` zurück, die mit dem angegebenen
Pin verbunden sind. `Class.AudioStreamWriter` hat einen **Output**-Pin.


AudioStreamWriter:GetConnectedWires

Ein Eingangs- oder Ausgangspin auf dieser Instanz.


Gibt ein Array von `Class.Wire|Wires` zurück, die mit dem angegebenen
Pin verbunden sind.


Erhält die Liste der Pins, die `Class.Wire` in `Class.Wire.TargetName`
verwenden kann, um sich über die `Class.Wire.TargetInstance`-Eigenschaft mit dieser Instanz zu verbinden.

Für `Class.AudioStreamWriter` gibt es keine.


AudioStreamWriter:GetInputPins

Ein Array von Strings, die gültige Pin-Namen darstellen.


Erhält die Liste der Pins, die `Class.Wire` in `Class.Wire.TargetName`
verwenden kann, um sich über die `Class.Wire.TargetInstance`-Eigenschaft mit dieser Instanz zu verbinden.


Erhält die Liste der Pins, die `Class.Wire` in `Class.Wire.SourceName`
verwenden kann, um sich über die `Class.Wire.SourceInstance`-Eigenschaft mit dieser Instanz zu verbinden.

Für `Class.AudioStreamWriter` ist dies nur `Output`.


AudioStreamWriter:GetOutputPins

Erhält die Liste der Pins, die `Class.Wire` in `Class.Wire.SourceName`
verwenden kann, um sich über die `Class.Wire.SourceInstance`-Eigenschaft mit dieser Instanz zu verbinden.


Gibt die Anzahl der Frames zurück, die derzeit in den internen
Puffer geschrieben werden können, ohne Samples zu verlieren. Verwenden Sie dies, um zu vermeiden, dass mehr Daten geschrieben werden, als der Puffer halten kann. Der verfügbare Platz erhöht sich, während die Audio-Engine gepufferte Samples verarbeitet.


AudioStreamWriter:Space

Die Anzahl der Frames von verfügbarem Platz im internen Puffer.


Gibt die Anzahl der Frames zurück, die ohne Verlust von Samples geschrieben werden können.


Schreibt Audiosamples in den internen Puffer. Die Audio-Engine verarbeitet
diese Samples mit der konfigurierten Abtastrate und gibt sie über den
**Output**-Pin aus. Die Anzahl der Puffer im Array muss der Anzahl
von Kanälen entsprechen, die durch `Class.AudioStreamWriter.Layout|Layout` angegeben sind. Gibt
die Anzahl der tatsächlich geschriebenen Frames zurück, die möglicherweise geringer ist als die Pufferlänge, wenn nicht genügend Platz verfügbar ist. Verwenden Sie
`Class.AudioStreamWriter:Space|Space()`, um die verfügbare Kapazität vor dem Schreiben zu überprüfen.


AudioStreamWriter:Write

audioBuffer

Ein Array von Puffern, einen pro Kanal, die Samples zum Schreiben enthalten.


Die Anzahl der tatsächlich in den Puffer geschriebenen Frames.


Schreibt Audiosamples in den internen Puffer zur Wiedergabe.


AudioStreamWriter

Das Kanal-Layout des Audiostreams, den der Writer erzeugt. Dies
bestimmt, wie viele Puffer an
`Class.AudioStreamWriter:Write|Write()` übergeben werden müssen. Zum Beispiel erfordert ein
`Enum.AudioChannelLayout|Stereo`-Layout zwei Puffer pro Aufruf.


AudioStreamWriter.Layout

Das Kanal-Layout des Audiostreams, den der Writer erzeugt.


Das Sample-Format der Audiodaten, die im internen Puffer gespeichert sind. Dieses
Eigenschaft ist derzeit schreibgeschützt und ist immer
`Enum.AudioSampleFormat|Float32`.


AudioStreamWriter.SampleFormat

Das Sample-Format der Audiodaten, die im internen Puffer gespeichert sind.


Die Abtastrate der Audiodaten in Hertz. Diese Eigenschaft ist derzeit
schreibgeschützt und ist immer `48000`.


AudioStreamWriter.SampleRate

Steuert die Größe des internen Ringpuffers, der Audiosamples speichert,
bevor sie von der Audio-Engine verarbeitet werden. Größere Fenster erlauben mehr
Samples, die im Voraus gepuffert werden, wodurch die Wahrscheinlichkeit von Unterbrechungen
verringert wird, aber die Latenz erhöht wird. Kleinere Fenster reduzieren die Latenz, erfordern
aber häufigere Schreibvorgänge.


AudioStreamWriter.WindowSize

Steuert die Größe des internen Ringpuffers, der Audiosamples speichert,
bevor sie von der Audio-Engine verarbeitet werden.


Schreibt Audiosamples aus Luau-Puffern in einen Audiostream für benutzerdefinierte
Synthese.


`Instance` ist die Basisklasse für alle Klassen in der Roblox-Klassenhierarchie
und kann Teil des `Class.DataModel`-Baums sein.

Es ist nicht möglich, direkt Root-`Instance`-Objekte zu erstellen, aber der spezielle
`Datatype.Instance.new()`-Konstruktor erstellt Objekte über Code, wobei der
Name der Klasse als Parameter übergeben wird und das erstellte Objekt zurückgegeben wird.


Demonstriert das Erkennen von Änderungen an der Abstammung einer Instanz, indem man sich mit dem
`Class.Instance.AncestryChanged` Ereignis verbindet.

Der Parent des ChangingPart wird im Laufe der Zeit auf verschiedene Werte gesetzt. Der Parent des
Teils ist der Vorfahr des Teils, sodass das `Class.Instance.AncestryChanged` Ereignis
ausgelöst wird, wann immer es sich ändert.

Wird ausgelöst, wenn diese Instanz umgegliedert wird oder wenn einer ihrer Vorfahren
umgegliedert wird.

Sie können dieses Ereignis verwenden, um die Löschung einer Instanz im Studio zu verfolgen,
wie z.B. manuelle Löschung im Explorer oder über ein Plugin. Wenn Sie erkennen müssen,
wann eine Instanz mit `Class.Instance:Destroy()` zerstört wird, verwenden Sie stattdessen das
`Class.Instance.Destroying`-Ereignis.


Instance.AncestryChanged

child

Die Instanz, deren `Class.Instance.Parent|Parent`-Eigenschaft geändert wurde,
was diese Instanz oder einen weiter entfernten Vorfahren sein kann, **nicht**
notwendigerweise die Instanz, mit der der Handler verbunden ist.


parent

Der neue Elternteil des `child`-Parameters.


Wird ausgelöst, wenn die `Class.Instance.Parent`-Eigenschaft dieses Objekts oder eines seiner
Vorfahren geändert wird.


Dieses Ereignis wird ausgelöst, wenn ein Attribut an der Instanz geändert wird,
auch wenn ein Attribut auf `nil` gesetzt wird. Der Name des geänderten
Attributs wird an die verbundene Funktion übergeben.

Zum Beispiel verbindet der folgende Code-Schnipsel die Funktion `attributeChanged()`
so dass sie ausgelöst wird, wenn sich eines der Attribute des Teils ändert:

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

local part = Workspace.Part

local function attributeChanged(attributeName)
	print(attributeName, "geändert")
end

part.AttributeChanged:Connect(attributeChanged)
```
Siehe auch `Class.Instance:GetAttributeChangedSignal()`, das ein Ereignis zurückgibt,
 das ausgelöst wird, wenn ein bestimmtes Attribut geändert wird.


Instance.AttributeChanged

attribute

Der Name des Attributs, das geändert wurde.


Wird ausgelöst, wenn ein Attribut an der `Class.Instance` geändert wird.


Dieses Snippet druckt die Namen von Objekten aus, während sie zum Workspace hinzugefügt werden:

Wird ausgelöst, nachdem ein Objekt an diese `Class.Instance` angehängt wurde.

Hinweis: Wenn Sie diese Methode auf einem Client verwenden, um Objekte zu erkennen, die vom
Server erstellt wurden, ist es notwendig, `Class.Instance:WaitForChild()` zu verwenden, wenn
Sie die Nachkommen dieses Objekts indizieren. Dies liegt daran, dass das Objekt und seine
Nachkommen nicht garantiert gleichzeitig vom Server zum Client repliziert werden. Zum Beispiel:

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

Workspace.ChildAdded:Connect(function(child)
	-- Verwenden Sie WaitForChild(), da Nachkommen möglicherweise noch nicht repliziert wurden
	local head = child:WaitForChild("Head")
end)
```
Hinweis: Dieses Ereignis funktioniert nur für unmittelbare Kinder der
`Class.Instance`. Für ein Ereignis, das alle Nachkommen erfasst, verwenden Sie
`Class.Instance.DescendantAdded`.

Siehe auch `Class.Instance.ChildRemoved`.


Instance.ChildAdded

Die `Class.Instance`, die hinzugefügt wurde.


Wird ausgelöst, nachdem ein Objekt an diese `Class.Instance` angehängt wurde.


Instance.childAdded

Dieser Ausschnitt druckt die Namen von Objekten, während sie aus dem
Workspace entfernt werden:

Wird ausgelöst, nachdem ein Kind von dieser `Class.Instance` entfernt wurde.

Entfernt bezieht sich darauf, wenn der Elternteil eines Objekts von dieser
`Class.Instance` auf etwas anderes als diese `Class.Instance` geändert wird. Hinweis: Dieses
Ereignis wird auch ausgelöst, wenn ein Kind zerstört wird (unter Verwendung von
`Class.Instance:Destroy()`), da die Zerstörungsfunktion den Elternteil eines Objekts auf
`nil` setzt.

Dieses Ereignis funktioniert nur für unmittelbare Kinder der `Class.Instance`.
Für ein Ereignis, das alle Nachkommen erfasst, verwenden Sie
`Class.Instance.DescendantRemoving`.

Siehe auch `Class.Instance.ChildAdded`.


Instance.ChildRemoved

Die `Class.Instance`, die entfernt wurde.


Wird ausgelöst, nachdem ein Kind von dieser `Class.Instance` entfernt wurde.


Das folgende Beispiel gibt den Namen jedes Objekts aus, das zum
Arbeitsbereich hinzugefügt wird:

Dieses Ereignis wird ausgelöst, nachdem ein Nachkomme zur `Class.Instance` hinzugefügt wurde.

Da es für jeden Nachkommen ausgelöst wird, wird das Anfügen eines Objekts an die
`Class.Instance` das Ereignis für dieses Objekt und alle seine Nachkommen einzeln auslösen.

Wenn Sie sich nur für die **direkten Kinder** der
`Class.Instance` interessieren, verwenden Sie stattdessen `Class.Instance.ChildAdded`.

Siehe auch `Class.Instance.DescendantRemoving`.


Instance.DescendantAdded

descendant

Wird ausgelöst, nachdem ein Nachkomme zur `Class.Instance` hinzugefügt wurde.


Das folgende Beispiel gibt den Namen eines Nachkommens aus, während er entfernt wird
aus dem Workspace:

Dieses Ereignis wird **sofort bevor** der Elternteil `Class.Instance`
geändert wird, sodass eine **Nachkomme**-Instanz nicht mehr ein Nachkomme sein wird. `Class.Instance:Destroy()|Destroy()` ändert den `Class.Instance.Parent|Parent` einer Instanz auf `nil`, sodass der Aufruf dieser Methode auf einem Nachkommen des Elternteils dazu führt, dass dieses Ereignis ausgelöst wird.

Da dieses Ereignis **vor** der Entfernung des Nachkommens ausgelöst wird, bleibt der Elternteil
des Nachkommens zum Zeitpunkt des Auslösens dieses Ereignisses unverändert. Wenn der Nachkomme
ebenfalls ein **direktes Kind** des Elternteils ist, wird dieses Ereignis vor `Class.Instance.ChildRemoved` ausgelöst.

Wenn ein Nachkomme Kinder hat, wird dieses Ereignis zuerst mit dem Nachkommen ausgelöst,
 gefolgt von seinen Nachkommen.

#### Warnung

Dieses Ereignis wird mit dem Nachkommenobjekt ausgelöst, das entfernt wird.
Der Versuch, den `Class.Instance.Parent|Parent` des Nachkommens auf etwas anderes zu setzen,
wird fehlschlagen. Unten ist ein Beispiel, das dies demonstriert:

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

Workspace.DescendantRemoving:Connect(function(descendant)
	-- Manipulieren Sie den Elternteil des Nachkommens in dieser Funktion nicht!
	-- Dieses Ereignis wird ausgelöst, WEIL der Elternteil manipuliert wurde, und die Änderung hat noch nicht stattgefunden
	-- Daher ist es problematisch, den Elternteil so zu ändern:
	descendant.Parent = game
end)

local part = Instance.new("Part")
part.Parent = Workspace
part.Parent = nil
```
Siehe auch `Class.Instance.DescendantAdded|DescendantAdded`.


Instance.DescendantRemoving

Die `Class.Instance`, die entfernt wird.


Wird sofort ausgelöst, bevor ein Nachkomme der `Class.Instance` entfernt wird.


Dieses Beispiel zeigt, wie ein Instanz, wenn das Immediate-Signalverhalten verwendet wird,
bei der Zerstörung an Ort und Stelle bleibt, bis die verbundene Funktion anhalten muss.

In diesem Beispiel wird demonstriert, wie eine Instanz zerstört wird, bevor das Signal ausgelöst wird, wenn das Deferred-Signalverhalten verwendet wird.

Die `Class.Instance` wird niemals aus dem Speicher gelöscht, solange eine verbundene
Funktion sie noch verwendet. Wenn die Funktion jedoch an irgendeinem Punkt wartet,
werden die `Class.Instance` und ihre Nachkommen auf `nil` gesetzt.

Wenn die `Class.Workspace.SignalBehavior`-Eigenschaft auf
`Enum.SignalBehavior.Immediate` gesetzt ist, wird dieses Ereignis sofort ausgelöst, bevor die
`Class.Instance` oder einer ihrer Vorfahren mit `Class.Instance:Destroy()` zerstört wird.

Wenn die `Class.Workspace.SignalBehavior`-Eigenschaft auf
`Enum.SignalBehavior.Deferred` gesetzt ist, wird dieses Ereignis am nächsten Wiederaufnahmepunkt
ausgelöst, was nach der Zerstörung der `Class.Instance` oder eines ihrer Vorfahren mit
`Class.Instance:Destroy()` sein wird.

Mit dem Verhalten `Enum.SignalBehavior.Deferred|Deferred` ist es problematisch, ein Skript
mit seinem eigenen `Class.Instance.Destroying`-Ereignis zu verbinden, da das Skript
vor dem Aufruf des Rückrufs zerstört wird (was bedeutet, dass es nicht ausgeführt wird).

Beim Löschen einer `Class.Instance` im Studio, wie z.B. manuelles Löschen
über den [Explorer](/studio/explorer) oder über ein Plugin,
wird die `Class.Instance` nicht zerstört. Stattdessen wird der Elternteil auf `nil`
gesetzt, was Sie mit `Class.Instance.AncestryChanged` verfolgen können.


Instance.Destroying

Wird sofort ausgelöst, bevor (oder wird auf nachher verschoben) die Instanz über
`Class.Instance:Destroy()` zerstört wird.


Demonstriert `Class.Instance.StyledPropertiesChanged`.


Dieses Ereignis wird ausgelöst, wenn eine beliebige Stileigenschaft an der Instanz geändert wird,
 einschließlich wenn eine Eigenschaft auf `nil` gesetzt wird.


Instance.StyledPropertiesChanged

Wird ausgelöst, wenn eine beliebige Stileigenschaft an der Instanz geändert wird,
 einschließlich wenn eine Eigenschaft auf `nil` gesetzt wird.


Diese Methode wendet ein Tag auf die Instanz an, ohne dass es Auswirkungen hat, wenn das Tag
bereits angewendet wurde. Das erfolgreiche Hinzufügen eines Tags löst ein Signal aus, das von
`Class.CollectionService:GetInstanceAddedSignal()` mit dem angegebenen Tag erstellt wurde.

#### Warnungen

- Die Tags einer Instanz, die clientseitig hinzugefügt wurden, werden verworfen, wenn der
  Server später ein Tag zu dieser Instanz hinzufügt oder entfernt, da der Server
  alle Tags zusammen repliziert und vorherige Tags überschreibt.

- Beim Taggen einer Instanz ist es üblich, dass einige Ressourcen verwendet werden, um
  dem Tag seine Funktionalität zu geben, z. B. Ereignisverbindungen oder Tabellen.
  Um Speicherlecks zu vermeiden, ist es eine gute Idee, diese aufzuräumen (trennen,
  auf `nil` setzen usw.), wenn sie für ein Tag nicht mehr benötigt werden. Tun Sie dies beim
  Aufrufen von `Class.Instance:RemoveTag()`, beim Aufrufen von
  `Class.Instance:Destroy()` oder in einer Funktion, die mit einem Signal verbunden ist,
  das von `Class.CollectionService:GetInstanceRemovedSignal()` zurückgegeben wird.


Instance:AddTag

Das Tag, das auf die Instanz angewendet werden soll.


Die Kinderfunktion gibt ein Array der Kinder des Objekts zurück.


Instance:children

Gibt ein Array der Kinder des Objekts zurück.


Diese Methode zerstört alle Kinder und Nachkommen einer Instanz.

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

-- Füge einige Funkeln hinzu
for i = 1, 3 do
	local sparkles = Instance.new("Sparkles")
	sparkles.Parent = part

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

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

part:ClearAllChildren()

print("Children:", #part:GetChildren())  --> Children: 0
```
Wenn Sie nicht **alle** Kinder und Nachkommen zerstören möchten, verwenden Sie entweder
`Class.Instance:GetChildren()` oder `Class.Instance:GetDescendants()`, um
über diese Kinder/Nachkommen zu iterieren und auszuwählen, was zu zerstören ist. Zum
Beispiel wird der folgende Code alle
`Class.BasePart|BaseParts` zerstören, die von einem `Class.Model` abstammen:

```
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

Diese Methode zerstört alle Kinder einer Instanz.


Demonstriert das Klonen eines Modells mit `Class.Instance:Clone()`.

`Clone()` erstellt eine Kopie einer Instanz und aller ihrer Nachkommen,
indem alle Instanzen ignoriert werden, die nicht
`Class.Instance.Archivable|Archivable` sind. Die Kopie der Root-Instanz wird
von dieser Methode zurückgegeben und ihr `Class.Instance.Parent|Parent` wird auf
`nil` gesetzt. Beachten Sie, dass, wenn die Instanz selbst
`Class.Instance.Archivable|Archivable` auf `false` gesetzt hat, diese Methode
`nil` zurückgibt.

Wenn eine Referenzeigenschaft wie `Class.ObjectValue.Value` in einer
kopierten Instanz gesetzt wird, hängt der Wert der Eigenschaft der Kopie von dem
Wert des Originals ab:

- Wenn eine Referenzeigenschaft auf eine Instanz verweist, die **auch** kopiert wurde,
  verweist die Kopie auf die Kopie.
- Wenn eine Referenzeigenschaft auf eine Instanz verweist, die **nicht** kopiert wurde,
  bleibt derselbe Wert in der Kopie erhalten.


Instance:Clone

Eine Kopie der Instanz oder `nil`, wenn die Instanz nicht
`Class.Instance.Archivable|Archivable` ist.


Erstellt eine Kopie einer Instanz und aller ihrer Nachkommen, wobei Instanzen
ignoriert werden, die nicht `Class.Instance.Archivable|Archivable` sind.


Instance:clone

Demonstriert das Zerstören eines Parts mit der `Class.Instance:Destroy()`-Funktion.

Diese Funktion ist der richtige Weg, um Objekte zu entsorgen, die nicht mehr
benötigt werden.

Setzt die `Class.Instance.Parent`-Eigenschaft auf `nil`, sperrt die
`Class.Instance.Parent`-Eigenschaft, trennt alle Verbindungen und ruft
`Destroy()` für alle Kinder auf. Diese Methode ist der richtige Weg, um Objekte zu entsorgen,
die nicht mehr benötigt werden.

Das Entsorgen von nicht benötigten Objekten ist wichtig, da unnötige Objekte und
Verbindungen in einem Ort Speicher verbrauchen, was im Laufe der Zeit zu ernsthaften
Leistungsproblemen führen kann.

Als bewährte Methode sollten Sie nach dem Aufrufen von `Destroy()` auf einem Objekt alle
Variablen, die auf das Objekt (oder seine Nachkommen) verweisen, auf `nil` setzen. Dies
verhindert, dass Ihr Code auf irgendetwas zugreift, das mit dem Objekt zu tun hat.

```lua
local part = Instance.new("Part")
part.Name = "Hello, world"
part:Destroy()
-- Machen Sie das nicht:
print(part.Name)  --> "Hello, world"
-- Machen Sie dies, um die obige Zeile zu verhindern:
part = nil
```
Sobald eine `Class.Instance` durch diese Methode zerstört wurde, kann sie nicht
wiederverwendet werden, da die `Class.Instance.Parent`-Eigenschaft gesperrt ist. Um ein
Objekt **vorübergehend** zu entfernen, anstatt es zu zerstören, setzen Sie
`Class.Instance.Parent|Parent` auf `nil`. Zum Beispiel:

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

object.Parent = nil
task.wait(2)
object.Parent = Workspace
```
Um ein Objekt nach einer bestimmten Zeit zu zerstören, verwenden Sie
`Class.Debris:AddItem()`.


Instance:Destroy

Setzt die `Class.Instance.Parent`-Eigenschaft auf `nil`, sperrt die
`Class.Instance.Parent`-Eigenschaft, trennt alle Verbindungen und ruft
`Destroy()` für alle Kinder auf.


Instance:destroy

Gibt den ersten Vorfahren der `Class.Instance` zurück, dessen
`Class.Instance.Name` dem angegebenen Namen entspricht.

Diese Methode funktioniert nach oben, was bedeutet, dass sie bei dem unmittelbaren
`Class.Instance.Parent` der Instanz beginnt und sich in Richtung des `Class.DataModel`
bewegt. Wenn kein passender Vorfahr gefunden wird, gibt sie `nil` zurück.

Der folgende Code-Schnipsel würde den ersten Vorfahren des Objekts
mit dem Namen `Car` finden.

```
local car = object:FindFirstAncestor("Car")
```
Für Varianten dieser Methode, die Vorfahren einer bestimmten Klasse finden,
sehen Sie sich `Class.Instance:FindFirstAncestorOfClass()` und
`Class.Instance:FindFirstAncestorWhichIsA()` an.


Instance:FindFirstAncestor

name

Der `Class.Instance.Name`, nach dem gesucht werden soll.


Gibt den ersten Vorfahren der `Class.Instance` zurück, dessen
`Class.Instance.Name` dem angegebenen Namen entspricht.


Gibt den ersten Vorfahren der `Class.Instance` zurück, dessen
`Class.Object.ClassName` dem angegebenen className entspricht.

Diese Methode funktioniert nach oben, was bedeutet, dass sie bei dem unmittelbaren
`Class.Instance.Parent` der Instanz beginnt und sich in Richtung des `Class.DataModel`
bewegt. Wenn kein passender Vorfahr gefunden wird, gibt sie `nil` zurück.

Ein häufiger Anwendungsfall dieser Methode ist das Finden des `Class.Model`, zu dem ein
`Class.BasePart` gehört. Zum Beispiel:

```
local model = part:FindFirstAncestorOfClass("Model")
```
Diese Methode ist eine Variante von `Class.Instance:FindFirstAncestor()`, die
die `Class.Object.ClassName`-Eigenschaft anstelle von
`Class.Instance.Name` überprüft. `Class.Instance:FindFirstAncestorWhichIsA()` existiert ebenfalls,
und verwendet die `Class.Object:IsA()`-Methode, um die Klassenvererbung zu respektieren.


Instance:FindFirstAncestorOfClass

className

Der `Class.Object.ClassName`, nach dem gesucht werden soll.


Gibt den ersten Vorfahren der `Class.Instance` zurück, dessen
`Class.Object.ClassName` dem angegebenen className entspricht.


Gibt den ersten Vorfahren der `Class.Instance` zurück, für den
`Class.Object:IsA()` für den angegebenen className `true` zurückgibt.

Diese Methode funktioniert nach oben, was bedeutet, dass sie bei dem unmittelbaren
`Class.Instance.Parent` der Instanz beginnt und sich in Richtung des `Class.DataModel`
bewegt. Wenn kein passender Vorfahr gefunden wird, gibt sie `nil` zurück.

Im Gegensatz zu `Class.Instance:FindFirstAncestorOfClass()` verwendet diese Methode
`Class.Object:IsA()`, die die Klassenvererbung respektiert. Zum Beispiel:

```
print(part:IsA("Part"))  --> true
print(part:IsA("BasePart"))  --> true
print(part:IsA("Instance"))  --> true
```
Daher gibt der folgende Code-Schnipsel den ersten
`Class.BasePart`-Vorfahren zurück, unabhängig davon, ob es sich um einen `Class.WedgePart`,
`Class.MeshPart` oder `Class.Part` handelt.

```
local part = object:FindFirstAncestorWhichIsA("BasePart")
```
Siehe auch `Class.Instance:FindFirstAncestor()`.


Instance:FindFirstAncestorWhichIsA

Gibt den ersten Vorfahren der `Class.Instance` zurück, für den
`Class.Object:IsA()` für den angegebenen className `true` zurückgibt.


Die folgende Suche würde im Workspace nach einem Objekt mit dem Namen "Brick" suchen. Wenn es gefunden wird,
wird der Name des Objekts auf "Foo" geändert.

Gibt das erste Kind der `Class.Instance` mit dem angegebenen Namen zurück oder
`nil`, wenn kein solches Kind existiert. Wenn das optionale Argument `recursive`
`true` ist, sucht diese Methode alle Nachkommen und nicht nur die unmittelbaren Kinder der `Class.Instance`.

#### Überprüfung der Existenz eines Objekts

`FindFirstChild()` ist notwendig, wenn Sie überprüfen müssen, ob ein Objekt existiert,
bevor Sie fortfahren. Der Versuch, ein Kind nach Namen mit dem Punktoperator zu indizieren,
wirft einen Fehler, wenn das Kind nicht existiert.

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

-- Die folgende Zeile gibt einen Fehler aus, wenn das Teil nicht im Arbeitsbereich existiert
Workspace.Part.Transparency = 0.5
```
Ein besserer Ansatz ist es, `FindFirstChild()` zu verwenden, um zuerst nach `Part` zu suchen,
und dann eine `if`-Anweisung zu verwenden, um Code auszuführen, der es benötigt.

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

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

#### Finden eines Kindes, dessen Name mit einer Eigenschaft übereinstimmt

Manchmal ist der `Class.Instance.Name|Name` eines Objekts derselbe wie der einer
Eigenschaft seines `Class.Instance.Parent|Parent`. Wenn der Punktoperator verwendet wird,
haben Eigenschaften Vorrang vor Kindern, wenn sie denselben Namen teilen.

Im folgenden Beispiel wird ein `Class.Folder` mit dem Namen `Color` zu einem
`Class.Part` hinzugefügt, das auch die `Class.Part.Color`-Eigenschaft hat. Beachten Sie, dass
`part.Color` auf den Wert der `Datatype.Color3`-Eigenschaft verweist, nicht auf die Kindinstanz `Class.Folder`. Ein Vorteil der Verwendung von
`Class.Instance:FindFirstChild()|FindFirstChild()` besteht darin, dass die
Einführung neuer Eigenschaften kein Risiko für Ihren Code darstellt.

```lua
local part = Instance.new("Part")
local folder = Instance.new("Folder")
folder.Name = "Color"
folder.Parent = part
local c1 = part.Color  -- Die Eigenschaft
local c2 = part:FindFirstChild("Color")  -- Der Kindordner
```

#### Leistungsnotizen

`Class.Instance:FindFirstChild()|FindFirstChild()` benötigt etwa 20 % länger
als die Verwendung des Punktoperators und fast 8 Mal länger als einfach das Speichern
eines Verweises auf ein Objekt. Daher sollten Sie vermeiden, es in leistungsabhängigem Code wie in engen Schleifen oder Funktionen, die mit
`Class.RunService.Heartbeat` und `Class.RunService.PreRender` verbunden sind, aufzurufen. Stattdessen
speichern Sie das Ergebnis in einer Variablen oder ziehen Sie in Betracht, die
`Class.Instance.ChildAdded|ChildAdded` oder
`Class.Instance:WaitForChild()|WaitForChild()`-Methoden zu verwenden, um zu erkennen, wann ein Kind mit einem bestimmten Namen verfügbar wird.


Instance:FindFirstChild

recursive

Ob die Suche rekursiv durchgeführt werden soll oder nicht.


Gibt das erste Kind der `Class.Instance` zurück, das mit dem angegebenen Namen gefunden wurde.


Instance:findFirstChild

Gibt das erste Kind der `Class.Instance` zurück, dessen
`Class.Object.ClassName|ClassName` dem angegebenen `className` entspricht.
Im Gegensatz zu `Class.Instance:FindFirstChildWhichIsA()` gibt diese Methode nur
Objekte zurück, deren Klasse mit `className` übereinstimmt, wobei die Klassenvererbung ignoriert wird. Wenn kein passendes Kind gefunden wird, gibt diese Methode `nil` zurück.


Instance:FindFirstChildOfClass

Gibt das erste Kind der `Class.Instance` zurück, dessen
`Class.Object.ClassName|ClassName` dem angegebenen Klassennamen entspricht.


Gibt das erste Kind der `Class.Instance` zurück, für das
`Class.Object:IsA()` für den angegebenen className `true` zurückgibt.

Wenn kein passendes Kind gefunden wird, gibt diese Methode `nil` zurück. Wenn das optionale
rekursive Argument `true` ist, sucht diese Methode alle Nachkommen und nicht nur die unmittelbaren Kinder der `Class.Instance`.

Im Gegensatz zu `Class.Instance:FindFirstChildOfClass()` verwendet diese Methode
`Class.Object:IsA()`, die die Klassenvererbung respektiert. Zum Beispiel:

```lua
print(part:IsA("Part")) --> true
print(part:IsA("BasePart")) --> true
print(part:IsA("Instance")) --> true
```
Daher gibt der folgende Code-Schnipsel das erste
`Class.BasePart`-Kind zurück, unabhängig davon, ob es sich um einen `Class.WedgePart`,
`Class.MeshPart` oder `Class.Part` handelt.

```
local part = object:FindFirstChildWhichIsA("BasePart")
```
Entwickler, die ein Kind nach Namen suchen, sollten stattdessen
`Class.Instance:FindFirstChild()` verwenden.


Instance:FindFirstChildWhichIsA

Gibt das erste Kind der `Class.Instance` zurück, für das
`Class.Object:IsA()` für den angegebenen className `true` zurückgibt.


Gibt den ersten Nachkommen zurück, der mit dem angegebenen `Class.Instance.Name` gefunden wurde.

Diese Methode ist deaktiviert und kann nicht verwendet werden. Um den ersten Nachkommen
 einer Instanz zu finden, ziehen Sie in Betracht, das `recursive`-Argument bei
`Class.Instance:FindFirstChild()` stattdessen zu verwenden.


Instance:FindFirstDescendant

Gibt den ersten Nachkommen zurück, der mit dem angegebenen `Class.Instance.Name` gefunden wurde.


Wenn die `Class.Instance` ein `Class.Actor` ist, wird der `Class.Actor` selbst zurückgegeben. Andernfalls wird der nächstgelegene Vorfahr `Class.Actor` zurückgegeben. Wenn kein
Vorfahr ein `Class.Actor` ist, ist das Ergebnis `nil`.


Instance:GetActor

Gibt den `Class.Actor` zurück, der mit der Instanz verbunden ist, falls vorhanden.


Diese Methode gibt den Wert zurück, der dem angegebenen
Attributnamen zugewiesen wurde. Wenn kein Attribut zugewiesen wurde, wird `nil` zurückgegeben.

Zum Beispiel setzt der folgende Code-Schnipsel den Wert des Attributs
`InitialPosition` der Instanz und ruft ihn dann ab:

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

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

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

#### Siehe auch

- `Class.Instance:SetAttribute()`, die das Attribut mit dem angegebenen
  Namen auf den angegebenen Wert setzt.
- `Class.Instance:GetAttributes()`, die ein Wörterbuch von Schlüssel-Wert-Paaren für jedes Attribut der Instanz zurückgibt.


Instance:GetAttribute

Der Name des Attributs, das abgerufen werden soll.


Der Wert, der dem angegebenen Attributnamen zugewiesen wurde. Wenn kein
Attribut zugewiesen wurde, wird `nil` zurückgegeben.


Gibt den Wert zurück, der dem angegebenen Attributnamen zugewiesen wurde.


Diese Methode gibt ein Ereignis zurück, das sich genau wie das
`Class.Object.Changed|Changed`-Ereignis verhält, mit dem Unterschied, dass es nur ausgelöst wird, wenn sich das
spezifische angegebene Attribut ändert; effektiv ist es ähnlich wie
`Class.Object:GetPropertyChangedSignal()|GetPropertyChangedSignal()`, jedoch für Attribute.

Es ist im Allgemeinen eine gute Idee, diese Methode anstelle einer Verbindung zu
`Class.Object.Changed|Changed` mit einer Funktion zu verwenden, die den Attributnamen überprüft. Nachfolgende Aufrufe dieser Methode auf demselben Objekt mit demselben
Attributnamen geben dasselbe Ereignis zurück.

Das folgende Codebeispiel gibt ein Signal zurück, das die Funktion
`attributeChanged()` auslöst, wenn sich das Attribut `InitialPosition` des Teils ändert:

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

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

local function attributeChanged()
	print("Attribut geändert")
end

part:GetAttributeChangedSignal("InitialPosition"):Connect(attributeChanged)
```
Siehe auch `Class.Instance.AttributeChanged`, das ausgelöst wird, wenn sich ein beliebiges
Attribut der Instanz ändert.


Instance:GetAttributeChangedSignal

Der Name des angegebenen Attributs, für das das Änderungssignal
zurückgegeben wird.


Ein Ereignis, das ausgelöst wird, wenn sich das angegebene Attribut ändert.


Gibt ein Ereignis zurück, das ausgelöst wird, wenn sich das angegebene Attribut ändert.


Diese Methode gibt ein Wörterbuch von Schlüssel-Wert-Paaren für jedes Attribut
zurück, wobei der Schlüssel der Name des Attributs und der Wert ein nicht-`nil` Wert ist.

Zum Beispiel gibt der folgende Code-Schnipsel die Attribute und Werte einer Instanz aus:

```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
```
Siehe auch `Class.Instance:GetAttribute()`, die den Wert zurückgibt, der dem angegebenen Attributnamen zugewiesen wurde.


Instance:GetAttributes

Ein Wörterbuch von String → Variant-Paaren für jedes Attribut, wobei der
String der Name des Attributs und die Variante ein nicht-nil Wert ist.


Gibt ein Wörterbuch der Attribute der Instanz zurück.


Das Folgende würde die Namen aller Objekte, die sich derzeit im Workspace befinden, beim Ausführen ausgeben.

Gibt ein Array (eine numerisch indizierte Tabelle) zurück, das alle direkten Kinder der
Instanz enthält oder jede `Class.Instance`, deren
`Class.Instance.Parent|Parent` gleich dem Objekt ist. Das Array kann mit einer numerischen oder generischen `for`-Schleife durchlaufen werden:

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

-- Beispiel für eine numerische Schleife
local children = Workspace:GetChildren()
for i = 1, #children do
	local child = children[i]
	print(child.Name .. " ist Kind Nummer " .. i)
end
```

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

-- Beispiel für eine generische Schleife
local children = Workspace:GetChildren()
for i, child in children do
	print(child.Name .. " ist Kind Nummer " .. i)
end
```
Beachten Sie, dass das zurückgegebene Array **nicht** in einer bestimmten Reihenfolge sortiert ist, sodass
manuelles Sortieren (zum Beispiel mit `Library.table.sort()`) empfohlen wird, um
 die Kinder, die von dieser Methode zurückgegeben werden, zu sortieren.

Siehe auch die `Class.Instance:GetDescendants()|GetDescendants()`-Methode.


Instance:GetChildren

Ein Array, das die Kinder der Instanz enthält.


Gibt ein Array zurück, das alle Kinder der Instanz enthält.


Instance:getChildren

Gibt eine codierte Zeichenfolge der Debug-ID zurück, die intern von Roblox verwendet wird. Beachten Sie,

- Dieses Element ist geschützt. Der Versuch, es in einem `Class.Script` oder
  `Class.LocalScript` zu verwenden, führt zu einem Fehler.
- Eine Debug-ID ist eine ID, die in Debugging-Prozessen verwendet wird. Sie ermöglicht es einem Debugger,
  jede Anweisung zu lesen, bevor eine Anwendung sie verarbeitet. Alle Objekte in
  Roblox verhalten sich wie Prozesse und führen Anweisungen (oder 'Code') aus, die bei Bedarf
  debuggt werden können.
- Dies kann für Plugins hilfreich sein, die ähnliche
  Objekte voneinander unterscheiden müssen (z. B. Objekte, die denselben Namen teilen).


Instance:GetDebugId

scopeLength

Gibt eine codierte Zeichenfolge der Debug-ID zurück, die intern von Roblox verwendet wird.


GetDescendants wird häufig verwendet, um etwas mit allen Nachfahren zu tun, die ein
bestimmter Objekttyp sind. Der Code in diesem Beispiel verwendet GetDescendants und
`Class.Instance:IsA()`, um alle Teile im Workspace zu finden und sie grün zu
färben.

Diese Objektmethode gibt ein Array zurück, das alle Nachkommen
 dieses Objekts enthält. Im Gegensatz zu `Class.Instance:GetChildren()`, das nur die unmittelbaren
Kinder eines Objekts zurückgibt, findet diese Methode jedes Kind des Objekts, jedes Kind dieser Kinder und so weiter.

Beachten Sie, dass das zurückgegebene Array **nicht** in einer bestimmten Reihenfolge sortiert ist, sodass
manuelles Sortieren (zum Beispiel mit `Library.table.sort()`) empfohlen wird, um
 die Nachkommen, die von dieser Methode zurückgegeben werden, zu sortieren. Ziehen Sie auch die
`Class.Instance:QueryDescendants()|QueryDescendants()`-Methode in Betracht, um
Nachkommen durch eine Kombination von Selektoren und Kombinatoren abzufragen.


Instance:GetDescendants

Ein Array, das die Nachkommen der Instanz enthält.


Gibt ein Array zurück, das alle Nachkommen der Instanz enthält.


Diese Code-Beispiel zeigt das Verhalten von `Class.Instance:GetFullName()`.
Es zeigt, wie die Funktion sich verhält, wenn sie auf ein Objekt aufgerufen wird, das sich nicht in der
`DataModel`-Hierarchie befindet, und es zeigt auch, wie der Rückgabewert keine
Sonderzeichen entkommt.

Dieses Codebeispiel implementiert die Funktion `Class.Instance:GetFullName()` neu in
Lua.


Gibt eine Zeichenfolge zurück, die die Abstammung der Instanz beschreibt. Die Zeichenfolge ist eine
Verkettung des `Class.Instance.Name|Name` des Objekts und seiner
Vorfahren, getrennt durch Punkte. Das `Class.DataModel` (`game`) wird nicht
berücksichtigt. Zum Beispiel kann ein `Class.Part` im `Class.Workspace`
`Class.Workspace.Part` zurückgeben.

Wenn diese Methode auf einer `Class.Instance` aufgerufen wird, die kein Nachkomme des
`Class.DataModel` ist, berücksichtigt sie alle Vorfahren bis hin zu dem obersten, der kein `Class.Instance.Parent|Parent` hat.

Diese Methode ist nützlich für Protokollierung und Debugging. Sie sollten versuchen, die zurückgegebene Zeichenfolge nicht für nützliche Operationen zu parsen; diese Methode entkommt nicht den Punkten (oder anderen Symbolen) in Objektnamen. Mit anderen Worten,
obwohl ihre Ausgabe oft wie ein gültiger Luau-Bezeichner aussieht, ist dies nicht garantiert.


Instance:GetFullName

Der vollständige Name der `Class.Instance`.


Gibt eine Zeichenfolge zurück, die die Abstammung der Instanz beschreibt.


Demonstriert `Class.Instance:GetStyled()`.


Diese Methode gibt den stilisierten oder ausdrücklich modifizierten Wert der
angegebenen Eigenschaft zurück, oder den Standardwert der Eigenschaft, wenn er nicht stilisiert/modifiziert wurde. Dies unterscheidet sich leicht vom direkten Zugriff auf den Eigenschaftswert,
wie `[GuiObject].Rotation`, der den Standard- oder modifizierten Wert der Eigenschaft zurückgibt.


Instance:GetStyled

selector

Optionaler Selektor für die Pseudo-Instanz, die Sie auf der Instanz anvisieren.


Der stilisierte oder ausdrücklich modifizierte Wert der angegebenen Eigenschaft, oder
ansonsten der Standardwert der Eigenschaft, wenn er nicht stilisiert/modifiziert wurde.


Gibt den stilisierten oder ausdrücklich modifizierten Wert der angegebenen Eigenschaft zurück,
oder den Standardwert der Eigenschaft, wenn er nicht stilisiert/modifiziert wurde.


Demonstriert `Class.Instance:GetStyledPropertyChangedSignal()`.


Diese Methode gibt ein Ereignis zurück, das sich genau wie das
`Class.Instance.StyledPropertiesChanged|StyledPropertiesChanged`-Ereignis verhält,
mit dem Unterschied, dass es nur ausgelöst wird, wenn sich die angegebene Stil-Eigenschaft ändert. Es ist
generell eine gute Idee, diese Methode anstelle einer Verbindung zu
`Class.Instance.StyledPropertiesChanged|StyledPropertiesChanged` mit einer
Funktion zu verwenden, die den Eigenschaftsnamen überprüft. Nachfolgende Aufrufe dieser Methode auf
dieselben Objekt mit demselben Eigenschaftsnamen geben dasselbe Ereignis zurück.

Beachten Sie, dass dieses Ereignis keine Argumente an eine verbundene Funktion übergibt,
so dass der Wert der geänderten Eigenschaft direkt innerhalb eines
Skripts gelesen werden muss.


Instance:GetStyledPropertyChangedSignal

property

Name der Stil-Eigenschaft, für die Änderungen überwacht werden sollen.


Ereignis, das ausgelöst wird, wenn sich die angegebene Stil-Eigenschaft ändert.


Gibt ein Ereignis zurück, das ausgelöst wird, wenn sich die angegebene Stil-Eigenschaft auf der
Instanz ändert.


Diese Methode gibt ein Array der Tags zurück, die auf die angegebene Instanz angewendet wurden, als
Strings. Sie können Tags entweder im Studio im
[Eigenschaften](/studio/properties) Fenster oder zur Laufzeit mit
`Class.Instance:AddTag()|AddTag()` hinzufügen.

Diese Methode ist nützlich, wenn Sie etwas mit mehreren Tags auf
 einer Instanz gleichzeitig tun möchten. Es ist jedoch ineffizient, diese Methode zu verwenden, um
 die Existenz eines einzelnen Tags zu überprüfen; verwenden Sie stattdessen
`Class.Instance:HasTag()|HasTag()`, um nach einem bestimmten Tag zu suchen.


Instance:GetTags

Ein Array von Strings, die jeweils ein auf die Instanz angewendetes Tag darstellen.


Gibt ein Array aller Tags zurück, die auf die Instanz angewendet wurden.


Diese Methode gibt `true` zurück, wenn das angegebene Tag zu dem
Objekt hinzugefügt wurde. Sie können Tags entweder im Studio im
[Eigenschaften](/studio/properties) Fenster oder zur Laufzeit mit
`Class.Instance:AddTag()|AddTag()` hinzufügen.


Instance:HasTag

Das Tag, das auf der Instanz überprüft werden soll.


`true`, wenn die Instanz das angegebene Tag hat, andernfalls `false`.


Überprüft, ob die Instanz ein bestimmtes Tag hat.


Demonstriert, wie man bestimmt, ob eine Instanz der Vorfahr einer anderen ist, indem man
`Class.Instance:IsAncestorOf()` verwendet

Workspace und SpawnLocation sind Vorfahren des Dekors von SpawnLocation.
Workspace ist ein Vorfahr von SpawnLocation.

SpawnLocation und sein Dekor sind Nachkommen von Workspace, keine Vorfahren.
Dekor ist ein Nachkomme von SpawnLocation, kein Vorfahr.

Gibt `true` zurück, wenn eine `Class.Instance` ein Vorfahr des angegebenen
Nachkommens ist.

Eine `Class.Instance` wird als Vorfahr eines Objekts betrachtet, wenn der
`Class.Instance.Parent` des Objekts oder einer seiner Elternteile
`Class.Instance.Parent` auf die `Class.Instance` gesetzt ist.

Siehe auch `Class.Instance:IsDescendantOf()`.


Instance:IsAncestorOf

Gibt `true` zurück, wenn eine `Class.Instance` ein Vorfahr des angegebenen
Nachkommens ist.


Instance

`Instance` ist die Basisklasse für alle Klassen in der Roblox-Klassenhierarchie
und kann Teil des `Class.DataModel`-Baums sein.


/reference/engine/classes/AudioStreamWriter.yaml

Zusammenfassung