Gói

*Nội dung này được dịch bằng AI (Beta) và có thể có lỗi. Để xem trang này bằng tiếng Anh, hãy nhấp vào đây.


Để giữ các tài nguyên được tổ chức và tái sử dụng trên toàn bộ một nhóm hoặc trên nhiều dự án, hãy tập hợp các instância của bạn và chuyển chúng thành những gói tái sử dụng **** packages . Các gói tăng quá trình xây dựng thế giới nhanh hơn và đồng b

  • Dễ dàng cập nhật tất cả các bản sao của một gói lên phiên bản mới nhất (hoặc chỉ cập nhật những bản sao cụ thể).
  • Cài đặt các gói tự động cập nhật mỗi khi có một phiên bản mới.
  • Đưa người hợp tác Chỉnh sửa hoặc Sử dụng quyền truy cập vào nội dung của một gói.
  • Xem lịch sử phiên bản đầy đủ cho một gói, so sánh các phiên bản và khôi phục các phiên bản cũ.

Workflow hiệu quả nhất là tạo một gói</g> , chia sẻ nó với bất kỳ nhà hàng đóng góp nào và thiết lập nó để tự động cập nhật . Và bạn không cần ph

Tạo Gói

Bạn có thể tạo một gói từ bất kỳ đối tượng nào hoặc bất kỳ chi nhánh con của đối tượng nào. Nếu bạn muốn tạo một gói cho một đối tượng, chúng tôi khuyến nghị thêm nó vào một nhóm Model để bạn có thể thêm, bỏhoặc mở rộng m

  1. Trong cửa sổ Explorer hoặc 3D viewport, nhấp chuột phải vào đối tượng được muốn và chọn Gửi đến Package .

    The context menu that display when you right-click an object in the Explorer window. The Convert to Package menu item is highlighted.
  2. Trong cái mới màn hình, hãy điền vào chi tiết gói. Đặc biệt, nếu bạn đang làm việc trong một nhóm , thiết lập Sở hữu cho nhóm phù hợp mà bạn có quyền tạo/chỉnh sửa trải nghiệm nhóm.

  3. Nhấp vào Gửi đi .

  4. Sau khi chuyển đổi hoàn tất, đối tượng nhận một biểu tượng "chain liên kết" trong cửa sổ Explorer để xác định nó như một gói. Đồng thời, bạn có thể thấy một đối tượng mới PackageLink được gắn với đối tượng.

    A maple tree model in the Explorer window with the package icon next to it.
  5. (Tùy chọn) Chọn đối tượng PackageLink và bật AutoUpdate trong cửa sổ Properties . Lưu ý là biểu tượng thay đổi để cho thấy rằng gói đã được cài đặt để tự động cập nhật.

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

Gắn gói

Để tạo một gói không tồn tại trong địa điểmhiện tại, bạn phải ban đầu nó từ Hộp công cụ :

  • Từ InventoryMy Packages cho các gói bạn đã phát sóng hoặc nhận từ Creator Store , cũng như các gói mà một người bạn sở hữu và đã cho bạn 1> quyền truy cập1> để sử dụng.
  • Từ CreationsGroup Packages cho các gói đã được xuất bản bởi các thành viên trong nhóm của bạn (bao gồm bạn).
A close up view of the Toolbox with both the Inventory tab and the assets dropdown menu highlighted.
Hộp công cụ → Inventory → My Packages
A close up view of the Toolbox with the Creations tab highlighted.
Hộp công cụ → Sáng tạo → Gói nhóm

Một khi bạn đã đặt một gói vào mô hình dữ liệu của một địa điểm, nó xuất hiện trong thư mục Gói của Quản lý tài sản và vẫn ở đó ngay cả khi bạn sau đó xóa tất cả bản sao của nó. Tuy nhiên, khi bạn đăng nơ

The Asset Manager window with a few example packages.
Gói trong Quản lý tài sản

Xuất thay đổi gói

Bạn có thể xuất bản bất kỳ thay đổi nào bạn thực hiện cho một gói làm mới nó thành phiên bản mới để có thể khiến nó có sẵn cho các bản sao khác của gói trên toàn nơi và trên tất cả các trải nghiệm. Lưu ý rằng nó không yêu cầu để x

Để xuất bản các thay đổi vào một gói:

  1. Trong cửa sổ Explorer hoặc 3D viewport, nhấp chuột phải vào bản sao đã được chỉnh sửa và chọn Xuất bản đến Package .

    The context menu that display when you right-click an object in the Explorer window. The Publish to Package menu item is highlighted.
  2. Nếu một bản sao gói có tự động cập nhật được bật, nó ngay lập tức kéo vào phiên bản đã cập nhật khi bạn mở nơi chứa chúng. Các bản sao khác có dấu chấm trắng trên icon gói cho thấy có sẵn một cập nhật. Bạn có thể <

    Two packages in the Explorer set to auto-update, and one with an update available.
  3. (Tùy chọn) Thêm một mô tả về các thay đổi của bạn:

    1. Nhấp chuột phải vào gói và chọn Thông tin gói .
    2. Trong cửa sổ Tùy chỉnh tài sản, chọn Phiên bản .
    3. Dưới sự thay đổi gần đây nhất của bạn, hãy chọn Thêm .
    4. Mô tả các thay đổi của bạn và nhấp vào Gửi .

Cập nhật các bản sao bị lỗi

Bạn có thể cập nhật bản sao gói cũ đến phiên bản mới nhất, hoặc bạn có thể tiếp tục sử dụng phiên bản cũ.

Để cập nhật một hoặc nhiều bản sao gói tới phiên bản mới nhất:

  1. Trong cửa sổ Explorer, tìm những bản sao cũ kỹ nằm trên dấu chấm trắng trên hình ảnh biểu tượng. Bạn cũng có thể chọn những bản sao cũ kỹ nằm trong cửa sổ 3D, nhưng có thể khó hơn để tìm thấy cách này.

    Two packages in the Explorer set to auto-update, and one with an update available.
  2. Nhấp chuột phải vào bản sao cũ và chọn Nhận gói tài nguyên mới nhất . Bạn cũng có thể chọn nhiều gói, nhấp chuột phải và Nhận gói tài nguyên đã được chọn .

Cập nhật hàng loạt

Sử dụng rộng rãi các gói có thể dẫn đến nhiều bản sao gói trên nhiều nơi trong một trải nghiệm. Ngoài ra, bên cạnh sincronization cá nhân và cập nhật tự động, bạn có thể cập nhật tất cả các bản sao của một gói thông qua cập nhật hàng loạ

  1. (Được khuyến nghị) Đóng các Instanz Studio khác với bất kỳ nơi nào của trải nghiệm đang mở; điều này ngăn chặn một Instanz không lưu khác của một nơi khỏi việc quá mức quét các cập nhật của bạn.

  2. Trong cửa sổ Explorer hoặc 3D viewport, nhấp chuột phải vào gói đã định và chọn Cập nhật tất cả .

  3. Chọn tất cả các nơi trong trải nghiệm hoặc một số thuộc tính nhỏ hơn của nơi và nhấp vào Cập nhật .

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

    Để ngăn chặn những lỗi trùm ý nghĩa, việc cập nhật hàng loạt không ảnh hưởng đến phiên bản đã được cập nhật của một gói. Sau khi việc cập nhật hàng loạt hoàn tất, Studio hiển thị một cảnh báo với số lượng gói mà nó đã không cập n

Cập nhật tự động

Để làm cho việc sao chép dễ dàng hơn, bạn có thể thiết lập một bản sao gói để cập nhật tự động mỗi khi một phiên bản mới được phát hành. Tự động cập nhật các bản sao gói sẽ diễn ra khi một nơi được mở ở Studio.

  1. Trong cửa sổ Explorer, mở rộng cây thư mục gói và chọn đối tượng PackageLink của nó.

    A close up view of a packaged chandelier model in the Explorer window. The PackageLink object is highlighted.
  2. Trong cửa sổ Tính chất, bật các tính chất Cập nhật tự động . If you have các gói tổng quát , thì tính chất này chỉ áp dụng cho tính chất cấp cao nhất, có nghĩa là các cập nhật tự động chỉ xảy ra khi tính chất cấp cha được cậ

Chia sẻ và quyền truy cập cấp độ

Nếu muốn, bạn có thể chia sẻ các gói với bạn bè hoặc cấp quyền truy cập đến các vai trò người dùng cụ thể trong nhóm của bạn.

  1. Trong Explorer, Toolbox hoặc Asset Manager, right-click vào gói đã định và chọn Thông tin gói .

  2. Trong cửa sổ Tùy chỉnh tài sản, chọn Các quyền truy cập .

    • Đối với một gói thuộc sở hữu nhóm, hãy mở rộng cây những vai trò. Sau đó chọn một cấp độ quyền cho mỗi vai trò. Các hộp chọn bị tắt cho thấy rằng quyền đã được cấu hình cho vai trò đó và không thể được thay đổi từ cửa sổ này.

      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.
      Cấp quyềnMô tả
      Chỉnh sửa Các thành viên trong vai trò có thể sử dụng, xem và chỉnh sửa các phiên bản hiện tại và trước đó của gói, bao gồm việc xuất bản các thay đổi vào nó. Việc cấp quyền truy cập đến một vai trò từ cửa sổ này chỉ cho phép truy cập vào bộ gói cụ thể .
      Không có quyền truy cập Các thành viên trong vai trò này không có quyền truy cập vào bất kỳ phiên bản mới của gói, mặc dù họ vẫn giữ quyền truy cập vào phiên bản hiện tại được đặt vào địa điểmđó.
    • Đối với một gói sở hữu người dùng , tìm kiếm bạn bè thông qua trường tìm kiếm, nhấp vào tên tài khoảndùng của họ và chọn một cấp độ quyền.

      Cấp quyềnMô tả
      Sử dụng và xem Người dùng có thể sử dụng và xem (nhưng không thể chỉnh sửa) các phiên bản hiện tại và trước đó của gói nạp. Khi bạn cung cấp cho một người dùng khả năng này, bạn không thể tạm dừng quyền truy cập vào một bản sao mà họ đã tích hợp vào trải nghiệm của họ
      Chỉnh sửa Người dùng có thể sử dụng, xem và chỉnh sửa các phiên bản hiện tại và trước đó của gói, bao gồm việc xuất bản các thay đổi cho nó.

Đổi Package

Bạn có thể chỉnh sửa các gói và con cái chúng như các đối tượng khác. Điều chỉnh các gói tắt cập nhật tự động cho đến khi bạn xuất bản hoặc quay lại các thay đổi.

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

Hầu hết các bản chỉnh sửa đánh dấu gói như đã điều chỉnh, mặc dù các thay đổi sau đây không phải là không xem xét thay đổi gói:

  • Đổi tên của thân cây.
  • Đổi vị trí hoặc quay của thân cây Class.BasePart , 1> Class.Model1> hoặc 4> Class.GuiObject4> .
  • Đổi Đã bật thuộc tính của một thân cây GuiObject như một ScreenGui, 1> Class.SurfaceGui1> hoặc 4> Class.BillboardGui4> .
  • Đổi một tham chiếu phần của một Weld bên trong gói đó đề cập đến một instace bên ngoài gói.

Một khi đã được chỉnh sửa, các gói với những thay đổi chưa được xuất bản nhận được một biểu tượng đã điều chỉnh trong Cửa sổ Explorer :

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

Thêm hoặc Cập nhật cài đặt

Bạn có thể bao gồm các thuộc tính instace ở gốc của một gói để tùy chỉnh hành vi của nó, ví dụ như tốc độ tối đa của một xe hơi đóng gói hoặc thời gian bật lại của một nút đóng gói.

Khi bạn xuất bản một gói, bộ tùy chỉnh/giá trị hiện tại của các thuộc tính/giá trị sẽ trở thành các thiết lập mặc định của gói của gói. Trên bất kỳ bản sao nào của gói, các thiết lậ

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.

Gói Đã Nhúc

Bạn có thể góp góp gói vào các gói khác để duy trì và hợp tác trên các hiện thân cấp độ phức tạp, chẳng hạn như một loạt các gói cơ cấu xe hơi mà có thể được điều chỉnh độc lập với gói cha của xe hơi. Ví dụ này cho thấy một gói xe hơi có chứa bốn bản sao

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

Tập lệnh Package

Mỗi script trong một gói chưa được chỉnh sửa là chỉ đọc và hiển thị thông báo ở trên với một liên kết hyperlink để mở khóa script.

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

Nhấp vào liên kết:

  • Đánh dấu gói như đã chỉnh sửa dù bạn có chỉnh sửa script hay không.
  • Loại bỏ thông báo/liên kết hyperlink từ các script khác trong gói.

Khi gói được xuất bản và di chuyển đến một không được chỉnh sửa trạng thái, các script dưới nó trở nên đọc chỉ với một liên kết hyperlink để chỉnh sửa.

Quay lại Thay đổi Gói

Thay vì làm mất một loạt các thay đổi gói từng bước, bạn có thể quay lại những thay đổi chưa được xuất bản trong một hành động, khôi phục một gói tới một phiên bản trước đó hoặc quay lại các thay đổi đến các cấu hình cụ thể.

Quay lại những thay đổi chưa được xuất bản

Để huỷ một loạt các thay đổi không xuất bản trong một loạt các thay đổi:

  1. Trong cửa sổ Explorer, tìm các bản sao đã được chỉnh sửa bằng dấu chấm câu đến bên cạnh tên của chúng. Bạn cũng có thể chọn các bản sao đã được chỉnh sửa trong cửa sổ 3D, which có thể dễ dàng hơn.

  2. Nhấp chuột phải vào một bản sao đã được chỉnh sửa và chọn Hủy thay đổi về Gói , hoặc chọn nhiều bản sao (ít nhất một bản sao đã được chỉnh sửa), nhấp chuột vào, và chọn Hủy thay đổi về Gói đã chọn .

Phục hồi đếnPhiên bản

Để khôi phục một gói lên một phiên bản trước đó đăng bản:

  1. Trong cửa sổ Explorer, 3D viewport, Toolbox hoặc Asset Manager, right-click vào gói được yêu cầu và chọn Thông tin gói tài sản .

  2. Trong cửa sổ Tùy chỉnh tài sản, chọn Phiên bản . Cửa sổ hiển thị chi tiết cho mỗi phiên bản đã phát sóng, bao gồm ngày và thời gian phát sóng, cùng với bất kỳ mô tả nào về thay đổi.

  3. Nhấp vào dấu kiểm tra bên cạnh phiên bản bạn muốn khôi phục và nhấp vào Gửi .

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

Đang quay lại cài đặt

Để đổi bất kỳ thuộc tính cấu hình nào trở về giá trị mặc định của nó, hãy chọn tùy chọn Đặt lại từ menu gear ở phần Tài sản của cửa sổ 1>Thuộc tính1>.

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

So sánh phiên bản gói

Khi một gói có nhiều phiên bản, bạn có thể so sánh các thay đổi giữa các phiên bản bằng cách sử dụng viewer so sánh, which is helpful for reviewing package updates, comparing your local changes against the latest version, and checking the content of past versions before restoring.

Công cụ có một menu hiện đại của các gói tập tin cho phép bạn xem tất cả các gói tập tin đã thêm, xóa hoặc điều chỉnh giữa các phiên bản sử dụng các biểu tượng tương ứng tương ứng tương ứng tương ứng tương ứng tương ứng tương ứng tương ứng tương ứng tương ứng tương ứng tương ứng tương ứng tương

  • Tổng quát thị giác hiển thị sự khác biệt thị giác của 3D render dưới các vị trí camera khác nhau. Đây là vị trí mặc định cho các gói có 3D object (mô hình, bộ phận) làm chủ đối tượng, và hiện nó chỉ khả dụng cho 3D object chủ đống.

    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.
  • Các biến tính hiển thị thay đổi của các biến tính và thuộc tính. Nó là một cái nhìn mặc định cho các gói có một đối tượng non-3D (như trang bị và ánh sáng và đối tượng 2D như là một đối tượng chính. Nó được sẵn sàng cho tấ

    An example of the Properties tab in the diff viewer. Modified properties in different versions are highlighted.
  • Script hiển thị sự khác biệt giữa các dòng script. Nó có sẵn cho các gói chứa các dòng script, bất kể dòng script có phải là đối tượng rễ hay không.

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

Để so sánh phiên bản gói:

  1. Trong cửa sổ Explorer hoặc 3D viewport, nhấp chuột phải vào gói mục tiêu và chọn So sánh phiên bản gói .

  2. Bởi mặc định, cửa sổ so sánh sự thay đổi giữa bản sao địa phương của bạn và phiên bản mới nhất. Sử dụng hai menu dropdown để so sánh các phiên bản khác nhau.

    A close up view of an example diff viewer. The compare settings are highlighted.
  3. Sau khi chọn các phiên bản:

    • Để so sánh các kết quả tạo thị giới hữu cơ của mô hình rễ, nếu hiện hành, hãy chọn tab Tổng quát thị giới hữu cơ và điều chỉnh kiểm soát máy ảnh cho góc nhìn mong muốn của bạn. Các điều khiển được đồng bộ giữa các tầm nhìn:

      • Pan máy ảnh bằng các nút bên trái của chuột.
      • Xoay máy ảnh bằng các nút chuột phải.
      • Nhấp vào và nhấp ra máy ảnh với bánh xe chuột.
      • Recenter using the keyboard shortcut -F .
    • Để so sánh các thuộc tính và thuộc tính của một ví dụ / trường hợp, chọn instância và trang Cài đặt tính chất .

    • Để so sánh sự khác biệt giữa các bản thảo, nếu hiện hành, hãy chọn bất kỳ bản thảo nào để mở trang Script cho các thay đổi dòng dữ liệu giữa các phiên bản đã được chọn, tương tự như các ứng dụng kiểm tra nguồn.

Tương tự, bạn có thể mở công cụ phân tích tập lệnh trực tiếp:

  1. Trong cửa sổ Explorer hoặc 3D viewport, nhấp chuột phải vào gói mục tiêu, which must either be a script or contain scripts, and select Xem thay đổi script .
  2. Ở trang hiện định mở, so sánh tất cả các thay đổi của script được chọn giữa bản gói hiện tại và bản gói đăng nhập mới nhất hoặc bản góp địa phương.