Live2d模型API接口

2020-01-25 101

Live2d模型api,适用于Live2D Cubism SDK v2版本,支持模型、服装的顺序切换和随机切换,材质图片经过tinypng压缩,支持cdn加速

Live2d模型API接口

Live2d模型api,适用于Live2D Cubism SDK v2版本,请勿用于商业用途!

参考https://github.com/fghrsh/live2d_api编写的nodejs版本,收藏了B站直播22、33看板娘,药水制作师,超次元游戏:海王星等模型

支持 模型、服装 的 顺序切换 和 随机切换

材质图片经过tinypng压缩,支持 cdn加速(需要SDK支持http协议资源的加载)

1、获取模型列表

url:https://api.timelessq.com/live2d/lists

method:GET

{
	"errno": 0,
	"errmsg": "",
	"data": [{
		"id": 1,
		"name": "bilibili",  // 分组名称
		"children": [{
				"id": 100,  // 模型ID
				"name": "22娘",  // 模型名称
				"message": "来自 Bilibili Live 的 22 哦 ~",
				"from": "https://github.com/xb2016/poster-girl-l2d-2233",
				"total": 20  // 材质服装数量
			},
			{
				"id": 101,
				"name": "33娘",
				"message": "来自 Bilibili Live 的 33 的说",
				"from": "https://github.com/xb2016/poster-girl-l2d-2233",
				"total": 20
			}
		]
	}]
}

2、获取模型贴图文件、Moc、动作组、物理效果、姿势

url:http://api.timelessq.com//live2d/get

method:GET

params:id   {Number}   模型id   必填项

               texture   {Number}   材质id   必填项   范围:1~材质服装总数,如22娘为1到20

               isuseCDN   {Boolean}   是否使用CDN加速,需要客户端live2d支持http协议的资源文件

例子:https://api.timelessq.com/live2d/get?id=100&texture=1

{
  "type": "Live2D Model Setting",
  "name": "22-3695903",
  "label": "22",
  "model": "../model/bilibili/22/model.moc",  // moc文件
  "textures": [ // 材质贴图文件
    "../model/bilibili/22/texture_00/closet-default.png",
    "../model/bilibili/22/texture_01/2016-default-upper.png",
    "../model/bilibili/22/texture_02/2016-default-lower.png",
    "../model/bilibili/22/texture_03/2016-default-hat.png"
  ],
  "layout": {
     ...
  },
  "hit_areas_custom": {
    "head_x": [
      -0.33,
      0.6
    ],
    "head_y": [
      0.19,
      -0.2
    ],
    "body_x": [
      -0.3,
      -0.25
    ],
    "body_y": [
      0.3,
      -0.9
    ]
  },
  "motions": { // 动作组
      ...
  }
}

3、根据模型id按顺序获取下一模型

同分组 多个模型 按顺序切换,得到模型id后可以通过http://api.timelessq.com//live2d/get,获取该模型的数据

url:https://api.timelessq.com/live2d/model/switch

method:GET

params:id   {Number}   模型id   必填项

例子:https://api.timelessq.com/live2d/model/switch?id=100

{
  "errno": 0,
  "errmsg": "",
  "data": {
    "id": 101, // 顺序切换下一模型id
    "message": "来自 Bilibili Live 的 33 的说"
  }

4、根据模型id随机获取下一模型

url:https://api.timelessq.com/live2d/model/random

method:GET

params:id   {Number}   模型id   必填项

例子:https://api.timelessq.com/live2d/model/random?id=100

{
  "errno": 0,
  "errmsg": "",
  "data": {
    "id": 200,  // 随机切换下一模型id
    "message": "来自 Potion Maker 的 Pio 酱 ~"
  }
}

评论(0)

0/500

还没有评论,快来抢第一吧