YamaPlayerPlaylistJsonTsvConverter
- Digital0 JPY
◆ YamaPlayerPlaylistJsonTsvConverter YamaPlayer のプレイリスト JSON と TSV を相互変換する Unity Editor ツールです。 プレイリストの管理をGoogleスプレッドシートやExcelで行えます。 ◆簡易使用説明 大まかな使用方法をスライドにしました。 https://docs.google.com/presentation/d/1W2lwuhbj5c1SbERQ081OtMZCXM5JS5C6A1hGNPFYUbc/edit?usp=sharing ◆ライセンス ライセンスはCC-0です。ご自由にご利用ください。許諾なく改変再配布可能です。 ◆お問い合わせ 何かしら問題があれば、Twitter (@hato_poppo_life) などでご連絡ください。 対応できる範囲で対応させていただきます。 下記GitHubのissueでも問題ありませんが、気づくまで時間がかかるかもしれません。 https://github.com/hatolife/YamaPlayerPlaylistJsonTsvConverter ◆補足 寄付などは受け付けておりません。 VRChatやTwitterでお友達になっていただいたほうが嬉しいです。 コードはCodexを用いて作成しました。 --- 以下 Codex 作成の資料です ---
README
# YamaPlayerPlaylistJsonTsvConverter YamaPlayer のプレイリスト JSON と TSV を相互変換する Unity Editor ツールです。 ## このツールの利点 - YamaPlayer 本体にも JSON の出力機能はありますが、そのままでは「見やすい・編集しやすい」形式とは言いにくいです。 - 本ツールで TSV 化することで、プレイリストをテキストベースかつ表形式で管理できます。 - TSV なら Googleスプレッドシートや Excel で、一覧編集・検索・並び替え・フィルタがしやすくなります。 - JSON/TSV の相互変換により、編集は表計算ソフト、反映は JSON という運用に分離できます。 - 出力 JSON の差分確認機能により、意図した変更かどうかを確認しやすくなります。 ## 機能 - JSON -> TSV 変換 - TSV -> JSON 変換 - 中断可能プログレスバー - Result のコピー可能表示 - `Input JSON` と `Output JSON` の差分要約表示 - WinMerge 連携（Windows） - `Diff with WinMerge` - `Install WinMerge (winget)` ## UI - `Input JSON` - `Output TSV` - `Output JSON` - `Input +1` ボタンで連番を自動設定 - 例: `playlists_1.json -> playlists_2.json` - 末尾連番なしは `_1` を付与 ## TSV 形式 ヘッダ（固定）: ```text playlist_name\tplaylist_active\tyoutube_list_id\tplaylist_is_edit\ttrack_mode\ttrack_title\ttrack_url ``` - `playlist_index` / `track_index` は使用しません - playlist 順・track 順は TSV の行順を採用します ## データ方針 - 空文字は許容 - `Tracks` 0件 playlist は許容 - URL 形式外は警告で許容 - URL は不要文字（空白・tab・改行・制御文字）を削除して正規化 ## 既知の互換処理 - 旧不整合TSV（ヘッダ7列なのにデータ先頭に旧 `playlist_index` が残る8列）を読み込んだ場合、先頭列を自動で無視します。 ## 使い方（基本） 1. `Input JSON` を選択 2. `Output TSV` / `Output JSON` を設定 3. `JSON -> TSV` または `TSV -> JSON` を実行 4. `Result` で警告・エラー・差分を確認 ## 注意 - 実行結果は `Result` の内容を優先して確認してください。 - 差分詳細は最大 200 件まで表示します。
USER_GUIDE
# YamaPlayerPlaylistJsonTsvConverter ユーザーガイド ## 1. 概要 このツールは、YamaPlayer のプレイリスト JSON を TSV に変換し、 表計算ソフトで編集した TSV を JSON に戻すための Unity Editor ツールです。 ## 2. 起動方法 Unity メニューから以下を選択します。 - `Tools/PoppoWorks/YamaPlayer Playlist Json TSV Converter` ## 3. 画面構成 上から順に次の入力欄があります。 - `Input JSON` - `Output TSV` - `Output JSON` `Output JSON` には `Input +1` ボタンがあります。 - 例: `playlists_1.json` を入力しているとき、`playlists_2.json` を自動設定 - 末尾連番がない場合は `_1` を付与 ## 4. 基本操作 ### 4.1 JSON -> TSV 1. `Input JSON` に元の JSON を指定 2. `Output TSV` に出力先を指定 3. `JSON -> TSV` を押す 4. `Result` で完了/警告/エラーを確認 ### 4.2 TSV -> JSON 1. `Output TSV` に読み込む TSV を指定 2. `Output JSON` に JSON 出力先を指定 3. `TSV -> JSON` を押す 4. `Result` で完了/警告/エラーを確認 5. 同時に `Input JSON` と `Output JSON` の差分要約が表示されます ## 5. TSV 仕様（重要） ヘッダは固定です。 ```text playlist_name\tplaylist_active\tyoutube_list_id\tplaylist_is_edit\ttrack_mode\ttrack_title\ttrack_url ``` - `playlist_index` / `track_index` は使いません - playlist 順・track 順は TSV の行順で決まります - 連続行の playlist メタが同じ間は同じ playlist として扱われます ## 6. データの扱い - 空文字は許容 - `Tracks` 0件 playlist は許容 - URL 形式外は警告（取り込みは継続） - URL は不要文字（空白・tab・改行・制御文字）を削除して正規化 ## 7. Result の見方 - `Errors`: 変換失敗要因。出力は信用しない - `Warnings`: 変換は実行されたが注意が必要 - `Diff`: `TSV -> JSON` 実行時の入力/出力差分 `Result` は選択してコピーできます。 ## 8. WinMerge 連携（Windows） - `Diff with WinMerge`: `Input JSON` と `Output JSON` を WinMerge で比較 - `Install WinMerge (winget)`: winget で WinMerge を導入 インストール確認ダイアログから、公式サイトを開いて手動インストールも可能です。 - 公式サイト: https://winmerge.org/?lang=ja ## 9. よくあるトラブル ### 9.1 ヘッダ不一致 - TSV の列名・順序が固定ヘッダと一致しているか確認してください。 ### 9.2 bool/int 変換エラー - `playlist_active` / `playlist_is_edit` は `true`/`false`（または `1`/`0`） - `track_mode` は整数 ### 9.3 意図しない差分が出る - TSV で行の並びを変更すると playlist/track の順序が変わります。 - `Diff` セクションで変更内容を確認してください。 ## 10. 運用の推奨 - 元 JSON は残し、`Output JSON` は別名で出力して比較する - `TSV -> JSON` 後に必ず `Diff` を確認する - 大きな変更前に JSON をバックアップする