`Class.AudioEmitter` 世界にオーディオストリームを送信します。1つまたは複数の **** に接続できる単一の `Class.Wire|Wires` ピンを提供します。どのストリームも、エミッタの親の位置から世界に放送されます。 `Class.AudioEmitter`親が `Class.Attachment` 、`Class.Camera` 、または `Class.PVInstance` の場合、親の世界位置が使用されます。親がこれらのクラスの 1 つでない場合、`Class.AudioEmitter` は効果的に静止します。

  `Class.AudioEmitter|AudioEmitters` は、3D 空間化を実装するために `Class.AudioListener|AudioListeners` によって聞かれます。

`Class.Wire` が接続または切断された後に発生するイベント、および `Class.Wire` が現在または以前に `Class.AudioEmitter` および他のワイヤー可能なインスタンスのピンに接続されているか、接続されていました。

AudioEmitter.WiringChanged

connected

インスタンスが接続されたか、切断されたか。

ターゲットの `Class.AudioEmitter` にピンを打った `Class.Wire` 。

wire

`Class.Wire` と他のインスタンスの間の `Class.AudioEmitter` 。

instance

`Class.Wire` を介して接続された他のインスタンス。

別のインスタンスが を介して接続されたり、切断されたりしたときに発火します。

テーブルマッピング角をボリュームに返します。キーは `0` と `180` （含む）の間の数字であり、値は `0` と `1` （含む）の間の数字で、ボリュームが方向に応じて衰減する方法を説明します。このメソッドは、デフォルトの角消去曲線が使用されている場合、空のテーブルを返します。

AudioEmitter:GetAngleAttenuation

上記のように、テーブルマッピング角をボリュームにマッピングします。

`Class.AudioEmitter` が使用している角消失曲線を取得するか、デフォルトの曲線を使用している場合は空のテーブルを取得します。

特定の `Class.AudioListener` に対して、このエミッターがどれほど聞こえるかを計算します。結果のボリューム、`0` から `1` までの範囲は、エミッターとリスナーの両方で距離と角度の衰減をカバーします。

AudioEmitter:GetAudibilityFor

listener

特定の `Class.AudioListener` に対して、このエミッターがどれほど聞こえるかを計算します。

指定されたピンに接続された `Class.Wire|Wires` のアレイを返します。`Class.AudioEmitter` には「入力」ピンが 1 つあります。

AudioEmitter:GetConnectedWires

指定されたピンに接続された `Class.Wire|Wires` のアレイを返します。

テーブルマッピング距離をボリュームに返す。キーは 0 より大きいまたは等しい数字であり、値は 0 から 1（含む）の間の数字で、ボリュームが距離を通じて衰減する方法を説明します。このメソッドは、デフォルトの距離衰減曲線が使用されている場合、空のテーブルを返します。

AudioEmitter:GetDistanceAttenuation

`Class.AudioEmitter` が使用している距離衰減曲線またはデフォルトの曲線を使用している場合は空のテーブルを取得します。

AudioEmitter:GetInputPins

エミッターと共有する を持つアレイを返します。

AudioEmitter:GetInteractingListeners

このエミッターを聞くことができるすべての `Class.AudioListener|AudioListeners` をリストします。

AudioEmitter:GetOutputPins

\[角度] と \[角度] の間の角度に基づいて、`Class.AudioListener` が `Class.AudioEmitter` をどれほど大声で聞くかに影響を与える音量-角度曲線を設定します。これは、`Datatype.CFrame.LookVector|LookVector` と関連付けられた `Class.AudioEmitter` に基づいています。

  カーブは、テーブルマッピング角キーをボリューム値にマッピングして表現されます。キーは `0` と `180` （含む）の間のユニークな数字であることが期待され、値は `0` と `1` （含む）の間の数字であることが期待されます。最大 400のキーバリューペアを含むテーブルがサポートされます。

  からの角度の曲線のポイントのボリュームレベルの線形インターポレーションにより、角度値が直接上下にある曲線のポイントのボリュームレベルの間で線形インターポレーションにより決定されます。下の `a` または上の `a` にポイントがない場合、他のポイントのボリュームレベルが選択されます。本質的に、カーブは直線で結ばれたポイントの連続体であり、左右の端点を超えて、それぞれのボリュームレベルでカーブが外側に広がります。

  このボリュームは、すべての他の衰減曲線 (受信 `Class.AudioListener` を含む) のボリュームと乗算されて、最終的な聴覚を得ることになります。

  テーブルが空または である場合、 は、定期的なボリューム値の角減衰曲線を使用するようにデフォルト設定されます。

AudioEmitter:SetAngleAttenuation

curve

が使用するべき角減衰曲線を設定するか、提供されない場合はボリュームの定数曲線を使用します。

彼らの間の距離に基づいて、どれほど大声で `Class.AudioListener` が `Class.AudioEmitter` を聞くかに影響を与えるボリューム-オーバー-距離曲線を設定します。

  カーブは、テーブルマッピング距離キーをボリューム値にマップすることで表現されます。キーは 0 より大きいか等しいユニークな数字であることが期待され、値は 0 から 1（含む）の間の数字であることが期待されます。最大 400のキーバリューペアを含むテーブルがサポートされます。

  距離 からの曲線のポイントのボリュームレベルの線形インターポレーションにより、ボリュームの量が決定します。距離値が直接上下にある曲線のポイントのボリュームレベルの間で線形インターポレーションを行います。下の `d` または上の `d` にポイントがない場合、他のポイントのボリュームレベルが選択されます。本質的に、カーブは直線で結ばれたポイントの連続であり、左右の端点を超えて、それぞれのボリュームレベルで無限に外側に広がります。

  このボリュームは、すべての他の衰減曲線 (受信 `Class.AudioListener` を含む) のボリュームと乗算されて、最終的な聴覚を得ることになります。

  テーブルが空であるか、`nil` である場合、`Class.AudioEmitter` は逆方向の法則によって決定された距離衰減曲線を使用するデフォルトになります。

AudioEmitter:SetDistanceAttenuation

`Class.AudioEmitter` が使用する距離衰減曲線を設定するか、提供されない場合は逆のロールオフ曲線を使用します。

AudioEmitter

Represents a volume-over-angle curve that affects how loudly a `Class.AudioListener` will hear the `Class.AudioEmitter` , based on the angle between them and the `Datatype.CFrame.LookVector|LookVector` 関連する `Class.AudioEmitter` .

  このプロパティは内部であり、スクリプトでアクセスできません;レプリケーションをサポートするために存在します。使用詳細は、`Class.AudioEmitter:SetAngleAttenuation()|SetAngleAttenuation()` を参照してください。

AudioEmitter.AngleAttenuation

放射された音の感じられる音量が、`Class.AudioListener` と関連する角度に基づいて変化する方法を表示します。Represents how the perceived volume of the emitted sound changes based on the angle between a   and the `Datatype.CFrame.LookVector|LookVector` associated with the `Class.AudioEmitter` .

と が相互作用グループを共有する場合、リスナーは送信者を聞くことができます。

AudioEmitter.AudioInteractionGroup

これを聞くことができるコントロール 。

彼らの間の距離に基づいて、 がどれほど大声で聞こえるかに影響を与えるボリューム-オーバー-ディスタンス曲線を表示します。

  このプロパティは内部であり、スクリプトでアクセスできません;レプリケーションをサポートするために存在します。使用詳細は、`Class.AudioEmitter:SetDistanceAttenuation()|SetDistanceAttenuation()` を参照してください。

AudioEmitter.DistanceAttenuation

放射された音の感知されるボリュームが、`Class.AudioListener` と `Class.AudioEmitter` の距離が増加するにつれて変化する方法を表します。

この `Class.AudioEmitter` 、`Class.MeshPart.CollisionFidelity` または `Class.MeshPart.RenderFidelity` と同様に、オーディオシミュレーションの詳細度を制御します。

  `Class.AudioEmitter|AudioEmitters` と `Class.AudioListener|AudioListeners` は、必要な詳細レベルに同意しないオプションを使用します。

AudioEmitter.SimulationFidelity

この `Class.AudioEmitter` に対するオーディオシミュレーションの詳細度を制御します。

世界にオーディオストリームを送信します。

`Instance` は、`Class.DataModel` ツリーの一部である Roblox クラス階層のすべてのクラスのベースクラスです。

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

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

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

オブジェクトの `Class.Instance.Parent` プロパティまたは祖先の 1 つが変更されると、炎が発生します。

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

  このイベントを使用して、Explorer での手動削除やプラグインを介した削除など、Studio でインスタンスの削除を追跡できます。インスタンスが `Class.Instance:Destroy()` を使用して破壊されたときに検出する必要がある場合は、代わりに `Class.Instance.Destroying` イベントを使用します。

Instance.AncestryChanged

child

変更された `Class.Instance` の whose `Class.Instance.Parent` は変更されました。

parent

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

オブジェクトの `Class.Instance.Parent` プロパティまたは祖先の 1 つが変更されると、炎が発生します。

このイベントは、アトリビュートが `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` で変更されるたびに発火します。

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

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

  この機能をクライアントで使用して、サーバーによって作成されたオブジェクトを検出するときは、これらのオブジェクトの子孫をインデックスするときに `Class.Instance:WaitForChild()` を使用する必要があります。これは、オブジェクトとその子孫が同時にサーバーからクライアントに複製されることは保証されていないためです。例えば:

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

  Workspace.ChildAdded:Connect(function(child)
  	-- Use WaitForChild() since descendants may not have replicated yet
  	local head = child:WaitForChild("Head")
  end)
  ```

  注: この機能は、`Class.Instance` の直接の子供にのみ作動します。すべての子孫をキャプチャする機能を使用するには、`Class.Instance.DescendantAdded` を使用します。

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

Instance.ChildAdded

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

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

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

  削除は、オブジェクトの親がこの からこれ以外のものに変更されたときを指します。注: このイベントは、子供が破壊されたとき(`Class.Instance:Destroy()` を使用して)、破壊機能がオブジェクトの親を `nil` に設定するときにも発動します。

  この機能は、`Class.Instance` の直接の子供にのみ作動します。すべての子孫をキャプチャする機能を使用するには、`Class.Instance.DescendantRemoving` を使用します。

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

Instance.ChildRemoved

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

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

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

  すべての子孫に発射すると、オブジェクトを親にすると、このオブジェクトとすべての子孫が個別にイベントを発射します。

  If you're only concerned with the **直接の子供** of the `Class.Instance` , use `Class.Instance.ChildAdded` instead.

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

Instance.DescendantAdded

descendant

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

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

このイベントは、親の **変更** が行われる直前に `Class.Instance` 発動し、 **後継者** インスタンスがもはや後継者ではなくなります。`Class.Instance:Destroy()|Destroy()` は、インスタンスの `Class.Instance.Parent|Parent` を `nil` に変更し、親の子孫にこのメソッドを呼ぶと、このイベントが発動します。

  このイベントは、子孫の削除の前に 発射されるため、このイベント発射時に親子孫の親は変更されません。子孫が親の直接の子供でもある場合、このイベントは より前に発動します。

  子孫に子供がいる場合、このイベントはまず子孫が発射し、その子孫を続けます。

  ##### 注意

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

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

  Workspace.DescendantRemoving:Connect(function(descendant)
  	-- Do not manipulate the parent of the descendant in this function!
  	-- This event fires BECAUSE the parent was manipulated, and the change hasn't happened yet
  	-- Therefore, it is problematic to change the parent like this:
  	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` の後継者が削除される直前に即座に発火します。

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

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

接続された関数がまだ使用している間、`Class.Instance` はメモリから削除されることはありません。しかし、機能がどこかで引き出された場合、`Class.Instance` とその子孫は`nil` に親属することになります。

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

  プロパティが に設定されている場合、このイベントは次の再開ポイントで発動し、それは またはその祖先の 1つが で破壊される後です。

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

  Studio で `Class.Instance` を削除するとき、手動で [エクスプローラー](/studio/explorer) を通じて削除するか、プラグインを通じて削除すると、`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("Styled properties changed")
  end

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

Instance.StyledPropertiesChanged

インスタンス上で任意のスタイルプロパティが変更されるたびに発火し、プロパティが `nil` に設定されている場合を含めます。

Instance.childAdded

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

  ##### 注意

  *   サーバーが後で、サーバーがすべてのタグを複製して前のタグを上書きするため、クライアント側に追加されたインスタンスのタグが削除されます。An instance's tags that were added client-side will be dropped if the server later adds or removes a tag on that instance because the server replicates all tags together and overwrites previous tags.

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

Instance:AddTag

インスタンスにタグを付与します。

この関数は、インスタンスの子供と孫すべてを破壊します。

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

  -- Add some sparkles
  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()` を使用します。たとえば、次のコードサンプルは、 から下にすべてを破壊します：

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

この機能は、インスタンスのすべての子を破壊します。

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

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

  参照プロパティ (例: `Class.ObjectValue.Value`) がクローンインスタンスに設定された場合、コピーのプロパティの値はオリジナルの値に依存します:

  *   参照プロパティが **も** クローンされたインスタンスを参照している場合、コピーはコピーに参照します。
  *   参照プロパティが **クローンされなかったオブジェクトを参照している場合、コピーに同じ値が保持されます** 。

Instance:Clone

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

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

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

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

  不要なオブジェクトの処分は重要であり、場所の不要なオブジェクトと接続は、時間経過により深刻なパフォーマンスの問題につながる可能性があるメモリを使用します。

  オブジェクトを呼び出した後のベストプラクティスとして、オブジェクト (またはその子孫) を参照するすべての変数を に設定します。これにより、コードがオブジェクトに関連するものにアクセスできなくなります。

  ```lua
  local part = Instance.new("Part")
  part.Name = "Hello, world"
  part:Destroy()
  -- これはしないでください：
  print(part.Name)  --> "Hello, 世界 "
  -- 上の行が機能しないようにするには、次の手順を実行してください：
  part = nil
  ```

  このメソッドで `Class.Instance` が破壊されたら、`Class.Instance.Parent` プロパティがロックされて再使用できなくなります。To **一時的に** 破壊するのではなく、オブジェクトを削除せずに、`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()` を呼び出します。

返す 最初の祖先の の が指定された名前と同じである の 最初の祖先。

  この機能は上向きで、つまりインスタンスの直接的な `Class.Instance.Parent` から始まり、`Class.DataModel` に向かって作動します。一致する祖先が見つからない場合、`nil` を返します。

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

  ```
  local car = object:FindFirstAncestor("Car")
  ```

  特定のクラスの祖先を見つけるこの機能のバリアントについては、`Class.Instance:FindFirstAncestorOfClass()` および `Class.Instance:FindFirstAncestorWhichIsA()` を参照してください。

Instance:FindFirstAncestor

name

返す 最初の祖先の の が指定された名前と同じである の 最初の祖先。

返すのは、`Class.Instance` の最初の祖先で、`Class.Object.ClassName` が指定された classNameと同等のもの。

  この機能は上向きで、つまりインスタンスの直接的な `Class.Instance.Parent` から始まり、`Class.DataModel` に向かって作動します。一致する祖先が見つからない場合、`nil` を返します。

  この機能の一般的な使用は、`Class.Model` に属する `Class.BasePart` を見つけることです。例えば:

  ```
  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.Object.ClassName` が指定された classNameと同等のもの。

返す 最初の祖先の `Class.Instance` について、`Class.Object:IsA()` が指定された className に対して true を返します。

  この機能は上向きで、つまりインスタンスの直接的な `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
  ```

  ただし、次のコードサンプルは、 、 、または であるかどうかにかかわらず、最初の祖先を返します。

  ```
  local part = object:FindFirstAncestorWhichIsA("BasePart")
  ```

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

Instance:FindFirstAncestorWhichIsA

返す 最初の祖先の `Class.Instance` について、`Class.Object:IsA()` が指定された className に対して true を返します。

以下は、ワークスペースで「ブリック」というオブジェクト名を検索します。見つかった場合、オブジェクト名を「フー」に変更します。

返す `Class.Instance` の最初の子供に、指定された名前を付け、または `nil` がそのような子供が存在しない場合。オプションの `recursive` 引数が `true` である場合、この関数は `Class.Instance` の直接の子供だけでなく、すべての子孫を検索します。

  ##### オブジェクトの存在をチェックする

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

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

  -- パーツがワークスペースに存在しない場合の次の行エラー
  Workspace.Part.Transparency = 0.5
  ```

  より良いアプローチは、`FindFirstChild()` を最初に `Part` をチェックし、その後 `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.Instance.Parent|Parent` のプロパティと同じです。ドット演算子を使用すると、名前を共有している場合、プロパティが子供より優先されます。

  次の例では、`Class.Folder` と呼ばれる `Color` が `Class.Part` に追加され、これにも `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")  -- The child folder
  ```

  ##### 性能の注意事項

  `Class.Instance:FindFirstChild()|FindFirstChild()` はドット演算子を使用するより約 20% 長く、オブジェクトへの参照を保存するよりもほぼ 8 倍長くかかります。そのため、緊密なループまたは `Class.RunService.Heartbeat` および `Class.RunService.PreRender` に接続された関数などのパフォーマンスに依存するコードで呼び出すべきではありません。代わりに、結果を変数に保存するか、`Class.Instance.ChildAdded|ChildAdded` または `Class.Instance:WaitForChild()|WaitForChild()` を使用して、指定された名前の子が利用可能になったときを検出する方法を検討します。

Instance:FindFirstChild

recursive

検索が再帰的に実行されるかどうか。

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

返す最初の子供の の が指定された と同じである 最初の子供の 。`Class.Instance:FindFirstChildWhichIsA()` とは異なり、この関数はクラスの相続を無視して、クラスの属性が `className` に一致するオブジェクトのみを返します。一致する子供が見つからない場合、この関数は `nil` を返します。

Instance:FindFirstChildOfClass

返すのは、 の最初の子供で、 が指定されたクラス名と同じの 。

`Class.Instance` に対する最初の子供を返し、`Class.Object:IsA()` が指定された className に対して true を返します。

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

  `Class.Instance:FindFirstChildOfClass()` とは異なり、この関数はクラスの継承を尊重する `Class.Object:IsA()` を使用します。たとえば:

  ```lua
  print(part:IsA("Part")) --> 真
  print(part:IsA("BasePart")) --> 真
  print(part:IsA("Instance")) --> true
  ```

  そのため、次のコードサンプルは、 、 、または であるかどうかにかかわらず、最初の子供を返します。

  ```
  local part = object:FindFirstChildWhichIsA("BasePart")
  ```

  名前で子を検索している開発者は、代わりに `Class.Instance:FindFirstChild()` を使用する必要があります。

Instance:FindFirstChildWhichIsA

`Class.Instance` に対する最初の子供を返し、`Class.Object:IsA()` が指定された className に対して true を返します。

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

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

Instance:FindFirstDescendant

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

If the `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)
  ```

  ##### 参照してください： See Also

  *   `Class.Instance:SetAttribute()` が、指定された名前の属性を指定された値に設定します。
  *   `Class.Instance:GetAttributes()` は、インスタンスの属性ごとにキー-バリューペアの辞書を返す。

Instance:GetAttribute

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

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

この機能は、特定の指定された属性が変更されるときにのみ発動するなど、`Class.Object.Changed|Changed` イベントと同じように動作するイベントを返しますが、属性に関しては効果的に `Class.Object:GetPropertyChangedSignal()|GetPropertyChangedSignal()` と同じです。

  一般的に、このメソッドを使用して、属性名をチェックする機能で `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

文字列が属性の名前であり、変体が非ゼロ値である各属性のストリング → 変体のペアの辞書。

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

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

すべてのインスタンスの直接の子供を含む配列 (数字でインデックス化されたテーブル) または、オブジェクトと同じ `Class.Instance` のすべての `Class.Instance.Parent|Parent` を含む返すアレイを返します。配列は、数字または一般的な forループを使用して循環できます：

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

  -- 数字のフォーループ例
  local children = Workspace:GetChildren()
  for i = 1, #children do
  	local child = children[i]
  	print(child.Name .. " is child number " .. i)
  end
  ```

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

  -- 一般的な forループの例
  local children = Workspace:GetChildren()
  for i, child in children do
  	print(child.Name .. " is child number " .. i)
  end
  ```

  子供は、`Class.Instance.Parent|Parent` プロパティがオブジェクトに設定された順序でソートされます。

  また、`Class.Instance:GetDescendants()|GetDescendants` 機能も参照してください。

Instance:GetChildren

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

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

Roblox 内で使用されているデバッグ ID のコード化された文字列を返します。注意:

  *   このアイテムは保護されています。`Class.Script` または `Class.LocalScript` で使用しようとすると、エラーが発生します。
  *   デバッグID は、デバッグプロセスで使用される IDです。デバッガーがアプリケーションが処理する前に、それぞれの指示を読むことができます。Roblox のすべてのオブジェクトはプロセスとして機能し、必要に応じてデバッグできる各実行指示（または「コード」）を実行します。
  *   これは、同じ名前を共有するオブジェクトを区別する必要があるプラグインにとって有用である可能性があります (例: 同じ名前を共有するオブジェクト)。

Instance:GetDebugId

scopeLength

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

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

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

Instance:GetDescendants

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

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

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

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

インスタンスの祖先を説明する文字列を返します。文字列は、オブジェクトとその祖先の `Class.Instance.Name|Name` の連結で、期間で区切られています。The `Class.DataModel` ( `game` ) は考慮されません。たとえば、`Class.Part` 中の `Class.Workspace` は、`Class.Workspace.Part` を返す可能性があります。

  When called on an `Class.Instance` それは `Class.DataModel` の子孫ではない場合、この関数は、`Class.Instance.Parent|Parent` を含まないすべての祖先を考慮します。

  この機能は、ログとデバッグに便利です。返された文字列を任意の有用な操作に解析しようとしてはならない; この関数はオブジェクト名に期間 (またはその他のシンボル) を脱出しない。言い換えれば、出力はしばしば有効な Luau 識別子のように見えますが、保証されていません。

Instance:GetFullName

インスタンスの祖先を説明する文字列を返します。

このメソッドは、指定されたプロパティのスタイル付きまたは明示的に変更された値を返すか、スタイル/修正されていない場合はデフォルトのプロパティ値を返します。これは、`[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 (modified value)
  ```

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("Style property changed!")
  end

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

Instance:GetStyledPropertyChangedSignal

property

変更を検出するスタイルプロパティの名前。

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

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

  このメソッドは、インスタンスで一度に複数のタグを使用したいときに便利です。ただし、単一のタグの存在をチェックするためにこのメソッドを使用するのは非効率であり、代わりに `Class.Instance:HasTag()|HasTag()` を使用して特定のタグをチェックします。

Instance:GetTags

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

このメソッドは、提供されたタグがオブジェクトに追加された場合に `true` を返します。タグを追加できるのは、[プロパティ](/studio/properties) ウィンドウで Studio に、またはランタイムで `Class.Instance:AddTag()|AddTag()` です。

Instance:HasTag

インスタンスに指定されたタグがあるかどうかをチェックします。

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

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

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

`Class.Instance` が指定された後継者の祖先である場合、真を返します。

  はオブジェクトの祖先と見なされ、オブジェクトの またはその親の が に設定されている場合、その親の祖先と見なされます。

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

Instance:IsAncestorOf

`Class.Instance` が指定された後継者の祖先である場合は、真です。

`Class.Instance` が指定された後継者の祖先である場合、真を返します。

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

  注意: `IsDescendantOf()` は、オブジェクトが削除されたかどうかをチェックするために `nil` のパラメータを使用できません。

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

Instance:IsDescendantOf

ancestor

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

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

指定されたプロパティに保存された値がコードでインスタンス化されたデフォルトと同等の場合、`true` を返します。たとえば、出力の プロパティの が を指し示している場合、ラベルに を呼び出すと、ラベルが作成されるときに がデフォルト値になるため、スタジオの挿入ワークフローを介して挿入されるのではなく、ラベルを作成するときに が返されます。

  このメソッドが `true` を返す場合、スタイリングは **しません** プロパティを明示的に変更することが優先されるため、スタイリングに影響しません。

Instance:IsPropertyModified

プロパティが変更されているかどうかを示すブール。

指定されたプロパティに保存された値がコードでインスタンス化されたデフォルトと同等の場合、`true` を返します。

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

この機能は、オブジェクトの `Class.Instance.Parent` を `nil` に設定し、すべての子孫に同じことを行います。

  オブジェクトが削除される前に参照されると、後でオブジェクトを回収できます。

Instance:Remove

オブジェクトの `Parent` を `nil` に設定し、すべての子孫に同じことを行います。

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

  インスタンスをタグ付けするときは、タグの機能を提供するために、例えばイベント接続またはテーブルが使用されるのが一般的であることに注意してください。メモリ漏れを防ぐには、タグがもう必要ないときにこれらをクリーンアップする (接続を切断し、`nil` に設定など) が良い考えです。

Instance:RemoveTag

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

Instance

`Instance` は、`Class.DataModel` ツリーの一部である Roblox クラス階層のすべてのクラスのベースクラスです。

/reference/engine/classes/AudioEmitter.yaml

AudioEmitter

コードサンプル

概要

プロパティ

方法

イベント

プロパティ

方法

イベント