English ver is here.
コナステ版SOUND VOLTEX用の配信補助ツールです。
OBSでの配信を想定しています。
主な機能は以下。
- プレー中の曲情報を分かりやすく表示
- その日のプレーログを画像出力
- リザルト画像の自動保存(曲名やスコア等を含んだファイル名)
- のVOLFORCE対象楽曲一覧の表示
- 自己ベストや全プレーログをCSV出力
- OBS制御機能(シーン、ソースの自動切り替え)
- Discordへのリザルト自動投稿
- ブラスターゲージ最大時に音声で通知
譜面付近のみを切り取ったレイアウトでも、曲情報を見やすく表示することができます。
また、リザルト画像の自動保存や、保存したリザルト画像からプレーログ画像の作成も行うことができます。
プレーログ画像はリザルト画像撮影のたびに自動更新されます。
F6キーを押すことでキャプチャの手動保存もできます。
コナステ版のVOLFORCE対象楽曲一覧を表示したりもできます。
さらに、ゲーム内の各シーン(選曲画面、プレー画面、リザルト画面)でOBS上のソースに対して表示・非表示を切り替えたり、
別のシーンに移行したりできます。
(例: プレー画面だけ手元カメラを表示、リザルト画面だけVTuberのアバターを消す、等)
また、Googleドライブに自動保存されるcsvファイルをもとに、以下のようなライバル欄を表示する機能もあります。
念のために書いておきますが、本アプリの処理内容はリバースエンジニアリングの類ではありません。
ゲーム画面を定期的にキャプチャし、画像処理によってどの画面かを判定しています。
OBSwebsocket経由でキャプチャを取得することで、PCへの負荷を抑えています。
以下の環境で検証しています。
OS: Windows10 64bit(22H2)
CPU: Intel系(i7-12700F)
GPU: NVIDIA系(RTX3050)
ウイルス対策ソフト: Windows Defender
OBS: 29.1.2
最新のWebSocket APIを使う都合上、OBSは28以降が必須となります。
CPUはAMD系でも問題ないはずです。(websocket経由だと安定する模様)
OBSとの通信(tcp4444)を行うため、ウイルス対策ソフトによってはブロックされる可能性があります。
| ファイル名 | 説明 |
|---|---|
| sdvx_helper.exe | sdvx_helper本体のバイナリ |
| update.exe | 自動アップデート用のバイナリ |
| version.txt | バージョン情報 |
| README.txt | 説明書 |
| out/ | 曲名情報やプレーログなどの出力先フォルダ |
| out/nowplaying.html | 曲情報表示用HTML。OBSにドラッグ&ドロップする。 |
| out/summary_full.png | プレーログ画像 |
| out/summary_small.png | プレーログ画像(簡易版) |
| resources/ | 画像認識などに必要なファイル一式 |
Releaseページの一番上にあるsdvx_helper.zipをダウンロードし、好きなフォルダ(デスクトップ以外)に解凍してください。
sdvx_helper.exeをクリックすると実行できます。
自動アップデート機能を搭載しており、更新データがある際は起動時にアップデートが走るようになっています。
OBSwebsocketについては、インストールされていない場合はここから最新のalphaってついてないバージョンの(～Windows-Installer.exe)をDLしてインストールしてください。
OBSのメニューバー内ツール→WebSocketサーバ設定で以下のように設定してあればOK。
OBSに接続できませんの表示が出る場合はこの辺を疑いましょう。
SDVX側の設定と本ツールの設定は以下のように対応しています。
この設定をやらないとゲーム画面を取得できないので注意。
ちなみに、OBS制御設定画面では各シーン(選曲、プレー中、リザルト)でソースの表示・非表示制御ができます。
- プレー中のみ手元カメラを表示
- リザルト・選曲画面で別のシーンに移行
みたいなことが簡単にできます。
nowplaying.htmlはソースをダブルクリックして幅820,高さ900に設定すると余白がいい感じになります。
また、OBS制御設定からプレー中のみ表示、みたいなこともできます。
ソース名がnowplaying.htmlまたはnowplayingでないと自動リロードされないので注意。
outフォルダ内の画像を直接OBS上に配置する場合は自動でリロードされるようです。
必須ではないですが、その他の便利機能の設定方法について記しておきます。
興味のある方はどうぞ。
OBSにout/vf_onselect.htmlをドラッグ&ドロップすると、以下のようなビューを表示できます。
(推奨サイズ: 幅2400，高さ700)
選曲画面でカーソルを合わせた曲がプレー済みであれば表示されます。
※曲名認識できる曲のみとなります。現在1000/1500曲程度
OBSにout/sdvx_stats_v2.htmlをドラッグ&ドロップすると、以下のようなビューを表示できます。
(推奨サイズ: 幅3500，高さ2700)
リザルト画面で更新されます。
プレイヤー名の部分は設定画面で入力した文字が使われます。日本語も使えます。
ちなみに、保存したリザルト画像をプレーログに反映ボタンを押すと、過去のリザルト画像をプレーログに反映できます。曲名認識DBは日々更新されていますが、認識できなかった曲を後から反映する場合もこちらのボタンを使ってください。
また、楽曲のジャケットはリザルト画面で保存するようにしています。
保存したリザルト画像からVFビュー用ジャケット画像を一括生成ボタンを押す
ことでも保存できます。ジャケット画像はsdvx_helperフォルダ内のjackets以下に格納されます。
全曲分生成すると200MB程度になる見込みですが、ディスク容量を気にされる方は
リザルト画面でジャケット画像を自動保存のチェックを外し、- out/sdvx_stats.html(v2ではない方, 幅3000, 高さ2300)を設定する
とよいです。
※曲名認識できる曲のみとなります。現在1200/1500曲程度。
認識できない曲 or レベルが登録されていない曲は計算対象外となるため、実際のVFよりも低く出る場合があります。
こちらは今後のアップデートで改善する予定です。
ソース名がsdvx_stats_v2.htmlである場合のみ、
アプリ終了時にこのビューをキャプチャした画像が保存されます。
OBSにout\summary_small.pngをドラッグ&ドロップすることで表示できます。
30曲分の履歴を表示するように作っていますが、曲数を減らしたい場合はAlt+マウスドラッグでトリミングしてください。
out\summary_full.pngがもう少し大きい版となります。こちらはスコアレートも含みます。
本機能を使うためには以下2点に注意する必要があります。
- 設定画面でリザルトの保存先フォルダを設定しておく
- 起動してからリザルトが保存されている
2．について、全てのリザルトを自動保存する機能があるので、そちらを有効にすることを推奨します。
サマリ画像生成時にはランクDのリザルトのみ弾く機能もあります。(今後もう少し拡張するかも)
主な仕様
- 設定画面で指定したリザルト置き場にあるリザルト画像をもとに生成
- リザルト保存時にsummary_*.pngの更新が走る
- アプリ起動の2時間前以降のリザルトを集計する
- 起動時にも一度更新処理が走る(2時間以内にリザルトが生成されていれば
仕様上、うまく動かない場合は一度アプリを再起動するとよいかもしれません。
取得対象に2時間の猶予を入れているので、再起動しても同じ画像が出てくるはずです。
また、リザルト取得に失敗して変な画像(ダブった、色が薄いなど)が入ってしまった場合は、
該当するリザルト画像のファイルを削除すれば次の生成で直ります。
設定画面のBLASTER GAUGE最大時に音声でリマインドするをチェックすることで、
選曲画面でゲージが最大だった場合にアラート音声(resources\blastermax.wav)が再生されます。
また、OBS上でsdvx_helper_blastermaxという名前のテキストソースを作っておくと、ゲージ最大時のみ**BLASTER GAUGEが最大です！**という文字列を入れるようにしています。
(フィルタのスクロール設定時に使いやすいように、後ろに数十文字分の全角スペースを入れています)
ゲージが足りていない場合は何も表示されません。
OBS制御設定から、sdvx_helper_blastermaxは選曲画面でのみ表示するのが良いかもしれません。
OBS上でsdvx_helper_playcountという名前のテキストを作るとplays: 13のように本アプリ起動後にプレーした曲数を表示することができます。
ヘッダには数字の前に入れる文字列(本日のプレー曲数:など)を、
フッタには数字の後ろに入れる文字列(曲目など)をそれぞれ指定してください。
手順
- ソース一覧で右クリック→追加→テキスト(GDI+)をクリック。
- 色やフォントなどを好みに合わせて設定する。(適当な文字を入力しておくとどこに置いたのかわかりやすいです。)
- 作成したソースを右クリック→名前を変更→
sdvx_helper_playcountにする。
以下の画像ファイルをOBSにドラッグ&ドロップすることで、VF等の情報を表示できます。
- vf_cur.png: 最新のVF
- vf_pre.png: アプリ起動時のVF
- class_cur.png: 最新の段位
- class_pre.png: アプリ起動時の段位
v.1.0.8からリザルトをDiscordに自動投稿できるようになりました。
自分のDiscordサーバに以下のようなプレーログを自動投稿することができます。
メニューバーのカスタムWebhook設定から設定できます。
こんな使い方を想定しています。
- 全プレーのログを自分のdiscordに残しておく
- PUCのログのみを自分のdiscordに残しておく
- 知り合いと共通のサーバを利用してライバル機能の代替として使う
設定名、DiscordのwebhookのURLを入力した上で追加ボタンを押すと登録できます。
送信対象とするLv(1～20)及びクリアランプも指定可能です。
画像送信の有無も指定できます。
ちなみに、WebhookはDiscord上でテキストチャンネルを編集->連携サービス->ウェブフックから作成できます。
ウェブフックURLをコピーしてsdvx_helperに入力してください。
本機能についての主な仕様は以下の通り。
- 通知時の名前は設定画面のプレーヤー名が使われる
- 通知時のアイコンはWebhookで指定したものが使われる
- 複数人で共有するサーバを登録する場合でも、別々のwebhookを登録しておけばアイコンで区別可能
- Webhook設定は複数登録することが可能
こちらを参照してください。
相手にもGoogleドライブ上に置いたcsvファイルのURLを教えてもらう必要があります。
うまく設定できると、選曲画面やリザルト画面で以下のようなビュー(out\rival.html)が表示できます。
インペリアルRTAなどに使えるように、VF:0からスタートして目標VFを達成するまでの時間を測定できるようになりました。
- 設定画面から目標VFを設定する。(デフォルト:20.000)
- メニューバー内RTA->RTA開始をクリック(または、F3キーを押下)してRTAモードを開始する
- 目標VFに到達するとタイマーが止まる
- sdvx_helper終了時に、rta_sdvx_stats_v2.htmlという名前のソースがあれば画像フォルダにRTA結果ビューが自動保存される。
RTA用の情報に関しては以下のお好きな方法で表示できます。
- RTA用統計情報ビュー(layout\rta_sdvx_stats_v2.html)をOBSにD&D(幅4000，高さ3000ぐらいを推奨)
- 指定された名前のテキスト(GDI+)のソースを用意する
- VF表示: sdvx_helper_rta_vf
- タイマー表示: sdvx_helper_rta_timer
RTA用統計情報ビューに表示されるタイマーについては、達成時以外は空白になります。
また、指定した名前のテキストソースに書き込まれる方のタイマーについては、曲決定画面で止まってしまう問題があります。
将来的には別スレッドに移動して止まらないようにしますが、そこまで大きな影響はないと思うので一旦このまま出しています。
インペRTAチャレンジなどにご活用ください。
上記設定ができていれば、OBS配信や録画を行う際に起動しておくだけでOKです。
F6キーを押すと指定したフォルダにキャプチャ画像を正しい向きで保存することができます。
ライセンスはApache2.0に準拠するものとします。
クレジット表記などは特に必要ありませんが、概要欄などに書いてくれると喜びます。
曲名認識用DB登録へのご協力のお願い
開発用Discordでは曲名認識(OCR)機能の開発状況を確認することができます。
このページにトラブルシューティング情報をまとめていく予定です。
バグ報告や要望は本レポジトリのIssueまたはTwitter(@cold_planet_)にご連絡ください。
ytlive_helper でエゴサしてるかもしれません。