アセットを整理してチームや複数のプロジェクトで再利用できるようにするために、インスタンスをグループ化し、それらを再利用可能な パッケージ に変換できます。パッケージは、ワールドを構築する全体のプロセスをより迅速かつ使いやすくしますが、一貫性、重複排除、コラボレーション、バージョン管理にも役立ちます：
- 新しいバージョンがあるときに、パッケージを 自動的に更新 するように設定できます。
- コラボレーターに対して、パッケージの内容に 編集 または 使用 の権限を付与することができます。
- パッケージの完全なバージョン履歴を表示し、バージョンを比較して、古いバージョンを復元できます。
最も効率的なワークフローは、パッケージを作成 し、コラボレーターと 共有 し、自動更新を設定 することです。また、パッケージを使用する前にモデルが「完成」するのを待つ必要はありません。たとえパッケージが単純な形状の上にあるプレースホルダーであっても、それを使用して 環境をグレーボックス し、公開するたびにプレースホルダーのコピーが自動的に更新されるようにできます。
パッケージを作成
使用するための 明示的な権限 を持たない制限されたアセットを含むパッケージを作成したい場合でも、パッケージを作成することはできますが、それら特定の制限されたアセットは、体験自体がそれらのアセットを使用する権限を持たない限り、実行時に 表示 されず、 聞こえ ません。
単一のオブジェクトやオブジェクトの親とその子のブランチからパッケージを作成できます。単一のオブジェクトのパッケージを作成したい場合は、最初にそれを Model グルーピングに追加して、パッケージ内で子オブジェクトを追加、削除、またはスケーリングできるようにしておくと良いでしょう。
パッケージを作成するには：
Explorer ウィンドウまたは 3D ビューポートで、パッケージに変換したいオブジェクトを右クリックし、コンテキストメニューで パッケージに変換 を選択します。
新しいウィンドウで、パッケージの詳細を入力します。特に、グループ で作業している場合は、所有権 を、作成 / 編集の権限を持つ適切なグループに設定します。
所有権の移転はアセットシステムでは サポートされていない ため、パッケージを作成する際には、所有者を慎重に考慮してください。
送信 をクリックします。
変換が完了すると、オブジェクトは Explorer ウィンドウに「連鎖リンク」記号を受け取り、パッケージであることが識別されます。さらに、オブジェクトに親子付けされた新しい PackageLink オブジェクトを見ることができます。
- オプションPackageLink オブジェクトを選択し、プロパティ ウィンドウで AutoUpdate を有効にします。アイコンが変更されて、パッケージが自動的に更新されるように設定されていることを示しています。
PackageLink オブジェクトを削除したり移動したりしないでください！どのパッケージコピーに対してもそうすることで、コピーは通常のオブジェクトに戻され、バージョンが更新される際の自動更新機能などのパッケージ機能が失われます。
パッケージを挿入
現在の場所に存在しないパッケージを挿入するには、最初に Toolbox から挿入する必要があります：
1 つの公開された場所のデータモデルにパッケージを挿入したら、それは Asset Manager に表示され、その後にそのコピーをすべて削除してもそこに残ります。
あなたが作成していないアセットを体験に挿入するときは注意してください。悪意のあるスクリプトが含まれている可能性があります。まず体験を保存し、その後は慣れないアセットの中のスクリプトを調査して、元の場所のバージョンに簡単に戻せるようにしてください。
パッケージを修正
他のオブジェクトと同様に、パッケージとその子を編集できます。パッケージの修正は 自動更新 を無効にし、変更を 公開 するか、元に戻す まで続きます。
ほとんどの編集によってパッケージが修正済みとしてマークされますが、次の変更は パッケージの変更 とみなされません：
- ルートノードの 名前 を変更すること。
- パッケージの外部インスタンスを参照しているパッケージ内の Weld の部分参照を変更すること。
修正されると、未公開の変更があるパッケージは Explorer ウィンドウに修正アイコンが表示されます：
構成の追加または更新
パッケージのルートに インスタンス属性 を含めることで、その動作をカスタマイズできます。パッケージを公開すると、現在の属性/値のセットがパッケージの デフォルト構成 になります。与えられたパッケージの コピー において、これらの属性値はインスタンス毎に変更できるもので、変更は 太字の斜体 で表示されます。パッケージコピーが 更新 されると、修正された構成値は保持され、他の属性は最新のデフォルト値に更新されます。
現在、構成値を扱う唯一の方法は、パッケージ内にスクリプトを追加し、実行時に構成に基づいて動作を読み込み適用することです。
デフォルトの 値 を構成して更新したいだけの場合は、それらの属性値を変更し、パッケージを再発行することで可能です（この場合、パッケージは 修正済み としてフラグ付けされません）。他の変更を公開したいが、デフォルト構成値を変更したくない場合は、値の変更がないパッケージを公開するか、公開する前に構成をデフォルトに戻してください。
ネストされたパッケージ
他のパッケージ内にパッケージをネストして、複雑な階層を維持し、コラボレーションできます。例えば、独立して変更できる車両の親パッケージのルートを持つ一連の車両メカニクスなどです。
ネストされたパッケージを変更すると、ネストされたパッケージ と 親パッケージの両方が修正されたと見なされます。ネストされたパッケージに変更を公開する前に、親 パッケージに変更を公開することはできません。親を公開すると、親パッケージが現在の未修正にマークされ、ネストされたパッケージの変更と競合することになります。
パッケージスクリプト
修正されていない パッケージ内の各スクリプトは読み取り専用で、スクリプトを解除するためのハイパーリンクを含む通知が上部に表示されます。
ハイパーリンクをクリックすると：
- スクリプトを編集しても、パッケージが修正済みとしてフラグ付けされます。
- パッケージ内の 他の スクリプトから通知/ハイパーリンクが削除されます。
パッケージが公開されて未修正の状態に移行すると、その下のスクリプトは読み取り専用となり、変更するためのハイパーリンクが表示されます。
パッケージ変更を公開
パッケージへの任意の変更を新しいバージョンとして公開でき、これにより、その更新が場所全体で他のパッケージコピーやすべての体験に利用可能になります。修正されたパッケージを場所を公開する前に公開することは 不要 です。なぜなら、修正されたバージョンは将来のイテレーションのために場所と一緒に保存されるからです。
パッケージへの変更を公開するには：
Explorer ウィンドウまたは 3D ビューポートで、修正されたコピーを右クリックし、パッケージに公開 を選択します。
- オプション変更の説明を追加します：
- パッケージを右クリックし、パッケージの詳細 を選択します。
- アセット構成 ウィンドウで、バージョン を選択します。
- 直近の変更した項目の下で、追加 を選択します。
- 変更について説明し、送信 ボタンをクリックします。
古いコピーを更新
古いパッケージコピーを最新バージョンに更新することも、古いバージョンを引き続き使用することもできます。
Explorer ウィンドウで、「ダウンロード」シンボルによって古いコピーを探します。3D ビューポートで古いコピーを選択することもできます。
古いコピーを右クリックし、最新パッケージを取得 を選択します。複数のパッケージを選択し、右クリックして 選択したパッケージの最新を取得 を選択することもできます。
一括更新
パッケージを広範囲に使用すると、体験内の複数の場所に多くのパッケージコピーが存在する可能性があります。 個別の同期 と 自動更新 に加えて、一括更新 を通じてすべてのパッケージコピーを更新できます。
- 推奨他のスタジオインスタンスを閉じて、体験の場所が開いているのを防ぎます。これは、別の未保存の場所があなたの更新を上書きする可能性を防ぎます。
- Explorer ウィンドウまたは 3D ビューポートで、目的のパッケージを右クリックし、すべて更新 を選択します。
- 体験内のすべての場所、または一部の場所を選択し、更新 をクリックします。
パッケージの一括更新は、選択した場所を自動的に 保存 しますが、公開 しません。さらに、意図しない上書きを防ぐために、一括更新はパッケージの 修正された バージョンには影響しません。一括更新が完了すると、スタジオは更新されていないパッケージの数とともに警告を表示します（もしあれば）。
自動更新
同期を容易にするために、新しいバージョンが公開されるたびにパッケージコピーを自動的に更新されるように設定できます。パッケージコピーの自動更新は、場所がスタジオで開かれるときに行われます。
Explorer ウィンドウで、パッケージの階層ツリーを展開し、その PackageLink オブジェクトを選択します。
プロパティ ウィンドウで AutoUpdate プロパティを有効にします。もし ネストされたパッケージ がある場合、このプロパティは最上級の親パッケージにのみ適用されるため、自動更新は 親 パッケージが更新されたときにのみ発生します。
自動更新は 修正された パッケージコピーには適用されません。パッケージインスタンスを変更すると、その 自動更新 プロパティは無効になり、無視されます。
共有とアクセスレベル
友達、体験、グループ、または特定のグループユーザーロールに対して、あなたのパッケージを自由に使用できるようにする権限を付与できます。アセットアクセスの詳細については、アセットのプライバシー を参照してください。
制限されたアセットを含むパッケージを、使用するための 明示的な権限 を持たない友達と共有する場合は、パッケージを共有することはできますが、その特定の制限されたアセットは、友達、体験、またはグループがそれらのアセットを使用する許可を持たない限り、実行時に 表示 されたり 聞こえ たりしません。
コラボレーター、たとえば友達やグループのパッケージ権限を変更するには：
Explorer ウィンドウ、Toolbox、または Asset Manager で、目的のパッケージを右クリックし、パッケージオプション ⟩ パッケージの詳細 を選択します。
アセット構成 ウィンドウで、権限 を選択します。
検索バーを使用して、パッケージを使用する権限を付与したいコラボレーターを入力して選択し、次に権限レベルを選択します。
権限 説明 使用 & 表示 コラボレーターは、現在のおよび以前のパッケージバージョンを使用および表示できます（ただし編集はできません）。この能力をコラボレーターに提供すると、彼らがすでに自分の体験に挿入したコピーへのアクセスを取り消すことはできません。アクセスを取り消すことで再挿入やパッケージの更新が防止されますが、彼らのデータモデル内にあるパッケージのコピーはそのまま保持されます。 編集 コラボレーターは、現在のおよび以前のパッケージバージョンを使用、表示、および編集することができます。これには、それに対する変更を発行することが含まれます。
パッケージ変更を元に戻す
パッケージ変更を一つ一つ元に戻すのではなく、未発表の変更を 一度に元に戻す か、パッケージを以前の バージョン に戻すか、特定の 構成 変更を元に戻すことができます。
未発表の変更を元に戻す
一連の 未発表 の変更を元に戻すには：
Explorer ウィンドウで、パッケージアイコンの点で修正されたコピーを探します。3D ビューポートで修正されたコピーを選択することも可能です。
修正された単一コピーを右クリックし、パッケージの変更を元に戻す を選択するか、複数コピー（そのうちの1つが修正されている）を選択し、右クリックして 選択したパッケージの変更を元に戻す を選択します。
公開されたバージョンに戻す
パッケージを 以前に公開された バージョンに戻すには：
- アセット構成 ウィンドウで バージョン を選択します。このウィンドウには、各公開バージョンの詳細が表示され、公開日と時間、および変更の説明が含まれています。
- 元に戻したいバージョンの隣にあるチェックマークをクリックし、送信 をクリックします。
パッケージへの変更を元に戻しても、構成はデフォルトにリセットされません。 構成を元に戻す を参照してください。
構成を元に戻す
任意の 構成 属性をデフォルトに戻すには、プロパティ ウィンドウの 属性 セクションのオプションメニューから リセット を選択します。
パッケージバージョンを比較
パッケージに複数のバージョンがあるときは、diff ビューアを使用してバージョン間の変更を比較できます。このツールには、バージョン間のすべての追加された、削除された、または変更されたインスタンスを示すパッケージ階層メニューがあり、以下の機能が含まれています：
ビジュアル概要 は、異なるカメラ位置での 3D レンダリングの視覚的な違いを示します。3D オブジェクト（モデル、部品）がルートオブジェクトであるパッケージのデフォルトビューであり、現在はルートオブジェクトにのみ利用可能です。
プロパティ は、プロパティおよび属性の変更を示します。これは、非 3D オブジェクト（スクリプト、ライト、2D オブジェクト）がルートオブジェクトであるパッケージのデフォルトビューであり、パッケージ内のすべてのインスタンスに対して使用できます。
スクリプト は、行ごとのスクリプトの違いを示します。スクリプトを含むパッケージの場合は利用可能であり、スクリプトがルートオブジェクトであるかどうかに関係なく表示されます。
パッケージバージョンを比較するには：
Explorer または 3D ビューポート内で、対象のパッケージを右クリックし、パッケージオプション ⟩ パッケージバージョンを比較 を選択します。
デフォルトでは、ウィンドウはローカルコピーと最新バージョンの間の変更を比較します。2つのドロップダウンメニューを使用して異なるバージョンを比較します。
一部の古いバージョンは、パッケージ diff ツールと互換性がない場合があります。
バージョンを選択した後：
ルートモデルの視覚的なレンダリングを比較するには、該当する場合は ビジュアル概要 タブを選択し、カメラコントロールを調整して希望の角度にします。コントロールは、ビュー間で同期されています：
- 左マウスクリックを使用してカメラをパンします。
- 右マウスクリックを使用してカメラを回転させます。
- マウスホイールでズームインおよびズームアウトします。
- キーボードショートカット F を使用して再中心化します。
インスタンスのプロパティと属性を比較するには、インスタンスを選択し、プロパティ タブを選択します。
スクリプトまたはスクリプトを含むパッケージのスクリプトの違いを比較するには、スクリプト タブを使用します。
このツールは、現在のバージョンと最新の公開またはローカルバージョンの間でスクリプトの変更を比較するのみを許可し、変更を行ったコラボレーターを示しません。
あるいは、Explorer ウィンドウまたは 3D ビューポート内のターゲットパッケージを右クリックして、直接スクリプト diff ツールを開き、スクリプトの変更を表示 を選択することができます。
