Live2dRender 功能一览

发送消息

发送信息非常简单,使用 live2d.initializeLive2D 初始化模型完成后,使用 setMessageBox 方法展示对话框,下面是例子:

live2d.setMessageBox('想要知道我的故事?好故事很贵的,我的朋友。', 3000);

3000 的意思是消息只会展示 3000 ms,3000 ms 过后,对话框会自动消失。

效果如下。

如果将该值设为 0 | undefined | null,那么消息框就会永远停留。这种情况下,阁下可以通过 live2d下的这两个同步方法来控制对话框的出现和消失。

// 隐藏对话框
live2d.hideMessageBox();

// 展示对话框
live2d.revealMessageBox();

自定义消息框样式

你可以在项目中输入 css 来覆盖默认的消息框样式,下面是一个例子:

#live2dMessageBox-content {
    background-color: #FF95BC;
    color: white;
    font-family: var(--base-font);
    padding: 10px;
    height: fit-content;
    border-radius: .7em;
    word-break: break-all;
    border-right: 1px solid transparent;
}

.live2dMessageBox-content-hidden {
    opacity: 0;
    transform: scaleY(0.2);
    transition: all 0.35s ease-in;
    -moz-transition: all 0.35s ease-in;
    -webkit-transition: all 0.35s ease-in;
}

.live2dMessageBox-content-visible {
    opacity: 1;
    transition: all 0.35s ease-out;
    -moz-transition: all 0.35s ease-out;
    -webkit-transition: all 0.35s ease-out;
}

展示表情

第四代 Live2d 模型开始可以定义表情,表情文件通常以 exp3.json 结尾,且和你的 model3.json 文件同目录。 Live2dRender 在读入你的模型时,也会读入你的表情文件(如果有的话)。表情文件内部如下:

{
	"Type": "Live2D Expression",
	"Parameters": [
		{
			"Id": "Param5",
			"Value": 1,
			"Blend": "Add"
		}
	]
}

只需要控制 Id 为指定参数,就能实现对应表情,因此,你可以自己编写表情文件。

程序中,你可以通过 setExpression 来设置表情,比如你有一个表情文件叫做 M baiyan.exp3.json,你可以如此让你的模型装载这个表情:

live2d.setExpression('M baiyan');

如果你的表情足够多,可以使用 setRandomExpression 来随即设置一个表情:

live2d.setRandomExpression();

事实上,当你点击你的 live2d 模型时,Live2dRender 每次就会调用 setRandomExpression 这个函数。

工具箱

live2d-render@0.0.5 之后,当你在初始化时 live2d 时,可以通过设置 ShowToolBox 为 true 来开启工具箱。

live2d.initializeLive2D({
    // ...
    
    // 展示工具箱(可以控制 live2d 的展出隐藏,使用特定表情)
    ShowToolBox: true,

    // ...
});

此时,当你把光标移动到模型上时,工具箱会透明度渐变动画自动浮现在模型左侧:

最上面的蓝色箭头用于 隐藏/展示 live2d 模型。

下面一堆 E 开头的按钮用于展示表情,比如点击 E2 就是让模型表演预设的 2 号表情。

Last Updated 2024-06-27 07:46:51