@next2d/media 1.18.12 → 2.0.0

package/README.md

@@ -1,10 +1,10 @@
-@next2d/media
+@next2d/renderer
 =============
 
 ## Installation
 
 ```
-npm install @next2d/media
+npm install @next2d/renderer
 ```
 
 ## License

package/package.json

@@ -1,26 +1,18 @@
 {
   "name": "@next2d/media",
-  "version": "1.18.12",
-  "description": "Next2D Media Packages",
-  "author": "Toshiyuki Ienaga<ienaga@tvon.jp> (https://github.com/ienaga/)",
+  "version": "2.0.0",
+  "description": "Next2D Media Package",
+  "author": "Toshiyuki Ienaga<ienaga@next2d.app> (https://github.com/ienaga/)",
   "license": "MIT",
   "homepage": "https://next2d.app",
   "bugs": "https://github.com/Next2D/Player/issues",
-  "main": "dist/index.js",
-  "types": "dist/index.d.ts",
-  "files": [
-    "dist"
-  ],
+  "main": "src/index.js",
+  "types": "src/index.d.ts",
+  "type": "module",
   "exports": {
     ".": {
-      "import": {
-        "types": "./dist/index.d.ts",
-        "default": "./dist/index.js"
-      },
-      "require": {
-        "types": "./dist/index.d.ts",
-        "default": "./dist/index.js"
-      }
+      "import": "./src/index.js",
+      "require": "./src/index.js"
     }
   },
   "keywords": [
@@ -31,15 +23,10 @@
     "type": "git",
     "url": "git+https://github.com/Next2D/Player.git"
   },
-  "peerDependencies": {
-    "@next2d/events": "1.18.12",
-    "@next2d/net": "1.18.12",
-    "@next2d/display": "1.18.12",
-    "@next2d/interface": "1.18.12",
-    "@next2d/core": "1.18.12",
-    "@next2d/share": "1.18.12",
-    "@next2d/util": "1.18.12",
-    "@next2d/geom": "1.18.12",
-    "@next2d/webgl": "1.18.12"
+  "dependencies": {
+    "@next2d/events": "2.0.0",
+    "@next2d/net": "2.0.0",
+    "@next2d/display": "2.0.0",
+    "@next2d/geom": "2.0.0"
   }
 }

package/src/MediaUtil.d.ts

@@ -0,0 +1,104 @@
+import type { Sound } from "./Sound";
+import type { Video } from "./Video";
+import type { IAjaxOption } from "./interface/IAjaxOption";
+/**
+ * @description ミュートになっているビデオを返却
+ *              Returns the muted video.
+ *
+ * @return {Video[]}
+ * @method
+ * @public
+ */
+export declare const $getMutedVideos: () => Video[];
+/**
+ * @description ミュートになっているビデオを追加
+ *              Add a video that has been muted.
+ *
+ * @param  {Video} video
+ * @return {void}
+ * @method
+ * @public
+ */
+export declare const $pushMutedVideos: (video: Video) => void;
+/**
+ * @description AudioContext が存在するか返却
+ *              Returns whether AudioContext exists.
+ *
+ * @return {boolean}
+ * @method
+ * @public
+ */
+export declare const $isAudioContext: () => boolean;
+/**
+ * @description AudioContext を起動
+ *              Start AudioContext.
+ *
+ * @method
+ * @private
+ */
+export declare const $bootAudioContext: () => void;
+/**
+ * @description AudioContext を返却
+ *              Returns AudioContext.
+ *
+ * @return {AudioContext}
+ * @method
+ * @protected
+ */
+export declare const $getAudioContext: () => AudioContext;
+/**
+ * @param  {object} option
+ * @return {void}
+ * @method
+ * @public
+ */
+export declare const $ajax: (option: IAjaxOption) => void;
+/**
+ * @description 値が最小値と最大値の間に収まるように調整します。
+ *              Adjust the value so that it falls between the minimum and maximum values.
+ *
+ * @param  {number} value
+ * @param  {number} min
+ * @param  {number} max
+ * @param  {number} [default_value=null]
+ * @return {number}
+ * @method
+ * @static
+ */
+export declare const $clamp: (value: number, min: number, max: number, default_value?: number | null) => number;
+/**
+ * @description 音量を返却
+ *              Returns the volume.
+ *
+ * @return {number}
+ * @method
+ * @public
+ */
+export declare const $getVolume: () => number;
+/**
+ * @description 音量を設定
+ *              Set the volume.
+ *
+ * @param {number} volume
+ * @method
+ * @public
+ */
+export declare const $setVolume: (volume: number) => void;
+/**
+ * @description 再生中のサウンドを返却
+ *              Returns the sound being played.
+ *
+ * @returns {Sound[]}
+ * @method
+ * @public
+ */
+export declare const $getPlayingSounds: () => Sound[];
+/**
+ * @description 再生中のビデオを返却
+ *              Returns the video being played.
+ *
+ * @returns {Video[]}
+ * @method
+ * @public
+ */
+export declare const $getPlayingVideos: () => Video[];

package/src/MediaUtil.js

@@ -0,0 +1,203 @@
+/**
+ * @type {Video[]}
+ * @public
+ */
+const $mutedVideos = [];
+/**
+ * @description ミュートになっているビデオを返却
+ *              Returns the muted video.
+ *
+ * @return {Video[]}
+ * @method
+ * @public
+ */
+export const $getMutedVideos = () => {
+    return $mutedVideos;
+};
+/**
+ * @description ミュートになっているビデオを追加
+ *              Add a video that has been muted.
+ *
+ * @param  {Video} video
+ * @return {void}
+ * @method
+ * @public
+ */
+export const $pushMutedVideos = (video) => {
+    $mutedVideos.push(video);
+};
+/**
+ * @type {AudioContext}
+ * @private
+ */
+let $audioContext = null;
+/**
+ * @description AudioContext が存在するか返却
+ *              Returns whether AudioContext exists.
+ *
+ * @return {boolean}
+ * @method
+ * @public
+ */
+export const $isAudioContext = () => {
+    return !!$audioContext;
+};
+/**
+ * @description AudioContext を起動
+ *              Start AudioContext.
+ *
+ * @method
+ * @private
+ */
+export const $bootAudioContext = () => {
+    if (!$audioContext) {
+        $audioContext = new AudioContext();
+    }
+    $audioContext.resume();
+};
+/**
+ * @description AudioContext を返却
+ *              Returns AudioContext.
+ *
+ * @return {AudioContext}
+ * @method
+ * @protected
+ */
+export const $getAudioContext = () => {
+    if (!$audioContext) {
+        $audioContext = new AudioContext();
+    }
+    return $audioContext;
+};
+/**
+ * @param  {object} option
+ * @return {void}
+ * @method
+ * @public
+ */
+export const $ajax = (option) => {
+    // get or post
+    let postData = null;
+    switch (option.method.toUpperCase()) {
+        case "GET":
+            if (option.data) {
+                const urls = option.url.split("?");
+                urls[1] = urls.length === 1
+                    ? option.data.toString()
+                    : `${urls[1]}&${option.data.toString()}`;
+                option.url = urls.join("?");
+            }
+            break;
+        case "PUT":
+        case "POST":
+            if (option.data) {
+                postData = option.data.toString();
+            }
+            break;
+        default:
+            break;
+    }
+    // start
+    const xmlHttpRequest = new XMLHttpRequest();
+    // init
+    xmlHttpRequest.open(option.method, option.url, true);
+    // set mimeType
+    xmlHttpRequest.responseType = option.format;
+    // use cookie
+    xmlHttpRequest.withCredentials = option.withCredentials;
+    // add event
+    if (option.event) {
+        const keys = Object.keys(option.event);
+        for (let idx = 0; idx < keys.length; ++idx) {
+            const name = keys[idx];
+            // @ts-ignore
+            xmlHttpRequest.addEventListener(name, option.event[name]);
+        }
+    }
+    // set request header
+    for (let idx = 0; idx < option.headers.length; ++idx) {
+        const header = option.headers[idx];
+        if (!header) {
+            continue;
+        }
+        xmlHttpRequest.setRequestHeader(header.name, header.value);
+    }
+    xmlHttpRequest.send(postData);
+};
+/**
+ * @description 値が最小値と最大値の間に収まるように調整します。
+ *              Adjust the value so that it falls between the minimum and maximum values.
+ *
+ * @param  {number} value
+ * @param  {number} min
+ * @param  {number} max
+ * @param  {number} [default_value=null]
+ * @return {number}
+ * @method
+ * @static
+ */
+export const $clamp = (value, min, max, default_value = null) => {
+    const number = +value;
+    return isNaN(number) && default_value !== null
+        ? default_value
+        : Math.min(Math.max(min, isNaN(number) ? 0 : number), max);
+};
+/**
+ * @type {number}
+ * @private
+ */
+let $volume = 1;
+/**
+ * @description 音量を返却
+ *              Returns the volume.
+ *
+ * @return {number}
+ * @method
+ * @public
+ */
+export const $getVolume = () => {
+    return $volume;
+};
+/**
+ * @description 音量を設定
+ *              Set the volume.
+ *
+ * @param {number} volume
+ * @method
+ * @public
+ */
+export const $setVolume = (volume) => {
+    $volume = $clamp(volume, 0, 1, 1);
+};
+/**
+ * @type {Sound[]}
+ * @private
+ */
+const $playingSounds = [];
+/**
+ * @description 再生中のサウンドを返却
+ *              Returns the sound being played.
+ *
+ * @returns {Sound[]}
+ * @method
+ * @public
+ */
+export const $getPlayingSounds = () => {
+    return $playingSounds;
+};
+/**
+ * @type {Video[]}
+ * @private
+ */
+const $playingVideos = [];
+/**
+ * @description 再生中のビデオを返却
+ *              Returns the video being played.
+ *
+ * @returns {Video[]}
+ * @method
+ * @public
+ */
+export const $getPlayingVideos = () => {
+    return $playingVideos;
+};

package/src/Sound/service/SoundDecodeService.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @description ArrayBufferをデコードしてAudioBufferを返却
+ *              Decode Uint8Array and return AudioBuffer.
+ *
+ * @param  {ArrayBuffer} array_buffer
+ * @return {AudioBuffer | void}
+ * @method
+ * @public
+ */
+export declare const execute: (array_buffer: ArrayBuffer) => Promise<AudioBuffer | void>;

package/src/Sound/service/SoundDecodeService.js

@@ -0,0 +1,30 @@
+import { $getAudioContext } from "../../MediaUtil";
+/**
+ * @description ArrayBufferをデコードしてAudioBufferを返却
+ *              Decode Uint8Array and return AudioBuffer.
+ *
+ * @param  {ArrayBuffer} array_buffer
+ * @return {AudioBuffer | void}
+ * @method
+ * @public
+ */
+export const execute = async (array_buffer) => {
+    if (!array_buffer.byteLength) {
+        return;
+    }
+    try {
+        return await $getAudioContext().decodeAudioData(array_buffer);
+    }
+    catch (_) {
+        const buffer = new Uint8Array(array_buffer);
+        let idx = 0;
+        for (; idx > buffer.byteLength;) {
+            idx = buffer.indexOf(0xff, idx);
+            if (idx === -1 || (buffer[idx + 1] & 0xe0) === 0xe0) {
+                break;
+            }
+            ++idx;
+        }
+        return await execute(buffer.subarray(idx).buffer);
+    }
+};

package/src/Sound/service/SoundEndedEventService.d.ts

@@ -0,0 +1,11 @@
+import type { Sound } from "../../Sound";
+/**
+ * @description サウンドデータの再生終了時のイベント実行関数
+ *              Event execution function when sound data playback ends
+ *
+ * @param  {Sound} sound
+ * @return {void}
+ * @method
+ * @public
+ */
+export declare const execute: (sound: Sound) => void;

package/src/Sound/service/SoundEndedEventService.js

@@ -0,0 +1,21 @@
+import { Event } from "@next2d/events";
+/**
+ * @description サウンドデータの再生終了時のイベント実行関数
+ *              Event execution function when sound data playback ends
+ *
+ * @param  {Sound} sound
+ * @return {void}
+ * @method
+ * @public
+ */
+export const execute = (sound) => {
+    if (sound.canLoop) {
+        sound.play();
+    }
+    else {
+        sound.stop();
+        if (sound.willTrigger(Event.COMPLETE)) {
+            sound.dispatchEvent(new Event(Event.COMPLETE));
+        }
+    }
+};

package/src/Sound/service/SoundLoadStartEventService.d.ts

@@ -0,0 +1,12 @@
+import type { Sound } from "../../Sound";
+/**
+ * @description サウンドの読み込みが開始イベントの実行関数
+ *              Execution function of the sound loading start event
+ *
+ * @param  {Sound} sound
+ * @param  {ProgressEvent} event
+ * @return {void}
+ * @method
+ * @public
+ */
+export declare const execute: (sound: Sound, event: ProgressEvent) => void;

package/src/Sound/service/SoundLoadStartEventService.js

@@ -0,0 +1,19 @@
+import { Event, ProgressEvent as Next2DProgressEvent } from "@next2d/events";
+/**
+ * @description サウンドの読み込みが開始イベントの実行関数
+ *              Execution function of the sound loading start event
+ *
+ * @param  {Sound} sound
+ * @param  {ProgressEvent} event
+ * @return {void}
+ * @method
+ * @public
+ */
+export const execute = (sound, event) => {
+    if (sound.willTrigger(Event.OPEN)) {
+        sound.dispatchEvent(new Event(Event.OPEN));
+    }
+    if (sound.willTrigger(Next2DProgressEvent.PROGRESS)) {
+        sound.dispatchEvent(new Next2DProgressEvent(Next2DProgressEvent.PROGRESS, false, event.loaded, event.total));
+    }
+};

package/src/Sound/service/SoundProgressEventService.d.ts

@@ -0,0 +1,12 @@
+import type { Sound } from "../../Sound";
+/**
+ * @description サウンドデータのローディング中のイベント実行関数
+ *              Event execution function during sound data loading
+ *
+ * @param  {Sound} sound
+ * @param  {ProgressEvent} event
+ * @return {void}
+ * @method
+ * @public
+ */
+export declare const execute: (sound: Sound, event: ProgressEvent) => void;

package/src/Sound/service/SoundProgressEventService.js

@@ -0,0 +1,16 @@
+import { ProgressEvent as Next2DProgressEvent } from "@next2d/events";
+/**
+ * @description サウンドデータのローディング中のイベント実行関数
+ *              Event execution function during sound data loading
+ *
+ * @param  {Sound} sound
+ * @param  {ProgressEvent} event
+ * @return {void}
+ * @method
+ * @public
+ */
+export const execute = (sound, event) => {
+    if (sound.willTrigger(Next2DProgressEvent.PROGRESS)) {
+        sound.dispatchEvent(new Next2DProgressEvent(Next2DProgressEvent.PROGRESS, false, event.loaded, event.total));
+    }
+};

package/src/Sound/usecase/SoundBuildFromCharacterUseCase.d.ts

@@ -0,0 +1,13 @@
+import type { ISoundCharacter } from "../../interface/ISoundCharacter";
+import type { Sound } from "../../Sound";
+/**
+ * @description キャラクターからSoundを構築
+ *              Build Sound from character
+ *
+ * @param  {Sound} sound
+ * @param  {ISoundCharacter} character
+ * @return {Promise<void>}
+ * @method
+ * @protected
+ */
+export declare const execute: (sound: Sound, character: ISoundCharacter) => Promise<void>;

package/src/Sound/usecase/SoundBuildFromCharacterUseCase.js

@@ -0,0 +1,23 @@
+import { execute as soundDecodeService } from "../service/SoundDecodeService";
+/**
+ * @description キャラクターからSoundを構築
+ *              Build Sound from character
+ *
+ * @param  {Sound} sound
+ * @param  {ISoundCharacter} character
+ * @return {Promise<void>}
+ * @method
+ * @protected
+ */
+export const execute = async (sound, character) => {
+    // load AudioBuffer
+    if (!character.audioBuffer) {
+        const uint8Array = new Uint8Array(character.buffer);
+        const audioBuffer = await soundDecodeService(uint8Array.buffer);
+        if (!audioBuffer) {
+            return;
+        }
+        character.audioBuffer = audioBuffer;
+    }
+    sound.audioBuffer = character.audioBuffer;
+};

package/src/Sound/usecase/SoundLoadEndEventUseCase.d.ts

@@ -0,0 +1,12 @@
+import type { Sound } from "../../Sound";
+/**
+ * @description サウンドデータのローディング完了イベントの実行関数
+ *              Execution function for sound data loading completion event
+ *
+ * @param  {Sound} sound
+ * @param  {ProgressEvent} event
+ * @return {Promise}
+ * @method
+ * @public
+ */
+export declare const execute: (sound: Sound, event: ProgressEvent) => Promise<AudioBuffer | void>;

package/src/Sound/usecase/SoundLoadEndEventUseCase.js

@@ -0,0 +1,35 @@
+import { execute as soundDecodeService } from "../service/SoundDecodeService";
+import { Event, ProgressEvent as Next2DProgressEvent, IOErrorEvent } from "@next2d/events";
+/**
+ * @description サウンドデータのローディング完了イベントの実行関数
+ *              Execution function for sound data loading completion event
+ *
+ * @param  {Sound} sound
+ * @param  {ProgressEvent} event
+ * @return {Promise}
+ * @method
+ * @public
+ */
+export const execute = async (sound, event) => {
+    const target = event.target;
+    if (!target) {
+        return;
+    }
+    if (sound.willTrigger(Next2DProgressEvent.PROGRESS)) {
+        sound.dispatchEvent(new Next2DProgressEvent(Next2DProgressEvent.PROGRESS, false, event.loaded, event.total));
+    }
+    if (199 < target.status && 400 > target.status) {
+        const audioBuffer = await soundDecodeService(target.response);
+        if (audioBuffer) {
+            sound.audioBuffer = audioBuffer;
+            if (sound.willTrigger(Event.COMPLETE)) {
+                sound.dispatchEvent(new Event(Event.COMPLETE));
+            }
+        }
+    }
+    else {
+        if (sound.willTrigger(IOErrorEvent.IO_ERROR)) {
+            sound.dispatchEvent(new IOErrorEvent(IOErrorEvent.IO_ERROR, false, target.statusText));
+        }
+    }
+};

package/src/Sound/usecase/SoundLoadUseCase.d.ts

@@ -0,0 +1,13 @@
+import type { URLRequest } from "@next2d/net";
+import type { Sound } from "../../Sound";
+/**
+ * @description 外部サウンドの読み込みを実行
+ *              Execute sound loading
+ *
+ * @param {Sound} sound
+ * @param {URLRequest} request
+ * @return {Promise}
+ * @method
+ * @protected
+ */
+export declare const execute: (sound: Sound, request: URLRequest) => Promise<void>;

package/src/Sound/usecase/SoundLoadUseCase.js

@@ -0,0 +1,38 @@
+import { execute as soundLoadStartEventService } from "../service/SoundLoadStartEventService";
+import { execute as soundProgressEventService } from "../service/SoundProgressEventService";
+import { execute as soundLoadEndEventUseCase } from "../usecase/SoundLoadEndEventUseCase";
+import { $ajax } from "../../MediaUtil";
+/**
+ * @description 外部サウンドの読み込みを実行
+ *              Execute sound loading
+ *
+ * @param {Sound} sound
+ * @param {URLRequest} request
+ * @return {Promise}
+ * @method
+ * @protected
+ */
+export const execute = async (sound, request) => {
+    await new Promise((resolve) => {
+        $ajax({
+            "format": "arraybuffer",
+            "url": request.url,
+            "method": request.method,
+            "data": request.data,
+            "headers": request.headers,
+            "withCredentials": request.withCredentials,
+            "event": {
+                "loadstart": (event) => {
+                    soundLoadStartEventService(sound, event);
+                },
+                "progress": (event) => {
+                    soundProgressEventService(sound, event);
+                },
+                "loadend": async (event) => {
+                    await soundLoadEndEventUseCase(sound, event);
+                    resolve();
+                }
+            }
+        });
+    });
+};