Function autoPlay

src/engine/ui.ts:252–286

(engine: VisualNovelEngine, enable: boolean)

 * or disabled (false);
 */
export function autoPlay (engine: VisualNovelEngine, enable: boolean): void {
	if (enable === true) {
		// The interval for autoplay speed is measured in seconds
		const interval = (engine.preference ('AutoPlaySpeed') as number) * 1000;
		let expected = Date.now () + interval;

		const timerFn = () => {
			const now = Date.now () - expected; // the drift (positive for overshooting)
			if (now > interval) {
				// something really bad happened. Maybe the browser (tab) was inactive?
				// possibly special handling to avoid futile "catch up" run
			}
			engine.proceed ({ userInitiated: false, skip: false, autoPlay: true }).then (() => {
				expected += interval;
				setTimeout (engine.global ('_auto_play_timer') as () => void, Math.max (0, interval - now)); // take into account drift
			}).catch (() => {
				// An action waiting for user interaction or something else
				// is blocking the game.
				expected += interval;
				setTimeout (engine.global ('_auto_play_timer') as () => void, Math.max (0, interval - now)); // take into account drift
			});
		};

		engine.global ('_auto_play_timer', timerFn);
		setTimeout (timerFn, interval);

		engine.element ().find ('[data-component="quick-menu"] [data-action="auto-play"] [data-string]').text (engine.string ('Stop') || 'Stop');
		engine.element ().find ('[data-component="quick-menu"] [data-action="auto-play"] [data-icon]').replaceWith ('<span class="fas fa-stop-circle"></span>');
	} else {
		clearTimeout (engine.global ('_auto_play_timer') as ReturnType<typeof setTimeout>);
		engine.global ('_auto_play_timer', null);
		engine.element ().find ('[data-component="quick-menu"] [data-action="auto-play"] [data-string]').text (engine.string ('AutoPlay') || 'AutoPlay');
		engine.element ().find ('[data-component="quick-menu"] [data-action="auto-play"] [data-icon]').replaceWith ('<span class="fas fa-play-circle"></span>');
	}
}

/**
 * @static distractionFree - Enable or disable the distraction free mode