1. このソフトは？
ブロックをならべるだけで、本物のドローン（Fylo EDU+）10機のショーを作れるソフトです。作ったショーは3Dシミュレーションで確認でき、そのまま実機に送ったり、Pythonコードや他ソフトの形式に書き出したりできます。
- 🧩 ブロックプログラミング（ドラッグ＆ドロップ）
- 🎬 3Dシミュレーションで飛ばす前に確認
- 🔁 Scratch / Hula / Fylo / BeeDance のファイルを取り込み＆相互変換
- 🚁 実機連携・Blender連携・Pythonコード生成
対象年齢：幼児〜おとな。むずかしいブロックは「👶 かんたん」モードでかくせます。
2. 画面の見かた
| ばしょ | なにがある？ |
|---|
| 上のバー | ▶スタート／■ストップ／↺リセット／🔇こえ（音声ガイド）／☀️しろ（白黒）／👶かんたん |
| 左パネル | タブ：🧩ブロック・⚙️せってい・🎬プリセット・🚁じっき。下半分に「プログラム（ならべたブロック）」 |
| 中央 | 3Dビュー。マウスでぐるぐる回せる。3D／うえ／まえ／よこ／キャラ／ろくが の切りかえ |
| 右パネル | 📍いまいるばしょ（座標表）・📝ログ・💾セーブ／よみこみ／書き出し／コードをみる |
3. 基本の使いかた
- 左の 🧩ブロック から、やりたい動きをクリック（またはプログラム欄へドラッグ）してならべる
- 上の ▶スタート！ を押すと、3Dビューでドローンが動く
- 気に入ったら 💾セーブ や コードをみる で書き出し
ブロックはドラッグで並べ替えできます（つかんで上下に動かす）。プログラム欄の▲▼✕でも操作できます。3Dビューでドローンをタップすると、その子だけに命令できます。
4. ブロック図鑑
✈️ うごき
⬆️上⬇️下◀️前▶️後⬅️左➡️右…cmで移動／📍ざひょうへ飛行X・Y・Zを入れてその位置へ／🌊ウェーブ番号順にバウンス
🔄 まわる
↩️右にかいてん↪️左にかいてん角度で向きを変える／🌀くるくるその場で回転
💫 フォーメーション
ハート・ほし・まる・ダイヤ・やじるし・いちれつ・ます目・らせん・ツリー・さくら・ゆきだるま・はなび／🔢すうじ0〜9／🔤アルファベットA〜Z／🔄かたちを回す（→5章）／✏️じぶんでつくる（自由に点を置く）
💡 ひかり
赤・青・黄・緑・にじいろ／🎨すきな色（RGB自由）（→6章）
⏱️ その他
🛫とびたつ🛬ちゃくりく⏳まつ秒数／🔁くりかえし前のブロックを何回か
6. ひかり（色）
ドローンのLEDの色を変えます。決まった色（赤・青・黄・緑・にじいろ）のほか、🎨すきな色でカラーパレットから1600万色すべて選べます。
ショーのはじめは全機消灯（黒）からスタートします。ドローンの基本色は ⚙️せってい で変えられます（黄・消灯を含む8色）。
7. プリセット
🎬プリセットタブから、できあいのショーを1クリックで読み込めます（全10種）。
スターショー・ハートショー・レインボー・スパイラル・10機ウェーブ／さらに回転バージョン5種（ほし回転・ハート回転・まる回転・らせん回転・さくら回転）。
「🚀8機デモをみる！」で完成デモも見られます。
8. せってい
| こうもく | ないよう |
|---|
| ひこうエリア | はば(X)・たかさ・おくゆき（cm）。星など高い形は「たかさ」を上げる |
| ドローンのかず | 1〜10機 |
| スピード | おそい〜とてもはやい（初期＝ふつう） |
| おおきさ | ドローン／キャラの大きさ（初期70%） |
| みため | 🚁ドローン／🎭キャラ の切りかえ |
| ドローンのいろ | 消灯・黄・シアン・オレンジ・ピンク・ライム・むらさき・しろ |
| 🏞️みための調整 | 🟦ゆか・🗼ぼう（基地局）・✨きせき の表示ON/OFF／それぞれ色変更／🖼️景色（背景画像） |
背景画像は360°でまわりを囲みます（カメラを回すと景色も広がる）。ゆか・グリッド・ぼう・わくの色も自由に変えられます。
9. 音楽・BGM
- 🎵 おんがくをえらぶ：mp3などを読み込むと、▶スタートでショーと同時に再生。波形もタイムラインに表示
- 🎹 じどうBGM：曲がなくても、やさしいメロディが自動で鳴る（その場で音を合成・ネット不要）
10. 取り込み
右下の 📥ファイルをひらく から読み込めます。
| 形式 | 説明 |
|---|
| Scratch (.sb3) | 公式Fylo Scratch（droneMotion）で作った作品 |
| Hula (.json) | Hulaのブロック編集（droneNormal）で作った作品 |
| Fylo (.sb3) | Fyloのプロジェクト |
| BeeDance (.zip) | プロのダンスファイル。30fpsそのまま滑らか再生。音楽・開始配置・基地局数も自動反映 |
| アプリJSON (.json) | このアプリで保存したファイル |
複数機ぶんのスクリプトは、待ち時間から時間で合成して「全機どうじ」に動かします（星なども正しく出ます）。
11. 書き出し・変換
- 📤 ファイルにほぞん：このアプリのJSON
- 🐝 Hula形式でほぞん：Hulaで開ける .json
- 🛸 Fylo形式でほぞん：Fyloで開ける .sb3
- 🐍 コードをみる：Python（全機・個別）／Scratch風／🐝Hula(pyhula)／8機デモ
Hula ⇄ Fylo 相互変換：片方を取り込んで、もう片方の形式で書き出すだけ。
Scratch系ソフトは大量ブロックを開けません。BeeDanceのような密なダンスは、書き出し時に自動で間引かれます（手作りショー向け）。
12. 実機で飛ばす
ドローンPCで drone_server.py を起動すると 🚁じっきタブ が現れ、画面のボタンで本物のドローンを飛ばせます（pyfyloが無いPCは自動でテストモード）。
操作の流れ：接続 → 境界設定（標定）→ ダンス生成 → シミュ表示 → 送信 → 時刻同期 → 位置初期化 → 起飛許可 → ショー開始。
実機は必ず安全な広い場所で、基地局の設定（高さ・台数・0号機の向き）を合わせてから飛ばしてください。
13. Blender連携
作ったショーをBlenderに渡してリアルなプレビュー動画にしたり、Blenderで作った動きを実機コードに書き出したりできます（fylo_blender.py / fylo_blender_export.py、Blender 5.12対応）。
14. こまったとき
新機能が出ない／消したものが復活する
ウェブサイト（sukusapoono.com）に新しいファイルをアップし忘れている可能性大です。
upload フォルダの中身を全部そのままサーバーに上書きアップ（解凍不要）- ブラウザで Ctrl+Shift+R（強制リロード）
とくに新しく増えたファイル（例：beedance_import.js・fylo_export.js）の上げ忘れに注意。編集したファイルだけでなく全部まとめて上書きが確実です。
星などが高すぎて「🚧はみ出し」が出る
⚙️せっていの「たかさ」を上げてください（実機の基地局の高さに合わせる）。
15. プロのダンスを楽しむ・いじる（BeeDance/CSV）
🐝 読み込むと出るもの
- 左下の距離パネル：✈️ドローンが飛ぶ幅／🗼基地局エリア（設営）／💥機体間の最小きょり（めやす1.00m）
- 柱（基地局）が公式と同じ設営エリアに立ち、はば・おくゆきのラベルつき。⚙️せっていで4/6/8台切りかえ、はば×おくゆき(m)を手で入れて置きなおしもできる（飛行幅とは別物）
- 読み込むと ゆか・ぼう は自動で表示ONにもどる
🔬 こまかく編集（タイムライン）の使い方
- BeeDanceやCSVのショーを📥で読み込む
- プログラム欄の上の 「🔬 こまかく」 を押す → 全画面の編集画面がひらく
- スライダーを左右にドラッグ＝場面めくり。3Dのドローンもその場面に動く（うしろの3D画面を見ながら操作）
- 直したい場面で止めて、表の数字（X よこ・Y おく・Z たかさ、cm）を打ちかえる→すぐ3Dにうつる。いろはカラーピッカーで変更
- ＋ふくせい＝いまの場面をコピーして次に追加（新しい振り付けの足し込み）／🗑＝場面を削除
- ✕とじるで完了。まちがえたら「↩もどす」
編集すると「なめらか30fps再生」→「ステップ再生」に切りかわります（編集を反映するため）。もとのなめらか再生に戻すには、ファイルを読み込みなおしてください。
📊 CSVショー（読み・書き）
- 読み込み：📥ファイルをひらく → CSVを複数まとめて選択（1機=1ファイル）か、CSV入りzipをそのまま1つ選ぶ。clever-show／Skybrush／mavsdk形式に対応
- 書き出し：💾セーブ欄の「📊CSVでほぞん」→ Skybrush互換CSV×機体数がzipで保存。BeeDance→CSV変換にも使える
🎼 じどう作曲
⚙️せってい→🎵おんがく→スタイル（🎉わくわく/🌸おだやか/🌙よぞら）を選んで「🎼じどう作曲」。ショーの長さに合った曲ができて、そのままショーの音楽になる。💾でWAV保存。押すたびちがう曲。
📱 QRコード ／ 🖼️ 画像 → ドローン
- QR：⚙️せっていにURLを入れて「📱QRをつくる」→ 黒いドットの位置に光るドローンが並ぶ（読めるQRは黒マス200〜440個＝機数が必要）。表示中はゆらゆら停止＋「QR表示中」バナー
- 画像：「🖼️画像をえらぶ」→ 絵の形と色をドローンで再現（白背景のイラスト向き。えほんモードの「🖼️じぶんのえ」からも使える）
16. ほかのドローン・形式への書き出し
| タブ | 対象 | 方式 |
|---|
| 🐝 Hula(pyhula) | Hulaドローン | 単機Pythonコード／HulaプロジェクトJSON書き出しも別ボタンで |
| 🛸 Tello | DJI Tello / Tello Talent | 各PC1機・PC=1を変えて実行・Enter同時スタート（djitellopy） |
| 🤖 CoDrone | CoDrone EDU（Robolink） | 1台のPCから全機制御（Swarm＋Sequence/Sync）。フォーメーションは全機同時の相対移動 |
| 🚁 ByRobot | e_drone／CodingRider／coding_drone | 各PC1機方式（sendTakeOff／sendControlPosition） |
| ⛏ マイクラ | Minecraft Education | 💾セーブ欄の2ボタン。ドローン1機＝光るブロック1つとして、マイクラの夜空でショーを再現 |
⛏ マイクラ（Minecraft Education）でショーを見る
飛ばせない日でも、作ったショーをマイクラの空で再現できます。実機のショーは幅数mなので、
高さ28ブロック・幅60ブロックに収まる倍率（最大6倍）に自動で拡大します。LEDが消えている機体はブロックを置きません。
| ボタン | 出るもの | つかいかた |
|---|
| ⛏ マイクラでほぞん (.csv) | t,drone,x,y,z,color のCSV |
D:\claude\minecraft_droneshow で py -3.11 show.py --play-csv そのファイル → マイクラのチャットで /connect localhost:19131。なめらか（1秒6コマ）でこちらがおすすめ |
| ⛏ マイクラ Code Builderのコード (.py) | MakeCode Python |
マイクラで C キー → MakeCode → Python にぜんぶ貼って、チャットに show（消すのは clear）。サーバー不要だが動きは遅い |
Code Builder のコードは、先頭の ORIGIN_X / ORIGIN_Y / ORIGIN_Z を書きかえるとショーの場所を動かせます。
マイクラ Education はストアアプリなので、/connect localhost が既定で止められています。つながらないときは minecraft_droneshow\loopback_ok.bat を管理者で実行するか、/connect PCのIPアドレス:19131 にしてください。
⚙️せってい「🤖ドローンのすがた」で、3D表示を🚁ドローンがた（プロペラつき）と💡ひかる球から選べます（じどう＝16機をこえたら球）。
17. バージョン履歴
v4.0プロダンス完全対応・変換ハブ完成（2026-07-15）
🔬こまかく編集（タイムライン式・座標と色を表で直接編集）／🎼じどう作曲（3スタイル・WAV保存）／
📊CSVショー入出力（clever-show・Skybrush・mavsdk対応、BeeDance→CSV変換、zipのまま読める）／
🤖CoDrone EDU・🚁ByRobotコード出力／左下に距離の常時パネル／
基地局エリアを手動設定（飛行幅とは別物として分離）／機体間の最小きょりチェック（めやす1.00m）／
🤖ドローンのすがた選択（ドローンがた⇄ひかる球）／しろモードの文字色修正。
v3.8100機・QR・画像・えほん（2026-07-14）
BeeDance 100機シミュレーション（軽量表示・自動フィットで大きいショーも画面内に）／
公式と同じ設営エリア計算を解読して表示（幅+1m・奥行は高さ×0.8下限・高さ+50cm）／
📱QRコードを光るドローンで表示（自作QRエンコーダ・読み取り検証済み）／
🖼️画像→ドローン（形と色を再現）／📖えほんモード（1枚1アクション・30枚）／
🛸Telloコード出力／🔟10機にもどすボタン。
v3.6基地局と距離（2026-07-14）
基地局4/6/8台切りかえ／柱がショーの範囲に立ち距離ラベル表示／ダンスカタログCSV自動生成（63本）。
v3.5みための仕上げ（2026-07-13）
軌跡（きせき）の表示ON/OFF追加／ゆか・グリッド・ぼう・わくの色変更を追加。
v3.4回転と見た目の調整（2026-07-13）
「かたちを回す」をたて軸のぐるっと回転に修正／背景画像を360°スカイボックス化／プリセットを10個に（回転版5種追加）／せっていの重複プリセット削除／スピード初期値を「ふつう」に／回転ブロックを上に移動・45度きざみ。
v3.3アルファベット・見た目機能（2026-07-13）
アルファベットA〜Zフォーメーション追加／床・棒の表示ON/OFF／背景画像取り込み／自動BGM／マークじょうほう（未使用の飾り）を削除。
v3.2回転アニメ・RGB（2026-07-13）
「かたちを回す」＝形を少しずつ回す回転アニメ／🎨RGB/カラーパレットのひかり。
v3.1ブロック拡充（2026-07-13）
座標へ飛行・左右移動ブロックをパレットに追加／ドローン色に黄・消灯追加・起動時は消灯／ログ窓を拡大。
v3.0Hula連携・相互変換（2026-07-12〜13）
Hula JSON（droneNormal）の取り込み・書き出し／Fylo ⇄ Hula 相互変換（アプリ経由）。
v2.6ドラッグ式ブロック編集（2026-07-12）
パレットからドラッグして挿入・並べ替え／Scratch風の見た目。
v2.5BeeDanceの音楽・配置（2026-07-12）
BeeDanceのzip内mp3を自動再生／開始配置・基地局数を3Dに反映。
v2.430fps専用プレイヤー（2026-07-12）
BeeDanceのダンスを間引かず30fpsそのまま滑らか再生（位置＋LED色）。
v2.3Hulaコード出力（2026-07-12）
単機ドローンHula向け pyhulaコード出力タブを追加。
v2.2BeeDance取り込み（2026-07-12）
BeeDanceの .dac 軌道（30fps・x/y/z＋RGB）を解析して取り込み。
v2.1座標へ飛行・時間合成（2026-07-12）
gotoCoord（座標へ飛行）対応／待ち時間で同期する複数スクリプトを時間で合成して全機同時に（星が正しく出る）。
v2.0Scratch取り込み（2026-07-12）
公式Fylo Scratch（.sb3 / droneMotion）の作品取り込みに対応（全23ブロック）。
v1.5ファイル分割・保守性
1枚のHTMLを formations / engine3d / codegen / helpers / app などに分割。
v1.4Blender連携
アプリ→Blender（リアルなプレビュー）／Blender→実機コード。
v1.3自動衝突回避
ぶつかりそうなフォーメーションを自動で広げる。💥ぶつかりチェック表示。
v1.2音楽取り込み
mp3などの取り込み・波形タイムライン・ショーと同時再生。
v1.1操作性の向上
キャラ切りかえ・サイズ調整・スピード修正・ドローン番号ON/OFF・座標表・3Dタップで個別選択。
v1.0最初のバージョン
ブロックで10機のショー作成／3Dシミュレーション／本物の pyfylo（dance_*）コード生成／実機連携。