Live2D看板娘代码引用

qq_28543535

已于 2022-10-21 11:01:45 修改

阅读量371

点赞数

分类专栏： # canvas 文章标签： javascript

于 2022-06-13 10:34:38 首次发布

本文链接：https://blog.csdn.net/qq_28543535/article/details/125254664

版权

canvas 专栏收录该内容

1 篇文章 0 订阅

订阅专栏

本文介绍了如何使用Live2D看板娘插件的PHP后端API，包括模型、皮肤的切换方式，如单模型单皮肤、多组皮肤递归切换，以及详细的目录结构和接口用法。还涵盖了常见问题及解决方法，如模板地址修改和对话内容调整。

摘要由CSDN通过智能技术生成

下载相关插件

Live2D 看板娘插件 (https://www.fghrsh.net/post/123.html) 上使用的后端 API

特性

- 原生 PHP 开发，无需伪静态，开箱即用
- 支持模型、皮肤的顺序切换和随机切换
- 支持单模型单皮肤切换、多组皮肤递归穷举
- 支持同分组多个模型或多个路径的加载切换

目录结构

│ model_list.json              // 模型列表
│
├─model                         // 模型路径
│ └─GroupName                  // 模组分组
│      └─ModelName              // 模型名称
│
├─add                           // 更新皮肤列表
├─get                           // 获取模型配置
├─rand                          // 随机切换模型
├─rand_textures                 // 随机切换皮肤
├─switch                        // 顺序切换模型
├─switch_textures               // 顺序切换皮肤
└─tools
        modelList.php           // 列出模型列表
        modelTextures.php       // 列出皮肤列表
        name-to-lower.php       // 文件名格式化

添加模型

单模型单皮肤切换
    - 单次加载只输出一个皮肤
    - 皮肤放在 `textures` 文件夹，自动识别

shell

│ index.json
│ model.moc
│ textures.cache       // 皮肤列表缓存，自动生成
│
├─motions
│      idle_01.mtn
│      idle_02.mtn
│      idle_03.mtn
│
└─textures
        default-costume.png
        school-costume.png
        winter-costume.png

单模型多组皮肤递归穷举
    - 多组皮肤组合模型、穷举组合
    - 皮肤文件夹按 `texture_XX` 命名
    - 添加 `textures_order.json` 列出组合

shell
│ index.json
│ model.moc
│ textures.cache
│ textures_order.json
│
├─motions
│      idle_01.mtn
│      idle_02.mtn
│      idle_03.mtn
│
├─texture_00
│      00.png
│
├─texture_01
│      00.png
│      01.png
│      02.png
│
├─texture_02
│      00.png
│      01.png
│      02.png
│
└─texture_03
       00.png
       01.png

textures_order.json
[
    ["texture_00"],
    ["texture_01","texture_02"],
    ["texture_03"]
]

textures.cache
[
    ["texture_00/00.png","texture_01/00.png","texture_02/00.png","texture_03/00.png"],
    ["texture_00/00.png","texture_01/00.png","texture_02/00.png","texture_03/01.png"],
    ["texture_00/00.png","texture_01/01.png","texture_02/01.png","texture_03/00.png"],
    ["texture_00/00.png","texture_01/01.png","texture_02/01.png","texture_03/01.png"],
    ["texture_00/00.png","texture_01/02.png","texture_02/02.png","texture_03/00.png"],
    ["texture_00/00.png","texture_01/02.png","texture_02/02.png","texture_03/01.png"]
]

同分组多个模型或多个路径切换
    - 修改 `model_list.json` 添加多个模型

shell
│
├─model
│ ├─Group1
│ │ ├─Model1
│ │ │      index.json
│ │ │
│ │ └─Model2
│ │          index.json
│ │
│ ├─Group2
│ │ └─Model1
│ │          index.json
│ │
│ └─GroupName
│     └─ModelName
│          │ index.json
│          │ model.moc
│          │
│          ├─motions
│          └─textures
│

model_list.json
{
    "models": [
        "GroupName/ModelName",
        [
            "Group1/Model1",
            "Group1/Model2",
            "Group2/Model1"
        ]
    ],
    "messages": [
        "Example 1",
        "Example 2"
    ]
}

接口用法

- `/add/` - 检测新增皮肤并更新缓存列表
- `/get/?id=1-23` 获取分组 1 的第 23 号皮肤
- `/rand/?id=1` 根据上一分组随机切换
- `/switch/?id=1` 根据上一分组顺序切换
- `/rand_textures/?id=1-23` 根据上一皮肤随机切换同分组其他皮肤
- `/switch_textures/?id=1-23` 根据上一皮肤顺序切换同分组其他皮肤