react-live2d/README.md

96 lines
2.9 KiB
Markdown
Raw Normal View History

2020-08-23 20:54:31 +08:00
<h1 align="center">react-live2d</h1>
![npm](https://img.shields.io/npm/dt/react-live2d)
![NPM](https://img.shields.io/npm/l/react-live2d)
![npm](https://img.shields.io/npm/v/react-live2d)
2020-08-24 20:12:59 +08:00
[示例地址](http://test2.supmiao.com)
2020-08-23 20:54:31 +08:00
服务器配置较差,网站首次打开,看板娘需要加载大量模型和动作,请耐心等候
## 目录说明
2020-08-24 20:12:59 +08:00
```
·
├─ Core # Cubism Core 核心库
2020-08-23 20:54:31 +08:00
2020-08-24 20:12:59 +08:00
└─ Samples             
2020-08-23 20:54:31 +08:00
   └─ TypeScript
2020-08-24 20:12:59 +08:00
└─ Demo # 项目目录
2020-08-23 20:54:31 +08:00
2020-08-24 20:12:59 +08:00
    └─ Resources # live2D的模型及动作导出的文件
2020-08-23 20:54:31 +08:00
2020-08-24 20:12:59 +08:00
    └─ Framework # 包含渲染和动画功能等的源代码
2020-08-23 20:54:31 +08:00
         └─ src          # 核心代码
2020-08-24 20:12:59 +08:00
```
## 🖥 Environment Support
| | Windows | macOS | Linux | Android | iOS |
| ----- | :-----: | :-----: | :-----: | :-----: | :-----: |
| Google Chrome | ✔ | ✔ | ✔ | ✔ | ✔ |
| Firefox | ✔ | ✔ | ✔ | ✔ | ✔ |
| Safari | - | ✔ | - | - | ✔ |
| Microsoft Edge | ✔ | ✔ | - | ✔ | ✔ |
| Internet Explorer 11 | ✔ | - | - | - | - |
2020-08-23 20:54:31 +08:00
## 📦 Install
2020-08-24 20:12:59 +08:00
为了不增加npm包的负担基础包还是直接使用script引入在你个人的react项目的->public->index.html先插入Core里可获得该min.js
```
2020-08-23 20:54:31 +08:00
<script src = "http://publicjs.supmiao.com/live2dcubismcore.min.js"></script>
2020-08-24 20:12:59 +08:00
```
2020-08-23 20:54:31 +08:00
```bash
npm install react-live2d
```
## 🔨 Usage
```jsx
import ReactLive2d from 'react-live2d';
const App = () => (
<>
<ReactLive2d
width={300}
height={500}
/>
</>
);
```
比如你想要给页面加入模型Hiyori那就在你的react项目中的public目录下将Hiyori放入Resources资源文件夹,如
2020-08-24 20:12:59 +08:00
```
·
└─ public
2020-08-23 20:54:31 +08:00
   └─ Resources
└─ Hiyori
2020-08-24 20:12:59 +08:00
```
更多模型请动手在github搜索'live2d 模型'即可,模型大多有版权,请慎勿用于商业~
2020-08-23 20:54:31 +08:00
api 文档 (待完善,如有需要功能欢迎提[issue](https://github.com/chendishen/Live2DBase/issues)
| 成员 | 说明 | 类型 | 默认值 |
2020-08-24 20:12:59 +08:00
| :-----: | ----- | ----- | ----- |
2020-08-23 20:54:31 +08:00
| width | 盒子宽度 | Number | 300 |
| height | 盒子高度 | Number | 400 |
| top | positionrelative的top值 | String | '' |
| right | positionrelative的right值 | String | '0' |
| bottom | positionrelative的bottom值 | String | '0' |
| left | positionrelative的left值 | String | '' |
| ModelList | 模型列表,暂时只展示数组的第一个模型 | Array<String> | ['Hiyori'] |
2020-08-24 20:12:59 +08:00
| TouchBody | 点击身体时聊天框随机出现数组的值 | Array<String> | ['啊呀,你的手在摸哪里嘛~','哼,坏人'] |
2020-08-24 20:25:41 +08:00
| TouchHead | 点击头部时聊天框随机出现数组的值,该值模型未存在头部事件时无效 | Array<String> | ['讨厌~不要掐人家的脸嘛~','希望明天也能感受到你的触摸呢'] |
2020-08-24 20:12:59 +08:00
| color | 聊天框背景颜色 | String | '#C8E6FE' |
2020-08-23 20:54:31 +08:00