【cocos2d-js官方文档】二十一、v3相对于v2版本的api变动

最新推荐文章于 2022-05-03 22:20:36 发布

转载最新推荐文章于 2022-05-03 22:20:36 发布 · 3.9k 阅读

文章标签：

#cocos2d #cocos2d-js #html5 #javascript #js

cocos2d-js 专栏收录该内容

29 篇文章

订阅专栏

本文概述了Cocos2d-x更新中的主要变化，包括SimpleAudioEngine.js更名为CCAudio.js，AudioEngine部分方法调整，纹理格式命名变更，Scheduler及数组操作函数改进等。此外还涉及了一些API的废弃和新增。

CCAudio.js

SimpleAudioEngine.js改名为CCAudio.js。

AudioEngine中删除了以下几个方法：

preloadMusic
preloadEffect
isFormatSupported
preloadSound

cc.AudioEngine.end被移到了实例中，而不是作为类的静态方法。

cc.textureCache

删除了以下的几个api：

cc.loadImg
cc.loadImage.handler
cc.computeImageFormatType

addImageAsync方法被合并到了addImage中去了。

CCTGAlib.js

移除了cc.tgaLoad。

cc.Texture2D

改动：

cc.TEXTURE_2D_PIXEL_FORMAT_RGBA8888     --> cc.Texture2D.PIXEL_FORMAT_RGBA8888
cc.TEXTURE_2D_PIXEL_FORMAT_RGB888       --> cc.Texture2D.PIXEL_FORMAT_RGB888
cc.TEXTURE_2D_PIXEL_FORMAT_RGB565       --> cc.Texture2D.PIXEL_FORMAT_RGB565
cc.TEXTURE_2D_PIXEL_FORMAT_A8           --> cc.Texture2D.PIXEL_FORMAT_A8
cc.TEXTURE_2D_PIXEL_FORMAT_I8           --> cc.Texture2D.PIXEL_FORMAT_I8
cc.TEXTURE_2D_PIXEL_FORMAT_AI88         --> cc.Texture2D.PIXEL_FORMAT_AI88
cc.TEXTURE_2D_PIXEL_FORMAT_RGBA4444     --> cc.Texture2D.PIXEL_FORMAT_RGBA4444
cc.TEXTURE_2D_PIXEL_FORMAT_RGB5A1       --> cc.Texture2D.PIXEL_FORMAT_RGB5A1
cc.TEXTURE_2D_PIXEL_FORMAT_PVRTC4       --> cc.Texture2D.PIXEL_FORMAT_PVRTC4
cc.TEXTURE_2D_PIXEL_FORMAT_PVRTC2       --> cc.Texture2D.PIXEL_FORMAT_PVRTC2
cc.TEXTURE_2D_PIXEL_FORMAT_DEFAULT      --> cc.Texture2D.PIXEL_FORMAT_DEFAULT
cc.Texture2D.setDefaultAlphaPixelFormat(format) --> cc.Texture2D.defaultPixelFormat = format
cc.Texture2D.getDefaultAlphaPixelFormat()       --> cc.Texture2D.defaultPixelFormat
cc.Texture2D.defaultAlphaPixelFormat()          --> cc.Texture2D.defaultPixelFormat

cc.Scheduler

cc.PRIORITY_SYSTEM改为cc.Scheduler.PRIORITY_SYSTEM。

数组操作函数

这些函数有些将名字开头改为小写，有些废弃了直接用Array的函数进行操作。

cc.ArrayVerifyType --> cc.arrayVerifyType
cc.ArrayRemoveObject --> cc.arrayRemoveObject
cc.ArrayRemoveArray ---> cc.arrayRemoveArray
cc.ArrayAppendObjectsToIndex --> cc.arrayAppendObjectsToIndex

cc.ArrayRemoveObjectAtIndex(arr, index) --> arr.splice(index, 1)
cc.ArrayGetIndexOfValue(arr, value) --> arr.indexOf(value)
cc.ArrayAppendObject(arr, addObj) --> arr.push(addObj)
cc.ArrayAppendObjectToIndex(arr, addObj, index) --> arr.splice(index, 0, addObj)
cc.ArrayGetIndexOfObject(arr, findObj) --> arr.indexOf(findObj)
cc.ArrayContainsObject(arr, findObj) --> arr.indexOf(findObj) != -1

remove cc.HASH_FIND_INT

共有方法或对象变成私有方法或对象：

cc.setup                    --> cc._setup
cc.initDebugSetting         --> cc._initDebugSetting
cc.canvas                   --> cc._canvas
cc.drawingUtil              --> cc._drawingUtil
cc.renderContext            --> cc._renderContext
cc.gameDiv                  --> cc._gameDiv
cc.setContextMenuEnable     --> cc._setContextMenuEnable
cc.renderContextType        --> cc._renderType
cc.CANVAS                   --> cc._RENDER_TYPE_CANVAS
cc.WEBGL                    --> cc._RENDER_TYPE_CANVAS
cc.mainRenderContextBackup  --> cc._mainRenderContextBackup
cc.RectFromString           --> cc.spriteFrameCache._rectFromString
cc.PointFromString          --> cc.spriteFrameCache._pointFromString
cc.SizeFromString           --> cc.spriteFrameCache._sizeFromString

常量

删除：

cc.IS_SHOW_DEBUG_ON_PAGE
cc.COCOS2D_DEBUG

其他

修改

cc.dumpConfig ---> cc.sys.dump

删除：

cc.isAddedHiddenEvent
cc.originalCanvasSize

新增：

cc.BuilderReader.registerController

转载自： http://www.cocos2dx.net/post/247