【Warudo Plugin】Pulsoid Bridge - リアルタイム心拍数連携
Pulsoid Bridge — Warudo 플러그인
「실시간 심박수, 그대로 노드 그래프에.」
Pulsoid의 실시간 심박수 데이터를 WebSocket으로 수신하여, Warudo의 노드 그래프에서 바로 활용할 수 있도록 연결해 주는 플러그인입니다.
심박수에 따라 캐릭터의 표정·이펙트·사운드를 바꾸거나, 특정 BPM 구간에 도달했을 때 액션을 실행하는 등 — 실시간 바이탈에 반응하는 연출을 그대로 만들 수 있습니다.
◆ 주요 기능
● Pulsoid 실시간 연결
공식 Pulsoid Real-time API에 WebSocket으로 직접 연결해 심박수를 실시간으로 수신합니다.
● 자동 연결 & 자동 재연결
씬 로드 시 자동으로 연결하고, 연결이 끊겨도 지수 백오프로 자동 재시도합니다.
● Stale 타임아웃
설정한 시간(1~30초) 동안 메시지가 도착하지 않으면 자동으로 0 BPM으로 폴백하여, 워치 분리·신호 두절 상황을 안전하게 처리합니다.
● 연결 상태 알림
Pulsoid 연결·해제 시 토스트 알림과 툴바 아이콘으로 상태를 즉시 확인할 수 있으며, 알림은 끌 수도 있습니다.
● 노드 그래프 통합
- 「심박수 수신 시」 노드: 새로운 심박수가 수신될 때마다 플로우를 트리거합니다.
- 「심박수 범위 비교」 노드: BPM 구간을 자유롭게 추가하여, 진입한 구간에 따라 서로 다른 플로우를 자동으로 분기합니다.
● 다국어 지원
영어, 한국어, 일본어, 중국어 간체에 대응합니다.
◆ 사용 예시
심박수 (BPM) → 연출
─────────────────────────────────────
60 ~ 90 BPM → 평온 표정 + 차분한 BGM
91 ~ 130 BPM → 일반 표정
131 ~ 160 BPM → 긴장 표정 + 효과음
161 BPM 이상 → 빨간 오버레이 + 흔들림 연출
◆ 설치 방법
1. .warudo 파일을 다운로드합니다.
2. `Warudo\Warudo_Data\StreamingAssets\Plugins` 폴더에 파일을 넣습니다.
3. Warudo를 재시작합니다.
4. 좌측 툴바에 Pulsoid Bridge 아이콘이 나타나면 설치 완료입니다.
◆ 설정 방법
1. Pulsoid 공식 사이트(https://pulsoid.net/ui/keys)에서 액세스 토큰을 발급받습니다.
2. Warudo의 Pulsoid 브릿지 플러그인 화면에 토큰을 붙여 넣습니다.
3. 「연결하기」 버튼을 누르면 실시간 심박수 수신이 시작됩니다.
4. 필요하면 「자동 연결」, 「자동 재연결」을 켜 두면 다음 실행부터 자동으로 연결됩니다.
5. 노드 그래프에서 「심박수 수신 시」 또는 「심박수 범위 비교」 노드를 추가하여 원하는 연출에 연결합니다.
◆ 라이선스 안내
본 플러그인은 1인 1라이선스입니다.
커미션 작업 시, 세팅하는 작가와 실제 사용하는 스트리머 양쪽 모두 각각 라이선스를 구매해야 합니다.
하나의 라이선스를 여러 명이 공유하거나 재배포하는 것은 금지됩니다.
기업 사용은 별도 문의 부탁드립니다.
※ Pulsoid 자체 사용에는 별도의 Pulsoid 계정 및 액세스 토큰이 필요합니다.
※ 본 제품은 “Animal Ear Headband_heartbeat” 프롭을 기반으로 제작되었습니다.