パッケージ

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


チーム全体または複数のプロジェクト全体でアセットを整理し、再利用可能な パッケージ に変換するには、インスタンスをグループ化して変換します。パッケージは、世界を構築する全体のプロセスをより速く、より人間工学的にするのに役立ちますが、一貫性、除去、コラボレーション、バージョン管理にも役立ちます:

最も効率的なワークフローは、パッケージを作成共同作業者と共有する、そして自動更新に設定することです。そして、パッケージで使用する前にモデルが「完了」するのを待つ必要はありません。パッケージが単純な形の上にプレースホルダーであっても、環境をグレーボックスにして、詳細なバージョンを公開すると、プレースホルダーのコピーが自動的に更新されるようにすることができます。

パッケージを作成

単一のオブジェクトまたは単一の親子ブランチのオブジェクトからパッケージを作成できます。単一のオブジェクト用のパッケージを作成したい場合は、パッケージ内で後でインスタンスを追加、削除、またはスケールすることなく、Model グループに最初に追加することをお勧めします。パッケージを破壊することなく、後でパッケージ内のインスタンスを追加、削除、またはスケールできます。

  1. エクスプローラー ウィンドウまたは 3D ビューポートで、必要なオブジェクトを右クリックして パッケージに変換 を選択します。

  2. 新しいウィンドウで、パッケージの詳細を記入します。特に、グループ で作業している場合、グループエクスペリエンスを作成/編集する権限を持つ適切なグループに 所有権 を設定します。

  3. クリック 送信

  4. 変換が完了した後、オブジェクトはエクスプローラーウィンドウで「チェーンリンク」シンボ紐づけるを受け取り、パッケージとして識別されます。さらに、オブジェクトに親属する新しい パッケージリンク オブジェクトを見ることもできます。

    A maple tree model in the Explorer window with the package icon next to it.
  5. (オプション) パッケージリンク オブジェクトを選択し、 プロパティ ウィンドウで を有効にします。アイコンが変更されてパッケージが自動更アップデートに設定されていることを示す方法を観察してください。

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

包を挿入する

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

  • From インベントリ ⟩ マイパッケージ パッケージを公開したり、 クリエイターストア から入手したパッケージ、および友人が所有し、あなたに 権限 を与えて使用しているパッケージを含め、 クリエイターストア から公開されたパッケージ。
  • From クリエーション > グループパッケージ for packages published by members of your グループ (including yourself)。
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.

ツールボックス /> クリエーション /> グループパッケージ
>

パッケージを公開された場プレースのデータモデルに挿入したら、アセットマネージャーに表示され、後ですべてのコピーを削除してもそこに残ります。

パッケージの変更を公開

パッケージに行った変更を新しいバージョンとしてパブリッシュして、場所全体やすべてのエクスペリエンスでパッケージの他のコピーに利用できるようにすることができます。場所を公開する前に修正済みパッケージを公開する必要はありません(修正版は将来の反復で場所と一緒に保存されます)。Note that it's not required to publish a modified package before publishing a place (the modified version is saved along with the place for future iteration).

パッケージの変更を公開するには:

  1. In the エクスプローラー window or 3D ビューポート, 修正されたコピーを右クリックして パッケージに公開 を選択します。

  2. パッケージコピーに 自動更新 が有効になっている場合、それらを含む場所を開いたときにすぐに更新されたバージョンを引き込みます。他のコピーは、アップデートが利用可能であることを示すパッケージアイコンの白いドットを取得します。必要に応じて、個別に更新 または マス更新 を必要に応じて更新できます。

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

    1. パッケージを右クリックし、 パッケージ詳細 を選択します。
    2. アセット構成ウィンドウで、 バージョン を選択します。
    3. 最も最近の変更の下で、 追加 を選択します。
    4. 変更を説明し、 Submit をクリックします。

期限切れのコピーを更新する

期限切れのパッケージコピーを最新バージョンに更新するか、古いバージョンを引き続き使用できます。

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

  1. エクスプローラ ウィンドウで、パッケージアイコンの白いドットで過期したコピーを見つけます。3D ビューポートで古いコピーを選択することもできますが、この方法で見つけるのが難しいかもしれません。

    Two packages in the Explorer set to auto-update, and one with an update available.
  2. 期限切れのコピーを右クリックし、 最新パッケージを取得 を選択します。複数のパッケージを選択したり、右クリックしたり、 選択したパッケージの最新を取得する もできます。

大規模アップデート

パッケージの広範な使用は、エクスペリエンスの複数の場所で多くのパッケージコピーに結びつく可能性があります。個々の同期と自動更新に加えて、マス更新でパッケージのすべてのコピーを更新できます。

  1. (おすすめ) エクスペリエンスの場所のいずれかを開いて他のスタジオインスタンスを閉じる;これにより、場所の別の保存されていないインスタンスがアップデートを上書きする可能性が防がれます。

  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. In the アセット構成 window, select 権限 .

    • グループ所有の パッケージ については、ロールツリーを拡張します。それから、各役割に許可レベルを選択します。無効になっている選択ボックスは、パーミッションがすでに設定されており、このウィンドウから変更できないことを示します。

      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.

ほとんどの編集は、パッケージを変更したとしてマークしますが、次の変更は パッケージの変更とは考えられていません

  • ルートノードの を変更する。
  • パッケージのルートノードの 位置 または 回転 を変更する、BasePartModel、または GuiObject のパッケージ。
  • ルートノードの 有効 プロパティを変更する GuiObjectScreenGui 、または SurfaceGui など、BillboardGui
  • パッケージ内のインスタンスを参照するパッケージ内の 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.

パッケージスクリプト

変更されていない パッケージ内の各スクリプトは読み込み専用であり、スクリプトをアンロックするためのハイパーリンクでトップに通知を表示します。

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

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

  • スクリプトを編集したかどうかにかかわらず、パッケージを変更したとしてマークします。
  • パッケージ内の他の スクリプト から通知/ハイパーリンクを削除します。

パッケージが公開されて 変更されていない状態に移行すると、その下のスクリプトは、修正するためのハイパーリンクで読み取り専用になります

パッケージの変更を戻す

一連のパッケージ変更をすべて一つずつ取り消すのではなく、1つのアクションで未公開の変更を戻す、パッケージを以前のバージョンに復元するか、特定の構成に変更を戻すことができます。

未公開の変更を戻す

全体の 未公開 の変更を取り消すには:

  1. エクスプローラ ウィンドウで、名前の横にある除号で修正されたコピーを見つけます。3D ビューポートで修正されたコピーを選択することもでき、これが簡単かもしれません。

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

バージョンに戻す

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

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

  2. In the アセット構成 window, select バージョン .ウィンドウには、公開日と時間、および変更の説明を含む、各公開バージョンの詳細が表示されます。

  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.
  • プロパティ は、プロパティと属性の変更を表示します。根のオブジェクト (スクリプト、ライト、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
    • インスタンスのプロパティと属性を比較するには、インスタンスと プロパティ タブを選択します。

    • スクリプトの差異を比較するには、適用可能用する場合は、ソースコントロールアプリケーションと同様に、選択したバージョン間のライン単位の変更を開くために任意のスクリプトを選択してください スクリプト タブを開きます。

代わりに、スクリプト差分ツールを直接開くこともできます:

  1. In the エクスプローラー window or 3D viewport, right-click the target package, which must either be a script or contain scripts, and select スクリプトの変更を表示 .
  2. 開いた差分タブで、選択したスクリプトのすべての変更を、現在のパッケージコピーと最新の公開またはローカルバージョンと比較します。