なでしこさんで「ひろいもの」を作るよ！　④　～いろいろ機能を追加して完成～

　問題を作成したり、それをダウンロードしたり、またそれをアップロードして遊んだりできるようにする。
　あるいは、なでしこさんの新機能をお試しし、効果音を鳴らしてみたりする。
　あるいはまた、自作のプラグインを使ってみようとしたところ、プラグインを更新し忘れていたことに気づいて反省したりする。

# 問題を自分で入力する機能
　規定の問題を解くだけでなく、自分で問題を入力することが出来たら便利ですよね。
　雑誌などの問題も、実際に石を拾えるようにしたら、頭の中だけで考えるよりも解答が捗ります。
　また、自分でもっとむじゅかしい問題を考えて、誰かに解かせたり？

## 問題を入力する
　石のない所を押したら石を置き、有るところを押したら石を消すようにすれば良いだけです。
　問題入力中のフラグを用意して、キャンバスを押した時のイベントに追加します。

<!--
描画中キャンバスをマウス押した時には、
    列,行＝マウス位置取得。
    もし、問題入力中フラグ＝オンならば、
        もし、現在データ[行][列]＝１ならば、
            現在データ[行][列]＝０。
        違えば、
            現在データ[行][列]＝１。
        ここまで。
        拾った履歴に[列,行]を配列追加。
        盤面描画。戻る。
    ここまで。
-->
<blockquote><font color="#7f00ff">描画中キャンバス</font><font color="black">を</font><font color="#7f00ff">マウス押した時</font><font color="black">には</font>、<br>&nbsp;&nbsp;&nbsp;&nbsp;<font color="blue">列</font>,<font color="blue">行</font><font color="magenta">＝</font><font color="blue">マウス位置取得</font>。<br>&nbsp;&nbsp;&nbsp;&nbsp;<font color="magenta">もし</font>、<font color="blue">問題入力中フラグ</font><font color="magenta">＝</font><font color="#7f00ff">オン</font><font color="black">ならば</font>、<br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<font color="magenta">もし</font>、<font color="blue">現在データ</font><font color="magenta">[</font><font color="blue">行</font><font color="magenta">]</font><font color="magenta">[</font><font color="blue">列</font><font color="magenta">]</font><font color="magenta">＝</font><font color="red">１</font><font color="black">ならば</font>、<br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<font color="blue">現在データ</font><font color="magenta">[</font><font color="blue">行</font><font color="magenta">]</font><font color="magenta">[</font><font color="blue">列</font><font color="magenta">]</font><font color="magenta">＝</font><font color="red">０</font>。<br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<font color="magenta">違えば</font>、<br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<font color="blue">現在データ</font><font color="magenta">[</font><font color="blue">行</font><font color="magenta">]</font><font color="magenta">[</font><font color="blue">列</font><font color="magenta">]</font><font color="magenta">＝</font><font color="red">１</font>。<br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<font color="magenta">ここまで</font>。<br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<font color="blue">拾った履歴</font><font color="black">に</font><font color="magenta">[</font><font color="blue">列</font>,<font color="blue">行</font><font color="magenta">]</font><font color="black">を</font><font color="#7f00ff">配列追加</font>。<br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<font color="blue">盤面描画</font>。<font color="magenta">戻る</font>。<br>&nbsp;&nbsp;&nbsp;&nbsp;<font color="magenta">ここまで</font>。</blockquote>

　基本的に言えばそれだけ！　なので、改めて記事にするようなコトは特に無かった。
　引っ張ったはいいけどどうしよう😅

## 入力完了する
　入力が完了したら、`尋ねる`を使って問題名の入力を促し、それをキーにして新しい辞書型変数に登録することにします。
　でも、辞書型変数についても既にやったしねー💧
 
　問題集も、作成したデータに差し替え、セレクトボックスの内容も書き換え、これで入力した問題を遊べるようになりました。　

<!--
ダイアログキャンセル値＝NULL。
　　「問題名を入力してください」と尋ねる。
　　問題名＝それ。
　　もし、それ=NULLならば、戻る。
　　もし、それ≠空ならば、
　　　　作成データ[問題名]＝現在データ。
　　　　問題集＝作成データ。
　　　　問題一覧＝問題集の辞書キー列挙。
　　　　問題セレクトに問題一覧をセレクトボックスアイテム設定。
　　　　問題セレクトに問題名をテキスト設定。
　　違えば、
　　　　「キャンセルします」で二択。
　　　　もし、それがいいえならば、
　　　　　　戻る。
　　　　ここまで。
　　ここまで。
-->
<blockquote><font color="blue">ダイアログキャンセル値</font><font color="magenta">＝</font><font color="#7f00ff">NULL</font>。<br>　　<font color="maroon">「問題名を入力してください」</font><font color="black">と</font><font color="#7f00ff">尋ねる</font>。<br>　　<font color="blue">問題名</font><font color="magenta">＝</font><font color="magenta">それ</font>。<br>　　<font color="magenta">もし</font>、<font color="magenta">それ</font><font color="magenta">=</font><font color="#7f00ff">NULL</font><font color="black">ならば</font>、<font color="magenta">戻る</font>。<br>　　<font color="magenta">もし</font>、<font color="magenta">それ</font><font color="magenta">≠</font><font color="#7f00ff">空</font><font color="black">ならば</font>、<br>　　　　<font color="blue">作成データ</font><font color="magenta">[</font><font color="blue">問題名</font><font color="magenta">]</font><font color="magenta">＝</font><font color="blue">現在データ</font>。<br>　　　　<font color="blue">問題集</font><font color="magenta">＝</font><font color="blue">作成データ</font>。<br>　　　　<font color="blue">問題一覧</font><font color="magenta">＝</font><font color="blue">問題集</font><font color="black">の</font><font color="#7f00ff">辞書キー列挙</font>。<br>　　　　<font color="blue">問題セレクト</font><font color="black">に</font><font color="blue">問題一覧</font><font color="black">を</font><font color="#7f00ff">セレクトボックスアイテム設定</font>。<br>　　　　<font color="blue">問題セレクト</font><font color="black">に</font><font color="blue">問題名</font><font color="black">を</font><font color="#7f00ff">テキスト設定</font>。<br>　　<font color="magenta">違えば</font>、<br>　　　　<font color="maroon">「キャンセルします」</font><font color="black">で</font><font color="#7f00ff">二択</font>。<br>　　　　<font color="magenta">もし</font>、<font color="magenta">それ</font><font color="black">が</font><font color="#7f00ff">いいえ</font><font color="black">ならば</font>、<br>　　　　　　<font color="magenta">戻る</font>。<br>　　　　<font color="magenta">ここまで</font>。<br>　　<font color="magenta">ここまで</font>。</blockquote>

　そういえば、やっぱやめた～ってなった時はどうするかなーと思い、新しいＵＩを作るほどのことでも無いので、`尋ねる`でキャンセルを押した時には何もせず戻り（問題入力続行）、問題名を入力せずにＯＫした場合には問題入力自体をキャンセルしてゲーム画面に戻る、ということにしてみました。

### ダイアログキャンセル値
　これは、一番最近のバージョンアップ(v3.4.24)でなでしこさんに追加された最新の機能です☆

👉 **[なでしこ3 マニュアル > plugin_browser/ダイアログキャンセル値](https://nadesi.com/v3/doc/index.php?plugin_browser%2F%E3%83%80%E3%82%A4%E3%82%A2%E3%83%AD%E3%82%B0%E3%82%AD%E3%83%A3%E3%83%B3%E3%82%BB%E3%83%AB%E5%80%A4&show)**
 
　実は、ｖ1には元々あった機能です。
　なでしこでは、簡単のため、未入力でＯＫしたときも、キャンセルをした場合も空文字列が返るようになっています。
　でも、処理を分けたい場合もありますよね。
　そこで、`ダイアログキャンセル値`です！

　未入力でＯＫした場合には空文字、キャンセルした場合にはダイアログキャンセル値が返るようになりました。
　ダイアログキャンセル値のデフォルトは空なので、もともとの動作と変わりはありませんが、処理を分けたい！　てなった時にはダイアログキャンセル値にベツのものを代入しておくことで判定出来るようになるって寸法です。

　ここではじゃばすくりぷとに合わせて`NULL`を指定しています。

## もっと大きな問題も入力したい
　今の碁盤のサイズは、古典の12問に合わせて作っていますが、もっと大きなサイズの問題も入力できるよう、碁盤の行列数を変更できるようにします。
 　行数、列数を入力するエディタを作成し、

👉 **[なでしこ3 マニュアル > plugin_browser/エディタ作成](https://nadesi.com/v3/doc/index.php?plugin_browser%2F%E3%82%A8%E3%83%87%E3%82%A3%E3%82%BF%E4%BD%9C%E6%88%90&show)**

　問題作成ボタンを押したらテキスト取得してキャンバスのサイズを変更、碁盤を再描画すれば良いだけです。

<!--
問題作成ボタンをクリックした時には、
    もし、問題入力中フラグ＝オフならば、
        ゲーム中フラグ＝オフ。
        問題入力中フラグ＝オン。
        行数＝行数エディタのテキスト取得。
        列数＝列数エディタのテキスト取得。
        画面サイズ計算。
        描画中キャンバスの「幅」に画面幅をDOM属性設定。
        描画中キャンバスの「高さ」に画面高さをDOM属性設定。
        盤面描画
//　～～～　略　～～～
-->
<blockquote><font color="blue">問題作成ボタン</font><font color="black">を</font><font color="#7f00ff">クリックした時</font><font color="black">には</font>、<br>&nbsp;&nbsp;&nbsp;&nbsp;<font color="magenta">もし</font>、<font color="blue">問題入力中フラグ</font><font color="magenta">＝</font><font color="#7f00ff">オフ</font><font color="black">ならば</font>、<br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<font color="blue">ゲーム中フラグ</font><font color="magenta">＝</font><font color="#7f00ff">オフ</font>。<br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<font color="blue">問題入力中フラグ</font><font color="magenta">＝</font><font color="#7f00ff">オン</font>。<br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<font color="blue">行数</font><font color="magenta">＝</font><font color="blue">行数エディタ</font><font color="black">の</font><font color="#7f00ff">テキスト取得</font>。<br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<font color="blue">列数</font><font color="magenta">＝</font><font color="blue">列数エディタ</font><font color="black">の</font><font color="#7f00ff">テキスト取得</font>。<br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<font color="blue">画面サイズ計算</font>。<br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<font color="#7f00ff">描画中キャンバス</font><font color="black">の</font><font color="maroon">「幅」</font><font color="black">に</font><font color="blue">画面幅</font><font color="black">を</font><font color="#7f00ff">DOM属性設定</font>。<br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<font color="#7f00ff">描画中キャンバス</font><font color="black">の</font><font color="maroon">「高さ」</font><font color="black">に</font><font color="blue">画面高さ</font><font color="black">を</font><font color="#7f00ff">DOM属性設定</font>。<br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<font color="blue">盤面描画</font><br><font color="green">//　～～～　略　～～～</font></blockquote>

　これで、好きなサイズの問題を入力し、遊ぶことが出来るようになりました！
　やったね🎶

　・・・と、ここまでやってきてワタクシが欲しかった欲しかった機能は一応ひととおり追加出来たのですが、結局書くことたいして無いじゃん・・・と、ワタクシ途方に暮れてしまいました💧💧💧
　プログラムの内容的にもなでしこの機能的にも、目新しい内容は特になく、唯一、ダイアログキャンセル値の紹介が出来た程度です。
　このままじゃ終われない！

# 別の問題集を読み込む機能
　せっかくなので、3日目の記事で書いた、ローカルのファイルを読み込むプラグインを実際に使ってみます。

 https://qiita.com/snowdrops89/items/7e9db5d926a1b69783b3

　取り込みます。

<!--
!「https://n3s.nadesi.com/plain/nadesiko3-FileReader.js」を取り込む。
-->
<blockquote><font color="magenta">!</font><font color="maroon">「https://n3s.nadesi.com/plain/nadesiko3-FileReader.js」</font><font color="black">を</font><font color="magenta">取り込む</font>。</blockquote>
 
　と、ここで！
　こうして記事を書いておきながら、プラグインの方が新しいものに更新されていなかった！　とゆう事実に気がつきました😱
　ダウンロードが使えるようになっていなかったのねん💧
　というわけで、遅まきながら貯蔵庫のプラグインを更新しました。
　ほんとスミマセン🙏🙇‍♀️

## 作成した問題をダウンロードできるようにする
　さて、気を取り直して・・・
　折角入力しても、今のままではひとたびゲーム画面を閉じたら失われてしまいます。
　いつでも再び遊べるようにしたいです。

　辞書型変数は、JSONエンコードすればテキストダウンロード出来ます。
<!--
ダウンロードボタン＝「ダウンロード」のボタン作成。
ダウンロードボタンをクリックした時には、
    作成データをJSONエンコードして「ひろいもの問題集.json」でテキストダウンロード。
ここまで。
-->
<blockquote><font color="blue">ダウンロードボタン</font><font color="magenta">＝</font><font color="maroon">「ダウンロード」</font><font color="black">の</font><font color="#7f00ff">ボタン作成</font>。<br><font color="blue">ダウンロードボタン</font><font color="black">を</font><font color="#7f00ff">クリックした時</font><font color="black">には</font>、<br>&nbsp;&nbsp;&nbsp;&nbsp;<font color="blue">作成データ</font><font color="black">を</font><font color="#7f00ff">JSONエンコード</font><font color="black">して</font><font color="maroon">「ひろいもの問題集.json」</font><font color="black">で</font><font color="blue">テキストダウンロード</font>。<br><font color="magenta">ここまで</font>。</blockquote>

　こんだけ！
　一度問題入力をするとセレクトボックスの内容が新しく作成した問題集に差し替わるのですが、以降は連続して問題入力すれば、新しい問題集に追加されていくので、一問だけではなく問題集として作成し、ダウンロードすることが出来ます。

## ローカルの問題ファイルを読み込む
　ダウンロードしてもソレを読み込めないと意味無いので、ローカルPCにある問題集を遊べるようにします。
　JSONファイルはUTF-8のテキストとして開き、JSONデコードすれば辞書型変数として使えるようになります。
<!--
問題選択ボタン＝ファイル選択作成。
問題選択ボタンでファイル選択した時には、
    ファイル＝対象[0]。
    空でファイルのテキストファイル開いた時には、
        問題集＝対象をJSONデコード。
        問題集変更してゲーム開始。
    ここまで。
ここまで。
-->
<blockquote><font color="blue">問題選択ボタン</font><font color="magenta">＝</font><font color="blue">ファイル選択作成</font>。<br><font color="blue">問題選択ボタン</font><font color="black">で</font><font color="blue">ファイル選択した時</font><font color="black">には</font>、<br>&nbsp;&nbsp;&nbsp;&nbsp;<font color="blue">ファイル</font><font color="magenta">＝</font><font color="magenta">対象</font><font color="magenta">[</font><font color="red">0</font><font color="magenta">]</font>。<br>&nbsp;&nbsp;&nbsp;&nbsp;<font color="#7f00ff">空</font><font color="black">で</font><font color="blue">ファイル</font><font color="black">の</font><font color="blue">テキストファイル開いた時</font><font color="black">には</font>、<br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<font color="blue">問題集</font><font color="magenta">＝</font><font color="magenta">対象</font><font color="black">を</font><font color="#7f00ff">JSONデコード</font>。<br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<font color="blue">問題集変更</font><font color="black">して</font><font color="blue">ゲーム開始</font>。<br>&nbsp;&nbsp;&nbsp;&nbsp;<font color="magenta">ここまで</font>。<br><font color="magenta">ここまで</font>。</blockquote>

　こんだけ！
　なお、`問題集変更`の中で、セレクトボックスの内容更新と、碁盤サイズの変更を行っています。

<!--
●問題集変更
    問題一覧＝問題集の辞書キー列挙。
    問題セレクトに問題一覧をセレクトボックスアイテム設定。
    行列数カウントして画面サイズ計算。
    空データ作成。
    描画中キャンバスの「幅」に画面幅をDOM属性設定。
    描画中キャンバスの「高さ」に画面高さをDOM属性設定。
ここまで。
-->
<blockquote><strong><font color="magenta">●問題集変更</font></strong><br>&nbsp;&nbsp;&nbsp;&nbsp;<font color="blue">問題一覧</font><font color="magenta">＝</font><font color="blue">問題集</font><font color="black">の</font><font color="#7f00ff">辞書キー列挙</font>。<br>&nbsp;&nbsp;&nbsp;&nbsp;<font color="blue">問題セレクト</font><font color="black">に</font><font color="blue">問題一覧</font><font color="black">を</font><font color="#7f00ff">セレクトボックスアイテム設定</font>。<br>&nbsp;&nbsp;&nbsp;&nbsp;<font color="blue">行列数カウント</font><font color="black">して</font><font color="blue">画面サイズ計算</font>。<br>&nbsp;&nbsp;&nbsp;&nbsp;<font color="blue">空データ作成</font>。<br>&nbsp;&nbsp;&nbsp;&nbsp;<font color="#7f00ff">描画中キャンバス</font><font color="black">の</font><font color="maroon">「幅」</font><font color="black">に</font><font color="blue">画面幅</font><font color="black">を</font><font color="#7f00ff">DOM属性設定</font>。<br>&nbsp;&nbsp;&nbsp;&nbsp;<font color="#7f00ff">描画中キャンバス</font><font color="black">の</font><font color="maroon">「高さ」</font><font color="black">に</font><font color="blue">画面高さ</font><font color="black">を</font><font color="#7f00ff">DOM属性設定</font>。<br><font color="magenta">ここまで</font>。</blockquote>

## 貯蔵庫の問題を読み込む
　良い問題が出来た時、それを貯蔵庫に素材としてアップロードしておけば、ほかの誰かに遊んでもらえるかも知れません。
　貯蔵庫に素材としてアップロードされている問題集を読み込み、差し替えることが出来るようにします。
　これは、最初に問題集をAJAXで取得するのと同じ事なので、特筆することはありません。
　エディタに入力した絶対URLから`AJAX_JSON取得`するだけです。

<!--
素材URL＝空のエディタ作成。
改行作成。
「素材の絶対URLを入力してください：」のラベル作成。
素材取得ボタン＝「読み込む」のボタン作成。
素材取得ボタンをクリックした時には、
    問題集＝素材URLのテキスト取得からAJAX_JSON取得。
    問題集変更してゲーム開始。
ここまで。
-->
<blockquote><font color="blue">素材URL</font><font color="magenta">＝</font><font color="#7f00ff">空</font><font color="black">の</font><font color="#7f00ff">エディタ作成</font>。<br><font color="#7f00ff">改行作成</font>。<br><font color="maroon">「素材の絶対URLを入力してください：」</font><font color="black">の</font><font color="#7f00ff">ラベル作成</font>。<br><font color="blue">素材取得ボタン</font><font color="magenta">＝</font><font color="maroon">「読み込む」</font><font color="black">の</font><font color="#7f00ff">ボタン作成</font>。<br><font color="blue">素材取得ボタン</font><font color="black">を</font><font color="#7f00ff">クリックした時</font><font color="black">には</font>、<br>&nbsp;&nbsp;&nbsp;&nbsp;<font color="blue">問題集</font><font color="magenta">＝</font><font color="blue">素材URL</font><font color="black">の</font><font color="#7f00ff">テキスト取得</font><font color="black">から</font><font color="#7f00ff">AJAX_JSON取得</font>。<br>&nbsp;&nbsp;&nbsp;&nbsp;<font color="blue">問題集変更</font><font color="black">して</font><font color="blue">ゲーム開始</font>。<br><font color="magenta">ここまで</font>。</blockquote>

　問題入力をして問題集が変わっている状態で`https://n3s.nadesi.com/image.php?f=384.json`を読み込むことで元の古典問題集に戻すことができました。
　
# そうだ音を鳴らそう！
　折角MML演奏が実装されて、ファイルを用意しなくても音が鳴らせるようになったワケですからそれを利用して効果音を鳴らしてみることにします🎵🎶

👉 **[ 📖 なでしこ3 マニュアル > nadesiko3-music/音楽 ](https://nadesi.com/v3/doc/index.php?nadesiko3-music%2F%E9%9F%B3%E6%A5%BD&show)**

　MML演奏については、アドベントカレンダー４日目でクジラ飛行机氏自らが紹介して下さっておりますので、そちらも合わせてお読み下さい。

https://qiita.com/kujirahand/items/c0b3aa96fd3403396cea

　とりあえず取り込む。

<!--
!『拡張プラグイン:music.js@1.0.2』を取り込む。
-->
<blockquote><font color="magenta">!</font><font color="maroon">『拡張プラグイン:music.js@1.0.2』</font><font color="black">を</font><font color="magenta">取り込む</font></blockquote>

#### プラグイン取り込みの省略記法
　なんと、プラグイン取り込みに省略記法が導入されて、とっても簡単に指定出来るようになっています✨

👉 **[なでしこ3 マニュアル > 文法/プラグイン取込 > 拡張プラグインの省略記法](https://nadesi.com/v3/doc/index.php?%E6%96%87%E6%B3%95%2F%E3%83%97%E3%83%A9%E3%82%B0%E3%82%A4%E3%83%B3%E5%8F%96%E8%BE%BC&show#hd9529db9)**

　貯蔵庫からはNAKO3プラグインが省略記法で取り込めて、JSプラグインは命名規則に沿って作成して公開すると、公式プラグイン以外もこの省略記法で取り込めるようになるってコトなんですね。
　うーん、JSプラグインはnpmで公開したほうがいいってコトなんですかね～？
　これまで、貯蔵庫で使う前提の物は、貯蔵庫から取り込みでいいかと思ってたんですけどね～。

👉 **[なでしこ3 マニュアル > FAQ/作ったプラグインをnpmで公開する方法](https://nadesi.com/v3/doc/index.php?FAQ%2F%E4%BD%9C%E3%81%A3%E3%81%9F%E3%83%97%E3%83%A9%E3%82%B0%E3%82%A4%E3%83%B3%E3%82%92npm%E3%81%A7%E5%85%AC%E9%96%8B%E3%81%99%E3%82%8B%E6%96%B9%E6%B3%95&show)**

　でもとりあえず、まず[npmにユーザー登録(Sign Up)](https://www.npmjs.com/) ができないワタクシですよ😭
　ぐーぐる翻訳さんたすけて‼️
 
　うーん、そのうちがんばる💧

 ### 音を鳴らします
　まあ、それはさておき！
　なにしろMML演奏の素晴らしい点は、「ドレミ」表記で記述出来ることです！(もちろん普通にcdeのMMLでも記述できます)
　というわけで、こんな感じで効果音を設定します。
　センスは無いけどゆるして💧

<!--
＃効果音
正解音＝「音階7 音符32 音量80 ド64レ＃」。
ハズレ音＝「音階3 音符8 ド」。
クリア音＝『音階6 音符16【「ファ"ラド」「ファ"ラド」「ド"ファ"ラ」】「ファ"ラド」ーーーーー』
ゲームオーバー音＝『調♭（ソラシレミ） テンポ 180
トラック1 音階4 シシ8.シ16シ↑レ8.ド16 ド8.↓シ16シ8.シ16シ
トラック2 音階4 音量 60 ファソファソファソファ』
-->
<blockquote><font color="green">＃効果音</font><br><font color="blue">正解音</font><font color="magenta">＝</font><font color="maroon">「音階7&nbsp;音符32&nbsp;音量80&nbsp;ド64レ＃」</font>。<br><font color="blue">ハズレ音</font><font color="magenta">＝</font><font color="maroon">「音階3&nbsp;音符8&nbsp;ド」</font>。<br><font color="blue">クリア音</font><font color="magenta">＝</font><font color="maroon">『音階6&nbsp;音符16【「ファ"ラド」「ファ"ラド」「ド"ファ"ラ」】「ファ"ラド」ーーーーー』</font><br><font color="blue">ゲームオーバー音</font><font color="magenta">＝</font><font color="maroon">『調♭（ソラシレミ）&nbsp;テンポ&nbsp;180<br>トラック1&nbsp;音階4&nbsp;シシ8.シ16シ↑レ8.ド16&nbsp;ド8.↓シ16シ8.シ16シ<br>トラック2&nbsp;音階4&nbsp;音量&nbsp;60&nbsp;ファソファソファソファ』</font></blockquote>

　あとは、マウス押したときのイベントと、終了判定にMML演奏を追加するだけです！

<!--
描画中キャンバスをマウス押した時には、
    列,行＝マウス位置取得。
//　～～～　中略　～～～
    もし、ゲーム中フラグ＝オフならば、戻る。
    もし、拾えるデータ[行][列]＝1ならば、
        正解音をMML演奏。
        現在データ[行][列]＝0。
        進行方向＝[列,行]の進行方向更新。
        拾った履歴に[列,行,進行方向]を配列追加。
        進行方向と[列,行]から拾えるデータ更新。
    違えば、
        ハズレ音をMML演奏。
    ここまで。
    盤面描画。0.1秒待つ。終了判定。
ここまで。
-->
<blockquote><font color="#7f00ff">描画中キャンバス</font><font color="black">を</font><font color="#7f00ff">マウス押した時</font><font color="black">には</font>、<br>&nbsp;&nbsp;&nbsp;&nbsp;<font color="blue">列</font>,<font color="blue">行</font><font color="magenta">＝</font><font color="blue">マウス位置取得</font>。<br><font color="green">//　～～～　中略　～～～</font><br>&nbsp;&nbsp;&nbsp;&nbsp;<font color="magenta">もし</font>、<font color="blue">ゲーム中フラグ</font><font color="magenta">＝</font><font color="#7f00ff">オフ</font><font color="black">ならば</font>、<font color="magenta">戻る</font>。<br>&nbsp;&nbsp;&nbsp;&nbsp;<font color="magenta">もし</font>、<font color="blue">拾えるデータ</font><font color="magenta">[</font><font color="blue">行</font><font color="magenta">]</font><font color="magenta">[</font><font color="blue">列</font><font color="magenta">]</font><font color="magenta">＝</font><font color="red">1</font><font color="black">ならば</font>、<br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<font color="blue">正解音</font><font color="black">を</font><font color="blue">MML演奏</font>。<br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<font color="blue">現在データ</font><font color="magenta">[</font><font color="blue">行</font><font color="magenta">]</font><font color="magenta">[</font><font color="blue">列</font><font color="magenta">]</font><font color="magenta">＝</font><font color="red">0</font>。<br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<font color="blue">進行方向</font><font color="magenta">＝</font><font color="magenta">[</font><font color="blue">列</font>,<font color="blue">行</font><font color="magenta">]</font><font color="black">の</font><font color="blue">進行方向更新</font>。<br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<font color="blue">拾った履歴</font><font color="black">に</font><font color="magenta">[</font><font color="blue">列</font>,<font color="blue">行</font>,<font color="blue">進行方向</font><font color="magenta">]</font><font color="black">を</font><font color="#7f00ff">配列追加</font>。<br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<font color="blue">進行方向</font><font color="black">と</font><font color="magenta">[</font><font color="blue">列</font>,<font color="blue">行</font><font color="magenta">]</font><font color="black">から</font><font color="blue">拾えるデータ更新</font>。<br>&nbsp;&nbsp;&nbsp;&nbsp;<font color="magenta">違えば</font>、<br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<font color="blue">ハズレ音</font><font color="black">を</font><font color="blue">MML演奏</font>。<br>&nbsp;&nbsp;&nbsp;&nbsp;<font color="magenta">ここまで</font>。<br>&nbsp;&nbsp;&nbsp;&nbsp;<font color="blue">盤面描画</font>。<font color="blue">0.1秒待つ</font>。<font color="blue">終了判定</font>。<br><font color="magenta">ここまで</font>。</blockquote>

 　再生の反応もよく、効果音として十分に機能していますよ‼️🎶

 <!--
●終了判定
    現在データと空データが同じ配列か確認。
    もし、それ＝はいならば、:
        クリア音をMML演奏
        「クリア！」と言う。
        ゲーム中フラグ＝オフ。戻る。
    拾えるデータと空データが同じ配列か確認。
    もし、それ＝はいならば、:
    　　ゲームオーバー音をMML演奏。
        「失敗！」と言う。
        ゲーム中フラグ＝オフ。戻る。
ここまで。
 -->
<blockquote><strong><font color="magenta">●終了判定</font></strong><br>&nbsp;&nbsp;&nbsp;&nbsp;<font color="blue">現在データ</font><font color="black">と</font><font color="blue">空データ</font><font color="black">が</font><font color="blue">同じ配列か確認</font>。<br>&nbsp;&nbsp;&nbsp;&nbsp;<font color="magenta">もし</font>、<font color="magenta">それ</font><font color="magenta">＝</font><font color="#7f00ff">はい</font><font color="black">ならば</font>、<font color="magenta">:<br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</font><font color="blue">クリア音</font><font color="black">を</font><font color="blue">MML演奏</font><br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<font color="maroon">「クリア！」</font><font color="black">と</font><font color="#7f00ff">言う</font>。<br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<font color="blue">ゲーム中フラグ</font><font color="magenta">＝</font><font color="#7f00ff">オフ</font>。<font color="magenta">戻る</font>。<br>&nbsp;&nbsp;&nbsp;&nbsp;<font color="blue">拾えるデータ</font><font color="black">と</font><font color="blue">空データ</font><font color="black">が</font><font color="blue">同じ配列か確認</font>。<br>&nbsp;&nbsp;&nbsp;&nbsp;<font color="magenta">もし</font>、<font color="magenta">それ</font><font color="magenta">＝</font><font color="#7f00ff">はい</font><font color="black">ならば</font>、<font color="magenta">:<br>&nbsp;&nbsp;&nbsp;&nbsp;　　</font><font color="blue">ゲームオーバー音</font><font color="black">を</font><font color="blue">MML演奏</font>。<br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<font color="maroon">「失敗！」</font><font color="black">と</font><font color="#7f00ff">言う</font>。<br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<font color="blue">ゲーム中フラグ</font><font color="magenta">＝</font><font color="#7f00ff">オフ</font>。<font color="magenta">戻る</font>。<br><font color="magenta">ここまで</font>。</blockquote>

　・・・あれ？

### ダイアログとMML演奏を同時に使う場合
　注意点としては、`言う`などのダイアログを使用すると、先に`MML演奏`があってもダイアログの方が先に開いてしまいます。そして、ダイアログが閉じてから演奏が始まります。
<!--
!『拡張プラグイン:music.js』を取り込む
「ドレミファソラシ↑ド」をMML演奏。
「OK」を言う。
-->
<blockquote><font color="magenta">!</font><font color="maroon">『拡張プラグイン:music.js』</font><font color="black">を</font><font color="magenta">取り込む</font><br><font color="maroon">「ドレミファソラシ↑ド」</font><font color="black">を</font><font color="blue">MML演奏</font>。<br><font color="maroon">「OK」</font><font color="black">を</font><font color="#7f00ff">言う</font>。</blockquote>

　演奏後すぐに次の命令が実行されるのはある意味当然で、そうでなければＢＧＭなどとして使うことが出来ないですからね～。
　でも、ダイアログが演奏を止めてしまうので困ったなと言うところ。
　感覚的にはやはり、クリアしたら先に曲が鳴って、それからダイアログじゃないですか？

　ちなみに、`オーディオ再生`の場合はどうかというと、Firefoxの場合はイイ感じに再生されつつダイアログも開くのですが、chrome系の場合はご同様にダイアログが先に開き、閉じてから再生が始まります💧
　しかし、chrome系も、`オーディオ再生`と`言う`の間に`秒待つ`でごく短いウェイトを入れてやることで、Firefox同様ダイアログ開きつつ再生させることが出来ますし、オーディオ命令の中には`オーディオ長さ取得`があり、取得した秒数だけウェイトを入れてやることで曲が再生し終わった後でダイアログを開くことも出来ます。

　がっ！
　`MML演奏`はまた動作が異なりました。
　曲より短いウェイトを入れた場合、その秒数分だけ再生されてダイアログが上がり、曲が中断されてしまいます＞＜
　そして、ダイアログを閉じるとFirefoxの場合は続きが演奏され、chromeは演奏されませんでした。
　ダイアログの動作はブラウザごと仕様が違っててめんどくさい～😣
　でも、どちらにしてもダイアログを開きつつ演奏もさせるというのは難しそうです。

　ならばやはり、曲を再生してからダイアログとしたい。
　でも、音楽命令の中に曲の長さを取得する命令はありません。
　しょうがない、ちょっと自分で計算してみよう。

### 曲の長さを計算
　特に指定をしていなければ、テンポのデフォルトは120、音符は四分音符です。
　テンポとは1分間に四分音符が何個入るかなので、テンポ120なら1分間に四分音符が120入る速さです。
 `60÷120`で、0.5が四分音符一個の長さとなり、ドレミファソラシドの8音なら4秒という計算になるはずです。

<!--
!『拡張プラグイン:music.js』を取り込む
「ドレミファソラシ↑ド」をMML演奏。
4秒待つ。
「OK」を言う。
-->
<blockquote><font color="magenta">!</font><font color="maroon">『拡張プラグイン:music.js』</font><font color="black">を</font><font color="magenta">取り込む</font><br><font color="maroon">「ドレミファソラシ↑ド」</font><font color="black">を</font><font color="blue">MML演奏</font>。<br><font color="blue">4秒待つ</font>。<br><font color="maroon">「OK」</font><font color="black">を</font><font color="#7f00ff">言う</font>。</blockquote>

　あれー？
　良いかと思いきや、ダイアログ閉じた後にちょっと鳴る～💧
　残響というか余韻というかの分を考慮しなきゃなようです。
　とりあえず1秒くらいプラスしておく。

<!--
●終了判定
    現在データと空データが同じ配列か確認。
    もし、それ＝はいならば、:
        ゲーム中フラグ＝オフ。
        クリア音をMML演奏。
        60/120*3+1秒待つ
        「クリア！」と言う。
        戻る。
    拾えるデータと空データが同じ配列か確認。
    もし、それ＝はいならば、:
        ゲーム中フラグ＝オフ。
        ゲームオーバー音をMML演奏。
        60/180*7+1秒待つ。
        「失敗！」と言う。
        戻る。
ここまで。
-->
<blockquote><strong><font color="magenta">●終了判定</font></strong><br>&nbsp;&nbsp;&nbsp;&nbsp;<font color="blue">現在データ</font><font color="black">と</font><font color="blue">空データ</font><font color="black">が</font><font color="blue">同じ配列か確認</font>。<br>&nbsp;&nbsp;&nbsp;&nbsp;<font color="magenta">もし</font>、<font color="magenta">それ</font><font color="magenta">＝</font><font color="#7f00ff">はい</font><font color="black">ならば</font>、<font color="magenta">:<br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</font><font color="blue">ゲーム中フラグ</font><font color="magenta">＝</font><font color="#7f00ff">オフ</font>。<br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<font color="blue">クリア音</font><font color="black">を</font><font color="blue">MML演奏</font>。<br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<font color="red">60</font><font color="magenta">/</font><font color="red">120</font><font color="magenta">*</font><font color="red">3</font><font color="magenta">+</font><font color="blue">1秒待つ</font><br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<font color="maroon">「クリア！」</font><font color="black">と</font><font color="#7f00ff">言う</font>。<br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<font color="magenta">戻る</font>。<br>&nbsp;&nbsp;&nbsp;&nbsp;<font color="blue">拾えるデータ</font><font color="black">と</font><font color="blue">空データ</font><font color="black">が</font><font color="blue">同じ配列か確認</font>。<br>&nbsp;&nbsp;&nbsp;&nbsp;<font color="magenta">もし</font>、<font color="magenta">それ</font><font color="magenta">＝</font><font color="#7f00ff">はい</font><font color="black">ならば</font>、<font color="magenta">:<br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</font><font color="blue">ゲーム中フラグ</font><font color="magenta">＝</font><font color="#7f00ff">オフ</font>。<br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<font color="blue">ゲームオーバー音</font><font color="black">を</font><font color="blue">MML演奏</font>。<br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<font color="red">60</font><font color="magenta">/</font><font color="red">180</font><font color="magenta">*</font><font color="red">7</font><font color="magenta">+</font><font color="blue">1秒待つ</font>。<br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<font color="maroon">「失敗！」</font><font color="black">と</font><font color="#7f00ff">言う</font>。<br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<font color="magenta">戻る</font>。<br><font color="magenta">ここまで</font>。</blockquote>

　だいたい良い感じ？
　完全に残響が消えるまでとしてしまうとダイアログ開くのがのろくさい印象になるので、こんなものかと思います。

# おわります

　できました‼️　完成です✨
　ムダに引っ張りましたが、なでしこの新機能のダイアログキャンセル値の紹介や、MML演奏を効果音として使えるか試したり、自作のプラグインも実際に使ってみたりと頑張りました。

　長くなったので、コードはこちらから確認して下さい～。
　遊んでみて下さいね☆

 https://n3s.nadesi.com/id.php?2709

　その後、効果音をオンオフするチェックを加えたり、問題作成や問題データ取り込みのUIを開閉出来るようにしたりしなどしています。