================================================================================ ezlocal-dish-js モジュール Version 2.1 Copyright(C) 2024 MIZUSHIKI ================================================================================ - 概要 -------------------------------------------------------------------------------- HSP3Dish.js をローカルで動作させる為の環境を構築、簡単にテストできるようにします 。 また、HSP3Dish helper の実行補助、出力HTMLの調整、nginx(ローカルサーバ)の起動、 テスト用ディレクトリへのファイルコピー、ローカル実行URLのリンク表示も行います。 QRコードを利用してスマホからローカル実行URLへ簡単にアクセスできます。 さらに、ランキング作成などが簡単になるPHP連携モジュールezphp.phpを同梱。 簡単にサーバへのテキスト保存またはSQLiteデータベース記録ができるようになります。 - 使い方 -------------------------------------------------------------------------------- #include "hsp3dish.as" #include "ezlocal-dish-js.hsp" ezLocalJS hsp3dish.as をインクルードした行のすぐ後で ezlocal-dish-js.hspをインクルードし、 ezLocalJS を実行してください。 -- 注意 ------------------------------------------------------------------------------ ezlocal-dish-js.hsp の中で通常ランタイムに上書き(#runtime "")しています。 このモジュールを使用しないときは ezLocalJS の行だけでなく #include "ezlocal-dish-js.hsp" の行もコメントアウトしてください。 - 対象HSP3バージョン -------------------------------------------------------------------------------- ・推奨： HSP3最新バージョン (β版も含むその時の最新版) ・動作可能： HSP3.51 ～ 但し HSP3.6, HSP3.7β1, HSP3.7β2 は「ブラウザ上にデータ保存できるようにする」が 使えません。 同梱サンプルはなるべくHSP3の最新バージョンでお試しください。 (テスト時のバージョンは HSP3.7β9 です。) 特に sample2, sample3 はブラウザへのデータ保存に依存した処理があるため HSP3.7β3 以降を使用してください。 - インストールされる環境について -------------------------------------------------------------------------------- -- nginx ------------------------------------------------------------------------------ フリーでオープンソースなWebサーバアプリケーション - 製作者： Igor Sysoev (Nginx Inc.) - 公式サイト： https://nginx.org - 保存場所： C:\nginx -- PHP-FPM ------------------------------------------------------------------------------ PHP実行方式の一つ。FastCGIプロトコルを介してWebサーバーと通信して処理を行う - 著作： Copyright © 2001-2024 The PHP Group - 頒布先： https://windows.php.net/download/ - 追加モジュール： bz2,curl,fileinfo,gettext,mbstring,exif,mysqli,pdo_mysql, pdo_sqlite,sqlite3 - 保存場所： C:\nginx\php - 環境のアンインストールについて -------------------------------------------------------------------------------- インストールする nginx はレジストリを書き換えません。 「C:\nginx」フォルダを削除すればアンインストール完了です。 PHP-FPMも「C:\nginx\php」に保存しているので一緒に消えます。 - オプションについて -------------------------------------------------------------------------------- hsp3dish.ini内の「; ezlocal-dish-js settings」で区切ったその下に ezlocal-dish-js 専用のオプション値を保存させてもらっています。 HTML調整オプションの中に「出力HTMLにスマホ表示等の調整を行う」がありますが、これ を指定するとHTMLソースにいくつかの調整を行います。 hsp3dish.ini内に下記のコマンドを書き込むことで調整を行うかどうかを個別に取捨選択 することができます。 「noAdj_***=1」を書き込むことで以下で解説している調整をしないようになります。 -- noAdj_border=1 ------------------------------------------------------------------------------ ゲーム画面の周りを囲んでいる線を消しています。 -- noAdj_controls=1 ------------------------------------------------------------------------------ 「Downloading...」などのステータス表示部分をゲームロード後に消しています。 また、昔名残のコントロールの残骸も邪魔になることがあるので消しています。 -- noAdj_systembox=1 ------------------------------------------------------------------------------ 下部に表示されている黒いシステムメッセージボックスを非表示にしています。 ただし、「#Error」が表示されるときは再表示するようになっています。 また、「デバッグ情報を出力する」を指定している場合はエラーではないメッセージが 表示されるときも再表示するようになっています。 -- noAdj_mobile=1 ------------------------------------------------------------------------------ スマホやタブレットでページを表示したときに画面いっぱいに広がるように表示解像度 を調整しています。 - ブラウザへのデータ保存の仕方 -------------------------------------------------------------------------------- HTML調整オプション「ブラウザ上にデータ保存できるようにする」を指定するとsaveフォ ルダのような物が作られアクセスできるようになります。 ・「save/ファイル名」を指定してテキスト等を保存できる。 フォルダを含めたファイルパスを指定する場合「\\」ではなく「/」でないと駄目なよ うだが「chdir "save" : notesave "frame.txt"」は可能。 ・保存を有効にするために必ず「devcontrol "syncfs"」を実行する必要がある。 ・ブラウザに保存されているデータを確認したい場合は、ブラウザの メニュー＞その他 のツール＞開発者ツール を起動。(ここではMicrosoft Edgeで説明) 「要素」「コンソール」などの並びの後ろのほうにある「アプリケーション」タブを開 き ストレージ＞IndexedDB＞/save＞FILE_DATA を確認すると「キー」と「値」が表示 され、これが「ファイル名」と「データ」に相当する。 「contents: Int8Array」のところでメモリダンプのような形で確認でき、その行の右 端の方にある小さいアイコン「メモリインスペクターパネルで表示」をクリックすると 画面下部に詳細が表示される。 アルファベットなどは確認できるが日本語は表示されない。メモリを見るにUTF-8文字 列で保存されている模様。ここに表示されないだけで日本語でもちゃんと取り出せる。 -- ★★ 注意 ★★ ------------------------------------------------------------------------------ どうやら保存した文章中に「'」シングルクォーテーションがあると読み込みの際にフ リーズしてしまうようです。。。慎重に取り扱ってください。 - 同梱物 ezphp.php による テキスト保存, データベース編集 について -------------------------------------------------------------------------------- phpを介してテキスト保存/読込とsqlite編集を行う簡易的なサンプルを同梱しています。 mod_ezphp.hsp内にヘルプが記載されており、commonフォルダに置けばF1ヘルプでも参照 できます。 具体的な使い方はサンプルの sample2_～.hsp, sample3_～.hsp を参照してください。 また、SQLiteのデータベースファイルは簡単に中を見れたり編集できるフリーソフトがあ るので活用してみてください。 ・#include "mod_ezphp.hsp" があれば、ezphp.php もテスト用ディレクトリにコピーさ れるようになっています。 - 使用ライブラリ -------------------------------------------------------------------------------- qrcodelib.dll _ Copyright (C) 2006-2018 Kentaro Fukuchi QRコードを生成するための高速かつコンパクトなライブラリ ・ライセンス ：GNU Lesser General Public License (LGPL) ・バイナリ頒布先： http://code.google.com/p/qrencode-win32/ ・ソースコード ： https://github.com/fukuchi/libqrencode ・HSP3コード参考： https://codetter.com/?p=525 * ezlocal-dish-jsモジュール内にも文字列データ化したdllを内包。モジュールファイル だけでdllが見つからないときはdllをカレントディレクトリに吐き出して保存します。 文字列データ化と吐き出し方については以下を参考にしました。ありがとうございます。 mod_MSZip : Cabinet.dllを使用した圧縮解凍モジュール - HSPメモ帳 (Hiro さん) - https://blog.goo.ne.jp/hiro239415/e/fe657bd57b6d2de0c4855c0578452dd9 - ezlocal-dish-js ver.1.1 までの XAMPP について -------------------------------------------------------------------------------- ローカルサーバ環境 nginx 採用前の ポータブル版XAMPP(C:\XAMPP-portable) が残って いる場合はフォルダを削除してください。 ポータブル版なのでレジストリは書き換えられていません。フォルダを削除すればアンイ ンストールは完了です。 - 免責、著作権、連絡先 -------------------------------------------------------------------------------- -- 免責 ------------------------------------------------------------------------------ 作者は、本モジュールの使用または使用不能から生じるコンピュータの故障、情報の消 失、その他あらゆる直接的及び間接的被害に関して一切の責任を負いません。 これに同意できない場合、本モジュールの使用を禁止します。 -- 著作権 ------------------------------------------------------------------------------ 著作権は作者である MIZUSHIKI が所有します。 Copyright(C) 2024 MIZUSHIKI -- 連絡先 ------------------------------------------------------------------------------ [作者メールアドレス] suwa.mizushiki@gmail.com ================================================================================ - Changelogs -------------------------------------------------------------------------------- 2.1 2024/ 9/10 --------------------- - PHP-FPM(PHP実行環境)もインストールすることにした - ezphp.phpや新規サンプル(sample2,sample3)を追加同梱 - オプションにスマホ横向き全画面FIT(β機能)を追加。サンプル(sample4)追加同梱。 - オプションの表示解像度調整対象からタブレットを除外 - その他の細かい箇所の変更と修正 2.0.1 2024/ 8/26 --------------------- - ローカルIP取得が上手くいかないことがあったのでWi-Fi項目を優先取得に修正 2.0 2024/ 8/23 --------------------- - インストールするローカルサーバ環境をXAMPPからnginxに変更 - 127.0.0.1(localhost)のrootフォルダをデフォルト値でなく設定値を調べるようにした - IPv4アドレスの取得を英語版でも取得できるように修正 - その他の細かい箇所の変更と修正 1.1 2024/ 8/20 --------------------- - 二重起動防止の方法を起動させないのでなく前回のウィンドウを消すことに変更 - HTML調整でシステムメッセージとコントロール非表示のタイミングを変更 - HTML調整で画面サイズに合わせた表示解像度化をスマホだけでなくタブレットにも適用 - 画面サイズ指定されてることが明らかなのにhsp3dish.iniがない場合に警告を表示 - hsp3dish.iniオプションのsx,syに文字列の指定も可能にした - hsp3dish.ini作成時やdataファルダの有無注意喚起時にdotfw.asを考慮するようにした - hspinet,mod_regexpを独自関数登録していたがincludeに戻した - その他の細かい箇所の変更と修正 1.0.1 2024/ 8/18 --------------------- - hsドキュメント追加(モジュール内) - オプションの非対象バージョン時OFFと変数定義位置修正 1.0 2024/ 8/16 --------------------- - 公開 ================================================================================