CCD + Addressables 演练

• 使用可寻址资源来配置和管理资源
• 生成 AssetBundles
• 在 Unity Dashboard（Unity 后台）中设置项目
• 设置命令行界面
• 在 CCD 后台中创建存储桶和标示
• 上传 AssetBundles

下载项目

测试项目

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. 按编辑器的 Play（运行） 按钮尝试运行游戏。

安装 Addressables 资源包

1. 选择 Window（窗口）> Package Manager（包管理器）。
2. 搜索已针对您当前所使用的 Unity 编辑器版本进行了验证的最新版本的 Addressables 包。此示例使用版本 1.16.19。
3. 选择所需的版本，然后选择 Install（安装）。

将游戏资源配置为可寻址

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. 将 Project（项目）窗口中的 Hats 文件夹（选择 Prefabs（预制件）> Hats（帽子））中的全部内容（不是文件夹本身）拖到 Hats 组中。
8. 从 Addressables Groups（Addressables 组）窗口中选择每个资源，然后在 Inspector（检视面板）窗口中将该资源冗长的 Addressable（可寻址）字段重命名为更简洁的名称。您可以选择所有资源，然后右键单击 > Simplify Addressable Names（简化可寻址资源名称） 来自动进行重命名。 对于场景资源 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

配置相应的配置文件并构建 AssetBundles

1. 在此阶段，创建一个新的 Addressables 配置文件，以便将与游戏开发相关的所有关联设置保存到此开发配置文件中：
   1. 单击 Window（窗口）> Asset Management（资源管理）> Addressables > Groups（组）。
   2. 从下拉选单中选择 Profile（配置文件）> Manage Profiles（管理配置文件）。
   3. 在打开的 Addressables Profiles（Addressables 配置文件）窗口中，选择 Create（创建）> Profile（配置文件）。
   4. 随即显示一个名为“New Profile”的配置文件。右键单击该配置文件，然后选择 Rename Profile（重命名配置文件）。将该配置文件命名为“Development Profile”。
2. 右键单击 Development Profile > Set Active（设为激活状态）。此操作会将 Development Profile 设置为当前正在使用的配置文件。
3. 现在，构建您的 AssetBundle，这是一个存档文件，其中包含游戏的非代码资源。这样一来，编辑器的运行模式就会使用 AssetBundles 而不是本地资源。
   1. 单击 Window（窗口）> Asset Management（资源管理）> Addressables > Groups（组）。
   2. 从下拉选单中选择 Build（构建）> New Build（新建构建）> Default Build Script（默认构建脚本）。
   3. 从下拉选单中选择 Play Mode Script（运行模式脚本）> Use Existing Build（使用现有构建）。

开始使用 CCD

1. 转到 Unity Dashboard（Unity 后台）。
2. 使用您的 Unity ID 登录。
3. 在 Projects（项目）下拉选单中，单击 Create Project（创建项目）。
   1. 将项目命名为“Loady Dungeons Workshop”。
   2. 单击 Create project（创建项目）。
4. 单击 Loady Dungeons Workshop 的 Project Settings（项目设置）（齿轮图标）。记下 Project ID。
5. 在左侧，选择 Environments（环境）。
6. 如果还没有开发环境，请创建一个。
7. 在 Dashboard（后台）登陆页面中，找到并选择 Cloud Content Delivery。

命令行界面（可选）

1. 下载适用于您的操作系统的 CLI。
2. 确保将 CLI 的文件夹包含在计算机的环境变量中。
3. 打开命令行并导航到项目的文件夹。
4. 输入以下命令以确保 CLI 已成功配置：

   ucd help

存储桶

创建存储桶

1. 在 CCD 登陆页面中，单击左侧的 Buckets（存储桶）。
2. 从 Projects（项目）下拉选单中选择 Loady Dungeons Workshop（如果尚未选择）。
3. 单击 Create Bucket（创建存储桶）。
   1. 将存储桶命名为“Loady Dungeons Sample”。
   2. 为存储桶提供可选描述。
   3. 为此存储桶选择以下选项之一：
      • Open to all（向所有人开放）：任何人都可以修改此存储桶中的内容。
      • Promotion only（仅推进）：所有者和管理员可以通过推进来修改内容。任何人都无法将内容上传到此存储桶或删除此存储桶中的内容。
   4. 要限制对此存储桶的读取访问权限，请选择 Enable Bucket Privacy（启用存储桶隐私）。私有存储桶仅允许拥有访问令牌的用户读取内容。
      注意

      创建存储桶后，无法更改存储桶隐私设置。
   5. 选择 Next（下一步）。
   6. 确保已检查生产环境和开发环境。
   7. 选择 Create（创建）。

手动生成 AssetBundles 并上传内容

生成 AssetBundles

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。如果您先前没有记下您的 Project ID，请通过以下方式进行查找：单击 Dashboard（后台）一角的用户名，然后单击 Account（帐户）> Project Management（项目管理）> Loady Dungeons Workshop。
     • 将路径中的

       BUCKET_ID

       替换为要使用的存储桶（在此示例中是您的开发环境中创建的 Loady Dungeons Sample 存储桶）的 ID。如果您先前没有记下此存储桶的

       BUCKET_ID

       ，请在 CCD Dashboard（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 重复上述设置
   此设置将这四组资源的构建路径和加载路径设置为我们为 Development Profile 指定的路径。
8. 仍在 Groups（组）窗口中，单击 Build（构建） 下拉选单，然后选择 New Build（新建构建）> Default Build Script（默认构建脚本）。此操作会将 AssetBundles 保存在 RemoteBuildPath 位置。
9. 要使用我们刚创建的构建作为游戏测试的基础，请单击 Play Mode Script（运行模式脚本）> Use Existing Build（使用现有构建）。
10. 单击 Unity 编辑器中的 Play（运行） 按钮以测试游戏。
    • 在游戏中按 Start（开始）。注意游戏现在的卡顿情况。

上传内容

1. 从后台选择开发环境中的 Loady Dungeons Sample 存储桶。
2. 选择 Upload using the dashboard（使用后台上传）（如果存储桶为空）或 Upload Content（上传内容）（如果存储桶已包含条目）。
3. 进行拖放，或选择 Browse（浏览） 按钮，将内容从构建 AssetBundles 所在的文件夹上传到 CCD Development 存储桶。您的文件位于先前指定为 RemoteBuildPath 的文件夹中。
4. 选择 Upload 5 Files（上传 5 个文件）（四个关卡再加上 Hats）。
5. 上传过程完成后，选择 Refresh Page（刷新页面） 以更新存储桶信息的状态。相应条目将显示为 Unreleased Changes（未发布的更改）。这意味着这些条目存在于存储桶中，但尚未包含在发布版本中。
6. 要创建发布版本，请选择 Create Release（创建发布版本）。此操作会获取您上传到开发环境 Loady Dungeons Sample 存储桶的 AssetBundles，并将它们绑定到一个发布版本中。按照屏幕上的提示完成该过程。

latest

使用 CCD Management 包生成 AssetBundles 并上传内容

生成 AssetBundles

1. 在您的 Unity 编辑器项目中，单击 Window（窗口）> Asset Management（资源管理）> Addressables > Groups（组）。
2. 在 Profile（配置文件）下拉选单中，确保已选择 Development Profile。
3. 在 Profile（配置文件）下拉选单中，选择 Manage Profiles（管理配置文件）。
4. 在 Profiles（配置文件）窗口中，选择 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 Path（构建路径）和 Load Path（加载路径）：Remote（远程）
   2. 对 Level 00、Level 01、Level 02 和 Level 03 重复上述设置
   此设置将这四组资源的构建路径和加载路径设置为先前为 Development Profile 指定的路径对。如需了解更多有关路径对的信息，请参阅配置文件。
8. 在 Groups（组）窗口中，单击 Build（构建）下拉选单，然后选择 New Build（新建构建）> Default Build Script（默认构建脚本）。此操作会将 AssetBundles 保存在 RemoteBuildPath 位置。
9. 要使用我们创建的构建作为游戏测试的基础，请单击 Play Mode Script（运行模式脚本）> Use Existing Build（使用现有构建）。
10. 选择 Unity 编辑器中的 Play（运行） 按钮以测试游戏。
11. 在游戏中选择 Start（开始）。注意游戏现在的卡顿情况。

上传内容

1. 在您的 Unity 编辑器项目中，单击 Window（窗口）> Asset Management（资源管理）> Addressables > Groups（组）。
2. 选择 Build & Release（构建并发布）。

latest

推进发布版本

1. 在 Unity Dashboard（Unity 后台）中转到 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 编辑器中，按编辑器的 Play（运行） 按钮。
2. 在游戏中按 Start（开始）。
3. 在游戏中按 Play（运行）。您现在可以在 Unity 编辑器中玩游戏。

将 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