cocos creator的资料实在太少,只好自己来分析和补充
DragonBones 骨骼动画,又叫龙骨动画,由白鹭时代推出的动画解决方案,免费。
Spine 与之相同的另一款骨骼动画解决方案,据说比dragonBones更强大,没用过没有发言权,收费
DragonBones动画制作
这不是重点,官方有制作教程,官方文档
导出时请注意
- 目前的Cocos Creator支持的数据版本是4.5
- 类型是DragonBones
- 输出比例可以根据需求设置
导出的是三个文件
- _tex.png 资源图集
- _tex.json 图集位置文件
- _ske.json 骨骼动画文件
在Cocos Creator 中使用
- 把导出的三个文件放到项目assets的同一文件下
- 在Scene中建一个空节点
- 在空节点的属性检查器中通过添加组件方式添加dragonBones组件
- 将_ske.json 拖到dragonBones组件的 Dragon Asset 属性
- 将_tex.json 拖到dragonBones组件的 Dragon Atlas Asset 属性
如此就可以在场景中看到骨骼动画的效果了,这个骨骼动画官方找的
脚本部分
写一个player.js 的脚本,绑在这个dragonBones组件所在的节点
player.js
cc.Class({
extends: cc.Component,
onLoad:function(){
//获取 ArmatureDisplay
this._armatureDisPlay = this.getComponent(dragonBones.ArmatureDisplay)
//获取 Armatrue
this._armature = this._armatureDisPlay.armature()
//添加动画监听
this._armatureDisPlay.addEventListener(dragonBones.EventObject.FADE_IN_COMPLETE, this.animationEventHandler, this)
this._armatureDisPlay.addEventListener(dragonBones.EventObject.FADE_OUT_COMPLETE, this.animationEventHandler, this)
},
attack:function(){
//动画执行方式一
this._armature.animation.fadeIn('attack1', -1, -1, 0, 'hit');
},
attack2:function(){
//动画执行方式二
this._armatureDisPlay.playAnimation('attack2', 1);
},
animationEventHandler: function animationEventHandler(event) {
if (event.type == dragonBones.EventObject.FADE_IN_COMPLETE) {
cc.log(event.detail.animationName + ' fade in complete');
} else if (event.type == dragonBones.EventObject.FADE_OUT_COMPLETE) {
cc.log(event.detail.animationName + ' fade out complete');
}
}
})
看了这个脚本文件,你是不是马上想去查看API,
然而...
关于dragonBones,Cocos 官方API给出如下
是不是觉得很坑,说好的API 呢
昨天还在群里和群友扯这些Cocos Creator的坑,群友来了句,这东西本来就是免费开源的,有什么问题你可以直接去改源码啊...
改源码... 呵呵
话不扯太多,给大家掰一掰这里面牵扯到的API吧
DrgonBones相关API
ArmatureDisplay
官方唯一有给出的api
(Armature Display 具有对骨骼数据的引用并且存储了骨骼实例的状态, 它由当前的骨骼动作,slot 颜色,和可见的 slot attachments 组成。
多个 Armature Display 可以使用相同的骨骼数据,其中包括所有的动画,皮肤和 attachments。)
-
playAnimation ( animName playTimes )
return dragonBones.AnimationState
播放指定的动画. animName 指定播放动画的名称。 playTimes 指定播放动画的次数。 -1 为使用配置文件中的次数。 0 为无限循环播放。
Ok,在白鹭时代的网站上找到了dragonBones的API
白鹭时代API文档
下面只列一下刚刚脚本中用到的API,其它的大家可以去看API
Armature
Armature 是 DragonBones 骨骼动画系统的核心。他包含需要加到场景的显示对象,所有的骨骼逻辑和动画系统
- animation
[只读] 骨架的动画实例
Animation
Animation实例隶属于Armature,用于控制Armature的动画播放
白鹭的API没有找到Animation.fadeIn方法,API中给出了gotoAndPlay方法
- gotoAndPlay ( animationName :string, fadeInTime :number, duration :number, playTimes :number, layer :number, group :string, fadeOutMode :string, pauseFadeOut :boolean, pauseFadeIn :boolean )
- return dragonBones.AnimationState
- 开始播放指定名称的动画
在源码中找到了fadeIn方法的代码,如下
/**
* @language zh_CN
* 淡入播放指定名称的动画。
* @param animationName 动画数据的名称。
* @param playTimes 循环播放的次数。 [-1: 使用数据默认值, 0: 无限循环播放, [1~N]: 循环播放 N 次]
* @param fadeInTime 淡入的时间。 [-1: 使用数据默认值, [0~N]: N 秒淡入完毕] (以秒为单位)
* @param layer 混合的图层,图层高会优先获取混合权重。
* @param group 混合的组,用于给动画状态编组,方便混合淡出控制。
* @param fadeOutMode 淡出的模式。
* @param additiveBlending 以叠加的形式混合。
* @param displayControl 是否对显示对象属性可控。
* @param pauseFadeOut 暂停需要淡出的动画。
* @param pauseFadeIn 暂停需要淡入的动画,直到淡入结束才开始播放。
* @returns 返回控制这个动画数据的动画状态。
* @see dragonBones.AnimationFadeOutMode
* @see dragonBones.AnimationState
* @version DragonBones 4.5
*/
Animation.prototype.fadeIn = function (animationName, fadeInTime, playTimes, layer, group, fadeOutMode, additiveBlending, displayControl, pauseFadeOut, pauseFadeIn) {
if (fadeInTime === void 0) { fadeInTime = -1; }
if (playTimes === void 0) { playTimes = -1; }
if (layer === void 0) { layer = 0; }
if (group === void 0) { group = null; }
if (fadeOutMode === void 0) { fadeOutMode = 3 /* SameLayerAndGroup */; }
if (additiveBlending === void 0) { additiveBlending = false; }
if (displayControl === void 0) { displayControl = true; }
if (pauseFadeOut === void 0) { pauseFadeOut = true; }
if (pauseFadeIn === void 0) { pauseFadeIn = true; }
var animationData = this._animations[animationName];
if (!animationData) {
this._time = 0;
console.warn("Non-existent animation.", "DragonBones: " + this._armature.armatureData.parent.name, "Armature: " + this._armature.name, "Animation: " + animationName);
return null;
}
if (this._time != this._time) {
this._time = 0;
}
this._isPlaying = true;
if (fadeInTime != fadeInTime || fadeInTime < 0) {
if (this._lastAnimationState) {
fadeInTime = animationData.fadeInTime;
}
else {
fadeInTime = 0;
}
}
if (playTimes < 0) {
playTimes = animationData.playTimes;
}
this._fadeOut(fadeInTime, layer, group, fadeOutMode, pauseFadeOut);
this._lastAnimationState = dragonBones.BaseObject.borrowObject(dragonBones.AnimationState);
this._lastAnimationState._layer = layer;
this._lastAnimationState._group = group;
this._lastAnimationState.additiveBlending = additiveBlending;
this._lastAnimationState.displayControl = displayControl;
this._lastAnimationState._fadeIn(this._armature, animationData.animation || animationData, animationName, playTimes, animationData.position, animationData.duration, this._time, 1 / animationData.scale, fadeInTime, pauseFadeIn);
this._animationStates.push(this._lastAnimationState);
this._animationStateDirty = true;
this._time = 0;
if (this._animationStates.length > 1) {
this._animationStates.sort(Animation._sortAnimationState);
}
var slots = this._armature.getSlots();
for (var i = 0, l = slots.length; i < l; ++i) {
var slot = slots[i];
if (slot.inheritAnimation) {
var childArmature = slot.childArmature;
if (childArmature &&
childArmature.animation.hasAnimation(animationName) &&
!childArmature.animation.getState(animationName)) {
childArmature.animation.fadeIn(animationName);
}
}
}
this._armature.advanceTime(0);
return this._lastAnimationState;
}
今天只是介绍了一下骨骼动画的基本使用方法,如有时间再和大家讨论更多的骨骼动画问题
有问题 请留言...