チーム全体または複数のプロジェクト全体でアセットを整理し、再利用可能な パッケージ に変換するには、インスタンスをグループ化して変換します。パッケージは、世界を構築する全体のプロセスをより速く、より人間工学的にするのに役立ちますが、一貫性、除去、コラボレーション、バージョン管理にも役立ちます：
- 簡単に パッケージのすべてのコピーを最新バージョンに更新する (またはのみ 特定のコピーを更新する )。
- パッケージを 自動更新 に設定して、新しいバージョンがあるたびに更新されます。
- コラボレーターに 編集 または 使用 権限をパッケージのコンテンツに付与します。
- パッケージの全バージョン履歴を表示し、バージョンを比較し、古いバージョンを復元します。
最も効率的なワークフローは、パッケージを作成、共同作業者と共有する、そして自動更新に設定することです。そして、パッケージで使用する前にモデルが「完了」するのを待つ必要はありません。パッケージが単純な形の上にプレースホルダーであっても、環境をグレーボックスにして、詳細なバージョンを公開すると、プレースホルダーのコピーが自動的に更新されるようにすることができます。
パッケージを作成
単一のオブジェクトまたは単一の親子ブランチのオブジェクトからパッケージを作成できます。単一のオブジェクト用のパッケージを作成したい場合は、パッケージ内で後でインスタンスを追加、削除、またはスケールすることなく、Model グループに最初に追加することをお勧めします。パッケージを破壊することなく、後でパッケージ内のインスタンスを追加、削除、またはスケールできます。
エクスプローラー ウィンドウまたは 3D ビューポートで、必要なオブジェクトを右クリックして パッケージに変換 を選択します。
新しいウィンドウで、パッケージの詳細を記入します。特に、グループ で作業している場合、グループエクスペリエンスを作成/編集する権限を持つ適切なグループに 所有権 を設定します。
所有権移行は は アセットシステムによってサポートされていないので、パッケージを作成するときは所有者を慎重に検討してください。
クリック 送信 。
変換が完了した後、オブジェクトはエクスプローラーウィンドウで「チェーンリンク」シンボ紐づけるを受け取り、パッケージとして識別されます。さらに、オブジェクトに親属する新しい パッケージリンク オブジェクトを見ることもできます。
(オプション) パッケージリンク オブジェクトを選択し、 プロパティ ウィンドウで を有効にします。アイコンが変更されてパッケージが自動更アップデートに設定されていることを示す方法を観察してください。
パッケージリンク インスタンスを削除または移動しないでください！任意のパッケージコピーでそうすると、コピーが通常のオブジェクトに変換され、新しいバージョンがあるときに更新できる能力などのパッケージ機能が失われます。
包を挿入する
現在の場プレースにまだ存在しないパッケージを挿入するには、 最初に ツールボックスから挿入する必要があります：
- From インベントリ ⟩ マイパッケージ パッケージを公開したり、 クリエイターストア から入手したパッケージ、および友人が所有し、あなたに 権限 を与えて使用しているパッケージを含め、 クリエイターストア から公開されたパッケージ。
パッケージを公開された場プレースのデータモデルに挿入したら、アセットマネージャーに表示され、後ですべてのコピーを削除してもそこに残ります。
エクスペリエンスに作成しなかったアセットを挿入するときは注意してください、悪意のあるスクリプトが含まれている可能性があります。最初にエクスペリエンスを保存し、不明なアセット内のスクリプトを調査して、場所バージョンに簡単に戻すことができます。
パッケージの変更を公開
パッケージに行った変更を新しいバージョンとしてパブリッシュして、場所全体やすべてのエクスペリエンスでパッケージの他のコピーに利用できるようにすることができます。場所を公開する前に修正済みパッケージを公開する必要はありません(修正版は将来の反復で場所と一緒に保存されます)。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).
パッケージの変更を公開するには：
In the エクスプローラー window or 3D ビューポート, 修正されたコピーを右クリックして パッケージに公開 を選択します。
(オプション) 変更の説明を追加:
- パッケージを右クリックし、 パッケージ詳細 を選択します。
- アセット構成ウィンドウで、 バージョン を選択します。
- 最も最近の変更の下で、 追加 を選択します。
- 変更を説明し、 Submit をクリックします。
期限切れのコピーを更新する
期限切れのパッケージコピーを最新バージョンに更新するか、古いバージョンを引き続き使用できます。
1つまたは複数のパッケージコピーを最新バージョンに更新するには：
エクスプローラ ウィンドウで、パッケージアイコンの白いドットで過期したコピーを見つけます。3D ビューポートで古いコピーを選択することもできますが、この方法で見つけるのが難しいかもしれません。
期限切れのコピーを右クリックし、 最新パッケージを取得 を選択します。複数のパッケージを選択したり、右クリックしたり、 選択したパッケージの最新を取得する もできます。
大規模アップデート
パッケージの広範な使用は、エクスペリエンスの複数の場所で多くのパッケージコピーに結びつく可能性があります。個々の同期と自動更新に加えて、マス更新でパッケージのすべてのコピーを更新できます。
(おすすめ) エクスペリエンスの場所のいずれかを開いて他のスタジオインスタンスを閉じる;これにより、場所の別の保存されていないインスタンスがアップデートを上書きする可能性が防がれます。
エクスプローラ ウィンドウまたは 3D ビューポートで、必要なパッケージを右クリックして すべて更新 を選択します。
エクスペリエンスのすべての場所、または場所の一部のセットを選択し、 更新 をクリックします。
意図しない上書きを防ぐため、マスアップデートはパッケージの 修正済み バージョンに影響しません。大規模アップデートが完了した後、Studio は、パッケージの数を表示し、 アップデートしなかった 場合は警告を表示します。
マス更新パッケージを自動的に更新 保存 選択された場所は、公開しません。
自動更新
同期を簡素化するために、新しいバージョンが公開されるたびに自動的に更新するパッケージコピーを設定できます。パッケージのコピーの自動更新は、Studio で場所が開いたときに行われます。
エクスプローラ ウィンドウで、パッケージの階層ツリーを拡張し、その パッケージリンク オブジェクトを選択します。
プロパティ ウィンドウで、 自動更新 プロパティを有効にします。ネストされたパッケージ がある場合、このプロパティは最高レベルの親パッケージにのみ適用され、自動更新は 親パッケージ が更新されたときにのみ発生します。
自動更新は、修正された パッケージコピーには適用されません。パッケージインスタンスを修正すると、その 自動更新 プロパティが無効になり、無視されます。
共有とアクセスレベル
必要に応じて、パッケージを友達と共有したり、グループ内の特定のユーザーロールにアクセスを付与したりできます。
エクスプローラ ウィンドウで ツールボックス 、または アセットマネージャ 、または アセットマネージャ で、必要なパッケージを右クリックし、 パッケージ情報 を選択します。
In the アセット構成 window, select 権限 .
グループ所有の パッケージ については、ロールツリーを拡張します。それから、各役割に許可レベルを選択します。無効になっている選択ボックスは、パーミッションがすでに設定されており、このウィンドウから変更できないことを示します。
許可 説明 編集 ロールのメンバーは、現在のパッケージバージョンと以前のバージョンを使用したり、表示したり、編集したり、それに変更を公開したりできます。このウィンドウからロールへの編集アクセスを付与すると、 特定のパッケージ へのアクセスが付与されるだけです。 アクセスなし ロールのメンバーは、パッケージの新しいバージョンにアクセスできませんが、場プレースに挿入された現在のバージョンにアクセスできます。 ユーザーが所有する パッケージ については、検索フィールドで友達を検索し、ユーザーユーザーネームをクリックし、許可レベルを選択します。
許可 説明 使用して表示 ユーザーは、現在のパッケージバージョンと以前のパッケージバージョンを使用して表示 (編集できない) できます。ユーザーにこの機能を提供したら、既に体験に挿入したコピーへのアクセスを取り消すことはできません；アクセスを取り消すと、再挿入やパッケージの更新が防止されますが、データモデルのパッケージコピーはそのまま残ります。 編集 ユーザーは、現在のパッケージバージョンと以前のバージョンを使用、表示、編集し、それに変更を公開することができます。
パッケージを変更する
パッケージとその子供を他のオブジェクトと同様に編集できます。パッケージを変更すると、変更を公開または戻すまで自動更新が無効になります。
ほとんどの編集は、パッケージを変更したとしてマークしますが、次の変更は パッケージの変更とは考えられていません ：
- ルートノードの 名 を変更する。
- パッケージ内のインスタンスを参照するパッケージ内の Weld のパーツ参照を変更する、パッケージ外のインスタンスを参照するパッケージ内の
修正後、公開されていない変更を持つパッケージは、エクスプローラー ウィンドウで修正されたアイコンを取得します：
設定を追加または更新する
パッケージのルートに インスタンス属性 を含めることで、例えばパッケージ化された車両の最大速度やパッケージ化されたボタンのデバウンス時間をカスタマイズできます。
パッケージを公開すると、現在のアトリビュート/値のセットがパッケージの デフォルト設定 になります。パッケージの任意のコピーでは、構成は ボールドイタリック で表示され、それらの属性値はインスタンスごとに変更できます。パッケージコピーが 更新 されると、修正された構成値が保存され、他の属性は最新のデフォルト値に更新されます。
現在、構成値を処理する唯一の方法は、実行時に構成に基づいて動作を読み込み、適用するパッケージにスクリプトを追加することです。
構成のデフォルト 値 を更新したい場合は、これらの属性値を変更してパッケージを再公開することができます(この場合、パッケージは 変更されたとして標識されることはありません ).他の修正を公開したいが、デフォルトの構成値を変更しないで済む場合は、値の変更がないパッケージで公開するか、公開前に構成をデフォルトに戻す必要があります。
巣子パッケージ
他のパッケージ内にパッケージをネストして、車両の親パッケージに独立して変更できるシリーズの車両メカニクスなど、複雑な階層を維持して共同作業することができます。この例では、同じホイールパッケージの 4 コピーを含む車パッケージを示しています：
ネストされたパッケージを変更すると、ネストされたパッケージ と親パッケージ の両方が変更されたものとみなされます。変更をパブリッシュする前に、親パッケージの変更を任意の ネスト パッケージにパブリッシュする必要があります、 親パッケージ のパブリッシングは、親がそれを現在/未変更としてマークし、ネストパッケージの変更と衝突するためです。
パッケージスクリプト
変更されていない パッケージ内の各スクリプトは読み込み専用であり、スクリプトをアンロックするためのハイパーリンクでトップに通知を表示します。
ハイパーリンクをクリックする:
- スクリプトを編集したかどうかにかかわらず、パッケージを変更したとしてマークします。
- パッケージ内の他の スクリプト から通知/ハイパーリンクを削除します。
パッケージが公開されて 変更されていない状態に移行すると、その下のスクリプトは、修正するためのハイパーリンクで読み取り専用になります
パッケージの変更を戻す
一連のパッケージ変更をすべて一つずつ取り消すのではなく、1つのアクションで未公開の変更を戻す、パッケージを以前のバージョンに復元するか、特定の構成に変更を戻すことができます。
未公開の変更を戻す
全体の 未公開 の変更を取り消すには：
エクスプローラ ウィンドウで、名前の横にある除号で修正されたコピーを見つけます。3D ビューポートで修正されたコピーを選択することもでき、これが簡単かもしれません。
単一の変更されたコピーを右クリックし、 パッケージへの変更を取り消す または複数のコピー (少なくとも 1つが変更された)を右クリックし、 選択したパッケージへの変更を取り消す を選択します。
バージョンに戻す
パッケージを 以前に公開された バージョンに復元するには：
エクスプローラ ウィンドウで、3Dビューポート、ツールボックス、またはアセットマネージャ、必要なパッケージを右クリックし、パッケージ詳細 を選択します。
In the アセット構成 window, select バージョン .ウィンドウには、公開日と時間、および変更の説明を含む、各公開バージョンの詳細が表示されます。
回復したいバージョンの横にあるチェックマークをクリックし、 送信 をクリックします。
パッケージの変更を戻すと、構成がデフォルトにリセットされません。見てください 構成の戻り。
設定を戻す
すべての 構成 属性をデフォルトに戻すには、 リセット オプションを 属性 セクションの プロパティ ウィンドウのギアメニューから選択します。
パッケージバージョンを比較
パッケージに複数のバージョンがある場合、パッケージの更新をレビューするのに役立つ差分ビューアを使用して、バージョン間の変更を比較し、ローカルの変更を最新バージョンと比較し、復元前に過去のバージョンのコンテンツをチェックできます。
ツールには、対応するアイコンを使用してバージョン間で追加、削除、または変更されたすべてのインスタンスを示すパッケージ階層メニューがあり、次のタブが利用可能です：
ビジュアル概要 は、異なるカメラポジションでの 3D レンダリングのビジュアル差を示します。3D オブジェクト (モデル、パーツ) をルートオブジェクトとするパッケージのデフォルトビューで、現在はルートオブジェクトのみが利用可能です。
プロパティ は、プロパティと属性の変更を表示します。根のオブジェクト (スクリプト、ライト、2D オブジェクト) を持つパッケージのデフォルトビューで、パッケージ内のすべてのインスタンスに使用可能です。
スクリプト は行ごとのスクリプトの差を表示します。スクリプトを含むパッケージであれば、スクリプトがルートオブジェクトかどうかにかかわらず使用できます。
パッケージバージョンを比較するには：
エクスプローラー ウィンドウまたは 3D ビューポートで、ターゲットパッケージを右クリックし、 パッケージバージョンの比較 を選択します。
デフォルトでは、ウィンドウはローカルコピーと最新バージョンの間の変更を比較します。2つのドロップダウンメニューを使用して、異なるバージョンを比較します。
いくつかの古いバージョンは、パッケージ差分ツールと互換性がない可能性があります。
バージョンを選択した後:
根モデルのビジュアルレンダリングを比較するには、適用可能用する場合は ビジュアル概要 タブを選択し、望む角度のカメラコントロールを調整します。コントロールはビュー間で同期されます：
- 左マウスクリックでカメラをパンする。
- 右マウスクリックでカメラを回転させます。
- マウスホイールでカメラを拡大および縮小します。
- キーボードショートカットを使用して再センター -F 。
インスタンスのプロパティと属性を比較するには、インスタンスと プロパティ タブを選択します。
スクリプトの差異を比較するには、適用可能用する場合は、ソースコントロールアプリケーションと同様に、選択したバージョン間のライン単位の変更を開くために任意のスクリプトを選択してください スクリプト タブを開きます。
このツールは、変更を行ったコラボレーターを示さずに、現在のバージョンと最新の公開またはローカルバージョンの間のスクリプト変更を比較することを許可します。
代わりに、スクリプト差分ツールを直接開くこともできます：
- In the エクスプローラー window or 3D viewport, right-click the target package, which must either be a script or contain scripts, and select スクリプトの変更を表示 .
- 開いた差分タブで、選択したスクリプトのすべての変更を、現在のパッケージコピーと最新の公開またはローカルバージョンと比較します。