Live2d for CocosCreator

根据Lived2d的官方WebGL示例修改,适配 CocosCreator

在线示例(手机模式打开)

使用方法

• 将 assest/components 目录中的"live2d"文件夹拷贝到项目中

  

• 场景中新建节点并附加组件"Live2dComponent"

  

  • 设置节点 Size 作为显示 Live2d 模型的画布尺寸,设置 ScaleY 为-1(不知道为什么我设置了 RenderTexture 的 setFlipY(true)也没有用,只能用 Scale 把节点倒置过来)
  • Render Texture: 可以不填,组件会自动创建 cc.RenderTexture 和 cc.Sprite 组件
  • Scale: 显示 Live2d 模型大小(暂时没有找到 live2d 设置缩放的地方,这里直接修改 Viewport 尺寸达到缩放的目的,感觉 3 左右挺好的)
  • Fps: Live2d 的刷新率(游戏 Live2d 在 update 的时候有相当的计算量,所以这里的 fps 可以比游戏的低一些,感觉 30fps 足够了,即使 20fps 也不觉得卡)
  • Loop Idel Motion: 是否自动循环Idel动作
  • Model Name: 加载live2d模型的名字

• 常用函数

  • this.getComponent(Live2dComponent.live2d //获取Live2d代理对象
  • this.getComponent(Live2dComponent).live2d.getModel(0) //获取Live2d模型
  • this.getComponent(Live2dComponent).live2d.getModel(0).startMotion(动作组名, 动作编号, 切换优先级(大数值打断小数值)) //执行动作
  • 动作结束会在Live2dComponent的节点emit事件Live2dComponent.EvtMotionFinish
  • this.getComponent(Live2dComponent).live2d.getModel(0).setExpression(表情名) //做表情
  • this.getComponent(Live2dComponent).live2d.loadModel(模型名) //加载模型,现在一次只有一个模型

注意事项

• 资源默认放置在 resources\live2d 文件夹中
• 由于CocosCreator的资源加载策略,自动识别资源类型与扩展名所以需要将live2d导出的资源重命名
  • XXX.moc3 => XXX_moc3.bin
  • XXX.model3.json => XXX_model3.bin
  • XXX.physics3.json => XXX_physics3.bin
  • XXX.pose3.json => XXX_pose3.bin
  • XXX.userdata3.json => XXX_userdata3.bin
  • XXX.motion3.json => XXX_motion3.bin
  • 使用脚本resource/rename_live2d.py可自动转换resource/live2d目录下的文件名