VideoCaptureService

`Instance` は Roblox クラス階層のすべてのクラスの基本クラスであり、`Class.DataModel` ツリーの一部である可能性があります。

ルートの `Instance` オブジェクトを直接作成することはできませんが、特別な `Datatype.Instance.new()` コンストラクタを使用して、クラスの名前をパラメーターとして渡し、作成されたオブジェクトを返します。


インスタンスの系譜の変化を検出する方法を示しています。`Class.Instance.AncestryChanged`イベントに接続します。

ChangingPartの親は、時間と共に異なる値に設定されます。パートの親はパートの先祖であるため、`Class.Instance.AncestryChanged`イベントは変更されるたびに発火します。

`Class.Instance.Parent` プロパティがオブジェクトまたはその先祖の一つで変更されたときに発火します。

このイベントには2つのパラメータが含まれています：`child` は `Class.Instance`を指し、実際に `Class.Instance.Parent` が変更されたものであり、`parent` はこのインスタンスの新しい `Class.Instance.Parent` を指します。

このイベントを使用して、スタジオ内でインスタンスの削除を追跡できます。たとえば、エクスプローラー内での手動削除やプラグインを通じての削除などです。`Class.Instance:Destroy()` を使用してインスタンスが破棄されたときの検出が必要な場合は、代わりに `Class.Instance.Destroying` イベントを使用してください。

Instance.AncestryChanged

child

`Class.Instance.Parent` が変更された `Class.Instance`。

parent

`Class.Instance.Parent` が変更された `Class.Instance` の新しい `Class.Instance.Parent`。

`Class.Instance.Parent` プロパティがオブジェクトまたはその先祖の一つで変更されたときに発火します。

このイベントは、インスタンスの属性が変更されるたびに発火し、属性が `nil` に設定されるときも含まれます。変更された属性の名前が接続された関数に渡されます。

たとえば、次のコードスニペットは、部品の属性のいずれかが変更されるたびに `attributeChanged()` 関数を接続しています：

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

local part = Workspace.Part

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

part.AttributeChanged:Connect(attributeChanged)
```
特定の属性が変更されるときに発火するイベントを返す `Class.Instance:GetAttributeChangedSignal()` も参照してください。

Instance.AttributeChanged

attribute

`Class.Instance` に属性が変更されるたびに発火します。

このスニペットは、オブジェクトがWorkspaceに追加されると、その名前を出力します:

オブジェクトがこの `Class.Instance` に親付けされた後に発火します。

このメソッドを使って、サーバーによって作成されたオブジェクトをクライアントで検出する場合、これらのオブジェクトの子孫をインデックスする際には `Class.Instance:WaitForChild()` を使用する必要があります。なぜなら、オブジェクトとその子孫が必ずしもサーバーからクライアントに同時に複製されるわけではないからです。たとえば：

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

Workspace.ChildAdded:Connect(function(child)
	-- 子孫がまだ複製されていない可能性があるため、WaitForChild() を使用します
	local head = child:WaitForChild("Head")
end)
```
このイベントは、`Class.Instance` の直近の子に対してのみ動作します。すべての子孫をキャプチャするイベントが必要な場合は、`Class.Instance.DescendantAdded` を使用してください。

`Class.Instance.ChildRemoved` も参照してください。

Instance.ChildAdded

オブジェクトがこの `Class.Instance` に親付けされた後に発火します。

Instance.childAdded

このスニペットは、オブジェクトがワークスペースから削除されるときにその名前を表示します:

この `Class.Instance` から子が削除された後に発火します。

削除は、オブジェクトの親がこの `Class.Instance` からこの `Class.Instance` 以外のものに変更されたときを指します。このイベントは、子が破棄されたとき（`Class.Instance:Destroy()` を使用）にも発火します。なぜなら、破棄関数がオブジェクトの親を `nil` に設定するからです。

このイベントは、`Class.Instance` の直近の子に対してのみ動作します。すべての子孫をキャプチャするイベントが必要な場合は、`Class.Instance.DescendantRemoving` を使用してください。

`Class.Instance.ChildAdded` も参照してください。

Instance.ChildRemoved

この `Class.Instance` から子が削除された後に発火します。

次の例では、Workspaceに追加されたオブジェクトの名前を印刷します:

このイベントは、子孫がこの `Class.Instance` に追加された後に発火します。

すべての子孫に対して発火するため、オブジェクトを `Class.Instance` に親付けすることは、このオブジェクトとそのすべての子孫に対して個別にイベントを発火させます。

`Class.Instance` の **直接の子** のみを考慮している場合は、代わりに `Class.Instance.ChildAdded` を使用してください。

`Class.Instance.DescendantRemoving` も参照してください。

Instance.DescendantAdded

descendant

子孫がこの `Class.Instance` に追加された後に発火します。

次の例は、Workspace から削除されるときに、任意の子孫の名前を印刷します:

このイベントは、親の `Class.Instance` が変更されて **子孫** インスタンスがもはや子孫でなくなるようにする直前に発火します。 `Class.Instance:Destroy()|Destroy()` は、インスタンスの `Class.Instance.Parent|Parent` を `nil` に変更するため、親の子孫に対してこのメソッドを呼び出すとこのイベントが発火します。

このイベントが発火する時点で、子孫の親は変更されていません。子孫が親の **直接の子** でもある場合、このイベントは `Class.Instance.ChildRemoved` よりも先に発火します。

子孫が子を持つ場合、このイベントはまず子孫が発火し、その後に子孫が続きます。

##### 警告

このイベントは、削除される子孫オブジェクトとともに発火します。子孫の `Class.Instance.Parent|Parent` を他のものに設定しようとすると失敗します。以下はこれを示す例です:

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

Workspace.DescendantRemoving:Connect(function(descendant)
	-- この関数内で子孫の親を操作しないでください！
	-- このイベントは親が操作されたために発火し、変更はまだ発生していません
	-- したがって、このように親を変更することは問題があります:
	descendant.Parent = game
end)

local part = Instance.new("Part")
part.Parent = Workspace
part.Parent = nil
```

`Class.Instance.DescendantAdded|DescendantAdded` も参照してください。

Instance.DescendantRemoving

子孫が削除される直前に発火します。

このサンプルは、即時シグナルの動作を使用する際に、インスタンスが破壊されるときに接続された関数が待機するまでその場所に留まることを示しています。

このサンプルは、遅延シグナルの動作を使用する際に、インスタンスがシグナルが発火する前に破壊される方法を示しています。

`Class.Instance` は、接続された関数がまだ使用している間はメモリから削除されることはありません。しかし、関数が任意の時点で待機する場合、`Class.Instance` とその子孫は `nil` に親付けされます。

`Class.Workspace.SignalBehavior` プロパティが `Enum.SignalBehavior.Immediate` に設定されている場合、このイベントは `Class.Instance` またはその先祖が `Class.Instance:Destroy()` で破棄される直前に発火します。

`Class.Workspace.SignalBehavior` プロパティが `Enum.SignalBehavior.Deferred` に設定されている場合、このイベントは次の再開ポイントで発火し、これは `Class.Instance` またはその先祖が `Class.Instance:Destroy()` で破棄された後になります。

`Enum.SignalBehavior.Deferred|Deferred` の動作では、スクリプトを自分の `Class.Instance.Destroying` イベントに接続することは問題があります。なぜなら、スクリプトはコールバックが呼び出される前に破棄されるため（つまり、実行されないからです）。

スタジオ内で `Class.Instance` を削除するとき、エクスプローラーを介して手動で削除するか、プラグインを通じて削除すると、`Class.Instance` は破棄されません。代わりに、親が `nil` に設定され、これを `Class.Instance.AncestryChanged` で追跡できます。

Instance.Destroying

`Class.Instance:Destroy()` を介してインスタンスが破棄される直前に発火します（または後で遅延されます）。

このイベントは、インスタンスのスタイルプロパティが変更されるたびに発火します。プロパティが `nil` に設定される場合も含まれます。

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

local player = Players.LocalPlayer
local playerGui = player.PlayerGui
local HUDContainer = playerGui:WaitForChild("HUDContainer")
local meterBar = HUDContainer.MeterBar

local function stylePropertyChanged()
	print("スタイルプロパティが変更されました")
end

meterBar:StyledPropertiesChanged():Connect(stylePropertyChanged)
```


Instance.StyledPropertiesChanged

インスタンスのスタイルプロパティが変更されるたびに発火します。プロパティが `nil` に設定される場合も含まれます。

このメソッドはインスタンスにタグを適用し、タグがすでに適用されている場合は何も効果がありません。タグの追加に成功すると、指定されたタグで `Class.CollectionService:GetInstanceAddedSignal()` によって作成されたシグナルが発火します。

##### 警告

- クライアント側で追加されたインスタンスのタグは、サーバーがそのインスタンスでタグを追加または削除するとドロップされます。サーバーはすべてのタグを一緒に複製し、以前のタグを上書きします。

- インスタンスにタグを付ける際、タグの機能を提供するためにリソースが使用されることが一般的です（例えば、イベント接続やテーブル）。メモリリークを防ぐために、タグにとって必要がなくなったときはこれらをクリーンアップすることが良いアイデアです（切断、`nil` に設定するなど）。これは、`Class.Instance:RemoveTag()` を呼び出すときや、`Class.Instance:Destroy()` を呼び出すとき、または `Class.CollectionService:GetInstanceRemovedSignal()` から返されたシグナルに接続された関数の中で行うべきです。


Instance:AddTag

インスタンスにタグを適用します。


子供関数はオブジェクトの子供の配列を返します。


Instance:children

オブジェクトの子供の配列を返します。


このメソッドはインスタンスのすべての子と子孫を破壊します。

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

-- スパークルを追加
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
```
すべての子供と子孫を破壊したくない場合は、`Class.Instance:GetChildren()` または `Class.Instance:GetDescendants()` を使用して、これらの子供/子孫をループし、破壊するものを選択することができます。たとえば、次のコードサンプルは `Class.Model` から下位のすべての `Class.BasePart|BaseParts` を破壊します：

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

このメソッドはインスタンスのすべての子を破壊します。


`Class.Instance:Clone()`を使用してモデルをクローンすることを示します。

`Clone()` はインスタンスとそのすべての子孫のコピーを作成し、`Class.Instance.Archivable|Archivable` でないすべてのインスタンスを無視します。ルートインスタンスのコピーがこのメソッドによって返され、その `Class.Instance.Parent|Parent` は `nil` に設定されます。インスタンス自体が `Class.Instance.Archivable|Archivable` を `false` に設定されている場合、このメソッドは `nil` を返します。

`Class.ObjectValue.Value` のような参照プロパティがクローンされたインスタンスに設定された場合、コピーのプロパティの値は元の値によって決まります：

- 参照プロパティが **同じく** クローンされたインスタンスを指す場合、コピーはそのコピーを指します。
- 参照プロパティが **クローンされていない** インスタンスを指す場合、同じ値がコピーに保持されます。


Instance:Clone

インスタンスとそのすべての子孫のコピーを作成し、`Class.Instance.Archivable|Archivable` でないインスタンスを無視します。


Instance:clone

この関数は、`Class.Instance:Destroy()`関数を使用してパーツを破壊することを示しています。

この関数は、もはや必要ないオブジェクトを処理する正しい方法です。

`Class.Instance.Parent` プロパティを `nil` に設定し、`Class.Instance.Parent` プロパティをロックし、すべての接続を切断し、すべての子に `Destroy()` を呼び出します。このメソッドはもはや必要のないオブジェクトを処理する正しい方法です。

不必要なオブジェクトを解放することは重要です。なぜなら、不必要なオブジェクトと接続はメモリを使い、時間とともに深刻なパフォーマンスの問題を引き起こす可能性があるからです。

`Destroy()` をオブジェクトに対して呼び出した後は、オブジェクト（またはその子孫）を参照している変数を `nil` に設定することが最善の実践です。これにより、コードがオブジェクトに関連する何かにアクセスするのを防ぎます。

```lua
local part = Instance.new("Part")
part.Name = "Hello, world"
part:Destroy()
-- これをしてはいけません：
print(part.Name)  --> "Hello, world"
-- 上記の行が実行されるのを防ぐには、こうするべきです：
part = nil
```

`Class.Instance` がこのメソッドによって破壊された場合、それは再利用できません。なぜなら `Class.Instance.Parent` プロパティがロックされているからです。オブジェクトを破壊するのではなく、**一時的に** 削除するには、`Class.Instance.Parent|Parent` を `nil` に設定します。例えば：

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

object.Parent = nil
task.wait(2)
object.Parent = Workspace
```
設定した時間が経過した後にオブジェクトを破壊するには、`Class.Debris:AddItem()` を使用してください。


Instance:Destroy

`Class.Instance.Parent` プロパティを `nil` に設定し、`Class.Instance.Parent` プロパティをロックし、すべての接続を切断し、すべての子に `Destroy()` を呼び出します。


Instance:destroy

`Class.Instance` の最初の祖先を返します。

このメソッドは上方向に作動し、インスタンスの直接の `Class.Instance.Parent` から始まり、`Class.DataModel` まで遡ります。一致する祖先が見つからない場合、`nil` が返されます。

次のコードスニペットは、オブジェクトの名前が `Car` である最初の祖先を見つけます。

```
local car = object:FindFirstAncestor("Car")
```
このメソッドのバリアントで特定のクラスの祖先を見つけるものについては、`Class.Instance:FindFirstAncestorOfClass()` および `Class.Instance:FindFirstAncestorWhichIsA()` を参照してください。


Instance:FindFirstAncestor

name

探すべき `Class.Instance.Name` です。


見つかった `Class.Instance` です。


`Class.Instance` の最初の祖先を返します。


`Class.Instance` の最初の祖先を返します。

このメソッドは上方向に作動し、インスタンスの直接の `Class.Instance.Parent` から `Class.DataModel` まで遡ります。一致する祖先が見つからない場合、`nil` が返されます。

このメソッドの一般的な使用法は、`Class.BasePart` に属する `Class.Model` を見つけることです。例えば：

```
local model = part:FindFirstAncestorOfClass("Model")
```
このメソッドは `Class.Instance:FindFirstAncestor()` のバリアントであり、`Class.Object.ClassName` プロパティをチェックするのではなく、`Class.Instance.Name` をチェックします。`Class.Instance:FindFirstAncestorWhichIsA()` も存在し、クラスの継承を尊重するために `Class.Object:IsA()` メソッドを使用します。


Instance:FindFirstAncestorOfClass

className

探すべき `Class.Object.ClassName` です。


`Class.Instance` の最初の祖先を返します。

このメソッドは上方向に作動し、インスタンスの直接の `Class.Instance.Parent` から `Class.DataModel` まで遡ります。一致する祖先が見つからない場合、`nil` が返されます。

`Class.Instance:FindFirstAncestorOfClass()` とは異なり、このメソッドは `Class.Object:IsA()` を使用し、クラスの継承を尊重します。例えば：

```
print(part:IsA("Part"))  --> true
print(part:IsA("BasePart"))  --> true
print(part:IsA("Instance"))  --> true
```
したがって、次のコードサンプルは最初の `Class.BasePart` 祖先を返します。

```
local part = object:FindFirstAncestorWhichIsA("BasePart")
```
名前で子オブジェクトを探している開発者は、代わりに `Class.Instance:FindFirstChild()` を使用すべきです。


Instance:FindFirstAncestorWhichIsA

以下は、Workspace内でオブジェクト名「Brick」を探します。見つかった場合、それ
はオブジェクトの名前を「Foo」に変更します。

指定された名前を持つ `Class.Instance` の最初の子を返します。存在しない場合は `nil` が返されます。オプションの `recursive` 引数が `true` の場合、このメソッドは `Class.Instance` の直接の子だけでなくすべての子孫を検索します。

##### オブジェクトの存在確認

`FindFirstChild()` は、続行する前にオブジェクトの存在を確認する必要がある場合に必要です。ドット演算子を使用して名前で子にインデックスを付けると、子が存在しない場合はエラーが発生します。

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

-- 以下の行は、パートがワークスペースに存在しない場合にエラーになります
Workspace.Part.Transparency = 0.5
```
より良いアプローチは、最初に `Part` を確認するために `FindFirstChild()` を使用し、その後に必要なコードを実行するための `if` 文を使用することです。

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

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

##### プロパティに一致する子の検索

時には、オブジェクトの `Class.Instance.Name|Name` がその親のプロパティと同じであることがあります。ドット演算子を使用すると、同じ名前のプロパティが子よりも優先されます。

次の例では、`Class.Part` に `Color` という名前の `Class.Folder` が追加されており、`Class.Part.Color` プロパティも存在します。`part.Color` は子の `Class.Folder` インスタンスではなく、`Datatype.Color3` プロパティ値を参照しています。`Class.Instance:FindFirstChild()|FindFirstChild()` を使用する利点は、新しいプロパティの導入がコードにリスクを与えないことです。

```lua
local part = Instance.new("Part")
local folder = Instance.new("Folder")
folder.Name = "Color"
folder.Parent = part
local c1 = part.Color  -- プロパティ
local c2 = part:FindFirstChild("Color")  -- 子フォルダ
```

##### パフォーマンスメモ

`Class.Instance:FindFirstChild()|FindFirstChild()` は、ドット演算子を使用するのに比べて約 20% より長くかかり、単にオブジェクトへの参照を保存するよりも 8 倍長くかかります。したがって、パフォーマンスが依存するコード（例えば、タイトなループや `Class.RunService.Heartbeat` や `Class.RunService.PreRender` に接続された関数など）では、このメソッドの呼び出しを避けるべきです。代わりに、結果を変数に保存するか、`Class.Instance.ChildAdded|ChildAdded` または `Class.Instance:WaitForChild()|WaitForChild()` を使用して、指定された名前の子が利用可能になるときに検出することを検討してください。


Instance:FindFirstChild

検索する `Class.Instance.Name` です。


recursive

検索が再帰的に行われるべきかどうか。


指定された名前で見つかった `Class.Instance` の最初の子を返します。


Instance:findFirstChild

指定された `Class.Instance` の最初の子を返します。その `Class.Object.ClassName|ClassName` が指定された `className` と等しい場合。`Class.Instance:FindFirstChildWhichIsA()` とは異なり、このメソッドはクラスの継承を無視し、`className` と一致するオブジェクトのみを返します。一致する子が見つからない場合、このメソッドは `nil` を返します。


Instance:FindFirstChildOfClass

指定された `Class.Instance` の最初の子を返します。


指定されたクラス名の `Class.Instance` の最初の子を返します。

一致する子が見つからない場合、このメソッドは `nil` を返します。オプションの再帰引数が `true` の場合、このメソッドは直接の子だけでなくすべての子孫を検索します。

`Class.Instance:FindFirstChildOfClass()` とは異なり、このメソッドはクラスの継承を尊重します。例えば：

```lua
print(part:IsA("Part")) --> true
print(part:IsA("BasePart")) --> true
print(part:IsA("Instance")) --> true
```
したがって、次のコードサンプルは最初の `Class.BasePart` 子を返します。

```
local part = object:FindFirstChildWhichIsA("BasePart")
```
名前で子を探している開発者は、代わりに `Class.Instance:FindFirstChild()` を使用すべきです。


Instance:FindFirstChildWhichIsA

指定されたクラス名の `Class.Instance` の最初の子を返します。


指定された `Class.Instance.Name` で見つかった最初の子孫を返します。

このメソッドは無効であり、使用することはできません。インスタンスの最初の子孫を見つけるには、代わりに `Class.Instance:FindFirstChild()` の `recursive` パラメータを使用してください。


Instance:FindFirstDescendant

指定された `Class.Instance.Name` で見つかった最初の子孫を返します。


`Class.Instance` が `Class.Actor` の場合、その `Class.Actor` 自体が返されます。そうでなければ、最も近い祖先の `Class.Actor` が返されます。祖先が `Class.Actor` でない場合、結果は `nil` となります。


Instance:GetActor

インスタンスに関連付けられた `Class.Actor` を返します。


このメソッドは、指定された属性名に割り当てられた値を返します。属性が割り当てられていない場合、`nil` が返されます。

例えば、次のコードスニペットはインスタンスの `InitialPosition` 属性を設定し、次にその値を取得します：

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

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

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

##### 関連項目

- `Class.Instance:SetAttribute()` は、指定された名前で属性を指定された値に設定します。
- `Class.Instance:GetAttributes()` は、インスタンスの各属性に対するキー-値ペアの辞書を返します。


Instance:GetAttribute

指定された属性名に割り当てられた値。属性が割り当てられていない場合、`nil` が返されます。


指定された属性名に割り当てられた値を返します。


このメソッドは、指定された属性が変更されたときにのみ発火するイベントを返します。一般的に、このメソッドを使用することが良いアイデアです。なぜなら、`Class.Object.Changed|Changed` に接続し、関数で属性名をチェックするのと同様の動作をするからです。既存のオブジェクトに対して同じ属性名でのこのメソッドの後続の呼び出しは、同じイベントを返します。

次のコード例は、パートの `InitialPosition` 属性が変更されたときに `attributeChanged()` 関数を発火させるシグナルを返します：

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

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

local function attributeChanged()
	print("Attribute changed")
end

part:GetAttributeChangedSignal("InitialPosition"):Connect(attributeChanged)
```

`Class.Instance.AttributeChanged` は、インスタンスの属性が変更されるたびに発火します。


Instance:GetAttributeChangedSignal

変更信号を返す指定された属性の名前です。


指定された属性が変更されたときに発火するイベントです。


指定された属性が変更されたときに発火するイベントを返します。


このメソッドは、属性の名前がキーで、その値が非 `nil` 値である各属性のキー-バリュー ペアの辞書を返します。

例えば、次のコードスニペットはインスタンスの属性と値を出力します：

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

`Class.Instance:GetAttribute()` は、指定された属性名に割り当てられた値を返します。


Instance:GetAttributes

各属性の名前がキーであり、非 `nil` 値である、文字列→バリアントのペアの辞書です。


インスタンスの属性の辞書を返します。


下記は、実行時にWorkspace内のすべてのオブジェクトの名前を印刷します。

インスタンスの直接のすべての子を含む配列（数値インデックスのテーブル）を返します。この配列は数値または一般的な `for` ループを使用してイテレートできます：

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

-- 数値ループの例
local children = Workspace:GetChildren()
for i = 1, #children do
	local child = children[i]
	print(child.Name .. " は子の番号 " .. i .. " です")
end
```

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

-- 一般的なループの例
local children = Workspace:GetChildren()
for i, child in children do
	print(child.Name .. " は子の番号 " .. i .. " です")
end
```
返された配列は、特に順序が指定されていないため、手動でソートを行うことをお勧めします（例えば、`Library.table.sort()` を使用）。

`Class.Instance:GetDescendants()|GetDescendants()` メソッドも参照してください。


Instance:GetChildren

インスタンスの子を含む配列です。


インスタンスのすべての子を含む配列を返します。


Instance:getChildren

ロブロックス内部で使用されるデバッグ ID のコード化された文字列を返します。注意点は次のとおりです：

- この項目は保護されています。`Class.Script` や `Class.LocalScript` で使用しようとするとエラーが発生します。
- デバッグ ID は、デバッグプロセスで使用される ID です。デバッガは、アプリケーションが処理する前に各命令を読み取ることができます。ロブロックス内のすべてのオブジェクトはプロセスとして機能し、必要に応じてデバッグ可能な命令（または 'コード'）を実行します。
- これは、類似のオブジェクトを区別する必要があるプラグインにとって役立ちます（同じ名前を持つオブジェクトなど）。


Instance:GetDebugId

scopeLength

Roblox によって内部で使用されるデバッグ ID のコード化された文字列を返します。


GetDescendants は、特定のタイプのオブジェクトのすべての子孫に対して何かを行うためにしばしば使用されます。この例のコードは GetDescendants と `Class.Instance:IsA()` を使用してワークスペース内のすべての部品を見つけ、それらを緑色に変更します。

このオブジェクトメソッドは、そのオブジェクトのすべての子孫を含む配列を返します。`Class.Instance:GetChildren()` とは異なり、このメソッドはオブジェクトのすべての子、すべての子の子、などを見つけます。

返された配列は特に順序が指定されていないため、手動でソートを行うことをお勧めします（例えば、`Library.table.sort()` を使用）。また、特定のセレクタと組み合わせで子孫を照会するには、`Class.Instance:QueryDescendants()|QueryDescendants()` メソッドも検討してください。


Instance:GetDescendants

インスタンスの子孫を含む配列です。


インスタンスのすべての子孫を含む配列を返します。


このコードサンプルは、`Class.Instance:GetFullName()` の動作を示します。
`DataModel` 階層にないオブジェクトで呼び出したときの関数の動作を示し、
戻り値が特殊文字をエスケープしないことも示します。

このコードサンプルは、`Class.Instance:GetFullName()` 関数を Lua で再実装します。

インスタンスの系譜を記述する文字列を返します。この文字列は、オブジェクトの `Class.Instance.Name|Name` とその祖先を結合したもので、ピリオドで区切られます。`Class.DataModel`（`game`）は考慮されません。例えば、`Class.Part` は `Class.Workspace.Part` を返すかもしれません。

`Class.DataModel` の子孫でない `Class.Instance` の上で呼び出されると、このメソッドは `Class.Instance.Parent|Parent` がない最も上の祖先までのすべての祖先を検討します。

このメソッドは、ログ記録やデバッグに役立ちます。返された文字列を有用な操作のために解析する試みは行わないでください。このメソッドはオブジェクト名のピリオド（または他の記号）をエスケープしません。言い換えれば、その出力は有効な Luau 識別子のように見えることが多いですが、保証はされません。


Instance:GetFullName

`Class.Instance` のフルネームです。


インスタンスの系譜を記述する文字列を返します。


このメソッドは、指定されたプロパティのスタイルされた値または明示的に変更された値を返します。そうでない場合は、スタイル変更されていないデフォルトのプロパティ値が返されます。これは、直接プロパティ値にアクセスすること（例えば、`[GuiObject].Rotation`）とわずかに異なり、プロパティのデフォルトまたは変更された値を返します。

```lua
local Players = game:GetService("Players")
local ReplicatedStorage = game:GetService("ReplicatedStorage")

local player = Players.LocalPlayer
local playerGui = player.PlayerGui
local HUDContainer = playerGui:WaitForChild("HUDContainer")

local coreSheet = ReplicatedStorage:FindFirstChild("CoreSheet")
local rule = coreSheet:FindFirstChildWhichIsA("StyleRule")
rule.Selector = "TextButton"

-- ボタンへの参照
local button = HUDContainer:FindFirstChildWhichIsA("TextButton")

print(button:GetStyled("Rotation")) --> 0 (デフォルト値)
print(button.Rotation) --> 0 (デフォルト値)

-- スタイルルールプロパティを通じて回転を適用
rule:SetProperty("Rotation", 30)

print(button:GetStyled("Rotation")) --> 30 (ルールに基づいたスタイル値)
print(button.Rotation) --> 0 (デフォルト値)

-- スタイルプロパティを明示的に変更/オーバーライド
button.Rotation = 45

print(button:GetStyled("Rotation")) --> 45 (変更された値)
print(button.Rotation) --> 45 (変更された値)
```


Instance:GetStyled

クエリするプロパティの名前。


指定されたプロパティのスタイルされた値または明示的に変更された値。スタイルや変更が行われていない場合はデフォルトのプロパティ値が返されます。


指定されたプロパティのスタイルされた値または明示的に変更された値を返します。スタイルや変更が行われていない場合はデフォルトのプロパティ値が返されます。


このメソッドは、指定されたスタイルプロパティが変更されたときに発火するイベントを返します。`Class.Instance.StyledPropertiesChanged|StyledPropertiesChanged` イベントと正確に同様の動作をしますが、特定のプロパティが変更されたときのみ発火します。一般的に、このメソッドを `Class.Instance.StyledPropertiesChanged|StyledPropertiesChanged` に接続し、プロパティ名をチェックする関数の代わりに使用することが良いアイデアです。後続の同じプロパティ名でこのメソッドを呼び出すと、同じイベントが返されます。

このイベントは、接続された関数に引数を渡さないため、変更されたプロパティの値はスクリプト内で直接読み取る必要があります。

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

local player = Players.LocalPlayer
local playerGui = player.PlayerGui
local HUDContainer = playerGui:WaitForChild("HUDContainer")
local meterBar = HUDContainer.MeterBar

local function stylePropertyChanged()
	print("スタイルプロパティが変更されました！")
end

meterBar:GetStyledPropertyChangedSignal("AnchorPoint"):Connect(stylePropertyChanged)
```


Instance:GetStyledPropertyChangedSignal

property

変更を監視するスタイルプロパティの名前です。


指定されたスタイルプロパティが変更されたときに発火するイベントです。


このメソッドは、指定されたインスタンスに適用されたすべてのタグを文字列として配列で返します。スタジオで [プロパティ](/studio/properties) ウィンドウを使用して、または実行時に `Class.Instance:AddTag()|AddTag()` を使用してタグを追加できます。

このメソッドは、インスタンス上の複数のタグを一度に操作したい場合に便利です。しかし、単一のタグの存在を確認するためにこのメソッドを使用するのは効率が悪いため、特定のタグを確認するには `Class.Instance:HasTag()|HasTag()` を使用してください。


Instance:GetTags

インスタンスに適用されたすべてのタグの配列を取得します。


このメソッドは、指定されたタグがオブジェクトに追加された場合は `true` を返します。スタジオで [プロパティ](/studio/properties) ウィンドウを使用して、または実行時に `Class.Instance:AddTag()|AddTag()` を使用してタグを追加できます。


Instance:HasTag

インスタンスが指定されたタグを持つかどうかを確認します。


この例は、`Class.Instance:IsAncestorOf()`を使用して、一つのインスタンスが他のインスタンスの祖先であるかどうかを判定する方法を示しています。

WorkspaceとSpawnLocationは、SpawnLocationのデカールの祖先です。
WorkspaceはSpawnLocationの祖先です。

SpawnLocationとそのデカールはWorkspaceの子孫であり、祖先ではありません。
デカールはSpawnLocationの子孫であり、祖先ではありません。

`Class.Instance` が指定された子孫の祖先である場合は `true` を返します。

`Class.Instance` はオブジェクトの祖先と見なされます。このオブジェクトの `Class.Instance.Parent` または親のどれか一つの `Class.Instance.Parent` が `Class.Instance` に設定されている場合です。

`Class.Instance:IsDescendantOf()` も参照してください。


Instance:IsAncestorOf

指定された子孫の祖先が `Class.Instance` である場合は `true` です。


`Class.Instance` が指定された子孫の祖先であるかどうかを返します。


指定された祖先の `Class.Instance` が子孫である場合は `true` を返します。

`IsDescendantOf()` は `nil` のパラメータと共に使用して、オブジェクトが削除されているかどうかを確認することはできないことに注意してください。

`Class.Instance:IsAncestorOf()` も参照してください。


Instance:IsDescendantOf

ancestor

指定された祖先の `Class.Instance` が子孫である場合は `true` です。


指定された祖先の `Class.Instance` が子孫である場合は `true` を返します。


Instance:isDescendantOf

このメソッドは、特定のプロパティがコードインスタンスによるデフォルトから変更されたかどうかを示します。コードを介して新たに作成されたインスタンスに対して呼び出されると、`false` が返されます。スタジオ作業フローによって新しく作成されたオブジェクトに対して呼び出されると、結果が異なる場合があります。

例えば、[Explorer](/studio/explorer) ウィンドウを介して挿入された `Class.TextLabel.BackgroundColor3|BackgroundColor3` プロパティを照会すると `true` が返されますが、`Datatype.Instance.new()` によって作成された `Class.TextLabel` の同じプロパティを照会すると、他に何も変更されていないことを前提に `false` が返されます。

このメソッドが `true` を返す場合、スタイリングはプロパティには **影響しません**。なぜなら、プロパティの明示的な変更がスタイリングよりも優先されるからです。プロパティをコードの初期状態にリセットしてスタイリングを許可するには、`Class.Instance:ResetPropertyToDefault()|ResetPropertyToDefault()` を使用してください。


Instance:IsPropertyModified

このプロパティがコードの初期状態から変更されている場合のブール値。


指定されたプロパティに格納されている値がコードインスタンスのデフォルトと等しくない場合 `true` を返します。


このオブジェクトメソッドは、指定された `selector` 文字列に一致するオブジェクトの子孫を含む配列を返します。`selector` 文字列には、クラス名、インスタンス名、階層関係、インスタンスのプロパティや属性の特定の値などの特性と一致する、複数のセレクタやコンビネータを含めることができます。`selector` 文法は `Class.StyleRule` で使用される文法に似ていますが、サポートされている文法の部分に関しては若干の違いがあります。

##### セレクタ

<table>
<thead>
  <tr>
    <th>セレクタ</th>
    <th>説明</th>
    <th>例</th>
  </tr>
</thead>
<tbody>
  <tr>
    <td><code>ClassName</code></td>
    <td>指定されたクラスのインスタンスに一致します。<code>Class.Object:IsA()</code> 関係において。</td>
    <td><code>SpotLight</code><br /><code>ImageButton</code><br /><code>Part</code></td>
  </tr>
  <tr>
    <td><code>.Tag</code></td>
    <td>指定された <code>Class.CollectionService</code> タグの付いたインスタンスに一致します。</td>
    <td><code>.Fruit</code><br /><code>.IntenseLight</code></td>
  </tr>
  <tr>
    <td><code>#Name</code></td>
    <td>特定の <code>Class.Instance.Name</code> のインスタンスに一致します。</td>
    <td><code>#RedTree</code><br /><code>#CloseButton</code></td>
  </tr>
  <tr>
    <td><code>[property = value]</code></td>
    <td>指定されたプロパティが存在し、そのプロパティが指定された値を持つインスタンスに一致します。ブール、数値、および文字列値がサポートされます。文字、数字、<code>_</code>、および <code>-</code>は、値を引用符で囲まずに使用できます。
    </td>
    <td><code>[CanCollide = false]</code><br />
    <code>[Brightness = "0.5"]</code><br />
    <code>[Name = Folder10]</code><br />
    <code>[Name = "Part.10"]</code></td>
  </tr>
  <tr>
    <td width="30%"><code>[$attribute = value]</code></td>
    <td>指定された属性が存在し、その属性が指定された値を持つインスタンスに一致します。プロパティセレクタの場合と同じ制限が適用されます。</td>
    <td width="30%"><code>[$MyAttribute = 10]</code></td>
  </tr>
</tbody>
</table>

セレクタは組み合わせることができます。たとえば、`Model.Apple[$Kind = "Red"][$State = 4]` は、`Class.Model` であり、タグ `Apple` が設定され、`Kind` 属性が文字列 `"Red"` と等しく、`State` 属性が `4` と等しいインスタンスと一致します。

##### コンビネータ

<table>
<thead>
  <tr>
    <th>コンビネータ</th>
    <th>説明</th>
    <th>例</th>
  </tr>
</thead>
<tbody>
  <tr>
    <td><code>&gt;</code></td>
    <td>前のフィルタ一致の <b>直接の子供</b> と一致します。</td>
    <td><code>Part &gt; .SwordHandle</code></td>
  </tr>
  <tr>
    <td><code>&gt;&gt;</code></td>
    <td>前のフィルタ一致の <b>子孫</b> と一致します。</td>
    <td><code>Model &gt;&gt; .TreeOnFire</code></td>
  </tr>
  <tr>
    <td width="10%"><code>,</code></td>
    <td>子孫クエリのための複数の独立したセレクタのリストを指定します。</td>
    <td width="50%"><code>Part.TagA, Part[$UseForce = true]</code></td>
  </tr>
</tbody>
</table>

デフォルトの最初のフィルタは子孫のコンビネータ `>>` です。セレクタが `>` で始まる場合、直接の子供のみが訪問されます。例えば、`>Part.Apple` は `Class.Part` であり、タグ `Apple` が設定されている **直接の子供** を選択します。

デフォルトのコンビネータも明示的に指定できます。このように、`>>SpotLight.Red` は `SpotLight.Red` と同じです。

フィルタに一致する要素のみが配列に配置されます。たとえば、`>#ExistingChild, >#MissingChild, >#AnotherExistingChild` は2つの要素を含む配列を返し、欠落している子供の `nil` はありません。


Instance:QueryDescendants

selector

要素をフィルタリングするために使用されるセレクタ文字列。


インスタンスの配列（フィルタに一致しない場合は空）です。


次のコードは、削除された後にパートをDataModelに再追加する方法を示しています:

このメソッドは、オブジェクトの `Class.Instance.Parent` を `nil` に設定し、そのすべての子孫に対しても同様の操作を行います。

オブジェクトが削除される前に参照されている場合、後でオブジェクトを取得することができます。


Instance:Remove

オブジェクトの `Parent` を `nil` に設定し、そのすべての子孫に対しても同様の操作を行います。


Instance:remove

このメソッドはインスタンスからタグを削除します。オブジェクトがそのタグを持っていなくてもエラーはスローされません。タグを正常に削除すると、指定されたタグで `Class.CollectionService:GetInstanceRemovedSignal()` によって生成された信号が発火します。

インスタンスにタグを付ける際には、タグの機能を提供するためにいくつかのリソースが使用されることが一般的です。たとえば、イベント接続やテーブルです。メモリリークを防ぐために、タグがもはや必要でなくなった場合は、これらをクリーンアップする（切断、`nil`に設定など）ことをお勧めします。

Instance:RemoveTag

インスタンスからタグを削除します。

プロパティをデフォルト値にリセットします。たとえば、`Class.TextLabel`の `ResetPropertyToDefault("Rotation")` を呼び出すことは、その `Class.TextLabel.Rotation|Rotation` を `0` （プロパティのデフォルト値）に設定するのと同じです。このメソッドは、スタイル設定がこのプロパティのデフォルト値を上書きすることを保証するために使用できます。

Instance:ResetPropertyToDefault

リセットするプロパティの名前。

プロパティをデフォルト値にリセットします。

このメソッドは、指定された名前の属性を指定された値に設定します。指定された値が `nil` の場合、デフォルトで `nil` が返されるため、属性が削除されます。

たとえば、次のコードスニペットは、インスタンスの `InitialPosition` 属性を `Datatype.Vector3|Vector3.new(0, 10, 0)` に設定します：

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

local part = Workspace.Part
part:SetAttribute("InitialPosition", Vector3.new(0, 10, 0))
```

##### 制限事項

名前付けの要件と制限：

- 名前はアルファベットと数字のみを使用する必要があります。
  - ピリオド、ハイフン、スラッシュ、アンダースコアも含めることができます。
- スペースやユニークな記号（@、~、！など）は許可されていません。
- 文字列は100文字以下でなければなりません。
- 名前は **RBX** で始めることはできません。ただし、呼び出し元がRobloxのコアスクリプト（Roblox専用）である場合は例外です。

サポートされていない型の属性を設定しようとすると、エラーが発生します。

##### 参照

- `Class.Instance:GetAttribute()` は、指定された属性名に割り当てられた値を返します。
- `Class.Instance:GetAttributes()` は、インスタンスの属性のキーと値のペアの辞書を返します。

Instance:SetAttribute

value

指定された属性に設定する値。

指定した名前の属性を指定した値に設定します。

以下のコードは、"Part"という名前のインスタンスが
Workspaceに追加されるのを待ちます。

指定された名前の `Class.Instance` の子を返します。子が存在しない場合、存在するまで現在のスレッドを待機します。`timeOut` パラメータが指定されている場合、このメソッドは指定された秒数後にタイムアウトし、`nil` を返します。

##### 主な使用法

`Class.Instance:WaitForChild()|WaitForChild()` は、`Class.LocalScript`でクライアント実行のコードを作成する際に非常に重要です。Robloxエンジンは、サーバーからクライアントにオブジェクトが複製される時間や順序を保証しません。さらに、`Class.Workspace.StreamingEnabled` が `true` に設定されている場合、プレイヤーのキャラクターから遠くにある `Class.BasePart|BaseParts` はクライアントにストリーミングされない場合があり、まだクライアントに存在しないオブジェクトをインデックスするとスクリプトが壊れる可能性があります。

##### 注意

- このメソッドは、呼び出し時に指定された名前の子が存在する場合は待機しません。
- `Class.Instance:FindFirstChild()` は、存在すると想定されるオブジェクトに対して `Class.Instance:WaitForChild()|WaitForChild()` のより効率的な代替手段です。
- このメソッドの呼び出しが5秒を超えて返されない場合、`timeOut` パラメータが指定されていないと、スレッドが無限に待機している可能性があるという警告が出力に表示されます。

Instance:WaitForChild

childName

timeOut

オプションのタイムアウトパラメータ。

指定された名前の `Class.Instance` の子を返します。子が存在しない場合、存在するまで現在のスレッドを待機します。

Instance

このプロパティは、エクスペリエンスが公開または保存されるとき、または `Class.Instance:Clone()|Clone()` がインスタンスの祖先の一つに対して呼び出されたときに、インスタンスを含めるべきかどうかを決定します。インスタンスに対して直接 `Class.Instance:Clone()|Clone()` を呼び出すと、そのインスタンスが **ない** `Class.Instance.Archivable|Archivable` の場合、`nil` が返されます。

スタジオで **複製** または **コピー**/**ペースト** オプションを使用してオブジェクトをコピーすると、そのオブジェクトの `Class.Instance.Archivable|Archivable` プロパティを無視し、コピーの `Class.Instance.Archivable|Archivable` を `true` に設定します。

```
local part = Instance.new("Part")
print(part:Clone())  --> Part
part.Archivable = false
print(part:Clone())  --> nil
```


Instance.Archivable

`Class.Instance` とその子孫を `Class.Instance:Clone()` を使ってクローンできるかどうか、または保存/公開できるかどうかを決定します。


Instance.archivable

このインスタンス内のスクリプトに許可されている機能のセット。機能を有効にするには、`Class.Instance.Sandboxed` プロパティを有効にする必要があります。

このプロパティは実験的な機能によって使用されます。詳細は [スクリプト機能](/scripting/capabilities) を参照してください。


Instance.Capabilities

このコンテナ内のスクリプトに許可されている機能のセット。


`Class.Instance` の非一意の識別子。名前はオブジェクト階層を整理し、スクリプトが特定のオブジェクトにアクセスできるようにするために使用されます。インスタンスの名前は最大 100 文字に制限されています。

オブジェクトの名前は、以下の方法を使用してデータモデル階層を通じてオブジェクトにアクセスするために頻繁に使用されます。

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

local baseplate = Workspace.Baseplate
local baseplate = Workspace["Baseplate"]
local baseplate = Workspace:FindFirstChild("BasePlate")
```
ドット演算子（`.`）を使用してオブジェクトにアクセス可能にするためには、名前はアンダースコアまたは文字で始める必要があり、名前の残りの部分には文字、数字、アンダースコアのみを含むことができ（他の特殊文字は不可）、この構文に従わないオブジェクトの名前はドット演算子を使用してアクセスできず、Luau はその名前を識別子として解釈しません。

同じ名前のオブジェクトが兄弟に存在する場合、その名前でオブジェクトにインデックスを付ける試みは、そのオブジェクトのいずれか一つだけを返し、`Class.Instance:FindFirstChild()` に似た動作をしますが、必ずしも希望のオブジェクトを返すとは限りません。特定のオブジェクトにコードを通じてアクセスする必要がある場合、そのオブジェクトにユニークな名前を付けるか、それと同じ名前を共有する兄弟がいないことを保証することをお勧めします。

`Class.Instance:GetFullName()` を参照して、オブジェクトの階層を含むフルネームを取得してください。


Instance.Name

`Class.Instance` の非一意の識別子。


`Parent` プロパティは `Class.Instance` の階層親を決定します。このプロパティが設定される方法について話すときによく使用される用語は次のとおりです：

- オブジェクトの `Parent` がそのオブジェクトに設定されている場合、そのオブジェクトは他のオブジェクトの **子** であるか、**親にされている** ということです。

- `Class.Instance` の **子孫** は、そのオブジェクトの子およびその子の子孫を含みます。

- `Class.Instance` の **祖先** は、インスタンスが子孫であるすべてのオブジェクトです。

`Parent` プロパティからは、`Class.Instance:GetChildren()|GetChildren()` や `Class.Instance:FindFirstChild()|FindFirstChild()` のような多くの他の API メンバーが名前を取得します。このプロパティは、オブジェクトがエクスペリエンス内に存在するか、削除する必要があるかを管理するためにも使用されます。オブジェクトの親が `Class.DataModel` 内にあり、変数に保存されているか、他のオブジェクトのプロパティによって参照されている限り、そのオブジェクトはエクスペリエンス内にとどまり、そうでなければ、そのオブジェクトは自動的に削除されます。

`Class.Instance:Destroy()|Destroy()` を呼び出すと、`Class.Instance` およびそのすべての子孫の `Parent` が `nil` に設定され、`Parent` プロパティが **ロック** されます。破棄されたオブジェクトの `Parent` を設定する際にエラーが発生します。

`Datatype.Instance.new()` を使用して作成された新しいオブジェクトは親を持たず、通常は一旦セットされるまで可視でなく機能しません。

##### オブジェクトの複製

サーバーによって作成されたオブジェクトは、複製されたオブジェクトに親付けされるまでクライアントに複製されません。オブジェクトを作成し、多くのプロパティを設定する際は、`Parent` プロパティを **最後に** 設定することが推奨されます。これにより、オブジェクトが1回だけ複製され、多くのプロパティ変更の複製を避けることができます。

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

-- 新しいインスタンスの親を最後に設定する（推奨）
local part = Instance.new("Part")
part.Position = Vector3.new(0, 10, 0)
part.Parent = Workspace
```
ただし、親付けされる前に親が設定されていない `Class.Model` にパーツを親付けする場合、そのモデルの各パーツを親付けすることは許容されます。


Instance.Parent

`Class.Instance` の階層親を決定します。


このプロパティは、ユーザーが権限のない方法で `Class.CoreGui` サービス内のオブジェクトを変更できないように保護していました。しかし、非推奨となり、何も機能しません。


Instance.RobloxLocked

`Class.CoreGui` オブジェクトを保護するために使用されていた非推奨のプロパティ。


`Instance` は Roblox クラス階層のすべてのクラスの基本クラスであり、`Class.DataModel` ツリーの一部である可能性があります。


/reference/engine/classes/VideoCaptureService.yaml

VideoCaptureService

概要

プロパティ

方法

イベント

プロパティ

方法

イベント

ページ内容