`Class.Actor` はコードを安全に独自のスレッドに分割できるようにするためのコンテナです。
`Library.task.desynchronize()` を使用しても安全です。また、スクリプトで使用されるインスタンスも含んでいる必要があります。

スクリプトのパフォーマンスを最適化するために複数の Actor を使用する方法については、
[Parallel Luau](/scripting/multithreading) を参照してください。

#### 注意事項

- 各 `Actor` は独自の Luau VM で実行されます。`Class.ModuleScript|ModuleScripts`
  は `Actor` ごとに **共有** または **キャッシュ** されません。
  各 VM はモジュールの独自のコピーを実行するため、モジュールレベルの状態は `Actor` ごとに分離されます。
  共有を意図する状態を持つモジュールの場合、設計に注意してください。
- `script:GetActor()` は `Class.ModuleScript` から呼び出された場合、
  `ModuleScript` が `Actor` の子孫でない限り `nil` を返します。
  他の場所に保存された `ModuleScripts`（たとえば、`Class.ReplicatedStorage`）であり、`Actor` に必要とされるものは
  `Actor` の子孫と見なされません。


このメソッドは、指定されたトピックを持つメッセージに Luau コールバックをバインドするために使用されます。メッセージが指定されたトピックに送信されると（`Class.Actor:SendMessage()|SendMessage()` を使用）、提供されたコールバックが _シリアル_ 実行コンテキストで呼び出されます。

複数の Luau コールバックを単一のアクターや単一のメッセージトピックにバインドすることができます。

注意: アクターの子孫であるスクリプトのみが、そのメッセージにバインドできます。

```lua
local actor = script:GetActor()

-- アクターに挨拶メッセージが送信されたときにメッセージを表示します
-- このスクリプトはアクターの子孫です。
local connection = actor:BindToMessage("Greeting", function(message)
  print("受信した挨拶メッセージ：", message)
end)
```

Actor:BindToMessage

topic

メッセージのタイプを識別するために使用されるトピックです。

function

この接続オブジェクトは、Luau コールバックをメッセージを受信することから切断するのに使用できます。

指定されたトピックを持つメッセージに Luau コールバックをバインドします。

このメソッドは、指定されたトピックを持つメッセージに Luau コールバックをバインドするために使用されます。メッセージが指定されたトピックに送信されると（`Class.Actor:SendMessage()|SendMessage()` を使用）、提供されたコールバックが _パラレル_ 実行コンテキストで呼び出されます。

複数の Luau コールバックを単一のアクターや単一のメッセージトピックにバインドすることができます。

注意: アクターの子孫であるスクリプトのみが、そのメッセージにバインドできます。

```lua
local actor = script:GetActor()

-- アクターに挨拶メッセージが送信されたときにメッセージを表示します
-- このスクリプトはアクターの子孫です。
local connection = actor:BindToMessageParallel("Greeting", function(message)
  print("受信した挨拶メッセージ：", message)
end)
```

Actor:BindToMessageParallel

Actor にメッセージを送信します。メッセージは非同期に送信されるため、
送信者は `Class.Actor:SendMessage()|SendMessage()` メソッドを呼び出す際にブロックや
待機することはありません。

単一の Actor が異なる種類のメッセージを受け取る可能性があるため、さまざまな種類のメッセージを区別するために、
`topic` パラメータが使用されます。

メッセージを受信する方法の詳細については、`Class.Actor:BindToMessage()|BindToMessage()` を参照してください。

メッセージ引数は **コピーによって渡され**、参照によっては渡されません。大きなテーブルを送信すると、
各呼び出しで完全なコピーが発生します。関数は特定の VM にバインドされており、メッセージ内で渡すことはできません。

```lua
-- `actor` が Actor インスタンスを参照するローカル変数であると仮定します
actor:SendMessage("Greeting", "Hello World")
```


Actor:SendMessage

送信されるメッセージを識別するために使用されるトピックです。

message

アクターに送信するメッセージの内容です。

アクターにメッセージを送信します。

Actor

`Class.Actor` は、コードを安全に独自のスレッドに分割できるコンテナです。

このサンプルには、オブジェクトのテーブルを受け取り、それを新しいモデルに親付けして、そのモデルを返す基本的な関数が含まれています。

モデルはコンテナオブジェクトであり、オブジェクトをまとめることを意味します。最適に使用するのは`Class.BasePart|BaseParts`のコレクションを保持することです。モデルはその機能を拡張するいくつかの関数を持っています。

モデルは**幾何学的**なグループ化を表すことを意図しています。グループ化に幾何学的解釈がない場合、例えば`Class.Script|Scripts`のコレクションの場合は、代わりに`Class.Folder`を使用してください。

構成部品がジョイントで接続されているモデル（物理シミュレーションを介して動かしたり破壊したりできるように）は通常、`Class.Model.PrimaryPart|PrimaryPart`が設定されており、モデルの移動に伴い、ピボットとバウンディングボックスが「フォロー」するどの部分であるかを指定します。静的モデルが1か所に留まる場合は、プライマリ部品を設定しても利点はありません。

モデルは広範囲な用途に使用され、Robloxプレイヤーキャラクターも含まれます。また、考慮すべきいくつかのユニークな動作があります。

- `Class.Humanoid`と`Class.Part`という名前の**Head**がモデルの下に親として設定されていると、モデルの上に名前/ヘルスのGUIが表示されます。詳細は[キャラクター名/ヘルス表示](/characters/name-health-display)を参照してください。
- 部品の**Y**軸上の位置が`Class.Workspace.FallenPartsDestroyHeight`の値に達すると、モデルの内部に最後のオブジェクトであった場合、そのモデルも破壊されます。
- `Class.Workspace.StreamingEnabled`がtrueに設定されている場所で使用されると、`Class.Model.ModelStreamingMode|ModelStreamingMode`の値が、モデルとその子孫がクライアントにどのように複製または削除されるかに関するさまざまな動作を制御します。さらに、`Class.Model.LevelOfDetail|LevelOfDetail`の値はモデルのレンダリングに影響します。

すべての`Class.Instance`タイプと同様に、親`Class.Model`がクライアントに複製されている場合でも、そのすべての子が複製されることは保証されません。これは、クライアントで実行されているコードがこれらのインスタンスにアクセスする場合に特に重要です。`Class.Model.ModelStreamingMode|ModelStreamingMode`を`Enum.ModelStreamingMode|Atomic`のような値で使用すると、親モデルがクライアントに存在する場合、モデル全体とそのすべての子孫が存在することが保証されます。あるいは、原子性が望まれない場合は`Class.Instance:WaitForChild()|WaitForChild()`を使用できます。

このモデルを指定されたプレイヤーのために永続的に設定します。永続的なモデルは、ストリーミング設定や条件に関係なく、そのプレイヤーに存在し続けます。

`Class.Model.ModelStreamingMode|ModelStreamingMode`は`Enum.ModelStreamingMode|PersistentPerPlayer`に設定されている必要があり、追加の結果として動作が変更されます。

Model:AddPersistentPlayer

playerInstance

このモデルを永続的にするための`Class.Player`です。

このモデルを指定されたプレイヤーのために永続的に設定します。`Class.Model.ModelStreamingMode|ModelStreamingMode`は
`Enum.ModelStreamingMode|PersistentPerPlayer`に設定されている必要があり、追加の結果として動作が変更されます。

このサンプルでは、追加されたすべてのプレイヤーキャラクターモデルのジョイントが
出現から3秒後に壊れます。これらのジョイントを壊すと、ヒューマノイドが
死亡します。

このコードサンプルは、スクリプトの兄弟である2つのパーツ（PartA と PartB）に対して、ジョイントを手動で作成する方法を示しています。互換性のある表面タイプ（スタッドとインレット）を持つ2つの接触したパーツにジョイントを作成します。

`BaseParts`間の接続を切断し、隣接する部品との表面接続、`Class.WeldConstraint|WeldConstraints`、およびすべての`Class.Weld|Welds`や他の`Class.JointInstance|JointInstances`を含みます。

`BreakJoints`がプレイヤーキャラクター`Class.Model`に使用されると、そのキャラクターの`Class.Humanoid`は首のジョイントに依存しているため死亡します。

隣接する部品との表面接続によって作成されたジョイントは、技術的には`Class.Model:MakeJoints()`を使用して再作成することができますが、これは表面によって作成されたジョイントのみ再作成されます。開発者は、ジョイントが壊れた後に部品が互いに接触していない場合はこの動作に依存しないでください。

Model:BreakJoints

`BaseParts`間の接続を切断し、隣接する部品との表面接続、`Class.WeldConstraint|WeldConstraints`、およびすべての`Class.Weld|Welds`や他の`Class.JointInstance|JointInstances`を含みます。

Model:breakJoints

この関数は、`Class.Model`内のすべての`Class.BasePart`子のボリュームの記述を返します。ボリュームの方向は、`Class.Model.PrimaryPart|PrimaryPart`の方向に基づいており、モデルが選択されているときにスタジオでレンダリングされる選択ボックスに一致します。`Class.Terrain:FillBlock()`の動作をミラーリングしており、バウンディングボックスの中心を表す`Datatype.CFrame`と、そのサイズを表す`Datatype.Vector3`を返します。ボリュームのサイズは、`Class.Model`内の部品に物理的な制約がかかっている場合、実行時に不正確になる場合があります。

バウンディングボックスの方向は、`Class.PVInstance.GetPivot|Pivot`の方向に一致します。すなわち、`Class.Model.PrimaryPart|PrimaryPart`（存在する場合）のピボットか、モデルの`Class.Model.WorldPivot|WorldPivot`です。

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

local model = Workspace.Model
local part = Workspace.Part
local orientation, size = model:GetBoundingBox()

-- 部品をモデルのバウンディングボックスに等しいようにサイズ変更および位置設定
part.Size = size
part.CFrame = orientation
```

Model:GetBoundingBox

ボリュームの方向を表す`Datatype.CFrame`、次にボリュームのサイズを表す`Datatype.Vector3`。

モデルのすべての部品を含むボリュームの記述を返します。

以下のコードサンプルは、Model.GetExtentsSize を使用して、部品を含むバウンディング ボックスのサイズを取得する方法を示しています。


モデル内のすべての`Class.BasePart|BaseParts`を含む最小バウンディングボックスのサイズを返します。方向は、`Class.PVInstance.GetPivot|Pivot`の方向に一致します。すなわち、`Class.Model.PrimaryPart|PrimaryPart`（存在する場合）のピボットか、モデルの`Class.Model.WorldPivot|WorldPivot`です。

この関数は最小バウンディングボックスのサイズのみを返し、開発者はバウンディングボックスの位置を取得するために自分の方法を使用する必要があります。

Model:GetExtentsSize

`Class.Model`の`Datatype.Vector3`のエクステンツサイズです。

モデル内のすべての`Class.BasePart|BaseParts`を含む最小バウンディングボックスのサイズを返します。`
`Class.Model.PrimaryPart`が設定されている場合は、その部分に整列します。

この値は、歴史的にモデルの中央位置のCFrameを返していました。

Model:GetModelCFrame

このコードは、モデルを作成し、その中にいくつかのパーツを配置し、それらをランダムに配置し、そのサイズを出力します:

GetModelSize関数は、`Class.Model`の`Datatype.Vector3`サイズを返します。

Model:GetModelSize

モデルのVector3サイズを返します。

このメソッドが`Class.Script`から呼び出された場合、指定されたプレイヤーオブジェクトを返します。このモデルが永続である場合は、`Class.LocalScript`から呼び出された場合、このモデルが`Class.Players.LocalPlayer|LocalPlayer`に対して永続であるかをチェックします。

Model:GetPersistentPlayers

このモデルオブジェクトが永続であるすべての`Class.Player`オブジェクトを含むテーブルです。

このモデルオブジェクトが永続であるすべての`Class.Player`オブジェクトを返します。呼び出し元が`Class.Script`か`Class.LocalScript`かに応じて動作が異なります。

以下のコードは、GetPrimaryPartCFrameと
SetPrimaryPartCFrameを使用してモデルを回転させる方法を示しています。

シンプルなモデルがWorkspaceに作成され、ループが開始されて
モデルはY軸の周りに0.2秒ごとに10度回転します。

この関数は、`Class.PVInstance:GetPivot()`に取って代わられ、よりパフォーマンスが良く動作を変更せずにコードの動作を変更しません。新しい作業には`Class.PVInstance:GetPivot()`を使用し、便利なときに既存の`Class.Model:GetPrimaryPartCFrame()`呼び出しを移行してください。

モデルの`Class.Model.PrimaryPart`の`Datatype.CFrame`を返します。

この関数は次のように等しいです。

    Model.PrimaryPart.CFrame

プライマリパートが存在しない場合、この関数はエラーをスローします。この動作が望ましくない場合、例えば、プライマリパートが設定されていないか破壊されている場合は、次のようにすることができます。これは、プライマリパートがない場合には`nil`と等しくなります。

    local cFrame = Model.PrimaryPart and Model.PrimaryPart.CFrame

Model:GetPrimaryPartCFrame

モデルの`Class.Model.PrimaryPart`の`Datatype.CFrame`を返します。プライマリパートがない場合、この関数はエラーをスローします。

このコードサンプルは、`Class.Model:PivotTo()` と `Class.Model:ScaleTo()` を使用して、すべてのコピー
のツリーモデルの置き換えを行う方法を示しています。モデルのピボットとスケールは参照として使用され、
置き換えモデルの相対的なサイズと位置が元のモデルと一致することを保証します。


モデルは永続的な標準スケール係数を持ち、これは新しく作成されたモデルには1で始まり、`Class.Model:ScaleTo()`を呼び出すことでモデルがスケールされるにつれて変更されます。この関数はモデルの現在の標準スケール係数を返します。

現在のスケール係数は、インスタンスのサイズに直接影響を与えません。それはコンテンツ作成やスクリプト目的で、モデルが元のサイズに対してどのようにスケールされたかを覚えるために使用されます。

特定のセッション内では、モデルは最初の`Class.Model:ScaleTo()`呼び出しの後、子インスタンスの正確な元のサイズ情報をキャッシュします。これは、`Class.Model:ScaleTo()|ScaleTo(x)`の後に`Class.Model:ScaleTo()|ScaleTo(1)`を呼び出すと、浮動小数点のドリフトなしにモデルの元の構成に正確に戻ります。浮動小数点のドリフトを回避するために、Scale**To**関数が用意されていて、Scale**By**関数はありません。

スケール係数はエンジン動作に1つの方法で影響を与えます：スケール係数は、そのモデルの下の`Class.Animation|Animations`のジョイントオフセットに適用されるため、アニメーションされたリグはスケールされてもアニメーションを正しく再生します。

Model:GetScale

モデルの現在の標準スケール係数です。

モデルの標準スケールを返します。新しく作成されたモデルのデフォルトは1であり、`Class.Model:ScaleTo()`を介してスケールされた場合に変化します。

このコードサンプルは、Model:MakeJoints関数を使用してジョイントを作成する方法を示しています。

モデルがインスタンス化され、二つのパーツが重なっています。上のパーツは
固定されていて、下のパーツは固定されていません。通常、Workspaceに親子関係を持つと、
下のパーツはベースプレートに落ちます。

しかし、下のパーツのTopSurfaceプロパティがEnum.SurfaceType.Weldに設定されているため、
Model:MakeJointsが実行されると、それらの間に接続が作成されます。

そのため、モデル内のジョイントが壊れるまで、下のパーツは落ちません。
これは通常、Model:BreakJointsを使用して行われますが、この例では、
爆発を使用して接続が壊されています。

このコードサンプルは、スクリプトの兄弟である二つのパーツ（PartA と PartB）にジョイントを作成する方法を示しています。接触している二つの互換性のある表面タイプ（スタッドとインレット）を持つパーツに対して MakeJoints を使用します。

SurfaceTypeに基づく結合は非推奨です。新しいプロジェクトにはMakeJointsを使用しないでください。代わりに`Class.WeldConstraint|WeldConstraints`および`Class.HingeConstraint|HingeConstraints`を使用してください。

`Class.Model`内のすべての`Class.BasePart|Parts`を処理し、指定された部品と接触する平面的な表面との間にジョイントを作成します。部品の表面によって依存します。

- スムーズな表面はジョイントを作成しません。
- 接着剤の表面は`Class.Glue`ジョイントを作成します。
- 溶接は、Unjoinableを除く任意の表面との`Class.Weld`ジョイントを作成します。
- スタッド、インレット、またはユニバーサルは、他の2つの表面のいずれかと`Class.Snap`ジョイントを作成します（例：スタッドとインレットやユニバーサル）。
- ヒンジやモーター表面は、`Class.Rotate`および`Class.RotateV`ジョイントインスタンスを作成します。

この関数は、パーツが`Class.Workspace`の子孫でない場合、機能しません。したがって、MakeJointsを使用する前にモデルがWorkspaceに親付けされていることを確認する必要があります。

Model:MakeJoints

モデル内のすべての`Class.BasePart|BaseParts`を処理します。部品のいずれかの面にジョイントを作成できるSurfaceTypeがある場合、隣接する部品とのジョイントを作成します。

Model:makeJoints

Model:move

location

このサンプルは、`Class.Model:MoveTo()`が衝突を避ける方法を示しています。

単純な2つの部分からなる`Class.Model`が作成され、その`Class.Model.PrimaryPart`
が設定されます。大きな障害物がその隣に配置されます。

5秒後、`Class.Model:MoveTo()`が使用され、モデルを障害物の内部に移動させようとします。
しかし、MoveToはモデルを障害物内に移動させないため、`Class.Model`はY軸上に持ち上げられ、障害物の上に配置されます。


指定された位置に`Class.Model.PrimaryPart|PrimaryPart`を移動します。プライマリパートが指定されていない場合、モデルのルートパートが使用されますが、ルートパートは決定論的ではないため、`Class.Model:MoveTo()|MoveTo()`を使用する際には常にプライマリパートを設定することをお勧めします。

モデルを移動させる場所に障害物がある場合（`Class.Terrain`や他の`Class.BasePart|BaseParts`など）、モデルは邪魔物がなくなるまで垂直に上に移動します。この動作が望ましくない場合は、代わりに`Class.PVInstance:PivotTo()`を使用する必要があります。

`Class.Model:MoveTo()|MoveTo()`でモデルを移動する際に回転は保持されないことに注意してください。モデルの現在の回転を保持する必要がある場合は、`Class.Model:TranslateBy()|TranslateBy()`または`Class.PVInstance:PivotTo()`を使用することをお勧めします。

Model:MoveTo

position

`Class.Model`が移動する`Datatype.Vector3`です。

指定された位置に`Class.Model.PrimaryPart|PrimaryPart`を移動します。プライマリパートが指定されていない場合、モデルのルートパートが使用されます。

Model:moveTo

このモデルを指定されたプレイヤーに対して永続的ではなくします。これによりモデルがすぐにプレイヤーから削除されることは保証されません。このメソッドを呼び出した後、モデルはそのプレイヤーに対して`Enum.ModelStreamingMode|Atomic`として扱われ、ターゲットストリーミング半径内にある限り存在し続けます。

`Class.Model.ModelStreamingMode|ModelStreamingMode`は`Enum.ModelStreamingMode|PersistentPerPlayer`に設定されている必要があり、削除の結果として動作が変更されます。

Model:RemovePersistentPlayer

このモデルを永続的ではなくするための`Class.Player`です。

このモデルを指定されたプレイヤーに対して永続的ではなくします。`Class.Model.ModelStreamingMode|ModelStreamingMode`は
`Enum.ModelStreamingMode|PersistentPerPlayer`に設定されている必要があり、削除の結果として動作が変更されます。

モデルの部品の回転を以前に設定されたアイデンティティ回転にリセットします。これは、`Class.Model:SetIdentityOrientation()`メソッドを介して行われます。

Model:ResetOrientationToIdentity

モデルには永続的な標準スケール係数があり、新しく作成されたモデルは1から始まります。この関数はモデルをピボット位置の周りでスケールします。

これを達成するために、次の2つを行います。

- モデルの現在のスケール係数を指定された値に設定します。
- すべての子インスタンスをそれに応じてサイズ変更および再配置します。

位置のスケーリングはピボット位置の周りで行われます。

すべての「幾何学的」プロパティが子インスタンスのスケーリングの対象になります。もちろん部品のサイズを含みますが、こちらはスケールされるプロパティの他の例です:

- `Class.WeldConstraint|WeldConstraints`や`Class.RopeConstraint`のようなジョイントの長さ
- `Class.HingeConstraint`のような物理的速度や力
- パーティクルエミッターのサイズのような視覚的プロパティ
- `Class.Sound.RollOffMinDistance`のような他の長さプロパティ

Model:ScaleTo

newScaleFactor

モデルのスケール係数を設定し、すべての子インスタンスのサイズと位置が初期のサイズと位置に対してそのスケール係数を持つように調整します。

指定されたモデルのアイデンティティ回転を設定します。後で`ResetOrientationToIdentity`メソッドを使用してモデル全体の回転をリセットできるようにします。

Model:SetIdentityOrientation

この関数は`Class.PVInstance:PivotTo()`に取って代わられ、よりパフォーマンスの良い置き換えとして機能し、あなたのコードの動作を変更しません。新しい作業には`Class.PVInstance:PivotTo()`を使用し、便利なときに既存の`Class.Model:SetPrimaryPartCFrame()`呼び出しを移行してください。

モデルの`Class.Model.PrimaryPart`の`Class.BasePart.CFrame`を設定します。すべての他の部品も移動し、`Class.Model.PrimaryPart`に関連する向きとオフセットを保持します。

注意すべき点は、この関数はモデルに`Class.Model.PrimaryPart`が存在しない場合、エラーをスローします。このことは、プライマリパートが設定されていなかったり、破壊されている場合に問題を引き起こす可能性があります。

Model:SetPrimaryPartCFrame

cframe

モデルの`Class.Model.PrimaryPart`の`Class.BasePart.CFrame`を設定します。他のすべての部品も移動し、`Class.Model.PrimaryPart`に関連する向きとオフセットを保持します。

このサンプルは、`Class.Model:TranslateBy()` が衝突を無視し、モデルの向きを尊重する方法を示しています。

シンプルな2つのパートからなる `Class.Model` が作成され、Y軸で45度回転され、
その `Class.Model.PrimaryPart` が設定されます。大きな障害物パートが
その隣に配置されます。

5秒後に `Class.Model:TranslateBy()` が使用され、モデルを
障害物パートの中に移動させるよう指示します。モデルは障害物の
中に移動し、現在の向きを維持します。


与えられた`Datatype.Vector3`オフセットで`Class.Model`を移動し、モデルの向きを保持します。新しい位置に他の`Class.BasePart`または`Class.Terrain`が既に存在する場合、その`Class.Model`は該当するオブジェクトと重なります。

この翻訳は、オブジェクト空間ではなくワールド空間で適用され、モデルの部品が異なる方向を向いていても、標準軸に沿って移動することができます。

Model:TranslateBy

delta

`Class.Model`を移動させるための`Datatype.Vector3`です。

与えられた`Datatype.Vector3`オフセットで`Class.Model`を移動し、モデルの向きを保持します。新しい位置に他の`Class.BasePart`または`Class.Terrain`が既に存在する場合、その`Class.Model`は該当するオブジェクトと重なります。

Model

インスタンスで[ストリーミング](/workspace/streaming)が有効な体験のために、モデルの詳細レベルを設定します。合成メッシュまたはインポスターメッシュは、物理学、衝突検出、またはレイキャスティングをサポートしていません。

`Enum.ModelLevelOfDetail|StreamingMesh`に設定されている場合は、低解像度の「インポスター」メッシュ（モデルのすべての子部品を囲む色付きの粗いメッシュ）がストリーミング半径の外側にレンダリングされます。テクスチャはサポートしていません。

`Enum.ModelLevelOfDetail|SLIM`に設定されている場合、**SLIM**モデル（スケーラブル・ライトウエイト・インタラクティブモデル）は、ストリーミング半径に基づいて、距離に応じてすべての子部品の合成を次第に低い解像度でレンダリングします。これは、`Enum.ModelLevelOfDetail|StreamingMesh`に対して視覚的な品質を大幅に向上させます。

`Enum.ModelLevelOfDetail|Disabled`または`Enum.ModelLevelOfDetail|Automatic`に設定されている場合、低解像度のメッシュは表示されません。


Model.LevelOfDetail

インスタンスストリーミングが有効な体験のためにモデルの詳細レベルを設定します。

インスタンスの[ストリーミング](/workspace/streaming)が有効な場合、`Class.Model|Models`がどのようにストリーミングされるかを制御します。動作は選択した列挙型に依存します。ストリーミングが無効な場合は影響を与えません。

このプロパティは、ストリーミングが有効な場合にスタジオ内の[プロパティ](/studio/properties)ウィンドウでのみ変更されるべきであり、`Class.Script|Scripts`内で変更されることはないが、`Class.LocalScript|LocalScripts`内では決して変更されるべきではありません（これにより未定義の動作を引き起こす可能性があります）。

Model.ModelStreamingMode

インスタンスストリーミングが有効な場合の`Class.Model|Models`のストリーミング動作を制御します。

このコードサンプルはサイコロのモデルを作成し、投げた後に
青い面が上を向いて着地したかどうかを出力します。 `Class.Model.PrimaryPart`が設定されていない場合、
サイコロのピボット/バウンディングボックスは回転し、内部のパーツは
ロール中に物理的にシミュレートされます。

`Class.Model`のプライマリパートを指します。プライマリパートはモデルのピボットの物理的参照として機能する`Class.BasePart`です。つまり、モデル内の部品が物理シミュレーションやその他の手段で動かされると、ピボットはプライマリパートと同期して移動します。

`Class.Model|Models`はデフォルトで`PrimaryPart`が設定されていないことに注意してください。物理的に作用される必要があるモデルを作成している場合、このプロパティはスタジオまたはスクリプト内で手動で設定する必要があります。プライマリパートが**設定されていない**場合、モデル内の部品が移動してもピボットはワールド空間の同じ位置に維持されます。

このプロパティを設定する場合、モデルの子孫である`Class.BasePart`でなければなりません。モデルの子孫でない`Class.BasePart`に`Class.Model.PrimaryPart`を設定しようとすると、その部品に設定されますが次のシミュレーションステップで`nil`にリセットされます。これは、スクリプトがモデルの子孫でない`Class.BasePart`に一時的にプライマリパートを設定できると仮定していた以前の動作です。

モデルの一般的なルールは次のとおりです。

- 部品が`Class.WeldConstraint|WeldConstraints`や`Class.Motor6D|Motor6Ds`などの物理ジョイントで接続されているモデルにはプライマリパートが割り当てられるべきです。たとえば、Robloxキャラクターモデルの`Class.Model.PrimaryPart`はデフォルトで**HumanoidRootPart**に設定されています。
- 通常`Class.BasePart.Anchored|Anchored`の静的なモデルは、スクリプトが明示的に移動させない限り1か所に留まり、`Class.Model.PrimaryPart`は設定しなくてもよく、設定しても利点がないことが多いです。

Model.PrimaryPart

`Class.Model`のプライマリパート、または明示的に設定されていない場合は`nil`。

プロパティウィンドウ内でこのプロパティを設定すると、すべての子インスタンス（材質、画像、部品の3Dジオメトリなど）のサイズが、元のサイズに対して指定されたスケール係数を持つように、`Class.Model:ScaleTo()`が呼ばれたかのようにモデルがスケールされます。

このプロパティはスタジオ内でのみ使用可能であり、`Class.Script`または`Class.LocalScript`で使用するとエラーが発生します。`Class.Model:ScaleTo()`および`Class.Model:GetScale()`はスクリプトから使用する必要があります。

Model.Scale

モデルのピボットの周りでモデルをスケールするためのエディタ専用プロパティ。 このプロパティを設定すると、`Class.Model:ScaleTo()`が呼ばれたかのようにスケールが移動します。

このコードサンプルは、モデルのピボットをそのモデルのバウンディングボックスの中心にリセットするためのカスタム関数を示しています。

このプロパティは、`Class.Model`の`Class.Model.PrimaryPart`が設定されていない場合のピボットがどこにあるかを決定します。`Class.Model` **が** `Class.Model.PrimaryPart|PrimaryPart`を持っている場合、`Class.Model`のピボットはそのプライマリパートのピボットに等しくなり、`Class.Model.WorldPivot|WorldPivot`プロパティは無視されます。

新しく作成された`Class.Model`の場合、そのピボットは内容物のバウンディングボックスの中心として扱われます。**最初に**その`Class.Model.WorldPivot`プロパティが設定されるまで。この世界ピボットが初めて設定されると、この初期の動作を復元することは不可能です。

通常、モデルをスタジオツールで移動させたり、`Class.PVInstance:PivotTo()`や`Class.Model:MoveTo()`のようなモデル移動関数を使用すると、ワールドピボットが設定されてこの新しいモデルの動作が終了します。

この動作の目的は、Luauコードが新しいモデルを作成し、オブジェクトを親にするだけで合理的なピボットを取得できるようにし、モデルをコードで作成するたびに`Class.Model.WorldPivot`を明示的に設定する必要がないようにすることです。

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

local model = Instance.new("Model")
Workspace.BluePart.Parent = model
Workspace.RedPart.Parent = model
model.Parent = Workspace

print(model:GetPivot())  -- 現在の"BluePart"と"RedPart"を含むバウンディングボックスの中心と等しい

model:PivotTo(CFrame.new(0, 10, 0))  -- 明示的に"model.WorldPivot"を設定することなく機能します
```

Model.WorldPivot

`Class.Model`の`Class.Model.PrimaryPart`が設定されていない場合、ピボットがどこにあるかを決定します。

モデルはコンテナオブジェクトであり、オブジェクトをまとめることを意味します。最適に使用するのは`Class.BasePart|BaseParts`のコレクションを保持することです。モデルはその機能を拡張するいくつかの関数を持っています。

A `Class.PVInstance`は作成できない抽象クラスです。それは
世界に物理的位置を持つすべてのオブジェクトの基盤です。


このコードサンプルは、<kbd>F</kbd>キーを押したときに、あなたのキャラクターを現在向いている方向に
10&nbsp;スタッド進めるシンプルなテレポートスクリプトです。これは、`Class.PVInstance:GetPivot()`で現在のピボットを取得し、
`PVInstance|PivotTo`を呼び出してキャラクターを前方に移動させることで実現されます。

この関数は`Class.PVInstance`のピボットを取得します。これはしばしば
`Class.PVInstance:PivotTo()`と共に使用されてモデルを移動させます。

`Class.Model|Models`と`Class.BasePart|BaseParts`は両方とも
`Class.PVInstance|PVInstances`（"Position Velocity Instances"）であり、したがって両方が
この関数を持っています。


PVInstance:GetPivot

`Class.PVInstance`のピボットを取得します。


`Class.PVInstance`とそのすべての子孫の`Class.PVInstance|PVInstances`を変換し、ピボットを指定された
`Datatype.CFrame`に位置させます。これはスクリプトを通じて`Class.Model|Models`を移動させるために
使われる主要な関数です。

`Class.BasePart|BaseParts`は必要なオフセットによってその`Datatype.CFrame`が変換されることで
この方法で移動します。
`Class.Model|Models`は必要なオフセットによってその`Class.Model.WorldPivot`が変換されることで
この方法で移動します。

効率を考慮して、`Class.BasePart|BaseParts`の`Class.BasePart.Position|Position`と
`Class.BasePart.Orientation|Orientation`に対して、
この方法で移動した場合は`Class.Object.Changed`イベントは発火されません；それらは
`Datatype.CFrame`に対してのみ発火されます。

`Class.Model|Models`に対して`Class.PVInstance:PivotTo()|PivotTo`を呼び出すと、
子孫のパーツとモデルのオフセットがキャッシュされるため、
同じモデルに対する後続の`Class.PVInstance:PivotTo()|PivotTo`呼び出しで
パーツ間の浮動小数点漂流が蓄積されることはありません。

`Class.Model|Models`と`Class.BasePart|BaseParts`は両方とも
`Class.PVInstance|PVInstances`（"Position Velocity Instances"）であり、したがって両方が
この関数を持っています。


PVInstance:PivotTo

targetCFrame

移動後に`Class.PVInstance`のピボットが等しくなるべき`Datatype.CFrame`。


`Class.PVInstance`とそのすべての子孫の`Class.PVInstance|PVInstances`を変換し、ピボットを指定された
`Datatype.CFrame`に位置させます。


PVInstance

PVInstance.Origin

PVInstance.Pivot Offset

世界に物理的位置を持つすべてのオブジェクトのための抽象クラス。


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

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

インスタンスの系譜に対する変更を検出する方法を示します。
`Class.Instance.AncestryChanged` イベントに接続することで実現します。

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


このインスタンスが再親和されたときや、その先祖のいずれかが再親和されたときに発火します。

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

Instance.AncestryChanged

child

`Class.Instance.Parent|Parent` プロパティが変更されたインスタンス。これがこのインスタンスか、より遠い先祖である可能性がありますが、必ずしもハンドラーに接続されているインスタンスとは限りません。

parent

`child` パラメータの新しい親。

このオブジェクトまたはその先祖の `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` の子孫が削除される直前に発火します。

このサンプルは、Immediate シグナル動作を使用する際に、
インスタンスが破棄されるまで、接続された関数が yield するまでその位置に留まることを示しています。


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


接続された関数がまだ使用している間、`Class.Instance` は決してメモリから削除されることはありません。ただし、関数が途中でyieldする場合、`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` の削除は、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` に設定されたときも含まれます。

このメソッドはインスタンスにタグを適用し、タグがすでに適用されている場合には効果がありません。タグを正常に追加すると、`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.Name` を持つ `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` です。

指定された名前に等しい `Class.Instance.Name` を持つ `Class.Instance` の最初の祖先を返します。

指定された className に等しい `Class.Object.ClassName` を持つ `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:FindFirstAncestorWhichIsA()` も存在し、代わりに `Class.Object:IsA()` を用いてクラスの継承を尊重します。

Instance:FindFirstAncestorOfClass

className

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

指定された className に等しい `Class.Object.ClassName` を持つ `Class.Instance` への最初の祖先を返します。

指定された className のために `Class.Object:IsA()` が true を返す最初の `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` 祖先の最初のものを返します、`Class.WedgePart` であっても、`Class.MeshPart` であっても、`Class.Part` であってもかまいません。

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

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

Instance:FindFirstAncestorWhichIsA

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

Instance

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