A lightweight 2.5D character player for the web, with lip sync and webcam face tracking.
Changelog
Next
The featured characters are not in the npm package, so nothing here needs a new version.
- 17 of the 21 featured characters rebuilt, as livliv.ai now shows them, and their covers redrawn.
0.3.0
The first version on npm, with the interface settled first: these change what a page written for 0.2 does.
What to change
| 0.2 | 0.3 |
|---|---|
import ... from '@livliv/player' and its subpaths |
'@livliv-dev/player', the package's name on npm. |
player.act('away') |
player.setAway(true) and setAway(false). act('away') now throws: it was a switch among one-off moves. |
player.puppet |
No longer in the types. player.poke() and player.canvasToModel() are what pages used it for. The field still exists and can change in any version. |
player.load(a); player.load(b) played a, then b |
The new load replaces the one running, which rejects with an AbortError. If you catch errors, let this one through: if (e.name === 'AbortError') return. |
dispose() on a load running rejected with an Error |
It rejects with an AbortError, as load() on a disposed player does. |
| Errors told apart by their message | e.code, on a LivLivError. The messages can change. |
New
load(source, { signal, onProgress, poster }): call a load off, follow how far it has come, show a picture until the first frame.LivLivError, with acodefor each reason, from@livliv-dev/playerand@livliv-dev/player/body.player.contextLostandplayer.onContextLost: the page hears when the WebGL context is gone. See API.md.dispose({ release: true }): gives the WebGL context up, for a canvas leaving the page.player.setAway(),player.poke(),player.canvasToModel().example/react.html.
Changed
- A model that breaks while it is built leaves the character before as it was, to the pixel. It used to leave an empty canvas.
- The pose stays in the ranges of
PARAM_RANGESonPlayertoo, as it did onBodyPlayer. A value that is not a number counts as the default. maxPixelRatiocan be read and changed on aPlayer.snapshot()on aPlayerdraws first, so it is the pose as it is now, on a paused player too.- A
BodyPlayer'sFrame.timecounts the frames before this one, as aPlayer's does. Its idle motion runs one frame later. - The two classes now share their code. Nothing a
Playerdraws changed: frame by frame, with the same random numbers, 1300 frames each of 4 characters came out identical.
See the commits for what came before 0.3.