# 書き庭 台本インポート(YMM4プラグイン・スパイク)

書き庭の「YMM4受け渡しパック」(timeline.json + 素材)を読み、
YMM4 のタイムラインへセリフ・立ち絵・背景・BGM・SE を一括配置するツールプラグイン。

- 仕様: 書き庭リポジトリの `docs/ymm4-bridge.md`(中間ファイル スキーマ v1)
- 状態: **API実証スパイク**。本体 `YukkuriMovieMaker.dll` の非公開ドキュメントAPI
  (`Project.Timeline.AddItems` 等)を使うため、YMM4 更新で壊れる可能性がある
- 検証環境: YMM4 v4.54.0.1 / .NET 10

## ビルド

`KakiniwaYmm4Import/KakiniwaYmm4Import.csproj` の `YMM4Dir` を
YMM4 のインストール先に合わせてから:

```
dotnet build KakiniwaYmm4Import -c Release
```

## インストール

ビルド成果物 `KakiniwaYmm4Import.dll` を
`<YMM4>/user/plugin/KakiniwaYmm4Import/` に置いて YMM4 を起動。

## 使い方

1. YMM4 でプロジェクトを開く(**先に保存しておく**。Undo 動作は未確認)
2. メニューの ツール → 「書き庭 台本インポート(スパイク)」
3. 受け渡しパックのフォルダ(timeline.json のある場所)を選ぶ
4. ログに配置結果が出る

## スパイクの割り切り(本実装での課題)

- 立ち絵は TachieItem ではなく **ImageItem として仮置き**
  (表情プリセット→`TachieFaceParameter` の流し込みは残調査)
- キャラ名は `ymm4Name` をそのまま `VoiceItem.CharacterName` に設定
  (YMM4 側に同名キャラが未登録でも配置はされる。照合UIは未実装)
- ボイスの自動生成トリガー・Undo 統合は未確認
- 配置は timeline.json の `start`(推定秒)×FPS の絶対配置
  (実尺での「順に詰める」は本実装で)