sfml.js 1.0.0-rc.1 → 1.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.ja.md +177 -0
- package/README.ko.md +177 -0
- package/README.md +119 -14
- package/README.zh-CN.md +177 -0
- package/assets/branding/sfml-js-symbol-pentagon.svg +24 -0
- package/assets/branding/sfml-js-wordmark-dark.svg +20 -0
- package/assets/branding/sfml-js-wordmark.svg +19 -0
- package/assets/breakout.png +0 -0
- package/dist/audio/effect-processor.d.ts +53 -8
- package/dist/audio/effect-processor.js +35 -5
- package/dist/audio/input-sound-file.d.ts +101 -15
- package/dist/audio/input-sound-file.js +101 -15
- package/dist/audio/listener.d.ts +74 -12
- package/dist/audio/listener.js +74 -12
- package/dist/audio/music.d.ts +172 -22
- package/dist/audio/music.js +185 -24
- package/dist/audio/output-sound-file.d.ts +36 -4
- package/dist/audio/output-sound-file.js +36 -4
- package/dist/audio/playback-device.d.ts +103 -17
- package/dist/audio/playback-device.js +97 -16
- package/dist/audio/sound-buffer-recorder.d.ts +89 -9
- package/dist/audio/sound-buffer-recorder.js +89 -9
- package/dist/audio/sound-buffer.d.ts +121 -16
- package/dist/audio/sound-buffer.js +98 -13
- package/dist/audio/sound-file-factory.d.ts +84 -11
- package/dist/audio/sound-file-factory.js +84 -11
- package/dist/audio/sound-file-reader.d.ts +155 -24
- package/dist/audio/sound-file-reader.js +84 -13
- package/dist/audio/sound-file-writer.d.ts +49 -7
- package/dist/audio/sound-file-writer.js +13 -2
- package/dist/audio/sound-recorder.d.ts +143 -19
- package/dist/audio/sound-recorder.js +142 -18
- package/dist/audio/sound-source.d.ts +273 -45
- package/dist/audio/sound-source.js +273 -45
- package/dist/audio/sound-stream.d.ts +57 -9
- package/dist/audio/sound-stream.js +43 -7
- package/dist/audio/sound.d.ts +32 -5
- package/dist/audio/sound.js +32 -5
- package/dist/audio/value.d.ts +291 -48
- package/dist/audio/value.js +235 -39
- package/dist/audio/worker.d.ts +256 -38
- package/dist/graphics/blend-mode.d.ts +199 -33
- package/dist/graphics/blend-mode.js +163 -27
- package/dist/graphics/boolean-vector.d.ts +102 -16
- package/dist/graphics/boolean-vector.js +102 -16
- package/dist/graphics/circle-shape.d.ts +68 -11
- package/dist/graphics/circle-shape.js +37 -6
- package/dist/graphics/color.d.ts +227 -42
- package/dist/graphics/color.js +177 -32
- package/dist/graphics/convex-shape.d.ts +45 -7
- package/dist/graphics/convex-shape.js +31 -5
- package/dist/graphics/drawable.d.ts +15 -2
- package/dist/graphics/drawable.js +6 -1
- package/dist/graphics/font.d.ts +153 -24
- package/dist/graphics/font.js +116 -18
- package/dist/graphics/glsl-matrix.d.ts +44 -7
- package/dist/graphics/glsl-matrix.js +44 -7
- package/dist/graphics/glsl.d.ts +129 -21
- package/dist/graphics/glsl.js +123 -20
- package/dist/graphics/glyph.d.ts +106 -17
- package/dist/graphics/glyph.js +76 -12
- package/dist/graphics/image.d.ts +159 -24
- package/dist/graphics/image.js +122 -18
- package/dist/graphics/primitive-type.d.ts +42 -7
- package/dist/graphics/primitive-type.js +42 -7
- package/dist/graphics/rect.d.ts +162 -26
- package/dist/graphics/rect.js +101 -16
- package/dist/graphics/rectangle-shape.d.ts +44 -7
- package/dist/graphics/rectangle-shape.js +31 -5
- package/dist/graphics/render-states.d.ts +153 -25
- package/dist/graphics/render-states.js +49 -8
- package/dist/graphics/render-target.d.ts +145 -22
- package/dist/graphics/render-target.js +110 -17
- package/dist/graphics/render-texture.d.ts +100 -16
- package/dist/graphics/render-texture.js +80 -13
- package/dist/graphics/render-window.d.ts +106 -17
- package/dist/graphics/render-window.js +57 -9
- package/dist/graphics/shader.d.ts +153 -24
- package/dist/graphics/shader.js +126 -20
- package/dist/graphics/shape.d.ts +133 -21
- package/dist/graphics/shape.js +115 -18
- package/dist/graphics/sprite.d.ts +71 -11
- package/dist/graphics/sprite.js +57 -9
- package/dist/graphics/stencil-mode.d.ts +193 -32
- package/dist/graphics/stencil-mode.js +121 -20
- package/dist/graphics/swap.d.ts +13 -2
- package/dist/graphics/text.d.ts +624 -103
- package/dist/graphics/text.js +443 -73
- package/dist/graphics/texture.d.ts +209 -32
- package/dist/graphics/texture.js +137 -21
- package/dist/graphics/transform.d.ts +93 -14
- package/dist/graphics/transform.js +93 -14
- package/dist/graphics/transformable.d.ts +13 -2
- package/dist/graphics/transformable.js +13 -2
- package/dist/graphics/vertex-array.d.ts +83 -14
- package/dist/graphics/vertex-array.js +70 -12
- package/dist/graphics/vertex-buffer.d.ts +162 -26
- package/dist/graphics/vertex-buffer.js +106 -17
- package/dist/graphics/vertex.d.ts +83 -14
- package/dist/graphics/vertex.js +43 -7
- package/dist/graphics/view.d.ts +140 -22
- package/dist/graphics/view.js +103 -16
- package/dist/internal/glsl-value.d.ts +30 -5
- package/dist/internal/glsl-value.js +30 -5
- package/dist/internal/scalar.d.ts +9 -1
- package/dist/internal/transformable.d.ts +84 -13
- package/dist/internal/value-storage.d.ts +8 -1
- package/dist/network/common.d.ts +6 -1
- package/dist/network/common.js +6 -1
- package/dist/network/dns.d.ts +103 -14
- package/dist/network/dns.js +55 -6
- package/dist/network/ftp.d.ts +217 -33
- package/dist/network/ftp.js +217 -33
- package/dist/network/gen/constants.d.ts +750 -124
- package/dist/network/gen/constants.js +750 -124
- package/dist/network/http.d.ts +365 -57
- package/dist/network/http.js +365 -57
- package/dist/network/ip-address.d.ts +179 -26
- package/dist/network/ip-address.js +164 -24
- package/dist/network/packet.d.ts +200 -29
- package/dist/network/packet.js +101 -13
- package/dist/network/sftp.d.ts +525 -84
- package/dist/network/sftp.js +322 -53
- package/dist/network/socket-selector.d.ts +109 -15
- package/dist/network/socket-selector.js +103 -14
- package/dist/network/socket.d.ts +245 -33
- package/dist/network/socket.js +205 -28
- package/dist/network/tcp-listener.d.ts +91 -13
- package/dist/network/tcp-listener.js +85 -12
- package/dist/network/tcp-socket.d.ts +232 -33
- package/dist/network/tcp-socket.js +153 -22
- package/dist/network/tls-material.d.ts +18 -2
- package/dist/network/tls-material.js +18 -2
- package/dist/network/udp-socket.d.ts +137 -19
- package/dist/network/udp-socket.js +101 -13
- package/dist/system/angle.d.ts +60 -10
- package/dist/system/angle.js +60 -10
- package/dist/system/clock.d.ts +51 -8
- package/dist/system/clock.js +51 -8
- package/dist/system/err.d.ts +14 -2
- package/dist/system/err.js +14 -2
- package/dist/system/error.d.ts +12 -2
- package/dist/system/error.js +12 -2
- package/dist/system/file-input-stream.d.ts +54 -7
- package/dist/system/file-input-stream.js +54 -7
- package/dist/system/input-stream.d.ts +97 -13
- package/dist/system/input-stream.js +60 -8
- package/dist/system/operators.d.ts +146 -19
- package/dist/system/operators.js +118 -15
- package/dist/system/sleep.d.ts +6 -1
- package/dist/system/sleep.js +6 -1
- package/dist/system/suspend-aware-clock.d.ts +18 -3
- package/dist/system/suspend-aware-clock.js +18 -3
- package/dist/system/time.d.ts +81 -12
- package/dist/system/time.js +63 -9
- package/dist/system/timeout-with-predicate.d.ts +48 -7
- package/dist/system/timeout-with-predicate.js +20 -3
- package/dist/system/unicode.d.ts +42 -6
- package/dist/system/unicode.js +42 -6
- package/dist/system/vector2.d.ts +240 -36
- package/dist/system/vector2.js +105 -16
- package/dist/system/vector3.d.ts +197 -31
- package/dist/system/vector3.js +104 -16
- package/dist/system/version.d.ts +43 -7
- package/dist/system/version.js +7 -1
- package/dist/window/clipboard.d.ts +12 -2
- package/dist/window/clipboard.js +12 -2
- package/dist/window/context-settings.d.ts +78 -13
- package/dist/window/context-settings.js +30 -5
- package/dist/window/context.d.ts +70 -10
- package/dist/window/context.js +52 -7
- package/dist/window/cursor.d.ts +44 -6
- package/dist/window/cursor.js +28 -4
- package/dist/window/event.d.ts +423 -70
- package/dist/window/event.js +36 -6
- package/dist/window/gen/constants.d.ts +1890 -314
- package/dist/window/gen/constants.js +1890 -314
- package/dist/window/joystick.d.ts +67 -11
- package/dist/window/joystick.js +43 -7
- package/dist/window/keyboard.d.ts +42 -6
- package/dist/window/keyboard.js +26 -4
- package/dist/window/mouse.d.ts +24 -3
- package/dist/window/mouse.js +24 -3
- package/dist/window/sensor.d.ts +20 -3
- package/dist/window/sensor.js +20 -3
- package/dist/window/touch.d.ts +19 -4
- package/dist/window/touch.js +19 -4
- package/dist/window/video-mode.d.ts +61 -10
- package/dist/window/video-mode.js +36 -6
- package/dist/window/vulkan.d.ts +26 -3
- package/dist/window/vulkan.js +26 -3
- package/dist/window/window.d.ts +296 -44
- package/dist/window/window.js +241 -34
- package/docs/README.ja.md +30 -0
- package/docs/README.ko.md +30 -0
- package/docs/README.md +30 -0
- package/docs/README.zh-CN.md +30 -0
- package/docs/api.ja.md +84 -0
- package/docs/api.ko.md +84 -0
- package/docs/api.md +48 -1080
- package/docs/api.zh-CN.md +81 -0
- package/docs/audio.ja.md +249 -0
- package/docs/audio.ko.md +251 -0
- package/docs/audio.md +132 -92
- package/docs/audio.zh-CN.md +252 -0
- package/docs/concepts.ja.md +130 -0
- package/docs/concepts.ko.md +130 -0
- package/docs/concepts.md +131 -0
- package/docs/concepts.zh-CN.md +131 -0
- package/docs/development.ja.md +144 -0
- package/docs/development.ko.md +144 -0
- package/docs/development.md +112 -43
- package/docs/development.zh-CN.md +146 -0
- package/docs/getting-started.ja.md +154 -0
- package/docs/getting-started.ko.md +154 -0
- package/docs/getting-started.md +156 -0
- package/docs/getting-started.zh-CN.md +156 -0
- package/docs/graphics.ja.md +256 -0
- package/docs/graphics.ko.md +254 -0
- package/docs/graphics.md +255 -0
- package/docs/graphics.zh-CN.md +257 -0
- package/docs/network.ja.md +214 -0
- package/docs/network.ko.md +216 -0
- package/docs/network.md +133 -84
- package/docs/network.zh-CN.md +218 -0
- package/docs/system.ja.md +169 -0
- package/docs/system.ko.md +171 -0
- package/docs/system.md +173 -0
- package/docs/system.zh-CN.md +173 -0
- package/docs/window.ja.md +138 -0
- package/docs/window.ko.md +140 -0
- package/docs/window.md +141 -0
- package/docs/window.zh-CN.md +141 -0
- package/native/shared-handle.h +41 -3
- package/package.json +17 -6
- package/src/audio/effect-processor.ts +53 -8
- package/src/audio/input-sound-file.ts +101 -15
- package/src/audio/listener.ts +74 -12
- package/src/audio/music.ts +191 -25
- package/src/audio/output-sound-file.ts +36 -4
- package/src/audio/playback-device.ts +103 -17
- package/src/audio/sound-buffer-recorder.ts +89 -9
- package/src/audio/sound-buffer.ts +121 -16
- package/src/audio/sound-file-factory.ts +84 -11
- package/src/audio/sound-file-reader.ts +155 -24
- package/src/audio/sound-file-writer.ts +49 -7
- package/src/audio/sound-recorder.ts +155 -20
- package/src/audio/sound-source.ts +273 -45
- package/src/audio/sound-stream.ts +57 -9
- package/src/audio/sound.ts +32 -5
- package/src/audio/value.ts +291 -48
- package/src/audio/worker.ts +256 -38
- package/src/graphics/blend-mode.ts +199 -33
- package/src/graphics/boolean-vector.ts +102 -16
- package/src/graphics/circle-shape.ts +68 -11
- package/src/graphics/color.ts +227 -42
- package/src/graphics/convex-shape.ts +45 -7
- package/src/graphics/drawable.ts +15 -2
- package/src/graphics/font.ts +153 -24
- package/src/graphics/glsl-matrix.ts +44 -7
- package/src/graphics/glsl.ts +129 -21
- package/src/graphics/glyph.ts +106 -17
- package/src/graphics/image.ts +159 -24
- package/src/graphics/primitive-type.ts +42 -7
- package/src/graphics/rect.ts +162 -26
- package/src/graphics/rectangle-shape.ts +44 -7
- package/src/graphics/render-states.ts +153 -25
- package/src/graphics/render-target.ts +145 -22
- package/src/graphics/render-texture.ts +100 -16
- package/src/graphics/render-window.ts +113 -18
- package/src/graphics/shader.ts +153 -24
- package/src/graphics/shape.ts +133 -21
- package/src/graphics/sprite.ts +71 -11
- package/src/graphics/stencil-mode.ts +193 -32
- package/src/graphics/swap.ts +13 -2
- package/src/graphics/text.ts +624 -103
- package/src/graphics/texture.ts +209 -32
- package/src/graphics/transform.ts +93 -14
- package/src/graphics/transformable.ts +13 -2
- package/src/graphics/vertex-array.ts +83 -14
- package/src/graphics/vertex-buffer.ts +162 -26
- package/src/graphics/vertex.ts +83 -14
- package/src/graphics/view.ts +140 -22
- package/src/internal/glsl-value.ts +30 -5
- package/src/internal/scalar.ts +9 -1
- package/src/internal/transformable.ts +84 -13
- package/src/internal/value-storage.ts +8 -1
- package/src/network/common.ts +6 -1
- package/src/network/dns.ts +103 -14
- package/src/network/ftp.ts +217 -33
- package/src/network/gen/constants.ts +750 -124
- package/src/network/http.ts +365 -57
- package/src/network/ip-address.ts +179 -26
- package/src/network/packet.ts +200 -29
- package/src/network/sftp.ts +525 -84
- package/src/network/socket-selector.ts +109 -15
- package/src/network/socket.ts +245 -33
- package/src/network/tcp-listener.ts +91 -13
- package/src/network/tcp-socket.ts +232 -33
- package/src/network/tls-material.ts +18 -2
- package/src/network/udp-socket.ts +137 -19
- package/src/system/angle.ts +60 -10
- package/src/system/clock.ts +51 -8
- package/src/system/err.ts +14 -2
- package/src/system/error.ts +12 -2
- package/src/system/file-input-stream.ts +54 -7
- package/src/system/input-stream.ts +97 -13
- package/src/system/operators.ts +146 -19
- package/src/system/sleep.ts +6 -1
- package/src/system/suspend-aware-clock.ts +18 -3
- package/src/system/time.ts +81 -12
- package/src/system/timeout-with-predicate.ts +48 -7
- package/src/system/unicode.ts +42 -6
- package/src/system/vector2.ts +240 -36
- package/src/system/vector3.ts +197 -31
- package/src/system/version.ts +43 -7
- package/src/window/clipboard.ts +12 -2
- package/src/window/context-settings.ts +78 -13
- package/src/window/context.ts +70 -10
- package/src/window/cursor.ts +44 -6
- package/src/window/event.ts +423 -70
- package/src/window/gen/constants.ts +1890 -314
- package/src/window/joystick.ts +67 -11
- package/src/window/keyboard.ts +42 -6
- package/src/window/mouse.ts +24 -3
- package/src/window/sensor.ts +20 -3
- package/src/window/touch.ts +19 -4
- package/src/window/video-mode.ts +61 -10
- package/src/window/vulkan.ts +26 -3
- package/src/window/window.ts +314 -46
- package/tools/constant-docs.cjs +109 -0
- package/tools/constant-docs.json +1318 -0
- package/tools/generate-network-constants.cjs +21 -9
- package/tools/generate-window-constants.cjs +26 -12
package/dist/audio/music.js
CHANGED
|
@@ -9,45 +9,127 @@ const value_1 = require("./value");
|
|
|
9
9
|
const audio_codec_registry_1 = require("../internal/audio-codec-registry");
|
|
10
10
|
const audio_music_pump_1 = require("../internal/audio-music-pump");
|
|
11
11
|
const input_sound_file_1 = require("./input-sound-file");
|
|
12
|
-
/**
|
|
12
|
+
/**
|
|
13
|
+
* super inside a callback always accesses the session that initiated it.
|
|
14
|
+
* @zh 回调内的 super 始终访问发起该回调的会话。
|
|
15
|
+
* @ja コールバック内の super は常にそのコールバックを開始したセッションにアクセスします。
|
|
16
|
+
* @ko 콜백 내부의 super는 항상 해당 콜백을 시작한 세션에 접근합니다.
|
|
17
|
+
*/
|
|
13
18
|
const callbackContext = new node_async_hooks_1.AsyncLocalStorage();
|
|
14
|
-
/**
|
|
19
|
+
/**
|
|
20
|
+
* Retain only the decoding session for Music finalization; session callbacks
|
|
21
|
+
* must hold only weak references to Music.
|
|
22
|
+
* @zh 回收 Music 时仅持有解码会话;会话回调只能弱引用 Music。
|
|
23
|
+
* @ja Music の回収時はデコードセッションのみを保持します。
|
|
24
|
+
* セッションコールバックは Music への弱参照のみを持つ必要があります。
|
|
25
|
+
* @ko Music 회수 시 디코딩 세션만 보유합니다.
|
|
26
|
+
* 세션 콜백은 Music에 대한 약한 참조만 가져야 합니다.
|
|
27
|
+
*/
|
|
15
28
|
const pumpCleanup = new FinalizationRegistry(pump => {
|
|
16
29
|
void pump.close().catch(() => { });
|
|
17
30
|
});
|
|
18
|
-
/**
|
|
31
|
+
/**
|
|
32
|
+
* Decode and play long audio in blocks without loading all samples into memory
|
|
33
|
+
* at once.
|
|
34
|
+
* @zh 按块解码和播放长音频,无需一次将全部样本加载到内存。
|
|
35
|
+
* @ja 全サンプルを一度にメモリへ読み込まず、長い音声をブロック単位でデコード・再生します。
|
|
36
|
+
* @ko 모든 샘플을 한 번에 메모리에 로드하지 않고 긴 오디오를 블록별로 디코딩하고 재생합니다.
|
|
37
|
+
*/
|
|
19
38
|
class Music extends sound_stream_1.SoundStream {
|
|
20
|
-
/**
|
|
39
|
+
/**
|
|
40
|
+
* Create a music playback source with no open content.
|
|
41
|
+
* @zh 创建未打开内容的音乐播放源。
|
|
42
|
+
* @ja コンテンツを開いていない音楽再生音源を作成します。
|
|
43
|
+
* @ko 콘텐츠가 열리지 않은 음악 재생 음원을 생성합니다.
|
|
44
|
+
*/
|
|
21
45
|
constructor() {
|
|
22
46
|
super(undefined, audio_native_1.audioNative.createAudioSource());
|
|
23
|
-
/**
|
|
47
|
+
/**
|
|
48
|
+
* Serialize open and close operations.
|
|
49
|
+
* @zh 串行管理打开和关闭操作。
|
|
50
|
+
* @ja 開く操作と閉じる操作を直列に管理します。
|
|
51
|
+
* @ko 열기 및 닫기 작업을 직렬로 관리합니다.
|
|
52
|
+
*/
|
|
24
53
|
this.queue = new audio_native_1.AudioQueue();
|
|
25
|
-
/**
|
|
54
|
+
/**
|
|
55
|
+
* Increment on close to cancel earlier open requests not yet installed.
|
|
56
|
+
* @zh 关闭时递增,取消此前尚未安装的打开请求。
|
|
57
|
+
* @ja 閉じる際に増加し、まだ適用されていない以前のオープン要求を取り消します。
|
|
58
|
+
* @ko 닫을 때 증가하여 아직 적용되지 않은 이전 열기 요청을 취소합니다.
|
|
59
|
+
*/
|
|
26
60
|
this.closeGeneration = 0;
|
|
27
61
|
}
|
|
28
|
-
/**
|
|
62
|
+
/**
|
|
63
|
+
* Asynchronously open an audio file for streaming and return whether it
|
|
64
|
+
* succeeded; does not call play automatically.
|
|
65
|
+
* @zh 异步打开音频文件用于流式播放,返回是否成功;不会自动 play。
|
|
66
|
+
* @ja ストリーミング再生用に音声ファイルを非同期で開き、成功したかどうかを返します。
|
|
67
|
+
* play は自動では呼びません。
|
|
68
|
+
* @ko 스트리밍 재생을 위해 오디오 파일을 비동기로 열고 성공 여부를 반환합니다.
|
|
69
|
+
* play를 자동으로 호출하지 않습니다.
|
|
70
|
+
*/
|
|
29
71
|
openFromFile(filename) { return this.open(filename); }
|
|
30
|
-
/**
|
|
72
|
+
/**
|
|
73
|
+
* Asynchronously open encoded audio bytes for streaming, returning whether it
|
|
74
|
+
* succeeded.
|
|
75
|
+
* @zh 异步打开编码音频字节用于流式播放,返回是否成功。
|
|
76
|
+
* @ja ストリーミング用にエンコード済み音声バイトを非同期で開き、
|
|
77
|
+
* 成功したかどうかを返します。
|
|
78
|
+
* @ko 스트리밍 재생을 위해 인코딩된 오디오 바이트를 비동기로 열고 성공 여부를 반환합니다.
|
|
79
|
+
*/
|
|
31
80
|
openFromMemory(data) { return this.open(data); }
|
|
32
|
-
/**
|
|
81
|
+
/**
|
|
82
|
+
* Asynchronously open a seekable stream, retaining the data source needed for
|
|
83
|
+
* decoding until close.
|
|
84
|
+
* @zh 异步打开可寻址流,保留解码所需的数据源直到 close。
|
|
85
|
+
* @ja シーク可能なストリームを非同期で開き、
|
|
86
|
+
* デコードに必要なデータソースを close まで保持します。
|
|
87
|
+
* @ko 탐색 가능한 스트림을 비동기로 열고,
|
|
88
|
+
* 디코딩에 필요한 데이터 소스를 close까지 유지합니다.
|
|
89
|
+
*/
|
|
33
90
|
openFromStream(stream) {
|
|
34
91
|
return this.open(stream);
|
|
35
92
|
}
|
|
36
|
-
/**
|
|
93
|
+
/**
|
|
94
|
+
* Return the latest streaming decoder pump error, or undefined if no pump is
|
|
95
|
+
* used or no error exists.
|
|
96
|
+
* @zh 返回流式解码泵最近的错误;未使用解码泵或无错误时为 undefined。
|
|
97
|
+
* @ja ストリーミングデコードポンプの最新エラーを返します。
|
|
98
|
+
* ポンプを使っていないかエラーがなければ undefined。
|
|
99
|
+
* @ko 스트리밍 디코딩 펌프의 최근 오류를 반환합니다.
|
|
100
|
+
* 펌프를 사용하지 않거나 오류가 없으면 undefined입니다.
|
|
101
|
+
*/
|
|
37
102
|
getWorkerError() { return this.pump?.error; }
|
|
38
|
-
/**
|
|
103
|
+
/**
|
|
104
|
+
* Return streaming decoder queue statistics, or undefined if no pump is used.
|
|
105
|
+
* @zh 返回流式解码队列统计;未使用解码泵时为 undefined。
|
|
106
|
+
* @ja ストリーミングデコードキューの統計を返します。ポンプ未使用なら undefined。
|
|
107
|
+
* @ko 스트리밍 디코딩 큐 통계를 반환합니다. 디코딩 펌프를 사용하지 않으면 undefined입니다.
|
|
108
|
+
*/
|
|
39
109
|
getWorkerStats() {
|
|
40
110
|
return this.pump?.getStats();
|
|
41
111
|
}
|
|
42
112
|
/**
|
|
43
|
-
*
|
|
113
|
+
* Stop playback and asynchronously close the decoding data source.
|
|
114
|
+
* Inside this object's own audio callback, only request closure; actual
|
|
115
|
+
* cleanup completes after that callback ends.
|
|
116
|
+
* @zh 停止播放并异步关闭解码数据源。
|
|
44
117
|
* 在自身音频回调内调用时只请求关闭;实际清理于该回调结束后完成。
|
|
118
|
+
* @ja 再生を停止し、デコード用データソースを非同期で閉じます。
|
|
119
|
+
* 自身の音声コールバック内では終了を要求するだけで、
|
|
120
|
+
* 実際のクリーンアップはそのコールバック終了後に完了します。
|
|
121
|
+
* @ko 재생을 중지하고 디코딩 데이터 소스를 비동기로 닫습니다.
|
|
122
|
+
* 자신의 오디오 콜백 내에서는 닫기만 요청하며,
|
|
123
|
+
* 실제 정리는 해당 콜백이 끝난 후 완료됩니다.
|
|
45
124
|
*/
|
|
46
125
|
close() {
|
|
47
126
|
++this.closeGeneration;
|
|
48
127
|
const context = callbackContext.getStore();
|
|
49
128
|
const reentrant = context?.owner.deref() === this;
|
|
50
|
-
//
|
|
129
|
+
// Stop feeding before queueing cleanup so open cannot wait for initial data.
|
|
130
|
+
// @zh 先终止供数,再排队等待清理,避免打开过程仍在等待首批数据。
|
|
131
|
+
// @ja 先に供給を停止してから後処理をキューに入れ、初期データ待ちを防ぎます。
|
|
132
|
+
// @ko 열기가 초기 데이터를 기다리지 않도록 공급 중단 후 정리를 큐에 넣습니다.
|
|
51
133
|
this.pump?.requestClose();
|
|
52
134
|
if (reentrant && context.pump !== this.pump)
|
|
53
135
|
context.pump.requestClose();
|
|
@@ -67,15 +149,30 @@ class Music extends sound_stream_1.SoundStream {
|
|
|
67
149
|
}
|
|
68
150
|
return closed;
|
|
69
151
|
}
|
|
70
|
-
/**
|
|
152
|
+
/**
|
|
153
|
+
* Return the total music duration.
|
|
154
|
+
* @zh 返回音乐总时长。
|
|
155
|
+
* @ja 音楽全体の長さを返します。
|
|
156
|
+
* @ko 음악의 전체 길이를 반환합니다.
|
|
157
|
+
*/
|
|
71
158
|
getDuration() { this.command(7); return new time_1.Time(this.times[1]); }
|
|
72
|
-
/**
|
|
159
|
+
/**
|
|
160
|
+
* Return a copy of the loop region, including its starting offset and length.
|
|
161
|
+
* @zh 返回循环区间副本,包含起点偏移和长度。
|
|
162
|
+
* @ja 開始オフセットと長さを含むループ区間のコピーを返します。
|
|
163
|
+
* @ko 시작 오프셋과 길이를 포함한 반복 구간 복사본을 반환합니다.
|
|
164
|
+
*/
|
|
73
165
|
getLoopPoints() {
|
|
74
166
|
this.command(6);
|
|
75
167
|
return new value_1.TimeSpan({ offset: new time_1.Time(this.times[2]),
|
|
76
168
|
length: new time_1.Time(this.times[3]) });
|
|
77
169
|
}
|
|
78
|
-
/**
|
|
170
|
+
/**
|
|
171
|
+
* Set the loop region; call setLooping(true) separately to enable looping.
|
|
172
|
+
* @zh 设置循环区间;启用循环需另行调用 setLooping(true)。
|
|
173
|
+
* @ja ループ区間を設定します。有効にするには別途 setLooping(true) を呼びます。
|
|
174
|
+
* @ko 반복 구간을 설정합니다. 반복 활성화는 별도로 setLooping(true)를 호출해야 합니다.
|
|
175
|
+
*/
|
|
79
176
|
setLoopPoints(value) {
|
|
80
177
|
const offset = (0, value_1.duration)(value.offset);
|
|
81
178
|
const length = (0, value_1.duration)(value.length);
|
|
@@ -84,25 +181,63 @@ class Music extends sound_stream_1.SoundStream {
|
|
|
84
181
|
this.command(5);
|
|
85
182
|
}
|
|
86
183
|
/**
|
|
87
|
-
*
|
|
184
|
+
* Fill interleaved 16-bit PCM on the object's owning JS thread; await super
|
|
185
|
+
* to read the current file. samples references a reusable native slot, valid
|
|
186
|
+
* only until the callback ends; false denotes the final block.
|
|
187
|
+
* @zh 在对象所属 JS 线程填充交错 16 位 PCM;await super 可读取当前文件。
|
|
88
188
|
* samples 指向原生可复用槽,仅在回调结束前有效;false 表示末块。
|
|
189
|
+
* @ja オブジェクトの所属 JS スレッドで 16 ビットインターリーブ PCM を埋めます。
|
|
190
|
+
* await super で現在のファイルを読み取れます。samples は再利用可能な
|
|
191
|
+
* ネイティブスロットを参照し、コールバック終了までのみ有効です。
|
|
192
|
+
* false は最終ブロックを示します。
|
|
193
|
+
* @ko 객체가 속한 JS 스레드에서 16비트 인터리브 PCM을 채웁니다.
|
|
194
|
+
* await super로 현재 파일을 읽을 수 있습니다. samples는 재사용 가능한
|
|
195
|
+
* 네이티브 슬롯을 참조하며 콜백 종료 전까지만 유효합니다. false는 마지막 블록입니다.
|
|
89
196
|
*/
|
|
90
197
|
onGetData(chunk) {
|
|
91
198
|
return this.callbackPump().onGetData(chunk);
|
|
92
199
|
}
|
|
93
|
-
/**
|
|
200
|
+
/**
|
|
201
|
+
* Seek on the object's owning JS thread; await super performs the current
|
|
202
|
+
* file's default seek.
|
|
203
|
+
* @zh 在对象所属 JS 线程定位;await super 执行当前文件的默认定位。
|
|
204
|
+
* @ja オブジェクトの所属 JS スレッドでシークします。
|
|
205
|
+
* await super で現在のファイルの既定のシークを実行します。
|
|
206
|
+
* @ko 객체가 속한 JS 스레드에서 탐색합니다.
|
|
207
|
+
* await super는 현재 파일의 기본 탐색을 수행합니다.
|
|
208
|
+
*/
|
|
94
209
|
onSeek(offset) {
|
|
95
210
|
return this.callbackPump().onSeek(offset);
|
|
96
211
|
}
|
|
97
212
|
/**
|
|
98
|
-
*
|
|
213
|
+
* Called on the object's owning JS thread while preparing the final block;
|
|
214
|
+
* return the next loop's interleaved sample offset. super returns the file's
|
|
215
|
+
* loop region or EOF position; undefined means no loop. The audio consumer
|
|
216
|
+
* thread initiates the actual seek, then asynchronously delegates to onSeek.
|
|
217
|
+
* @zh 在对象所属 JS 线程准备末块时调用,返回下一轮交错样本偏移。
|
|
99
218
|
* super 返回文件循环区间或 EOF 的位置;undefined 表示不循环。
|
|
100
219
|
* 实际定位由音频消费线程发起,再异步交给 onSeek。
|
|
220
|
+
* @ja 最終ブロックの準備中にオブジェクトの所属 JS スレッドで呼ばれ、
|
|
221
|
+
* 次のループのインターリーブサンプルオフセットを返します。super は
|
|
222
|
+
* ファイルのループ区間または EOF の位置を返し、undefined はループなしを表します。
|
|
223
|
+
* 実際のシークは音声消費スレッドが開始し、非同期で onSeek に委譲します。
|
|
224
|
+
* @ko 마지막 블록 준비 중 객체가 속한 JS 스레드에서 호출되며
|
|
225
|
+
* 다음 반복의 인터리브 샘플 오프셋을 반환합니다. super는 파일의 반복 구간
|
|
226
|
+
* 또는 EOF 위치를 반환하며 undefined는 반복하지 않음을 뜻합니다.
|
|
227
|
+
* 실제 탐색은 오디오 소비 스레드가 시작한 후 비동기로 onSeek에 넘깁니다.
|
|
101
228
|
*/
|
|
102
229
|
onLoop() {
|
|
103
230
|
return this.callbackPump().onLoop();
|
|
104
231
|
}
|
|
105
|
-
/**
|
|
232
|
+
/**
|
|
233
|
+
* Get the current callback's session to avoid writing to newly opened music
|
|
234
|
+
* after await.
|
|
235
|
+
* @zh 获取当前回调所属的会话,避免 await 后误写新打开的音乐。
|
|
236
|
+
* @ja 現在のコールバックのセッションを取得し、
|
|
237
|
+
* await 後に新しく開いた音楽へ誤って書き込むのを防ぎます。
|
|
238
|
+
* @ko 현재 콜백이 속한 세션을 가져와 await 후 새로 열린 음악에
|
|
239
|
+
* 잘못 기록하는 것을 방지합니다.
|
|
240
|
+
*/
|
|
106
241
|
callbackPump() {
|
|
107
242
|
const context = callbackContext.getStore();
|
|
108
243
|
if (context?.owner.deref() !== this) {
|
|
@@ -110,7 +245,15 @@ class Music extends sound_stream_1.SoundStream {
|
|
|
110
245
|
}
|
|
111
246
|
return context.pump;
|
|
112
247
|
}
|
|
113
|
-
/**
|
|
248
|
+
/**
|
|
249
|
+
* Install weak-reference dispatchers only for subclass callback overrides,
|
|
250
|
+
* preserving the native path for ordinary instances.
|
|
251
|
+
* @zh 仅在子类覆写回调时安装弱引用派发器,保留普通实例 Native 路径。
|
|
252
|
+
* @ja サブクラスがコールバックをオーバーライドした場合のみ弱参照の
|
|
253
|
+
* ディスパッチャーを設定し、通常のインスタンスの Native 経路を維持します。
|
|
254
|
+
* @ko 하위 클래스가 콜백을 재정의할 때만 약한 참조 디스패처를 설치하여
|
|
255
|
+
* 일반 인스턴스의 Native 경로를 유지합니다.
|
|
256
|
+
*/
|
|
114
257
|
createCallbacks() {
|
|
115
258
|
if (this.onGetData === Music.prototype.onGetData &&
|
|
116
259
|
this.onSeek === Music.prototype.onSeek &&
|
|
@@ -135,14 +278,27 @@ class Music extends sound_stream_1.SoundStream {
|
|
|
135
278
|
onLoop: pump => callbackContext.run({ owner, pump }, () => owner.deref()?.onLoop()),
|
|
136
279
|
};
|
|
137
280
|
}
|
|
138
|
-
/**
|
|
281
|
+
/**
|
|
282
|
+
* Detach the current session and await native queue and file cleanup.
|
|
283
|
+
* @zh 脱离当前会话并等待 Native 队列和文件清理。
|
|
284
|
+
* @ja 現在のセッションを切り離し、Native キューとファイルの後処理を待ちます。
|
|
285
|
+
* @ko 현재 세션을 분리하고 Native 큐와 파일 정리를 기다립니다.
|
|
286
|
+
*/
|
|
139
287
|
async closePump() {
|
|
140
288
|
pumpCleanup.unregister(this);
|
|
141
289
|
const pump = this.pump;
|
|
142
290
|
this.pump = undefined;
|
|
143
291
|
await pump?.close();
|
|
144
292
|
}
|
|
145
|
-
/**
|
|
293
|
+
/**
|
|
294
|
+
* Open a new file; reject reopening inside session callbacks to avoid waiting
|
|
295
|
+
* for their own preparation phase.
|
|
296
|
+
* @zh 打开新文件;会话回调中拒绝重开,避免等待其自身的准备阶段。
|
|
297
|
+
* @ja 新しいファイルを開きます。自身の準備段階を待たないよう、
|
|
298
|
+
* セッションコールバック内での再オープンは拒否します。
|
|
299
|
+
* @ko 새 파일을 엽니다. 자신의 준비 단계를 기다리지 않도록
|
|
300
|
+
* 세션 콜백 내에서 다시 여는 요청은 거부합니다.
|
|
301
|
+
*/
|
|
146
302
|
open(input) {
|
|
147
303
|
if (callbackContext.getStore()?.owner.deref() === this) {
|
|
148
304
|
return Promise.reject(new Error('Cannot reopen Music inside its callback'));
|
|
@@ -187,6 +343,11 @@ class Music extends sound_stream_1.SoundStream {
|
|
|
187
343
|
});
|
|
188
344
|
}
|
|
189
345
|
}
|
|
190
|
-
/**
|
|
346
|
+
/**
|
|
347
|
+
* Time span type for the loop region.
|
|
348
|
+
* @zh 循环区间的时间段类型。
|
|
349
|
+
* @ja ループ区間の時間範囲の型。
|
|
350
|
+
* @ko 반복 구간의 시간 범위 타입입니다.
|
|
351
|
+
*/
|
|
191
352
|
Music.TimeSpan = value_1.TimeSpan;
|
|
192
353
|
exports.Music = Music;
|
|
@@ -1,15 +1,47 @@
|
|
|
1
1
|
import { audioHandle } from '../internal/audio-native';
|
|
2
2
|
import { type SoundChannel } from './value';
|
|
3
|
-
/**
|
|
3
|
+
/**
|
|
4
|
+
* Asynchronously encode interleaved 16-bit PCM into an audio file whose format
|
|
5
|
+
* is determined by the file extension.
|
|
6
|
+
* @zh 将交错 16 位 PCM 异步编码到音频文件,格式由文件扩展名决定。
|
|
7
|
+
* @ja 16 ビットインターリーブ PCM を音声ファイルに非同期でエンコードします。
|
|
8
|
+
* 形式はファイルの拡張子で決まります。
|
|
9
|
+
* @ko 16비트 인터리브 PCM을 오디오 파일로 비동기 인코딩합니다.
|
|
10
|
+
* 형식은 파일 확장자로 결정됩니다.
|
|
11
|
+
*/
|
|
4
12
|
export declare class OutputSoundFile {
|
|
5
13
|
readonly [audioHandle]: import("../internal/audio-native").AudioHandle<"output">;
|
|
6
14
|
private readonly queue;
|
|
7
15
|
private writer?;
|
|
8
|
-
/**
|
|
16
|
+
/**
|
|
17
|
+
* Close the previous output and asynchronously create a file, with sample
|
|
18
|
+
* rate in Hz; return whether it succeeded.
|
|
19
|
+
* @zh 关闭旧输出并异步创建文件,采样率以 Hz 计,返回是否成功。
|
|
20
|
+
* @ja 以前の出力を閉じて非同期でファイルを作成します。
|
|
21
|
+
* サンプルレートの単位は Hz で、成功したかどうかを返します。
|
|
22
|
+
* @ko 이전 출력을 닫고 파일을 비동기로 생성합니다.
|
|
23
|
+
* 샘플 레이트는 Hz 단위이며 성공 여부를 반환합니다.
|
|
24
|
+
*/
|
|
9
25
|
openFromFile(filename: string, sampleRate: number, channelCount: number, channelMap: Iterable<SoundChannel>): Promise<boolean>;
|
|
10
|
-
/**
|
|
26
|
+
/**
|
|
27
|
+
* Asynchronously encode samples in order; do not modify data until the
|
|
28
|
+
* Promise settles.
|
|
29
|
+
* @zh 按顺序异步编码样本;Promise 完成前不得修改 data。
|
|
30
|
+
* @ja サンプルを順に非同期でエンコードします。
|
|
31
|
+
* Promise の完了前に data を変更しないでください。
|
|
32
|
+
* @ko 샘플을 순서대로 비동기 인코딩합니다.
|
|
33
|
+
* Promise가 완료되기 전에 data를 수정하면 안 됩니다.
|
|
34
|
+
*/
|
|
11
35
|
write(data: Int16Array): Promise<void>;
|
|
12
|
-
/**
|
|
36
|
+
/**
|
|
37
|
+
* Wait for all writes, flush the encoder, and close the file to ensure
|
|
38
|
+
* complete file contents.
|
|
39
|
+
* @zh 等待所有写入、刷新编码器并关闭文件,确保文件内容完整。
|
|
40
|
+
* @ja すべての書き込みを待ち、エンコーダーをフラッシュしてファイルを閉じ、
|
|
41
|
+
* ファイル内容の完全性を確保します。
|
|
42
|
+
* @ko 모든 쓰기를 기다리고 인코더를 플러시한 뒤 파일을 닫아
|
|
43
|
+
* 파일 내용이 완전히 기록되도록 합니다.
|
|
44
|
+
*/
|
|
13
45
|
close(): Promise<void>;
|
|
14
46
|
private closeCurrent;
|
|
15
47
|
}
|
|
@@ -5,13 +5,29 @@ exports.OutputSoundFile = void 0;
|
|
|
5
5
|
const audio_native_1 = require("../internal/audio-native");
|
|
6
6
|
const value_1 = require("./value");
|
|
7
7
|
const audio_codec_registry_1 = require("../internal/audio-codec-registry");
|
|
8
|
-
/**
|
|
8
|
+
/**
|
|
9
|
+
* Asynchronously encode interleaved 16-bit PCM into an audio file whose format
|
|
10
|
+
* is determined by the file extension.
|
|
11
|
+
* @zh 将交错 16 位 PCM 异步编码到音频文件,格式由文件扩展名决定。
|
|
12
|
+
* @ja 16 ビットインターリーブ PCM を音声ファイルに非同期でエンコードします。
|
|
13
|
+
* 形式はファイルの拡張子で決まります。
|
|
14
|
+
* @ko 16비트 인터리브 PCM을 오디오 파일로 비동기 인코딩합니다.
|
|
15
|
+
* 형식은 파일 확장자로 결정됩니다.
|
|
16
|
+
*/
|
|
9
17
|
class OutputSoundFile {
|
|
10
18
|
constructor() {
|
|
11
19
|
this[_a] = audio_native_1.audioNative.createAudioOutput();
|
|
12
20
|
this.queue = new audio_native_1.AudioQueue();
|
|
13
21
|
}
|
|
14
|
-
/**
|
|
22
|
+
/**
|
|
23
|
+
* Close the previous output and asynchronously create a file, with sample
|
|
24
|
+
* rate in Hz; return whether it succeeded.
|
|
25
|
+
* @zh 关闭旧输出并异步创建文件,采样率以 Hz 计,返回是否成功。
|
|
26
|
+
* @ja 以前の出力を閉じて非同期でファイルを作成します。
|
|
27
|
+
* サンプルレートの単位は Hz で、成功したかどうかを返します。
|
|
28
|
+
* @ko 이전 출력을 닫고 파일을 비동기로 생성합니다.
|
|
29
|
+
* 샘플 레이트는 Hz 단위이며 성공 여부를 반환합니다.
|
|
30
|
+
*/
|
|
15
31
|
openFromFile(filename, sampleRate, channelCount, channelMap) {
|
|
16
32
|
(0, value_1.unsigned)(sampleRate);
|
|
17
33
|
(0, value_1.unsigned)(channelCount);
|
|
@@ -39,7 +55,15 @@ class OutputSoundFile {
|
|
|
39
55
|
}
|
|
40
56
|
});
|
|
41
57
|
}
|
|
42
|
-
/**
|
|
58
|
+
/**
|
|
59
|
+
* Asynchronously encode samples in order; do not modify data until the
|
|
60
|
+
* Promise settles.
|
|
61
|
+
* @zh 按顺序异步编码样本;Promise 完成前不得修改 data。
|
|
62
|
+
* @ja サンプルを順に非同期でエンコードします。
|
|
63
|
+
* Promise の完了前に data を変更しないでください。
|
|
64
|
+
* @ko 샘플을 순서대로 비동기 인코딩합니다.
|
|
65
|
+
* Promise가 완료되기 전에 data를 수정하면 안 됩니다.
|
|
66
|
+
*/
|
|
43
67
|
write(data) {
|
|
44
68
|
(0, value_1.samples)(data);
|
|
45
69
|
return this.queue.run(async () => {
|
|
@@ -51,7 +75,15 @@ class OutputSoundFile {
|
|
|
51
75
|
}
|
|
52
76
|
});
|
|
53
77
|
}
|
|
54
|
-
/**
|
|
78
|
+
/**
|
|
79
|
+
* Wait for all writes, flush the encoder, and close the file to ensure
|
|
80
|
+
* complete file contents.
|
|
81
|
+
* @zh 等待所有写入、刷新编码器并关闭文件,确保文件内容完整。
|
|
82
|
+
* @ja すべての書き込みを待ち、エンコーダーをフラッシュしてファイルを閉じ、
|
|
83
|
+
* ファイル内容の完全性を確保します。
|
|
84
|
+
* @ko 모든 쓰기를 기다리고 인코더를 플러시한 뒤 파일을 닫아
|
|
85
|
+
* 파일 내용이 완전히 기록되도록 합니다.
|
|
86
|
+
*/
|
|
55
87
|
close() {
|
|
56
88
|
return this.queue.run(() => this.closeCurrent());
|
|
57
89
|
}
|
|
@@ -1,35 +1,121 @@
|
|
|
1
|
-
/**
|
|
1
|
+
/**
|
|
2
|
+
* Lifecycle notifications for the audio playback device.
|
|
3
|
+
* @zh 音频播放设备的生命周期通知。
|
|
4
|
+
* @ja 音声再生デバイスのライフサイクル通知。
|
|
5
|
+
* @ko 오디오 재생 장치의 수명 주기 알림입니다.
|
|
6
|
+
*/
|
|
2
7
|
export declare enum Notification {
|
|
3
|
-
/**
|
|
8
|
+
/**
|
|
9
|
+
* The device started.
|
|
10
|
+
* @zh 设备开始运行。
|
|
11
|
+
* @ja デバイスが動作を開始しました。
|
|
12
|
+
* @ko 장치가 작동을 시작했습니다.
|
|
13
|
+
*/
|
|
4
14
|
DeviceStarted = 0,
|
|
5
|
-
/**
|
|
15
|
+
/**
|
|
16
|
+
* The device stopped.
|
|
17
|
+
* @zh 设备停止运行。
|
|
18
|
+
* @ja デバイスが停止しました。
|
|
19
|
+
* @ko 장치가 작동을 중지했습니다.
|
|
20
|
+
*/
|
|
6
21
|
DeviceStopped = 1,
|
|
7
|
-
/**
|
|
22
|
+
/**
|
|
23
|
+
* The audio output route changed.
|
|
24
|
+
* @zh 音频输出路由发生变化。
|
|
25
|
+
* @ja 音声出力の経路が変わりました。
|
|
26
|
+
* @ko 오디오 출력 경로가 변경되었습니다.
|
|
27
|
+
*/
|
|
8
28
|
DeviceRerouted = 2,
|
|
9
|
-
/**
|
|
29
|
+
/**
|
|
30
|
+
* A system interruption began.
|
|
31
|
+
* @zh 系统中断开始。
|
|
32
|
+
* @ja システムによる割り込みが始まりました。
|
|
33
|
+
* @ko 시스템 인터럽트가 시작되었습니다.
|
|
34
|
+
*/
|
|
10
35
|
DeviceInterruptionBegan = 3,
|
|
11
|
-
/**
|
|
36
|
+
/**
|
|
37
|
+
* A system interruption ended.
|
|
38
|
+
* @zh 系统中断结束。
|
|
39
|
+
* @ja システムによる割り込みが終了しました。
|
|
40
|
+
* @ko 시스템 인터럽트가 끝났습니다.
|
|
41
|
+
*/
|
|
12
42
|
DeviceInterruptionEnded = 4,
|
|
13
|
-
/**
|
|
43
|
+
/**
|
|
44
|
+
* The device was unlocked.
|
|
45
|
+
* @zh 设备解除锁定。
|
|
46
|
+
* @ja デバイスのロックが解除されました。
|
|
47
|
+
* @ko 장치 잠금이 해제되었습니다.
|
|
48
|
+
*/
|
|
14
49
|
DeviceUnlocked = 5
|
|
15
50
|
}
|
|
16
|
-
/**
|
|
51
|
+
/**
|
|
52
|
+
* Callback receiving playback device status notifications.
|
|
53
|
+
* @zh 接收播放设备状态通知的回调。
|
|
54
|
+
* @ja 再生デバイスの状態通知を受け取るコールバック。
|
|
55
|
+
* @ko 재생 장치 상태 알림을 받는 콜백입니다.
|
|
56
|
+
*/
|
|
17
57
|
export type NotificationCallback = (notification: Notification) => void;
|
|
18
|
-
/**
|
|
58
|
+
/**
|
|
59
|
+
* Return the names of available playback devices.
|
|
60
|
+
* @zh 返回可用播放设备名称。
|
|
61
|
+
* @ja 利用可能な再生デバイスの名前を返します。
|
|
62
|
+
* @ko 사용 가능한 재생 장치 이름을 반환합니다.
|
|
63
|
+
*/
|
|
19
64
|
export declare function getAvailableDevices(): string[];
|
|
20
|
-
/**
|
|
65
|
+
/**
|
|
66
|
+
* Return the system's default playback device name,
|
|
67
|
+
* or undefined if unavailable.
|
|
68
|
+
* @zh 返回系统默认播放设备名称;不可用时为 undefined。
|
|
69
|
+
* @ja システムの既定の再生デバイス名を返します。利用不可なら undefined。
|
|
70
|
+
* @ko 시스템 기본 재생 장치 이름을 반환합니다. 사용할 수 없으면 undefined입니다.
|
|
71
|
+
*/
|
|
21
72
|
export declare function getDefaultDevice(): string | undefined;
|
|
22
|
-
/**
|
|
73
|
+
/**
|
|
74
|
+
* Switch to the named playback device and return whether it succeeded.
|
|
75
|
+
* @zh 切换到指定名称的播放设备,返回是否成功。
|
|
76
|
+
* @ja 指定名の再生デバイスに切り替え、成功したかどうかを返します。
|
|
77
|
+
* @ko 지정한 이름의 재생 장치로 전환하고 성공 여부를 반환합니다.
|
|
78
|
+
*/
|
|
23
79
|
export declare function setDevice(name: string): boolean;
|
|
24
|
-
/**
|
|
80
|
+
/**
|
|
81
|
+
* Switch to the system's default playback device and report success.
|
|
82
|
+
* @zh 切换到系统默认播放设备,返回是否成功。
|
|
83
|
+
* @ja システムの既定の再生デバイスに切り替え、成功したかどうかを返します。
|
|
84
|
+
* @ko 시스템 기본 재생 장치로 전환하고 성공 여부를 반환합니다.
|
|
85
|
+
*/
|
|
25
86
|
export declare function setDeviceToDefault(): boolean;
|
|
26
|
-
/**
|
|
87
|
+
/**
|
|
88
|
+
* Switch to a null device with no sound output and return whether it succeeded.
|
|
89
|
+
* @zh 切换到不输出声音的空设备,返回是否成功。
|
|
90
|
+
* @ja 音を出力しないヌルデバイスに切り替え、成功したかどうかを返します。
|
|
91
|
+
* @ko 소리를 출력하지 않는 널 장치로 전환하고 성공 여부를 반환합니다.
|
|
92
|
+
*/
|
|
27
93
|
export declare function setDeviceToNull(): boolean;
|
|
28
|
-
/**
|
|
94
|
+
/**
|
|
95
|
+
* Return the current playback device name, or undefined if unavailable.
|
|
96
|
+
* @zh 返回当前播放设备名称;不可用时为 undefined。
|
|
97
|
+
* @ja 現在の再生デバイス名を返します。利用不可なら undefined。
|
|
98
|
+
* @ko 현재 재생 장치 이름을 반환합니다. 사용할 수 없으면 undefined입니다.
|
|
99
|
+
*/
|
|
29
100
|
export declare function getDevice(): string | undefined;
|
|
30
|
-
/**
|
|
101
|
+
/**
|
|
102
|
+
* Return the current device sample rate in Hz, or undefined if unavailable.
|
|
103
|
+
* @zh 返回当前设备采样率(Hz);不可用时为 undefined。
|
|
104
|
+
* @ja 現在のデバイスのサンプルレートを Hz で返します。利用不可なら undefined。
|
|
105
|
+
* @ko 현재 장치의 샘플 레이트를 Hz로 반환합니다. 사용할 수 없으면 undefined입니다.
|
|
106
|
+
*/
|
|
31
107
|
export declare function getDeviceSampleRate(): number | undefined;
|
|
32
|
-
/**
|
|
108
|
+
/**
|
|
109
|
+
* Return whether the current device follows the system default.
|
|
110
|
+
* @zh 返回当前设备是否跟随系统默认设备。
|
|
111
|
+
* @ja 現在のデバイスがシステムの既定デバイスに追従するかどうかを返します。
|
|
112
|
+
* @ko 현재 장치가 시스템 기본 장치를 따르는지 반환합니다.
|
|
113
|
+
*/
|
|
33
114
|
export declare function isDefaultDevice(): boolean;
|
|
34
|
-
/**
|
|
115
|
+
/**
|
|
116
|
+
* Set the device notification callback; undefined or null removes it.
|
|
117
|
+
* @zh 设置设备通知回调;undefined 或 null 移除回调。
|
|
118
|
+
* @ja デバイス通知のコールバックを設定します。undefined または null で解除します。
|
|
119
|
+
* @ko 장치 알림 콜백을 설정합니다. undefined 또는 null은 콜백을 제거합니다.
|
|
120
|
+
*/
|
|
35
121
|
export declare function setNotificationCallback(callback?: NotificationCallback | null): void;
|