包裹

*此內容是使用 AI(Beta 測試版)翻譯,可能含有錯誤。若要以英文檢視此頁面,請按一下這裡


要在您的團隊或多個項目中保持資產有組織且可重用,請將您的實例組合成可重用 。包使整個建世界的過程更快速並更友好,但它們也幫助您與一致性、重複、協作和版本化:

  • 容易地 更新所有複製的包裹到最新版本 (或只有 更新特定複製的包裹) )。
  • 將包裹設置為 自動更新 ,每當有新版本。
  • 提供 編輯 或 使用 權限給包裹內容。
  • 檢視包裹的完整版本歷史,比較版本,並還原舊版本。

最有效的工作流程是創建包裹 並與任何合作者分享 ,然後將其設定為自動更新 並且不需要等待模型成為 "完成" 前才能在包裹中使用。即使是簡單形狀的廣告牌在眾多更詳細的版

創建包裹

您可以從任何單一對象或任何單一父親和子女分支的對象創建包。如果您想為單一對物件創建包,我們建議先添加它到 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 窗口中收到「鏈綁定符號」,以便在 Package 中識別。此外,您可以在對象上看到新的 PackageLink 對象,與對物件相關。

    A maple tree model in the Explorer window with the package icon next to it.
  5. (可選) 選擇 包裹鏈接 對象,並在 AutoUpdate 窗口中啟用 自動更新 。注意圖示如何變更,表示包裹設定為自動更新。

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

插入包裹

要插入尚未在當前空間置存在的包裹,您必須先從 工具箱 中插入它:

  • 清單我的包裹 為您發布到或從 創作者商店 取得的包裹,以及您朋友擁有並且已給您 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. 描述您的變更,然後按一下 提交

更新過時的副本

您可以將過時的包裹副本更新到最新版本,或者您可以繼續使用較舊的版本。

要更新一個或多個包裹複製到最新版本:

  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. 屬性 窗口中,啟用 自動更新 屬性。如果您有 樹狀包 ,此屬性只適用於最高層級的父親包,即自動更新只會在父親包被更新時發生。

分享和存取等級

如果需要,您可以與朋友分享包裹或授予特定用戶角色在您的群組中的存取權限。

  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.
      許可說明
      編輯 角色成員可以使用、查檢視和編輯目前和以前的包裹版本,包括發布變更以及。 從此視窗授權編輯存取權限的角色,只會對 特定包裹 進行存取。
      沒有權限 角色成員沒有 access 到任何新版本的包裹,雖然他們保留在該空間置插入的當前版本的存取權限。
    • 對於 擁有用戶的 包裹,在搜尋欄位中搜尋朋友,然後按一下他們的使用者名稱,並選擇一個權限等級。

      許可說明
      使用和檢視 使用者可以使用並檢視 (但不能編輯) 目前和舊版本包裹版本。 一旦提供使用者此能力,您就無法撤回他們已經插入到體驗的複製人; 撤回檢視權限防止重新插入或包裹更新,但包裹複製人在其資料模型中保持完整。
      編輯 使用者可以使用、檢視、編輯目前和以前的包裹版本,包括發布變更。

修改包裹

您可以像其他物件一樣編輯包和其子包。修改包會使自動更新無效,直到您發布或還原變更。

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

大多數編輯都會標為包裝為已修改,雖然以下變更是 被視為包裝變更:

  • 變更根節的 名稱
  • 變更 位置 或 旋轉 根節的包裹的根節的 BasePart 或 2>旋轉2> 。
  • 變更 啟用 屬性的根節 GuiObject ,例如 ScreenGui 、 2>Class.SurfaceGui2> 或 5>Class.BillboardGui5> 。
  • 在包裹內參照 Weld 的零件。

修改後,未發佈變更的包裹會在 Explorer 窗口中顯示變更圖示:

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

添加或更新設定

您可以在包裹的根部包括 案例屬性 來自訂其行為,例如包裝車輛的最大速度或包裝按鈕的暫時撤離時間。

當您發布包裹時,目前的屬性/值將會成為包裹的 預設設定 。在任何包裹的複製上顯示配置會在 強調標題 中顯示,這些屬性值可以在 每個實例上 變更。當包裹複製更新時,變更的配置值將會保留,而其他屬性值將會更新

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.

組合包腳本

未修改 包裹內的每個指令碼只閱取,並且在頂部有超級鏈接顯示通知。

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> 區塊的 4>頁面4> 中選擇。

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.
  • 指令碼 顯示線行碼 script 差異。 它可用於包含指令碼的包裹,無論是否為根對象。

    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. 開啟的差分標籤中,比較選取的指令碼在當前包裹副本和最新發佈或本地版本之間的所有變更。