Skip to main content
Version: 2023.1

设置

xasset 的设置配置主要包含以下属性：

提示

在 Unity 编辑器中选择使用 xasset>Edit Settings 可以快速定位到设置配置。

Develop​

开发设置主要包括：

  • Playmode 决定了 Unity 编辑器进入播放模式后，xasset 的运行模式，可以通过 xasset>Playmode 菜单快速切换，了解更多请参考运行模式的说明。
  • Editor Runtime Platform 决定了 Unity 编辑器进入播放模式后 xasset 的运行平台，就是可以在不切换 Unity 的平台的情况下，加载该平台打包后的资产。
  • Remote Assets URL 远程资产地址，需要指向 Build Path 的文件夹，当使用Start With Remote Assets模式运行的时候，xasset 会从该地址对应的资产目录加载资产。

对于专业版用户。目前，xasset 已经完美解决了 Google 没做好的 Android App Bundle 包的 Asset Pack 在编辑器环境的调试加载更新不方便的问题，这将大幅边玩边下功能的开发测试时间。

Build​

构建设置主要包括：

  • Build Path 输出目录的根目录。
  • Bundles Name 打包资产后输出的运行时使用的资产包目录。
  • Bundles Cache Name 打包资产后输出的编辑器增量大打包使用的资产包缓存目录。
  • Player Assets Name 打包安装包资产后输出的安装包资产目录。
  • Players Name 打包安装包后输出的安装包目录。
  • Updatable 运行时是否开启更新。
  • Update Info URL 运行时更新信息的下载地址。
  • Download URL 生成的 updateinfo.json 中资产下载地址。
  • Player URL 安装包下载更新地址，强更时跳转的 url。
  • Pack Player Assets 是否将安装包内的资产二次打包，Android 设备上开启这个选项可以优化 IO 效率。
  • Player Assets Split Mode 安装包资产分包模式。

Bundle​

资产包设置主要包括：

  • Check Reference 是否检查引用关系。默认开启，打包时会检查同一个资产是否被多个打包配置中的分组引用，如果出现会报错并中断打包任务。
  • Simplify Path Depth 简化包名路径。需要注意的是，如果开启这个选项，那么在打包时，可能会把多个父目录和名字相同的文件打包到一起。
  • Options 打包版本文件的选项，
  • Pack By File For All Scenes 是否让所有场景按文件为单位打包。
  • Pack Together For All Shaders 是否让所有 Shader 打包到一起。
  • Force Use Builtin Pipeline 强制使用内置管线
  • Extension 打包输出的 bundle 的扩展名。
  • Shaders 用到的 Shader 文件的扩展名。
  • Exclude Files 打包采集资产和依赖时需要排除的文件。

Player​

播放器配置的主要选项有：

  • Log Level 日志级别。从低到高依次为 Info、Debug、Warning、Error、None 几个级别，勾选高级别的时候不输出低级别的日志。
  • Max Downloads 最大并行下载数量。同步下载请求会突破这个显示。
  • Max Download Retry Times 最大下载错误重试次数。
  • Max Requests 每个队列最大单帧更新数量。
  • Autoslicing 是否开启自动切片。开启后，xasset 会根据自动切片时间步长，和当前帧处理的总耗时，自动把没处理完成的异步请求放到下一帧处理，从而避免单帧业务堆积导致卡顿。
  • Autoslicing Timestep 自动切片时间步长，值越大处理的请求数量越多，值越小处理请求的数量越小，可以根据目标帧率分配。
  • Auto Release Timestep 自动回收的时间步长。
  • Search Paths 加载资产的搜索路径。具体用法请参考搜索路径的说明。
  • Preload Assets 预加载资产列表，在初始化时会自动加载，只能配置在打包分组中的资产。

Player Assets Split Mode​

安装包资产分离模式主要包含如下选项：

  • Split By Install Time Assets Only 安装包中只包含交付模式为 Install Time 的 Groups 中的资产。（专业版可用）
  • Include All Assets 安装包中包含所有资产。
  • Exclude All Assets 安装包中不包含资产。

需要注意的是：

  1. 在 WebGL 平台中，只会发布包含所有资产的安装包。
  2. 在未勾选 Updatable 的时候，也只会发布包含所有资产的安装包。