﻿ColaV v0.8.5
==============

VTuber 向けアバター共有アプリ（Windows）。
Web 版は公開済みです。ブラウザだけで体験したい方は公式の Web 版をご利用ください。

■ 起動方法
  1. このフォルダを好きな場所に置きます（Program Files 以外でも可）。
  2. colav-app.exe をダブルクリックして起動します。
  3. 初回に Windows / SmartScreen の警告が出る場合は「詳細情報」→「実行」を選んでください
     （コード署名未付与の開発配布物のため、警告が出ることがあります）。

■ 無料版と有料版のちがい
  ・有料版（-booth.zip）: ルーム作成などホスト向け機能を含むビルドです。
  ・無料版（-booth-free.zip）: 参加中心のビルドです（ホスト作成機能は含みません）。
  どちらの zip かはファイル名で判別できます。
  ※ BOOTH など返品不可の販売では、先に無料版で起動・参加できることを確認してから
    有料版をご購入ください（環境差で動かない場合のトラブルを避けられます）。

■ OBS で取り込む場合
  OBS のソースに「Spout2 Capture」を追加し、Sender に "ColaV Out" を選択します。
  「Spout2 Capture」自体は OBS の標準機能ではなく別プラグイン（win-spout）が必要ですが、
  ColaV に同梱されています。OBS が入っている環境で ColaV を初めて起動すると
  「インストールしますか？」と一度だけ確認され、「インストールする」を選ぶだけで
  自動的に導入されます（ダウンロード等の外部通信は行いません）。
  ・初回にスキップした場合や、後から OBS を入れた場合は、ColaV 画面上部の
    「🔌 OBS連携を導入」ボタンからいつでも再導入できます。
  ・自動導入がうまくいかない場合は、手動でも導入できます。配布元
    https://github.com/Off-World-Live/obs-spout2-plugin から win-spout をダウンロードし、
    フォルダの中身を %ProgramData%\obs-studio\plugins\win-spout に配置してください。

■ TikTok Live Studio など Spout 非対応アプリで使う場合（仮想カメラ）
  1. vcam\install-vcam.bat を右クリック →「管理者として実行」で仮想カメラを登録します（初回のみ）。
  2. ColaV の画面下部にある「仮想カメラ」チェックを ON にします。
  3. 配信アプリのカメラ選択に "ColaVVirtualCamera" が現れます。
  ※ 古い環境で "DirectShow Softcam" のままの場合は、vcam\refresh-vcam-name.bat を
    管理者として実行してください（同梱している場合）。
  ※ 不要になったら vcam\uninstall-vcam.bat を管理者として実行してください。

■ ゲーム画面を共有する
  上部のボタン列にある「＋ 🎮 ゲーム画面」からソース（モニター／ウィンドウ／
  キャプチャボード）を選ぶと、その時点で共有が始まります。ゲーム画面と自分のアバターは
  1 枚に合成されて相手に届き、モード A / B のどちらにいても共有は続きます。
  ・アバターのソースと入れ替わるのではなく、アバターは残って一緒に合成されます。
  ・焼き込み位置やサイズは右パネルの「ゲーム画面」セクションで変えられます。
  ・止めるときは同じボタンから「✖ 共有しない」を選びます。

■ 動作環境（目安）
  ・Windows 10 / 11（64bit）
  ・インターネット接続（ルーム参加・シグナリング用）
  ・GPU がある環境を推奨（合成・送出を GPU 側で処理し、CPU 負荷を抑える設計）

■ トラブルシュート
  ・起動しない / 落ちる: 同じフォルダに FFmpeg の DLL（avcodec 等）があるか確認してください。
  ・相手にアバターが見えない: 自分の映像ソース（Spout / 画面 / 画像など）が選ばれているか確認。
  ・仮想カメラが出ない: install-vcam.bat を管理者実行したか、カメラ一覧を再読込してください。
  ・OBS に「Spout2 Capture」ソースが出てこない: 上記の自動導入が失敗している可能性があります。
    「🔌 OBS連携を導入」ボタンで再試行するか、手動導入を行ってから OBS を再起動してください。

■ 利用条件
  本ソフトウェア本体の利用条件は licenses\LICENSE-colav.txt を参照してください。

■ 同梱オープンソース
  ・FFmpeg（共有ライブラリ・LGPL）。licenses\LICENSE-ffmpeg.txt / NOTICE.txt を参照。
  ・softcam（仮想カメラ・MIT）。vcam\LICENSE-softcam.txt を参照。
  ・obs-spout2-plugin（OBS 用 Spout2 プラグイン・GPL-2.0）。ColaV には静的リンクせず、
    OBS 側で動く別プロセスのプラグインとして同梱しています。
    spout2-plugin\LICENSE-obs-spout2-plugin.txt を参照。
  ・その他依存ライブラリの概要は licenses\THIRD_PARTY_NOTICES.txt を参照。
