包裝

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


若要將資產整理並在團隊或多個項目中重複使用,請將實例群組化並轉換為可重複使用的 包裝 。包裝可以加快整體世界建造的速度和舒適度,但它們也可以幫助穩定性、去重複、協作和版本控制:

  • 輕鬆 更新包裝的所有副本 到最新版本 (或只更新特定副本)。
  • 將包裝設為自動更新,每當有新版本時。
  • 給予合作者 編輯使用 包裹內容的權限。
  • 查看包裝的完整版本歷史記錄,比較版本,並恢復舊版本。

最有效的工作流程是創建包與任何合作者共享,並設為自動更新。你也不需要等待模型在包裝中使用之前「完成」。即使包裹是簡單形狀頂部的暫時器,你也可以使用它來灰箱你的環境,然後暫時器的副本會在你發布更詳細版本時自動更新。

創建包裝

您可以從任何單一對象或任何單一父母和子分支對象創建包。如果您想為單一對物件創建包裹,我們建議先將其添加到 Model 集群中,以便您稍後在包裹內添加、新增 加至除或擴展實例,而不會破壞包裹。

  1. 檢索器 視窗或 3D 視角中,右鍵單擊所需對象,然後選擇 轉換為包裝

  2. 在新視窗中,填寫包裹細節。特別是,如果你在 群組 工作,將 所有權 設為你有權創建/編輯群組體驗的適當群組。

  3. 點擊 提交

  4. 轉換完成後,對象會在 Explorer 窗口中收到「鏈綁定」符號,以識別它為包裝。此外,您可以看到一個新的 包聯結 對象,被賦予到對物件。

    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.

插入包裝

若要插入尚未在目前空間置中存在的包,您必須 工具箱 插入它:

  • 庫存 > 我的包裹 對於你發布到或從 創作者商店 獲得的包裹,以及朋友擁有並給予你 權限 使用的包裹。
  • 創作 > 群組包 對發布於你 群組 成員的包(包括你自己)的包進行包裝。
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.

工具箱 ⟩ 創作 ⟩ 群組包
>

一旦你將包裹插入到發布位空間的數據模型中,它就會出現在 資產管理器 中,即使稍後刪除所有副本,它也會保留在那裡。

發布包裹變更

您可以將包裝中所做的任何變更發布為新版本,以便在整個地方和所有體驗中提供給其他包裝副本。請注意,在發布位置之前發布修改的包並不需要 必須 發布修改的包 (修改版本與位置一起保存以供未來回合使用)。

要發布包裝的變更:

  1. 檢索器 視窗或 3D 視角中,右鍵單擊修改的副本並選擇 發布到包裝

  2. 如果包裝副本啟用了自動更新,當您開啟包含它們的地方時,它立即拉取更新版本。其他副本會在包裝圖示上獲得白色點,表示可用更新。您可以 個別更新批量更新 它們,根據需求。

    Two packages in the Explorer set to auto-update, and one with an update available.
  3. (可選) 添加您的變更說明:

    1. 右鍵單擊包裹,然後選擇 包裹詳情
    2. 在資產配置窗口中,選擇 版本
    3. 在你最新的變更下,選擇 新增
    4. 描述您的變更,然後單擊 提交

更新過期的副本

您可以將過時的包裝副本升級到最新版本,或繼續使用較舊版本。

要將一個或多個包副本升級到最新版本:

  1. 導航器 窗口中,使用包裹圖示上的白色點找到過期的副本。您也可以在 3D 視角中選擇過時的副本,但可能會更難找到這種方式。

    Two packages in the Explorer set to auto-update, and one with an update available.
  2. 右鍵單擊過期的副本,然後選擇 取得最新包 。您也可以選擇多個包,右鍵單擊,然後 取得選擇的包最新版本

大規模更新

廣泛使用包可能會導致體驗中的多個地點上的許多包副本。除了 個別同步自動更新 外,您還可以通過 批量更新 來更新包裝的所有副本。

  1. (建議) 關閉其他開啟體驗地點的 Studio 實例,以防另一個尚未儲存的地點實例潛在地覆蓋您的更新。

  2. 檢索器 視窗或 3D 視角中,右鍵單擊所需包裹,然後選擇 全部更新

  3. 選擇體驗中的所有地點或一些地點子片,然後單擊 更新

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

    為了防止意外覆蓋,大規模更新不會影響包裝的 修改 版本。大規模更新完成後,Studio 會顯示警告,包括它沒有更新的包數量 更新,如果有。

自動更新

為了讓同步更容易,您可以設置包裹副本每次發布新版本時自動更新。當在 Studio 中開啟一個地方時,包裝副本的自動更新將發生。

  1. 導航器 窗口中,擴展包的階層樹並選擇其 包裝鏈 對物件。

    A close up view of a packaged chandelier model in the Explorer window. The PackageLink object is highlighted.
  2. 屬性 窗口中,啟用 自動更新 屬性。如果你有 巢穴包,這個屬性只適用於最高等級的父包,即自動更新只會發生當 父包 被更新時。

分享和存取等級

如果需要,您可以與朋友分享包裹或向群組內的特定使用者角色提供訪問權限。

  1. 檢索器 視窗中, 工具箱資產管理器 ,右鍵單擊所需包裹,然後選擇 包裹詳情

  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.

大多數編輯將包裹標記為已修改,雖然下列變更不被視為包裹修改:

  • 變更根節點的 名稱
  • 變更包裝根節點的 位置旋轉 ,如果包裝是 BasePartModelGuiObject
  • 變更根節點 啟用 屬性,例如 、 或 。
  • 變更包裝內包含一個外部包的實例參考的 Weld 內的零件參考。

一旦修改,未發布變更的包在 勘误器 視窗中會獲得修改的圖示:

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.

點擊超鏈接:

  • 無論您編輯腳本還是否編輯腳指令碼,都會標記包為已修改。
  • 從包裝內的 其他 腳本中移除通知/超鏈接。

發布包並移至未修改狀態後,包含其下的腳本將變為只讀狀態,並帶有修改超鏈接。

撤回包裝變更

您可以在一個行動作中撤銷未發布的變更,將包裝恢復到以前的版本,或恢復變更到特定的配置

恢復未發布的變更

要取消整個系列的 未發布 變更:

  1. 導航器 窗口中,找到旁邊的問號標示的修改副本。您也可以在 3D 視角中選擇修改的副本,這可能更簡單。

  2. 右鍵單擊一個修改的副本,然後選擇 取消包裝變更 ,或選擇多個副本(至少一個已修改),右鍵單擊,然後選擇 取消選擇的包裝

恢復到版本

要將包恢復到 以前發布 版本:

  1. 檢索器 視窗中,3D視角、 工具箱資產管理器 ,右鍵單擊所需包裹,然後選擇 包裹詳情

  2. 資產配置 窗口中,選擇 版本 。該窗口顯示每個發布版本的詳情,包括發布日期和時間,以及任何更改的說明。

  3. 點擊版本旁邊的檢查標記,然後點擊 提交

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

恢復配置

若要將任何 配置 屬性恢復至預設值,請在 屬性 區域的 裝備選單 中選擇 重設 選項。

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. 檢索器 視窗或 3D 視角中,右鍵單擊目標包並選擇 比較包版本

  2. 預設情況下,窗口會比較您的本地副本與最新版本之間的變更。使用兩個下拉選單來比較不同版本。

    A close up view of an example diff viewer. The compare settings are highlighted.
  3. 選擇版本後:

    • 若要比較根模型的視覺渲染,如果適用,請選擇 視覺概觀 標籤,並調整相機控制以達到所需的角度。控件在視窗之間同步:

      • 使用左鍵點擊攝影機。
      • 使用右鍵點擊旋轉相機。
      • 使用滑鼠輪縮放相機。
      • 使用快捷鍵 -F 重新中心化。
    • 要比較實個體、實例的屬性和特性,請選擇實例和 屬性 標籤。

    • 若要比較腳本差異,如果適用,請選擇任何腳本以開啟 腳本 標籤,用於比較您選擇的版本之間的行狀變更,類似於來源控制應用程式。

或者,您可以直接開啟腳本差異工具:

  1. 導航器 視窗或 3D 視角中,右鍵單擊目標包裹,該包裹必須是腳本或包含腳本,然後選擇 查看腳本變更
  2. 在開啟的差異標籤中,比較選擇的腳本的所有變更與當前包裹副本和最新發布或本地版本之間。