包裹

*此内容使用人工智能(Beta)翻译,可能包含错误。若要查看英文页面,请点按 此处


要在您的团队或多个项目之间组织资产并使其在多个项目中重用,请将实例组合成可重用的 。包使建世界的整个过程更快 и更易于操作,但它们还可以帮助您与一致性、重复、协作和版本化:

最有效的工作流程是创建一个包裹、与任何合作者共享设置它为自动更新。 您不需要等待模型完成,然后才能使用它在包裹中。 即使是简单形状的替换器在顶部,您也可以使用它来1>灰箱您的环境

创建包裹

您可以从任意单个对象或任意单个父子树中创建包裹。如果您想为单个对象创建包裹,我们建议先将其添加到一个 Model 组,然后才能在包裹中添加、移除或缩放实例。

  1. 在 Explorer 窗口或 3D 视图中,右击目标对象,然后选择 转换到包裹

    The context menu that display when you right-click an object in the Explorer window. The Convert to Package menu item is highlighted.
  2. 在新窗口中,填写包裹详细信息。 特别是如果您在 群组 中工作,请将 所有者 设置为您所有权限创建/编辑群组体验的适当群组。

  3. 单击 提交

  4. 转换完成后,对象在 Explorer 窗口中收到 “关联接符” 符号,以便将它确定为包裹。 您还可以看到一个新的 PackageLink 对象,其父对象为对象。

    A maple tree model in the Explorer window with the package icon next to it.
  5. (可选) 选择 PackageLink 对象,并在 AutoUpdate 窗口中启用 自动更新 。注意图标变更为表示包裹自动更新。

    A maple tree model in the Explorer window with the auto-update package icon next to it.

插入包裹

要插入当前场景方中尚未存在的包裹,您必须首先从工具箱中插入它:

  • InventoryMy Packages 对于你发布到或从创建者商店获得的包裹,以及你朋友拥有和给予你1>权限1>的包裹。
  • 创建 → 组合包裹 为您的 群组 成员发布的包裹(包括您自己)。
A close up view of the Toolbox with both the Inventory tab and the assets dropdown menu highlighted.
工具箱 → 物品栏 → 我的包裹
A close up view of the Toolbox with the Creations tab highlighted.
工具箱 → 创建 → 组合包裹

一旦您将包裹插入到某个场景方的数据模型中,它就会出现在 包裹 文件夹的 资源管理器 中,即使您稍后删除所有副本。但是,当您发布该场景时,文件夹会更新,以反映仅在该场景方使用的包裹。

The Asset Manager window with a few example packages.
资产管理器中的包裹

发布包裹更改

您可以将您对包裹的任何更改发布为新版本,以便在其他版本的包裹上使其可用。 注意,在发布地方之前(发布包裹的修改版本),您不需要发布一个已更改的包裹。

要发布更改到包裹:

  1. 在 Explorer 窗口或 3D 视图中,右击复制的内容,然后选择 发布到包裹

    The context menu that display when you right-click an object in the Explorer window. The Publish to Package menu item is highlighted.
  2. 如果包裹副本有自动更新设置,它们会在您打开包含它们的地方时立即拉入更新版本。其他副本上的复制会在包裹图标上的白点上显示更新可用性。您可以单独更新批量更新它们,根据需要。

    Two packages in the Explorer set to auto-update, and one with an update available.
  3. (可选) 添加您的更改的描述:

    1. 右击包裹,然后选择 包裹详细信息
    2. 在资产配置窗口中,选择 版本
    3. 在您最近的更改下,选择 添加
    4. 描述您的更改,然后单击 提交

更新过期的副本

您可以将过期的包裹副本更新到最新版本,或者您可以继续使用较旧的版本。

要将 one 或多个包裹副本更新到最新版本:

  1. Explorer 窗口中,找到包裹图标上的白色点击标记更旧的副本。您也可以在 3D 视图中选择更旧的副本,但可能会更难找到此方法。

    Two packages in the Explorer set to auto-update, and one with an update available.
  2. 右击旧版本的复制品,然后选择 获取最新包裹 。您还可以选择多个包裹,右击,然后选择 获取选定包裹

批量更新

过度使用包裹可能会导致在体验中的多个地点上的多个包裹副本。 在 单独同步 和 自动更新 之外,您可以通过 批量更新 更新包裹的所有副本。

  1. (推荐)关闭其他 Studio 实例,打开体验的地方之一,以防其他未保存的地方可能覆盖您的更新。

  2. 在 Explorer 窗口或 3D 视图中,右击所需包裹,然后选择 更新所有

  3. 选择体验中的所有地方或者某个子集地方,然后单击 更新

    A view of the mass update window, showing two places.

    为了防止意外的覆盖,大规模更新不会影响包裹的 改装版本 。 在大规模更新完成后,Studio 会显示一个警告,显示它所做的 不更新 包裹,如果有。

自动更新

为了使同步更轻松,您可以将包裹副本设置为自动更新,以便在发布新版本时自动更新。当一个地方在 Studio 打开时,会发生包裹副本的自动更新。

  1. Explorer 窗口中,扩展包裹的层级树,然后选择其 PackageLink 对象。

    A close up view of a packaged chandelier model in the Explorer window. The PackageLink object is highlighted.
  2. 在属性窗口中,启用自动更新属性。如果您有嵌套包,该属性仅适用于最高级父亲包,这意味着只有2>父亲包2>才能发生自动更新。

共享和访问级别

如果需要,您可以与朋友共享包裹或向您的群组中的特定用户角色授予访问权限。

  1. 在 Explorer、Toolbox 或 Asset Manager 中,右击目标包裹,然后选择 包裹详细信息

  2. 在资产配置窗口中,选择 权限

    • 对于一个 群组拥有 包裹,扩展角色树。然后选择每个角色的权限级别。禁用的选择框表示权限已经配置为该角色,无法从此窗口更改。

      A close up view of some settings in the pop-up window. The arrow icon next to the group icon and the member Edit dropdown menu are highlighted.
      权限描述
      编辑 角色成员可以使用、查看和编辑当前和上一个包裹版本,包括发布更改。 从此窗口授予编辑访问权限的角色只能访问 特定包裹
      无法访问 角色成员不会接受任何新版本的包裹,尽管他们保留在当前版本插入到位场景的访问权限。
    • 对于一个 用户拥有 包裹,通过搜索字段搜索朋友,单击其用户名,然后选择一个权限等级。

      权限描述
      使用和查看 用户可以使用和查看 (但不能编辑) 当前和上一个包裹版本。 一旦您向用户提供此能力,您无法对他们插入的复制体验中恢复访问权限;恢复访问防止重插或更新包裹,但复制体验中的包裹仍然完整。
      编辑 用户可以使用、查看和编辑当前和上一个版本的包裹,包括发布更改。

修改包裹

您可以像其他对象编辑包和其子包。修改包会使自动更新关闭,直到您发布或恢复更改。

The pop-up notice that you cannot update a modified package until you publish or revert your changes.

大多数编辑将包裹标记为已修改,尽管以下变更是 被视为包裹修改:

  • 改变 root 节点的名称
  • 改变 位置 或 旋转 根节的包裹的根节的位置,BasePart 、2> Class.Model2> 或 5> Class.GuiObject5> 。
  • 改变 启用 属性的根节的 GuiObject ,例如一个 ScreenGui 、2> Class.SurfaceGui2> 或 5> Class.BillboardGui5> 。
  • 改变一个 Weld 的零件参考,可以在包裹外的实例上参考。

一旦修改,未发布的更改将在 Explorer 窗口中显示改变:

The Explorer window with an icon that identifies unpublished package changes.

添加或更新配置

您可以在包裹的根部分包含实例属性来自定义其行为,例如包装车辆的最大速度或包装按钮的弹出时间。

当您发布包裹时,当前的属性/值将变为包裹的 默认配置 。 在任何包裹的副本上,配置都显示在 bold italics 中,这些属性值可以在实例上的任何时候更改。 当包裹复制更新时,更新后的配置值将被保留,而其他属性将被更新到最新默认值。

The Attributes section of the Properties window. Two properties are highlighted as having their default values while two other italicized properties are highlighted to show they have been configured.

子包裹

您可以将包裹嵌套在其他包裹中以便在复杂的层级结构中进行管理和协作,例如包含在车辆父包中独立于车辆的四个车轮机甲部件。此示例显示一个包裹,其中包含四个复制同一轮胎包的车轮机甲部件:

An expanded hierarchy in the Explorer window showing how packages can contain packages.

包裹脚本

未修改 包内的每个脚本都是只读的,并且顶部有一个 hyperlink 以解锁脚本。

A script tab with a yellow notification that you can click to modifiy the script that's within an unmodified package.

点击超链接:

  • 无论您编辑脚本还是否编辑包,都会标记包裹。
  • 将通知/超链从 其他 脚本移除在包裹内。

发布包裹并将其移动到 未修改 状态后,其下的脚本将变为只读,具有超链接以修改。

恢复包裹更改

相反,您可以在一次操作中 撤销一系列包裹更改 ,恢复发布前的更改 ,或将包裹恢复到以前版本 或恢复更改到特定 配置

恢复未发布的更改

要撤销一个整个 series of 未发布 更改:

  1. 在 Explorer 窗口中,按照上方的问号找到修改的副本。您也可以在 3D 视图中选择修改的副本,这可能更容易。

  2. 右击单个修改的副本,然后选择 撤销更改包裹 ,或选择多个副本 (至少其中一个已修改) ,然后右击,然后选择 撤销更改选定包裹 .

恢复到版本

要将包裹恢复到以前发布的版本:

  1. 在 Explorer 窗口、3D 视图窗、工具箱或资产管理器中,右击目标包裹,然后选择 包裹详细信息

  2. 在资产配置窗口中,选择 版本 。 窗口显示每个发布的版本的详细信息,包括发布日期和时间以及任何对更改的描述。

  3. 点击您想要恢复的版本旁边的复选标记,然后单击 提交

    The pop-up window for a chandelier asset. It displays multiple versions.

恢复配置

要将任何 配置 属性恢复为默认值,请从 属性 部分的 属性 窗口中选择 1>重置1> 选项。

The Attributes section of the Properties window. The gear menu is expanded and the Reset menu item is highlighted.

比较包裹版本

当包裹有多个版本时,您可以使用差分视图,这是查看包裹更新、比较您的本地更新与最新版本、并检查过去版本中的内容前进行检查的好助手。

该工具有一个包裹层级菜单,该菜单指示在相应的图标之间添加、移除或修改的实例,并且提供以下选项卡:

  • 视觉概览 显示 3D 渲染下的不同镜头位置下的视觉差异。 它是包裹中带有 3D 对象 (模型、零件) 作为根对象的默认视图,并且目前仅对根对象可用。

    An example of the Visual Overview tab in the diff viewer. One version of a building displays on the left-hand side, and another on the right-hand side.
  • 属性 显示属性和属性的更改。它是非3D对象(脚本、灯、2D对象)作为根对象的包裹的默认视图,并且可以为包裹中的所有实例提供服务。

    An example of the Properties tab in the diff viewer. Modified properties in different versions are highlighted.
  • 脚本 显示行列中的脚本差异。它对于包含脚本的包裹,无论是否为根对象。

    An example of the Script tab in the diff viewer. Modified script lines in different versions are highlighted.

要将包裹版本进行比较:

  1. 在 Explorer 窗口或 3D 视图中,右击目标包裹,然后选择 比较包裹版本

  2. 默认情况下,窗口会比较您的本地副本和最新版本之间的更改。 使用两个下拉菜单来比较不同版本。

    A close up view of an example diff viewer. The compare settings are highlighted.
  3. 选择版本后:

    • 要比较根模型的视觉渲染,如果适用,请选择 视觉概览 选项卡并调整相机控制以达到您想要的角度。控制在视图之间同步:

      • 使用左键点击来旋转相机。
      • 使用右键点击旋转相机。
      • 使用鼠标轮子放大和缩小相机。
      • 使用键盘快捷方式 -F 重新显示。
    • 要比较实例的属性和属性,请选择实例和 属性 选项卡。

    • 要比较脚本差异,如果适用,请选择任何脚本打开 脚本 选项卡之间的行-行之间的更改,类似源控制应用程序。

或者,您可以直接打开脚本差异工具:

  1. 在 Explorer 窗口或 3D 视图中,右击目标包裹,它必须是脚本或包含脚本,然后选择 查看脚本更改
  2. 在打开的差异选项卡中,比较选定的脚本之间的所有更改,包括当前包裹副本和最新发布版本或本地版本。