livliv-dev/player

选用指南

AI 根据 README 整理 · 2026/11/6 08:36:29

使用方式

可通过 npm 安装并导入 Player 类在网页中使用，也提供 iframe 嵌入方式。

查看 README 依据

- **Online**: the examples run on [livliv-dev.github.io/player](https://livliv-dev.github.io/player/). - **Here**: `npm install && npm run build`, serve this folder with any static server and open `/example/demo.html` (expressions, actions, microphone, camera; `?model=../characters/<id>/` picks another character). `/example/png.html` and `/example/vrm.html` show a PNGTuber and a VRM. - **On livliv.ai**: each character's page there plays it with the same renderer. Start at [livliv.ai/discover](https://livliv.ai/discover). ## Use it in your page ```js

import { Player } from '@livliv/player' const player = new Player(document.querySelector('canvas')) await player.load('characters/k01/') // a folder with model.json and textures/, or a .livliv file player.setExpression('smile') // ids are in player.expressions player.act('nod') player.params.mouthOpen = 0.6 // 0..1 ``` Lip sync and face tracking: ```js import { createSpeech } from '@livliv/player/voice' import { startFaceTracking } from '@livliv/player/tracking' // needs @mediapipe/tasks-vision const speech = createSpeech(player)

部署要求

需要支持 WebGL2 和 ES2023 的浏览器，如 Chrome/Edge 97+、Firefox 104+、Safari 15.4+。

查看 README 依据

[CONTRIBUTING.md](CONTRIBUTING.md). Security reports: [SECURITY.md](SECURITY.md). ## Browser support WebGL2 and ES2023: Chrome / Edge 97+, Firefox 104+, Safari 15.4+. Tested on current desktop browsers, not yet on phones. ## License The code is under the [Apache License 2.0](LICENSE) (see also [NOTICE](NOTICE)). The featured characters have their own licence, [characters/LICENSE.md](characters/LICENSE.md). Neither licence covers the LivLiv name and logos. ## Thanks

已知限制

尚未在手机上测试，且核心包未发布到 npm，需从仓库构建。

查看 README 依据

The whole API is in [API.md](API.md): options, params, expressions and actions, drivers, VRM and PNGTuber characters, the limits on untrusted files, the model package and the format version. The LivLiv package format (`.livliv`, `model.json` v4) is in [FORMAT.md](FORMAT.md), with a JSON Schema in [`schema/`](schema/); packages exported before v4 are described in [FORMAT-v3.md](FORMAT-v3.md) and still play. > Not on npm yet: build it from this repository and import `dist/index.js`. ## Featured characters

[CONTRIBUTING.md](CONTRIBUTING.md). Security reports: [SECURITY.md](SECURITY.md). ## Browser support WebGL2 and ES2023: Chrome / Edge 97+, Firefox 104+, Safari 15.4+. Tested on current desktop browsers, not yet on phones. ## License The code is under the [Apache License 2.0](LICENSE) (see also [NOTICE](NOTICE)). The featured characters have their own licence, [characters/LICENSE.md](characters/LICENSE.md). Neither licence covers the LivLiv name and logos. ## Thanks