チーム全体や複数のプロジェクト間でのアセット管理を最適化するには、1 つのアセットやアセット階層をパッケージに変換して、複数のバーチャル空間で再利用できます。 パッケージがアップデートされた場合、チームメンバーは、最新バージョンに、特定のコピーをアップデート、バーチャル空間全体のすべてのコピーをアップデートまたは特定のコピーを自動アップデートするよう設定できます。 パッケージには、パッケージクリエーターとエディタに、パッケージの動作をカスタマイズするためのオプションを含めることができる設定も含まれています。
パッケージの作成
パッケージは、データモデル内の任意の 1 つのノードまたはサブツリーのルートノードから作成できます。
エクスプローラウィンドウで、目的のオブジェクトやノードを右クリックし、コンテキストメニューからパッケージに変換を選択します。
ダイアログウィンドウで、要求された詳細を入力します。 特にグループ内で作業している場合は、グループバーチャル空間の作成・編集を行う権限を持つ希望のグループに所有権を設定します。
アセットシステムでは所有権の移転は サポートされていませんので、パッケージを作成する際は所有者を慎重に検討してください。送信ボタンをクリックします。
PackageLinkオブジェクトの削除または再度の親子化を行ってはいけません。 パッケージコピーに対してこれを行うと、公開済みバージョンとの関連性が失われ、コピーは通常のオブジェクトに戻されます。
パッケージの挿入
現在のプレースにまだ存在しないパッケージを挿入するには、最初に次のガイドラインに従ってツールボックスから挿入する必要があります。
プレースのデータモデルに挿入したパッケージが挿入されると、アセット管理のパッケージフォルダに表示され、後にすべてのコピーを削除してもそこに残ります。 しかし、プレースを公開する際には、プレース内で使用されたパッケージのみを反映するようフォルダがアップデートされます
パッケージの変更
パッケージとその子は、ほかのオブジェクトと同様に編集できます。 パッケージインスタンスを初めて編集して変更する際、警告ダイアログが開き、変更済みのパッケージはどのような手段でもアップデートできず、一連の編集を取り消すには元に戻す必要があるという事前通知が表示されます。
この役割のメンバーは、パッケージへの変更の公開を含む、現行と以前のパッケージバージョンの利用、表示、編集を行うことができます。
| 編集 | パッケージの変更 |
|---|---|
| ルートノードの名前の変更。 | いいえ |
| BasePart、ModelまたはGuiObjectパッケージのルートノードの位置または回転の変更。 | いいえ |
| ScreenGui、SurfaceGuiまたはBillboardGuiといったルートノードGuiObjectの有効化プロパティの変更。 | いいえ |
| パッケージの外部のインスタンスを参照するパッケージの中にあるWeldのパーツリファレンスの変更。 | いいえ |
変更後、未公開の変更があるパッケージは黄色の点でエクスプローラ階層に表示されます。
設定の追加または更新
パッケージのルートにインスタンス属性を入れて、パッケージ化された車両の最高速度や、パッケージ化されたボタンの公開時間など、動作をカスタマイズできます。
パッケージを公開すると、現在の属性/値のセットがパッケージのデフォルト設定になります。 パッケージの任意のコピーでは、設定は太字イタリック体で表示され、それらの属性値はインスタンスごとに変更できます。 パッケージのコピーが更新されると、変更された設定値は保持され、他の属性は最新のデフォルト値に更新されます。
現在、設定値を処理する唯一の方法は、ランタイムで設定に基づいて動作を読み取って適用するスクリプトをパッケージに追加することです。
設定のデフォルト値を更新したい場合、それらの属性値を変更してパッケージを再公開できます（この場合、パッケージは変更されたようにフラグが付けられません）。 他の変更を公開したいが、デフォルト設定値を変更したくない場合は、値を変更せずにパッケージで公開するか、公開する前に設定をデフォルトに戻す必要があります。
入れ子パッケージ
パッケージをほかのパッケージの中に入れ子にすることで、複雑な階層の管理と共同作業を行うことができます。 例えば、車両の機械的要素の数々を、車両の親パッケージとは独立させて変更できます。
入れ子パッケージを変更した場合、入れ子パッケージおよび親パッケージの両方が変更されたものと見なされます。 親を公開するとその親は最新・未変更としてマークされて入れ子パッケージの変更と競合するため、親パッケージへの変更を公開する前にすべての入れ子パッケージへの変更を公開する必要があります。
パッケージのスクリプト
未変更のパッケージ内にある各スクリプトは、読み取り専用で、上部にスクリプトのロックを解除するハイパーリンクを含む通知が表示されます。
このハイパーリンクをクリックすると次が実行されます。
- スクリプトが変更されるかどうかにかかわらず、パッケージは変更済みとフラグ付けされます。
- パッケージ内のほかのスクリプトから、この通知とハイパーリンクを削除します。
パッケージが公開されて未変更の状態になると、その下のスクリプトは読み取り専用となり、編集用のハイパーリンクが表示されます。
パッケージ変更の公開
変更済みパッケージ（黄色い丸がついたもの）を公開すると、プレース全体とすべての仮想空間にあるそのほかのパッケージのコピーで変更内容が有効になります。 プレースを公開する前に、変更済みパッケージを公開する必要はありません（変更済みのバージョンは、その後のイテレーションで利用できるようプレースと共に保存されます）。
パッケージへの変更を公開するには、次の手順に従います。
エクスプローラウィンドウで変更済みパッケージ（黄色の丸印がついたもの）を右クリックし、パッケージに公開を選択します。
古いコピーのアップデート
パッケージの古いコピーを最新バージョンにアップデートするか、古いバージョンを引き続き利用することができます。
1 つまたは複数のパッケージのコピーを最新バージョンにアップデートするには、次の手順に従います。
エクスプローラウィンドウで、名前の横に緑色の同期アイコンがある古いコピーを見つけます。
1 つの古いコピーを右クリックしてコンテキストメニューから最新パッケージを取得を選択するか、複数のコピー（変更済みを少なくとも 1 つ含む）を選び、右クリックして、選択したパッケージの最新アップデートを取得を選択します。
いずれかのパッケージのコピーが変更されている場合、** 最新アップデートを取得[]**メニューオプションは利用できません。 未公開の変更の一連で作業をしている場合、最新バージョンを取得する前に変更を元に戻す必要があります。
一括アップデート
パッケージを多用すると、バーチャル空間内の複数のプレースで多数のパッケージのコピーが存在することになる可能性があります。 個別の同期と自動アップデートに加え、一括アップデートによりパッケージの全てのコピーを更新することができます。
**（推奨）**仮想空間のプレースのいずれかが開かれている Studio（スタジオ）インスタンスを閉じます。 こうすることで、プレースのほかの未保存インスタンスがアップデート内容を上書きする可能性を回避できます。
Explorerウィンドウで、アップデートしたいパッケージを右クリックし、コンテキストメニューからすべてをアップデートを選択します。
ポップアップウィンドウのバージョンと日付の詳細の下にあるすべてにチェックを入れてバーチャル空間内のすべてのプレースを選択するか、一括アップデートを適用する特定のプレースのみを選択します。
アップデートボタンをクリックします。
パッケージの一括アップデートでは、選択したプレースを自動的に保存しますが、公開はしません。 このため、変更を表示させるには別途公開する必要があります。
意図しない上書きを防止するため、一括アップデートでは変更済みのパッケージのバージョンには影響しませんが、Studioはこの処理を通じてアップデートされないパッケージの数を警告します。
自動アップデート
簡単に同期させるには、新しいバージョンが公開されるたびに、開いている Studio セッションの中にある場合にパッケージのコピーが自動アップデートされるよう設定することができます。
エクスプローラウィンドウで、パッケージの階層ツリーを展開し、該当するPackageLinkオブジェクトを選択します。
自動アップデートは、変更済みパッケージコピーには適用されません。 パッケージインスタンスを変更すると、そのAutoUpdateプロパティは無効になり、無視されます。
共有とアクセスレベル
希望に応じて、パッケージを友達とシェアしたり、グループ内の特定のユーザー役割にアクセスを与えることができます。
ポップアップウィンドウで、左側の列にある権限を選択すると、グループ所有またはユーザー所有のパッケージのいずれかに対する共有・アクセスのオプションが表示されます。
グループ所有のパッケージの場合、グループのアイコンの隣にある›をクリックして役割ツリーを展開し、各役割の権限レベルを選択します。 薄い表示で無効になっている選択ボックスは、その役割において権限がすでに設定されていてこのウィンドウからでは変更できないことを示しています。
権限 概要 編集 この役割のメンバーは、パッケージへの変更の公開を含む、 現行と以前のパッケージバージョンの利用、表示、編集を行うことができます。 アクセス不可 この役割のメンバーは、パッケージの新しいバージョンにはアクセスできませんが、現行と以前のバージョンへのアクセスは可能です。 ユーザー所有パッケージの場合、検索フィールドで友達を検索したら友達のアバター・ユーザー名をクリック、権限レベルを選択します。
権限 概要 使用&ビュー ユーザーは現行と以前のパッケージバージョンの使用と表示を行えます（ただし編集は行えません）。 この機能をユーザーに提供すると、ユーザーがバーチャル空間にすでに挿入したコピーへのアクセスを取り消すことができなくなります。 アクセスを取り消すと、再挿入またはパッケージアップデートを回避しますが、データモデル内のパッケージコピーは元のままになります。 編集 ユーザーは、現行と以前のパッケージバージョンを使用、表示、編集できるようになります。
パッケージの変更の取り消し
一連の大規模パッケージの変更全体を一つずつ取り消すのではなく、公開されていない変更を一つの操作で元に戻す、パッケージを以前のバージョンに復元する、または特定の設定に変更を戻すといったことができます
未公開の変更の取り消し
一連の未公開の変更を取り消すには、次を行います。
エクスプローラウィンドウで、名前の隣に黄色の丸がついている変更済みコピーを見つけます。
1 つの変更済みコピーを右クリックして、コンテキストメニューからパッケージへの変更を取り消すを選択するか、複数のコピー（変更済みを少なくとも 1 つ含む）を選び、右クリックして選択したパッケージへの変更を取り消すを選択します。
バージョンへの復元
パッケージを以前に公開されたバージョンへと復元するには、次の手順に従います。
ポップアップウィンドウで、左側の列にあるバージョンを選択します。 現在公開されているバージョンと以前公開されたバージョン（V1、V2、など）が、公開された日時と共に表示されます。
復元したいバージョンの隣にあるチェックマークをクリックし、送信をクリックします。
パッケージに変更を戻しても、設定をデフォルトにリセットすることはありません。 設定の取り消しをご覧ください。
設定の取り消し
設定属性をデフォルトに戻すには、プロパティウィンドウの属性セクションのギアメニューからリセットオプションを選択します。
スクリプト変更の比較
パッケージオブジェクトにスクリプトが含まれる、またはスクリプト自体がパッケージである場合、内蔵の diff ツールを使用して 1 行ずつ相違点を比較できます。 これは、アップデートを行うかの判断と、アップデートの互換性を確保するにはバーチャル空間でほかに何を編集する必要があるかの検討を行うのに役立ちます。
スクリプトの変更を比較するには、次の手順に従います。
エクスプローラウィンドウで、変更済みまたは古いパッケージを右クリックします。 パッケージは、スクリプトであるか、またはスクリプトを含んでいる必要があります。
スクリプトの変更を表示をコンテキストメニューから選択します。
Diff 結果のタブが開かれるので、現行のパッケージのコピーと、最新の公開済みまたはローカルバージョンとの間の変更点をすべて比較します。
この比較の例では、1 行目のprint()コマンドが変更されています。 赤色でハイライトされた行は、古いスクリプトのコピーの 1 行目を示しており、そのすぐ下の緑色の行は、公開されたスクリプトパッケージの 1 行目を示しています。 さらに、公開されたスクリプトパッケージには新しく 2 つの行が追加されました。 2 行目の空の行と 3 行目の新しいprint()コマンドです。
