vue 看板娘
可直接在 vue 项目中直接引用此包,即可应用看板娘,目前包含简单的功能配置。
https://evgo2017.com/repos/live2d,访问速度快
https://evgo2017.github.io/vue-live2d/page/index.html,部署在 github 上,访问速度不定,但示例较完善,方便调整参数查看效果,同本地浏览页面效果。
npm install vue-live2d
// 在组件中引入
import live2d from 'vue-live2d'
import 'vue-live2d/dist/vue-live2d.css'
// 支持 Vue.use(live2d)
其中包含源码,example/App.vue
为使用示例。
$ git clone https://github.com/evgo2017/vue-live2d.git
$ cd ./vue-live2d
$ npm install
$ npm run serve
核心是 packages 文件夹下的文件。
$ npm run build-bundle
生成的文件在 dist 文件夹内,是 npm 安装此插件后在 node_modules/vue-live2d
内的文件。
配置项 | 含义 | 类型 | 默认 |
---|---|---|---|
size | 模型宽度和高度 | Number | 255 |
width | 模型宽度 | Number | 0 |
height | 模型高度 | Number | 0 |
apiPath | 更换模型的请求地址 | String | https://live2d.fghrsh.net/api |
model | 默认显示的模型,[编码,衣服号] | Array | [1, 53] |
direction | 模型方位(左或者右) | String | left(其他字符串均表示 right) |
tips | 在触发某些事件时模型说出的话 | Object | 格式查看 /packages/src/tips.js |
homePage | 可打开某页面的地址 | String | https://github.com/evgo2017/vue-live2d |
customId | 自定义 id | String | vue-live2d-main |
这三个参数放在一起说,它们都是用来调整模型宽高的。width 只调整宽度,height 只调整高度,size 同时调整宽高为同一值。
优先级:width = height > size。可以说 width 和 height 参数会覆盖 size 参数设置的对应值。
设置 size 是为了减少重新加载模型的次数。
加载模型时是通过请求此 API 地址获得数据,也可自行搭建,进而进一步设置模型。
默认显示的模型,为数组,第一个值代表具体模型编码,第二个值代表该模型的皮肤号。
插件每次切换模型或者换装时候,都会在控制台 console 这此信息,可通过此方便获得自己喜欢的模型信息。
模型方位,仅支持左(left)或者右(right)。
当为 left 时,工具栏会置于左侧,同时鼠标经过模型时,模型会整体向右移动。right 反之。
在页面上触发某些事件时,模型会说出的话。
注意:此参数只可初始化一次,若使用插件定义的默认值则不要绑定此参数。
插件中只有显示模型的 canvas 必须有 id ,可自定义其 id 值。
此参数是我在尝试一个页面上加载多个模型时增加,可以成功,但通常最初只会显示一个模样,需要手动触发其他模型,同时原本显示的模型成为静态,触发的其他模型变为动态。
比如页面有一个 A 模型,和一个 B 模型。A 正确显示,但 B 只有工具栏等内容。此时手动点击 B 模型的切换模型或者换装,B 模型正确显示,同时 A 模型成为静态,不再随着鼠标移动而动。再次点击 A 模型重复操作同理。
这部分切换应该是与核心库有关,综合考虑不继续完善此功能。
现版本是参考资料中的项目进行修改的,改动较大,核心为 live2d.min.js
,暂不知作者是谁。
也有查看 live2d 官网的 Web SDK (4-r.1),综合考虑后还是采用目前的 js。
[1] https://github.com/fghrsh/live2d_demo