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