개발자 정보

원격 모델, OBS 주소 옵션과 문제 제보에 필요한 기술 정보를 확인합니다.

이 페이지는 일반적인 방송 준비에는 필요하지 않습니다. Livesona를 다른 서비스와 연결하거나 원격 모델을 직접 제공할 때 참고하세요.

OBS 화면 주소

OBS 브라우저 소스는 다음 경로를 사용합니다.

https://livesona.heonys.dev/overlay.html

지원하는 query 값은 다음과 같습니다.

기존 query 계약은 하위 호환 경로로 유지됩니다. 알 수 없는 값은 안전한 기본값으로 처리됩니다.

src에는 HTTPS로 공개된 model3.json 주소를 넣을 수 있습니다. model3.json이 참조하는 moc3, 텍스처, 물리, 모션 파일도 브라우저에서 접근할 수 있어야 합니다.

각 파일을 제공하는 서버는 Livesona origin의 요청을 허용하는 CORS 헤더를 보내야 합니다. 인증 토큰이나 만료되는 비공개 주소를 query에 넣으면 OBS 설정과 기술 정보에 노출될 수 있으므로 권장하지 않습니다.

OBS의 브라우저 저장 공간은 origin별로 분리됩니다. livesona.heonys.dev, Vercel 미리보기 주소, 예전 배포 주소는 같은 모델 저장소를 공유하지 않습니다. 주소를 바꾼 뒤에는 새 주소에서 모델을 다시 불러와야 합니다.

로컬 모델은 OBS의 브라우저 저장 공간(OPFS)에 저장됩니다. OBS 캐시를 지우면 저장본도 함께 사라질 수 있습니다.

모델 불러오기의 검사 결과 복사에는 model3·moc 버전, 파일 수와 용량 구간, motion·expression·physics·pose 유무, finding code와 브라우저 정보가 들어갑니다.

모델 파일, 모델명, 파일명, 절대 경로와 파일 내용은 포함하지 않습니다. finding code는 문제를 정확히 분류하기 위한 값이며, 일반 사용자는 화면에 표시되는 한국어 안내만 확인해도 됩니다.

Livesona의 Live2D 렌더링과 입력 처리는 live2d-web을 사용합니다. 라이브러리 API와 더 자세한 구현 문서는 live2d-web 개발자 문서에서 확인할 수 있습니다.