react 项目下的安装

安装

npm install live2d-render
yarn add live2d-render

了解和准备 live2d 文件

先准备一个 live2d 模型,一个 live2d 模型通常是一个包含了如下几类文件的文件夹:

  • xxx.moc3
  • xxx.model3.json (配置文件,live2d 最先读取的就是这个文件,可以认为它是 live2d 模型的入口文件,里面列举了所有模型需要使用的静态资源的相对路径)
  • 其他

比如我的模型为一个小猫娘,文件夹为 cat,这个文件夹下包含了如下的文件:

/cat
    -| sdwhite cat b.model3.json
    -| SDwhite cat B.moc3
    -| xxx.exp3.json
    -| ...
    -| ...

模型版权申明:Lenore莱诺尔(B站:一个ayabe)

我把 cat 文件夹放在了 ./public 文件夹下。那么我的模型的基本路径为:./cat/sdwhite cat b.model3.json,记住这个路径。

使用 live2d-render 展示 live2d

react 项目中,通过如下代码初始化 live2d

import logo from './logo.svg';
import './App.css';

import { useEffect } from 'react';
import * as live2d from 'live2d-render';


function App() {
    useEffect(() => {
        live2d.initializeLive2D({
            // live2d 所在区域的背景颜色
            BackgroundRGBA: [0.0, 0.0, 0.0, 0.0],
    
            // live2d 的 model3.json 文件的相对 根目录 的路径
            ResourcesPath: './cat/sdwhite cat b.model3.json',
    
            // live2d 的大小
            CanvasSize: {
                height: 500,
                width: 400
            },
            
            // 展示工具箱(可以控制 live2d 的展出隐藏,使用特定表情)
            ShowToolBox: true,
    
            // 是否使用 indexDB 进行缓存优化,这样下一次载入就不会再发起网络请求了
            LoadFromCache: true
        });
    }, []);

    return (
        <div className="App">
            <header className="App-header">
                <img src={logo} className="App-logo" alt="logo" />
                <p>
                    Edit <code>src/App.js</code> and save to reload.
                </p>
                <a
                    className="App-link"
                    href="https://reactjs.org"
                    target="_blank"
                    rel="noopener noreferrer"
                >
                    Learn React
                </a>
            </header>
        </div>
    );
}

export default App;

效果如下

Last Updated 2024-09-19 04:43:18