CocosCreator3.0的版本改动

CocosCreator3.0版本是真正的3D项目集成版本。其中有很大的版本改动，例如：

一、文件布局

package文件夹改成extensions文件夹；

具体查看 https://docs.cocos.com/creator/3.0/manual/zh/editor/publish/custom-build-plugin.html 。

增加build-templates文件夹，该文件夹对于构建自定义项目很有帮助；

具体查看 https://docs.cocos.com/creator/3.0/manual/zh/editor/publish/custom-project-build-template.html 。

增加profiles文件夹，该文件夹包含项目配置信息、场景配置信息等；

具体查看 https://docs.cocos.com/creator/3.0/manual/zh/editor/extension/profile.html?h=profiles 。

二、脚本的API

1.cc的移除

之前：没有了cc的命名空间，如之前的CCClass的属性定义是

3.0：移除了cc的前缀

三、开放数据域的编写

之前：我们需要创建一个CocosCreator项目，然后在编译的时候，选择“开放数据域”的项目类型即可。如图：

3.0：我们需要在构建的时候选择"生成开放数据域工程模板"，如图：

然后再像写web前端那样，编辑开放数据域项目。

具体的开放数据域目录大概像这样

开放数据域的具体的开发流程可参考：https://docs.cocos.com/creator/3.0/manual/zh/editor/publish/build-open-data-context.html 。

四、可以实现Prefab的嵌套

五、音频播放

之前：

// Learn TypeScript:
//  - https://docs.cocos.com/creator/manual/en/scripting/typescript.html
// Learn Attribute:
//  - https://docs.cocos.com/creator/manual/en/scripting/reference/attributes.html
// Learn life-cycle callbacks:
//  - https://docs.cocos.com/creator/manual/en/scripting/life-cycle-callbacks.htmlconst { ccclass, property } = cc._decorator;@ccclass
export class AudioMgr {static musicVolume: number = 1.0;static roleVolume: number = 1.0;static effectVolume: number = 1.0;static curPlayEffectId: number = 0;static init() {this.initVolumes();this.setMusicVolume(this.musicVolume, false);}static playMusic(audio: AudioType, loop: boolean = false) {cc.resources.load("mp3/" + audio, cc.AudioClip, (err, clip: cc.AudioClip) => {if (err) {console.error("playMusic", err);return;}cc.audioEngine.playMusic(clip, loop);});}// 播放普通音效 / 角色音效static playEffect(audio: AudioType | string, type: VolumeType = VolumeType.OTHER, loop: boolean = false, cb?: (audioId: number) => void) {cc.audioEngine.setEffectsVolume(type === VolumeType.OTHER ? this.effectVolume : this.roleVolume);this._playEffect(audio, loop, cb);}// 播放普通音效，播放这次声音时，取消上次声音static playEffectNoRepeat(audio: AudioType | string, type: VolumeType = VolumeType.OTHER, loop: boolean = false, cb?: (audioId: number) => void) {cc.audioEngine.setEffectsVolume(type === VolumeType.OTHER ? this.effectVolume : this.roleVolume);if (this.curPlayEffectId) {cc.audioEngine.stopEffect(this.curPlayEffectId);}cc.resources.load("mp3/" + audio, cc.AudioClip, (err, clip: cc.AudioClip) => {if (err) {console.error("playEffectNoRepeat", err);cb && cb(-1);return;}this.curPlayEffectId = cc.audioEngine.playEffect(clip, loop);cb && cb(this.curPlayEffectId);});}static _playEffect(audio: AudioType | string, loop: boolean = false, cb?: (audioId: number) => void) {cc.resources.load("mp3/" + audio, cc.AudioClip, (err, clip: cc.AudioClip) => {if (err) {console.error("_playEffect", err);cb && cb(-1);return;}let id = cc.audioEngine.playEffect(clip, loop);cb && cb(id);});}// bgm音量static setMusicVolume(volume: number, saved = true) {this.musicVolume = volume;cc.audioEngine.setMusicVolume(this.musicVolume);if (saved) cc.sys.localStorage.setItem("musicVolume", volume);}// 角色音效音量static setRoleVolume(volume: number, saved = true) {this.roleVolume = volume;if (saved) cc.sys.localStorage.setItem("roleVolume", volume);}// 普通音效音量static setEffectVolume(volume: number, saved = true) {this.effectVolume = volume;if (saved) cc.sys.localStorage.setItem("effectVolume", volume);}// 静音 / 恢复声音static setAudioEnabled(enabled: boolean) {if (enabled) {cc.audioEngine.setMusicVolume(this.musicVolume);cc.audioEngine.setEffectsVolume(this.effectVolume);} else {cc.audioEngine.setMusicVolume(0);cc.audioEngine.setEffectsVolume(0);}}// 读取用户音量设置static initVolumes() {let musicVolume = cc.sys.localStorage.getItem("musicVolume");let roleVolume = cc.sys.localStorage.getItem("roleVolume");let effectVolume = cc.sys.localStorage.getItem("effectVolume");this.musicVolume = musicVolume ? parseFloat(musicVolume) : 0.3;this.roleVolume = roleVolume ? parseFloat(roleVolume) : 1.0;this.effectVolume = effectVolume ? parseFloat(effectVolume) : 0.5;}
}export const enum AudioType {loginBgm = "bgm_lobby",     // 登录背景音乐button_01 = "UI_button",    // 按钮点击音效hitpop_A = "hitpop_A",  // 普通子弹击中1hitpop_B = "hitpop_B",  // 普通子弹击中2bgm_win = "bgm_win_01", //胜利bgm_fail = "bgm_fail_01", //失败bgm_boss_coming = "bgm_bossopening_01",   // boss出场音效role_hit = "hit_knife_01",          // 角色受伤时音效gold = "battery",       // 电池diamond = "chip",       // 钻石box_open = "boxopen",   // 得到卡牌碎片tutorial = "tutorial",   // 教程door = "door", //门request1 = "request1",  // 好友邀请音效slotcard = "slotcard",  // 随即机甲按钮losefire = "losefire",  // 随即机甲按钮duan_levelup = "levelup",  // 段位升级音效score_up = "pointnumber", // 结算分数音效
}export const enum VolumeType {MUSIC = 0,  // 背景音ROLE,       // 人声音效OTHER,      // 其他音效
}// 角色攻击音效
export function getRoleAttackAudio(roleId: number) {return "role/role_" + roleId + "attack";
}// 角色攻击音效
export function getRoleIdleAudio(roleId: number) {return "role/role_" + roleId + "idle";
}// 角色攻击音效
export function getCardUpgradeAudio() {return "card_upgrade";
}// 角色受伤音效
export function getRoleHurtAudio(roleId: number) {return "role/role_" + roleId + "hurt";
}

3.0：


/*音频管理类，主要负责音频的加载，播放*/
import { _decorator, Component, Node, AudioClip, sys } from 'cc';
import { ResMgr } from './ResMgr';
const { ccclass, property } = _decorator;@ccclass('AudioMgr')
export class AudioMgr {static curBgMusicPath: string = null!;static bgMusicArr: { [key: string]: AudioClip } = {};static soundEffectArr: { [key: string]: AudioClip } = {};static soundVolume: number = 1;static bgMusicVolume: number = 1;//播放背景音乐static playBgMusic(audioPath: string) {this.curBgMusicPath = audioPath;if (this.getBgMusicOpen()) {if (this.bgMusicArr[audioPath]) {this.bgMusicArr[audioPath].setVolume(this.bgMusicVolume);this.bgMusicArr[audioPath].play();} else {ResMgr.loadRes("audio/" + audioPath, AudioClip, (err, clip) => {if (err) {console.error("找不到背景音乐audio/" + audioPath + "的音频！");return;}this.bgMusicArr[audioPath] = clip;clip.setVolume(this.bgMusicVolume);clip.setLoop(true);clip.play();});}}}//暂停背景音乐static pauseBgMusic() {if (this.bgMusicArr[this.curBgMusicPath]) {this.bgMusicArr[this.curBgMusicPath].pause();}}//播放一般音频static playSoundEffect(audioPath: string) {if (this.getSoundEffectOpen()) {if (this.soundEffectArr[audioPath]) {this.soundEffectArr[audioPath].setVolume(this.bgMusicVolume);this.soundEffectArr[audioPath].play();} else {ResMgr.loadRes("audio/" + audioPath, AudioClip, (err, clip) => {if (err) {console.error("找不到音效audio/" + audioPath + "的音频！");return;}this.soundEffectArr[audioPath] = clip;clip.setVolume(this.soundVolume);clip.setLoop(false);clip.play();});}}}//设置背景音乐static setBgMusicOpen(open: boolean) {if (open) {sys.localStorage.setItem("BgMusic", "1");this.playBgMusic(this.curBgMusicPath);} else {sys.localStorage.setItem("BgMusic", "0");this.pauseBgMusic();}}static getBgMusicOpen(): boolean {if (sys.localStorage.getItem("BgMusic") == "0") {return false;} else {return true;}}//设置音效static setSoundEffect(open: boolean) {if (open) {sys.localStorage.setItem("SoundEffect", "1");} else {sys.localStorage.setItem("SoundEffect", "0");}}static getSoundEffectOpen(): boolean {if (sys.localStorage.getItem("SoundEffect") == "0") {return false;} else {return true;}}
}

以上是一些比较大的区别，3.0较之前的版本还是有很多的细小的区别，这里就不细说了。