一个服务，可以允许在 `Class.Player` 对象中的属性默认值被设置。当玩家进入服务器时，玩家对象的每个属性都设置为相应属性的当前值 `Class.StarterPlayer` 。

  此外，您可以将四个对象添加到此服务：

  *   一个 `Class.StarterPlayerScripts` 实例，其中每个玩家运行一次的脚本。
  *   一个 `Class.StarterCharacterScripts` 实例，每次重生点时向每个玩家的角色添加脚本。
  *   一个名为    的实例，将用作每个玩家角色的默认机器人。
  *   一个名为    的实例，将用作所有玩家的角色模型。

StarterPlayer

该属性描述了当前游戏的权限级别关于自定义虚拟形象 `Class.Animation|Animations` 从网站。

  因此，无法在游戏内更改此值。它只能通过在网站上游戏设置页面中更改游戏的权限级别来更改。

  该属性不适用于游戏。

StarterPlayer.AllowCustomAnimations

描述网站对自定义虚拟形象动画的权限级别。

这段代码示例用于 TextButton。它允许玩家在移动设备上切换自动跳转行为。

该属性设置角色在移动设备上击中障碍物时是否自动跳跃。

  该属性从 `Class.StarterPlayer` 复制到 `Class.Player` 当他们加入游戏时。在此之后。该属性的值复制到角色的 `Class.Humanoid.AutoJumpEnabled` 属性中的 `Class.Humanoid` 在生重生点时。换言之，使用这三个属性可以在每个角色、每个玩家和每场游戏的基础上设置自动跳转行为。

StarterPlayer.AutoJumpEnabled

设置角色在移动设备上击中障碍物时是否自动跳跃。

StarterPlayer.AvatarJointUpgrade

The example demonstrates how to set a player's camera minimum and maximum
zoom distance.

In this example, we set the `Class.Player.CameraMinZoomDistance` and
`Class.Player.CameraMaxZoomDistance` to set the min and max distance in studs
a player's camera can be from their character.

Note that since the example attempts to set the CameraMinZoomDistance to be
greater than the CameraMaxZoomDistance, the CameraMinZoomDistance value will
be decreased and set to the value of the max zoom distance.

To change the default min and max zoom distance values for a player when they
first enter the game, you can change the
`StarterClass.Player.CameraMinZoomDistance` and
`StarterClass.Player.CameraMaxZoomDistance` properties.

此属性设置了相机可以从默认相机与角色之间的最大距离以学分。

  该属性设置了加入游戏的每个玩家的默认值 `Class.Player.CameraMaxZoomDistance` 。如果这个值设置为低于 `Class.StarterPlayer.CameraMinZoomDistance` 的值，它将增加到相机的最小缩放距离。

StarterPlayer.CameraMaxZoomDistance

玩家默认摄像头允许在钉子中缩放的最大距离。

这个属性设置了相机可以从默认相机与角色之间的最小距离，以学分为单位。

  该属性设置了加入游戏的每个玩家的默认值 `Class.Player.CameraMinZoomDistance` 。如果这个值设置为高于 `Class.StarterPlayer.CameraMaxZoomDistance` 的值，它将被减少为 CameraMaxZoomDistance。

StarterPlayer.CameraMinZoomDistance

玩家默认摄像头的最小距离允许放大。

This example demonstrates how to change the character's CameraMode to first
person using the LockFirstPerson value of the `Enum.CameraMode` enum.

为游戏中的每个玩家设置默认值 `Class.Player.CameraMode`。相机有两种模式：

  ##### 第一人称

  在第一人称模式下，玩家的相机全程缩放。除非具有可见的 GUI 与 `Class.GuiButton.Modal` 属性设置为 `true` ,否则鼠标将被锁定，用户的相机将随着鼠标移动转为镜头。

  ##### 第三人称

  在第三人称模式（默认）下，角色可以在相镜头中看到。在 Roblox 上的第三人称模式中：

  *   您可以单击右键并拖动以旋转相镜头，或使用屏幕右下角的箭头键。
  *   当你移动鼠标时，你的相机不会更改（除非你将鼠标移至屏幕末端）。
  *   当您按下任何箭头键时，用户的角色将面向相应的箭头键的方向。
  *   您可以自由缩放。

StarterPlayer.CameraMode

将默认镜头像头的模式更改为第一或第三人称。

该属性决定了玩家的    的初始值。该属性的值默认为 7.2 格。

  此属性仅在属性窗口中可见，如果 `Class.StarterPlayer.CharacterUseJumpPower` 设置为 `false`，否则无关。

  由于此属性仅适用于将来生成的角色，更改它不会更改任何现有的玩家角色。对此属性的更改只会在玩家重生时生效。

StarterPlayer.CharacterJumpHeight

决定了 `Class.Humanoid.JumpHeight` 对于 `Class.Player.Character` 的初始值。

该属性决定了玩家的    的初始值。该属性的值默认为 50，当应用于玩家的 `Class.Humanoid` 时，将受到 0 到 1000 之间的约束。

  此属性仅在属性窗口中可见，如果 `Class.StarterPlayer.CharacterUseJumpPower` 设置为 `true`，否则无关。

  由于此属性仅适用于将来生成的角色，更改它不会更改任何现有的玩家角色。对此属性的更改只会在玩家重生时生效。

StarterPlayer.CharacterJumpPower

决定了 `Class.Humanoid.JumpPower` 对于 `Class.Player.Character` 的初始值。

该属性决定了玩家的    的初始值。默认为 89°，因此人形可以默认攀登任何他们想要的坡度。当应用于玩家的 `Class.Humanoid` 时，将受到 0 和 89 之间的限制。

  由于此属性仅适用于将来生成的角色，更改它不会更改任何现有的玩家角色。对此属性的更改只会在玩家重生时生效。

StarterPlayer.CharacterMaxSlopeAngle

决定了 `Class.Humanoid.MaxSlopeAngle` 对于 `Class.Player.Character` 的初始值。

决定了玩家的    的初始值。切换它将更改哪个属性在属性窗口中可见：`Class.StarterPlayer.CharacterJumpHeight|CharacterJumpHeight`（false）或`Class.StarterPlayer.CharacterJumpPower`（true）。默认为真。

  由于此属性仅适用于将来生成的角色，更改它不会更改任何现有的玩家角色。对此属性的更改只会在玩家重生时生效。

StarterPlayer.CharacterUseJumpPower

决定 `Class.Humanoid.UseJumpPower` 对于 `Class.Player.Character` 的初始状态。

该属性决定了玩家的 `Class.Player.Character` 的初始值为 `Class.Humanoid.WalkSpeed` 。该属性默认为 16。

  由于此属性仅适用于将来生成的角色，更改它不会更改任何现有的玩家角色。对此属性的更改只会在玩家重生时生效。

StarterPlayer.CharacterWalkSpeed

决定了 `Class.Humanoid.WalkSpeed` 对于 `Class.Player.Character` 的初始值。

StarterPlayer.ClassicDeath

定义默认相机脚本如何处理相机和相机主题之间的对象。适用于所有玩家加入体验时，不能为个人玩家更改。

  默认值为 `Enum.DevCameraOcclusionMode|Zoom` （0）。请参阅 `Enum.DevCameraOcclusionMode` 获取可用模式列表。

StarterPlayer.DevCameraOcclusionMode

设置默认相机如何处理在相机和玩家之间的对象。

The example demonstrates how to set a player's camera movement mode for
players on a computer.

In this example, we set the camera movement mode to Classic via the
`Enum.DevComputerCameraMovementMode` enum. This means that the camera of
players on touch enabled devices will track the player but will not
automatically rotate if the player walks left or right.

此属性可让开发者在玩家使用电脑时覆盖玩家的相机模式。

  这是玩家加入游戏的默认属性。它可以通过设置 `Class.Player.DevComputerCameraMode` 对个人玩家进行更改。

  如果设置为 `Enum.DevComputerCameraMovementMode|UserChoice` 那么玩家的相机移动模式将由玩家在游戏设置中设置的任何内容决定。否则，模式将根据此属性设置。

  查看 `Enum.DevComputerCameraMovementMode` 以获取可用的不同摄像头模式。

  该属性对不在计算机上的玩家没有影响。

StarterPlayer.DevComputerCameraMovementMode

如果玩家正在使用电脑，让开发者覆盖每个玩家的默认摄像头模式。

此属性可让开发者在玩家使用电脑时覆盖玩家的移动模式。

  这是玩家加入游戏的默认属性。它可以通过设置 `Class.Player.DevComputerMovementMode` 对个人玩家进行更改。

  如果设置为 `Enum.DevComputerMovementMode|UserChoice` 那么玩家的移动模式将由玩家在游戏设置中设置的任何内容决定。否则，模式将根据此属性设置。

  查看 `Enum.DevComputerMovementMode` 可用的不同移动模式。如果玩家在电脑上，让开发者覆盖玩家的移动模式。

  该属性对不在计算机上的玩家没有影响。

StarterPlayer.DevComputerMovementMode

如果玩家正在使用电脑，让开发者覆盖玩家的移动模式。

The example demonstrates how to set a player's camera movement mode.

In this example, we set the camera movement mode to Classic via the
`Enum.DevTouchCameraMovementMode` enum. This means that the camera of players
on touch enabled devices will track the player but will not automatically
rotate if the player walks left or right.

此属性可让开发者在玩家使用触摸设备时覆盖玩家的相机模式。

  这是玩家加入游戏的默认属性。它可以通过设置 `Class.Player.DevTouchCameraMode` 对个人玩家进行更改。

  如果设置为 `Enum.DevTouchCameraMovementMode|UserChoice` 那么玩家的相机移动模式将由玩家在游戏设置中设置的任何内容决定。否则，模式将根据此属性设置。

  查看 `Enum.DevTouchCameraMovementMode` 以获取可用的不同摄像头模式。

  该属性对移动设备上的玩家没有影响。

StarterPlayer.DevTouchCameraMovementMode

如果玩家正在使用移动设备，让开发者覆盖每个玩家的默认相机移动模式。

此属性可让开发者在玩家使用触摸设备时覆盖玩家的移动模式。

  这是玩家加入游戏的默认属性。它可以通过设置 `Class.Player.DevTouchMovementMode` 对个人玩家进行更改。

  如果设置为 `Enum.DevTouchMovementMode|UserChoice` 那么玩家的移动模式将由玩家在游戏设置中设置的任何内容决定。否则，模式将根据此属性设置。

  查看 `Enum.DevTouchMovementMode` 可用的不同移动模式。如果玩家使用触摸设备，让开发者覆盖玩家的移动模式。

  该属性对不触摸启用设备上的玩家没有影响。

StarterPlayer.DevTouchMovementMode

如果玩家使用触摸设备，让开发者覆盖玩家的移动模式。

StarterPlayer.EnableDynamicHeads

The example demonstrates how to enable and disabled whether a player can lock
their mouse.

In this example, we set the use a while true loop to toggle the state of the
DevEnabledMouseLock property between _true_ and _false_ every 5 seconds. While
this example has little practical use, it demos how to change the property via
a `LocalScript`.

此属性决定是否默认启用玩家锁定鼠标。

  鼠标锁定将锁定玩家的鼠标指针在屏幕中心。移动鼠标会旋转`Class.Camera`和`Class.Player`将相对于相镜头当前旋转移动。

  该属性设置了值 `Class.Player.DevEnableMouseLock` 。

  请注意，与Shift-Lock相关的 API 正在被弃用，因此建议使用 `Class.UserInputService.MouseBehavior` 来锁定鼠标。

StarterPlayer.EnableMouseLockOption

决定是否默认启用玩家的鼠标锁定。

This example demonstrates how to hide other `Humanoid`'s (`Player` and NPC)
health bars and names.

This is done by setting the player's `Class.Player.HealthDisplayDistance` and
`Class.Player.NameDisplayDistance` properties to 0.

If you would like to display health bars and names, you set the properties to
a value greater than 0. For instance, setting the properties to 100 means that
the player will see other player's health and names up to 100 studs away.

To modify the default values for players, you can change the values of the
`StarterClass.Player.HealthDisplayDistance` and
`StarterClass.Player.NameDisplayDistance` properties.

该属性设置了这名玩家可以看到其他 `Class.Humanoid` 生命条的距离，以学分为单位。如果设置为 0，生命条不会显示。此属性默认设置为 100 格。

  要在玩家加入游戏后更改显示距离，您可以设置 `Class.Player.HealthDisplayDistance` 属性。

  如果 `Class.Humanoid` 生命值栏可见，您可以使用 `Class.Humanoid.DisplayDistanceType` 设置显示类型。

StarterPlayer.HealthDisplayDistance

设置此玩家可以看到其他 `Class.Humanoid` 生命条的距离。如果设置为 0，生命条将不会显示。

This example demonstrates how to disable loading a player's character
appearance. Instead, the player loads as a grey model without any hats,
shirts, pants, etc.

This is useful for games using custom clothing and accessories.

Note that if the character has already spawned, this change will not take affect
until the player respawns or the `Class.Player:LoadCharacter()` function is
called.

该属性设置玩家角色的外观是否应加载。

  将其设置为 `false` 会导致玩家没有衣服（包括帽子）、身体颜色、身体包或与玩家虚拟形象相关的其他任何东西。默认情况下，此属性设置为 `true` .

  将其设置为 `true` 会导致玩家加载相应于玩家 `Class.Player.CharacterAppearanceId` 的外观。

  如果使用 `Class.Player:LoadCharacterWithHumanoidDescription()` ，将 `Class.StarterPlayer.LoadCharacterAppearance` 设置为 false，因为玩家的虚拟形象不需要作为装备角色的所有资产ID，所有资产ID都来自传入的 `Class.HumanoidDescription` 。

StarterPlayer.LoadCharacterAppearance

是否应该加载玩家角色的外观。

指示是否生成到体验中的角色将配备层次服装配件（尽管 `Class.Workspace.MeshPartHeadsAndAccessories` 也需要在 `Class.Workspace` 中启用）。

StarterPlayer.LoadCharacterLayeredClothing 

指示是否将生成到体验中的角色配备上层服装配件。

StarterPlayer.LuaCharacterController

设置此玩家可以看到其他 `Class.Humanoid` 名称的距离。如果设置为 `0`，名称将被隐藏。此属性默认设置为 `100` 格。

  要在玩家加入游戏后更改显示距离，您可以设置 `Class.Player.NameDisplayDistance` 属性。

  如果 `Class.Humanoid` 名称可见，您可以使用 `Class.Humanoid.DisplayDistanceType` 设置显示类型。

StarterPlayer.NameDisplayDistance

设置此玩家可以看到其他 `Class.Humanoid` 名称的距离。

StarterPlayer.RagdollDeath

此属性决定是否在加载虚拟形象时加载用户拥有的表情。将此属性设置为 false 禁用加载。开发者可以直接在工作室设置属性或通过[游戏设置菜单](/studio/game-settings)设置属性。

  禁用表情加载时，开发人员仍然可以通过在游戏中添加表情来使用表情功能。

  还请参阅[虚拟形象表情](/characters/emotes)，一篇详细说明如何控制、自定义和播放虚拟形象表情的文章。

StarterPlayer.UserEmotesEnabled

决定是否在加载虚拟形象时加载用户拥有的表情。

一个服务，可以允许在 `Class.Player` 对象中的属性默认值被设置。

`Instance` 是 Roblox 类层次中所有类的基础类，可以组成 `Class.DataModel` 树。

  无法直接创建根 `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` 属性发生更改时，触发火焰。

  该事件包含两个参数：指向了具有>的》的》，其中》实际上已更改，而》指向了这个实例的新》。

  您可以使用此事件来跟踪 Studio 中实例的删除，例如手动删除在 Explorer 或通过插件进行。如果需要检测实例是否使用 `Class.Instance:Destroy()` 被摧毁，请使用 `Class.Instance.Destroying` 事件。

Instance.AncestryChanged

child

已更改其 `Class.Instance` 的 `Class.Instance.Parent` 。

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` 上更改特性时，都会发生火焰。

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` 后发生。

  每次发射到每个后裔时，将对象父辈到 `Class.Instance` 将会独立地发射该对象和所有其子对象的事件。

  如果您仅关心 **直接子女** 的 `Class.Instance` , 请使用 `Class.Instance.ChildAdded` 。

  还见 `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: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` 的后裔被移除之前立即发生火焰。

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` 或其祖先被摧毁之前立即发生，使用 `Class.Instance:Destroy()` 摧毁。

  如果 `Class.Workspace.SignalBehavior` 属性设置为 `Enum.SignalBehavior.Deferred` ,该事件将在下一次恢复点触发,这将是在 `Class.Instance` 或其祖先之一被摧毁后,用 `Class.Instance:Destroy()` 删除。

  使用 `Enum.SignalBehavior.Deferred|Deferred` 行为连接脚本到自己的 `Class.Instance.Destroying` 事件是有问题的，因为脚本在调用回调之前会被摧毁（即不会执行）。

  当在 Studio 中删除 `Class.Instance` 时，例如通过手动删除通过 [Explorer](/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()` 创建的信号，其标签与指定的标签相同。

  ##### 警告

  *   服务器稍后添加或移除了该实例上的标签，客户端添加的标签将被丢弃，因为服务器复制所有标签并覆盖以前的标签。

  *   当标记实例时，常见的是一些资源被用来给标签提供功能，例如事件连接或表。为了防止内存泄漏，清理这些（断开、设置为 `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()` 循环那些孩子/后裔并选择要摧毁的内容例如，以下代码示例将摧毁所有 `Class.BasePart|BaseParts` 从一个 `Class.Model` 下降：

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

  local model = Workspace:FindFirstChild("TestModel")

  for _, descendant in model:GetDescendants() do
  	if descendant:IsA("BasePart") then
  		descendant:Destroy()
  	end
  end
  ```

Instance:ClearAllChildren

展示使用 `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` 的实例。

展示使用 `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)  --> “你好，世界”
  -- 这样做可以防止上面的线工作：
  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()` 。

返回第一个祖先的 `Class.Instance` 其 `Class.Instance.Name` 与给定名称相等。

  这个函数向上工作，意味着它从实例的即时 `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` 其 `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.Instance` 其 `Class.Object.ClassName` 与给定的 className 相等。

返回第一个祖先的 `Class.Instance` 为谁 `Class.Object:IsA()` 返回给定类别的真实。

  这个函数向上工作，意味着它从实例的即时 `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

返回第一个祖先的 `Class.Instance` 为谁 `Class.Object:IsA()` 返回给定类别的真实。

The below would look in Workspace for an object name "Brick". If found, it
will change the name of the object to "Foo".

返回 `Class.Instance` 的第一个孩子，用给定的名称返回，或 `nil` 如果没有这样的孩子。如果可选的 `recursive` 参数是 `true` , 这个函数搜索所有子孙，而不仅限于 `Class.Instance` 的直接子女。

  ##### 检查对象的存在

  `FindFirstChild()` 必须如果你需要在继续前验证对象存在。尝试使用 dot 运营符索引子女按名称索引时，如果子女不存在，将抛出错误。

  ```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` 相同。当使用点运营符时，如果属性共享名称，它们会在孩子之前占据优先权。

  在以下示例中，一个 被添加到 ，这也有 属性。注意到 `part.Color` 指的是 `Datatype.Color3` 属性值，而不是子 `Class.Folder` 实例。使用 `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()` 使用点运营符比使用 dot 运营符多花费约 20% 时间，几乎是存储对象引用的 8 倍。因此，您应该避免在紧密循环或连接到 `Class.RunService.Heartbeat` 和 `Class.RunService.PreRender` 的函数中调用它。相反，将结果存储在变量中，或考虑使用 `Class.Instance.ChildAdded|ChildAdded` 或 `Class.Instance:WaitForChild()|WaitForChild()` 来检测给定名称的子域何时可用。

Instance:FindFirstChild

recursive

返回找到给定名称的 `Class.Instance` 的第一个孩子。

返回 `Class.Instance` 的第一个孩子，其 `Class.Object.ClassName|ClassName` 与给定的 `className` 相等。与 `Class.Instance:FindFirstChildWhichIsA()` 不同，这个函数只返回那些类匹配 `className` 的对象，忽略了类继承。如果未找到匹配的子，该函数返回 `nil` 。

Instance:FindFirstChildOfClass

返回 `Class.Instance` 的第一个孩子，其 `Class.Object.ClassName|ClassName` 与给定的类名相等。

返回 `Class.Instance` 为谁 `Class.Object:IsA()` 返回真实给定类别的第一个孩子。

  如果未找到匹配的子，该函数返回 `nil` 。如果可选递归性参数为真值，此函数搜索所有子孙，而不仅限于 `Class.Instance` 的直接子女。

  与 `Class.Instance:FindFirstChildOfClass()` 不同，此函数使用 `Class.Object:IsA()` ，这与类继承有关。例如：

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

  因此，以下代码示例将返回第一个 `Class.BasePart` 子，无论是 `Class.WedgePart` 、 `Class.MeshPart` 还是 `Class.Part` 。

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

  寻找名称的孩子的开发人员应该使用 `Class.Instance:FindFirstChild()` 而不是。

Instance:FindFirstChildWhichIsA

要搜索的 `Class.Object.ClassName` 。

返回 `Class.Instance` 为谁 `Class.Object:IsA()` 返回真实给定类别的第一个孩子。

返回找到的第一个子孙，使用给定的 `Class.Instance.Name` 。

  该方法已禁用且无法使用。要找到实例的第一个后裔，请考虑使用 `recursive` 参数在 `Class.Instance:FindFirstChild()` 上。

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` 事件相似的事件，除了它仅在特定给定属性发生变化时发射外，实际上与 `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` 与对象相等。使用数字或通用循环进行遍历时，阵列可以被遍历：

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

  -- 通用循环示例
  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` 的连接，用逗号分开。不考虑 `Class.DataModel` ( `game` )。例如，一个 `Class.Part` 在 `Class.Workspace` 中可能返回 `Class.Workspace.Part`。

  当调用到一个 `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 的 [属性](/studio/properties) 窗口或在运行时添加标签 `Class.Instance:AddTag()|AddTag()` .

  当您想要一次使用多个标签对实例进行操作时，此方法很有用。然而，使用此方法检查单个标签的存在是不高效的；相反，使用 `Class.Instance:HasTag()|HasTag()` 检查特定标签。

Instance:GetTags

获取应用于实例的所有标签的阵列。

该方法返回 `true` 如果提供的标签已添加到对象。您可以在 Studio 的 [属性](/studio/properties) 窗口或运行时添加标签 `Class.Instance:AddTag()|AddTag()`。

Instance:HasTag

Instance

`Instance` 是 Roblox 类层次中所有类的基础类，可以组成 `Class.DataModel` 树。

/reference/engine/classes/StarterPlayer.yaml