CCD と Addressables のウォークスルー

• Addressable Assets パッケージを使用してアセットを設定および管理する
• アセットバンドルを生成する
• Unity Dashboard でプロジェクトを設定する
• コマンドラインインターフェースを設定する
• CCD ダッシュボードでバケットとバッジを作成する
• アセットバンドルをアップロードする

プロジェクトをダウンロードする

プロジェクトをテストする

1. Unity エディターを開きます。
2. Loady Dungeons プロジェクトを開きます。
3. MainMenu シーンを開きます。
4. Game (ゲーム) タブをクリックします。
5. Aspect (アスペクト) ドロップダウンで、+ をクリックします。
   1. Type (タイプ) が "Aspect Ratio" (アスペクト比)、Width (幅) と Height (高さ) がそれぞれ 9 と 16 の新しいアスペクトを作成します。これにより、ゲームのプレビューが携帯電話で実行したときの外観に近くなります。
   2. OK をクリックします。
   3. Low Resolution Aspect Ratios (低解像度のアスペクト比) をオフにします。
6. エディターの 再生 ボタンを押して、ゲームを試します。

Addressable Assets パッケージをインストールする

1. Window (ウィンドウ) > Package Manager (パッケージマネージャー) を選択します。
2. 使用している Unity エディターで検証済みの最新バージョンの Addressables を探します。この例では、バージョン 1.16.19 を使用します。
3. 必要なバージョンを選択し、Install (インストール) を選択します。

ゲームアセットを Addressable として設定する

1. Project (プロジェクト) ウィンドウで Scenes (シーン) フォルダーを開きます。
2. 以下のアセットを選択します。
   • Level_00
   • Level_01
   • Level_02
   • Level_03
3. Inspector ウィンドウで、それぞれに対して Addressable を選択します。
4. Window (ウィンドウ) > Asset Management (アセット管理) > Addressables > Groups (グループ) から Addressables Groups (Addressables グループ) ウィンドウを開きます。
5. Create (作成) > Group (グループ) > Packed Assets (パックされたアセット) を使用して、以下のグループを新規作成します。
   • Level 00
   • Level 01
   • Level 02
   • Level 03
   • Hats
6. Scenes (シーン) のアセットを、デフォルトグループからそれぞれの対応するグループにドラッグします。例えば、Level_01 シーンを、デフォルトグループから新規作成した Level 01 グループにドラッグします。
7. Hats フォルダーの (フォルダー自体ではなく) コンテンツ全体を、Project (プロジェクト) ウィンドウの Hats フォルダー (Prefabs (プレハブ) > Hats) から Hats グループにドラッグします。
8. Addressables Groups (Addressables ウィンドウ) から各アセットを選択し、その長い Addressable フィールドの名前を Inspector ウィンドウ内でより単純な名前に変更します。すべてのアセットを選択し、右クリック > Simplify Addressable Names (Addressable の名前を単純化) を選択すると、それらの名前が自動的に変更されます。 シーンアセット Level_00 であれば、Addressable フィールドにあるその名前を Assets/Scenes/Level_00.unity から Level_00 に変更します。
   • シーンアセット Level_00 の Addressable フィールドの名前を Level_00 に変更
   • シーンアセット Level_01 の Addressable フィールドの名前を Level_01 に変更
   • シーンアセット Level_02 の Addressable フィールドの名前を Level_02 に変更
   • シーンアセット Level_03 の Addressable フィールドの名前を Level_03 に変更
   • プレハブアセット Hat00 の Addressable フィールドの名前を Hat00 に変更
   • プレハブアセット Hat01 の Addressable フィールドの名前を Hat01 に変更
   • プレハブアセット Hat02 の Addressable フィールドの名前を Hat02 に変更
   • プレハブアセット Hat03 の Addressable フィールドの名前を Hat03 に変更

プロファイルを設定してアセットバンドルをビルドする

1. この段階では、新しいアドレス指定可能プロファイルを作成し、ゲームの開発に関するすべての関連設定をこの開発プロファイルに保存します。
   1. Window (ウィンドウ) > Asset Management (アセット管理) > Addressables > Groups (グループ) をクリックします。
   2. ドロップダウンから Profile (プロファイル) > Manage Profiles (プロファイルの管理) を選択します。
   3. 表示される Addressables Profiles (アドレス指定可能プロファイル) ウィンドウで、Create (作成) > Profile (プロファイル) を選択します。
   4. New Profile (新しいプロファイル) という名前のプロファイルが表示されます。それを 右クリック して、Rename Profile (プロファイルの名前を変更) を選択します。“Development Profile” という名前を付けます。
2. Development Profile を右クリックし、Set Active (アクティブに設定) を選択します。これにより、Development Profile が現在使用中のプロファイルとして設定されます。
3. 次に、ゲームのコード以外のアセットを含むアーカイブファイル、アセットバンドル をビルドします。これを行うのは、エディターの再生モードで、ローカルアセットの代わりにアセットバンドルを使用するためです。
   1. Window (ウィンドウ) > Asset Management (アセット管理) > Addressables > Groups (グループ) をクリックします。
   2. Build (ビルド) > New Build (新しいビルド) > Default Build Script (デフォルトビルドスクリプト) をドロップダウンから選択します。
   3. Play Mode Script (再生モードスクリプト) > Use Existing Build (既存のビルドを使用) をドロップダウンから選択します。

CCD の使用を開始する

1. Unity Dashboard に移動します。
2. Unity ID を使用してサインインします。
3. Projects (プロジェクト) ドロップダウンから、Create Project (プロジェクトを作成) をクリックします。
   1. “Loady Dungeons Workshop” という名前を付けます。
   2. Create project (プロジェクトを作成) をクリックします。
4. Loady Dungeons Workshop の Project Settings (プロジェクト設定、歯車のアイコン) をクリックします。プロジェクト ID をメモします。
5. 左側で、Environments (環境) を選択します。
6. まだ開発環境がない場合は作成します。
7. Unity Dashboard のランディングページで、Cloud Content Delivery を見つけて選択します。

コマンドラインインターフェース (任意)

1. 使用している OS 用の CLI をダウンロード します。
2. 必ず、CLI のフォルダーをコンピューターの環境変数に加えてください。
3. コマンドラインを開き、プロジェクトのフォルダーに移動します。
4. 以下のコマンドを入力して、CLI が正常に設定されていることを確認します:

   ucd help

バケット

バケットを作成する

1. CCD のランディングページで、左側の Buckets (バケット) をクリックします。
2. プロジェクトのドロップダウンから Loady Dungeons Workshop を選択します (まだ選択されていない場合)。
3. Create Bucket (バケットを作成) をクリックします。
   1. バケットに “Loady Dungeons Sample” という名前を付けます。
   2. バケットの説明 (任意) を入力します。
   3. バケットを以下のどちらにするかを選択します。
      • Open to all (全員に公開): 誰でもこのバケット内のコンテンツを変更することができます。
      • Promotion only (昇格専用): オーナーとマネージャーが、昇格 によってコンテンツを変更できます。誰も、このバケットにコンテンツをアップロードしたり、このバケットからコンテンツを削除したりはできません。
   4. このバケットに対する読み取りアクセスを制限するには、Enable Bucket Privacy (バケットのプライバシーを有効化) を選択します。Private バケットでは、アクセストークンを持つユーザーのみがコンテンツを読み取ることができます。
      注

      バケットの作成後にバケットのプライバシー設定を変更することはできません。
   5. Next (次へ) を選択します。
   6. 本番環境と開発環境の両方にチェックが付いていることを確認してください。
   7. Create (作成) を選択します。

アセットバンドルを生成し、コンテンツを手動でアップロードする

アセットバンドルを生成する

1. Unity エディターのプロジェクトで、Window (ウィンドウ) > Asset Management (アセット管理) > Addressables > Groups (グループ) をクリックします。
2. Profile (プロファイル) ドロップダウンで、Development Profile が選択されていることを確認します。選択されていない場合は、ここで選択します。
3. Profile (プロファイル) ドロップダウンで、Manage Profiles (プロファイルの管理) を選択します。
4. Development Profile が選択された状態で、以下のように設定します。
   • RemoteBuildPath:

     AssetBundles/[BuildTarget]

     。ここで、

     [BuildTarget]

     はデフォルトのサブフォルダーです。
   • RemoteLoadPath:

     https://PROJECT_ID.client-api.unity3dusercontent.com/client_api/v1/buckets/BUCKET_ID/release_by_badge/latest/entry_by_path/content/?path=

     • PROJECT_ID

       をプロジェクトの ID に置き換えます。プロジェクト ID を前にメモしていなかった場合は、ダッシュボードの隅にあるユーザー名をクリックし、Account (アカウント) > Project Management (プロジェクト管理) > Loady Dungeons Workshop で調べます。
     • パス内の

       BUCKET_ID

       を、使用するバケット (この例では、開発環境に作成した Loady Dungeons Sample バケット) の ID に置き換えます。その

       BUCKET_ID

       を前にメモしていなかった場合は、CCD ダッシュボード内のバケットのリストで調べます。
     • パス内の

       latest

       は、最新のリリースに割り当てられている自動生成されたバッジ Latest を指します。
5. Addressables Groups (Addressables グループ) ウィンドウに戻ります。
6. Hats を選択します。
7. Inspector パネルで、以下のように設定します。
   1. Build Path: RemoteBuildPath
   2. Load Path: RemoteLoadPath
   3. Level 00、Level 01、Level 02、Level 03 に対して繰り返します。
   これにより、これらの 4 組のアセットのビルドパスとロードパスが、Development Profile に対して指定したパスに設定されます。
8. 引き続き Addressables Groups (Addressables グループ) ウィンドウで、Build (ビルド) ドロップダウンをクリックし、New Build (新しいビルド) > Default Build Script (デフォルトビルドスクリプト) を選択します。これにより、アセットバンドルが RemoteBuildPath の場所に保存されます。
9. 先ほど作成したビルドをプレイテストのベースとして使用するには、Play Mode Script (再生モードスクリプト) > Use Existing Build (既存のビルドを使用) をクリックします。
10. Unity エディターの 再生 ボタンをクリックしてゲームをテストします。
    • ゲーム内の Start (開始) を押します。ゲームがどのようにスタックしているかに注目してください。

コンテンツをアップロードする

1. ダッシュボードで、開発環境の Loady Dungeons Sample バケットを選択します。
2. バケットが空の場合は Upload using the dashboard (ダッシュボードを使用してアップロード)、バケットにすでにエントリーが含まれている場合は Upload Content (コンテンツをアップロード) を選択します。
3. ドラッグアンドドロップするか、Browse (参照) ボタンを選択して、アセットバンドルをビルドしたフォルダーから CCD の開発バケットにコンテンツをアップロードします。ファイルは、先ほど RemoteBuildPath として指定したフォルダーにあります。
4. Upload 5 Files (5 個のファイルをアップロード) (4 つのレベルと Hats) を選択します。
5. アップロードプロセスが終わったら、Refresh Page (ページを更新) を選択して、バケットの情報のステータスを更新します。エントリーは Unreleased Changes (未リリースの変更) として表示されます。これは、エントリーがバケット内に存在するが、まだ リリース にラップされていないことを意味します。
6. リリースを作成するには、Create Release (リリースを作成) を選択します。これにより、開発環境の Loady Dungeons Sample バケットにアップロードしたアセットバンドルが取得され、リリースにバインドされます。画面上のプロンプトに従って、プロセスを完了します。

latest

アセットバンドルを生成し、CCD Management パッケージを使用してコンテンツをアップロードする

アセットバンドルを生成する

1. Unity エディターのプロジェクトで、Window (ウィンドウ) > Asset Management (アセット管理) > Addressables > Groups (グループ) をクリックします。
2. Profile (プロファイル) ドロップダウンで、Development Profile が選択されていることを確認します。
3. Profile (プロファイル) ドロップダウンで、Manage Profiles (プロファイルの管理) を選択します。
4. Profile (プロファイル) ウィンドウで、Development Profile を選択し、Remote (リモート) ドロップダウンを Cloud Content Delivery を使用するように変更します。
   注

   この時点でまだ CCD Management パッケージをインストールしていない場合は、追加するよう求めるプロンプトが Unity エディターで表示されます。インストールするには、Install CCD Management SDK Package (CCD Management SDK パッケージをインストール) ボタンをクリックします。
   1. 次に表示されるオプションのリストで、先ほど作成した Loady Dungeons Sample バケットを選択します。
   2. その後に表示されるリストで、Latest (最新) バッジを選択します。
5. Addressables Groups (Addressables グループ) ウィンドウに戻ります。
6. Hats を選択します。
7. Inspector パネルの Content Packaging & Loading (コンテンツのパッケージ化とロード) で、以下を行います。
   1. Build and Load Paths (ビルドパスとロードパス) を Remote (リモート) に設定します。
   2. Level 00、Level 01、Level 02、Level 03 に対して繰り返します。
   これにより、これらの 4 組のアセットのビルドパスとロードパスが、Development Profile に対して指定したパスのペアに設定されます。パスのペアの詳細については、プロファイル を参照してください。
8. Groups (グループ) ウィンドウで、Build (ビルド) ドロップダウンをクリックし、New Build (新しいビルド) > Default Build Script (デフォルトビルドスクリプト) を選択します。これにより、アセットバンドルが RemoteBuildPath の場所に保存されます。
9. 作成したビルドをプレイテストのベースとして使用するには、Play Mode Script (再生モードスクリプト) > Use Existing Build (既存のビルドを使用) をクリックします。
10. Unity エディターの 再生 ボタンを選択して、ゲームをテストします。
11. ゲーム内の Start (開始) を選択します。ゲームがどのようにスタックしているかに注目してください。

コンテンツをアップロードする

1. Unity エディターのプロジェクトで、Window (ウィンドウ) > Asset Management (アセット管理) > Addressables > Groups (グループ) をクリックします。
2. Build & Release (ビルドとリリース) を選択します。

latest

リリースを昇格させる

1. まだ行っていない場合は、Unity Dashboard で Loady Dungeons Workshop CCD プロジェクトに移動し、Environments (環境) ドロップダウンで開発環境が選択されていることを確認し、Loady Dungeons Sample バケットを選択します。
2. Promote Release (リリースを昇格) を選択します。
3. Target Environment (ターゲット環境) ドロップダウンで、production (本番) を選択します。
4. Target Bucket (ターゲットバケット) ドロップダウンで、Loady Dungeons Sample を選択します。
5. リリースノート (任意) を追加します。
6. Next (次へ) を選択し、画面上のプロンプトに従います。
7. Promote Release (リリースを昇格) を選択します。

latest

1. 環境ごとに別々のプレイヤービルドを用意します。開発ビルドではデバッグシンボルを利用し、

   bucket_id

   変数を開発環境のバケットに設定します。本番ビルドではデバッグシンボルを無効にし、

   bucket_id

   変数を本番環境のバケットに設定しますが、どちらのビルドでも同じコンテンツを使用します。
2. プロファイル変数の静的プロパティまたは TransformInternalId を使用して、実行時にカタログがリーチするバケットを動的に変更します。Addressables における静的プロファイル変数と内部 ID の変換の詳細については、リソース URL の変換 に関するドキュメントを参照してください。

1. Unity エディターで、エディターの 再生 ボタンを押します。
2. ゲーム内で Start (開始) を押します。
3. ゲーム内で Play (再生) を押します。Unity エディター内でゲームをプレイできるようになりました。

Private バケットで Addressables を使用する

void Start(){	textComponent = GetComponent<Text>();	Addressables.WebRequestOverride = webRequest =>	{		webRequest.SetRequestHeader("Authorization", "Basic "+token);		//  Debug.Log($"Fetching: {webRequest.url}");	};	Addressables.LoadAssetAsync<TextAsset>("Assets/one.txt").Completed += handle =>	{		textComponent.text = handle.Result.text;		// Debug.Log($"Text is now: {handle.Result.text}");	};}

token