@akashic/headless-driver 2.13.9 → 2.14.0

package/lib/TimeKeeper.d.ts

@@ -0,0 +1,7 @@
+export declare class TimeKeeper {
+    _currentTime: number;
+    now: () => number;
+    advance(ms: number): void;
+    rewind(): void;
+    set(time: number): void;
+}

package/lib/TimeKeeper.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TimeKeeper = void 0;
+class TimeKeeper {
+    constructor() {
+        this._currentTime = 0;
+        // NOTE: this を束縛するためアロー関数で定義
+        this.now = () => {
+            return this._currentTime;
+        };
+    }
+    advance(ms) {
+        this._currentTime += ms;
+    }
+    rewind() {
+        this._currentTime = 0;
+    }
+    set(time) {
+        this._currentTime = time;
+    }
+}
+exports.TimeKeeper = TimeKeeper;

package/lib/runner/Platform.d.ts

@@ -20,6 +20,7 @@ export declare abstract class Platform {
     protected errorHandler: (err: any) => void;
     protected loadFileHandler: RunnerLoadFileHandler;
     constructor(param: PlatformParameters);
+    abstract advanceLoopers(ms: number): void;
     sendToExternal(_playId: string, data: any): void;
     loadGameConfiguration: (url: string, callback: (err: Error | null, data?: string | Uint8Array) => void) => void;
 }

package/lib/runner/Runner.d.ts

@@ -1,7 +1,9 @@
+/// <reference types="node" />
 import type { AMFlow } from "@akashic/amflow";
 import { Trigger } from "@akashic/trigger";
+import { TimeKeeper } from "../TimeKeeper";
 import type { Platform } from "./Platform";
-import type { RunnerAdvanceConditionFunc, RunnerExecutionMode, RunnerLoadFileHandler, RunnerPlayer, RunnerPointEvent, RunnerRenderingMode } from "./types";
+import type { RunnerAdvanceConditionFunc, RunnerExecutionMode, RunnerLoadFileHandler, RunnerLoopMode, RunnerPlayer, RunnerPointEvent, RunnerRenderingMode } from "./types";
 export interface RunnerParameters {
     contentUrl: string;
     assetBaseUrl: string;
@@ -12,6 +14,7 @@ export interface RunnerParameters {
     runnerId: string;
     amflow: AMFlow;
     executionMode: RunnerExecutionMode;
+    loopMode?: RunnerLoopMode;
     trusted?: boolean;
     renderingMode?: RunnerRenderingMode;
     loadFileHandler: RunnerLoadFileHandler;
@@ -38,6 +41,7 @@ export declare abstract class Runner {
      */
     abstract readonly g: any;
     abstract platform: Platform | null;
+    abstract fps: number | null;
     errorTrigger: Trigger<Error>;
     sendToExternalTrigger: Trigger<any>;
     private params;
@@ -50,6 +54,7 @@ export declare abstract class Runner {
     get configurationBaseUrl(): string | undefined;
     get amflow(): AMFlow;
     get executionMode(): RunnerExecutionMode;
+    get loopMode(): RunnerLoopMode;
     get trusted(): boolean;
     get renderingMode(): RunnerRenderingMode;
     get loadFileHandler(): RunnerLoadFileHandler;
@@ -61,6 +66,9 @@ export declare abstract class Runner {
     get externalValue(): {
         [key: string]: any;
     } | undefined;
+    protected timekeeper: TimeKeeper;
+    protected timekeeperTimerId: NodeJS.Timer | null;
+    protected timekeeperPrevTime: number;
     constructor(params: RunnerParameters);
     /**
      * Runner を開始する。
@@ -84,11 +92,11 @@ export declare abstract class Runner {
      * Runner を指定ミリ秒だけ進行する。
      * @param ms 進行するミリ秒。
      */
-    abstract advance(ms: number): void;
+    abstract advance(ms: number): Promise<void>;
     /**
      * Runner を一フレーム進行する。
      */
-    abstract step(): void;
+    abstract step(): Promise<void>;
     /**
      * Runner に対して任意のポイントイベントを発火させる。
      * @param event 発火させるポイントイベント
@@ -105,6 +113,12 @@ export declare abstract class Runner {
      * @param timeout タイムアウトまでのミリ秒数。省略時は `5000` 。ゲーム内時間ではなく実時間である点に注意。
      */
     advanceUntil(condition: RunnerAdvanceConditionFunc, timeout?: number): Promise<void>;
+    /**
+     * 次フレームを飛ばさない程度に時間を進める。
+     */
     protected abstract _stepMinimal(): void;
+    protected advancePlatform(ms: number): void;
+    protected startTimekeeper(): void;
+    protected stopTimekeeper(): void;
     protected onError(error: Error): void;
 }

package/lib/runner/Runner.js

@@ -11,6 +11,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Runner = void 0;
 const trigger_1 = require("@akashic/trigger");
+const TimeKeeper_1 = require("../TimeKeeper");
 class Runner {
     get runnerId() {
         return this.params.runnerId;
@@ -39,6 +40,10 @@ class Runner {
     get executionMode() {
         return this.params.executionMode;
     }
+    get loopMode() {
+        var _a;
+        return (_a = this.params.loopMode) !== null && _a !== void 0 ? _a : "realtime";
+    }
     get trusted() {
         return !!this.params.trusted;
     }
@@ -64,6 +69,9 @@ class Runner {
     constructor(params) {
         this.errorTrigger = new trigger_1.Trigger();
         this.sendToExternalTrigger = new trigger_1.Trigger();
+        this.timekeeper = new TimeKeeper_1.TimeKeeper();
+        this.timekeeperTimerId = null;
+        this.timekeeperPrevTime = 0;
         this.params = params;
     }
     /**
@@ -74,9 +82,9 @@ class Runner {
     advanceUntil(condition, timeout = 5000) {
         return __awaiter(this, void 0, void 0, function* () {
             return new Promise((resolve, reject) => {
-                const limit = Date.now() + timeout;
+                const limit = performance.now() + timeout;
                 const handler = () => {
-                    if (limit < Date.now()) {
+                    if (limit < performance.now()) {
                         return void reject(new Error("Runner#advanceUntil(): processing timeout"));
                     }
                     try {
@@ -93,6 +101,46 @@ class Runner {
             });
         });
     }
+    advancePlatform(ms) {
+        // 以下のメソッドプロパティが存在することは呼び出し側で保証する
+        const fps = this.fps;
+        const platform = this.platform;
+        const timekeeper = this.timekeeper;
+        const frame = 1000 / fps;
+        const frameWithGrace = frame * 1.2; // 1 フレームよりも少し大きめの値
+        const steps = Math.floor(ms / frame);
+        let progress = 0;
+        for (let i = 0; i < steps; i++) {
+            const now = timekeeper.now();
+            // NOTE: 浮動小数による誤差を考慮し、 1 フレームよりも少し大きめに目標時刻を進め、その後 Looper を確実に進めた後に再度目標時刻を正常値に戻す。
+            timekeeper.advance(frameWithGrace);
+            // NOTE: game-driver の内部実装により Looper 経由で一度に進める時間に制限がある。
+            // そのため一度に進める時間を fps に応じて分割する。
+            platform.advanceLoopers(frame);
+            timekeeper.set(now + frame);
+            progress += frame;
+        }
+        timekeeper.advance(ms - progress);
+        platform.advanceLoopers(ms - progress);
+    }
+    startTimekeeper() {
+        this.stopTimekeeper();
+        const duration = 1000 / this.fps / 2; // this.fps != null の条件でのみしか呼ばれないため non-null assertion を利用
+        this.timekeeperPrevTime = performance.now();
+        this.timekeeperTimerId = setInterval(() => {
+            const now = performance.now();
+            const delta = now - this.timekeeperPrevTime;
+            this.timekeeper.advance(delta);
+            this.timekeeperPrevTime = now;
+        }, duration);
+    }
+    stopTimekeeper() {
+        if (this.timekeeperTimerId == null) {
+            return;
+        }
+        clearInterval(this.timekeeperTimerId);
+        this.timekeeperTimerId = null;
+    }
     onError(error) {
         this.stop();
         this.errorTrigger.fire(error);

package/lib/runner/RunnerManager.d.ts

@@ -2,7 +2,7 @@ import type { AMFlowClient } from "../play/amflow/AMFlowClient";
 import type { PlayManager } from "../play/PlayManager";
 import type { EncodingType } from "../utils";
 import type { RunnerStartParameters } from "./Runner";
-import type { RunnerExecutionMode, RunnerPlayer, RunnerRenderingMode } from "./types";
+import type { RunnerExecutionMode, RunnerLoopMode, RunnerPlayer, RunnerRenderingMode } from "./types";
 import type { RunnerV1Game } from "./v1";
 import { RunnerV1 } from "./v1";
 import type { RunnerV2Game } from "./v2";
@@ -14,6 +14,7 @@ export interface CreateRunnerParameters {
     amflow: AMFlowClient;
     playToken: string;
     executionMode: RunnerExecutionMode;
+    loopMode?: RunnerLoopMode;
     gameArgs?: any;
     player?: RunnerPlayer;
     /**

package/lib/runner/RunnerManager.js

@@ -105,6 +105,7 @@ class RunnerManager {
                     playToken: params.playToken,
                     amflow,
                     executionMode: params.executionMode,
+                    loopMode: params.loopMode,
                     trusted: params.trusted,
                     renderingMode: params.renderingMode,
                     loadFileHandler: this.createLoadFileHandler(params.allowedUrls),

package/lib/runner/types.d.ts

@@ -1,5 +1,6 @@
 import type { EncodingType } from "../utils";
 export type RunnerExecutionMode = "active" | "passive";
+export type RunnerLoopMode = "realtime" | "replay";
 export type RunnerRenderingMode = "none" | "canvas";
 export type RunnerAdvanceConditionFunc = () => boolean;
 export interface RunnerPointEvent {

package/lib/runner/v1/RunnerV1.d.ts

@@ -15,7 +15,7 @@ export declare class RunnerV1 extends Runner {
     stop(): void;
     pause(): void;
     resume(): void;
-    step(): void;
+    step(): Promise<void>;
     protected _stepMinimal(): void;
     advance(ms: number): Promise<void>;
     changeGameDriverState(param: gdr.GameDriverInitializeParameterObject): Promise<void>;

package/lib/runner/v1/RunnerV1.js

@@ -10,6 +10,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.RunnerV1 = void 0;
+const promises_1 = require("node:timers/promises");
 const engine_files_v1_1 = require("engine-files-v1");
 const Runner_1 = require("../Runner");
 const PlatformV1_1 = require("./platform/PlatformV1");
@@ -44,6 +45,7 @@ class RunnerV1 extends Runner_1.Runner {
             this.driver.stopGame();
             this.driver = null;
         }
+        this.stopTimekeeper();
         this.running = false;
     }
     pause() {
@@ -52,6 +54,7 @@ class RunnerV1 extends Runner_1.Runner {
             return;
         }
         this.platform.pauseLoopers();
+        this.stopTimekeeper();
         this.running = false;
     }
     resume() {
@@ -60,26 +63,31 @@ class RunnerV1 extends Runner_1.Runner {
             return;
         }
         this.platform.resumeLoopers();
+        this.startTimekeeper();
         this.running = true;
     }
     step() {
-        if (this.fps == null || this.platform == null) {
-            this.errorTrigger.fire(new Error("Cannot call Runner#step() before initialized"));
-            return;
-        }
-        if (this.running) {
-            this.errorTrigger.fire(new Error("Cannot call Runner#step() in running"));
-            return;
-        }
-        this.platform.advanceLoopers(Math.ceil(1000 / this.fps));
+        return __awaiter(this, void 0, void 0, function* () {
+            if (this.fps == null || this.platform == null) {
+                this.errorTrigger.fire(new Error("Cannot call Runner#step() before initialized"));
+                return;
+            }
+            if (this.running) {
+                this.errorTrigger.fire(new Error("Cannot call Runner#step() in running"));
+                return;
+            }
+            this.timekeeper.advance(1000 / this.fps);
+            this.platform.advanceLoopers(Math.ceil(1000 / this.fps));
+            yield (0, promises_1.setImmediate)();
+        });
     }
     _stepMinimal() {
         if (this.fps == null || this.platform == null) {
-            this.errorTrigger.fire(new Error("RunnerV1#_stepHalf(): Cannot call Runner#step() before initialized"));
+            this.errorTrigger.fire(new Error("RunnerV1#_stepMinimal(): Cannot call Runner#step() before initialized"));
             return;
         }
         if (this.running) {
-            this.errorTrigger.fire(new Error("RunnerV1#_stepHalf(): Cannot call Runner#step() in running"));
+            this.errorTrigger.fire(new Error("RunnerV1#_stepMinimal(): Cannot call Runner#step() in running"));
             return;
         }
         // NOTE: 現状 PDI の API 仕様により this.step() では厳密なフレーム更新ができない。そこで、一フレームの 1/2 の時間で進行することでフレームが飛んでしまうことを防止する。
@@ -103,14 +111,7 @@ class RunnerV1 extends Runner_1.Runner {
                     skipThreshold: Math.ceil(ms / this.fps) + 1
                 }
             });
-            const delta = Math.ceil(1000 / this.fps);
-            let progress = 0;
-            while (progress <= ms) {
-                // NOTE: game-driver の内部実装により Looper 経由で一度に進める時間に制限がある。
-                // そのため一度に進める時間を fps に応じて分割する。
-                this.platform.advanceLoopers(delta);
-                progress += delta;
-            }
+            this.advancePlatform(ms);
             yield this.changeGameDriverState({
                 loopConfiguration: {
                     loopMode,

package/lib/runner/v1/platform/assets/NullAudioAsset.js

@@ -4,9 +4,9 @@ exports.NullAudioAsset = void 0;
 const engine_files_v1_1 = require("engine-files-v1");
 class NullAudioAsset extends engine_files_v1_1.akashicEngine.AudioAsset {
     _load(loader) {
-        setTimeout(() => {
+        setImmediate(() => {
             loader._onAssetLoad(this);
-        }, 0);
+        });
     }
 }
 exports.NullAudioAsset = NullAudioAsset;

package/lib/runner/v1/platform/assets/NullImageAsset.js

@@ -9,9 +9,9 @@ class NullImageAsset extends engine_files_v1_1.akashicEngine.ImageAsset {
         this._surface = null;
     }
     _load(loader) {
-        setTimeout(() => {
+        setImmediate(() => {
             loader._onAssetLoad(this);
-        }, 0);
+        });
     }
     asSurface() {
         return this._surface || (this._surface = new NullSurface_1.NullSurface(this.width, this.height, null));

package/lib/runner/v1/platform/assets/NullVideoAsset.js

@@ -10,9 +10,9 @@ class NullVideoAsset extends engine_files_v1_1.akashicEngine.VideoAsset {
         this._player = new engine_files_v1_1.akashicEngine.VideoPlayer();
     }
     _load(loader) {
-        setTimeout(() => {
+        setImmediate(() => {
             loader._onAssetLoad(this);
-        }, 0);
+        });
     }
     asSurface() {
         return this._surface || (this._surface = new NullSurface_1.NullSurface(this.width, this.height, null));

package/lib/runner/v2/RunnerV2.d.ts

@@ -15,7 +15,7 @@ export declare class RunnerV2 extends Runner {
     stop(): void;
     pause(): void;
     resume(): void;
-    step(): void;
+    step(): Promise<void>;
     advance(ms: number): Promise<void>;
     changeGameDriverState(param: gdr.GameDriverInitializeParameterObject): Promise<void>;
     firePointEvent(event: RunnerPointEvent): void;

package/lib/runner/v2/RunnerV2.js

@@ -10,6 +10,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.RunnerV2 = void 0;
+const promises_1 = require("node:timers/promises");
 const engine_files_v2_1 = require("engine-files-v2");
 const Runner_1 = require("../Runner");
 const PlatformV2_1 = require("./platform/PlatformV2");
@@ -44,6 +45,7 @@ class RunnerV2 extends Runner_1.Runner {
             this.driver.stopGame();
             this.driver = null;
         }
+        this.stopTimekeeper();
         this.running = false;
     }
     pause() {
@@ -52,6 +54,7 @@ class RunnerV2 extends Runner_1.Runner {
             return;
         }
         this.platform.pauseLoopers();
+        this.stopTimekeeper();
         this.running = false;
     }
     resume() {
@@ -60,18 +63,23 @@ class RunnerV2 extends Runner_1.Runner {
             return;
         }
         this.platform.resumeLoopers();
+        this.startTimekeeper();
         this.running = true;
     }
     step() {
-        if (this.fps == null || this.platform == null) {
-            this.errorTrigger.fire(new Error("Cannot call Runner#step() before initialized"));
-            return;
-        }
-        if (this.running) {
-            this.errorTrigger.fire(new Error("Cannot call Runner#step() in running"));
-            return;
-        }
-        this.platform.advanceLoopers(Math.ceil(1000 / this.fps));
+        return __awaiter(this, void 0, void 0, function* () {
+            if (this.fps == null || this.platform == null) {
+                this.errorTrigger.fire(new Error("Cannot call Runner#step() before initialized"));
+                return;
+            }
+            if (this.running) {
+                this.errorTrigger.fire(new Error("Cannot call Runner#step() in running"));
+                return;
+            }
+            this.timekeeper.advance(1000 / this.fps);
+            this.platform.advanceLoopers(Math.ceil(1000 / this.fps));
+            yield (0, promises_1.setImmediate)();
+        });
     }
     advance(ms) {
         return __awaiter(this, void 0, void 0, function* () {
@@ -91,14 +99,7 @@ class RunnerV2 extends Runner_1.Runner {
                     skipThreshold: Math.ceil(ms / this.fps) + 1
                 }
             });
-            const delta = Math.ceil(1000 / this.fps);
-            let progress = 0;
-            while (progress <= ms) {
-                // NOTE: game-driver の内部実装により Looper 経由で一度に進める時間に制限がある。
-                // そのため一度に進める時間を fps に応じて分割する。
-                this.platform.advanceLoopers(delta);
-                progress += delta;
-            }
+            this.advancePlatform(ms);
             yield this.changeGameDriverState({
                 loopConfiguration: {
                     loopMode,
@@ -146,11 +147,11 @@ class RunnerV2 extends Runner_1.Runner {
     }
     _stepMinimal() {
         if (this.fps == null || this.platform == null) {
-            this.errorTrigger.fire(new Error("RunnerV2#_stepHalf(): Cannot call Runner#step() before initialized"));
+            this.errorTrigger.fire(new Error("RunnerV2#_stepMinimal(): Cannot call Runner#step() before initialized"));
             return;
         }
         if (this.running) {
-            this.errorTrigger.fire(new Error("RunnerV2#_stepHalf(): Cannot call Runner#step() in running"));
+            this.errorTrigger.fire(new Error("RunnerV2#_stepMinimal(): Cannot call Runner#step() in running"));
             return;
         }
         // NOTE: 現状 PDI の API 仕様により this.step() では厳密なフレーム更新ができない。そこで、一フレームの 1/2 の時間で進行することでフレームが飛んでしまうことを防止する。

package/lib/runner/v2/platform/assets/NullAudioAsset.js

@@ -4,9 +4,9 @@ exports.NullAudioAsset = void 0;
 const engine_files_v2_1 = require("engine-files-v2");
 class NullAudioAsset extends engine_files_v2_1.akashicEngine.AudioAsset {
     _load(loader) {
-        setTimeout(() => {
+        setImmediate(() => {
             loader._onAssetLoad(this);
-        }, 0);
+        });
     }
 }
 exports.NullAudioAsset = NullAudioAsset;

package/lib/runner/v2/platform/assets/NullImageAsset.js

@@ -9,9 +9,9 @@ class NullImageAsset extends engine_files_v2_1.akashicEngine.ImageAsset {
         this._surface = null;
     }
     _load(loader) {
-        setTimeout(() => {
+        setImmediate(() => {
             loader._onAssetLoad(this);
-        }, 0);
+        });
     }
     asSurface() {
         return this._surface || (this._surface = new NullSurface_1.NullSurface(this.width, this.height, null));

package/lib/runner/v2/platform/assets/NullVideoAsset.js

@@ -10,9 +10,9 @@ class NullVideoAsset extends engine_files_v2_1.akashicEngine.VideoAsset {
         this._player = new engine_files_v2_1.akashicEngine.VideoPlayer();
     }
     _load(loader) {
-        setTimeout(() => {
+        setImmediate(() => {
             loader._onAssetLoad(this);
-        }, 0);
+        });
     }
     asSurface() {
         return this._surface || (this._surface = new NullSurface_1.NullSurface(this.width, this.height, null));

package/lib/runner/v3/RunnerV3.d.ts

@@ -19,7 +19,7 @@ export declare class RunnerV3 extends Runner {
     stop(): void;
     pause(): void;
     resume(): void;
-    step(): void;
+    step(): Promise<void>;
     advance(ms: number): Promise<void>;
     changeGameDriverState(param: gdr.GameDriverInitializeParameterObject): Promise<void>;
     firePointEvent(event: RunnerPointEvent): void;

package/lib/runner/v3/RunnerV3.js

@@ -10,6 +10,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.RunnerV3 = void 0;
+const promises_1 = require("node:timers/promises");
 const Runner_1 = require("../Runner");
 const engineFiles_1 = require("./engineFiles");
 const PlatformV3_1 = require("./platform/PlatformV3");
@@ -44,6 +45,7 @@ class RunnerV3 extends Runner_1.Runner {
             this.driver.stopGame();
             this.driver = null;
         }
+        this.stopTimekeeper();
         this.running = false;
     }
     pause() {
@@ -52,6 +54,7 @@ class RunnerV3 extends Runner_1.Runner {
             return;
         }
         this.platform.pauseLoopers();
+        this.stopTimekeeper();
         this.running = false;
     }
     resume() {
@@ -60,18 +63,27 @@ class RunnerV3 extends Runner_1.Runner {
             return;
         }
         this.platform.resumeLoopers();
+        this.startTimekeeper();
         this.running = true;
     }
     step() {
-        if (this.fps == null || this.platform == null) {
-            this.errorTrigger.fire(new Error("Cannot call Runner#step() before initialized"));
-            return;
-        }
-        if (this.running) {
-            this.errorTrigger.fire(new Error("Cannot call Runner#step() in running"));
-            return;
-        }
-        this.platform.stepLoopers();
+        return __awaiter(this, void 0, void 0, function* () {
+            if (this.fps == null || this.platform == null) {
+                this.errorTrigger.fire(new Error("Cannot call Runner#step() before initialized"));
+                return;
+            }
+            if (this.running) {
+                this.errorTrigger.fire(new Error("Cannot call Runner#step() in running"));
+                return;
+            }
+            this.timekeeper.advance(1000 / this.fps);
+            this.platform.stepLoopers();
+            // Looper を進行させるとアセット読み込み・AMFlow のコールバックなどの setImmediate() が実行されるが、
+            // それらを Runner#step() の完了タイミングで確実に処理するため、Runner#step() の完了を setImmediate() で遅延させている。
+            // ここを単純な Promise で返しても microtask queue に積まれるため、macrotask queue に積まれる setImmediate() の処理の完了を待つことはできない。
+            // @see https://nodejs.org/en/learn/asynchronous-work/understanding-setimmediate
+            yield (0, promises_1.setImmediate)();
+        });
     }
     advance(ms) {
         return __awaiter(this, void 0, void 0, function* () {
@@ -96,14 +108,7 @@ class RunnerV3 extends Runner_1.Runner {
                     skipThreshold: Math.ceil(ms / this.fps) + 1
                 }
             });
-            const delta = Math.ceil(1000 / this.fps);
-            let progress = 0;
-            while (progress <= ms) {
-                // NOTE: game-driver の内部実装により Looper 経由で一度に進める時間に制限がある。
-                // そのため一度に進める時間を fps に応じて分割する。
-                this.platform.advanceLoopers(delta);
-                progress += delta;
-            }
+            this.advancePlatform(ms);
             yield this.changeGameDriverState({
                 loopConfiguration: {
                     loopMode,
@@ -170,7 +175,16 @@ class RunnerV3 extends Runner_1.Runner {
         return this.getPrimarySurface()._drawable;
     }
     _stepMinimal() {
-        this.step();
+        if (this.fps == null || this.platform == null) {
+            this.errorTrigger.fire(new Error("RunnerV3#_stepMinimal(): Cannot call Runner#step() before initialized"));
+            return;
+        }
+        if (this.running) {
+            this.errorTrigger.fire(new Error("RunnerV3#_stepMinimal(): Cannot call Runner#step() in running"));
+            return;
+        }
+        // NOTE: 現状 PDI の API 仕様により this.step() では厳密なフレーム更新ができない。そこで、一フレームの 1/2 の時間で進行することでフレームが飛んでしまうことを防止する。
+        this.platform.advanceLoopers(1000 / this.fps / 2);
     }
     initGameDriver() {
         return new Promise((resolve, reject) => {
@@ -183,6 +197,7 @@ class RunnerV3 extends Runner_1.Runner {
                 name: this.player ? this.player.name : undefined
             };
             const executionMode = this.executionMode === "active" ? engineFiles_1.gameDriver.ExecutionMode.Active : engineFiles_1.gameDriver.ExecutionMode.Passive;
+            const loopMode = this.loopMode === "replay" ? engineFiles_1.gameDriver.LoopMode.Replay : engineFiles_1.gameDriver.LoopMode.Realtime;
             this.platform = new PlatformV3_1.PlatformV3({
                 configurationBaseUrl: this.configurationBaseUrl,
                 assetBaseUrl: this.assetBaseUrl,
@@ -212,7 +227,8 @@ class RunnerV3 extends Runner_1.Runner {
                     executionMode
                 },
                 loopConfiguration: {
-                    loopMode: engineFiles_1.gameDriver.LoopMode.Realtime
+                    loopMode,
+                    targetTimeFunc: this.timekeeper.now
                 },
                 gameArgs: this.gameArgs
             }, (e) => {

package/lib/runner/v3/platform/audios/NullAudioAsset.js

@@ -14,9 +14,9 @@ class NullAudioAsset extends Asset_1.Asset {
         this.data = undefined;
     }
     _load(loader) {
-        setTimeout(() => {
+        setImmediate(() => {
             loader._onAssetLoad(this);
-        }, 0);
+        });
     }
     play() {
         return this._system.createPlayer();

package/lib/runner/v3/platform/graphics/null/NullImageAsset.js

@@ -12,9 +12,9 @@ class NullImageAsset extends Asset_1.Asset {
         this.height = height;
     }
     _load(loader) {
-        setTimeout(() => {
+        setImmediate(() => {
             loader._onAssetLoad(this);
-        }, 0);
+        });
     }
     asSurface() {
         return this._surface || (this._surface = new NullSurface_1.NullSurface(this.width, this.height));

package/lib/runner/v3/platform/videos/NullVideoAsset.js

@@ -19,9 +19,9 @@ class NullVideoAsset extends Asset_1.Asset {
         this._player = new NullVideoPlayer_1.NullVideoPlayer();
     }
     _load(loader) {
-        setTimeout(() => {
+        setImmediate(() => {
             loader._onAssetLoad(this);
-        }, 0);
+        });
     }
     asSurface() {
         return this._surface || (this._surface = new NullSurface_1.NullSurface(this.width, this.height));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@akashic/headless-driver",
-  "version": "2.13.9",
+  "version": "2.14.0",
   "description": "A library to execute contents using Akashic Engine headlessly",
   "main": "lib/index.js",
   "author": "DWANGO Co., Ltd.",