项目设置

项目设置 面板通过点击编辑器主菜单栏中的 项目 -> 项目设置 即可打开，主要用于设置特定项目的相关配置项。这些设置会保存在项目的 settings/packages 文件夹中。如果需要在不同开发者之间同步项目设置，请将 settings 目录加入到版本控制。

项目设置 由几个不同的分页组成，包括 Macro Config、功能裁剪、项目数据、Layers、物理、脚本 和 纹理压缩。修改设置之后 项目设置 面板会自动保存修改。

Macro Config（引擎宏配置）

引擎宏设置 提供了修改宏配置的快捷方式，配置的宏将会在预览、构建时生效，同时也会跟随自定义引擎的配置更新当前宏配置的默认值。

macro

  • ENABLE_TILEDMAP_CULLING：是否开启 TiledMap 的自动裁减功能，默认开启。需要注意的是 TiledMap 如果设置了 skew 和 rotation 的话，建议手动关闭该项，否则会导致渲染出错。

  • TOUCH_TIMEOUT：用于甄别一个触点对象是否已经失效并且可以被移除的延时时长。开发者可通过修改这个值来获得想要的效果，默认值是 5000 毫秒。详情请参考 API 文档 TOUCH_TIMEOUT。

  • ENABLE_TRANSPARENT_CANVAS：用于设置 Canvas 背景是否支持 Alpha 通道，默认不开启支持。

    • 若希望 Canvas 背景是透明的，并显示背后的其他 DOM 元素，便可开启该项。
    • 若关闭该项，则会有更高的性能表现。

  • ENABLE_WEBGL_ANTIALIAS：是否开启 GL 的抗锯齿配置，默认开启。这个配置只影响 GL 相关后端，对应在创建 GL Context 时是否传入抗锯齿选项。

  • CLEANUP_IMAGE_CACHE：是否在将贴图上传至 GPU 之后删除原始图片缓存，删除之后图片将无法进行 动态合图。该项默认不开启。

  • ENABLE_MULTI_TOUCH：是否开启多点触摸，默认开启。

  • MAX_LABLE_CANVAS_POOL_SIZE：设置 Label 使用的 Canvas 对象池的最大数量，请根据项目同场景的 Label 数量进行调整。

更多关于引擎宏模块的具体信息与代码可以参考 Engine Macro（GitHub | Gitee）。

功能裁剪

功能裁剪 分页主要是针对发布游戏时引擎中使用的模块进行裁剪，达到减小发布版引擎包体的效果。列表中未选中的模块在打包、预览时将会被裁剪掉。建议打包后进行完整的测试，避免场景和脚本中使用到了被裁剪掉的模块。

feature-core

项目数据

项目数据 分页主要用于设置默认 Canvas、渲染管线等，只对当前项目生效。

project-data

默认 Canvas 设置

默认 Canvas 设置包括 设计分辨率 和 适配屏幕宽度/高度，用于规定在新建场景或 Canvas 组件 时，Canvas 中默认的设计分辨率数值，以及 Fit Height 和 Fit Width。详情请参考 多分辨率适配方案。

渲染管线

渲染管线用于控制场景的渲染流程，目前内置的渲染管线包括 builtin-forward (前向渲染管线) 和 builtin-deferred (延迟渲染管线) ，开发者也可以自定义渲染管线。详情请参考 进阶主题 — 渲染管线

Layers

Layers

  • Layers 能让相机渲染部分场景，让灯光照亮部分场景。
  • 可自定义 0 到 19 个 Layers，清空输入框则删除原先的设置。
  • 后 12 个 Layers 是引擎内置的，不可修改。

  • 目前使用到 Layer 的位置包括：

    1. Node 节点在 属性检查器 中的 Layer 属性。

      Layers-node

    2. Camera 节点在 属性检查器 中的 Visibility 属性，节点的 Layer 属性匹配相机的 Visibility 属性。只有当节点设置的 Layer 属性包含在相机的 Visibility 中时，节点才可以被相机看见。更多说明可以参考 Camera 组件。

      Layers-camera

物理

physics

用于配置物理的各项参数，详情请参考 物理配置。

脚本

scripting

  • 符合规范的类字段：当开启时，将使用 Define 语义实现类字段，否则，将使用 Set 语义实现类字段。

  • 允许声明类字段：当开启时，在 TypeScript 脚本中将允许使用 declare 关键字来声明类字段。当字段以 declare 声明且未指定显式的初始化式时，将依照规范初始化为 undefined。

  • 启用宽松模式：启用宽松模式进行脚本编译。

  • 导出条件：为条件化导出模块指定解析条件，详情可参考 条件性导出。

压缩纹理

与 Cocos Creator 2.x 不同，Cocos Creator 3.0 的压缩纹理是在 项目设置 中配置预设，然后在 属性检查器 中选择图片资源的预设方式。旧版本的项目在升级到 v3.0 后，编辑器会自动扫描项目中所有的压缩纹理配置情况，整理出几个预设，由于是自动扫描的，所以预设名称可能不匹配项目，可以自行在此处修改。

compress-texture

该分页主要用于添加压缩纹理预设配置，可添加多个，每个压缩纹理配置允许针对不同的平台制定配置细则。添加完成后，在 层级管理器 中选中图片资源，就可以在 属性检查器 中快速添加压缩纹理预设。同时也可以在该分页中直接修改预设来达到批量更新压缩纹理配置的使用需求。

目前配置压缩纹理支持以下平台：

  1. Web：包括 Web-Mobile 和 Web-Desktop 两个平台
  2. iOS
  3. Mini Game: 包括目前 Creator 支持的所有小游戏平台，比如微信小游戏、华为快游戏等
  4. Android

各平台对纹理压缩的支持情况，详情请参考 压缩纹理。

添加/删除纹理压缩预设

在上方的输入框中输入压缩纹理预设名称，点击 Enter 键或者右侧的加号按钮即可添加一个预设。另外两个按钮是用于导入/导出压缩纹理预设，详情请参考下文介绍。

add

添加完压缩纹理后，如需删除可以直接将鼠标移到预设名称上，点击右侧的删除按钮即可。

delete

注意：面板中内置的 default 和 transparent 这两个预设不可修改/删除。

添加/删除纹理压缩格式

选择平台，然后点击 Add Format 按钮，选择需要的纹理格式，再配置好对应的质量等级即可，目前同类型的图片格式只能添加一次。

add-format

如需删除，将鼠标移至纹理格式上方，点击右侧的红色删除按钮即可。

delete-format

修改压缩纹理预设名称

压缩纹理预设的名称仅仅是作为 显示 使用，在添加压缩纹理预设时，就会随机生成 uuid 作为该预设的 ID，因而直接修改预设名称并不会影响图片资源处对预设的引用。

edit

导出/导入压缩纹理预设

压缩纹理配置页面允许导入/导出压缩纹理预设，以便更好地跨项目复用配置，也可以自行在外部编辑好压缩纹理预设再导入到编辑器。

大部分情况下直接导入导出即可，如果需要自行编写压缩纹理配置，请参考下方接口定义与范例：

接口定义：

  1. type IConfigGroups = Record<ITextureCompressPlatform, IConfigGroupsInfo>;
  2. type ITextureCompressPlatform = 'miniGame' | 'web' | 'ios' | 'android' | 'pc';
  3. type ITextureCompressType =
  4.     | 'jpg'
  5.     | 'png'
  6.     | 'webp'
  7.     | 'pvrtc_4bits_rgb'
  8.     | 'pvrtc_4bits_rgba'
  9.     | 'pvrtc_4bits_rgb_a'
  10.     | 'pvrtc_2bits_rgb'
  11.     | 'pvrtc_2bits_rgba'
  12.     | 'pvrtc_2bits_rgb_a'
  13.     | 'etc1_rgb'
  14.     | 'etc1_rgb_a'
  15.     | 'etc2_rgb'
  16.     | 'etc2_rgba'
  17.     | 'astc_4x4'
  18.     | 'astc_5x5'
  19.     | 'astc_6x6'
  20.     | 'astc_8x8'
  21.     | 'astc_10x5'
  22.     | 'astc_10x10'
  23.     | 'astc_12x12';
  24. type IConfigGroupsInfo = Record<ITextureCompressType, IQuality>
  25. interface ICompressPresetItem {
  26.     name: string;
  27.     options: IConfigGroups;
  28. }

示例参考：

  1. {
  2.     "default": {
  3.         "name": "default",
  4.         "options": {
  5.             "miniGame": {
  6.                 "etc1_rgb": "fast",
  7.                 "pvrtc_4bits_rgb": "fast"
  8.             },
  9.             "android": {
  10.                 "astc_8x8": "-medium",
  11.                 "etc1_rgb": "fast"
  12.             },
  13.             "ios": {
  14.                 "astc_8x8": "-medium",
  15.                 "pvrtc_4bits_rgb": "fast"
  16.             },
  17.             "web": {
  18.                 "astc_8x8": "-medium",
  19.                 "etc1_rgb": "fast",
  20.                 "pvrtc_4bits_rgb": "fast"
  21.             },
  22.         }
  23.     },
  24.     "transparent": {
  25.         "name": "transparent",
  26.         "options": {
  27.             "miniGame": {
  28.                 "etc1_rgb_a": "fast",
  29.                 "pvrtc_4bits_rgb_a": "fast"
  30.             },
  31.             "android": {
  32.                 "astc_8x8": "-medium",
  33.                 "etc1_rgb_a": "fast"
  34.             },
  35.             "ios": {
  36.                 "astc_8x8": "-medium",
  37.                 "pvrtc_4bits_rgb_a": "fast"
  38.             },
  39.             "web": {
  40.                 "astc_8x8": "-medium",
  41.                 "etc1_rgb_a": "fast",
  42.                 "pvrtc_4bits_rgb_a": "fast"
  43.             },
  44.         }
  45.     }
  46. }

扩展项目设置面板

Creator 支持在 项目设置 右侧添加自定义功能页，详情请参考 扩展项目设置。