自2022年9月6日起,本文档站不再更新内容,相关文档已迁移至全新“抖音开放平台”前往

版本 CDN 服务

一、使用 CDN 服务

使用自己已有的 CDN 网络

  • 相应设置到自己工程的 AA Profile 配置档中

二、版本资源构建、部署

  1. 设置 AA profile:本地构建路径
  2. 设置 AA profile:加载路径
  3. 构建资源
  4. 本地输出 bundles
  5. 上传到 CDN
  6. 最后:打包 Build 版本 Apk

下面小节,对此进行详述。

三、构建和上传部署 bundle 文件

首先,正式发布版本,一般推荐选择 AA profile:ttcdn

设置一个使用自己已有的 CDN 网络。

设置界面

以下以 AA profile:ttcdn为例,分步介绍该 profile 设置中相关的路径、变量。

1.设置 AA profile:构建路径 RemoteBuildPath

设置界面

RemoteBuildPath变量决定:编辑器构建输出 bundle 的本地目录

2.设置 AA profile:加载路径 RemoteLoadPath

设置界面

RemoteLoadPath变量决定:运行时加载 bundle 的远端 url

例如:{AddressableConfig.CdnRootUrl}/[CdnProjPath]/[BuildTarget]

  • 其中:{AddressableConfig.CdnRootUrl} 使用了花括号,是引用一个类的 static 属性,运行时动态解析。
  • 此时应当在游戏启动代码中,将它 set 赋值为实际使用的 CDN 根目录 url。

例如:

// in your game initialize code
AddressableConfig.CdnRootUrl =
  "https://lf3-stark-cdn.bdgp.cc/obj/game-res-cn/ucmc" // 举例:默认使用我们字节游戏StarkContainer这边的CDN根目录

// AddressableConfig.CdnRootUrl = "https://sf1-ttcdn-tos.pstatp.com/obj/game-res-cn/ucmc"; // 2021.08.23 已废除旧域名

AddressableConfig.CdnRootUrl = "https://your-cdn-site.com/obj/res" // 举例:使用你自定义的CDN站点的根目录

// then, more initialize codes, load assets after this ...
调用示例
  • CdnRootUrl 应当设置的链接网址,可以从你的 CDN 服务页面去寻找, 例如:此页面中的【复制下载链接】,例如得到:https://lf3-stark-cdn.bdgp.cc/obj/game-res-cn/ucmc/mushroomch.mini/_dummy.txt 然后再去掉自己工程的那些子目录和文件的字符串部分(/mushroomch.mini/_dummy.txt ),即可 上图箭头位置下载
  • 其中:[CdnProjPath] 使用了中括号,引用另一个编辑器变量,为你的工程的子目录路径, 可以设置为:

例如:YourGameName/test

例如:mushroomch.mini/release

  • 以上全部拼接后,最终 RemoteLoadPath 会解释为例如:
  • 【可选】或者,也可以把 <span style="background-color: rgba(245, 246, 247, 1)"><strong>RemoteLoadPath</strong></span>** **整个变量手动修改为完整 url。

例如这样填写并拼接:

甚至这样全部如上图那样直接填写也可以
  • 注意】1:profile 配置档变量有修改后,应及时 Ctrl/Cmd + S 保存
  • 注意】2:对于 Play Mode 3: Use Existing Build 模式的调试、以及对于打包 Android Apk 构建出版本:

profile 配置档变量有修改后(例如修改加载 CDN url、子目录文件夹),必须再次“构建 AA 资源”才能正确生效

保证构建最新 AA 资源后,然后再调试、打包

3.构建 AA 资源

构建 AA 资源 bundle 应完成:

  • 选择 AA profile(例如 ttcdn)
  • 构建 AA 资源,输出 bundle 文件

4.本地输出

找到构建输出的本地目录:

此目录对应 AA profile 中的 RemoteBuildPath变量配置。

例如:/ServerData/ttcdn/Android

上图为输出的本地目录

5.上传到 CDN

将上一步输出目录所有内容,上传部署到 CDN 服务的某个子目录,应与 AA profile 中的 RemoteLoadPath变量匹配。

6.检查确认 url 正确性

通过以下几种方法,确认所 build 的 AA 资源配置的 url,与实际 hosting 工具 或 真实 CDN 网络上资源的下载链接,进行比对,以确认 url 正确性。

  • 可以通过选择一个 AA Group,确认检查 inspector 面板中的 LoadPath

检查 LoadPath

  • 可以编辑器中,确认 AA 配置窗口选择 profile(例如 ttcdn)、并选择 Play Mode: 3. Use Existing Build,编辑器 Play 运行后,检查这样格式的 log:AssetBundle - First request url:
  • 可以打开工程目录中 build 构建 AA 资源后的 catalog.json,该文件位于例如:Library/com.unity.addressables/aa/Android/catalog.json,其中找到任意一个htttp开头的*.bundle 的 url,即可确认。
  • 可以构建 Apk 并真机运行游戏,adb logcat 检查这样格式的 log:AssetBundle - First request url:

7.最后:打包 Build 版本 Apk

8.每当更新 CDN 资源

涉及包括 bundle 资源本身变更、要更新部署到 CDN,或修改 CDN url 更改,或者更改 CDN 上子目录等情况时需按以下步骤操作:

  • 如果有 url、子目录变动,确认 Editor 中修改 AA Profile 配置档
  • Editor 中执行:构建 AA 资源。
  • 部署更新到 CDN 网络。
  • 最后打包构建游戏包 APK
点击纠错
该文档是否对你的开发有所帮助?
有帮助
没帮助
该文档是否对你的开发有所帮助?
有帮助
没帮助