パッケージ

*このコンテンツは、ベータ版のAI(人工知能)を使用して翻訳されており、エラーが含まれている可能性があります。このページを英語で表示するには、 こちら をクリックしてください。


アセットをチームまたは複数のプロジェクト間で整理し、再利用できるようにするには、インスタンスをグループ化し、 パック に変換します。パックは、世界の構築のプロセスをより速く、エラゴミなく、コラボレーション、バージョン管理などに役立ちます:

最も効率的なワークフローは、パッケージを作成する、パッケージを共有する、および自動更新を設定です。パッケージを公開する前に、モデルを「完了」する必要はありません。たとえパッケージがシンプ

パッケージの作成

オブジェクトの任意のオブジェクト、またはオブジェクトの親や子の枝からパッケージを作成できます。単一のオブジェクトにパッケージを作成する場合は、まず Model グループに追加して、後でパッケージ内のインスタンスを追加、削除、またはスケールすることができます。

  1. エクスプローラ ウィンドウまたは 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] ウィンドウで「チェーンリンク」シンボルを受紐づけるして、パッケージとして識別されます。さらに、オブジェクトの上に新しい パッケージリンク オブジェクトが見えるようになります。

    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.

パッケージを挿入中

現在の場プレースに既に存在しないパッケージを挿入するには、 最初に ツールボックスから挿入する必要があります:

  • From インベントリパック for パックを公開したり、得たりしたパック、および友達が所有しているパック、または クリエイターストア から、パーミッションを与えているパックを使用するパックを、以下の順序で説明します。
  • From クリエーショングループパック for パックが公開されたメンバーの グループ (包括自分)。
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. エクスプローラ ウィンドウまたは 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. パッケージコピーに 自動更新 が有効になっている場合、それらの場所を開くと、すぐに更新されたバージョンを取得します。他のコピーは、パッケージアイコンの上のホワイトドットを示す、更新が利用可能を表すポップアップを表示します。個々に更新 または 2>大規模更新

    Two packages in the Explorer set to auto-update, and one with an update available.
  3. (オプション) 変更の説明を追加します:

    1. パッケージを右クリックし、 パッケージ詳細 を選択します。
    2. アセット構成ウィンドウで、 バージョン を選択します。
    3. 最新の変更を挙げて、 Add を選択します。
    4. 変更を説明し、 送信 をクリックします。

更新された古いコピー

古いバージョンのパッケージコピーを最新バージョンに更新するか、古いバージョンを続けて使用することができます。

1つまたは複数のパッケージコピーを最新バージョンに更新するには:

  1. In the エクスプローラー window, locate outdated copアイコンes by the white dot on the package icon. 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. In the エクスプローラ window, expand the package's hierarchy tree and select its パッケージリンク object.

    A close up view of a packaged chandelier model in the Explorer window. The PackageLink object is highlighted.
  2. In the プロパティ ウィンドウ, enable the 自動更新 property. If you have ネストパック , this property only applies to the highest-level parent package, meaning automatic updates only occur when the 1>親1> package is updated.

共有とアクセスレベル

必要に応じて、パッケージを友達と共有したり、グループ内の特定のユーザーロールにアクセスを付与したりできます。

  1. In the Explorer、Toolbox、or Asset Manager, right-click the 必要なパックをクリックし、Select パック詳細 .

  2. アセット構成ウィンドウで 権限 を選択します。

    • For a グループ所有の パッケージ, expand the roles tree. 然後、各ロールの権限レベルを選択します。 選択ボックスが無効になっている場合は、そのロールの権限はすでに 構成されている この役割から変更できません。このウィンドウから変更できません。

      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.

ほとんどの編集は、パッケージを変更済みとしてマークしますが、次の変更はパッケージの変更として考慮されません:

  • ルートノードの 名前 を変更する。
  • パッケージのルートノードの 位置 または 回転 を変更すると、BasePart 、2>Class.Model2> または 5>Class.GuiObject5> のライトノードの 8>位置8> が変更されます。
  • Class.GuiObject のようなルートノードの GuiObject プロパティを変更する ScreenGui 、1>Class.SurfaceGui1> 、または 4>Class.BillboardGui4> など。
  • パッケージの外にインスタンスを参照するパーツの参照を変更する。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.

ネストパック

複数の車両メカニックを含むシリーズの車両メカニックを変更できる親パックなど、複雑な階層を維持および共同で作業するために、パッケージを他のパッケージ内にネストできます。この例では、車両の親パックに 4つのコピーの同じホイールパックが含まれている車両メカニックのパッケージが示されています:

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

パッケージスクリプト

unmodified パッケージ内のスクリプトは、読み取り専用であり、トップにハイパーリンクを表示してスクリプトのロックを解除します。

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

ハイパーリンクをクリックする:

  • スクリプトを編集するかどうかにかかわらず、パッケージをフラッグします。
  • パッケージ内の 他の スクリプトから通知/ハイパーリンクを削除します。

パッケージが公開され、 変更なし 状態に移動すると、下のスクリプトは、読み取りで読み取り、変更を行うためのハイパーリンクを持つようになります。

パッケージ変更を戻す

複数のパッケージ変更を一度に取り消す代わりに、一度にパッケージ変更を元に戻すことができます。パッケージを以前の1>バージョン1>に戻す1>、または4>特定の7>設定7>に戻す4>。

公開されていない変更を戻す

公開されていない 変更の連続を取り消すには:

  1. エクスプローラ ウィンドウで、名前の隣にあるインタージェクションポイントで変更後のコピーを見つけることができます。3D ビューポートでも変更後のコピーを選択することができます。これは、より簡単な場合があります。

  2. 単一の変更済みコピーを右クリックし、 パッケージの変更を取り消す を選択します。また、複数のコピー (少なくとも 1 つが変更されている) を右クリックし、 パッケージの変更を取り消す を選択します。

バージョンに戻す

パッケージを以前に公開されたバージョンに戻すには:

  1. エクスプローラ ウィンドウ、3D ビューポート、ツールボックス、またはアセットマネージャーで、必要なパックを右クリックし、 パック詳細 を選択します。

  2. アセット構成ウィンドウで、 バージョン を選択します。ウィンドウは、公開されたバージョンの詳細を含む、データと時間の発行、変更の説明などを表示します。

  3. バージョンを復元したいバージョンの隣にあるチェックマークをクリックし、 Submit をクリックします。

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

設定を戻す

任意の 設定 属性をデフォルトに戻すには、ギアメニューの リセット オプションを選択し、プロパティ セクションの 2>設定2> ウィンドウから 5>リセット5> オプションを選択します。

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

バージョン比較

パッケージに複数のバージョンがある場合は、変更を比較するために差分ビューアを使用して、パッケージの更新をレビューしたり、ローカルの変更を最新バージョンに比較したり、復元前のコンテンツをチェックしたりすることができます。

ツールには、対応するアイコンを使用して、バージョン間の追加、削除、または変更されたインスタンスをすべて表示するパッケージ層メニューがあり、次のタブが利用可能です:

  • ビジュアル概要 は、3D レンダリングの 3つのカメラポジションのビジュアルの違いを表示します。これは、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. デフォルトでは、ローカルコピーと最新バージョンの間で変更を比較します。2つのドロップダウンメニューを使用して、異なるバージョンを比較します。

    A close up view of an example diff viewer. The compare settings are highlighted.
  3. バージョンを選択した後:

    • ルートモデルのビジュアルレンダリングを比較するには、 ビジュアル概要 タブを選択し、カメラのコントロールを必要に応じて調整します。コントロールはビュー間で同期されます:

      • 左マウスクリックを使用してカメラをパンします。
      • 右マウスクリックを使用してカメラを回転します。
      • マウスホイールでカメラを拡大/縮小します。
      • キーボードのショートカットを使用して -F を再センターします。
    • インスタンスのプロパティと属性を比較するには、インスタンスと プロパティ タブを選択します。

    • スクリプトの違いを比較するには、スクリプトタブを開き、選択したバージョン間のラインごとの変更を行うために、任意のスクリプトを選択します。 To compare script differences, if applicable, select any script to open the スクリプト tab for line-by-line changes between your selected versions, similar to source control applications.

あるいは、スクリプトの差分ツールを直接開くこともできます:

  1. エクスプローラ ウィンドウまたは 3D ビューポートで、スクリプトである必要があるスクリプトパックを右クリックし、 スクリプト変更を表示 を選択します。
  2. 開いたダイフィックタブで、選択したスクリプトのすべての変更を現在のパッケージコピーと最新の公開またはローカルバージョンの間で比較します。