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
|
@@ -3,9 +3,22 @@ Object.defineProperty(exports, "__esModule", { value: true });
|
|
|
3
3
|
exports.SoundFileReader = exports.SoundFileReaderInfo = void 0;
|
|
4
4
|
const audio_native_1 = require("../internal/audio-native");
|
|
5
5
|
const value_1 = require("./value");
|
|
6
|
-
/**
|
|
6
|
+
/**
|
|
7
|
+
* sf::SoundFileReader::Info with directly mapped scalar fields.
|
|
8
|
+
* @zh 标量字段直接映射的 sf::SoundFileReader::Info。
|
|
9
|
+
* @ja スカラーフィールドが直接マッピングされた sf::SoundFileReader::Info。
|
|
10
|
+
* @ko 스칼라 필드가 직접 매핑된 sf::SoundFileReader::Info입니다.
|
|
11
|
+
*/
|
|
7
12
|
class SoundFileReaderInfo {
|
|
8
|
-
/**
|
|
13
|
+
/**
|
|
14
|
+
* Create empty format information or copy value; mapping is for internal
|
|
15
|
+
* native decoder mapping.
|
|
16
|
+
* @zh 创建空格式信息或复制 value;mapping 供原生解码器内部映射使用。
|
|
17
|
+
* @ja 空の形式情報を作成するか value をコピーします。
|
|
18
|
+
* mapping はネイティブデコーダー内部のマッピング用です。
|
|
19
|
+
* @ko 빈 형식 정보를 생성하거나 value를 복사합니다.
|
|
20
|
+
* mapping은 네이티브 디코더의 내부 매핑용입니다.
|
|
21
|
+
*/
|
|
9
22
|
constructor(value, mapping = audio_native_1.audioNative.createAudioReaderInfo()) {
|
|
10
23
|
this[audio_native_1.audioHandle] = mapping.handle;
|
|
11
24
|
const region = (name) => {
|
|
@@ -26,36 +39,94 @@ class SoundFileReaderInfo {
|
|
|
26
39
|
this.channelMap = value.channelMap;
|
|
27
40
|
}
|
|
28
41
|
}
|
|
29
|
-
/**
|
|
42
|
+
/**
|
|
43
|
+
* Total sample count across all channels.
|
|
44
|
+
* @zh 所有声道合计的样本总数。
|
|
45
|
+
* @ja 全チャンネルのサンプル総数。
|
|
46
|
+
* @ko 모든 채널의 샘플 총수입니다.
|
|
47
|
+
*/
|
|
30
48
|
get sampleCount() { return this.count[0]; }
|
|
31
|
-
/**
|
|
49
|
+
/**
|
|
50
|
+
* Set the total sample count as an unsigned 64-bit integer.
|
|
51
|
+
* @zh 设置无符号 64 位样本总数。
|
|
52
|
+
* @ja サンプル総数を符号なし 64 ビット整数で設定します。
|
|
53
|
+
* @ko 샘플 총수를 부호 없는 64비트 정수로 설정합니다.
|
|
54
|
+
*/
|
|
32
55
|
set sampleCount(value) {
|
|
33
56
|
if (typeof value !== 'bigint' || value < 0n || value > 0xffffffffffffffffn) {
|
|
34
57
|
throw new RangeError('Expected uint64 sample count');
|
|
35
58
|
}
|
|
36
59
|
this.count[0] = value;
|
|
37
60
|
}
|
|
38
|
-
/**
|
|
61
|
+
/**
|
|
62
|
+
* Number of channels.
|
|
63
|
+
* @zh 声道数量。
|
|
64
|
+
* @ja チャンネル数。
|
|
65
|
+
* @ko 채널 수입니다.
|
|
66
|
+
*/
|
|
39
67
|
get channelCount() { return this.channels[0]; }
|
|
40
|
-
/**
|
|
68
|
+
/**
|
|
69
|
+
* Set the number of channels.
|
|
70
|
+
* @zh 设置声道数量。
|
|
71
|
+
* @ja チャンネル数を設定します。
|
|
72
|
+
* @ko 채널 수를 설정합니다.
|
|
73
|
+
*/
|
|
41
74
|
set channelCount(value) { this.channels[0] = (0, value_1.unsigned)(value); }
|
|
42
|
-
/**
|
|
75
|
+
/**
|
|
76
|
+
* Sample rate per channel, in Hz.
|
|
77
|
+
* @zh 每声道采样率,单位为 Hz。
|
|
78
|
+
* @ja チャンネルごとのサンプルレート。単位は Hz。
|
|
79
|
+
* @ko 채널별 샘플 레이트이며 단위는 Hz입니다.
|
|
80
|
+
*/
|
|
43
81
|
get sampleRate() { return this.rate[0]; }
|
|
44
|
-
/**
|
|
82
|
+
/**
|
|
83
|
+
* Set the sample rate in Hz.
|
|
84
|
+
* @zh 设置采样率,单位为 Hz。
|
|
85
|
+
* @ja サンプルレートを Hz で設定します。
|
|
86
|
+
* @ko 샘플 레이트를 Hz 단위로 설정합니다.
|
|
87
|
+
*/
|
|
45
88
|
set sampleRate(value) { this.rate[0] = (0, value_1.unsigned)(value); }
|
|
46
|
-
/**
|
|
89
|
+
/**
|
|
90
|
+
* Read-only view of interleaved channel positions.
|
|
91
|
+
* @zh 交错声道位置的只读视图。
|
|
92
|
+
* @ja インターリーブチャンネル位置の読み取り専用ビュー。
|
|
93
|
+
* @ko 인터리브 채널 위치의 읽기 전용 뷰입니다.
|
|
94
|
+
*/
|
|
47
95
|
get channelMap() { return this.map; }
|
|
48
|
-
/**
|
|
96
|
+
/**
|
|
97
|
+
* Copy the channel position mapping.
|
|
98
|
+
* @zh 复制声道位置映射。
|
|
99
|
+
* @ja チャンネル位置のマッピングをコピーします。
|
|
100
|
+
* @ko 채널 위치 매핑을 복사합니다.
|
|
101
|
+
*/
|
|
49
102
|
set channelMap(value) {
|
|
50
103
|
this.map = new Int32Array(audio_native_1.audioNative.setAudioReaderChannels(this[audio_native_1.audioHandle], (0, value_1.channels)(value)));
|
|
51
104
|
}
|
|
52
105
|
}
|
|
53
106
|
exports.SoundFileReaderInfo = SoundFileReaderInfo;
|
|
54
|
-
/**
|
|
107
|
+
/**
|
|
108
|
+
* Custom audio decoder interface; I/O positions count samples across all
|
|
109
|
+
* channels.
|
|
110
|
+
* @zh 自定义音频解码器接口,读写位置以所有声道合计的样本数计。
|
|
111
|
+
* @ja カスタム音声デコーダーのインターフェース。
|
|
112
|
+
* 読み書き位置は全チャンネルの合計サンプル数で表します。
|
|
113
|
+
* @ko 사용자 정의 오디오 디코더 인터페이스입니다.
|
|
114
|
+
* 읽기 및 쓰기 위치는 모든 채널의 합계 샘플 수로 나타냅니다.
|
|
115
|
+
*/
|
|
55
116
|
class SoundFileReader {
|
|
56
|
-
/**
|
|
117
|
+
/**
|
|
118
|
+
* Release resources held by the decoder; does nothing by default.
|
|
119
|
+
* @zh 释放解码器持有的资源;默认无操作。
|
|
120
|
+
* @ja デコーダーが保持するリソースを解放します。既定では何もしません。
|
|
121
|
+
* @ko 디코더가 보유한 리소스를 해제합니다. 기본 동작은 아무 작업도 하지 않습니다.
|
|
122
|
+
*/
|
|
57
123
|
close() { }
|
|
58
124
|
}
|
|
59
|
-
/**
|
|
125
|
+
/**
|
|
126
|
+
* Decoder format information type.
|
|
127
|
+
* @zh 解码器格式信息类型。
|
|
128
|
+
* @ja デコーダーの形式情報の型。
|
|
129
|
+
* @ko 디코더 형식 정보 타입입니다.
|
|
130
|
+
*/
|
|
60
131
|
SoundFileReader.Info = SoundFileReaderInfo;
|
|
61
132
|
exports.SoundFileReader = SoundFileReader;
|
|
@@ -1,17 +1,59 @@
|
|
|
1
1
|
import type { SoundChannel } from './value';
|
|
2
|
-
/**
|
|
2
|
+
/**
|
|
3
|
+
* Custom audio encoder interface accepting interleaved 16-bit PCM.
|
|
4
|
+
* @zh 自定义音频编码器接口,接受交错 16 位 PCM。
|
|
5
|
+
* @ja 16 ビットのインターリーブ PCM を受け取るカスタム音声エンコーダー。
|
|
6
|
+
* @ko 16비트 인터리브 PCM을 받는 사용자 정의 오디오 인코더 인터페이스입니다.
|
|
7
|
+
*/
|
|
3
8
|
export declare abstract class SoundFileWriter {
|
|
4
|
-
/**
|
|
9
|
+
/**
|
|
10
|
+
* Create an output file; sampleRate is in Hz and channelMap contains
|
|
11
|
+
* interleaved channel positions. Return whether it succeeded.
|
|
12
|
+
* @zh 创建输出文件;sampleRate 为 Hz,channelMap 为交错声道位置,返回是否成功。
|
|
13
|
+
* @ja 出力ファイルを作成します。sampleRate は Hz、
|
|
14
|
+
* channelMap はインターリーブチャンネル位置です。成功したかどうかを返します。
|
|
15
|
+
* @ko 출력 파일을 생성합니다. sampleRate는 Hz 단위이며
|
|
16
|
+
* channelMap은 인터리브 채널 위치입니다. 성공 여부를 반환합니다.
|
|
17
|
+
*/
|
|
5
18
|
abstract open(filename: string, sampleRate: number, channelCount: number, channelMap: Iterable<SoundChannel>): boolean | Promise<boolean>;
|
|
6
|
-
/**
|
|
19
|
+
/**
|
|
20
|
+
* Encode and write samples; preserve the input until asynchronous completion.
|
|
21
|
+
* @zh 编码并写入样本,异步完成前应保留输入内容。
|
|
22
|
+
* @ja サンプルをエンコードして書き込みます。非同期処理の完了まで入力を保持します。
|
|
23
|
+
* @ko 샘플을 인코딩하여 기록합니다. 비동기 작업이 완료될 때까지 입력을 유지해야 합니다.
|
|
24
|
+
*/
|
|
7
25
|
abstract write(samples: Int16Array): void | Promise<void>;
|
|
8
|
-
/**
|
|
26
|
+
/**
|
|
27
|
+
* Flush and release output resources. Called by OutputSoundFile.close().
|
|
28
|
+
* @zh 刷新并释放输出资源,由 OutputSoundFile.close() 调用。
|
|
29
|
+
* @ja 出力をフラッシュしてリソースを解放します。
|
|
30
|
+
* OutputSoundFile.close() から呼ばれます。
|
|
31
|
+
* @ko 출력을 플러시하고 리소스를 해제합니다. OutputSoundFile.close()가 호출합니다.
|
|
32
|
+
*/
|
|
9
33
|
close(): void | Promise<void>;
|
|
10
34
|
}
|
|
11
|
-
/**
|
|
35
|
+
/**
|
|
36
|
+
* Registrable encoder class requiring a no-argument constructor and a
|
|
37
|
+
* filename-based format probe.
|
|
38
|
+
* @zh 可注册的编码器类,需提供无参数构造和文件名格式探测方法。
|
|
39
|
+
* @ja 登録可能なエンコーダークラス。引数なしのコンストラクターと
|
|
40
|
+
* ファイル名による形式判定メソッドが必要です。
|
|
41
|
+
* @ko 등록 가능한 인코더 클래스로, 인수 없는 생성자와
|
|
42
|
+
* 파일명 기반 형식 탐지 메서드를 제공해야 합니다.
|
|
43
|
+
*/
|
|
12
44
|
export interface SoundFileWriterConstructor {
|
|
13
|
-
/**
|
|
45
|
+
/**
|
|
46
|
+
* Create an unopened encoder instance.
|
|
47
|
+
* @zh 创建尚未打开的编码器实例。
|
|
48
|
+
* @ja 未オープンのエンコーダーインスタンスを作成します。
|
|
49
|
+
* @ko 아직 열리지 않은 인코더 인스턴스를 생성합니다.
|
|
50
|
+
*/
|
|
14
51
|
new (): SoundFileWriter;
|
|
15
|
-
/**
|
|
52
|
+
/**
|
|
53
|
+
* Determine from the filename whether the output format is supported.
|
|
54
|
+
* @zh 按文件名判断是否支持该输出格式。
|
|
55
|
+
* @ja ファイル名から出力形式に対応しているか判定します。
|
|
56
|
+
* @ko 파일명을 기준으로 해당 출력 형식의 지원 여부를 판단합니다.
|
|
57
|
+
*/
|
|
16
58
|
check(filename: string): boolean | Promise<boolean>;
|
|
17
59
|
}
|
|
@@ -1,9 +1,20 @@
|
|
|
1
1
|
"use strict";
|
|
2
2
|
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
3
|
exports.SoundFileWriter = void 0;
|
|
4
|
-
/**
|
|
4
|
+
/**
|
|
5
|
+
* Custom audio encoder interface accepting interleaved 16-bit PCM.
|
|
6
|
+
* @zh 自定义音频编码器接口,接受交错 16 位 PCM。
|
|
7
|
+
* @ja 16 ビットのインターリーブ PCM を受け取るカスタム音声エンコーダー。
|
|
8
|
+
* @ko 16비트 인터리브 PCM을 받는 사용자 정의 오디오 인코더 인터페이스입니다.
|
|
9
|
+
*/
|
|
5
10
|
class SoundFileWriter {
|
|
6
|
-
/**
|
|
11
|
+
/**
|
|
12
|
+
* Flush and release output resources. Called by OutputSoundFile.close().
|
|
13
|
+
* @zh 刷新并释放输出资源,由 OutputSoundFile.close() 调用。
|
|
14
|
+
* @ja 出力をフラッシュしてリソースを解放します。
|
|
15
|
+
* OutputSoundFile.close() から呼ばれます。
|
|
16
|
+
* @ko 출력을 플러시하고 리소스를 해제합니다. OutputSoundFile.close()가 호출합니다.
|
|
17
|
+
*/
|
|
7
18
|
close() { }
|
|
8
19
|
}
|
|
9
20
|
exports.SoundFileWriter = SoundFileWriter;
|
|
@@ -2,59 +2,183 @@ import { audioHandle, AudioQueue, type AudioHandle } from '../internal/audio-nat
|
|
|
2
2
|
import { type AudioRecorderCallbacks } from '../internal/audio-recorder-session';
|
|
3
3
|
import { type ChannelMap } from './value';
|
|
4
4
|
import type { AudioWorkerOptions, AudioWorkerStats } from './worker';
|
|
5
|
-
/**
|
|
5
|
+
/**
|
|
6
|
+
* Capture device audio and process interleaved 16-bit PCM in a Node Worker.
|
|
7
|
+
* @zh 采集设备音频并在 Node Worker 中处理交错 16 位 PCM。
|
|
8
|
+
* @ja デバイスの音声をキャプチャし、Node Worker で
|
|
9
|
+
* 16 ビットインターリーブ PCM を処理します。
|
|
10
|
+
* @ko 장치 오디오를 캡처하고 Node Worker에서 16비트 인터리브 PCM을 처리합니다.
|
|
11
|
+
*/
|
|
6
12
|
export declare class SoundRecorder {
|
|
7
13
|
readonly [audioHandle]: AudioHandle<'recorder'>;
|
|
8
14
|
protected readonly queue: AudioQueue;
|
|
9
15
|
private readonly values;
|
|
10
16
|
private readonly options?;
|
|
11
17
|
private session?;
|
|
12
|
-
/**
|
|
18
|
+
/**
|
|
19
|
+
* On-demand callback session on the owning JS thread.
|
|
20
|
+
* @zh 按需启用的所属 JS 线程回调会话。
|
|
21
|
+
* @ja 必要に応じて有効にする、所属 JS スレッド上のコールバックセッション。
|
|
22
|
+
* @ko 필요에 따라 활성화되는 소속 JS 스레드의 콜백 세션입니다.
|
|
23
|
+
*/
|
|
13
24
|
private directSession?;
|
|
14
|
-
/**
|
|
25
|
+
/**
|
|
26
|
+
* Stop request generation, used to cancel subclass sessions not yet started.
|
|
27
|
+
* @zh 停止请求的代数,用于取消尚未启动的子类会话。
|
|
28
|
+
* @ja 停止要求の世代番号。未開始のサブクラスセッションを取り消すために使います。
|
|
29
|
+
* @ko 중지 요청 세대 번호로, 아직 시작하지 않은 하위 클래스 세션을 취소하는 데 사용합니다.
|
|
30
|
+
*/
|
|
15
31
|
private stopVersion;
|
|
16
32
|
private channelMap;
|
|
17
33
|
private pendingOperations;
|
|
18
|
-
/**
|
|
34
|
+
/**
|
|
35
|
+
* Create a recorder using a Worker module;
|
|
36
|
+
* capture begins after calling start.
|
|
37
|
+
* @zh 使用 Worker 模块创建录音器;调用 start 后开始采集。
|
|
38
|
+
* @ja Worker モジュールで録音器を作成します。start の呼び出し後にキャプチャを開始します。
|
|
39
|
+
* @ko Worker 모듈로 녹음기를 생성합니다. start 호출 후 캡처를 시작합니다.
|
|
40
|
+
*/
|
|
19
41
|
constructor(options: AudioWorkerOptions);
|
|
20
42
|
/** @internal */
|
|
21
43
|
constructor(options: undefined, bufferRecorder: true);
|
|
22
|
-
/**
|
|
44
|
+
/**
|
|
45
|
+
* Return the names of currently available recording devices.
|
|
46
|
+
* @zh 返回当前可用录音设备的名称。
|
|
47
|
+
* @ja 現在利用できる録音デバイスの名前を返します。
|
|
48
|
+
* @ko 현재 사용 가능한 녹음 장치 이름을 반환합니다.
|
|
49
|
+
*/
|
|
23
50
|
static getAvailableDevices(): string[];
|
|
24
|
-
/**
|
|
51
|
+
/**
|
|
52
|
+
* Return the default recording device name.
|
|
53
|
+
* @zh 返回默认录音设备名称。
|
|
54
|
+
* @ja 既定の録音デバイス名を返します。
|
|
55
|
+
* @ko 기본 녹음 장치 이름을 반환합니다.
|
|
56
|
+
*/
|
|
25
57
|
static getDefaultDevice(): string;
|
|
26
|
-
/**
|
|
58
|
+
/**
|
|
59
|
+
* Return whether the system supports audio capture.
|
|
60
|
+
* @zh 返回系统是否支持音频采集。
|
|
61
|
+
* @ja システムが音声キャプチャに対応しているかどうかを返します。
|
|
62
|
+
* @ko 시스템의 오디오 캡처 지원 여부를 반환합니다.
|
|
63
|
+
*/
|
|
27
64
|
static isAvailable(): boolean;
|
|
28
|
-
/**
|
|
65
|
+
/**
|
|
66
|
+
* Return the current sample rate in Hz.
|
|
67
|
+
* @zh 返回当前采样率,单位为 Hz。
|
|
68
|
+
* @ja 現在のサンプルレートを Hz で返します。
|
|
69
|
+
* @ko 현재 샘플 레이트를 Hz 단위로 반환합니다.
|
|
70
|
+
*/
|
|
29
71
|
getSampleRate(): number;
|
|
30
|
-
/**
|
|
72
|
+
/**
|
|
73
|
+
* Return the number of capture channels.
|
|
74
|
+
* @zh 返回采集声道数。
|
|
75
|
+
* @ja キャプチャのチャンネル数を返します。
|
|
76
|
+
* @ko 캡처 채널 수를 반환합니다.
|
|
77
|
+
*/
|
|
31
78
|
getChannelCount(): number;
|
|
32
|
-
/**
|
|
79
|
+
/**
|
|
80
|
+
* Return the speaker position mapping of the capture channels.
|
|
81
|
+
* @zh 返回采集声道的扬声器位置映射。
|
|
82
|
+
* @ja キャプチャチャンネルのスピーカー位置マッピングを返します。
|
|
83
|
+
* @ko 캡처 채널의 스피커 위치 매핑을 반환합니다.
|
|
84
|
+
*/
|
|
33
85
|
getChannelMap(): ChannelMap;
|
|
34
|
-
/**
|
|
86
|
+
/**
|
|
87
|
+
* Return the current recording device name.
|
|
88
|
+
* @zh 返回当前录音设备名称。
|
|
89
|
+
* @ja 現在の録音デバイス名を返します。
|
|
90
|
+
* @ko 현재 녹음 장치 이름을 반환합니다.
|
|
91
|
+
*/
|
|
35
92
|
getDevice(): string;
|
|
36
|
-
/**
|
|
93
|
+
/**
|
|
94
|
+
* Asynchronously switch recording devices and return whether it succeeded.
|
|
95
|
+
* Runs in invocation order; must not be called from subclass callbacks.
|
|
96
|
+
* @zh 异步切换录音设备并返回是否成功;按调用顺序执行,子类回调内不可调用。
|
|
97
|
+
* @ja 録音デバイスを非同期で切り替え、成功したかどうかを返します。
|
|
98
|
+
* 呼び出し順に実行し、サブクラスのコールバック内からは呼べません。
|
|
99
|
+
* @ko 녹음 장치를 비동기로 전환하고 성공 여부를 반환합니다.
|
|
100
|
+
* 호출 순서대로 실행하며 하위 클래스 콜백 내부에서 호출할 수 없습니다.
|
|
101
|
+
*/
|
|
37
102
|
setDevice(name: string): Promise<boolean>;
|
|
38
|
-
/**
|
|
103
|
+
/**
|
|
104
|
+
* Set the capture channel count; wait for the current asynchronous recording
|
|
105
|
+
* operation to finish before calling.
|
|
106
|
+
* @zh 设置采集声道数;必须等待当前异步录音操作结束后调用。
|
|
107
|
+
* @ja キャプチャのチャンネル数を設定します。
|
|
108
|
+
* 現在の非同期録音操作の完了を待ってから呼んでください。
|
|
109
|
+
* @ko 캡처 채널 수를 설정합니다.
|
|
110
|
+
* 현재 비동기 녹음 작업이 끝날 때까지 기다린 후 호출해야 합니다.
|
|
111
|
+
*/
|
|
39
112
|
setChannelCount(count: number): void;
|
|
40
113
|
/**
|
|
41
|
-
*
|
|
114
|
+
* Asynchronously initialize capture, defaulting to 44100 Hz; return false if
|
|
115
|
+
* already capturing, rejected, or startup fails. Do not restart from subclass
|
|
116
|
+
* callbacks; await stop() externally before starting the next session.
|
|
117
|
+
* @zh 异步初始化采集会话,默认 44100 Hz;已采集、拒绝或启动失败返回 false。
|
|
42
118
|
* 不可在子类回调内部重新启动;应在外部等待 stop() 后再开启下一会话。
|
|
119
|
+
* @ja キャプチャセッションを非同期で初期化します。既定値は 44100 Hz。
|
|
120
|
+
* キャプチャ中、拒否、開始失敗の場合は false を返します。
|
|
121
|
+
* サブクラスのコールバック内で再開せず、外部で stop() を待ってから
|
|
122
|
+
* 次のセッションを開始してください。
|
|
123
|
+
* @ko 캡처 세션을 비동기로 초기화하며 기본값은 44100 Hz입니다.
|
|
124
|
+
* 이미 캡처 중이거나 거부 또는 시작 실패 시 false를 반환합니다.
|
|
125
|
+
* 하위 클래스 콜백 내부에서 재시작할 수 없습니다.
|
|
126
|
+
* 외부에서 stop()을 기다린 후 다음 세션을 시작해야 합니다.
|
|
43
127
|
*/
|
|
44
128
|
start(sampleRate?: number): Promise<boolean>;
|
|
45
129
|
/**
|
|
46
|
-
*
|
|
130
|
+
* Asynchronously stop capture and await remaining samples and onStop.
|
|
131
|
+
* Inside subclass callbacks, await stop() only waits for the device to stop,
|
|
132
|
+
* avoiding a self-wait. Draining continues after the callback exits;
|
|
133
|
+
* await stop() again externally to wait for full completion.
|
|
134
|
+
* @zh 异步停止采集并等待剩余样本及 onStop 完成。
|
|
47
135
|
* 子类回调内 await stop() 只等待设备停止,避免等待自身;
|
|
48
136
|
* 回调退出后继续排空,外部再次 await stop() 可等待完整结束。
|
|
137
|
+
* @ja キャプチャを非同期で停止し、残りのサンプルと onStop の完了を待ちます。
|
|
138
|
+
* サブクラスのコールバック内の await stop() は自己待機を避け、
|
|
139
|
+
* デバイス停止のみを待ちます。コールバック終了後もキューの処理を続け、
|
|
140
|
+
* 外部で再度 await stop() すると完全な終了を待てます。
|
|
141
|
+
* @ko 캡처를 비동기로 중지하고 남은 샘플 및 onStop 완료를 기다립니다.
|
|
142
|
+
* 하위 클래스 콜백 안의 await stop()은 자신을 기다리지 않도록
|
|
143
|
+
* 장치 중지만 기다립니다. 콜백 종료 후에도 큐 처리를 계속하며,
|
|
144
|
+
* 외부에서 다시 await stop()하면 전체 완료를 기다릴 수 있습니다.
|
|
49
145
|
*/
|
|
50
146
|
stop(): Promise<void>;
|
|
51
|
-
/**
|
|
147
|
+
/**
|
|
148
|
+
* Return current Worker or subclass callback queue statistics;
|
|
149
|
+
* the native fast path returns undefined.
|
|
150
|
+
* @zh 返回当前 Worker 或子类回调队列统计;Native 快路径为 undefined。
|
|
151
|
+
* @ja 現在の Worker またはサブクラスコールバックのキュー統計を返します。
|
|
152
|
+
* Native 高速経路では undefined です。
|
|
153
|
+
* @ko 현재 Worker 또는 하위 클래스 콜백 큐 통계를 반환합니다.
|
|
154
|
+
* Native 고속 경로에서는 undefined입니다.
|
|
155
|
+
*/
|
|
52
156
|
getWorkerStats(): AudioWorkerStats | undefined;
|
|
53
|
-
/**
|
|
157
|
+
/**
|
|
158
|
+
* Return the first Worker or subclass callback error, or undefined if none.
|
|
159
|
+
* @zh 返回 Worker 或子类回调的首次错误;没有错误时为 undefined。
|
|
160
|
+
* @ja Worker またはサブクラスコールバックの最初のエラーを返します。
|
|
161
|
+
* エラーがなければ undefined。
|
|
162
|
+
* @ko Worker 또는 하위 클래스 콜백의 첫 오류를 반환합니다.
|
|
163
|
+
* 오류가 없으면 undefined입니다.
|
|
164
|
+
*/
|
|
54
165
|
getWorkerError(): Error | undefined;
|
|
55
|
-
/**
|
|
166
|
+
/**
|
|
167
|
+
* Enable recording callbacks on the owning JS thread as needed;
|
|
168
|
+
* ordinary Worker recorders do not use this pipeline.
|
|
169
|
+
* @zh 按需启用所属 JS 线程的录音回调;普通 Worker 录音器不使用该管线。
|
|
170
|
+
* @ja 必要に応じて所属 JS スレッドの録音コールバックを有効にします。
|
|
171
|
+
* 通常の Worker 録音器はこのパイプラインを使いません。
|
|
172
|
+
* @ko 필요에 따라 소속 JS 스레드의 녹음 콜백을 활성화합니다.
|
|
173
|
+
* 일반 Worker 녹음기는 이 파이프라인을 사용하지 않습니다.
|
|
174
|
+
*/
|
|
56
175
|
protected recorderCallbacks(): AudioRecorderCallbacks | undefined;
|
|
57
|
-
/**
|
|
176
|
+
/**
|
|
177
|
+
* Receive a completed native recording buffer.
|
|
178
|
+
* @zh 接收已完成的 Native 录音缓冲区。
|
|
179
|
+
* @ja 完成した Native 録音バッファーを受け取ります。
|
|
180
|
+
* @ko 완성된 Native 녹음 버퍼를 받습니다.
|
|
181
|
+
*/
|
|
58
182
|
protected onBuffer(buffer: AudioHandle<'bufferData'>): void;
|
|
59
183
|
private run;
|
|
60
184
|
}
|
|
@@ -5,15 +5,34 @@ const audio_native_1 = require("../internal/audio-native");
|
|
|
5
5
|
const audio_worker_session_1 = require("../internal/audio-worker-session");
|
|
6
6
|
const audio_recorder_session_1 = require("../internal/audio-recorder-session");
|
|
7
7
|
const value_1 = require("./value");
|
|
8
|
-
/**
|
|
8
|
+
/**
|
|
9
|
+
* Stop the independent session when the wrapper is finalized; the session must
|
|
10
|
+
* not strongly reference the wrapper.
|
|
11
|
+
* @zh 回收包装对象时停止独立会话;会话不得强引用包装对象。
|
|
12
|
+
* @ja ラッパーの回収時に独立したセッションを停止します。
|
|
13
|
+
* セッションはラッパーへの強参照を持ってはいけません。
|
|
14
|
+
* @ko 래퍼 객체가 회수될 때 독립 세션을 중지합니다.
|
|
15
|
+
* 세션은 래퍼 객체를 강하게 참조하면 안 됩니다.
|
|
16
|
+
*/
|
|
9
17
|
const cleanup = new FinalizationRegistry(session => {
|
|
10
18
|
void session.stop().catch(() => { });
|
|
11
19
|
});
|
|
12
|
-
/**
|
|
20
|
+
/**
|
|
21
|
+
* Capture device audio and process interleaved 16-bit PCM in a Node Worker.
|
|
22
|
+
* @zh 采集设备音频并在 Node Worker 中处理交错 16 位 PCM。
|
|
23
|
+
* @ja デバイスの音声をキャプチャし、Node Worker で
|
|
24
|
+
* 16 ビットインターリーブ PCM を処理します。
|
|
25
|
+
* @ko 장치 오디오를 캡처하고 Node Worker에서 16비트 인터리브 PCM을 처리합니다.
|
|
26
|
+
*/
|
|
13
27
|
class SoundRecorder {
|
|
14
28
|
constructor(options, bufferRecorder = false) {
|
|
15
29
|
this.queue = new audio_native_1.AudioQueue();
|
|
16
|
-
/**
|
|
30
|
+
/**
|
|
31
|
+
* Stop request generation, used to cancel subclass sessions not yet started.
|
|
32
|
+
* @zh 停止请求的代数,用于取消尚未启动的子类会话。
|
|
33
|
+
* @ja 停止要求の世代番号。未開始のサブクラスセッションを取り消すために使います。
|
|
34
|
+
* @ko 중지 요청 세대 번호로, 아직 시작하지 않은 하위 클래스 세션을 취소하는 데 사용합니다.
|
|
35
|
+
*/
|
|
17
36
|
this.stopVersion = 0;
|
|
18
37
|
this.pendingOperations = 0;
|
|
19
38
|
if (!bufferRecorder && !options) {
|
|
@@ -25,27 +44,70 @@ class SoundRecorder {
|
|
|
25
44
|
this.channelMap = new Int32Array(mapping.channelMap);
|
|
26
45
|
this.options = options;
|
|
27
46
|
}
|
|
28
|
-
/**
|
|
47
|
+
/**
|
|
48
|
+
* Return the names of currently available recording devices.
|
|
49
|
+
* @zh 返回当前可用录音设备的名称。
|
|
50
|
+
* @ja 現在利用できる録音デバイスの名前を返します。
|
|
51
|
+
* @ko 현재 사용 가능한 녹음 장치 이름을 반환합니다.
|
|
52
|
+
*/
|
|
29
53
|
static getAvailableDevices() {
|
|
30
54
|
return audio_native_1.audioNative.audioCaptureDevices(0);
|
|
31
55
|
}
|
|
32
|
-
/**
|
|
56
|
+
/**
|
|
57
|
+
* Return the default recording device name.
|
|
58
|
+
* @zh 返回默认录音设备名称。
|
|
59
|
+
* @ja 既定の録音デバイス名を返します。
|
|
60
|
+
* @ko 기본 녹음 장치 이름을 반환합니다.
|
|
61
|
+
*/
|
|
33
62
|
static getDefaultDevice() {
|
|
34
63
|
return audio_native_1.audioNative.audioCaptureDevices(1);
|
|
35
64
|
}
|
|
36
|
-
/**
|
|
65
|
+
/**
|
|
66
|
+
* Return whether the system supports audio capture.
|
|
67
|
+
* @zh 返回系统是否支持音频采集。
|
|
68
|
+
* @ja システムが音声キャプチャに対応しているかどうかを返します。
|
|
69
|
+
* @ko 시스템의 오디오 캡처 지원 여부를 반환합니다.
|
|
70
|
+
*/
|
|
37
71
|
static isAvailable() { return audio_native_1.audioNative.audioCaptureDevices(2); }
|
|
38
|
-
/**
|
|
72
|
+
/**
|
|
73
|
+
* Return the current sample rate in Hz.
|
|
74
|
+
* @zh 返回当前采样率,单位为 Hz。
|
|
75
|
+
* @ja 現在のサンプルレートを Hz で返します。
|
|
76
|
+
* @ko 현재 샘플 레이트를 Hz 단위로 반환합니다.
|
|
77
|
+
*/
|
|
39
78
|
getSampleRate() { return this.values[0]; }
|
|
40
|
-
/**
|
|
79
|
+
/**
|
|
80
|
+
* Return the number of capture channels.
|
|
81
|
+
* @zh 返回采集声道数。
|
|
82
|
+
* @ja キャプチャのチャンネル数を返します。
|
|
83
|
+
* @ko 캡처 채널 수를 반환합니다.
|
|
84
|
+
*/
|
|
41
85
|
getChannelCount() { return this.values[1]; }
|
|
42
|
-
/**
|
|
86
|
+
/**
|
|
87
|
+
* Return the speaker position mapping of the capture channels.
|
|
88
|
+
* @zh 返回采集声道的扬声器位置映射。
|
|
89
|
+
* @ja キャプチャチャンネルのスピーカー位置マッピングを返します。
|
|
90
|
+
* @ko 캡처 채널의 스피커 위치 매핑을 반환합니다.
|
|
91
|
+
*/
|
|
43
92
|
getChannelMap() { return this.channelMap; }
|
|
44
|
-
/**
|
|
93
|
+
/**
|
|
94
|
+
* Return the current recording device name.
|
|
95
|
+
* @zh 返回当前录音设备名称。
|
|
96
|
+
* @ja 現在の録音デバイス名を返します。
|
|
97
|
+
* @ko 현재 녹음 장치 이름을 반환합니다.
|
|
98
|
+
*/
|
|
45
99
|
getDevice() {
|
|
46
100
|
return audio_native_1.audioNative.audioRecorderDevice(this[audio_native_1.audioHandle]);
|
|
47
101
|
}
|
|
48
|
-
/**
|
|
102
|
+
/**
|
|
103
|
+
* Asynchronously switch recording devices and return whether it succeeded.
|
|
104
|
+
* Runs in invocation order; must not be called from subclass callbacks.
|
|
105
|
+
* @zh 异步切换录音设备并返回是否成功;按调用顺序执行,子类回调内不可调用。
|
|
106
|
+
* @ja 録音デバイスを非同期で切り替え、成功したかどうかを返します。
|
|
107
|
+
* 呼び出し順に実行し、サブクラスのコールバック内からは呼べません。
|
|
108
|
+
* @ko 녹음 장치를 비동기로 전환하고 성공 여부를 반환합니다.
|
|
109
|
+
* 호출 순서대로 실행하며 하위 클래스 콜백 내부에서 호출할 수 없습니다.
|
|
110
|
+
*/
|
|
49
111
|
setDevice(name) {
|
|
50
112
|
if ((0, audio_recorder_session_1.currentRecorderSession)(this[audio_native_1.audioHandle])) {
|
|
51
113
|
return Promise.reject(new Error('Cannot change device inside a Recorder callback'));
|
|
@@ -55,7 +117,15 @@ class SoundRecorder {
|
|
|
55
117
|
return this.directSession?.runDeviceOperation(change) ?? change();
|
|
56
118
|
});
|
|
57
119
|
}
|
|
58
|
-
/**
|
|
120
|
+
/**
|
|
121
|
+
* Set the capture channel count; wait for the current asynchronous recording
|
|
122
|
+
* operation to finish before calling.
|
|
123
|
+
* @zh 设置采集声道数;必须等待当前异步录音操作结束后调用。
|
|
124
|
+
* @ja キャプチャのチャンネル数を設定します。
|
|
125
|
+
* 現在の非同期録音操作の完了を待ってから呼んでください。
|
|
126
|
+
* @ko 캡처 채널 수를 설정합니다.
|
|
127
|
+
* 현재 비동기 녹음 작업이 끝날 때까지 기다린 후 호출해야 합니다.
|
|
128
|
+
*/
|
|
59
129
|
setChannelCount(count) {
|
|
60
130
|
if (this.pendingOperations) {
|
|
61
131
|
throw new Error('Wait for the pending recorder operation');
|
|
@@ -63,8 +133,19 @@ class SoundRecorder {
|
|
|
63
133
|
this.channelMap = new Int32Array(audio_native_1.audioNative.audioRecorderChannels(this[audio_native_1.audioHandle], (0, value_1.unsigned)(count)));
|
|
64
134
|
}
|
|
65
135
|
/**
|
|
66
|
-
*
|
|
136
|
+
* Asynchronously initialize capture, defaulting to 44100 Hz; return false if
|
|
137
|
+
* already capturing, rejected, or startup fails. Do not restart from subclass
|
|
138
|
+
* callbacks; await stop() externally before starting the next session.
|
|
139
|
+
* @zh 异步初始化采集会话,默认 44100 Hz;已采集、拒绝或启动失败返回 false。
|
|
67
140
|
* 不可在子类回调内部重新启动;应在外部等待 stop() 后再开启下一会话。
|
|
141
|
+
* @ja キャプチャセッションを非同期で初期化します。既定値は 44100 Hz。
|
|
142
|
+
* キャプチャ中、拒否、開始失敗の場合は false を返します。
|
|
143
|
+
* サブクラスのコールバック内で再開せず、外部で stop() を待ってから
|
|
144
|
+
* 次のセッションを開始してください。
|
|
145
|
+
* @ko 캡처 세션을 비동기로 초기화하며 기본값은 44100 Hz입니다.
|
|
146
|
+
* 이미 캡처 중이거나 거부 또는 시작 실패 시 false를 반환합니다.
|
|
147
|
+
* 하위 클래스 콜백 내부에서 재시작할 수 없습니다.
|
|
148
|
+
* 외부에서 stop()을 기다린 후 다음 세션을 시작해야 합니다.
|
|
68
149
|
*/
|
|
69
150
|
start(sampleRate = 44100) {
|
|
70
151
|
(0, value_1.unsigned)(sampleRate);
|
|
@@ -118,9 +199,21 @@ class SoundRecorder {
|
|
|
118
199
|
});
|
|
119
200
|
}
|
|
120
201
|
/**
|
|
121
|
-
*
|
|
202
|
+
* Asynchronously stop capture and await remaining samples and onStop.
|
|
203
|
+
* Inside subclass callbacks, await stop() only waits for the device to stop,
|
|
204
|
+
* avoiding a self-wait. Draining continues after the callback exits;
|
|
205
|
+
* await stop() again externally to wait for full completion.
|
|
206
|
+
* @zh 异步停止采集并等待剩余样本及 onStop 完成。
|
|
122
207
|
* 子类回调内 await stop() 只等待设备停止,避免等待自身;
|
|
123
208
|
* 回调退出后继续排空,外部再次 await stop() 可等待完整结束。
|
|
209
|
+
* @ja キャプチャを非同期で停止し、残りのサンプルと onStop の完了を待ちます。
|
|
210
|
+
* サブクラスのコールバック内の await stop() は自己待機を避け、
|
|
211
|
+
* デバイス停止のみを待ちます。コールバック終了後もキューの処理を続け、
|
|
212
|
+
* 外部で再度 await stop() すると完全な終了を待てます。
|
|
213
|
+
* @ko 캡처를 비동기로 중지하고 남은 샘플 및 onStop 완료를 기다립니다.
|
|
214
|
+
* 하위 클래스 콜백 안의 await stop()은 자신을 기다리지 않도록
|
|
215
|
+
* 장치 중지만 기다립니다. 콜백 종료 후에도 큐 처리를 계속하며,
|
|
216
|
+
* 외부에서 다시 await stop()하면 전체 완료를 기다릴 수 있습니다.
|
|
124
217
|
*/
|
|
125
218
|
stop() {
|
|
126
219
|
++this.stopVersion;
|
|
@@ -128,6 +221,9 @@ class SoundRecorder {
|
|
|
128
221
|
if (current)
|
|
129
222
|
return current.requestStop();
|
|
130
223
|
// Cancel an onStart callback immediately, even while start owns the queue.
|
|
224
|
+
// @zh 即使 start 占用队列,也立即取消 onStart 回调。
|
|
225
|
+
// @ja start がキューを占有中でも、onStart コールバックを即座に取り消します。
|
|
226
|
+
// @ko start가 큐를 점유하는 동안에도 onStart 콜백을 즉시 취소합니다.
|
|
131
227
|
void this.directSession?.requestStop().catch(() => { });
|
|
132
228
|
return this.run(async () => {
|
|
133
229
|
if (this.directSession) {
|
|
@@ -140,19 +236,47 @@ class SoundRecorder {
|
|
|
140
236
|
await this.session?.drain();
|
|
141
237
|
});
|
|
142
238
|
}
|
|
143
|
-
/**
|
|
239
|
+
/**
|
|
240
|
+
* Return current Worker or subclass callback queue statistics;
|
|
241
|
+
* the native fast path returns undefined.
|
|
242
|
+
* @zh 返回当前 Worker 或子类回调队列统计;Native 快路径为 undefined。
|
|
243
|
+
* @ja 現在の Worker またはサブクラスコールバックのキュー統計を返します。
|
|
244
|
+
* Native 高速経路では undefined です。
|
|
245
|
+
* @ko 현재 Worker 또는 하위 클래스 콜백 큐 통계를 반환합니다.
|
|
246
|
+
* Native 고속 경로에서는 undefined입니다.
|
|
247
|
+
*/
|
|
144
248
|
getWorkerStats() {
|
|
145
249
|
return this.directSession?.getStats() ?? this.session?.getStats();
|
|
146
250
|
}
|
|
147
|
-
/**
|
|
251
|
+
/**
|
|
252
|
+
* Return the first Worker or subclass callback error, or undefined if none.
|
|
253
|
+
* @zh 返回 Worker 或子类回调的首次错误;没有错误时为 undefined。
|
|
254
|
+
* @ja Worker またはサブクラスコールバックの最初のエラーを返します。
|
|
255
|
+
* エラーがなければ undefined。
|
|
256
|
+
* @ko Worker 또는 하위 클래스 콜백의 첫 오류를 반환합니다.
|
|
257
|
+
* 오류가 없으면 undefined입니다.
|
|
258
|
+
*/
|
|
148
259
|
getWorkerError() {
|
|
149
260
|
return this.directSession?.error ?? this.session?.error;
|
|
150
261
|
}
|
|
151
|
-
/**
|
|
262
|
+
/**
|
|
263
|
+
* Enable recording callbacks on the owning JS thread as needed;
|
|
264
|
+
* ordinary Worker recorders do not use this pipeline.
|
|
265
|
+
* @zh 按需启用所属 JS 线程的录音回调;普通 Worker 录音器不使用该管线。
|
|
266
|
+
* @ja 必要に応じて所属 JS スレッドの録音コールバックを有効にします。
|
|
267
|
+
* 通常の Worker 録音器はこのパイプラインを使いません。
|
|
268
|
+
* @ko 필요에 따라 소속 JS 스레드의 녹음 콜백을 활성화합니다.
|
|
269
|
+
* 일반 Worker 녹음기는 이 파이프라인을 사용하지 않습니다.
|
|
270
|
+
*/
|
|
152
271
|
recorderCallbacks() {
|
|
153
272
|
return undefined;
|
|
154
273
|
}
|
|
155
|
-
/**
|
|
274
|
+
/**
|
|
275
|
+
* Receive a completed native recording buffer.
|
|
276
|
+
* @zh 接收已完成的 Native 录音缓冲区。
|
|
277
|
+
* @ja 完成した Native 録音バッファーを受け取ります。
|
|
278
|
+
* @ko 완성된 Native 녹음 버퍼를 받습니다.
|
|
279
|
+
*/
|
|
156
280
|
onBuffer(buffer) { void buffer; }
|
|
157
281
|
run(action) {
|
|
158
282
|
++this.pendingOperations;
|