模块

引擎通过模块向开发者暴露功能接口,模块以 ECMAScript 模块形式存在。

⚠️ 注意,从 v3.0 开始,将不能通过全局变量 cc 访问引擎功能!

引擎模块

功能

模块 'cc' 提供了所有引擎功能的访问。模块 'cc' 的内容是动态的,其内容和 项目设置 中的 功能裁剪 设置有关。

引擎日志输出

示例:

  1. import { log } from 'cc';
  2. log('Hello world!');

构建时常量

引擎模块 'cc/env' 暴露了一些构建时的 常量,这些常量代表执行环境、调试级别或平台标识等。

由于这些常量都以 const 声明,提供了很好的代码优化机会。

执行环境

名称(类型都为 boolean说明
BUILD是否正在构建后的环境中运行
PREVIEW是否正在预览环境中运行
EDITOR是否正在编辑器环境中运行

调试级别

名称(类型都为 boolean说明
DEBUG是否处于调试模式。仅当构建时未勾选调试选项的情况下为 false,其它情况下都为 true
DEV等价于 DEBUG/EDITOR/PREVIEW

平台标识

下表列出的常量表示是否正在 某一个某一类 平台上运行,常量的类型都是 boolean

名称代表平台MINIGAME “小游戏”RUNTIME_BASED 基于 Cocos RuntimeSUPPORT_JIT 支持 JIT
HTML5Web
NATIVE原生平台
ALIPAY支付宝小游戏✔️✔️
BAIDU百度小游戏✔️✔️
BYTEDANCE字节跳动小游戏✔️✔️
WECHAT微信小游戏✔️✔️
XIAOMI小米快游戏✔️✔️
COCOSPLAYCocos Play✔️✔️
HUAWEI华为快游戏✔️✔️
OPPOOPPO 小游戏✔️✔️
VIVOvivo 小游戏✔️✔️

调试模式下的输出

示例如下:

  1. import { log } from 'cc';
  2. import { DEV } from 'cc/env';
  3. if (DEV) {
  4. log('I am in development mode!');
  5. }