danoniplus 49.6.0 → 50.0.0

package/js/danoni_main.js

@@ -4,12 +4,12 @@
  * 
  * Source by tickle
  * Created : 2018/10/08
- * Revised : 2026/08/16
+ * Revised : 2026/08/24
  *
  * https://github.com/cwtickle/danoniplus
  */
-const g_version = `Ver 49.6.0`;
-const g_revisedDate = `2026/08/16`;
+const g_version = `Ver 50.0.0`;
+const g_revisedDate = `2026/08/24`;
 
 // カスタム用バージョン (danoni_custom.js 等で指定可)
 let g_localVersion = ``;
@@ -135,6 +135,19 @@ let g_fps = 60;
 // プレイ画面再生時の内部スケジューリング用のマージン時間(100ms)
 let g_scheduleLead = 0.1;
 
+// フレーム進行を音源クロック(AudioContext.currentTime)基準で補正するか
+// - false の場合は従来通り performance.now() 基準で動作
+let g_audioClockSync = true;
+
+// 出力遅延(AudioContext.outputLatency)をタイミング補正に含めるか
+// - true にすると出力デバイス(有線/Bluetooth等)によらず同じAdjustmentが使えるが、
+//   既存のAdjustment設定値と互換性がなくなるため既定は false
+let g_audioLatencyCompensation = false;
+
+// 次フレームまでの待機時間の上限(ms)
+// - 音源クロックが一時的に停止した際に待ち続けないようにするための保険
+let g_maxFrameWait = 50;
+
 // 譜面データの&区切りを有効にするか
 let g_enableAmpersandSplit = true;
 
@@ -2562,6 +2575,7 @@ class AudioPlayer {
 		this._gain = this._context.createGain();
 		this._gain.connect(this._context.destination);
 		this._startTime = 0;
+		this._scheduledTime = 0;
 		this._fadeinPosition = 0;
 		this._eventListeners = {};
 		this.playbackRate = 1;
@@ -2586,17 +2600,25 @@ class AudioPlayer {
 	 * - scheduleLead は安定した再生タイミングを確保するための内部マージン
 	 */
 	play(_adjustmentTime = 0) {
+		// AudioContextの時計は1回だけ読み、以降はその値を使い回す
+		// - currentTimeはレンダークォンタム単位でしか進まないため、複数回読むと
+		//   予約時刻と論理開始時刻が最大1クォンタム分ずれる
+		const ctxNow = this._context.currentTime;
+
 		this._source = this._context.createBufferSource();
 		this._source.buffer = this._buffer;
 		this._source.playbackRate.value = this.playbackRate;
 		this._source.connect(this._gain);
 
 		// 実際の予約時刻（内部スケジューリング用のマージンを含む）
-		const startAt = this._context.currentTime + g_scheduleLead + _adjustmentTime;
+		const startAt = ctxNow + g_scheduleLead + _adjustmentTime;
 		this._source.start(startAt, this._fadeinPosition);
 
 		// ゲーム側の論理的開始時刻（g_scheduleLead を含めない）
-		this._startTime = this._context.currentTime + _adjustmentTime;
+		this._startTime = ctxNow + _adjustmentTime;
+
+		// 実際に音が鳴り始めるAudioContext上の時刻（フレーム同期の基準）
+		this._scheduledTime = startAt;
 	}
 
 	pause() {
@@ -2621,6 +2643,26 @@ class AudioPlayer {
 		return this._context.currentTime - this._startTime + this._fadeinPosition;
 	}
 
+	/** AudioContextの現在時刻(秒) */
+	get contextTime() {
+		return this._context.currentTime;
+	}
+
+	/** 実際に音が鳴り始めるAudioContext上の時刻(秒) */
+	get scheduledTime() {
+		return this._scheduledTime;
+	}
+
+	/** 音が出力デバイスから実際に出るまでの遅延(秒) */
+	get outputLatency() {
+		return this._context.outputLatency || this._context.baseLatency || 0;
+	}
+
+	/** AudioContextの状態(running / suspended / closed) */
+	get contextState() {
+		return this._context.state;
+	}
+
 	set currentTime(_currentTime) {
 		this._fadeinPosition = _currentTime;
 	}
@@ -2708,6 +2750,37 @@ const getSharedAudioContext = () => {
 	return g_sharedAudioContext;
 };
 
+/**
+ * AudioContextのウォームアップ
+ * - 生成直後・resume直後のAudioContextは出力デバイスの起動待ちのため、
+ *   しばらく currentTime が進まない(環境により数十〜数百ms)
+ * - この状態で音源をスケジュールすると、起動に要した時間がそのまま
+ *   音源と譜面のずれになるため、無音を1回鳴らして時計が動き出すまで待つ
+ * @returns {Promise<void>}
+ */
+const warmUpAudioContext = async () => {
+	const ctx = getSharedAudioContext();
+	if (ctx.state !== `running`) {
+		await ctx.resume().catch(() => { });
+	}
+	if (ctx.state !== `running`) {
+		return; // ジェスチャー未取得等でresumeできない場合は何もしない
+	}
+
+	// 無音を1サンプルだけ鳴らして出力デバイスを起動させる
+	const source = ctx.createBufferSource();
+	source.buffer = ctx.createBuffer(1, 1, ctx.sampleRate);
+	source.connect(ctx.destination);
+	source.start();
+
+	// currentTimeが実際に進み始めるまで待機(最大500ms)
+	const baseTime = ctx.currentTime;
+	const limitTime = performance.now() + 500;
+	while (ctx.currentTime === baseTime && performance.now() < limitTime) {
+		await new Promise(resolve => setTimeout(resolve, 10));
+	}
+};
+
 /**
  * クリップボードコピー関数
  * 入力値をクリップボードへコピーし、メッセージを表示
@@ -8388,6 +8461,7 @@ const setDifficulty = (_initFlg) => {
 
 	// ユーザカスタムイベント(初期)
 	safeExecuteCustomHooks(`g_customJsObj.difficulty`, g_customJsObj.difficulty, _initFlg, g_canLoadDifInfoFlg);
+	resolveKeyFamily();
 
 	// 設定サマリー表示の更新
 	updateSettingSummary();
@@ -8397,6 +8471,77 @@ const setDifficulty = (_initFlg) => {
 	g_canLoadDifInfoFlg = true;
 };
 
+/**
+ * keyLabelの系統ごとに、選択時に強制したい設定値・選択/離脱時の個別処理を登録する
+ * @param {string} _name 系統名
+ * @param {(key: string) => boolean} _match この系統に属するkeyLabelかどうか
+ * @param {object} [_fields] path -> 値 or 値を返す関数（単純代入で済むもの）
+ * @param {object} [_hooks] { onAcquire, onRelease } 選択/離脱の瞬間に1回だけ呼ばれる（複合処理用）
+ * @param {object} [_appliers] path -> 個別の適用関数（単純代入で済まないfields用）
+ */
+const registerKeyFamily = (_name, _match, _fields = {}, _hooks = {}, _appliers = {}) => {
+	g_familyObj.families.push({ name: _name, match: _match, fields: _fields, appliers: _appliers, ..._hooks });
+};
+
+/**
+ * 現在のキー状態に応じて適用すべき設定群を判定し、
+ * 各パラメータの値・スナップショット・フックを管理・適用する
+ */
+const resolveKeyFamily = () => {
+	// 1. 現在のキーに一致するファミリーを検索（見つからなければ null ＝ 標準状態）
+	const newFamily = g_familyObj.families.find(f => f.match(g_keyObj.currentKey)) ?? null;
+
+	// 2. ファミリーが切り替わった瞬間（入場・離脱）にフック（固有の副作用）を実行
+	if (newFamily !== g_familyObj.currentFamily) {
+		g_familyObj.currentFamily?.onRelease?.();
+		newFamily?.onAcquire?.();
+		g_familyObj.currentFamily = newFamily;
+	}
+
+	// 3. 登録されているすべてのファミリーが持つパス（プロパティ）の全リストを取得
+	const allPaths = new Set(g_familyObj.families.flatMap(f => Object.keys(f.fields)));
+	allPaths.forEach(path => {
+		const spec = newFamily?.fields[path];
+		// 該当プロパティのカスタム処理があれば優先し、なければ通常のプロパティ代入を使用
+		const applier = g_familyObj.families.map(f => f.appliers[path]).find(Boolean) ?? (v => setPathVal(path, v));
+
+		if (spec !== undefined) {
+			// 【変更値の適用】現在のファミリーにそのプロパティの設定がある場合
+			// 初めて書き換えるプロパティの場合のみ、元の値をスナップショット（初期値）として退避
+			if (!g_familyObj.ownership[path]) {
+				g_familyObj.snapshot[path] = getPathVal(path);
+				g_familyObj.ownership[path] = true;
+			}
+			// 関数なら評価し、値ならそのまま適用値とする
+			applyIfChanged(path, typeof spec === `function` ? spec() : spec, applier);
+		} else if (g_familyObj.ownership[path]) {
+			// 【標準への復元】別のファミリーに移行し、かつ元々自分が書き換えていたプロパティの場合
+			// スナップショットから元の値（初期値）を復元し、オーナーシップを解放
+			applyIfChanged(path, g_familyObj.snapshot[path], applier);
+			g_familyObj.ownership[path] = false;
+		}
+		// ownership[path]がfalseのままなら、標準同士の切り替えでも一切触らない
+	});
+};
+
+/**
+ * 値に変更がある場合のみ、代入またはカスタム処理を実行してキャッシュを更新する
+ * @param {string} _path 設定のパス
+ * @param {string|number} _value 適用する値
+ * @param {Function} _applier 実際の適用処理を行う関数
+ */
+const applyIfChanged = (_path, _value, _applier) => {
+	// すでに同じ値が適用済みの場合は、無駄な再描画や再代入を防ぐためスキップ
+	if (g_familyObj.appliedPaths.has(_path) && g_familyObj.applied[_path] === _value) return;
+
+	// 適用値をキャッシュに保存
+	g_familyObj.applied[_path] = _value;
+	g_familyObj.appliedPaths.add(_path);
+
+	// 実際の反映処理（値の代入、または画像再描画などの副作用）を実行
+	_applier(_value);
+};
+
 /**
  * 設定・オプション画面のラベル・ボタン処理の描画
  * @param {Object} _sprite 基準とするスプライト(ここで指定する座標は、そのスプライトからの相対位置)
@@ -12208,6 +12353,9 @@ const loadMusic = async () => {
 	}
 
 	if (loadSucceeded) {
+		// 初回プレイ時に出力デバイスの起動待ちでずれるのを防ぐため、
+		// メイン画面へ移行する前にAudioContextを起動させておく
+		await warmUpAudioContext();
 		mainInit(); // 音源・譜面変換双方の完了後にまとめて呼ぶ
 	}
 };
@@ -14964,6 +15112,7 @@ const mainInit = () => {
 	let thisTime;
 	let buffTime;
 	let musicStartTime;
+	let musicStartCtxTime;
 	let musicStartFlg = false;
 
 	g_inputKeyBuffer = {};
@@ -16197,14 +16346,32 @@ const mainInit = () => {
 			}
 
 			// 60fpsから遅延するため、その差分を取って次回のタイミングで遅れをリカバリする
+			// - WebAudioAPI使用時は音源クロック(AudioContext.currentTime)を基準とする
+			//   performance.now()とAudioContextの時計は独立して進むため、後者を基準にしないと
+			//   再生開始時のオフセットずれやsuspend/resumeによるずれを吸収できない
 			thisTime = performance.now();
 			buffTime = 0;
-			if (g_audio instanceof AudioPlayer || currentFrame >= musicStartFrame) {
+			let holdFrame = false;
+
+			if (g_audio instanceof AudioPlayer && g_audioClockSync && musicStartCtxTime !== undefined) {
+				if (g_audio.contextState === `running`) {
+					buffTime = (g_audio.contextTime - musicStartCtxTime) * 1000
+						- (currentFrame - musicStartFrame) * 1000 / g_fps;
+				} else {
+					// AudioContext停止中は音源も止まっているため、フレーム進行も止めて復帰を待つ
+					getSharedAudioContext(); // suspended時はresumeを試行
+					holdFrame = true;
+				}
+			} else if (g_audio instanceof AudioPlayer || currentFrame >= musicStartFrame) {
 				buffTime = (thisTime - musicStartTime - (currentFrame - musicStartFrame) * 1000 / g_fps);
 			}
-			g_scoreObj.frameNum++;
-			g_scoreObj.baseFrame++;
-			g_timeoutEvtId = setTimeout(flowTimeline, 1000 / g_fps - buffTime);
+
+			if (!holdFrame) {
+				g_scoreObj.frameNum++;
+				g_scoreObj.baseFrame++;
+			}
+			g_timeoutEvtId = setTimeout(flowTimeline, holdFrame ? g_maxFrameWait :
+				Math.min(Math.max(1000 / g_fps - buffTime, 0), g_maxFrameWait));
 		}
 	};
 	safeExecuteCustomHooks(`g_skinJsObj.main`, g_skinJsObj.main);
@@ -16217,6 +16384,11 @@ const mainInit = () => {
 		const musicStartAdjustment = (g_headerObj.blankFrame - g_stateObj.decimalAdjustment + 1) / g_fps;
 		musicStartTime = performance.now() + (musicStartAdjustment + g_scheduleLead) * 1000;
 		g_audio.play(musicStartAdjustment);
+
+		// 音源クロック基準の開始時刻(フレーム進行の基準)
+		// - g_audioLatencyCompensationが有効な場合は出力遅延分だけ表示を後ろへずらす
+		musicStartCtxTime = g_audio.scheduledTime
+			+ (g_audioLatencyCompensation ? g_audio.outputLatency : 0);
 	}
 
 	g_timeoutEvtId = setTimeout(flowTimeline, 1000 / g_fps);

package/js/lib/danoni_constants.js

@@ -5,7 +5,7 @@
  *
  * Source by tickle
  * Created : 2019/11/19
- * Revised : 2026/08/16 (v49.6.0)
+ * Revised : 2026/08/24 (v50.0.0)
  *
  * https://github.com/cwtickle/danoniplus
  */
@@ -5273,6 +5273,27 @@ const g_skinJsObj = {
     result: [],
 };
 
+const g_root = {
+    get g_diffObj() { return g_diffObj; },
+    get g_posObj() { return g_posObj; },
+    get g_headerObj() { return g_headerObj; },
+    get g_stateObj() { return g_stateObj; },
+    get g_keycons() { return g_keycons; },
+};
+const getPathVal = _path => _path.split(`.`).reduce((o, k) => o?.[k], g_root);
+const setPathVal = (_path, _value) => {
+    const keys = _path.split(`.`);
+    const last = keys.pop();
+    const target = keys.reduce((o, k) => o?.[k], g_root);
+    if (target == null || !Object.hasOwn(target, last)) {
+        console.warn(`setPathVal: path not found for "${_path}"`);
+        return;
+    }
+    target[last] = _value;
+};
+
+const g_familyObj = { families: [], currentFamily: null, ownership: {}, snapshot: {}, applied: {}, appliedPaths: new Set() };
+
 const g_errorCache = {
     'g_customJsObj.titleEnterFrame': [],
     'g_customJsObj.mainEnterFrame': [],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "danoniplus",
-  "version": "49.6.0",
+  "version": "50.0.0",
   "description": "Dancing☆Onigiri (CW Edition) - Web-based Rhythm Game",
   "main": "./js/danoni_main.js",
   "jsdelivr": "./js/danoni_main.js",