Warudo / RhyLive / Troubleshooting

실행할 때 꺼지는 RhyLive를 다시 깨운다

Warudo를 처음 실행하면 RhyLive가 비활성 상태로 시작하지만, 무선·유선을 전환하면 얼굴 추적이 살아나는 문제를 위한 비공식 복구 방법이다. Warudo 0.15.0에서 유선 연결로 확인했다.

한눈에 보기

무엇을 바꾸는가

증상

시작할 때만 RhyLive가 X

iPhone과 드라이버는 정상인데 Warudo 시작 직후에는 얼굴 추적이 연결되지 않는다.

원인 방향

초기화 타이밍 충돌

시작 과정의 수신기 초기화가 겹치면서 늦게 끝난 작업이 새 수신기를 실패 상태로 바꿀 수 있다.

복구

3초 후 한 번 재시작

현재 유선·무선 설정을 바꾸지 않고 RhyLive 수신기의 기존 재시작 동작을 한 번 호출한다.

Download

공유용 파일

한 번에 받기

사용자 정의 노드, 블루프린트 JSON, 설치 안내가 포함된 ZIP 파일이다.

ZIP 다운로드

사용자 정의 노드

Warudo Playground에 넣어 RhyLive 수신기의 재시작 동작을 호출한다.

CS 받기

복구 블루프린트

그래프가 활성화되면 3초를 기다린 뒤 사용자 정의 노드를 실행한다.

JSON 받기

비공식 임시 해결책이다. Warudo 또는 RhyLive 업데이트 후 내부 API가 바뀌면 작동하지 않을 수 있다.

Install

설치 순서

가장 중요한 경로

Warudo 위쪽 Menu → Open Data Folder → 열린 폴더의 Playground

01 ZIP 압축 풀기
Warudo-RhyLive-Startup-Recovery.zip을 원하는 폴더에 압축 해제한다.
02 Playground 열기
Warudo 위쪽 Menu에서 Open Data Folder를 누른다. 열린 폴더의 Playground 안에 RhyLiveRestartReceiverNode.cs를 넣고 잠시 기다린다.
03 JSON 불러오기
Warudo Editor 왼쪽의 Σ 아이콘을 누른다. 블루프린트 목록 아래의 ⋯ 메뉴에서 파일 가져오기를 선택한 뒤, 압축을 푼 RhyLive 시작 복구 - 공유용.json을 연다.
04 수신기 선택
가져온 RhyLive 시작 복구 - 공유용 그래프를 연다. RhyLive 수신기 다시 시작 노드를 누르고, Receiver에서 현재 장면의 RhyLive 수신기를 선택한다.
05 활성화 후 재실행
복구 그래프 옆의 눈 아이콘을 켠 다음 Warudo를 완전히 종료하고 다시 실행한다. 장면이 열린 뒤 3~5초 기다린다.

Warudo Menu에서 Open Data Folder를 선택하는 공식 문서 화면 — **① 데이터 폴더 열기** Warudo 공식 문서의 `Menu → Open Data Folder` 화면.

Warudo Blueprints 탭에서 Import Blueprint From File 버튼을 누르는 공식 문서 화면 — **② JSON 가져오기** Warudo 공식 문서에서 표시한 `Import Blueprint From File` 버튼.

기본 Steam 절대 경로: C:\Program Files (x86)\Steam\steamapps\common\Warudo\Warudo_Data\StreamingAssets\Playground\ 다른 드라이브에 설치했어도 Open Data Folder를 쓰면 경로를 찾을 필요가 없다.

Connection

유선과 무선

유선 모드

현재 수신기가 유선으로 설정되어 있으면 유선 수신기를 다시 시작한다.

무선 모드

현재 수신기가 무선으로 설정되어 있으면 무선 수신기를 다시 시작한다. 연결 방식을 강제로 바꾸지 않는다.

Verify

정상 작동 확인

01완전 종료
Warudo를 완전히 종료한 뒤 다시 실행한다.
023~5초 대기
무선·유선 버튼을 수동으로 전환하지 않고 기다린다.
03페이셜 확인
모델의 얼굴 추적이 자동으로 시작되는지 확인한다.

Player.log

성공 로그 예시

[RhyLiveStartRecovery] Invoking ResetReceiver.
[RhyLive SDK] iOS Device Connected: ...
[RhyLive SDK] Successfully connected to iOS device

로그는 Windows의 AppData\LocalLow\HakuyaLabs\Warudo\Player.log에서 확인할 수 있다. 공개 게시물이나 문의 글에는 장치 이름과 장치 ID를 가린다.

Notes

알아둘 점

RhyLive 또는 Warudo 본체 DLL을 교체하지 않는다.
공유용 JSON은 특정 사용자의 장면 ID를 포함하지 않으므로 Receiver를 직접 선택해야 한다.
무선 연결에 문제가 없다면 이 복구 그래프를 굳이 사용할 필요는 없다.
업데이트 후 실패하면 Player.log에서 Playground 컴파일 오류와 ResetReceiver 관련 메시지를 확인한다.