livliv-dev/player
웹에서 2.5D 캐릭터를 움직이는 경량 플레이어 공개
원제 livliv-dev/player
스타 1,277TypeScript
Key Point
웹 스트림 오버레이나 앱에 AI 아바타를 임베드하려는 크리에이터와 개발자에게 무거운 라이브러리 없이 빠르게 2.5D 캐릭터를 구현할 수 있는 도구가 생겼다.
핵심 요약
- LivLiv Player는 웹용 2.5D 캐릭터 플레이어로, 입술 싱크와 웹캠 얼굴 추적을 지원한다.
- WebGL2 기반이며 의존성 없이 압축 시 약 30KB 크기로, LivLiv·VRM·PNGTuber 캐릭터를 동일한 API로 재생한다.
- 입술 싱크(마이크·오디오·비디오)와 얼굴 추적(MediaPipe)은 모두 브라우저에서 동작하며, 필요할 때만 로드된다.
- 즉시 사용 가능한 21개 캐릭터가 포함되어 있으며, 온라인 데모는 livliv-dev.github.io/player에서 확인할 수 있다.
- npm으로 설치하거나 리포지토리를 클론해 로컬 서버로 실행 가능하며, /example/demo.html에서 표정·동작·마이크·카메라 기능을 테스트할 수 있다.
- PNGTuber와 VRM 캐릭터용 별도 예제(/example/png.html, /example/vrm.html)도 제공된다.
- VRM은 VRoid Studio나 VRM 0.x·1.0을 지원하는 도구에서 가져올 수 있으며, LivLiv 모델은 livliv.ai에서 생성 후 .livliv 파일로 다운로드할 수 있다.
- LivLiv 모델 생성에는 AI가 사용되지만, 플레이어 자체는 로컬에서만 실행되어 AI 서비스를 호출하지 않는다.
- 브라우저 지원 범위는 WebGL2 및 ES2023 기준으로 Chrome/Edge 97+, Firefox 104+, Safari 15.4+이다.
- 코드는 Apache License 2.0이고, 포함된 21개 캐릭터는 별도 라이선스를 가지며, 일부는 다른 창작자의 작품을 개조한 것이다.
- 공개 장소에서 LivLiv로 만든 캐릭터를 사용할 때는 AI 생성임을 명시해야 한다.
저장소 보기 ↗github.com