@byteplus/react-native-live-push 1.5.1-rc.1 → 1.5.1-rc.3

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.
Files changed (54) hide show
  1. package/ios/RCTVeLivePush/RCTVeLivePush.mm +1 -1
  2. package/ios/VeLiveMixerView.m +5 -15
  3. package/lib/commonjs/typescript/codegen/android/api.d.ts +869 -93
  4. package/lib/commonjs/typescript/codegen/android/callback.d.ts +243 -31
  5. package/lib/commonjs/typescript/codegen/android/errorcode.d.ts +60 -15
  6. package/lib/commonjs/typescript/codegen/android/keytype.d.ts +1173 -219
  7. package/lib/commonjs/typescript/codegen/ios/api.d.ts +899 -102
  8. package/lib/commonjs/typescript/codegen/ios/callback.d.ts +162 -28
  9. package/lib/commonjs/typescript/codegen/ios/errorcode.d.ts +100 -25
  10. package/lib/commonjs/typescript/codegen/ios/keytype.d.ts +692 -180
  11. package/lib/commonjs/typescript/codegen/pack/api.d.ts +1180 -133
  12. package/lib/commonjs/typescript/codegen/pack/callback.d.ts +243 -35
  13. package/lib/commonjs/typescript/codegen/pack/errorcode.d.ts +69 -16
  14. package/lib/commonjs/typescript/codegen/pack/keytype.d.ts +1459 -270
  15. package/lib/commonjs/typescript/core/api.d.ts +8 -1
  16. package/lib/commonjs/typescript/core/effect.d.ts +5 -1
  17. package/lib/commonjs/typescript/core/logger.d.ts +1 -0
  18. package/lib/commonjs/typescript/platforms/android/AppLogWrapper.d.ts +8 -0
  19. package/lib/commonjs/typescript/platforms/ios/RangersAppLog.d.ts +4 -0
  20. package/lib/module/typescript/codegen/android/api.d.ts +869 -93
  21. package/lib/module/typescript/codegen/android/callback.d.ts +243 -31
  22. package/lib/module/typescript/codegen/android/errorcode.d.ts +60 -15
  23. package/lib/module/typescript/codegen/android/keytype.d.ts +1173 -219
  24. package/lib/module/typescript/codegen/ios/api.d.ts +899 -102
  25. package/lib/module/typescript/codegen/ios/callback.d.ts +162 -28
  26. package/lib/module/typescript/codegen/ios/errorcode.d.ts +100 -25
  27. package/lib/module/typescript/codegen/ios/keytype.d.ts +692 -180
  28. package/lib/module/typescript/codegen/pack/api.d.ts +1180 -133
  29. package/lib/module/typescript/codegen/pack/callback.d.ts +243 -35
  30. package/lib/module/typescript/codegen/pack/errorcode.d.ts +69 -16
  31. package/lib/module/typescript/codegen/pack/keytype.d.ts +1459 -270
  32. package/lib/module/typescript/core/api.d.ts +8 -1
  33. package/lib/module/typescript/core/effect.d.ts +5 -1
  34. package/lib/module/typescript/core/logger.d.ts +1 -0
  35. package/lib/module/typescript/platforms/android/AppLogWrapper.d.ts +8 -0
  36. package/lib/module/typescript/platforms/ios/RangersAppLog.d.ts +4 -0
  37. package/lib/typescript/codegen/android/api.d.ts +869 -93
  38. package/lib/typescript/codegen/android/callback.d.ts +243 -31
  39. package/lib/typescript/codegen/android/errorcode.d.ts +60 -15
  40. package/lib/typescript/codegen/android/keytype.d.ts +1173 -219
  41. package/lib/typescript/codegen/ios/api.d.ts +899 -102
  42. package/lib/typescript/codegen/ios/callback.d.ts +162 -28
  43. package/lib/typescript/codegen/ios/errorcode.d.ts +100 -25
  44. package/lib/typescript/codegen/ios/keytype.d.ts +692 -180
  45. package/lib/typescript/codegen/pack/api.d.ts +1180 -133
  46. package/lib/typescript/codegen/pack/callback.d.ts +243 -35
  47. package/lib/typescript/codegen/pack/errorcode.d.ts +69 -16
  48. package/lib/typescript/codegen/pack/keytype.d.ts +1459 -270
  49. package/lib/typescript/core/api.d.ts +8 -1
  50. package/lib/typescript/core/effect.d.ts +5 -1
  51. package/lib/typescript/core/logger.d.ts +1 -0
  52. package/lib/typescript/platforms/android/AppLogWrapper.d.ts +8 -0
  53. package/lib/typescript/platforms/ios/RangersAppLog.d.ts +4 -0
  54. package/package.json +1 -1
@@ -1,7 +1,12 @@
1
1
  import { int, long, Matrix, ByteBuffer, Runnable, double, String, ArrayList, float, Context, LiveSdkSetting } from './types';
2
2
  import { VeLivePusher } from './api';
3
3
  export declare class VeLiveVideoEncoderConfiguration {
4
-
4
+ /** {zh}
5
+ * @detail api
6
+ * @brief 获取推流视频分辨率。
7
+ * @return 推流视频分辨率 [VeLiveVideoResolution](#VeLivePusherDef-VeLiveVideoResolution)。
8
+ *
9
+ */
5
10
  /** {en}
6
11
  * @detail api
7
12
  * @brief Gets the video resolution.
@@ -9,7 +14,13 @@ export declare class VeLiveVideoEncoderConfiguration {
9
14
  *
10
15
  */
11
16
  getResolution(): VeLiveVideoResolution;
12
-
17
+ /** {zh}
18
+ * @detail api
19
+ * @brief 设置推流视频分辨率。
20
+ * @param resolution 推流视频分辨率,默认值为 VeLiveVideoResolution720P,详情请参见 [VeLiveVideoResolution](#VeLivePusherDef-VeLiveVideoResolution)。
21
+ * @return 推流视频编码参数配置对象,详情请参见 [VeLiveVideoEncoderConfiguration](#VeLivePusherDef-VeLiveVideoEncoderConfiguration)。
22
+ *
23
+ */
13
24
  /** {en}
14
25
  * @detail api
15
26
  * @brief Sets the video resolution.
@@ -18,7 +29,12 @@ export declare class VeLiveVideoEncoderConfiguration {
18
29
  *
19
30
  */
20
31
  setResolution(resolution: VeLiveVideoResolution): this;
21
-
32
+ /** {zh}
33
+ * @detail api
34
+ * @brief 获取推流视频编码格式。
35
+ * @return 推流视频编码格式,详情请参见 [VeLiveVideoCodec](#VeLiveVideoCodec)。
36
+ *
37
+ */
22
38
  /** {en}
23
39
  * @detail api
24
40
  * @brief Gets the video codec.
@@ -26,7 +42,13 @@ export declare class VeLiveVideoEncoderConfiguration {
26
42
  *
27
43
  */
28
44
  getCodec(): VeLiveVideoCodec;
29
-
45
+ /** {zh}
46
+ * @detail api
47
+ * @brief 设置推流视频编码格式。
48
+ * @param codec 推流视频编码格式,详情请参见 [VeLiveVideoCodec](#VeLiveVideoCodec) 。
49
+ * @return 推流视频编码参数,详见 [VeLiveVideoEncoderConfiguration](#VeLivePusherDef-VeLiveVideoEncoderConfiguration)。
50
+ *
51
+ */
30
52
  /** {en}
31
53
  * @detail api
32
54
  * @brief Sets the video codec.
@@ -35,7 +57,13 @@ export declare class VeLiveVideoEncoderConfiguration {
35
57
  *
36
58
  */
37
59
  setCodec(codec: VeLiveVideoCodec): this;
38
-
60
+ /** {zh}
61
+ * @detail api
62
+ * @brief 获取推流视频编码码率。
63
+ * @return <br>
64
+ * 推流视频编码码率。
65
+ *
66
+ */
39
67
  /** {en}
40
68
  * @detail api
41
69
  * @brief Get the encoded video bitrate.
@@ -43,7 +71,13 @@ export declare class VeLiveVideoEncoderConfiguration {
43
71
  *
44
72
  */
45
73
  getBitrate(): int;
46
-
74
+ /** {zh}
75
+ * @detail api
76
+ * @brief 设置推流视频编码码率。
77
+ * @param bitrate 推流视频编码码率,单位为 kbps,默认值由 `resolution` 参数值决定。
78
+ * @return 推流视频编码参数配置对象,详情请参见 [VeLiveVideoEncoderConfiguration](#VeLivePusherDef-VeLiveVideoEncoderConfiguration)。
79
+ *
80
+ */
47
81
  /** {en}
48
82
  * @detail api
49
83
  * @brief Sets the encoded video bitrate.
@@ -52,7 +86,13 @@ export declare class VeLiveVideoEncoderConfiguration {
52
86
  *
53
87
  */
54
88
  setBitrate(bitrate: int): this;
55
-
89
+ /** {zh}
90
+ * @detail api
91
+ * @brief 获取推流视频编码最小码率。
92
+ * @return <br>
93
+ * 推流视频编码最小码率。
94
+ *
95
+ */
56
96
  /** {en}
57
97
  * @detail api
58
98
  * @brief Gets the minimum encoded video bitrate.
@@ -60,7 +100,13 @@ export declare class VeLiveVideoEncoderConfiguration {
60
100
  *
61
101
  */
62
102
  getMinBitrate(): int;
63
-
103
+ /** {zh}
104
+ * @detail api
105
+ * @brief 设置推流视频编码最小码率。
106
+ * @param minBitrate 推流视频编码最小码率,单位为 kbps,默认值由 `resolution` 参数值决定;如果开启自适应码率,推流 SDK 根据网络情况进行编码码率自适应调整的最小码率
107
+ * @return 推流视频编码参数配置对象,详情请参见 [VeLiveVideoEncoderConfiguration](#VeLivePusherDef-VeLiveVideoEncoderConfiguration)。
108
+ *
109
+ */
64
110
  /** {en}
65
111
  * @detail api
66
112
  * @brief Sets the minimum encoded video bitrate.
@@ -69,7 +115,13 @@ export declare class VeLiveVideoEncoderConfiguration {
69
115
  *
70
116
  */
71
117
  setMinBitrate(minBitrate: int): this;
72
-
118
+ /** {zh}
119
+ * @detail api
120
+ * @brief 获取推流视频编码最大码率。
121
+ * @return <br>
122
+ * 推流视频编码最大码率。
123
+ *
124
+ */
73
125
  /** {en}
74
126
  * @detail api
75
127
  * @brief Gets the maximum encoded video bitrate.
@@ -77,7 +129,14 @@ export declare class VeLiveVideoEncoderConfiguration {
77
129
  *
78
130
  */
79
131
  getMaxBitrate(): int;
80
-
132
+ /** {zh}
133
+ * @detail api
134
+ * @brief 设置推流视频编码最大码率。
135
+ * @param maxBitrate 推流视频编码最大码率,单位为 kbps,默认值由 `resolution` 参数值决定;如果开启自适应码率,推流 SDK 根据网络情况进行编码码率自适应调整的最大码率。
136
+ * @return
137
+ * 推流视频编码参数配置对象,详情请参见 [VeLiveVideoEncoderConfiguration](#VeLivePusherDef-VeLiveVideoEncoderConfiguration)。
138
+ *
139
+ */
81
140
  /** {en}
82
141
  * @detail api
83
142
  * @brief Sets the maximum encoded video bitrate.
@@ -86,7 +145,13 @@ export declare class VeLiveVideoEncoderConfiguration {
86
145
  *
87
146
  */
88
147
  setMaxBitrate(maxBitrate: int): this;
89
-
148
+ /** {zh}
149
+ * @detail api
150
+ * @brief 获取推流视频编码 GOP。
151
+ * @return <br>
152
+ * 推流视频编码 GOP。
153
+ *
154
+ */
90
155
  /** {en}
91
156
  * @detail api
92
157
  * @brief Gets the encoded video GOP size.
@@ -94,7 +159,13 @@ export declare class VeLiveVideoEncoderConfiguration {
94
159
  *
95
160
  */
96
161
  getGopSize(): int;
97
-
162
+ /** {zh}
163
+ * @detail api
164
+ * @brief 设置推流视频编码 GOP。
165
+ * @param gopSize 视频 GOP 大小,单位为 s,默认值为 2
166
+ * @return 推流视频编码参数配置对象,详情请参见 [VeLiveVideoEncoderConfiguration](#VeLivePusherDef-VeLiveVideoEncoderConfiguration)。
167
+ *
168
+ */
98
169
  /** {en}
99
170
  * @detail api
100
171
  * @brief Sets the encoded video GOP size.
@@ -103,7 +174,12 @@ export declare class VeLiveVideoEncoderConfiguration {
103
174
  *
104
175
  */
105
176
  setGopSize(gopSize: int): this;
106
-
177
+ /** {zh}
178
+ * @detail api
179
+ * @brief 获取推流视频编码帧率。
180
+ * @return 推流视频编码帧率。
181
+ *
182
+ */
107
183
  /** {en}
108
184
  * @detail api
109
185
  * @brief Gets the encoded frame rate.
@@ -111,7 +187,13 @@ export declare class VeLiveVideoEncoderConfiguration {
111
187
  *
112
188
  */
113
189
  getFps(): int;
114
-
190
+ /** {zh}
191
+ * @detail api
192
+ * @brief 设置推流视频编码帧率。
193
+ * @param fps 视频编码帧率,单位为 fps,默认值为 15
194
+ * @return 推流视频编码参数配置对象,详情请参见 [VeLiveVideoEncoderConfiguration](#VeLivePusherDef-VeLiveVideoEncoderConfiguration)。
195
+ *
196
+ */
115
197
  /** {en}
116
198
  * @detail api
117
199
  * @brief Sets the encoded frame rate.
@@ -120,7 +202,14 @@ export declare class VeLiveVideoEncoderConfiguration {
120
202
  *
121
203
  */
122
204
  setFps(fps: int): this;
123
-
205
+ /** {zh}
206
+ * @detail api
207
+ * @brief 获取是否开启 B 帧。
208
+ * @return 是否开启B帧。<br/>
209
+ * - true:B 帧开启;
210
+ * - false:B 帧关闭。
211
+ *
212
+ */
124
213
  /** {en}
125
214
  * @detail api
126
215
  * @brief Gets whether to enable B frames.
@@ -130,7 +219,15 @@ export declare class VeLiveVideoEncoderConfiguration {
130
219
  *
131
220
  */
132
221
  isEnableBFrame(): boolean;
133
-
222
+ /** {zh}
223
+ * @detail api
224
+ * @brief 设置推流视频编码开启 B 帧。
225
+ * @param enableBFrame 是否开启 B 帧。默认为 false。 <br>
226
+ * - true:开启;
227
+ * - false:关闭。
228
+ * @return 推流视频编码参数配置对象,详情请参见 [VeLiveVideoEncoderConfiguration](#VeLivePusherDef-VeLiveVideoEncoderConfiguration)。
229
+ *
230
+ */
134
231
  /** {en}
135
232
  * @detail api
136
233
  * @brief Sets whether to enable B frames.
@@ -141,7 +238,15 @@ export declare class VeLiveVideoEncoderConfiguration {
141
238
  *
142
239
  */
143
240
  setEnableBFrame(enableBFrame: boolean): this;
144
-
241
+ /** {zh}
242
+ * @detail api
243
+ * @brief 获取是否开启硬件编码。
244
+ * @return <br>
245
+ * 是否开启硬件编码。<br>
246
+ * - true:开启;
247
+ * - false:关闭。
248
+ *
249
+ */
145
250
  /** {en}
146
251
  * @detail api
147
252
  * @brief Gets whether to enable hardware encoding.
@@ -151,7 +256,15 @@ export declare class VeLiveVideoEncoderConfiguration {
151
256
  *
152
257
  */
153
258
  isEnableAccelerate(): boolean;
154
-
259
+ /** {zh}
260
+ * @detail api
261
+ * @brief 设置推流视频编码开启硬件编码。
262
+ * @param enableAccelerate 是否开启硬件编码。默认值为 true。 <br>
263
+ * - true:开启;
264
+ * - false:关闭。
265
+ * @return 推流视频编码参数配置对象,详情请参见 [VeLiveVideoEncoderConfiguration](#VeLivePusherDef-VeLiveVideoEncoderConfiguration)。
266
+ *
267
+ */
155
268
  /** {en}
156
269
  * @detail api
157
270
  * @brief Enables hardware encoding.
@@ -165,21 +278,34 @@ export declare class VeLiveVideoEncoderConfiguration {
165
278
  }
166
279
  export declare class VeLiveVideoFrame {
167
280
  constructor(width: int, height: int, pts: long, data: ArrayBuffer);
168
-
281
+ /** {zh}
282
+ * @detail api
283
+ * @brief 增加 VeLiveVideoFrame 对象的引用计数。当您需要继续使用 VeLiveVideoFrame 对象时,请调用此方法将引用计数增加 1。
284
+ *
285
+ */
169
286
  /** {en}
170
287
  * @detail api
171
288
  * @brief Increases the reference count of the `VeLiveVideoFrame` object. Call this method to increase the reference count by 1 if you need to continue using the `VeLiveVideoFrame` object.
172
289
  *
173
290
  */
174
291
  retain(): void;
175
-
292
+ /** {zh}
293
+ * @detail api
294
+ * @brief 释放对 VeLiveVideoFrame 对象的引用。在您不再需要使用 VeLiveVideoFrame 对象时,应调用此方法将引用计数减少 1。当引用计数减少到零,表示不再有引用指向该对象,可以安全地释放或销毁该对象。
295
+ *
296
+ */
176
297
  /** {en}
177
298
  * @detail api
178
299
  * @brief Releases the reference to the `VeLiveVideoFrame` object. Call this method to reduce the reference count by 1 when you no longer need to use the `VeLiveVideoFrame` object. When the reference count is reduced to 0, it means there is no reference to the object, and the object can be safely released or destroyed.
179
300
  *
180
301
  */
181
302
  release(): void;
182
-
303
+ /** {zh}
304
+ * @detail api
305
+ * @brief 获取视频数据类型。
306
+ * @return 视频数据类型,详情请参见 [VeLiveVideoBufferType](#VeLiveVideoBufferType)。
307
+ *
308
+ */
183
309
  /** {en}
184
310
  * @detail api
185
311
  * @brief Gets the data type of the video.
@@ -187,7 +313,13 @@ export declare class VeLiveVideoFrame {
187
313
  *
188
314
  */
189
315
  getBufferType(): VeLiveVideoBufferType;
190
-
316
+ /** {zh}
317
+ * @detail api
318
+ * @brief 设置视频数据类型。
319
+ * @param bufferType 视频数据类型,详情请参见 [VeLiveVideoBufferType](#VeLiveVideoBufferType)。
320
+ * @return 视频帧对象,详情请参见 [VeLiveVideoFrame](#VeLiveVideoFrame)。
321
+ *
322
+ */
191
323
  /** {en}
192
324
  * @detail api
193
325
  * @brief Sets the data type of the video.
@@ -196,7 +328,12 @@ export declare class VeLiveVideoFrame {
196
328
  *
197
329
  */
198
330
  setBufferType(bufferType: VeLiveVideoBufferType): this;
199
-
331
+ /** {zh}
332
+ * @detail api
333
+ * @brief 获取视频像素格式。
334
+ * @return 视频像素格式,详情请参见 [VeLivePixelFormat](#VeLivePixelFormat)。
335
+ *
336
+ */
200
337
  /** {en}
201
338
  * @detail api
202
339
  * @brief Gets the pixel format.
@@ -205,7 +342,13 @@ export declare class VeLiveVideoFrame {
205
342
  *
206
343
  */
207
344
  getPixelFormat(): VeLivePixelFormat;
208
-
345
+ /** {zh}
346
+ * @detail api
347
+ * @brief 设置视频像素格式。
348
+ * @param pixelFormat 视频像素格式,详情请参见 [VeLivePixelFormat](#VeLivePixelFormat)。
349
+ * @return 视频帧对象,详情请参见 [VeLiveVideoFrame](#VeLiveVideoFrame)。
350
+ *
351
+ */
209
352
  /** {en}
210
353
  * @detail api
211
354
  * @brief Sets the pixel format.
@@ -214,7 +357,12 @@ export declare class VeLiveVideoFrame {
214
357
  *
215
358
  */
216
359
  setPixelFormat(pixelFormat: VeLivePixelFormat): this;
217
-
360
+ /** {zh}
361
+ * @detail api
362
+ * @brief 获取视频帧旋转角度。
363
+ * @return 视频帧旋转角度,详情请参见 [VeLiveVideoRotation](#VeLiveVideoRotation)。
364
+ *
365
+ */
218
366
  /** {en}
219
367
  * @detail api
220
368
  * @brief Gets the rotation angle in a clockwise direction.
@@ -222,7 +370,13 @@ export declare class VeLiveVideoFrame {
222
370
  *
223
371
  */
224
372
  getRotation(): VeLiveVideoRotation;
225
-
373
+ /** {zh}
374
+ * @detail api
375
+ * @brief 设置视频帧旋转角度。
376
+ * @param rotation 视频帧旋转角度,详情请参见 [VeLiveVideoRotation](#VeLiveVideoRotation)。
377
+ * @return 视频帧对象,详情请参见 [VeLiveVideoFrame](#VeLiveVideoFrame)。
378
+ *
379
+ */
226
380
  /** {en}
227
381
  * @detail api
228
382
  * @brief Sets the rotation angle in a clockwise direction.
@@ -232,7 +386,13 @@ export declare class VeLiveVideoFrame {
232
386
  *
233
387
  */
234
388
  setRotation(rotation: VeLiveVideoRotation): this;
235
-
389
+ /** {zh}
390
+ * @detail api
391
+ * @brief 获取视频帧宽度。
392
+ * @return <br>
393
+ * 视频帧宽度。
394
+ *
395
+ */
236
396
  /** {en}
237
397
  * @detail api
238
398
  * @brief Gets the width of the video frame.
@@ -241,7 +401,13 @@ export declare class VeLiveVideoFrame {
241
401
  *
242
402
  */
243
403
  getWidth(): int;
244
-
404
+ /** {zh}
405
+ * @detail api
406
+ * @brief 获取视频帧高度。
407
+ * @return <br>
408
+ * 视频帧高度。
409
+ *
410
+ */
245
411
  /** {en}
246
412
  * @detail api
247
413
  * @brief Gets the height of the video frame.
@@ -250,7 +416,13 @@ export declare class VeLiveVideoFrame {
250
416
  *
251
417
  */
252
418
  getHeight(): int;
253
-
419
+ /** {zh}
420
+ * @detail api
421
+ * @brief 获取带旋转角度的视频帧宽度。
422
+ * @return <br>
423
+ * 带旋转角度的视频帧宽度。
424
+ *
425
+ */
254
426
  /** {en}
255
427
  * @detail api
256
428
  * @brief Gets the width of the rotated video frame.
@@ -259,7 +431,13 @@ export declare class VeLiveVideoFrame {
259
431
  *
260
432
  */
261
433
  getRotatedWidth(): int;
262
-
434
+ /** {zh}
435
+ * @detail api
436
+ * @brief 获取带旋转角度的视频帧高度。
437
+ * @return <br>
438
+ * 带旋转角度的视频帧高度。
439
+ *
440
+ */
263
441
  /** {en}
264
442
  * @detail api
265
443
  * @brief Gets the height of the rotated video frame.
@@ -268,7 +446,13 @@ export declare class VeLiveVideoFrame {
268
446
  *
269
447
  */
270
448
  getRotatedHeight(): int;
271
-
449
+ /** {zh}
450
+ * @detail api
451
+ * @brief 获取视频帧时间戳。
452
+ * @return <br>
453
+ * 视频帧时间戳,单位为 μs。
454
+ *
455
+ */
272
456
  /** {en}
273
457
  * @detail api
274
458
  * @brief Gets the timestamp of the video frame.
@@ -277,7 +461,13 @@ export declare class VeLiveVideoFrame {
277
461
  *
278
462
  */
279
463
  getPts(): long;
280
-
464
+ /** {zh}
465
+ * @detail api
466
+ * @brief 获取视频帧纹理 ID。
467
+ * @return <br>
468
+ * 视频帧纹理 ID。
469
+ *
470
+ */
281
471
  /** {en}
282
472
  * @detail api
283
473
  * @brief Gets the texture ID.
@@ -286,7 +476,12 @@ export declare class VeLiveVideoFrame {
286
476
  *
287
477
  */
288
478
  getTextureId(): int;
289
-
479
+ /** {zh}
480
+ * @detail api
481
+ * @brief 获取视频帧纹理矩阵。
482
+ * @return 视频帧纹理矩阵。
483
+ *
484
+ */
290
485
  /** {en}
291
486
  * @detail api
292
487
  * @brief Gets the texture matrix.
@@ -294,7 +489,13 @@ export declare class VeLiveVideoFrame {
294
489
  *
295
490
  */
296
491
  getTextureMatrix(): Matrix;
297
-
492
+ /** {zh}
493
+ * @detail api
494
+ * @brief 获取 ByteBuffer 格式的视频数据。
495
+ * @return <br>
496
+ * ByteBuffer 格式的视频数据。
497
+ *
498
+ */
298
499
  /** {en}
299
500
  * @detail api
300
501
  * @brief Gets the video data in the format of ByteBuffer.
@@ -302,7 +503,12 @@ export declare class VeLiveVideoFrame {
302
503
  *
303
504
  */
304
505
  getBuffer(): ByteBuffer;
305
-
506
+ /** {zh}
507
+ * @detail api
508
+ * @brief 获取 byte[] 格式的视频数据。
509
+ * @return byte[] 格式的视频数据。
510
+ *
511
+ */
306
512
  /** {en}
307
513
  * @detail api
308
514
  * @brief Gets the video data in the format of byte [].
@@ -310,7 +516,13 @@ export declare class VeLiveVideoFrame {
310
516
  *
311
517
  */
312
518
  getData(): ArrayBuffer;
313
-
519
+ /** {zh}
520
+ * @detail api
521
+ * @brief 获取视频帧内部销毁回调。
522
+ * @return <br>
523
+ * 视频帧内部销毁回调。
524
+ *
525
+ */
314
526
  /** {en}
315
527
  * @detail api
316
528
  * @brief Gets the internal release callback.
@@ -318,7 +530,13 @@ export declare class VeLiveVideoFrame {
318
530
  *
319
531
  */
320
532
  getReleaseCallback(): Runnable;
321
-
533
+ /** {zh}
534
+ * @detail api
535
+ * @brief 设置视频帧内部销毁回调。
536
+ * @param releaseCallback 视频帧内部销毁回调
537
+ * @return 视频帧对象,详情请参见 [VeLiveVideoFrame](#VeLiveVideoFrame)。
538
+ *
539
+ */
322
540
  /** {en}
323
541
  * @detail api
324
542
  * @brief Sets the internal release callback.
@@ -329,19 +547,28 @@ export declare class VeLiveVideoFrame {
329
547
  setReleaseCallback(releaseCallback: Runnable): this;
330
548
  }
331
549
  export declare enum VeLiveAudioCodec {
332
-
550
+ /** {zh}
551
+ * @brief FDKAAC 编码。
552
+ *
553
+ */
333
554
  /** {en}
334
555
  * @brief FDKAAC.
335
556
  *
336
557
  */
337
558
  VeLiveAudioCodecFdkAAC = 0,
338
-
559
+ /** {zh}
560
+ * @brief Mediacodec AAC 编码。
561
+ *
562
+ */
339
563
  /** {en}
340
564
  * @brief Mediacodec AAC.
341
565
  *
342
566
  */
343
567
  VeLiveAudioCodecMediaCodecAAC = 1,
344
-
568
+ /** {zh}
569
+ * @brief FFMPEG AAC 编码。
570
+ *
571
+ */
345
572
  /** {en}
346
573
  * @brief FFMPEG AAC.
347
574
  *
@@ -349,13 +576,19 @@ export declare enum VeLiveAudioCodec {
349
576
  VeLiveAudioCodecFFmpegAAC = 2
350
577
  }
351
578
  export declare enum VeLiveVideoCodec {
352
-
579
+ /** {zh}
580
+ * @brief 使用 H.264 视频编码。
581
+ *
582
+ */
353
583
  /** {en}
354
584
  * @brief H.264.
355
585
  *
356
586
  */
357
587
  VeLiveVideoCodecH264 = 0,
358
-
588
+ /** {zh}
589
+ * @brief 使用火山引擎自研 ByteVC1 视频编码。
590
+ *
591
+ */
359
592
  /** {en}
360
593
  * @brief ByteVC1, an encoding format developed by BytePlus.
361
594
  *
@@ -363,97 +596,145 @@ export declare enum VeLiveVideoCodec {
363
596
  VeLiveVideoCodecByteVC1 = 1
364
597
  }
365
598
  export declare class VeLivePusherStatistics {
366
-
599
+ /** {zh}
600
+ * @brief 视频编码宽度,单位为 px。
601
+ *
602
+ */
367
603
  /** {en}
368
604
  * @brief The width of the encoded video, in pixels.
369
605
  *
370
606
  */
371
607
  encodeWidth: int;
372
-
608
+ /** {zh}
609
+ * @brief 视频编码高度,单位为 px。
610
+ *
611
+ */
373
612
  /** {en}
374
613
  * @brief The height of the encoded video, in pixels.
375
614
  *
376
615
  */
377
616
  encodeHeight: int;
378
-
617
+ /** {zh}
618
+ * @brief 视频采集宽度,单位为 px。
619
+ *
620
+ */
379
621
  /** {en}
380
622
  * @brief The width of the captured video, in pixels.
381
623
  *
382
624
  */
383
625
  captureWidth: int;
384
-
626
+ /** {zh}
627
+ * @brief 视频采集高度,单位为 px。
628
+ *
629
+ */
385
630
  /** {en}
386
631
  * @brief The height of the captured video, in pixels.
387
632
  *
388
633
  */
389
634
  captureHeight: int;
390
-
635
+ /** {zh}
636
+ * @brief 视频采集帧率,单位为 fps。
637
+ *
638
+ */
391
639
  /** {en}
392
640
  * @brief The captured frame rate, in fps.
393
641
  *
394
642
  */
395
643
  captureFps: double;
396
-
644
+ /** {zh}
645
+ * @brief 视频编码帧率,单位为 fps。
646
+ *
647
+ */
397
648
  /** {en}
398
649
  * @brief The encoded frame rate, in fps.
399
650
  *
400
651
  */
401
652
  encodeFps: double;
402
-
653
+ /** {zh}
654
+ * @brief 视频发送帧率,可用展示实时帧率,单位为 fps。
655
+ *
656
+ */
403
657
  /** {en}
404
658
  * @brief The transmission frame rate, in fps. You can use this parameter to showcase the real-time frame rate on the user interface.
405
659
  *
406
660
  */
407
661
  transportFps: double;
408
-
662
+ /** {zh}
663
+ * @brief 视频推流帧率,即您通过 [setVideoEncoderConfiguration](147517#VeLivePusher-setvideoencoderconfiguration) 方法设置的帧率,单位为 fps。
664
+ *
665
+ */
409
666
  /** {en}
410
667
  * @brief The encoded frame rate you specify in the setVideoEncoderConfiguration {@link #VeLivePusher#setVideoEncoderConfiguration} method, in fps.
411
668
  *
412
669
  */
413
670
  fps: int;
414
-
671
+ /** {zh}
672
+ * @brief 视频推流码率,即您通过 [setVideoEncoderConfiguration](147517#VeLivePusher-setvideoencoderconfiguration) 方法设置的码率,单位为 kbps。
673
+ *
674
+ */
415
675
  /** {en}
416
676
  * @brief The encoded bitrate you specify in the setVideoEncoderConfiguration {@link #VeLivePusher#setVideoEncoderConfiguration} method, in Kbps.
417
677
  *
418
678
  */
419
679
  videoBitrate: int;
420
-
680
+ /** {zh}
681
+ * @brief 视频推流最小码率,即您通过 [setVideoEncoderConfiguration](147517#VeLivePusher-setvideoencoderconfiguration) 方法设置的最小码率,单位为 kbps。
682
+ *
683
+ */
421
684
  /** {en}
422
685
  * @brief The minimum encoded bitrate you specify in the setVideoEncoderConfiguration {@link #VeLivePusher#setVideoEncoderConfiguration} method, in Kbps.
423
686
  *
424
687
  */
425
688
  minVideoBitrate: int;
426
-
689
+ /** {zh}
690
+ * @brief 视频推流最大码率,即您通过 [setVideoEncoderConfiguration](147517#VeLivePusher-setvideoencoderconfiguration) 方法设置的最大码率,单位为 kbps。
691
+ *
692
+ */
427
693
  /** {en}
428
694
  * @brief The maximum encoded bitrate you specify in the setVideoEncoderConfiguration {@link #VeLivePusher#setVideoEncoderConfiguration} method, in Kbps.
429
695
  *
430
696
  */
431
697
  maxVideoBitrate: int;
432
-
698
+ /** {zh}
699
+ * @brief 视频编码码率,单位为 kbps。
700
+ *
701
+ */
433
702
  /** {en}
434
703
  * @brief The encoded video bitrate, in Kbps.
435
704
  *
436
705
  */
437
706
  encodeVideoBitrate: double;
438
-
707
+ /** {zh}
708
+ * @brief 视频发送码率,可用于展示实时码率,单位为 kbps。
709
+ *
710
+ */
439
711
  /** {en}
440
712
  * @brief The transmission bitrate, in Kbps. You can use this parameter to showcase the real-time bitrate on the user interface.
441
713
  *
442
714
  */
443
715
  transportVideoBitrate: double;
444
-
716
+ /** {zh}
717
+ * @brief 音频编码码率,单位为 kbps。
718
+ *
719
+ */
445
720
  /** {en}
446
721
  * @brief The audio encoding bitrate, in Kbps.
447
722
  *
448
723
  */
449
724
  encodeAudioBitrate: double;
450
-
725
+ /** {zh}
726
+ * @brief 推流地址。
727
+ *
728
+ */
451
729
  /** {en}
452
730
  * @brief The push stream address.
453
731
  *
454
732
  */
455
733
  url: String;
456
-
734
+ /** {zh}
735
+ * @brief 视频编码格式。
736
+ *
737
+ */
457
738
  /** {en}
458
739
  * @brief The video codec.
459
740
  *
@@ -461,19 +742,28 @@ export declare class VeLivePusherStatistics {
461
742
  codec: String;
462
743
  }
463
744
  export declare enum VeLivePusherRenderMode {
464
-
745
+ /** {zh}
746
+ * @brief 视频帧自适应画布。视频帧非等比缩放,直至画布被填满。在此过程中,视频帧的长宽比例可能会发生变化。
747
+ *
748
+ */
465
749
  /** {en}
466
750
  * @brief Stretch the video to fill the screen. The aspect ratio of the video might change.
467
751
  *
468
752
  */
469
753
  VeLivePusherRenderModeFill = 0,
470
-
754
+ /** {zh}
755
+ * @brief 视频帧内容全部显示优先。视频尺寸等比缩放,优先保证视频内容全部显示。当视频尺寸与显示窗口尺寸不一致时,会把窗口未被填满的区域填充成背景颜色。
756
+ *
757
+ */
471
758
  /** {en}
472
759
  * @brief Display the full video. The video is uniformly scaled until one dimension of the video hits the boundary of the screen. Any remaining space on the screen will be filled with background color.
473
760
  *
474
761
  */
475
762
  VeLivePusherRenderModeFit = 1,
476
-
763
+ /** {zh}
764
+ * @brief 视窗填满优先。视频帧等比缩放,直至视窗被视频填满。如果视频帧长宽比例与视窗不同,视频帧的多出部分将无法显示。
765
+ *
766
+ */
477
767
  /** {en}
478
768
  * @brief Uniformly scale the video until the screen is completely filled. Part of the video may be cropped.
479
769
  *
@@ -481,13 +771,19 @@ export declare enum VeLivePusherRenderMode {
481
771
  VeLivePusherRenderModeHidden = 2
482
772
  }
483
773
  export declare enum VeLiveVideoEffectLicenseType {
484
-
774
+ /** {zh}
775
+ * @brief 离线认证视频特效许可证。
776
+ *
777
+ */
485
778
  /** {en}
486
779
  * @brief Authenticate offline.
487
780
  *
488
781
  */
489
782
  VeLiveVideoEffectLicenseTypeOffLine = 0,
490
-
783
+ /** {zh}
784
+ * @brief 在线认证视频特效许可证。
785
+ *
786
+ */
491
787
  /** {en}
492
788
  * @brief Authenticate online.
493
789
  *
@@ -495,13 +791,19 @@ export declare enum VeLiveVideoEffectLicenseType {
495
791
  VeLiveVideoEffectLicenseTypeOnLine = 1
496
792
  }
497
793
  export declare enum VeLiveAudioBufferType {
498
-
794
+ /** {zh}
795
+ * @brief 未知的音频数据类型。
796
+ *
797
+ */
499
798
  /** {en}
500
799
  * @brief Unknown data type.
501
800
  *
502
801
  */
503
802
  VeLiveAudioBufferTypeUnknown = 0,
504
-
803
+ /** {zh}
804
+ * @brief ByteBuffer 音频数据类型。
805
+ *
806
+ */
505
807
  /** {en}
506
808
  * @brief ByteBuffer.
507
809
  *
@@ -509,13 +811,19 @@ export declare enum VeLiveAudioBufferType {
509
811
  VeLiveAudioBufferTypeByteBuffer = 1
510
812
  }
511
813
  export declare enum VeLiveAudioChannel {
512
-
814
+ /** {zh}
815
+ * @brief 单声道,适用于语音通信,节省带宽。
816
+ *
817
+ */
513
818
  /** {en}
514
819
  * @brief Mono, which is suitable for voice communication and saves bandwidth.
515
820
  *
516
821
  */
517
822
  VeLiveAudioChannelMono = 1,
518
-
823
+ /** {zh}
824
+ * @brief 立体声,适用于音乐播放,提供更丰富的音频体验。
825
+ *
826
+ */
519
827
  /** {en}
520
828
  * @brief Stereo, which provides a richer audio experience and is suitable for music playback.
521
829
  *
@@ -523,25 +831,37 @@ export declare enum VeLiveAudioChannel {
523
831
  VeLiveAudioChannelStereo = 2
524
832
  }
525
833
  export declare enum VeLiveFirstFrameType {
526
-
834
+ /** {zh}
835
+ * @brief 视频/音频采集首帧,采集首帧是从音频设备或视频设备(如麦克风、摄像头)获取的第一帧数据。
836
+ *
837
+ */
527
838
  /** {en}
528
839
  * @brief The first audio or video frame captured by the microphone or the camera.
529
840
  *
530
841
  */
531
842
  VeLiveFirstCaptureFrame = 0,
532
-
843
+ /** {zh}
844
+ * @brief 视频渲染首帧,渲染首帧是在渲染过程中在屏幕上显示的第一帧视频数据。
845
+ *
846
+ */
533
847
  /** {en}
534
848
  * @brief The first video frame rendered, which is the first frame displayed on the screen.
535
849
  *
536
850
  */
537
851
  VeLiveFirstRenderFrame = 1,
538
-
852
+ /** {zh}
853
+ * @brief 视频/音频编码完成首帧,编码完成首帧是编码为某种特定格式的第一帧数据。
854
+ *
855
+ */
539
856
  /** {en}
540
857
  * @brief The first audio or video frame encoded in a certain format.
541
858
  *
542
859
  */
543
860
  VeLiveFirstEncodedFrame = 2,
544
-
861
+ /** {zh}
862
+ * @brief 视频/音频发送首帧,发送首帧是在发送过程中,通过网络传输的第一帧数据。
863
+ *
864
+ */
545
865
  /** {en}
546
866
  * @brief The first audio or video frame transmitted through the network.
547
867
  *
@@ -549,48 +869,72 @@ export declare enum VeLiveFirstFrameType {
549
869
  VeLiveFirstSendFrame = 3
550
870
  }
551
871
  export declare enum VeLiveVideoCaptureType {
552
-
872
+ /** {zh}
873
+ * @brief 使用前置摄像头进行视频采集。
874
+ *
875
+ */
553
876
  /** {en}
554
877
  * @brief Capture the video with the front-facing camera.
555
878
  *
556
879
  */
557
880
  VeLiveVideoCaptureFrontCamera = 0,
558
-
881
+ /** {zh}
882
+ * @brief 使用后置摄像头进行视频采集。
883
+ *
884
+ */
559
885
  /** {en}
560
886
  * @brief Capture the video with the rear camera.
561
887
  *
562
888
  */
563
889
  VeLiveVideoCaptureBackCamera = 1,
564
-
890
+ /** {zh}
891
+ * @brief 使用设备的双摄进行视频采集。
892
+ *
893
+ */
565
894
  /** {en}
566
895
  * @brief Capture the video with dual cameras.
567
896
  *
568
897
  */
569
-
898
+ /** {zh}
899
+ * @brief 使用屏幕采集。
900
+ *
901
+ */
570
902
  /** {en}
571
903
  * @brief Capture the screen.
572
904
  *
573
905
  */
574
906
  VeLiveVideoCaptureScreen = 2,
575
-
907
+ /** {zh}
908
+ * @brief 使用外部设备或源进行视频采集。
909
+ *
910
+ */
576
911
  /** {en}
577
912
  * @brief Capture the video with an external device or source.
578
913
  *
579
914
  */
580
915
  VeLiveVideoCaptureExternal = 3,
581
-
916
+ /** {zh}
917
+ * @brief 使用指定的静态图片作为视频源。
918
+ *
919
+ */
582
920
  /** {en}
583
921
  * @brief Use a static image as the video source.
584
922
  *
585
923
  */
586
924
  VeLiveVideoCaptureCustomImage = 4,
587
-
925
+ /** {zh}
926
+ * @brief 使用最近采集的一帧图像重复作为视频源。
927
+ *
928
+ */
588
929
  /** {en}
589
930
  * @brief Use the last frame as the video source.
590
931
  *
591
932
  */
592
933
  VeLiveVideoCaptureLastFrame = 5,
593
-
934
+ /** {zh}
935
+ * @brief 使用黑色帧作为视频源,一般用于调试或特殊需求。
936
+ *
937
+ */
594
938
  /** {en}
595
939
  * @brief Use a black frame as the video source. This is usually used for debugging purposes or in special circumstances.
596
940
  *
@@ -598,31 +942,46 @@ export declare enum VeLiveVideoCaptureType {
598
942
  VeLiveVideoCaptureDummyFrame = 6
599
943
  }
600
944
  export declare enum VeLiveVideoProfile {
601
-
945
+ /** {zh}
946
+ * @brief 未知的视频配置类型。
947
+ *
948
+ */
602
949
  /** {en}
603
950
  * @brief Unknown codec.
604
951
  *
605
952
  */
606
953
  VeLiveVideoProfileUnknown = 0,
607
-
954
+ /** {zh}
955
+ * @brief H.264 编码配置,使用 Baseline 级别。
956
+ *
957
+ */
608
958
  /** {en}
609
959
  * @brief H.264, using Baseline level.
610
960
  *
611
961
  */
612
962
  VeLiveVideoProfileH264Baseline = 1,
613
-
963
+ /** {zh}
964
+ * @brief H.264 编码配置,使用 Main 级别。
965
+ *
966
+ */
614
967
  /** {en}
615
968
  * @brief H.264, using Main level.
616
969
  *
617
970
  */
618
971
  VeLiveVideoProfileH264Main = 2,
619
-
972
+ /** {zh}
973
+ * @brief H.264 编码配置,使用 High 级别。
974
+ *
975
+ */
620
976
  /** {en}
621
977
  * @brief H.264, using High level.
622
978
  *
623
979
  */
624
980
  VeLiveVideoProfileH264High = 3,
625
-
981
+ /** {zh}
982
+ * @brief ByteVC1 编码配置,使用 Main 级别。
983
+ *
984
+ */
626
985
  /** {en}
627
986
  * @brief ByteVC1, using Main level.
628
987
  *
@@ -630,25 +989,37 @@ export declare enum VeLiveVideoProfile {
630
989
  VeLiveVideoProfileByteVC1Main = 4
631
990
  }
632
991
  export declare enum VeLiveVideoRotation {
633
-
992
+ /** {zh}
993
+ * @brief 不旋转。
994
+ *
995
+ */
634
996
  /** {en}
635
997
  * @brief Do not rotate.
636
998
  *
637
999
  */
638
1000
  VeLiveVideoRotation0 = 0,
639
-
1001
+ /** {zh}
1002
+ * @brief 顺时针旋转 90 度。
1003
+ *
1004
+ */
640
1005
  /** {en}
641
1006
  * @brief Rotate by 90 degrees clockwise.
642
1007
  *
643
1008
  */
644
1009
  VeLiveVideoRotation90 = 90,
645
-
1010
+ /** {zh}
1011
+ * @brief 顺时针旋转 180 度。
1012
+ *
1013
+ */
646
1014
  /** {en}
647
1015
  * @brief Rotate by 180 degrees clockwise.
648
1016
  *
649
1017
  */
650
1018
  VeLiveVideoRotation180 = 180,
651
-
1019
+ /** {zh}
1020
+ * @brief 顺时针旋转 270 度。
1021
+ *
1022
+ */
652
1023
  /** {en}
653
1024
  * @brief Rotate by 270 degrees clockwise.
654
1025
  *
@@ -656,13 +1027,19 @@ export declare enum VeLiveVideoRotation {
656
1027
  VeLiveVideoRotation270 = 270
657
1028
  }
658
1029
  export declare enum VeLiveVideoFrameSource {
659
-
1030
+ /** {zh}
1031
+ * @brief 采集到的原始视频帧。这是从设备的摄像头或其他视频输入源获取的视频帧。
1032
+ *
1033
+ */
660
1034
  /** {en}
661
1035
  * @brief The original video frame captured by the camera or other video sources.
662
1036
  *
663
1037
  */
664
1038
  VeLiveVideoFrameSourceCapture = 1,
665
-
1039
+ /** {zh}
1040
+ * @brief 编码前的视频帧。这是通过各种处理(例如滤镜、旋转等)后,准备进行编码的视频帧。
1041
+ *
1042
+ */
666
1043
  /** {en}
667
1044
  * @brief The video frame to be encoded after undergoing various processes, such as filtering and rotation.
668
1045
  *
@@ -670,19 +1047,28 @@ export declare enum VeLiveVideoFrameSource {
670
1047
  VeLiveVideoFrameSourcePreEncode = "1 << 1"
671
1048
  }
672
1049
  export declare enum VeLiveAudioProfile {
673
-
1050
+ /** {zh}
1051
+ * @brief LC-AAC 编码方式。
1052
+ *
1053
+ */
674
1054
  /** {en}
675
1055
  * @brief LC-AAC.
676
1056
  *
677
1057
  */
678
1058
  VeLiveAudioAACProfileLC = 0,
679
-
1059
+ /** {zh}
1060
+ * @brief HEv1-AAC 编码方式。
1061
+ *
1062
+ */
680
1063
  /** {en}
681
1064
  * @brief HEv1-AAC.
682
1065
  *
683
1066
  */
684
1067
  VeLiveAudioAACProfileHEv1 = 1,
685
-
1068
+ /** {zh}
1069
+ * @brief HEv2-AAC 编码方式。
1070
+ *
1071
+ */
686
1072
  /** {en}
687
1073
  * @brief HEv2-AAC.
688
1074
  *
@@ -690,25 +1076,37 @@ export declare enum VeLiveAudioProfile {
690
1076
  VeLiveAudioAACProfileHEv2 = 2
691
1077
  }
692
1078
  export declare enum VeLiveVideoBufferType {
693
-
1079
+ /** {zh}
1080
+ * @brief 未知视频数据类型,当未指定输入视频数据的格式时,会默认为此类型。
1081
+ *
1082
+ */
694
1083
  /** {en}
695
1084
  * @brief Unknown data type, which is the default type if you do not specify any type.
696
1085
  *
697
1086
  */
698
1087
  VeLiveVideoBufferTypeUnknown = 0,
699
-
1088
+ /** {zh}
1089
+ * @brief 视频数据类型为 OpenGL 纹理。
1090
+ *
1091
+ */
700
1092
  /** {en}
701
1093
  * @brief OpenGL texture.
702
1094
  *
703
1095
  */
704
1096
  VeLiveVideoBufferTypeTexture = 1,
705
-
1097
+ /** {zh}
1098
+ * @brief 视频数据类型为 ByteBuffer 类型。
1099
+ *
1100
+ */
706
1101
  /** {en}
707
1102
  * @brief ByteBuffer.
708
1103
  *
709
1104
  */
710
1105
  VeLiveVideoBufferTypeByteBuffer = 2,
711
-
1106
+ /** {zh}
1107
+ * @brief 视频数据类型为 ByteArray 类型。
1108
+ *
1109
+ */
712
1110
  /** {en}
713
1111
  * @brief ByteArray.
714
1112
  *
@@ -716,7 +1114,12 @@ export declare enum VeLiveVideoBufferType {
716
1114
  VeLiveVideoBufferTypeByteArray = 3
717
1115
  }
718
1116
  export declare class VeLiveAudioCaptureConfiguration {
719
-
1117
+ /** {zh}
1118
+ * @detail api
1119
+ * @brief 获取采集音频采样率。
1120
+ * @return 音频采样率,详情请参见 [VeLiveAudioSampleRate](#VeLiveAudioSampleRate)。
1121
+ *
1122
+ */
720
1123
  /** {en}
721
1124
  * @detail api
722
1125
  * @brief Gets the sample rate.
@@ -724,7 +1127,13 @@ export declare class VeLiveAudioCaptureConfiguration {
724
1127
  *
725
1128
  */
726
1129
  getSampleRate(): VeLiveAudioSampleRate;
727
-
1130
+ /** {zh}
1131
+ * @detail api
1132
+ * @brief 设置采集音频采样率。
1133
+ * @param sampleRate 音频采样率,默认值为 VeLiveAudioSampleRate44100,详情请参见 [VeLiveAudioSampleRate](#VeLiveAudioSampleRate)。
1134
+ * @return 推流音频采集参数配置对象,详情请参见 [VeLiveAudioCaptureConfiguration](#VeLivePusherDef-VeLiveAudioCaptureConfiguration)。
1135
+ *
1136
+ */
728
1137
  /** {en}
729
1138
  * @detail api
730
1139
  * @brief Sets the sample rate.
@@ -733,7 +1142,12 @@ export declare class VeLiveAudioCaptureConfiguration {
733
1142
  *
734
1143
  */
735
1144
  setSampleRate(sampleRate: VeLiveAudioSampleRate): this;
736
-
1145
+ /** {zh}
1146
+ * @detail api
1147
+ * @brief 获取采集音频声道数。
1148
+ * @return 音频声道数,详情请参见 [VeLiveAudioChannel](#VeLiveAudioChannel)。
1149
+ *
1150
+ */
737
1151
  /** {en}
738
1152
  * @detail api
739
1153
  * @brief Gets the number of audio channels.
@@ -741,7 +1155,13 @@ export declare class VeLiveAudioCaptureConfiguration {
741
1155
  *
742
1156
  */
743
1157
  getChannel(): VeLiveAudioChannel;
744
-
1158
+ /** {zh}
1159
+ * @detail api
1160
+ * @brief 设置采集音频声道数。
1161
+ * @param channel 音频声道数,默认值为 VeLiveAudioChannelStereo,详情请参见 [VeLiveAudioChannel](#VeLiveAudioChannel)
1162
+ * @return 推流音频采集参数配置对象,详情请参见 [VeLiveAudioCaptureConfiguration](#VeLivePusherDef-VeLiveAudioCaptureConfiguration)。
1163
+ *
1164
+ */
745
1165
  /** {en}
746
1166
  * @detail api
747
1167
  * @brief Sets the number of audio channels.
@@ -752,19 +1172,28 @@ export declare class VeLiveAudioCaptureConfiguration {
752
1172
  setChannel(channel: VeLiveAudioChannel): this;
753
1173
  }
754
1174
  export declare class VeLiveStreamMixDescription {
755
-
1175
+ /** {zh}
1176
+ * @brief 视频混流布局设置的数组,其中每个元素代表一路视频流的布局。详情请参见 [VeLiveMixVideoLayout](#VeLivePusherDef-VeLiveMixVideoLayout)。
1177
+ *
1178
+ */
756
1179
  /** {en}
757
1180
  * @brief An array of video mixing configurations, where each array element represents the mixing configurations of a video stream. See [VeLiveMixVideoLayout](#VeLivePusherDef-VeLiveMixVideoLayout) for details.
758
1181
  *
759
1182
  */
760
1183
  mixVideoStreams: ArrayList<VeLiveMixVideoLayout>;
761
-
1184
+ /** {zh}
1185
+ * @brief 音频混流设置的数组,其中每个元素代表一路音频流的。详情请参见 [VeLiveMixAudioLayout](#VeLivePusherDef-VeLiveMixAudioLayout)。
1186
+ *
1187
+ */
762
1188
  /** {en}
763
1189
  * @brief An array of audio mixing configurations, where each array element represents the mixing configurations of an audio stream. See [VeLiveMixAudioLayout](#VeLivePusherDef-VeLiveMixAudioLayout) for details.
764
1190
  *
765
1191
  */
766
1192
  mixAudioStreams: ArrayList<VeLiveMixAudioLayout>;
767
-
1193
+ /** {zh}
1194
+ * @brief 视频混流画布的背景色设置,采用 #RRGGBB 格式。
1195
+ *
1196
+ */
768
1197
  /** {en}
769
1198
  * @brief The background color of the mixed video, in #RRGGBB format.
770
1199
  *
@@ -772,31 +1201,46 @@ export declare class VeLiveStreamMixDescription {
772
1201
  backgroundColor: String;
773
1202
  }
774
1203
  export declare enum VeLiveAudioSampleRate {
775
-
1204
+ /** {zh}
1205
+ * @brief 8k 采样。
1206
+ *
1207
+ */
776
1208
  /** {en}
777
1209
  * @brief 8K.
778
1210
  *
779
1211
  */
780
1212
  VeLiveAudioSampleRate8000 = 8000,
781
-
1213
+ /** {zh}
1214
+ * @brief 16k 采样。
1215
+ *
1216
+ */
782
1217
  /** {en}
783
1218
  * @brief 16K.
784
1219
  *
785
1220
  */
786
1221
  VeLiveAudioSampleRate16000 = 16000,
787
-
1222
+ /** {zh}
1223
+ * @brief 32k 采样。
1224
+ *
1225
+ */
788
1226
  /** {en}
789
1227
  * @brief 32K.
790
1228
  *
791
1229
  */
792
1230
  VeLiveAudioSampleRate32000 = 32000,
793
-
1231
+ /** {zh}
1232
+ * @brief 44.1k 采样。
1233
+ *
1234
+ */
794
1235
  /** {en}
795
1236
  * @brief 44.1K.
796
1237
  *
797
1238
  */
798
1239
  VeLiveAudioSampleRate44100 = 44100,
799
-
1240
+ /** {zh}
1241
+ * @brief 48k 采样。
1242
+ *
1243
+ */
800
1244
  /** {en}
801
1245
  * @brief 48K.
802
1246
  *
@@ -804,37 +1248,55 @@ export declare enum VeLiveAudioSampleRate {
804
1248
  VeLiveAudioSampleRate48000 = 48000
805
1249
  }
806
1250
  export declare enum VeLiveAudioPowerLevel {
807
-
1251
+ /** {zh}
1252
+ * @brief 无声,音量 ≤1db。
1253
+ *
1254
+ */
808
1255
  /** {en}
809
1256
  * @brief Muted. The volume is 1 dB or less.
810
1257
  *
811
1258
  */
812
1259
  VeLiveAudioPowerLevelSilent = 0,
813
-
1260
+ /** {zh}
1261
+ * @brief 安静,音量 15db 以下。
1262
+ *
1263
+ */
814
1264
  /** {en}
815
1265
  * @brief Quiet. The volume is below 15 dB.
816
1266
  *
817
1267
  */
818
1268
  VeLiveAudioPowerLevelQuiet = 1,
819
-
1269
+ /** {zh}
1270
+ * @brief 轻声,接近耳语音量,音量为 16db~30db 之间。
1271
+ *
1272
+ */
820
1273
  /** {en}
821
1274
  * @brief Soft, close to whisper. The volume is between 16 dB and 30 dB.
822
1275
  *
823
1276
  */
824
1277
  VeLiveAudioPowerLevelLight = 2,
825
-
1278
+ /** {zh}
1279
+ * @brief 正常,音量适宜,类似正常对话的音量,音量为 30db~60db 之间。
1280
+ *
1281
+ */
826
1282
  /** {en}
827
1283
  * @brief Normal, similar to the volume in a daily conversation. The volume is between 30 dB and 60 dB.
828
1284
  *
829
1285
  */
830
1286
  VeLiveAudioPowerLevelNormal = 3,
831
-
1287
+ /** {zh}
1288
+ * @brief 较大,音量较高,类似咖啡馆、餐厅的环境噪音,音量为 61db~85db 之间。
1289
+ *
1290
+ */
832
1291
  /** {en}
833
1292
  * @brief Loud, similar to the volume of the noise at cafes. The volume is between 61 dB and 85 dB.
834
1293
  *
835
1294
  */
836
1295
  VeLiveAudioPowerLevelLoud = 4,
837
-
1296
+ /** {zh}
1297
+ * @brief 吵闹,音量极高,类似于繁忙的街道或者是音乐会现场,音量超过 85db。
1298
+ *
1299
+ */
838
1300
  /** {en}
839
1301
  * @brief Noisy, similar to the volume of the noise on a busy street or at a concert. The volume is higher than 85 dB.
840
1302
  *
@@ -842,7 +1304,12 @@ export declare enum VeLiveAudioPowerLevel {
842
1304
  VeLiveAudioPowerLevelNoise = 5
843
1305
  }
844
1306
  export declare class VeLiveVideoCaptureConfiguration {
845
-
1307
+ /** {zh}
1308
+ * @detail api
1309
+ * @brief 获取采集视频宽度。
1310
+ * @return 采集视频宽度。
1311
+ *
1312
+ */
846
1313
  /** {en}
847
1314
  * @detail api
848
1315
  * @brief Gets the width of the captured video.
@@ -850,7 +1317,13 @@ export declare class VeLiveVideoCaptureConfiguration {
850
1317
  *
851
1318
  */
852
1319
  getWidth(): int;
853
-
1320
+ /** {zh}
1321
+ * @detail api
1322
+ * @brief 设置采集视频宽度。
1323
+ * @param width 采集视频宽度,默认值为 720。
1324
+ * @return 推流视频采集参数配置对象,详情请参见 [VeLiveVideoCaptureConfiguration](#VeLivePusherDef-VeLiveVideoCaptureConfiguration)。
1325
+ *
1326
+ */
854
1327
  /** {en}
855
1328
  * @detail api
856
1329
  * @brief Sets the width of the captured video.
@@ -859,7 +1332,13 @@ export declare class VeLiveVideoCaptureConfiguration {
859
1332
  *
860
1333
  */
861
1334
  setWidth(width: int): this;
862
-
1335
+ /** {zh}
1336
+ * @detail api
1337
+ * @brief 获取采集视频高度。
1338
+ * @return <br>
1339
+ * 采集视频高度。
1340
+ *
1341
+ */
863
1342
  /** {en}
864
1343
  * @detail api
865
1344
  * @brief Gets the height of the captured video.
@@ -868,7 +1347,13 @@ export declare class VeLiveVideoCaptureConfiguration {
868
1347
  *
869
1348
  */
870
1349
  getHeight(): int;
871
-
1350
+ /** {zh}
1351
+ * @detail api
1352
+ * @brief 设置采集视频高度。
1353
+ * @param height 采集视频高度,默认值为 1280。
1354
+ * @return 推流视频采集参数配置对象,详情请参见 [VeLiveVideoCaptureConfiguration](#VeLivePusherDef-VeLiveVideoCaptureConfiguration)。
1355
+ *
1356
+ */
872
1357
  /** {en}
873
1358
  * @detail api
874
1359
  * @brief Sets the height of the captured video.
@@ -877,7 +1362,13 @@ export declare class VeLiveVideoCaptureConfiguration {
877
1362
  *
878
1363
  */
879
1364
  setHeight(height: int): this;
880
-
1365
+ /** {zh}
1366
+ * @detail api
1367
+ * @brief 获取采集视频帧率。
1368
+ * @return <br>
1369
+ * 采集视频帧率。
1370
+ *
1371
+ */
881
1372
  /** {en}
882
1373
  * @detail api
883
1374
  * @brief Gets the captured frame rate.
@@ -885,7 +1376,13 @@ export declare class VeLiveVideoCaptureConfiguration {
885
1376
  *
886
1377
  */
887
1378
  getFps(): int;
888
-
1379
+ /** {zh}
1380
+ * @detail api
1381
+ * @brief 设置采集视频帧率。
1382
+ * @param fps 采集视频帧率,默认值为 15。
1383
+ * @return 推流视频采集参数配置对象,详情请参见 [VeLiveVideoCaptureConfiguration](#VeLivePusherDef-VeLiveVideoCaptureConfiguration)。
1384
+ *
1385
+ */
889
1386
  /** {en}
890
1387
  * @detail api
891
1388
  * @brief Sets the captured frame rate.
@@ -896,37 +1393,55 @@ export declare class VeLiveVideoCaptureConfiguration {
896
1393
  setFps(fps: int): this;
897
1394
  }
898
1395
  export declare enum VeLivePixelFormat {
899
-
1396
+ /** {zh}
1397
+ * @brief 未知格式。
1398
+ *
1399
+ */
900
1400
  /** {en}
901
1401
  * @brief Unknown format.
902
1402
  *
903
1403
  */
904
1404
  VeLivePixelFormatUnknown = 0,
905
-
1405
+ /** {zh}
1406
+ * @brief I420 格式。
1407
+ *
1408
+ */
906
1409
  /** {en}
907
1410
  * @brief I420.
908
1411
  *
909
1412
  */
910
1413
  VeLivePixelFormatI420 = 1,
911
-
1414
+ /** {zh}
1415
+ * @brief NV12 格式。
1416
+ *
1417
+ */
912
1418
  /** {en}
913
1419
  * @brief NV12.
914
1420
  *
915
1421
  */
916
1422
  VeLivePixelFormatNV12 = 2,
917
-
1423
+ /** {zh}
1424
+ * @brief NV21 格式。
1425
+ *
1426
+ */
918
1427
  /** {en}
919
1428
  * @brief NV21.
920
1429
  *
921
1430
  */
922
1431
  VeLivePixelFormatNV21 = 3,
923
-
1432
+ /** {zh}
1433
+ * @brief 2D 纹理格式。
1434
+ *
1435
+ */
924
1436
  /** {en}
925
1437
  * @brief 2D texture.
926
1438
  *
927
1439
  */
928
1440
  VeLivePixelFormat2DTexture = 4,
929
-
1441
+ /** {zh}
1442
+ * @brief OES 纹理格式。
1443
+ *
1444
+ */
930
1445
  /** {en}
931
1446
  * @brief OES texture.
932
1447
  *
@@ -934,43 +1449,64 @@ export declare enum VeLivePixelFormat {
934
1449
  VeLivePixelFormatOesTexture = 5
935
1450
  }
936
1451
  export declare enum VeLivePusherStatus {
937
-
1452
+ /** {zh}
1453
+ * @brief 初始状态。
1454
+ *
1455
+ */
938
1456
  /** {en}
939
1457
  * @brief The initial state.
940
1458
  *
941
1459
  */
942
1460
  VeLivePushStatusNone = 0,
943
-
1461
+ /** {zh}
1462
+ * @brief 正在连接服务器。
1463
+ *
1464
+ */
944
1465
  /** {en}
945
1466
  * @brief Connecting to the server.
946
1467
  *
947
1468
  */
948
1469
  VeLivePushStatusConnecting = 1,
949
-
1470
+ /** {zh}
1471
+ * @brief 连接服务器成功。
1472
+ *
1473
+ */
950
1474
  /** {en}
951
1475
  * @brief The connection with the server is established.
952
1476
  *
953
1477
  */
954
1478
  VeLivePushStatusConnectSuccess = 2,
955
-
1479
+ /** {zh}
1480
+ * @brief 重连服务器中。
1481
+ *
1482
+ */
956
1483
  /** {en}
957
1484
  * @brief Reconnecting to the server.
958
1485
  *
959
1486
  */
960
1487
  VeLivePushStatusReconnecting = 3,
961
-
1488
+ /** {zh}
1489
+ * @brief 推流连接被终止。
1490
+ *
1491
+ */
962
1492
  /** {en}
963
1493
  * @brief Stops connecting to the server.
964
1494
  *
965
1495
  */
966
1496
  VeLivePushStatusConnectStop = 4,
967
-
1497
+ /** {zh}
1498
+ * @brief 推流连接失败。
1499
+ *
1500
+ */
968
1501
  /** {en}
969
1502
  * @brief Fails to connect to the server.
970
1503
  *
971
1504
  */
972
1505
  VeLivePushStatusConnectError = 5,
973
-
1506
+ /** {zh}
1507
+ * @brief 与服务器断开连接。
1508
+ *
1509
+ */
974
1510
  /** {en}
975
1511
  * @brief The connection with the server is lost.
976
1512
  *
@@ -978,7 +1514,16 @@ export declare enum VeLivePusherStatus {
978
1514
  VeLivePushStatusDisconnected = 6
979
1515
  }
980
1516
  export declare enum VeLiveVideoResolution {
981
-
1517
+ /** {zh}
1518
+ * @brief 360P 分辨率。档位详细配置如下所示。
1519
+ * - 横屏分辨率:640x360
1520
+ * - 竖屏分辨率:360x640
1521
+ * - 帧率:15fps
1522
+ * - 目标码率:500kbps
1523
+ * - 最小码率:250kbps
1524
+ * - 最大码率:800kbps
1525
+ *
1526
+ */
982
1527
  /** {en}
983
1528
  * @brief 360P.
984
1529
  * - Resolution in landscape mode: 640x360
@@ -990,7 +1535,16 @@ export declare enum VeLiveVideoResolution {
990
1535
  *
991
1536
  */
992
1537
  VeLiveVideoResolution360P = "VeLiveVideoResolution360P",
993
-
1538
+ /** {zh}
1539
+ * @brief 480P 分辨率。档位详细配置如下所示。
1540
+ * - 横屏分辨率:864x480
1541
+ * - 竖屏分辨率:480x864
1542
+ * - 帧率:15fps
1543
+ * - 目标码率:800kbps
1544
+ * - 最小码率:320kbps
1545
+ * - 最大码率:1266kbps
1546
+ *
1547
+ */
994
1548
  /** {en}
995
1549
  * @brief 480P.
996
1550
  * - Resolution in landscape mode: 864x480
@@ -1002,7 +1556,16 @@ export declare enum VeLiveVideoResolution {
1002
1556
  *
1003
1557
  */
1004
1558
  VeLiveVideoResolution480P = "VeLiveVideoResolution480P",
1005
-
1559
+ /** {zh}
1560
+ * @brief 540P 分辨率。档位详细配置如下所示。
1561
+ * - 横屏 960x540
1562
+ * - 竖屏 540x960
1563
+ * - 帧率:15fps
1564
+ * - 目标码率:1000kbps
1565
+ * - 最小码率:500kbps
1566
+ * - 最大码率:1520kbps
1567
+ *
1568
+ */
1006
1569
  /** {en}
1007
1570
  * @brief 540P.
1008
1571
  * - Resolution in landscape mode: 960x540
@@ -1014,7 +1577,16 @@ export declare enum VeLiveVideoResolution {
1014
1577
  *
1015
1578
  */
1016
1579
  VeLiveVideoResolution540P = "VeLiveVideoResolution540P",
1017
-
1580
+ /** {zh}
1581
+ * @brief 720P 分辨率。档位详细配置如下所示。
1582
+ * - 横屏 1280x720
1583
+ * - 竖屏 720x1280
1584
+ * - 帧率:15fps
1585
+ * - 目标码率:1200kbps
1586
+ * - 最小码率:800kbps
1587
+ * - 最大码率:1900kbps
1588
+ *
1589
+ */
1018
1590
  /** {en}
1019
1591
  * @brief 720P.
1020
1592
  * - Resolution in landscape mode: 1280x720
@@ -1026,7 +1598,16 @@ export declare enum VeLiveVideoResolution {
1026
1598
  *
1027
1599
  */
1028
1600
  VeLiveVideoResolution720P = "VeLiveVideoResolution720P",
1029
-
1601
+ /** {zh}
1602
+ * @brief 1080P 分辨率。档位详细配置如下所示。
1603
+ * - 横屏 1920x1080
1604
+ * - 竖屏 1080x1920
1605
+ * - 帧率:20 fps
1606
+ * - 目标码率:2500kbps
1607
+ * - 最小码率:1000kbps
1608
+ * - 最大码率:3800kbps
1609
+ *
1610
+ */
1030
1611
  /** {en}
1031
1612
  * @brief 1080P.
1032
1613
  * - Resolution in landscape mode: 1920x1080
@@ -1041,7 +1622,12 @@ export declare enum VeLiveVideoResolution {
1041
1622
  }
1042
1623
  export declare class VeLiveAudioFrame {
1043
1624
  constructor();
1044
-
1625
+ /** {zh}
1626
+ * @detail api
1627
+ * @brief 获取音频数据类型。
1628
+ * @return 音频数据类型,详情请参见 [VeLiveAudioBufferType](#VeLiveAudioBufferType)。
1629
+ *
1630
+ */
1045
1631
  /** {en}
1046
1632
  * @detail api
1047
1633
  * @brief Gets the audio data type.
@@ -1049,7 +1635,12 @@ export declare class VeLiveAudioFrame {
1049
1635
  *
1050
1636
  */
1051
1637
  getBufferType(): VeLiveAudioBufferType;
1052
-
1638
+ /** {zh}
1639
+ * @detail api
1640
+ * @brief 获取音频采样率。
1641
+ * @return 音频采样率,详情请参见 [VeLiveAudioSampleRate](#VeLiveAudioSampleRate)。
1642
+ *
1643
+ */
1053
1644
  /** {en}
1054
1645
  * @detail api
1055
1646
  * @brief Gets the audio sample rate.
@@ -1057,7 +1648,12 @@ export declare class VeLiveAudioFrame {
1057
1648
  *
1058
1649
  */
1059
1650
  getSampleRate(): VeLiveAudioSampleRate;
1060
-
1651
+ /** {zh}
1652
+ * @detail api
1653
+ * @brief 获取音频声道数。
1654
+ * @return 音频声道数,详情请参见 [VeLiveAudioChannel](#VeLiveAudioChannel)。
1655
+ *
1656
+ */
1061
1657
  /** {en}
1062
1658
  * @detail api
1063
1659
  * @brief Gets the number of audio channels.
@@ -1065,7 +1661,12 @@ export declare class VeLiveAudioFrame {
1065
1661
  *
1066
1662
  */
1067
1663
  getChannels(): VeLiveAudioChannel;
1068
-
1664
+ /** {zh}
1665
+ * @detail api
1666
+ * @brief 获取每个声道的采样点数。
1667
+ * @return 采样点数。
1668
+ *
1669
+ */
1069
1670
  /** {en}
1070
1671
  * @detail api
1071
1672
  * @brief Get the number of sampling points of each channel.
@@ -1073,7 +1674,13 @@ export declare class VeLiveAudioFrame {
1073
1674
  *
1074
1675
  */
1075
1676
  getSamplesPerChannel(): int;
1076
-
1677
+ /** {zh}
1678
+ * @detail api
1679
+ * @brief 获取音频时间戳,单位为 μs。
1680
+ * @return <br>
1681
+ * 音频时间戳,单位为 μs。
1682
+ *
1683
+ */
1077
1684
  /** {en}
1078
1685
  * @detail api
1079
1686
  * @brief Gets the audio timestamp, in μs.
@@ -1082,7 +1689,13 @@ export declare class VeLiveAudioFrame {
1082
1689
  *
1083
1690
  */
1084
1691
  getPts(): long;
1085
-
1692
+ /** {zh}
1693
+ * @detail api
1694
+ * @brief 获取音频数据。音频帧数据为小端字节序存储。
1695
+ * @return <br>
1696
+ * 格式为 ByteBuffer 的音频数据。
1697
+ *
1698
+ */
1086
1699
  /** {en}
1087
1700
  * @detail api
1088
1701
  * @brief Gets the audio data. The audio data is stored in little-endian byte order.
@@ -1093,25 +1706,37 @@ export declare class VeLiveAudioFrame {
1093
1706
  getBuffer(): ByteBuffer;
1094
1707
  }
1095
1708
  export declare enum VeLiveNetworkQuality {
1096
-
1709
+ /** {zh}
1710
+ * @brief 未查询到网络状态。
1711
+ *
1712
+ */
1097
1713
  /** {en}
1098
1714
  * @brief Network status not found.
1099
1715
  *
1100
1716
  */
1101
1717
  VeLiveNetworkQualityUnknown = 0,
1102
-
1718
+ /** {zh}
1719
+ * @brief 网络差。
1720
+ *
1721
+ */
1103
1722
  /** {en}
1104
1723
  * @brief Bad network condition.
1105
1724
  *
1106
1725
  */
1107
1726
  VeLiveNetworkQualityBad = 1,
1108
-
1727
+ /** {zh}
1728
+ * @brief 网络一般。
1729
+ *
1730
+ */
1109
1731
  /** {en}
1110
1732
  * @brief Poor network condition.
1111
1733
  *
1112
1734
  */
1113
1735
  VeLiveNetworkQualityPoor = 2,
1114
-
1736
+ /** {zh}
1737
+ * @brief 网络状态佳。
1738
+ *
1739
+ */
1115
1740
  /** {en}
1116
1741
  * @brief Good network condition.
1117
1742
  *
@@ -1119,37 +1744,55 @@ export declare enum VeLiveNetworkQuality {
1119
1744
  VeLiveNetworkQualityGood = 3
1120
1745
  }
1121
1746
  export declare enum VeLivePusherLogLevel {
1122
-
1747
+ /** {zh}
1748
+ * @brief 输出 VERBOSE、DEBUG、INFO、WARNING 和 ERROR 级别的日志。
1749
+ *
1750
+ */
1123
1751
  /** {en}
1124
1752
  * @brief Output VERBOSE, DEBUG, INFO, WARNING and ERROR.
1125
1753
  *
1126
1754
  */
1127
1755
  VeLiveLogLevelVerbose = 0,
1128
-
1756
+ /** {zh}
1757
+ * @brief 输出 DEBUG、INFO、WARNING 和 ERROR 级别的日志。
1758
+ *
1759
+ */
1129
1760
  /** {en}
1130
1761
  * @brief Output DEBUG, INFO, WARNING and ERROR.
1131
1762
  *
1132
1763
  */
1133
1764
  VeLiveLogLevelDebug = 1,
1134
-
1765
+ /** {zh}
1766
+ * @brief 输出 INFO、WARNING 和 ERROR 级别的日志。
1767
+ *
1768
+ */
1135
1769
  /** {en}
1136
1770
  * @brief Output INFO, WARNING and ERROR.
1137
1771
  *
1138
1772
  */
1139
1773
  VeLiveLogLevelInfo = 2,
1140
-
1774
+ /** {zh}
1775
+ * @brief 输出 WARNING 和 ERROR 级别的日志。
1776
+ *
1777
+ */
1141
1778
  /** {en}
1142
1779
  * @brief Output WARNING and ERROR.
1143
1780
  *
1144
1781
  */
1145
1782
  VeLiveLogLevelWarn = 3,
1146
-
1783
+ /** {zh}
1784
+ * @brief 输出 ERROR 级别的日志。
1785
+ *
1786
+ */
1147
1787
  /** {en}
1148
1788
  * @brief Output ERROR.
1149
1789
  *
1150
1790
  */
1151
1791
  VeLiveLogLevelError = 4,
1152
-
1792
+ /** {zh}
1793
+ * @brief 关闭日志。
1794
+ *
1795
+ */
1153
1796
  /** {en}
1154
1797
  * @brief Disable logging.
1155
1798
  *
@@ -1157,7 +1800,10 @@ export declare enum VeLivePusherLogLevel {
1157
1800
  VeLiveLogLevelNone = 5
1158
1801
  }
1159
1802
  export declare enum VeLiveAudioBitDepth {
1160
-
1803
+ /** {zh}
1804
+ * @brief 16bit 位深度。
1805
+ *
1806
+ */
1161
1807
  /** {en}
1162
1808
  * @brief 16bit.
1163
1809
  *
@@ -1165,20 +1811,32 @@ export declare enum VeLiveAudioBitDepth {
1165
1811
  VeLiveAudioBitDepth16 = 16
1166
1812
  }
1167
1813
  export declare class VeLiveMixAudioLayout {
1168
-
1814
+ /** {zh}
1815
+ * @brief 音频流 ID,唯一标识,用于区分不同的音频流。
1816
+ *
1817
+ */
1169
1818
  /** {en}
1170
1819
  * @brief The unique identifier for an audio stream.
1171
1820
  *
1172
1821
  */
1173
1822
  streamId: int;
1174
-
1823
+ /** {zh}
1824
+ * @detail api
1825
+ * @brief 混流音频的音量,范围为 [0.0,4.0]。当您将 [VeLiveAudioMixType](#VeLiveAudioMixType) 设置为 `VeLiveAudioMixPlayAndPush` 时,该变量同时控制混流音频在拉流端和本地的播放音量。
1826
+ *
1827
+ */
1175
1828
  /** {en}
1176
1829
  * @detail api
1177
1830
  * @brief The volume of the mixed audio stream. The value range is [0.0,4.0]. If you set [VeLiveAudioMixType](#VeLiveAudioMixType) to `VeLiveAudioMixPlayAndPush`, this variable takes effect on both the host and the audience sides.
1178
1831
  *
1179
1832
  */
1180
1833
  volume: float;
1181
-
1834
+ /** {zh}
1835
+ * @detail api
1836
+ * @brief 更新音频混流设置。
1837
+ * @param other 新的音频混流设置,详情请参见 [VeLiveMixAudioLayout](#VeLivePusherDef-VeLiveMixAudioLayout)。
1838
+ *
1839
+ */
1182
1840
  /** {en}
1183
1841
  * @detail api
1184
1842
  * @brief Updates audio mixing configurations.
@@ -1188,7 +1846,13 @@ export declare class VeLiveMixAudioLayout {
1188
1846
  update(other: VeLiveMixAudioLayout): void;
1189
1847
  }
1190
1848
  export declare class VeLivePusherConfiguration {
1191
-
1849
+ /** {zh}
1850
+ * @detail api
1851
+ * @brief 设置推流器推流失败后尝试重连的时间间隔。
1852
+ * @param interval 时间间隔,单位为 s,默认值为 5
1853
+ * @order 2
1854
+ *
1855
+ */
1192
1856
  /** {en}
1193
1857
  * @detail api
1194
1858
  * @brief Sets the time interval between each attempt to reconnect.
@@ -1197,7 +1861,14 @@ export declare class VeLivePusherConfiguration {
1197
1861
  *
1198
1862
  */
1199
1863
  setReconnectIntervalSeconds(interval: int): this;
1200
-
1864
+ /** {zh}
1865
+ * @detail api
1866
+ * @brief 获取推流器推流失败后尝试重连的时间间隔。
1867
+ * @order 3
1868
+ * @return <br>
1869
+ * 时间间隔,单位为 s。
1870
+ *
1871
+ */
1201
1872
  /** {en}
1202
1873
  * @detail api
1203
1874
  * @brief Gets the time interval between each attempt to reconnect.
@@ -1207,7 +1878,13 @@ export declare class VeLivePusherConfiguration {
1207
1878
  *
1208
1879
  */
1209
1880
  getReconnectIntervalSeconds(): int;
1210
-
1881
+ /** {zh}
1882
+ * @detail api
1883
+ * @brief 设置推流器推流失败后尝试重连的次数。
1884
+ * @param maxCount 重连次数,默认值为 3
1885
+ * @order 4
1886
+ *
1887
+ */
1211
1888
  /** {en}
1212
1889
  * @detail api
1213
1890
  * @brief Sets the number of attempts to reconnect after the initial attempt fails.
@@ -1216,7 +1893,14 @@ export declare class VeLivePusherConfiguration {
1216
1893
  *
1217
1894
  */
1218
1895
  setReconnectCount(maxCount: int): this;
1219
-
1896
+ /** {zh}
1897
+ * @detail api
1898
+ * @brief 获取推流器推流失败后尝试重连的次数。
1899
+ * @order 5
1900
+ * @return <br>
1901
+ * 重连次数。
1902
+ *
1903
+ */
1220
1904
  /** {en}
1221
1905
  * @detail api
1222
1906
  * @brief Gets the number of attempts to reconnect after the initial attempt fails.
@@ -1226,7 +1910,14 @@ export declare class VeLivePusherConfiguration {
1226
1910
  *
1227
1911
  */
1228
1912
  getReconnectCount(): int;
1229
-
1913
+ /** {zh}
1914
+ * @detail api
1915
+ * @brief 设置视频采集参数,用于调整和设置视频采集相关的参数。
1916
+ * @order 6
1917
+ * @param config 视频采集参数,详情请参见 [VeLiveVideoCaptureConfiguration](#VeLivePusherDef-VeLiveVideoCaptureConfiguration)。
1918
+ * @return 推流引擎初始化配置对象,详情请参见 [VeLivePusherConfiguration](#VeLivePusherConfiguration)。
1919
+ *
1920
+ */
1230
1921
  /** {en}
1231
1922
  * @detail api
1232
1923
  * @brief Sets the video capture configurations.
@@ -1237,7 +1928,13 @@ export declare class VeLivePusherConfiguration {
1237
1928
  *
1238
1929
  */
1239
1930
  setVideoCaptureConfig(config: VeLiveVideoCaptureConfiguration): this;
1240
-
1931
+ /** {zh}
1932
+ * @detail api
1933
+ * @brief 获取视频采集参数,用于调整和设置视频采集相关的参数。
1934
+ * @order 7
1935
+ * @return 视频采集参数配置对象,详情请参见 [VeLiveVideoCaptureConfiguration](#VeLivePusherDef-VeLiveVideoCaptureConfiguration)。
1936
+ *
1937
+ */
1241
1938
  /** {en}
1242
1939
  * @detail api
1243
1940
  * @brief Gets the video capture configurations.
@@ -1246,7 +1943,14 @@ export declare class VeLivePusherConfiguration {
1246
1943
  *
1247
1944
  */
1248
1945
  getVideoCaptureConfig(): VeLiveVideoCaptureConfiguration;
1249
-
1946
+ /** {zh}
1947
+ * @detail api
1948
+ * @brief 设置音频采集参数,用于调整和设置音频采集相关的参数。
1949
+ * @order 7
1950
+ * @param config 音频采集参数,详情请参见 [VeLiveAudioCaptureConfiguration](#VeLivePusherDef-VeLiveAudioCaptureConfiguration)。
1951
+ * @return 推流引擎初始化配置对象,详情请参见 [VeLiveAudioCaptureConfiguration](#VeLivePusherDef-VeLiveAudioCaptureConfiguration)。
1952
+ *
1953
+ */
1250
1954
  /** {en}
1251
1955
  * @detail api
1252
1956
  * @brief Sets the audio capture configurations.
@@ -1256,7 +1960,13 @@ export declare class VeLivePusherConfiguration {
1256
1960
  *
1257
1961
  */
1258
1962
  setAudioCaptureConfig(config: VeLiveAudioCaptureConfiguration): this;
1259
-
1963
+ /** {zh}
1964
+ * @detail api
1965
+ * @brief 获取音频采集参数,用于调整和设置音频采集相关的参数。
1966
+ * @order 8
1967
+ * @return 音频采集参数配置对象,详情请参见 [VeLiveAudioCaptureConfiguration](#VeLivePusherDef-VeLiveAudioCaptureConfiguration)。
1968
+ *
1969
+ */
1260
1970
  /** {en}
1261
1971
  * @detail api
1262
1972
  * @brief Gets the audio capture configurations.
@@ -1265,7 +1975,14 @@ export declare class VeLivePusherConfiguration {
1265
1975
  *
1266
1976
  */
1267
1977
  getAudioCaptureConfig(): VeLiveAudioCaptureConfiguration;
1268
-
1978
+ /** {zh}
1979
+ * @detail api
1980
+ * @brief 设置应用上下文。
1981
+ * @order 9
1982
+ * @param context 应用上下文。
1983
+ * @return 推流引擎初始化配置对象,详情请参见 [VeLivePusherConfiguration](#VeLivePusherConfiguration)。
1984
+ *
1985
+ */
1269
1986
  /** {en}
1270
1987
  * @detail api
1271
1988
  * @brief Sets the context of the application.
@@ -1275,7 +1992,14 @@ export declare class VeLivePusherConfiguration {
1275
1992
  *
1276
1993
  */
1277
1994
  setContext(context: Context): this;
1278
-
1995
+ /** {zh}
1996
+ * @detail api
1997
+ * @brief 获取应用上下文。
1998
+ * @order 10
1999
+ * @return <br>
2000
+ * 应用上下文。
2001
+ *
2002
+ */
1279
2003
  /** {en}
1280
2004
  * @detail api
1281
2005
  * @brief Gets the context of the application.
@@ -1285,7 +2009,15 @@ export declare class VeLivePusherConfiguration {
1285
2009
  *
1286
2010
  */
1287
2011
  getContext(): Context;
1288
-
2012
+ /** {zh}
2013
+ * @detail api
2014
+ * @brief 设置扩展参数,默认不需要设置。如果需要使用,您可通过提交工单联系[技术支持](https://console.volcengine.com/workorder/create?step=3&SubProductID=P00000076)。
2015
+ * @order 11
2016
+ * @param params 扩展参数。
2017
+ * @return
2018
+ * 推流引擎初始化配置对象,详情请参见 [VeLivePusherConfiguration](#VeLivePusherConfiguration)。
2019
+ *
2020
+ */
1289
2021
  /** {en}
1290
2022
  * @detail api
1291
2023
  * @brief Sets advanced parameters. You can leave this parameter empty. If you need to use it, please [create a ticket](https://console.byteplus.com/workorder/create?step=2&SubProductID=P00000980) to contact BytePlus technical support.
@@ -1295,7 +2027,14 @@ export declare class VeLivePusherConfiguration {
1295
2027
  *
1296
2028
  */
1297
2029
  setExtraParameters(params: String): this;
1298
-
2030
+ /** {zh}
2031
+ * @detail api
2032
+ * @brief 获取扩展参数。
2033
+ * @order 12
2034
+ * @return <br>
2035
+ * 扩展参数。
2036
+ *
2037
+ */
1299
2038
  /** {en}
1300
2039
  * @detail api
1301
2040
  * @brief Gets advanced parameters.
@@ -1305,7 +2044,13 @@ export declare class VeLivePusherConfiguration {
1305
2044
  *
1306
2045
  */
1307
2046
  getExtraParams(): LiveSdkSetting;
1308
-
2047
+ /** {zh}
2048
+ * @detail api
2049
+ * @brief 构造推流引擎。
2050
+ * @order 1
2051
+ * @return 推流引擎,详情请参见 [VeLivePusher](147517#VeLivePusher)。
2052
+ *
2053
+ */
1309
2054
  /** {en}
1310
2055
  * @detail api
1311
2056
  * @brief Creates the live pusher.
@@ -1316,13 +2061,19 @@ export declare class VeLivePusherConfiguration {
1316
2061
  build(): VeLivePusher;
1317
2062
  }
1318
2063
  export declare enum VeLiveOrientation {
1319
-
2064
+ /** {zh}
2065
+ * @brief 横屏模式。
2066
+ *
2067
+ */
1320
2068
  /** {en}
1321
2069
  * @brief The landscape mode.
1322
2070
  *
1323
2071
  */
1324
2072
  VeLiveOrientationLandscape = 0,
1325
-
2073
+ /** {zh}
2074
+ * @brief 竖屏模式。
2075
+ *
2076
+ */
1326
2077
  /** {en}
1327
2078
  * @brief The portrait mode.
1328
2079
  *
@@ -1330,19 +2081,28 @@ export declare enum VeLiveOrientation {
1330
2081
  VeLiveOrientationPortrait = 1
1331
2082
  }
1332
2083
  export declare enum VeLiveVideoMirrorType {
1333
-
2084
+ /** {zh}
2085
+ * @brief 对采集画面的镜像控制。开启时,预览和推流画面都会呈现为镜像状态。
2086
+ *
2087
+ */
1334
2088
  /** {en}
1335
2089
  * @brief Mirror the captured video. When turned on, both the preview and the pushed video are mirrored.
1336
2090
  *
1337
2091
  */
1338
2092
  VeLiveVideoMirrorCapture = 0,
1339
-
2093
+ /** {zh}
2094
+ * @brief 对预览画面的镜像控制。开启时,只有主播预览画面呈现镜像状态。
2095
+ *
2096
+ */
1340
2097
  /** {en}
1341
2098
  * @brief Mirror the preview. When turned on, only the preview is mirrored.
1342
2099
  *
1343
2100
  */
1344
2101
  VeLiveVideoMirrorPreview = 1,
1345
-
2102
+ /** {zh}
2103
+ * @brief 对编码前画面的镜像控制。开启时,主播推流画面呈现镜像状态。
2104
+ *
2105
+ */
1346
2106
  /** {en}
1347
2107
  * @brief Mirror the video before encoding. When turned on, only the pushed video is mirrored.
1348
2108
  *
@@ -1350,7 +2110,13 @@ export declare enum VeLiveVideoMirrorType {
1350
2110
  VeLiveVideoMirrorPushStream = 2
1351
2111
  }
1352
2112
  export declare class VeLiveFileRecorderConfiguration {
1353
-
2113
+ /** {zh}
2114
+ * @detail api
2115
+ * @brief 获取录制视频宽度。
2116
+ * @return <br>
2117
+ * 录制视频宽度。
2118
+ *
2119
+ */
1354
2120
  /** {en}
1355
2121
  * @detail api
1356
2122
  * @brief Gets the width of the recorded video.
@@ -1358,7 +2124,13 @@ export declare class VeLiveFileRecorderConfiguration {
1358
2124
  *
1359
2125
  */
1360
2126
  getWidth(): int;
1361
-
2127
+ /** {zh}
2128
+ * @detail api
2129
+ * @brief 设置录制视频宽度。
2130
+ * @param width 录制视频宽度,默认值为 360
2131
+ * @return 推流本地文件录制配置对象,详情请参见 [VeLiveFileRecorderConfiguration](#VeLivePusherDef-VeLiveFileRecorderConfiguration)。
2132
+ *
2133
+ */
1362
2134
  /** {en}
1363
2135
  * @detail api
1364
2136
  * @brief Sets the width of the recorded video.
@@ -1367,7 +2139,13 @@ export declare class VeLiveFileRecorderConfiguration {
1367
2139
  *
1368
2140
  */
1369
2141
  setWidth(width: int): this;
1370
-
2142
+ /** {zh}
2143
+ * @detail api
2144
+ * @brief 获取录制视频高度。
2145
+ * @return <br>
2146
+ * 录制视频高度。
2147
+ *
2148
+ */
1371
2149
  /** {en}
1372
2150
  * @detail api
1373
2151
  * @brief Gets the height of the recorded video.
@@ -1375,7 +2153,13 @@ export declare class VeLiveFileRecorderConfiguration {
1375
2153
  *
1376
2154
  */
1377
2155
  getHeight(): int;
1378
-
2156
+ /** {zh}
2157
+ * @detail api
2158
+ * @brief 设置录制视频高度。
2159
+ * @param height 录制视频宽度,默认值为 640。
2160
+ * @return 推流本地文件录制配置对象,详情请参见 [VeLiveFileRecorderConfiguration](#VeLivePusherDef-VeLiveFileRecorderConfiguration)。<br/>
2161
+ *
2162
+ */
1379
2163
  /** {en}
1380
2164
  * @detail api
1381
2165
  * @brief Sets the height of the recorded video.
@@ -1384,7 +2168,13 @@ export declare class VeLiveFileRecorderConfiguration {
1384
2168
  *
1385
2169
  */
1386
2170
  setHeight(height: int): this;
1387
-
2171
+ /** {zh}
2172
+ * @detail api
2173
+ * @brief 获取录制视频帧率。
2174
+ * @return <br>
2175
+ * 录制视频帧率。
2176
+ *
2177
+ */
1388
2178
  /** {en}
1389
2179
  * @detail api
1390
2180
  * @brief Gets the frame rate of the recorded video.
@@ -1392,7 +2182,13 @@ export declare class VeLiveFileRecorderConfiguration {
1392
2182
  *
1393
2183
  */
1394
2184
  getFps(): int;
1395
-
2185
+ /** {zh}
2186
+ * @detail api
2187
+ * @brief 设置录制视频帧率。
2188
+ * @param fps 录制视频帧率,默认值为 15。
2189
+ * @return 推流本地文件录制配置对象,详情请参见 [VeLiveFileRecorderConfiguration](#VeLivePusherDef-VeLiveFileRecorderConfiguration)。
2190
+ *
2191
+ */
1396
2192
  /** {en}
1397
2193
  * @detail api
1398
2194
  * @brief Sets the frame rate of the recorded video.
@@ -1401,7 +2197,13 @@ export declare class VeLiveFileRecorderConfiguration {
1401
2197
  *
1402
2198
  */
1403
2199
  setFps(fps: int): this;
1404
-
2200
+ /** {zh}
2201
+ * @detail api
2202
+ * @brief 获取录制视频码率。
2203
+ * @return <br>
2204
+ * 录制视频码率。
2205
+ *
2206
+ */
1405
2207
  /** {en}
1406
2208
  * @detail api
1407
2209
  * @brief Gets the bitrate of the recorded video.
@@ -1409,7 +2211,14 @@ export declare class VeLiveFileRecorderConfiguration {
1409
2211
  *
1410
2212
  */
1411
2213
  getBitrate(): int;
1412
-
2214
+ /** {zh}
2215
+ * @detail api
2216
+ * @brief 设置录制视频码率。
2217
+ * @param bitrate 录制视频码率,单位为 kbps,默认值为 2000。
2218
+ * @return
2219
+ * 推流本地文件录制配置对象,详情请参见 [VeLiveFileRecorderConfiguration](#VeLivePusherDef-VeLiveFileRecorderConfiguration)。
2220
+ *
2221
+ */
1413
2222
  /** {en}
1414
2223
  * @detail api
1415
2224
  * @brief Sets the bitrate of the recorded video.
@@ -1420,55 +2229,84 @@ export declare class VeLiveFileRecorderConfiguration {
1420
2229
  setBitrate(bitrate: int): this;
1421
2230
  }
1422
2231
  export declare class VeLiveMixVideoLayout {
1423
-
2232
+ /** {zh}
2233
+ * @brief 视频流 ID,唯一标识,用于区分不同的视频流。
2234
+ *
2235
+ */
1424
2236
  /** {en}
1425
2237
  * @brief The unique identifier for a video stream.
1426
2238
  *
1427
2239
  */
1428
2240
  streamId: int;
1429
-
2241
+ /** {zh}
2242
+ * @brief 视频流对应区域左上角的横坐标,该坐标是相对整体画面的归一化比例,取值的范围为 [0.0,1.0]。
2243
+ *
2244
+ */
1430
2245
  /** {en}
1431
2246
  * @brief The horizontal offset, which represents the ratio of the distance between the left edge of the video and the left edge of the screen to the width of the screen. The value range is [0.0,1.0], where `0.0` indicates the left edge and `1.0` indicates the right edge.
1432
2247
  *
1433
2248
  */
1434
2249
  x: float;
1435
-
2250
+ /** {zh}
2251
+ * @brief 视频流对应区域左上角的纵坐标,该坐标是相对整体画面的归一化比例,取值的范围为 [0.0,1.0]。
2252
+ *
2253
+ */
1436
2254
  /** {en}
1437
2255
  * @brief The vertical offset, which represents the ratio of the distance between the top edge of the video and the top edge of the screen to the height of the screen. The value range is [0.0,1.0], where `0.0` indicates the top edge and `1.0` indicates the bottom edge.
1438
2256
  *
1439
2257
  */
1440
2258
  y: float;
1441
-
2259
+ /** {zh}
2260
+ * @brief 视频流对应区域宽度,该宽度是相对整体画面的归一化比例,取值的范围为 [0.0,1.0]。
2261
+ *
2262
+ */
1442
2263
  /** {en}
1443
2264
  * @brief The ratio of the video width to the screen width. The value range is [0.0,1.0], where `1.0` indicates that the video occupies the entire screen width.
1444
2265
  *
1445
2266
  */
1446
2267
  width: float;
1447
-
2268
+ /** {zh}
2269
+ * @brief 视频流对应区域高度,该高度是相对整体画面的归一化比例,取值的范围为 [0.0,1.0]。
2270
+ *
2271
+ */
1448
2272
  /** {en}
1449
2273
  * @brief The ratio of the video height to the screen height. The value range is [0.0,1.0], where `1.0` indicates that the video occupies the entire screen height.
1450
2274
  *
1451
2275
  */
1452
2276
  height: float;
1453
-
2277
+ /** {zh}
2278
+ * @brief 视频流在混流中的透明度,取值范围为 [0.0,1.0],取值 0.0 表示全透明,取值 1.0 表示不透明。
2279
+ *
2280
+ */
1454
2281
  /** {en}
1455
2282
  * @brief The video transparency. The value range is [0.0, 1.0], where `0.0` indicates full transparency and `1.0` indicates full opacity.
1456
2283
  *
1457
2284
  */
1458
2285
  alpha: float;
1459
-
2286
+ /** {zh}
2287
+ * @brief 视频流在混流中的层级。取值范围为 [0,100],取值 0 表示最底层,取值越大,层级越高。
2288
+ *
2289
+ */
1460
2290
  /** {en}
1461
2291
  * @brief The level of video within the final mixed video. The value range is [0,100], where `0` represents the bottom layer. The higher the value, the higher the level of the video in the final output.
1462
2292
  *
1463
2293
  */
1464
2294
  zOrder: int;
1465
-
2295
+ /** {zh}
2296
+ * @brief 视频流的渲染模式。详情请参见 [VeLivePusherRenderMode](#VeLivePusherRenderMode)。
2297
+ *
2298
+ */
1466
2299
  /** {en}
1467
2300
  * @brief The render mode of the video. See [VeLivePusherRenderMode](#VeLivePusherRenderMode) for details.
1468
2301
  *
1469
2302
  */
1470
2303
  renderMode: VeLivePusherRenderMode;
1471
-
2304
+ /** {zh}
2305
+ * @brief 是否保留视频流原 Alpha 通道值,默认为保留,当 [alpha](#VeLiveMixVideoLayout-alpha) 取值在 [0.0, 1.0] 之间时,则忽略该配置。
2306
+ * - YES:保留;
2307
+ * - NO:不保留。
2308
+ *
2309
+ */
1472
2310
  /** {en}
1473
2311
  * @brief Whether to retain the original Alpha channel value of the video stream. The default is retain. When the value of [alpha](#VeLiveMixVideoLayout-alpha) is within the range of [0.0, 1.0], this configuration is ignored.<br/>
1474
2312
  *
@@ -1477,7 +2315,12 @@ export declare class VeLiveMixVideoLayout {
1477
2315
  *
1478
2316
  */
1479
2317
  enableAlpha: boolean;
1480
-
2318
+ /** {zh}
2319
+ * @detail api
2320
+ * @brief 更新视频混流设置。
2321
+ * @param other 新的视频混流设置,详情请参见 [VeLiveMixVideoLayout](#VeLivePusherDef-VeLiveMixVideoLayout)。
2322
+ *
2323
+ */
1481
2324
  /** {en}
1482
2325
  * @detail api
1483
2326
  * @brief Updates video mixing configurations.
@@ -1487,7 +2330,13 @@ export declare class VeLiveMixVideoLayout {
1487
2330
  update(other: VeLiveMixVideoLayout): void;
1488
2331
  }
1489
2332
  export declare class VeLiveVideoEffectLicenseConfiguration {
1490
-
2333
+ /** {zh}
2334
+ * @detail api
2335
+ * @brief 初始化配置为本地验证模式。
2336
+ * @param path 视频特效许可证的本地缓存路径。可通过 [getPath](#VeLiveVideoEffectLicenseConfiguration-getpath) 获取。
2337
+ * @return 返回 VeLiveVideoEffectLicenseConfiguration 类的实例,该实例使用指定的本地路径进行许可证验证。
2338
+ *
2339
+ */
1491
2340
  /** {en}
1492
2341
  * @detail api
1493
2342
  * @brief Initializes the license configurations in local authentication mode.
@@ -1496,7 +2345,15 @@ export declare class VeLiveVideoEffectLicenseConfiguration {
1496
2345
  *
1497
2346
  */
1498
2347
  static create(path: String): VeLiveVideoEffectLicenseConfiguration;
1499
-
2348
+ /** {zh}
2349
+ * @detail api
2350
+ * @brief 初始化配置为在线验证模式。
2351
+ * @return <br>返回 VeLiveVideoEffectLicenseConfiguration 类的实例,该实例使用指定的 key、secret 和 url 进行在线许可证验证。
2352
+ * @param key 视频特效许可证的在线认证 key。可通过 [getKey](#VeLiveVideoEffectLicenseConfiguration-getkey) 获取。
2353
+ * @param secret 视频特效许可证的在线认证 secret。可通过 [getSecret](#VeLiveVideoEffectLicenseConfiguration-getsecret) 获取。
2354
+ * @param url 视频特效许可证的在线认证地址,如果传入 `null`,可通过 [getUrl](147521#VeLiveVideoEffectLicenseConfiguration-geturl) 获取在线认证地址。
2355
+ *
2356
+ */
1500
2357
  /** {en}
1501
2358
  * @detail api
1502
2359
  * @brief Initializes the license configurations in local authentication mode.
@@ -1505,7 +2362,12 @@ export declare class VeLiveVideoEffectLicenseConfiguration {
1505
2362
  *
1506
2363
  */
1507
2364
  static create_key$secret$url(key: String, secret: String, url: String): VeLiveVideoEffectLicenseConfiguration;
1508
-
2365
+ /** {zh}
2366
+ * @detail api
2367
+ * @brief 获取视频特效许可证类型。
2368
+ * @return 视频特效许可证类型,许可证类型请参见 [VeLiveVideoEffectLicenseType](147521#VeLiveVideoEffectLicenseType)。
2369
+ *
2370
+ */
1509
2371
  /** {en}
1510
2372
  * @detail api
1511
2373
  * @brief Gets the special effects license type.
@@ -1513,7 +2375,12 @@ export declare class VeLiveVideoEffectLicenseConfiguration {
1513
2375
  *
1514
2376
  */
1515
2377
  getType(): VeLiveVideoEffectLicenseType;
1516
-
2378
+ /** {zh}
2379
+ * @detail api
2380
+ * @brief 获取视频特效许可证的本地路径。当 [VeLiveVideoEffectLicenseType](#VeLiveVideoEffectLicenseType) 为 `VeLiveVideoEffectLicenseTypeOffLine` 时,返回许可证文件的本地路径。
2381
+ * @return 视频特效许可证的本地路径。
2382
+ *
2383
+ */
1517
2384
  /** {en}
1518
2385
  * @detail api
1519
2386
  * @brief Gets the local path to the video effects license. When [VeLiveVideoEffectLicenseType](#VeLiveVideoEffectLicenseType) is `VeLiveVideoEffectLicenseTypeOffLine`, return the local path of the license file.
@@ -1521,7 +2388,12 @@ export declare class VeLiveVideoEffectLicenseConfiguration {
1521
2388
  *
1522
2389
  */
1523
2390
  getPath(): String;
1524
-
2391
+ /** {zh}
2392
+ * @detail api
2393
+ * @brief 获取视频特效许可证的在线认证 key。当 [VeLiveVideoEffectLicenseType](#VeLiveVideoEffectLicenseType) 为 `VeLiveVideoEffectLicenseTypeOnLine` 时,返回在线认证的 key。
2394
+ * @return 视频特效许可证的在线认证 key。
2395
+ *
2396
+ */
1525
2397
  /** {en}
1526
2398
  * @detail api
1527
2399
  * @brief Gets the online authentication key for the video effects licenses, when [VeLiveVideoEffectLicenseType](#VeLiveVideoEffectLicenseType) is `VeLiveVideoEffectLicenseTypeOnLine`.
@@ -1529,7 +2401,12 @@ export declare class VeLiveVideoEffectLicenseConfiguration {
1529
2401
  *
1530
2402
  */
1531
2403
  getKey(): String;
1532
-
2404
+ /** {zh}
2405
+ * @detail api
2406
+ * @brief 获取视频特效许可证的在线认证 secret。当 [VeLiveVideoEffectLicenseType](#VeLiveVideoEffectLicenseType) 为 `VeLiveVideoEffectLicenseTypeOnLine` 时,返回在线认证的 secret。
2407
+ * @return 视频特效许可证的在线认证 secret。
2408
+ *
2409
+ */
1533
2410
  /** {en}
1534
2411
  * @detail api
1535
2412
  * @brief Gets the online authentication secret for the video effects license, when [VeLiveVideoEffectLicenseType](#VeLiveVideoEffectLicenseType) is `VeLiveVideoEffectLicenseTypeOnLine`.
@@ -1537,7 +2414,12 @@ export declare class VeLiveVideoEffectLicenseConfiguration {
1537
2414
  *
1538
2415
  */
1539
2416
  getSecret(): String;
1540
-
2417
+ /** {zh}
2418
+ * @detail api
2419
+ * @brief 获取视频特效许可证的在线认证地址。当 [VeLiveVideoEffectLicenseType](#VeLiveVideoEffectLicenseType) 为 `VeLiveVideoEffectLicenseTypeOnLine` 时,返回在线认证地址。
2420
+ * @return 视频特效许可证的在线认证地址。
2421
+ *
2422
+ */
1541
2423
  /** {en}
1542
2424
  * @detail api
1543
2425
  * @brief Gets the online authentication address for the video effects license, when [VeLiveVideoEffectLicenseType](#VeLiveVideoEffectLicenseType) is `VeLiveVideoEffectLicenseTypeOnLine`.
@@ -1547,13 +2429,19 @@ export declare class VeLiveVideoEffectLicenseConfiguration {
1547
2429
  getUrl(): String;
1548
2430
  }
1549
2431
  export declare enum VeLiveAudioFrameSource {
1550
-
2432
+ /** {zh}
2433
+ * @brief 采集到的原始音频帧。这是从设备的麦克风或其他音频输入源获取的音频帧。
2434
+ *
2435
+ */
1551
2436
  /** {en}
1552
2437
  * @brief The original audio frame captured by the microphone or other audio sources.
1553
2438
  *
1554
2439
  */
1555
2440
  VeLiveAudioFrameSourceCapture = 1,
1556
-
2441
+ /** {zh}
2442
+ * @brief 编码前的音频帧。这是通过各种处理(例如噪音消除、回声消除等)后,准备进行编码的音频帧。
2443
+ *
2444
+ */
1557
2445
  /** {en}
1558
2446
  * @brief The audio frame to be encoded after undergoing various processes, such as noise cancellation and echo cancellation.
1559
2447
  *
@@ -1561,7 +2449,13 @@ export declare enum VeLiveAudioFrameSource {
1561
2449
  VeLiveAudioFrameSourcePreEncode = "1 << 1"
1562
2450
  }
1563
2451
  export declare class VeLiveAudioEncoderConfiguration {
1564
-
2452
+ /** {zh}
2453
+ * @detail api
2454
+ * @brief 获取推流音频编码码率。
2455
+ * @return <br>
2456
+ * 推流音频编码码率。
2457
+ *
2458
+ */
1565
2459
  /** {en}
1566
2460
  * @detail api
1567
2461
  * @brief Gets the audio encoding bitrate.
@@ -1569,7 +2463,13 @@ export declare class VeLiveAudioEncoderConfiguration {
1569
2463
  *
1570
2464
  */
1571
2465
  getBitrate(): int;
1572
-
2466
+ /** {zh}
2467
+ * @detail api
2468
+ * @brief 设置推流音频编码码率。
2469
+ * @param bitrate 推流音频编码码率,单位为 kbps,默认值为 64。
2470
+ * @return 推流音频编码参数配置对象,详情请参见 [VeLiveAudioEncoderConfiguration](#VeLivePusherDef-VeLiveAudioEncoderConfiguration)。
2471
+ *
2472
+ */
1573
2473
  /** {en}
1574
2474
  * @detail api
1575
2475
  * @brief Sets the audio encoding bitrate.
@@ -1578,7 +2478,12 @@ export declare class VeLiveAudioEncoderConfiguration {
1578
2478
  *
1579
2479
  */
1580
2480
  setBitrate(bitrate: int): this;
1581
-
2481
+ /** {zh}
2482
+ * @detail api
2483
+ * @brief 获取推流音频采样率。
2484
+ * @return 推流音频采样率。详情请参见 [VeLiveAudioSampleRate](#VeLiveAudioSampleRate)。
2485
+ *
2486
+ */
1582
2487
  /** {en}
1583
2488
  * @detail api
1584
2489
  * @brief Gets the encoding sample rate.
@@ -1586,7 +2491,13 @@ export declare class VeLiveAudioEncoderConfiguration {
1586
2491
  *
1587
2492
  */
1588
2493
  getSampleRate(): VeLiveAudioSampleRate;
1589
-
2494
+ /** {zh}
2495
+ * @detail api
2496
+ * @brief 设置推流音频采样率。
2497
+ * @param sampleRate 推流音频采样率,默认值为 VeLiveAudioSampleRate44100,详情请参见 [VeLiveAudioSampleRate](#VeLiveAudioSampleRate)。
2498
+ * @return 推流音频编码参数配置对象,详情请参见 [VeLiveAudioEncoderConfiguration](#VeLivePusherDef-VeLiveAudioEncoderConfiguration)。
2499
+ *
2500
+ */
1590
2501
  /** {en}
1591
2502
  * @detail api
1592
2503
  * @brief Sets the encoding sample rate.
@@ -1595,7 +2506,12 @@ export declare class VeLiveAudioEncoderConfiguration {
1595
2506
  *
1596
2507
  */
1597
2508
  setSampleRate(sampleRate: VeLiveAudioSampleRate): this;
1598
-
2509
+ /** {zh}
2510
+ * @detail api
2511
+ * @brief 获取推流音频声道。
2512
+ * @return 推流音频声道。详情请参见 [VeLiveAudioChannel](#VeLiveAudioChannel)。
2513
+ *
2514
+ */
1599
2515
  /** {en}
1600
2516
  * @detail api
1601
2517
  * @brief Gets the number of audio channels for streaming.
@@ -1603,7 +2519,13 @@ export declare class VeLiveAudioEncoderConfiguration {
1603
2519
  *
1604
2520
  */
1605
2521
  getChannel(): VeLiveAudioChannel;
1606
-
2522
+ /** {zh}
2523
+ * @detail api
2524
+ * @brief 设置推流音频声道。
2525
+ * @param channel 推流音频声道,默认值为 VeLiveAudioChannelStereo,详情请参见 [VeLiveAudioChannel](#VeLiveAudioChannel)。
2526
+ * @return 推流音频编码参数配置对象,详情请参见 [VeLiveAudioEncoderConfiguration](#VeLivePusherDef-VeLiveAudioEncoderConfiguration)。
2527
+ *
2528
+ */
1607
2529
  /** {en}
1608
2530
  * @detail api
1609
2531
  * @brief Sets the number of audio channels for streaming.
@@ -1612,7 +2534,12 @@ export declare class VeLiveAudioEncoderConfiguration {
1612
2534
  *
1613
2535
  */
1614
2536
  setChannel(channel: VeLiveAudioChannel): this;
1615
-
2537
+ /** {zh}
2538
+ * @detail api
2539
+ * @brief 获取推流音频编码类型。
2540
+ * @return 推流音频编码类型。详情请参见 [VeLiveAudioProfile](#VeLiveAudioProfile)。
2541
+ *
2542
+ */
1616
2543
  /** {en}
1617
2544
  * @detail api
1618
2545
  * @brief Gets the audio encoding format.
@@ -1620,7 +2547,13 @@ export declare class VeLiveAudioEncoderConfiguration {
1620
2547
  *
1621
2548
  */
1622
2549
  getProfile(): VeLiveAudioProfile;
1623
-
2550
+ /** {zh}
2551
+ * @detail api
2552
+ * @brief 设置推流音频编码类型。
2553
+ * @param profile 推流音频编码类型,默认值为 VeLiveAudioAACProfileLC,详情请参见 [VeLiveAudioProfile](#VeLiveAudioProfile)。
2554
+ * @return 推流音频编码参数配置对象,详情请参见 [VeLiveAudioEncoderConfiguration](#VeLivePusherDef-VeLiveAudioEncoderConfiguration)。
2555
+ *
2556
+ */
1624
2557
  /** {en}
1625
2558
  * @detail api
1626
2559
  * @brief Sets the audio encoding format.
@@ -1631,13 +2564,19 @@ export declare class VeLiveAudioEncoderConfiguration {
1631
2564
  setProfile(profile: VeLiveAudioProfile): this;
1632
2565
  }
1633
2566
  export declare enum VeLiveAudioMixType {
1634
-
2567
+ /** {zh}
2568
+ * @brief 拉流端可以听到混音效果,本地无法听到。
2569
+ *
2570
+ */
1635
2571
  /** {en}
1636
2572
  * @brief The audience can hear the mixed audio, but the host cannot.
1637
2573
  *
1638
2574
  */
1639
2575
  VeLiveAudioMixPush = 0,
1640
-
2576
+ /** {zh}
2577
+ * @brief 拉流端和本地都可以听到混音效果。
2578
+ *
2579
+ */
1641
2580
  /** {en}
1642
2581
  * @brief Both the host and audience can hear the mixed audio.
1643
2582
  *
@@ -1645,31 +2584,46 @@ export declare enum VeLiveAudioMixType {
1645
2584
  VeLiveAudioMixPlayAndPush = 1
1646
2585
  }
1647
2586
  export declare enum VeLiveAudioCaptureType {
1648
-
2587
+ /** {zh}
2588
+ * @brief 使用默认麦克风设备进行音频采集。
2589
+ *
2590
+ */
1649
2591
  /** {en}
1650
2592
  * @brief Capture the audio with the default microphone.
1651
2593
  *
1652
2594
  */
1653
2595
  VeLiveAudioCaptureMicrophone = 0,
1654
-
2596
+ /** {zh}
2597
+ * @brief 使用语音通话模式进行音频采集,此模式下会启动硬件的 3A 功能,即自动增益控制、自动频率控制和自动噪声抑制。
2598
+ *
2599
+ */
1655
2600
  /** {en}
1656
2601
  * @brief Capture the audio in voice call mode, which will activate the 3A features of the hardware, including automatic gain control, automatic frequency control, and automatic noise suppression.
1657
2602
  *
1658
2603
  */
1659
2604
  VeLiveAudioCaptureVoiceCommunication = 1,
1660
-
2605
+ /** {zh}
2606
+ * @brief 使用录屏直播无障碍音频模式进行音频采集。
2607
+ *
2608
+ */
1661
2609
  /** {en}
1662
2610
  * @brief Capture the audio in screen recording.
1663
2611
  *
1664
2612
  */
1665
2613
  VeLiveAudioCaptureVoiceRecognition = 2,
1666
-
2614
+ /** {zh}
2615
+ * @brief 使用外部设备或源进行音频采集。
2616
+ *
2617
+ */
1667
2618
  /** {en}
1668
2619
  * @brief Capture the audio with an external device or source.
1669
2620
  *
1670
2621
  */
1671
2622
  VeLiveAudioCaptureExternal = 3,
1672
-
2623
+ /** {zh}
2624
+ * @brief 使用静音帧作为音频源。
2625
+ *
2626
+ */
1673
2627
  /** {en}
1674
2628
  * @brief Use muted frames as the audio source.
1675
2629
  *