===================================== 한국어 ===================================== 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 계정 및 액세스 토큰이 필요합니다. ===================================== English ===================================== Pulsoid Bridge — Warudo Plugin "Real-time heart rate, straight into the node graph." A Warudo plugin that receives real-time heart rate data from Pulsoid via WebSocket and pipes it directly into the Warudo node graph. Drive expressions, effects, and sounds with your live BPM, or trigger actions whenever your heart rate enters a specific zone — build performances that truly react to your vitals. ◆ Key Features ● Real-Time Pulsoid Connection Connects directly to the official Pulsoid Real-time API over WebSocket and streams heart rate data in real time. ● Auto Connect & Auto Reconnect Connects automatically on scene load and retries with exponential backoff whenever the connection drops. ● Stale Timeout Falls back to 0 BPM if no message arrives within a configurable window (1–30 seconds), so unplugged watches and dropped signals are handled safely. ● Connection Notifications See the connection state at a glance through toast notifications and a toolbar status icon. Notifications can be turned off if you prefer a quiet UI. ● Node Graph Integration - "On Heart Rate Received" node: fires a flow every time a new heart rate value arrives. - "Heart Rate Range" node: define any number of BPM zones — the node automatically routes flow to the matching zone, with a separate "No Match" output. ● Multi-Language Available in English, Korean, Japanese, and Simplified Chinese. ◆ Usage Examples Heart Rate (BPM) → Performance ───────────────────────────────────── 60 ~ 90 BPM → Calm expression + relaxed BGM 91 ~ 130 BPM → Default expression 131 ~ 160 BPM → Tense expression + SFX 161 BPM and up → Red overlay + camera shake ◆ Installation 1. Download the .warudo file. 2. Place the file in the `Warudo\Warudo_Data\StreamingAssets\Plugins` folder. 3. Restart Warudo. 4. When the Pulsoid Bridge icon appears in the left toolbar, installation is complete. ◆ Setup 1. Issue an access token at https://pulsoid.net/ui/keys. 2. Paste the token into the Pulsoid Bridge plugin panel inside Warudo. 3. Press "Connect" to start receiving live heart rate data. 4. Optionally enable "Auto Connect" and "Auto Reconnect" so future sessions connect on their own. 5. Add the "On Heart Rate Received" or "Heart Rate Range" node in the node graph and wire it into the performance you want to drive. ◆ License This plugin is licensed per individual user. For commission work, both the creator who sets it up and the streamer who uses it must each purchase their own license. Sharing a single license between multiple people or redistributing it is prohibited. For corporate or business use, please contact us separately. * A separate Pulsoid account and access token are required to use Pulsoid itself. ===================================== 日本語 ===================================== Pulsoid Bridge — Warudo プラグイン 「リアルタイム心拍数を、そのままノードグラフへ。」 Pulsoidのリアルタイム心拍数データをWebSocketで受信し、Warudoのノードグラフから直接利用できるように繋ぐプラグインです。 心拍数に応じて表情・エフェクト・サウンドを切り替えたり、特定のBPM帯に入った瞬間にアクションを発火したり — 自分のバイタルに連動する演出を自然に作り込めます。 ◆ 主な機能 ● Pulsoidリアルタイム接続 公式Pulsoid Real-time APIにWebSocketで直接接続し、心拍数をリアルタイムで受信します。 ● 自動接続 & 自動再接続 シーン読み込み時に自動で接続し、切断された場合は指数バックオフで自動再試行します。 ● Staleタイムアウト 設定した時間（1〜30秒）内にメッセージが届かない場合は自動で0 BPMにフォールバックし、ウォッチの取り外しや信号断を安全に処理します。 ● 接続状態通知 Pulsoid接続／切断時にトースト通知とツールバーアイコンで状態をひと目で確認できます。通知はオフにすることも可能です。 ● ノードグラフ連携 - 「心拍数受信時」ノード: 新しい心拍数を受信するたびにフローを発火します。 - 「心拍数範囲」ノード: BPMの区間を自由に追加でき、入った区間ごとに別々のフローへ自動的に分岐します。範囲外用の「No Match」出力も用意されています。 ● 多言語対応 英語、韓国語、日本語、簡体中国語に対応しています。 ◆ 使用例 心拍数 (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 Bridgeプラグイン画面にトークンを貼り付けます。 3. 「接続」ボタンを押すとリアルタイム心拍数の受信が開始されます。 4. 必要に応じて「自動接続」「自動再接続」をオンにしておくと、次回起動から自動で接続されます。 5. ノードグラフに「心拍数受信時」または「心拍数範囲」ノードを追加し、演出に接続します。 ◆ ライセンスについて 本プラグインは1人1ライセンスです。 コミッション作業の場合、セットアップを行う作家と実際に使用するストリーマーの双方がそれぞれライセンスを購入する必要があります。 1つのライセンスを複数人で共有したり、再配布することは禁止されています。 法人・企業でのご利用については、別途お問い合わせください。 ※ Pulsoid自体の利用には別途Pulsoidアカウントおよびアクセストークンが必要です。