Livliv Player

1周前发布 21 00

Livliv Player 是一款专为网页环境设计的超轻量 2.5D 角色播放器。其核心目标是降低虚拟角色在网页、直播画面及各类应用中的接入门槛。该播放器基于 WebGL2 构建,无外部依赖,核心代码经 gzip 压缩后仅约 30 KB。

所在地:
livliv-dev
收录时间:
2026-11-08
其他站点:
Livliv PlayerLivliv Player

Livliv Player 是一款轻量 WebGL2 2.5D 网页虚拟角色播放器,零外部依赖,核心代码gzip压缩后仅约30KB。所有口型同步、摄像头面捕逻辑在浏览器本地完成,一套API同时支持LivLiv自有格式、VRM、PNGTuber三类虚拟形象,适合嵌入网页、OBS直播画面、各类Web应用。内置21款预制角色,开箱即用。

Livliv Player

核心特性

  • 渲染底层 WebGL2,无强制依赖,核心体积极小
  • 本地能力:麦克风/音频/视频驱动口型同步、MediaPipe摄像头面捕,摄像头数据不上传
  • 统一接口:LivLiv自研格式、VRM、PNGTuber三种角色互通调用
  • 预制素材包:仓库自带21个风格角色,附带封面图,可直接加载
  • 支持表情触发、动作指令、直接读写嘴部参数,可自由驱动

快速接入

npm install @livliv-dev/player

基础加载角色、控制表情动作:

import { Player } from '@livliv-dev/player'
const player = new Player(document.querySelector('canvas'))
await player.load('characters/k01/')

player.setExpression('smile')
player.act('nod')
player.params.mouthOpen = 0.6

口型同步、摄像头面捕模块按需引入:

import { createSpeech } from '@livliv-dev/player/voice'
import { startFaceTracking } from '@livliv-dev/player/tracking'
const speech = createSpeech(player)
await startFaceTracking(player)

VRM / PNGTuber 使用配套的 BodyPlayer,同样一套调用范式。

角色格式说明

  1. .livliv / model.json v4:LivLiv自研模型格式,不依赖Live2D Cubism SDK,不读取moc3/cmo3文件,和Live2D无关联;v3旧包也兼容播放
  2. VRM:支持VRM 0.x / 1.0,依赖three.js + @pixiv/three-vrm
  3. PNGTuber:最简只需要张嘴、闭嘴两张图,补充闭眼图效果更好

预制角色许可说明

仓库characters/内21个角色:

  • 大部分LivLiv原创角色:个人非商业免费,需要署名「角色:LivLiv(livliv.ai)」;禁止售卖、商用、用于AI训练,播放器自带LivLiv水印
  • Kujira、Kujira Q、Pen 为衍生作品,许可单独见 CREDITS.md
  • 每个角色附带512×768的cover.webp封面,用作加载占位图

重要提示:在livliv.ai生成角色会使用AI,公开展示时需要注明AI参与制作,不可宣称手绘/人工绑定。播放器本身不含AI推理能力,只做本地渲染。

免代码嵌入(OBS直播友好)

透明背景iframe,直接作为OBS浏览器源:

<iframe src="[https://livliv.ai/live/k01](https://livliv.ai/live/k01)" width="480" height="640" allow="camera; microphone"
  style="border:0;background:transparent"></iframe>

本地调试

npm install && npm run build

静态服务器打开目录,访问示例:

  • /example/demo.html:完整演示(表情、动作、麦克风、面捕)
  • /example/png.html:PNGTuber示例
  • /example/vrm.html:VRM示例

相关导航

Motion Prompt

Motion Prompt

Shohei Ohtaki 开源 Motion Prompt,一套面向 AI 视频、网页动效、UI 设计的标准化动效名称库,本质是一本可交互、可直接喂给 AI 的视觉设计词典,解决创作者想不出动效专业术语、只能用模糊口语描述效果的痛点。整套库一共 8 个分组,合计 192 个效果条目,覆盖动态图形、镜头运镜转场、UI 组件、落地页网页动效、照片光影风格,并且提供英 / 日 / 西 / 简中 / 繁中多语言版本。