CocosCreator3.0的版本改动

悠悠 2022-11-15 11:38 139阅读 0赞

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

## 一、文件布局 ##

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3UwMTM2NTQxMjU_size_16_color_FFFFFF_t_70][]

package文件夹改成extensions文件夹；

具体查看 [https://docs.cocos.com/creator/3.0/manual/zh/editor/publish/custom-build-plugin.html][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][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][https_docs.cocos.com_creator_3.0_manual_zh_editor_extension_profile.html_h_profiles] 。

## 二、脚本的API ##

### 1.cc的移除 ###

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

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3UwMTM2NTQxMjU_size_16_color_FFFFFF_t_70 1][]

**3.0：**移除了cc的前缀

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3UwMTM2NTQxMjU_size_16_color_FFFFFF_t_70 2][]

## 三、开放数据域的编写 ##

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

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3UwMTM2NTQxMjU_size_16_color_FFFFFF_t_70 3][]

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

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3UwMTM2NTQxMjU_size_16_color_FFFFFF_t_70 4][]

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

具体的开放数据域目录大概像这样![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3UwMTM2NTQxMjU_size_16_color_FFFFFF_t_70 5][]

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

## 四、可以实现Prefab的嵌套 ##

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3UwMTM2NTQxMjU_size_16_color_FFFFFF_t_70 6][]

## 五、音频播放 ##

**之前：**

// 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.html
    
    const { 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",  // 普通子弹击中1
        hitpop_B = "hitpop_B",  // 普通子弹击中2
        bgm_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较之前的版本还是有很多的细小的区别，这里就不细说了。

[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3UwMTM2NTQxMjU_size_16_color_FFFFFF_t_70]: /images/20221022/7d23a382ecda4709b60073d5b67cd8b7.png
[https_docs.cocos.com_creator_3.0_manual_zh_editor_publish_custom-build-plugin.html]: https://docs.cocos.com/creator/3.0/manual/zh/editor/publish/custom-build-plugin.html
[https_docs.cocos.com_creator_3.0_manual_zh_editor_publish_custom-project-build-template.html]: https://docs.cocos.com/creator/3.0/manual/zh/editor/publish/custom-project-build-template.html
[https_docs.cocos.com_creator_3.0_manual_zh_editor_extension_profile.html_h_profiles]: https://docs.cocos.com/creator/3.0/manual/zh/editor/extension/profile.html?h=profiles
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3UwMTM2NTQxMjU_size_16_color_FFFFFF_t_70 1]: /images/20221022/49cea3e0947b41af8db67df29e29ff88.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3UwMTM2NTQxMjU_size_16_color_FFFFFF_t_70 2]: /images/20221022/19c5a479b1af4a8fbd09f8bb78c674fc.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3UwMTM2NTQxMjU_size_16_color_FFFFFF_t_70 3]: https://img-blog.csdnimg.cn/20210331185026201.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3UwMTM2NTQxMjU=,size_16,color_FFFFFF,t_70
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3UwMTM2NTQxMjU_size_16_color_FFFFFF_t_70 4]: https://img-blog.csdnimg.cn/20210331184939376.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3UwMTM2NTQxMjU=,size_16,color_FFFFFF,t_70
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3UwMTM2NTQxMjU_size_16_color_FFFFFF_t_70 5]: https://img-blog.csdnimg.cn/20210331185238246.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3UwMTM2NTQxMjU=,size_16,color_FFFFFF,t_70
[https_docs.cocos.com_creator_3.0_manual_zh_editor_publish_build-open-data-context.html]: https://docs.cocos.com/creator/3.0/manual/zh/editor/publish/build-open-data-context.html
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3UwMTM2NTQxMjU_size_16_color_FFFFFF_t_70 6]: https://img-blog.csdnimg.cn/20210331190613397.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3UwMTM2NTQxMjU=,size_16,color_FFFFFF,t_70