# Batyun2 クイックスタート

Batyun2 は、PC で再生している動画の動きを解析し、Intiface 対応デバイス
（動作確認済み: The Handy）のストローク位置へリアルタイム変換するアプリです。

## 必要なもの

- Windows 10 (1903以降) / 11 64bit、または macOS (Apple Silicon)
- Intiface 対応のリニアデバイス（動作確認済み: The Handy）
- [Intiface Central](https://intiface.com/central/)（無料・推奨）
  - WiFi 接続（The Handy Connection Key）でも利用可能
- PC 上で再生できる動画またはキャプチャ対象ウィンドウ

デバイス本体、動画コンテンツ、成人向けコンテンツ素材は同梱されません。

## セットアップ（初回のみ）

1. zip を任意のフォルダへ展開し、`Batyun2.exe`（Mac: `Batyun2.app`）を起動する。
   デモ版は `Batyun2Demo.exe`（Mac: `Batyun2Demo.app`）。
   - Windows SmartScreen が表示された場合は、配布元を確認したうえで
     「詳細情報」→「実行」。
   - Mac で「"Batyun2" は壊れているため開けません」「開発元を検証できない」と
     表示される場合は、アプリを **右クリック（Control+クリック）→「開く」→「開く」**。
     それでも開けない場合はターミナルで
     `xattr -dr com.apple.quarantine /path/to/Batyun2.app` を実行してください。
2. Intiface Central を起動し「Start Server」を押す。
3. デバイスの電源を入れ Bluetooth モードにする
   （The Handy は Wi-Fi ボタン短押しでモード切替）。
4. Intiface Central のデバイス一覧に表示されたら準備完了。

## 基本操作（初回起動時に画面の案内も出ます）

1. **接続** — 画面左上の「未接続」をクリック → 接続方式で
   「Intiface (Bluetooth)」を選択 →「接続」。緑の「接続済み」になれば OK。
2. **映像を選ぶ** — 「ソースを選択」でウィンドウ一覧（サムネイル付き）から
   動画を再生しているウィンドウをクリック → 右のプレビューで確認 →
   「このウィンドウにする」。
3. **反応させたい部分を囲む** — 映像の上をマウスでドラッグして、
   反応させたい部分（結合部・胸・口・お尻など）を囲む（緑の枠）。
4. **部位プリセット** — サイドバーで囲んだ部位に合ったプリセットを選ぶ。
   モザイクのある映像は「モザイクあり」にチェック。
   動きが逆に感じたら「動きを反転」。
5. **強さ・動作範囲** — 実機の動きを見ながらスライダーで好みに調整。

## 遅延プレビュー（映像と実機の同期）

実機はコマンドから動作までわずかに遅れます。上部バーの「遅延プレビュー」を
オンにすると、映像を少し遅らせた別ウィンドウが開き、体感を同期できます。

- 「おすすめ値」ボタン → そこから微調整
- 別ウィンドウは **F キーまたはダブルクリックで全画面**、ESC で閉じる

## うまく動かないとき

- **デバイスが接続できない**
  - Intiface Central の「Start Server」が押されているか確認。
  - Intiface Central のデバイス一覧に実機が表示されているか確認。
  - WiFi 方式の場合は Connection Key と本体のネット接続を確認。
- **動きが検出されない**
  - 反応範囲（緑の枠）が動いている部分を囲んでいるか確認。
  - 反応範囲を「映像全体」に切り替えて試す。
- **X (Twitter) などの動画が、プレビューを全画面にすると止まる**
  - ブラウザ側の仕様です（ウィンドウが完全に隠れると、サイトが動画の
    再生を一時停止します）。以下のいずれかで回避できます:
    1. Chrome のショートカットのプロパティ →「リンク先」の末尾に追記:
       `--disable-backgrounding-occluded-windows --disable-features=CalculateNativeWinOcclusion`
       （Chrome を全て閉じてから起動し直すと有効）
    2. 動画を右クリック（2回）→「ピクチャーインピクチャー」で小窓化し、
       Batyun2 のキャプチャ対象をその小窓にする（おすすめ）
    3. モニタが2枚あれば、プレビューを別モニタで全画面にする
- **アプリが起動しない**
  - Windows 10 (1903以降)/11 64bit で実行しているか確認。
  - zip を完全に展開してから起動する。

## 設定・ログの保存場所とアンインストール

- 設定とログは以下に保存されます:
  - Windows: `%APPDATA%\Batyun2`
  - Mac: `~/Library/Application Support/Batyun2`
- アンインストールは、展開したフォルダと上記フォルダを削除するだけです。
  レジストリは使用しません。

## 注意

Batyun2 は成人向けデバイスを制御するツールなので、18 歳未満は使用しないでください。
利用する動画・機器・環境の規約と法令は利用者が確認してください。
