@byteplus/react-native-live-push 1.5.1-rc.2 → 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 (53) hide show
  1. package/ios/VeLiveMixerView.m +5 -15
  2. package/lib/commonjs/typescript/codegen/android/api.d.ts +869 -93
  3. package/lib/commonjs/typescript/codegen/android/callback.d.ts +243 -31
  4. package/lib/commonjs/typescript/codegen/android/errorcode.d.ts +60 -15
  5. package/lib/commonjs/typescript/codegen/android/keytype.d.ts +1173 -219
  6. package/lib/commonjs/typescript/codegen/ios/api.d.ts +899 -102
  7. package/lib/commonjs/typescript/codegen/ios/callback.d.ts +162 -28
  8. package/lib/commonjs/typescript/codegen/ios/errorcode.d.ts +100 -25
  9. package/lib/commonjs/typescript/codegen/ios/keytype.d.ts +692 -180
  10. package/lib/commonjs/typescript/codegen/pack/api.d.ts +1180 -133
  11. package/lib/commonjs/typescript/codegen/pack/callback.d.ts +243 -35
  12. package/lib/commonjs/typescript/codegen/pack/errorcode.d.ts +69 -16
  13. package/lib/commonjs/typescript/codegen/pack/keytype.d.ts +1459 -270
  14. package/lib/commonjs/typescript/core/api.d.ts +8 -1
  15. package/lib/commonjs/typescript/core/effect.d.ts +5 -1
  16. package/lib/commonjs/typescript/core/logger.d.ts +1 -0
  17. package/lib/commonjs/typescript/platforms/android/AppLogWrapper.d.ts +8 -0
  18. package/lib/commonjs/typescript/platforms/ios/RangersAppLog.d.ts +4 -0
  19. package/lib/module/typescript/codegen/android/api.d.ts +869 -93
  20. package/lib/module/typescript/codegen/android/callback.d.ts +243 -31
  21. package/lib/module/typescript/codegen/android/errorcode.d.ts +60 -15
  22. package/lib/module/typescript/codegen/android/keytype.d.ts +1173 -219
  23. package/lib/module/typescript/codegen/ios/api.d.ts +899 -102
  24. package/lib/module/typescript/codegen/ios/callback.d.ts +162 -28
  25. package/lib/module/typescript/codegen/ios/errorcode.d.ts +100 -25
  26. package/lib/module/typescript/codegen/ios/keytype.d.ts +692 -180
  27. package/lib/module/typescript/codegen/pack/api.d.ts +1180 -133
  28. package/lib/module/typescript/codegen/pack/callback.d.ts +243 -35
  29. package/lib/module/typescript/codegen/pack/errorcode.d.ts +69 -16
  30. package/lib/module/typescript/codegen/pack/keytype.d.ts +1459 -270
  31. package/lib/module/typescript/core/api.d.ts +8 -1
  32. package/lib/module/typescript/core/effect.d.ts +5 -1
  33. package/lib/module/typescript/core/logger.d.ts +1 -0
  34. package/lib/module/typescript/platforms/android/AppLogWrapper.d.ts +8 -0
  35. package/lib/module/typescript/platforms/ios/RangersAppLog.d.ts +4 -0
  36. package/lib/typescript/codegen/android/api.d.ts +869 -93
  37. package/lib/typescript/codegen/android/callback.d.ts +243 -31
  38. package/lib/typescript/codegen/android/errorcode.d.ts +60 -15
  39. package/lib/typescript/codegen/android/keytype.d.ts +1173 -219
  40. package/lib/typescript/codegen/ios/api.d.ts +899 -102
  41. package/lib/typescript/codegen/ios/callback.d.ts +162 -28
  42. package/lib/typescript/codegen/ios/errorcode.d.ts +100 -25
  43. package/lib/typescript/codegen/ios/keytype.d.ts +692 -180
  44. package/lib/typescript/codegen/pack/api.d.ts +1180 -133
  45. package/lib/typescript/codegen/pack/callback.d.ts +243 -35
  46. package/lib/typescript/codegen/pack/errorcode.d.ts +69 -16
  47. package/lib/typescript/codegen/pack/keytype.d.ts +1459 -270
  48. package/lib/typescript/core/api.d.ts +8 -1
  49. package/lib/typescript/core/effect.d.ts +5 -1
  50. package/lib/typescript/core/logger.d.ts +1 -0
  51. package/lib/typescript/platforms/android/AppLogWrapper.d.ts +8 -0
  52. package/lib/typescript/platforms/ios/RangersAppLog.d.ts +4 -0
  53. package/package.json +1 -1
@@ -3,9 +3,20 @@ import * as $p_i from '../ios/index';
3
3
  import { VeLivePusherObserver, VeLivePusherStatisticsObserver, VeLiveFileRecordingListener, VeLiveVideoFrameFilter, VeLiveAudioFrameFilter, VeLiveVideoFrameListener, VeLiveAudioFrameListener, VeLiveSnapshotListener, VeLiveMediaPlayerListener, VeLiveMediaPlayerFrameListener } from './callback';
4
4
  import { VeLivePusherRenderMode, VeLiveVideoMirrorType, VeLiveVideoCaptureType, VeLiveAudioCaptureType, VeLiveOrientation, VeLivePusherLogLevel, VeLiveVideoEncoderConfiguration, VeLiveAudioEncoderConfiguration, VeLiveFileRecorderConfiguration, VeLiveVideoFrame, VeLiveAudioFrame, VeLiveVideoCaptureConfiguration, VeLiveVideoEffectLicenseConfiguration } from './keytype';
5
5
  import { View, Bitmap } from './types';
6
-
6
+ /** {zh}
7
+ * @detail api
8
+ * @brief 直播推流器。
9
+ */
7
10
  export declare class VeLivePusher {
8
-
11
+ /** {zh}
12
+ * @platform android
13
+ * @detail api
14
+ * @hidden
15
+ * @brief 获取当前 SDK 版本号。
16
+ * @return <br>
17
+ * 当前 SDK 版本号。
18
+ *
19
+ */
9
20
  /** {en}
10
21
  * @platform android
11
22
  * @detail api
@@ -16,7 +27,13 @@ export declare class VeLivePusher {
16
27
  *
17
28
  */
18
29
  static android_getVersion(): string;
19
-
30
+ /** {zh}
31
+ * @detail api
32
+ * @brief 设置输出到控制台的日志等级。
33
+ * @order 49
34
+ * @param logLevel 输出的日志级别。级别详情请参见 [VeLivePusherLogLevel](147521#VeLivePusherLogLevel)。
35
+ *
36
+ */
20
37
  /** {en}
21
38
  * @detail api
22
39
  * @brief Sets the level of the output log.
@@ -25,7 +42,14 @@ export declare class VeLivePusher {
25
42
  *
26
43
  */
27
44
  static setLogLevel(logLevel: VeLivePusherLogLevel): void;
28
-
45
+ /** {zh}
46
+ * @platform android
47
+ * @detail api
48
+ * @brief 设置 OpenGL 的上下文。
49
+ * @order 50
50
+ * @param context OpenGL 上下文。
51
+ *
52
+ */
29
53
  /** {en}
30
54
  * @platform android
31
55
  * @detail api
@@ -38,7 +62,12 @@ export declare class VeLivePusher {
38
62
  protected _instance: any;
39
63
  protected __init(...args: any[]): void;
40
64
  protected __new_instance(...args: any[]): any;
41
-
65
+ /** {zh}
66
+ * @detail api
67
+ * @brief 停止采集和推流,并销毁推流器。通常在调用 [stopPush](#VeLivePusher-stoppush) 结束推流后调用此方法进行清理。
68
+ * @order 4
69
+ *
70
+ */
42
71
  /** {en}
43
72
  * @detail api
44
73
  * @brief Stops capturing and pushing streams and destroys the pusher. Call this method after [stopPush](#VeLivePusher-stoppush) is called.
@@ -46,7 +75,16 @@ export declare class VeLivePusher {
46
75
  *
47
76
  */
48
77
  destroy(): void;
49
-
78
+ /** {zh}
79
+ * @detail api
80
+ * @brief 设置推流器回调,通过设置回调,监听推流器的推流错误、状态、网络质量、设备、首帧等回调事件。
81
+ * @notes <br>
82
+ * - 需要在创建推流引擎后,调用本方法;
83
+ * - 重复调用本方法,仅最后一次调用生效。
84
+ * @order 2
85
+ * @param observer 推流器回调对象,详细信息请参见 [VeLivePusherObserver](147519#VeLivePusherObserver)。
86
+ *
87
+ */
50
88
  /** {en}
51
89
  * @detail api
52
90
  * @brief Sets an observer to listen for live pusher events, including errors, statuses, network quality, device information, and first frame rendering.
@@ -58,7 +96,17 @@ export declare class VeLivePusher {
58
96
  *
59
97
  */
60
98
  setObserver(observer: VeLivePusherObserver): void;
61
-
99
+ /** {zh}
100
+ * @detail api
101
+ * @brief 设置推流器周期性回调,用于定期获取推流状态信息。
102
+ * @notes <br>
103
+ * - 需要在创建推流引擎后,调用本方法;
104
+ * - 重复调用本方法,仅最后一次调用生效。
105
+ * @order 3
106
+ * @param observer 推流器周期性回调对象,详细信息请参见 [VeLivePusherStatisticsObserver](147519#VeLivePusherDef-VeLivePusherStatisticsObserver)。
107
+ * @param interval 周期性回调的时间间隔,单位为 s,默认值为 5。
108
+ *
109
+ */
62
110
  /** {en}
63
111
  * @detail api
64
112
  * @brief Sets an observer to periodically report push-stream statistics.
@@ -71,7 +119,13 @@ export declare class VeLivePusher {
71
119
  *
72
120
  */
73
121
  setStatisticsObserver(observer: VeLivePusherStatisticsObserver, interval: number): void;
74
-
122
+ /** {zh}
123
+ * @detail api
124
+ * @brief 设置本地摄像头预览视图。摄像头采集到的画面,经过美颜、脸形调整、滤镜等多种效果叠加之后,最终会显示到传入的 View 上。
125
+ * @param view 摄像头预览视图
126
+ * @order 5
127
+ *
128
+ */
75
129
  /** {en}
76
130
  * @detail api
77
131
  * @brief Sets the preview for the local camera. If beauty AR is applied to the captured video or if it undergoes any other processing, the preview will display the processed video.
@@ -80,7 +134,13 @@ export declare class VeLivePusher {
80
134
  *
81
135
  */
82
136
  setRenderView(view: View): Promise<void>;
83
-
137
+ /** {zh}
138
+ * @detail api
139
+ * @brief 设置本地预览画面的填充模式。
140
+ * @param mode 填充模式。
141
+ * @order 6
142
+ *
143
+ */
84
144
  /** {en}
85
145
  * @detail api
86
146
  * @brief Sets fill mode for the local camera preview.
@@ -89,7 +149,18 @@ export declare class VeLivePusher {
89
149
  *
90
150
  */
91
151
  setRenderFillMode(mode: VeLivePusherRenderMode): void;
92
-
152
+ /** {zh}
153
+ * @detail api
154
+ * @brief 开启/关闭镜像。
155
+ * @notes <br>
156
+ * 用于配置视频镜像效果,影响采集、预览和推流画面。
157
+ * @order 7
158
+ * @param type 镜像类型,详细信息请参见 [VeLiveVideoMirrorType](147521#VeLiveVideoMirrorType)。
159
+ * @param mirror 是否开启镜像。<br>
160
+ * - true:开启;
161
+ * - false:关闭。
162
+ *
163
+ */
93
164
  /** {en}
94
165
  * @detail api
95
166
  * @brief Enables or disables mirroring for the local preview and the streamed video.
@@ -101,7 +172,14 @@ export declare class VeLivePusher {
101
172
  *
102
173
  */
103
174
  setVideoMirror(type: VeLiveVideoMirrorType, mirror: boolean): void;
104
-
175
+ /** {zh}
176
+ * @detail api
177
+ * @brief 开始视频采集。
178
+ * @notes <br>调用该接口后,可以通过调用接口 [stopVideoCapture](#VeLivePusher-stopvideocapture) 停止视频采集。
179
+ * @order 8
180
+ * @param type 视频采集类型,详细信息请参见 VeLiveVideoCaptureType{@link #VeLiveVideoCaptureType}
181
+ *
182
+ */
105
183
  /** {en}
106
184
  * @detail api
107
185
  * @brief Starts video capture.
@@ -111,7 +189,13 @@ export declare class VeLivePusher {
111
189
  *
112
190
  */
113
191
  startVideoCapture(type: VeLiveVideoCaptureType): void;
114
-
192
+ /** {zh}
193
+ * @detail api
194
+ * @brief 停止视频采集。
195
+ * @notes <br>调用该接口后,可以通过调用接口 [startVideoCapture](#VeLivePusher-startvideocapture) 开始视频采集。
196
+ * @order 10
197
+ *
198
+ */
115
199
  /** {en}
116
200
  * @detail api
117
201
  * @brief Stops video capture.
@@ -120,7 +204,14 @@ export declare class VeLivePusher {
120
204
  *
121
205
  */
122
206
  stopVideoCapture(): void;
123
-
207
+ /** {zh}
208
+ * @detail api
209
+ * @brief 开始音频采集。
210
+ * @notes <br>调用该接口后,可以通过调用接口 [stopAudioCapture](#VeLivePusher-stopaudiocapture) 停止音频采集。
211
+ * @order 9
212
+ * @param type 音频采集类型,详细信息请参见 [VeLiveAudioCaptureType](147521#VeLiveAudioCaptureType)。
213
+ *
214
+ */
124
215
  /** {en}
125
216
  * @detail api
126
217
  * @brief Starts audio capture.
@@ -130,7 +221,13 @@ export declare class VeLivePusher {
130
221
  *
131
222
  */
132
223
  startAudioCapture(type: VeLiveAudioCaptureType): void;
133
-
224
+ /** {zh}
225
+ * @detail api
226
+ * @brief 停止音频采集。
227
+ * @notes <br>调用该接口后,可以通过调用接口 [startAudioCapture](#VeLivePusher-startaudiocapture) 开始音频采集。
228
+ * @order 11
229
+ *
230
+ */
134
231
  /** {en}
135
232
  * @detail api
136
233
  * @brief Stops audio capture.
@@ -139,7 +236,14 @@ export declare class VeLivePusher {
139
236
  *
140
237
  */
141
238
  stopAudioCapture(): void;
142
-
239
+ /** {zh}
240
+ * @detail api
241
+ * @brief 切换视频采集类型。
242
+ * @notes <br>该接口必须在调用接口 [startVideoCapture](#VeLivePusher-startvideocapture) 后调用才能生效。
243
+ * @order 12
244
+ * @param type 视频采集类型,详细信息请参见 [VeLiveVideoCaptureType](147521#VeLiveVideoCaptureType)。
245
+ *
246
+ */
143
247
  /** {en}
144
248
  * @detail api
145
249
  * @brief Switches the video capture type.
@@ -149,7 +253,14 @@ export declare class VeLivePusher {
149
253
  *
150
254
  */
151
255
  switchVideoCapture(type: VeLiveVideoCaptureType): void;
152
-
256
+ /** {zh}
257
+ * @detail api
258
+ * @brief 切换音频采集类型。
259
+ * @notes <br>该接口必须在调用接口 [startVideoCapture](#VeLivePusher-startvideocapture) 后调用才能生效。
260
+ * @order 13
261
+ * @param type 音频采集类型,详细信息请参见 [VeLiveAudioCaptureType](147521#VeLiveAudioCaptureType)。
262
+ *
263
+ */
153
264
  /** {en}
154
265
  * @detail api
155
266
  * @brief Switches audio capture type.
@@ -159,7 +270,13 @@ export declare class VeLivePusher {
159
270
  *
160
271
  */
161
272
  switchAudioCapture(type: VeLiveAudioCaptureType): void;
162
-
273
+ /** {zh}
274
+ * @detail api
275
+ * @brief 获取当前视频采集类型。
276
+ * @order 14
277
+ * @return 视频采集类型,详细信息请参见 [VeLiveVideoCaptureType](147521#VeLiveVideoCaptureType)。
278
+ *
279
+ */
163
280
  /** {en}
164
281
  * @detail api
165
282
  * @brief Gets the current video capture type.
@@ -168,7 +285,13 @@ export declare class VeLivePusher {
168
285
  *
169
286
  */
170
287
  getCurrentVideoCaptureType(): VeLiveVideoCaptureType;
171
-
288
+ /** {zh}
289
+ * @detail api
290
+ * @brief 获取当前音频采集类型。
291
+ * @order 15
292
+ * @return <br>音频采集类型,详细信息请参见 [VeLiveAudioCaptureType](147521#VeLiveAudioCaptureType)。
293
+ *
294
+ */
172
295
  /** {en}
173
296
  * @detail api
174
297
  * @brief Gets the current audio capture type.
@@ -177,7 +300,13 @@ export declare class VeLivePusher {
177
300
  *
178
301
  */
179
302
  getCurrentAudioCaptureType(): VeLiveAudioCaptureType;
180
-
303
+ /** {zh}
304
+ * @detail api
305
+ * @brief 自定义静态图,适用于静态图推流采集类型。使用该接口时,需要将视频采集类型设置为 VeLiveVideoCaptureCustomImage,您可调用 [startVideoCapture](#VeLivePusher-startvideocapture) 方法,将 [VeLiveVideoCaptureType](147521#VeLiveVideoCaptureType) 设置为 VeLiveVideoCaptureCustomImage。
306
+ * @order 16
307
+ * @param image 静态图片,用于在静态图推流采集类型下设置静态图。
308
+ *
309
+ */
181
310
  /** {en}
182
311
  * @detail api
183
312
  * @brief Sets a static image to push. When using this method, you must call startVideoCapture {@link #VeLivePusher#startVideoCapture} and set VeLiveVideoCaptureType {@link #VeLiveVideoCaptureType} to `VeLiveVideoCaptureCustomImage`.
@@ -186,7 +315,18 @@ export declare class VeLivePusher {
186
315
  *
187
316
  */
188
317
  updateCustomImage(image: Bitmap): Promise<void>;
189
-
318
+ /** {zh}
319
+ * @detail api
320
+ * @brief 获取相机设备管理对象 `VeLiveCameraDevice`。通过设备管理,您可以使用以下功能。
321
+ * - 控制闪光灯开关
322
+ * - 设置摄像头缩放比例
323
+ * - 设置自动对焦
324
+ * @notes <br>
325
+ * 该接口需要在 startVideoCapture{@link #startVideoCapture} 方法中设置 VeLiveVideoCaptureType{@link #VeLiveVideoCaptureType} 为 VeLiveVideoCaptureFrontCamera 或 VeLiveVideoCaptureBackCamera。
326
+ * @order 17
327
+ * @return 相机设备管理对象 [VeLiveCameraDevice](#VeLiveCameraDevice)。
328
+ *
329
+ */
190
330
  /** {en}
191
331
  * @detail api
192
332
  * @brief Gets the camera manager. With the camera manager, you can do the following:
@@ -199,7 +339,14 @@ export declare class VeLivePusher {
199
339
  *
200
340
  */
201
341
  getCameraDevice(): VeLiveCameraDevice;
202
-
342
+ /** {zh}
343
+ * @detail api
344
+ * @brief 设置推流视频编码参数。
345
+ * @notes 该接口可在推流开始前或开始后调用。
346
+ * @order 18
347
+ * @param config 推流视频参数,支持设置推流视频分辨率、编码格式、目标码率和视频 GOP 大小等信息。详情请参见 [VeLiveVideoEncoderConfiguration](147521#VeLivePusherDef-VeLiveVideoEncoderConfiguration)。
348
+ *
349
+ */
203
350
  /** {en}
204
351
  * @detail api
205
352
  * @brief Sets video encoding parameters for the pushed stream.
@@ -209,7 +356,14 @@ export declare class VeLivePusher {
209
356
  *
210
357
  */
211
358
  setVideoEncoderConfiguration(config: VeLiveVideoEncoderConfiguration): void;
212
-
359
+ /** {zh}
360
+ * @platform android
361
+ * @detail api
362
+ * @brief 获取推流视频编码参数。
363
+ * @order 19
364
+ * @return 推流视频参数,支持设置推流视频分辨率、编码格式、目标码率和视频 GOP 大小等信息。详情请参见 [VeLiveVideoEncoderConfiguration](147521#VeLivePusherDef-VeLiveVideoEncoderConfiguration)。
365
+ *
366
+ */
213
367
  /** {en}
214
368
  * @platform android
215
369
  * @detail api
@@ -219,7 +373,14 @@ export declare class VeLivePusher {
219
373
  *
220
374
  */
221
375
  android_getVideoEncoderConfiguration(): $p_a.VeLiveVideoEncoderConfiguration;
222
-
376
+ /** {zh}
377
+ * @detail api
378
+ * @brief 设置推流音频编码参数。
379
+ * @notes <br>该接口需要在 [startPush](#VeLivePusher-startpush) 或 [startPushWithUrls](#VeLivePusher-startpushwithurls) 方法之前调用。
380
+ * @order 20
381
+ * @param config 推流音频编码参数,详情请参见 [VeLiveAudioEncoderConfiguration](147521#VeLivePusherDef-VeLiveAudioEncoderConfiguration)。
382
+ *
383
+ */
223
384
  /** {en}
224
385
  * @detail api
225
386
  * @brief Sets audio encoding parameters for the pushed stream.
@@ -229,7 +390,14 @@ export declare class VeLivePusher {
229
390
  *
230
391
  */
231
392
  setAudioEncoderConfiguration(config: VeLiveAudioEncoderConfiguration): void;
232
-
393
+ /** {zh}
394
+ * @platform android
395
+ * @detail api
396
+ * @brief 获取推流音频编码参数。
397
+ * @order 21
398
+ * @return 推流音频编码参数,详情请参见 [VeLiveAudioEncoderConfiguration](147521#VeLivePusherDef-VeLiveAudioEncoderConfiguration)。
399
+ *
400
+ */
233
401
  /** {en}
234
402
  * @platform android
235
403
  * @detail api
@@ -239,7 +407,13 @@ export declare class VeLivePusher {
239
407
  *
240
408
  */
241
409
  android_getAudioEncoderConfiguration(): $p_a.VeLiveAudioEncoderConfiguration;
242
-
410
+ /** {zh}
411
+ * @detail api
412
+ * @brief 开始推流。
413
+ * @order 22
414
+ * @param url 推流地址,用于将直播流推送到目标服务器。
415
+ *
416
+ */
243
417
  /** {en}
244
418
  * @detail api
245
419
  * @brief Starts streaming.
@@ -248,7 +422,15 @@ export declare class VeLivePusher {
248
422
  *
249
423
  */
250
424
  startPush(url: string): void;
251
-
425
+ /** {zh}
426
+ * @detail api
427
+ * @brief 开始推流,支持备用推流地址。
428
+ * @notes <br>
429
+ * 当主推流地址不可用时,会自动切换到备用推流地址继续推流。
430
+ * @order 23
431
+ * @param urls 推流地址列表,包含一个或多个推流地址。
432
+ *
433
+ */
252
434
  /** {en}
253
435
  * @detail api
254
436
  * @brief Starts streaming with one or more push stream addresses.
@@ -259,7 +441,13 @@ export declare class VeLivePusher {
259
441
  *
260
442
  */
261
443
  startPushWithUrls(urls: Array<string>): void;
262
-
444
+ /** {zh}
445
+ * @detail api
446
+ * @brief 停止推流。
447
+ * @notes <br>停止推流后,可以通过调用 [startPush](#VeLivePusher-startpush) 或 [startPushWithUrls](#VeLivePusher-startpushwithurls) 方法重新开始推流。
448
+ * @order 24
449
+ *
450
+ */
263
451
  /** {en}
264
452
  * @detail api
265
453
  * @brief Stops streaming.
@@ -269,7 +457,16 @@ export declare class VeLivePusher {
269
457
  *
270
458
  */
271
459
  stopPush(): void;
272
-
460
+ /** {zh}
461
+ * @detail api
462
+ * @brief 当前是否正在推流中,可用来查询推流器的当前状态。
463
+ * @order 25
464
+ * @return <br>
465
+ * 是否正在推流。<br>
466
+ * - true:正在推流中;
467
+ * - false:已经停止推流。
468
+ *
469
+ */
273
470
  /** {en}
274
471
  * @detail api
275
472
  * @brief Checks whether the streaming is currently ongoing. You can use this method to query the status of the live pusher.
@@ -281,7 +478,19 @@ export declare class VeLivePusher {
281
478
  *
282
479
  */
283
480
  isPushing(): boolean;
284
-
481
+ /** {zh}
482
+ * @detail api
483
+ * @brief 设置推流水印。
484
+ * @order 26
485
+ * @param image 水印图片。取值为 null 时,表示禁用水印。
486
+ * @param x 水印的水平偏移量,即水印图片相对视频流左上角的横向偏移与视频流宽度的比值,取值范围为 [0.0,1.0]。
487
+ * @param y 水印的垂直偏移量,即水印图片相对视频流左上角的纵向偏移与视频流高度的比值,取值范围为 [0.0,1.0]。
488
+ * @param scale 水印图片的缩放比例,取值范围为 [0.0,1.0]。
489
+ * @return <br>
490
+ * - 0:水印设置成功;
491
+ * - <0:水印设置失败。
492
+ *
493
+ */
285
494
  /** {en}
286
495
  * @detail api
287
496
  * @brief Sets a watermark for the pushed stream.
@@ -296,7 +505,15 @@ export declare class VeLivePusher {
296
505
  *
297
506
  */
298
507
  setWatermark(image: Bitmap, x: number, y: number, scale: number): Promise<number>;
299
-
508
+ /** {zh}
509
+ * @detail api
510
+ * @brief 开始本地文件录制。
511
+ * @order 27
512
+ * @param path 录制文件保存路径,不能为空。
513
+ * @param config 文件录制设置,详情请参见 [VeLiveFileRecorderConfiguration](147521#VeLivePusherDef-VeLiveFileRecorderConfiguration)。
514
+ * @param listener 本地文件录制的监听,详情请参见 [VeLiveFileRecordingListener](147519#VeLivePusherDef-VeLiveFileRecordingListener)。
515
+ *
516
+ */
300
517
  /** {en}
301
518
  * @detail api
302
519
  * @brief Starts local recording.
@@ -307,7 +524,13 @@ export declare class VeLivePusher {
307
524
  *
308
525
  */
309
526
  startFileRecording(path: string, config: VeLiveFileRecorderConfiguration, listener: VeLiveFileRecordingListener): void;
310
-
527
+ /** {zh}
528
+ * @detail api
529
+ * @brief 停止本地文件录制。
530
+ * @notes <br>该接口需要在 [startFileRecording](#VeLivePusher-startfilerecording) 方法之后调用。
531
+ * @order 28
532
+ *
533
+ */
311
534
  /** {en}
312
535
  * @detail api
313
536
  * @brief Stops local recording.
@@ -316,7 +539,17 @@ export declare class VeLivePusher {
316
539
  *
317
540
  */
318
541
  stopFileRecording(): void;
319
-
542
+ /** {zh}
543
+ * @detail api
544
+ * @brief 高级配置。
545
+ * @order 29
546
+ * @param key 推流高级配置为 JSON 格式的字符串,此参数为 JSON 结构中的 Key。您可通过提交工单联系[技术支持](https://console.volcengine.com/workorder/create?step=3&SubProductID=P00000076),了解配置方法。
547
+ * @param value 推流高级配置为 JSON 格式的字符串,此参数为 JSON 结构中的 Value。您可通过提交工单联系[技术支持](https://console.volcengine.com/workorder/create?step=3&SubProductID=P00000076),了解配置方法。
548
+ * @return <br>
549
+ * - 0:成功;
550
+ * - -1:失败,参数错误。
551
+ *
552
+ */
320
553
  /** {en}
321
554
  * @detail api
322
555
  * @brief Set advanced configurations. You can contact BytePlus technical support for more information about how to use this method.
@@ -329,7 +562,17 @@ export declare class VeLivePusher {
329
562
  *
330
563
  */
331
564
  setProperty(key: string, value: Object): number;
332
-
565
+ /** {zh}
566
+ * @detail api
567
+ * @brief 推送外部视频帧数据。
568
+ * @notes <br>
569
+ * 调用该接口时,需要将视频采集类型设置为 VeLiveVideoCaptureExternal,您可调用 startVideoCapture{@link #startVideoCapture} 方法,将 VeLiveVideoCaptureType{@link #VeLiveVideoCaptureType} 设置为 VeLiveVideoCaptureExternal。
570
+ * @order 30
571
+ * @param frame 视频帧的数据信息,详情请参见 [VeLiveVideoFrame](147521#VeLiveVideoFrame)。
572
+ * @return - 0:成功;
573
+ * - <0:失败。
574
+ *
575
+ */
333
576
  /** {en}
334
577
  * @detail api
335
578
  * @brief Pushes an external video frame.
@@ -341,7 +584,17 @@ export declare class VeLivePusher {
341
584
  *
342
585
  */
343
586
  pushExternalVideoFrame(frame: VeLiveVideoFrame): number;
344
-
587
+ /** {zh}
588
+ * @detail api
589
+ * @brief 推送外部音频帧数据。
590
+ * @notes 该接口需要在 startAudioCapture 方法中设置 [VeLiveAudioCaptureType](147521#VeLiveAudioCaptureType) 为 VeLiveAudioCaptureExternal。
591
+ * @order 31
592
+ * @param frame 外部音频数据。详情请参见 [VeLiveAudioFrame](147521#VeLiveAudioFrame)。
593
+ * @return <br>
594
+ * - 0:成功;
595
+ * - <0:失败。
596
+ *
597
+ */
345
598
  /** {en}
346
599
  * @detail api
347
600
  * @brief Pushes an external audio frame.
@@ -353,7 +606,13 @@ export declare class VeLivePusher {
353
606
  *
354
607
  */
355
608
  pushExternalAudioFrame(frame: VeLiveAudioFrame): number;
356
-
609
+ /** {zh}
610
+ * @detail api
611
+ * @brief 设置推流视频帧朝向。默认为竖屏推流。
612
+ * @order 32
613
+ * @param orientation 视频帧朝向,详情请参见 [VeLiveOrientation](147521#VeLiveOrientation)。
614
+ *
615
+ */
357
616
  /** {en}
358
617
  * @detail api
359
618
  * @brief Sets the orientation of the pushed video frame. The default orientation is portrait.
@@ -362,7 +621,25 @@ export declare class VeLivePusher {
362
621
  *
363
622
  */
364
623
  setOrientation(orientation: VeLiveOrientation): void;
365
-
624
+ /** {zh}
625
+ * @detail api
626
+ * @brief 通过视频帧发送 SEI 消息。
627
+ * @notes <br>该接口需要在调用 [startPush](#VeLivePusher-startpush) 或 [startPushWithUrls](#VeLivePusher-startpushwithurls) 方法之后调用。
628
+ * @order 33
629
+ * @param key SEI 消息为 JSON 格式的字符串。此参数为 JSON 结构中的 Key。
630
+ * @param value SEI 消息为 JSON 格式的字符串。此参数为 JSON 结构中的 Value。
631
+ * @param repeat 消息发送重复的次数。例如,`repeat` 取值为 20,`isKeyFrame` 取值为 YES,则会在视频帧开始的连续 20 个关键帧中添加 SEI 消息。
632
+ * @param isKeyFrame 是否仅在关键帧中包含 SEI 消息。<br>
633
+ * - true:仅在关键帧中包含;
634
+ * - false:所有帧中均包含。
635
+ * @param allowsCovered 是否允许覆盖。<br>
636
+ * - true:允许;
637
+ * - false:不允许。
638
+ * @return <br>
639
+ * - 0:成功;
640
+ * - <0:失败。
641
+ *
642
+ */
366
643
  /** {en}
367
644
  * @detail api
368
645
  * @brief Sends an SEI message through the video frame. The SEI messages are strings in JSON format.
@@ -383,7 +660,15 @@ export declare class VeLivePusher {
383
660
  *
384
661
  */
385
662
  sendSeiMessage(key: string, value: Object, repeat: number, isKeyFrame: boolean, allowsCovered: boolean): number;
386
-
663
+ /** {zh}
664
+ * @detail api
665
+ * @brief 设置静音。
666
+ * @param mute 是否设置为静音。默认为正常推流。<br>
667
+ * - true:静音推流;
668
+ * - false:正常推流。
669
+ * @order 34
670
+ *
671
+ */
387
672
  /** {en}
388
673
  * @detail api
389
674
  * @brief Sets whether to mute the stream.
@@ -394,7 +679,15 @@ export declare class VeLivePusher {
394
679
  *
395
680
  */
396
681
  setMute(mute: boolean): void;
397
-
682
+ /** {zh}
683
+ * @detail api
684
+ * @brief 当前是否是静音状态。
685
+ * @order 35
686
+ * @return <br>
687
+ * - true:当前是静音状态;
688
+ * - false:当前非静音状态。
689
+ *
690
+ */
398
691
  /** {en}
399
692
  * @detail api
400
693
  * @brief Checks whether the stream is muted.
@@ -405,7 +698,19 @@ export declare class VeLivePusher {
405
698
  *
406
699
  */
407
700
  isMute(): boolean;
408
-
701
+ /** {zh}
702
+ * @detail api
703
+ * @brief 获取视频特效管理对象 `VeLiveVideoEffectManager`。通过视频特效管理,您可以使用以下功能。
704
+ * - 设置美颜
705
+ * - 设置特效
706
+ * - 设置素材
707
+ * - 设置贴图
708
+ * - 设置滤镜
709
+ * @notes 该接口需要集成智能美化特效 SDK 后才能使用。
710
+ * @order 36
711
+ * @return 视频特效管理对象 [VeLiveVideoEffectManager](#VeLiveVideoEffectManager)。
712
+ *
713
+ */
409
714
  /** {en}
410
715
  * @detail api
411
716
  * @brief Gets the special effects manager. With the special effects manager, you can do the following:
@@ -420,7 +725,13 @@ export declare class VeLivePusher {
420
725
  *
421
726
  */
422
727
  getVideoEffectManager(): VeLiveVideoEffectManager;
423
-
728
+ /** {zh}
729
+ * @detail api
730
+ * @brief 自定义视频处理。
731
+ * @order 37
732
+ * @param filter 视频数据处理回调,详情请参见 [VeLiveVideoFrameFilter](147519#VeLivePusherDef-VeLiveVideoFrameFilter)。
733
+ *
734
+ */
424
735
  /** {en}
425
736
  * @detail api
426
737
  * @brief Sets custom video processing.
@@ -429,7 +740,15 @@ export declare class VeLivePusher {
429
740
  *
430
741
  */
431
742
  setVideoFrameFilter(filter: VeLiveVideoFrameFilter): void;
432
-
743
+ /** {zh}
744
+ * @detail api
745
+ * @brief 获取音频模块管理对象。
746
+ * @notes <br>
747
+ * 该接口需要在 startAudioCapture{@link #startAudioCapture} 方法中设置 VeLiveAudioCaptureType{@link #VeLiveAudioCaptureType} 为 VeLiveAudioCaptureMicrophone。
748
+ * @order 38
749
+ * @return 音频模块管理对象 [VeLiveAudioDevice](#VeLiveAudioDevice)。
750
+ *
751
+ */
433
752
  /** {en}
434
753
  * @detail api
435
754
  * @brief Gets the audio device manager.
@@ -439,7 +758,13 @@ export declare class VeLivePusher {
439
758
  *
440
759
  */
441
760
  getAudioDevice(): VeLiveAudioDevice;
442
-
761
+ /** {zh}
762
+ * @detail api
763
+ * @brief 自定义音频处理。
764
+ * @order 39
765
+ * @param filter 音频帧滤镜对象 VeLiveAudioFrameFilter 。
766
+ *
767
+ */
443
768
  /** {en}
444
769
  * @detail api
445
770
  * @brief Sets custom audio processing.
@@ -448,7 +773,13 @@ export declare class VeLivePusher {
448
773
  *
449
774
  */
450
775
  setAudioFrameFilter(filter: VeLiveAudioFrameFilter): void;
451
-
776
+ /** {zh}
777
+ * @detail api
778
+ * @brief 创建播放器。
779
+ * @order 1
780
+ * @return 播放器管理对象 [VeLiveMediaPlayer](#VeLiveMediaPlayer)。
781
+ *
782
+ */
452
783
  /** {en}
453
784
  * @detail api
454
785
  * @brief Creates the media player.
@@ -457,7 +788,13 @@ export declare class VeLivePusher {
457
788
  *
458
789
  */
459
790
  createPlayer(): VeLiveMediaPlayer;
460
-
791
+ /** {zh}
792
+ * @platform android
793
+ * @detail api
794
+ * @brief 开始系统音频采集。
795
+ * @order 41
796
+ *
797
+ */
461
798
  /** {en}
462
799
  * @platform android
463
800
  * @detail api
@@ -466,7 +803,13 @@ export declare class VeLivePusher {
466
803
  *
467
804
  */
468
805
  android_startMixSystemAudio(): void;
469
-
806
+ /** {zh}
807
+ * @platform android
808
+ * @detail api
809
+ * @brief 停止系统音频采集。
810
+ * @order 42
811
+ *
812
+ */
470
813
  /** {en}
471
814
  * @platform android
472
815
  * @detail api
@@ -475,7 +818,13 @@ export declare class VeLivePusher {
475
818
  *
476
819
  */
477
820
  android_stopMixSystemAudio(): void;
478
-
821
+ /** {zh}
822
+ * @platform android
823
+ * @detail api
824
+ * @brief 获取当前是否处于屏幕采集状态。
825
+ * @order 43
826
+ *
827
+ */
479
828
  /** {en}
480
829
  * @platform android
481
830
  * @detail api
@@ -484,7 +833,16 @@ export declare class VeLivePusher {
484
833
  *
485
834
  */
486
835
  android_isScreenRecording(): boolean;
487
-
836
+ /** {zh}
837
+ * @detail api
838
+ * @brief 添加视频帧的监听回调,用于获取推流器输出的视频帧。
839
+ * @order 44
840
+ * @param listener 视频帧的监听回调,详细信息请参见 [VeLiveVideoFrameListener](147519#VeLivePusherDef-VeLiveVideoFrameListener)。
841
+ * @return <br>
842
+ * - 0:成功;
843
+ * - <0:失败。
844
+ *
845
+ */
488
846
  /** {en}
489
847
  * @detail api
490
848
  * @brief Adds a video frame listener.
@@ -496,7 +854,18 @@ export declare class VeLivePusher {
496
854
  *
497
855
  */
498
856
  addVideoFrameListener(listener: VeLiveVideoFrameListener): number;
499
-
857
+ /** {zh}
858
+ * @detail api
859
+ * @brief 移除已添加的视频帧监听回调。
860
+ * @notes <br>
861
+ * 如果没有添加过此监听回调或者监听回调已被移除,调用此方法将返回失败。
862
+ * @order 45
863
+ * @param listener 视频帧的监听回调,详细信息请参见 [VeLiveVideoFrameListener](147519#VeLivePusherDef-VeLiveVideoFrameListener)。
864
+ * @return <br>
865
+ * - 0:成功;
866
+ * - <0:失败。
867
+ *
868
+ */
500
869
  /** {en}
501
870
  * @detail api
502
871
  * @brief Removes the video frame listener.
@@ -510,7 +879,16 @@ export declare class VeLivePusher {
510
879
  *
511
880
  */
512
881
  removeVideoFrameListener(listener: VeLiveVideoFrameListener): number;
513
-
882
+ /** {zh}
883
+ * @detail api
884
+ * @brief 添加音频帧的监听回调,用于获取推流器输出的音频帧。
885
+ * @order 46
886
+ * @param listener 音频帧监听回调,详细信息请参见 [VeLiveAudioFrameListener](147519#VeLivePusherDef-VeLiveAudioFrameListener)。
887
+ * @return <br>
888
+ * - 0:成功;
889
+ * - <0:失败。
890
+ *
891
+ */
514
892
  /** {en}
515
893
  * @detail api
516
894
  * @brief Adds an audio frame listener.
@@ -522,7 +900,18 @@ export declare class VeLivePusher {
522
900
  *
523
901
  */
524
902
  addAudioFrameListener(listener: VeLiveAudioFrameListener): number;
525
-
903
+ /** {zh}
904
+ * @detail api
905
+ * @brief 移除已添加的音频帧监听回调。
906
+ * @notes <br>
907
+ * 如果没有添加过此监听回调或者监听回调已被移除,调用此方法将返回失败。
908
+ * @order 47
909
+ * @param listener 音频帧的监听回调,详细信息请参见 [VeLiveAudioFrameListener](147519#VeLivePusherDef-VeLiveAudioFrameListener)。
910
+ * @return <br>
911
+ * - 0:成功;
912
+ * - <0:失败。
913
+ *
914
+ */
526
915
  /** {en}
527
916
  * @detail api
528
917
  * @brief Removes the audio frame listener.
@@ -536,7 +925,13 @@ export declare class VeLivePusher {
536
925
  *
537
926
  */
538
927
  removeAudioFrameListener(listener: VeLiveAudioFrameListener): number;
539
-
928
+ /** {zh}
929
+ * @detail api
930
+ * @brief 视频截图。
931
+ * @order 48
932
+ * @param listener 截图监听对象,详情请参见 [VeLiveSnapshotListener](147519#VeLivePusherDef-VeLiveSnapshotListener)。
933
+ *
934
+ */
540
935
  /** {en}
541
936
  * @detail api
542
937
  * @brief Takes a screenshot.
@@ -545,7 +940,13 @@ export declare class VeLivePusher {
545
940
  *
546
941
  */
547
942
  snapshot(listener: VeLiveSnapshotListener): void;
548
-
943
+ /** {zh}
944
+ * @platform ios
945
+ * @detail api
946
+ * @param applicationGroupIdentifier iOS app group 标识符。
947
+ * @brief 开启屏幕采集。
948
+ * @order 20
949
+ */
549
950
  /** {en}
550
951
  * @platform ios
551
952
  * @detail api
@@ -554,7 +955,14 @@ export declare class VeLivePusher {
554
955
  * @order 20
555
956
  */
556
957
  ios_startScreenCapture(applicationGroupIdentifier: string): void;
557
-
958
+ /** {zh}
959
+ * @platform ios
960
+ * @detail api
961
+ * @brief 停止屏幕采集。
962
+ * @notes <br>
963
+ * 该方法用于结束当前屏幕采集流程,并释放相关资源。调用本方法后,`pauseScreenCapture` 和 `resumeScreenCapture` 将不再生效。
964
+ * @order 21
965
+ */
558
966
  /** {en}
559
967
  * @platform ios
560
968
  * @detail api
@@ -564,7 +972,14 @@ export declare class VeLivePusher {
564
972
  * @order 21
565
973
  */
566
974
  ios_stopScreenCapture(): void;
567
-
975
+ /** {zh}
976
+ * @platform ios
977
+ * @detail api
978
+ * @brief 暂停屏幕采集。
979
+ * @notes <br>
980
+ * 调用该方法后,屏幕采集将暂停输出数据,但不会销毁内部资源。您可通过 `resumeScreenCapture` 来恢复采集。如果当前采集已经停止或尚未开始,调用本方法不会产生任何效果。
981
+ * @order 22
982
+ */
568
983
  /** {en}
569
984
  * @platform ios
570
985
  * @detail api
@@ -574,7 +989,14 @@ export declare class VeLivePusher {
574
989
  * @order 22
575
990
  */
576
991
  ios_pauseScreenCapture(): void;
577
-
992
+ /** {zh}
993
+ * @platform ios
994
+ * @detail api
995
+ * @brief 恢复屏幕采集。
996
+ * @notes <br>
997
+ * 在调用 `pauseScreenCapture` 暂停后,通过本方法可以恢复屏幕采集输出。如果屏幕采集已经停止或尚未开始,调用本方法不会产生任何效果。
998
+ * @order 23
999
+ */
578
1000
  /** {en}
579
1001
  * @platform ios
580
1002
  * @detail api
@@ -584,7 +1006,13 @@ export declare class VeLivePusher {
584
1006
  * @order 23
585
1007
  */
586
1008
  ios_resumeScreenCapture(): void;
587
-
1009
+ /** {zh}
1010
+ * @platform ios
1011
+ * @detail api
1012
+ * @brief 初始化推流器。
1013
+ * @order 0
1014
+ * @param config 推流配置类。详细信息请参见 [VeLivePusherConfiguration](155321#VeLivePusherConfiguration)。
1015
+ */
588
1016
  /** {en}
589
1017
  * @platform ios
590
1018
  * @detail api
@@ -593,7 +1021,19 @@ export declare class VeLivePusher {
593
1021
  * @order 0
594
1022
  */
595
1023
  ios_initWithConfig(config: $p_i.VeLivePusherConfiguration): this;
596
-
1024
+ /** {zh}
1025
+ * @platform ios
1026
+ * @detail api
1027
+ * @brief 添加屏幕采集的监听。
1028
+ * @notes <br>
1029
+ * 如果没有添加过此监听回调或者监听回调已被移除,调用此方法将返回失败。
1030
+ * @param listener 屏幕采集事件监听回调,详细信息请参见 VeLiveScreenCaptureStatusObserver{@link #VeLiveScreenCaptureStatusObserver}
1031
+ * @param observer 录屏推流事件监听器。详情见 [VeLiveScreenCaptureStatusObserver](155319#VeLiveScreenCaptureStatusObserver)。
1032
+ * @order 5
1033
+ * @return <br>
1034
+ * - 0:成功;
1035
+ * - <0:失败。
1036
+ */
597
1037
  /** {en}
598
1038
  * @platform ios
599
1039
  * @brief Sets the observer for screen capturing events.
@@ -604,7 +1044,18 @@ export declare class VeLivePusher {
604
1044
  * - <0: Failure.
605
1045
  */
606
1046
  ios_setScreenCaptureObserver(observer: $p_i.id<$p_i.VeLiveScreenCaptureStatusObserver>): number;
607
-
1047
+ /** {zh}
1048
+ * @platform ios
1049
+ * @detail api
1050
+ * @brief 推送外部视频编码数据。
1051
+ * @notes
1052
+ * 该接口需要在 [startVideoCapture:](#VeLivePusher-startvideocapture) 方法中设置 [VeLiveVideoCaptureType](155321#VeLiveVideoCaptureType) 为 VeLiveVideoCaptureFrontCamera 或 VeLiveVideoCaptureExternal。
1053
+ * @order 38
1054
+ * @param encodeFrame 视频编码帧的数据信息,详情请参见 [VeLiveVideoEncodeFrame](155321#VeLiveVideoEncodeFrame)。
1055
+ * @return <br>
1056
+ * - 0:成功;
1057
+ * - <0:失败。
1058
+ */
608
1059
  /** {en}
609
1060
  * @platform ios
610
1061
  * @detail api
@@ -618,7 +1069,14 @@ export declare class VeLivePusher {
618
1069
  * - <0: Failure.
619
1070
  */
620
1071
  ios_pushExternalVideoEncodeFrame(encodeFrame: $p_i.VeLiveVideoEncodeFrame): number;
621
-
1072
+ /** {zh}
1073
+ * @platform ios
1074
+ * @detail api
1075
+ * @brief 强制请求 IDR 帧,发起请求以编码一个新的 IDR 帧。
1076
+ * @notes
1077
+ * 该接口需要在调用 [startPush:](#VeLivePusher-startpush) 或 [startPushWithUrls:](#VeLivePusher-startpushwithurls) 方法之后调用。
1078
+ * @order 49
1079
+ */
622
1080
  /** {en}
623
1081
  * @platform ios
624
1082
  * @detail api
@@ -629,12 +1087,20 @@ export declare class VeLivePusher {
629
1087
  */
630
1088
  ios_requestIDRFrame(): void;
631
1089
  }
632
-
1090
+ /** {zh}
1091
+ * @detail api
1092
+ * @brief 媒体播放器对象。
1093
+ */
633
1094
  export declare class VeLiveMediaPlayer {
634
1095
  protected _instance: any;
635
1096
  protected __init(...args: any[]): void;
636
1097
  protected __new_instance(...args: any[]): any;
637
-
1098
+ /** {zh}
1099
+ * @detail api
1100
+ * @brief 销毁播放器实例。
1101
+ * @order 1
1102
+ *
1103
+ */
638
1104
  /** {en}
639
1105
  * @detail api
640
1106
  * @brief Destroys the media player instance.
@@ -642,7 +1108,15 @@ export declare class VeLiveMediaPlayer {
642
1108
  *
643
1109
  */
644
1110
  destroy(): void;
645
-
1111
+ /** {zh}
1112
+ * @detail api
1113
+ * @brief 设置播放状态的监听。
1114
+ * @notes <br>
1115
+ * 重复调用本方法,仅最后一次调用生效。
1116
+ * @order 4
1117
+ * @param listener 播放状态监听。详情请参见 [VeLiveMediaPlayerListener](147519#VeLivePusherDef-VeLiveMediaPlayerListener)。
1118
+ *
1119
+ */
646
1120
  /** {en}
647
1121
  * @detail api
648
1122
  * @brief Sets the observer for playback statuses.
@@ -653,7 +1127,16 @@ export declare class VeLiveMediaPlayer {
653
1127
  *
654
1128
  */
655
1129
  setListener(listener: VeLiveMediaPlayerListener): void;
656
-
1130
+ /** {zh}
1131
+ * @detail api
1132
+ * @brief 设置文件路径。支持的文件格式包括 MP3、AAC、M4A、WAV。
1133
+ * @order 2
1134
+ * @param url 文件路径。
1135
+ * @return <br>
1136
+ * - 0:成功;
1137
+ * - ≠0:失败。
1138
+ *
1139
+ */
657
1140
  /** {en}
658
1141
  * @detail api
659
1142
  * @brief Sets the file path. Supported file formats include MP3, AAC, M4A, WAV.
@@ -665,7 +1148,14 @@ export declare class VeLiveMediaPlayer {
665
1148
  *
666
1149
  */
667
1150
  prepare(url: string): number;
668
-
1151
+ /** {zh}
1152
+ * @detail api
1153
+ * @brief 开始播放。
1154
+ * @notes <br>
1155
+ * 需要在调用 start{@link #start} 开始播放后,调用本方法。
1156
+ * @order 12
1157
+ *
1158
+ */
669
1159
  /** {en}
670
1160
  * @detail api
671
1161
  * @brief Start playback.
@@ -675,7 +1165,17 @@ export declare class VeLiveMediaPlayer {
675
1165
  *
676
1166
  */
677
1167
  start(): Promise<number>;
678
-
1168
+ /** {zh}
1169
+ * @detail api
1170
+ * @brief 停止播放。
1171
+ * @notes <br>
1172
+ * 需要在调用 start{@link #start} 开始播放后,调用本方法。
1173
+ * @order 13
1174
+ * @return <br>
1175
+ * - 0:成功;
1176
+ * - ≠0:失败。
1177
+ *
1178
+ */
679
1179
  /** {en}
680
1180
  * @detail api
681
1181
  * @brief Stops playback.
@@ -688,7 +1188,13 @@ export declare class VeLiveMediaPlayer {
688
1188
  *
689
1189
  */
690
1190
  stop(): Promise<number>;
691
-
1191
+ /** {zh}
1192
+ * @detail api
1193
+ * @brief 暂停播放。
1194
+ * @notes <br>需要在调用 [start](#VeLiveMediaPlayer-start)[start](#VeLiveMediaPlayer-start) 开始播放后,调用本方法。
1195
+ * @order 14
1196
+ *
1197
+ */
692
1198
  /** {en}
693
1199
  * @detail api
694
1200
  * @brief Pauses playback.
@@ -698,7 +1204,13 @@ export declare class VeLiveMediaPlayer {
698
1204
  *
699
1205
  */
700
1206
  pause(): Promise<void>;
701
-
1207
+ /** {zh}
1208
+ * @detail api
1209
+ * @brief 恢复播放。
1210
+ * @notes <br>需要在调用 [pause](#VeLiveMediaPlayer-pause) 暂停播放后,调用本方法。
1211
+ * @order 15
1212
+ *
1213
+ */
702
1214
  /** {en}
703
1215
  * @detail api
704
1216
  * @brief Resumes playback.
@@ -707,7 +1219,16 @@ export declare class VeLiveMediaPlayer {
707
1219
  *
708
1220
  */
709
1221
  resume(): Promise<void>;
710
-
1222
+ /** {zh}
1223
+ * @detail api
1224
+ * @brief 获取文件的总时长,单位为 ms。
1225
+ * @notes <br>需要在调用 [start](#VeLiveMediaPlayer-start) 开始播放后,调用本方法。
1226
+ * @order 3
1227
+ * @return <br>
1228
+ * - >0:成功,音频文件时长;
1229
+ * - ≤0:失败。
1230
+ *
1231
+ */
711
1232
  /** {en}
712
1233
  * @detail api
713
1234
  * @brief Gets the duration of the media file.
@@ -719,7 +1240,16 @@ export declare class VeLiveMediaPlayer {
719
1240
  *
720
1241
  */
721
1242
  getDuration(): number;
722
-
1243
+ /** {zh}
1244
+ * @detail api
1245
+ * @brief 设置播放进度。
1246
+ * @order 5
1247
+ * @param posMs 播放时间,单位为 ms。
1248
+ * @return <br>
1249
+ * - 0:成功;
1250
+ * - ≠0:失败。
1251
+ *
1252
+ */
723
1253
  /** {en}
724
1254
  * @detail api
725
1255
  * @brief Sets the playback progress.
@@ -731,7 +1261,15 @@ export declare class VeLiveMediaPlayer {
731
1261
  *
732
1262
  */
733
1263
  seek(posMs: number): number;
734
-
1264
+ /** {zh}
1265
+ * @detail api
1266
+ * @brief 开启/关闭音频是否混音到直播流。
1267
+ * @param enable 开启/关闭,默认为 false。 <br>
1268
+ * - ture:开启;
1269
+ * - false:关闭。
1270
+ * @order 6
1271
+ *
1272
+ */
735
1273
  /** {en}
736
1274
  * @detail api
737
1275
  * @brief Enables or disables mixing the audio to the live stream.
@@ -742,7 +1280,14 @@ export declare class VeLiveMediaPlayer {
742
1280
  *
743
1281
  */
744
1282
  enableMixer(enable: boolean): void;
745
-
1283
+ /** {zh}
1284
+ * @detail api
1285
+ * @brief 开启/关闭自动音量均衡。
1286
+ * @order 7
1287
+ * @param sourceLufs 源响度。
1288
+ * @param targetLufs 目标响度。
1289
+ *
1290
+ */
746
1291
  /** {en}
747
1292
  * @detail api
748
1293
  * @brief Enables or disables automatic volume equalization.
@@ -752,7 +1297,15 @@ export declare class VeLiveMediaPlayer {
752
1297
  *
753
1298
  */
754
1299
  enableAutoEq(sourceLufs: number, targetLufs: number): void;
755
-
1300
+ /** {zh}
1301
+ * @detail api
1302
+ * @brief 设置音视频帧回调的监听。
1303
+ * @notes <br>
1304
+ * 重复调用本方法,仅最后一次调用生效。
1305
+ * @order 8
1306
+ * @param listener 音视频帧回调监听。详情请参见 [VeLiveMediaPlayerFrameListener](147519#VeLivePusherDef-VeLiveMediaPlayerFrameListener)。
1307
+ *
1308
+ */
756
1309
  /** {en}
757
1310
  * @detail api
758
1311
  * @brief Sets the observer for audio and video frames.
@@ -763,7 +1316,13 @@ export declare class VeLiveMediaPlayer {
763
1316
  *
764
1317
  */
765
1318
  setFrameListener(listener: VeLiveMediaPlayerFrameListener): void;
766
-
1319
+ /** {zh}
1320
+ * @detail api
1321
+ * @brief 设置播放音频的音量。
1322
+ * @order 9
1323
+ * @param volume 播放音频音量,取值范围为 [0.0,4.0]。
1324
+ *
1325
+ */
767
1326
  /** {en}
768
1327
  * @detail api
769
1328
  * @brief Sets the playback volume.
@@ -771,8 +1330,15 @@ export declare class VeLiveMediaPlayer {
771
1330
  * @order 113
772
1331
  *
773
1332
  */
774
- setBGMVolume(volume: number): void;
775
-
1333
+ setBGMVolume(volume: number): void;
1334
+ /** {zh}
1335
+ * @detail api
1336
+ * @brief 设置音频采集音量。
1337
+ * @notes <br>需要在调用 [start](#VeLiveMediaPlayer-start) 开始播放背景音乐后,调用本方法。
1338
+ * @order 10
1339
+ * @param volume 音频采集音量,取值范围为 [0.0,4.0]。
1340
+ *
1341
+ */
776
1342
  /** {en}
777
1343
  * @detail api
778
1344
  * @brief Sets the audio capture volume.
@@ -782,7 +1348,15 @@ export declare class VeLiveMediaPlayer {
782
1348
  *
783
1349
  */
784
1350
  setVoiceVolume(volume: number): void;
785
-
1351
+ /** {zh}
1352
+ * @detail api
1353
+ * @brief 设置是否循环播放。
1354
+ * @param loop 是否循环播放。默认为 false。<br>
1355
+ * - true:循环播放;
1356
+ * - false:不循环播放。
1357
+ * @order 11
1358
+ *
1359
+ */
786
1360
  /** {en}
787
1361
  * @detail api
788
1362
  * @brief Sets whether to loop the video.
@@ -793,7 +1367,13 @@ export declare class VeLiveMediaPlayer {
793
1367
  *
794
1368
  */
795
1369
  enableBGMLoop(loop: boolean): void;
796
-
1370
+ /** {zh}
1371
+ * @platform ios
1372
+ * @detail api
1373
+ * @brief 支持 MP4 格式的视频渲染。
1374
+ * @param view 渲染视图。
1375
+ * @order 93
1376
+ */
797
1377
  /** {en}
798
1378
  * @platform ios
799
1379
  * @detail api
@@ -803,31 +1383,46 @@ export declare class VeLiveMediaPlayer {
803
1383
  */
804
1384
  ios_setRenderView(view: $p_i.UIView): void;
805
1385
  }
806
-
1386
+ /** {zh}
1387
+ * @detail keytype
1388
+ * @brief 推流引擎初始化配置。
1389
+ */
807
1390
  export declare class VeLivePusherConfiguration {
808
1391
  protected _instance: any;
809
-
1392
+ /** {zh}
1393
+ * @platform ios
1394
+ * @brief 音频采集参数设置,用于调整和设置音频采集相关的参数。详情请参见 [VeLiveAudioCaptureConfiguration](#VeLiveAudioCaptureConfiguration)。
1395
+ */
810
1396
  /** {en}
811
1397
  * @platform ios
812
1398
  * @brief The audio capture configurations. See [VeLiveAudioCaptureConfiguration](#VeLiveAudioCaptureConfiguration) for details.
813
1399
  */
814
1400
  get audioCaptureConfig(): $p_i.VeLiveAudioCaptureConfiguration;
815
1401
  set audioCaptureConfig(value: $p_i.VeLiveAudioCaptureConfiguration);
816
-
1402
+ /** {zh}
1403
+ * @platform ios
1404
+ * @brief 推流失败后,尝试重连的时间间隔。单位为 s,默认值为 5。
1405
+ */
817
1406
  /** {en}
818
1407
  * @platform ios
819
1408
  * @brief The time interval between each attempt to reconnect, in seconds. The default value is `5`.
820
1409
  */
821
1410
  get reconnectIntervalSeconds(): $p_i.int;
822
1411
  set reconnectIntervalSeconds(value: $p_i.int);
823
-
1412
+ /** {zh}
1413
+ * @platform ios
1414
+ * @brief 推流失败后,尝试重连的次数。默认值为 3。
1415
+ */
824
1416
  /** {en}
825
1417
  * @platform ios
826
1418
  * @brief The number of attempts to reconnect after the initial attempt fails. The default value is `3`.
827
1419
  */
828
1420
  get reconnectCount(): $p_i.int;
829
1421
  set reconnectCount(value: $p_i.int);
830
-
1422
+ /** {zh}
1423
+ * @platform ios
1424
+ * @brief 设置扩展参数,用于实现某些特殊功能或配置,默认不需要设置。
1425
+ */
831
1426
  /** {en}
832
1427
  * @platform ios
833
1428
  * @brief Advanced parameters. You can leave this parameter empty.
@@ -836,7 +1431,14 @@ export declare class VeLivePusherConfiguration {
836
1431
  set extraParameters(value: $p_i.NSDictionary);
837
1432
  protected __init(...args: any[]): void;
838
1433
  protected __new_instance(...args: any[]): any;
839
-
1434
+ /** {zh}
1435
+ * @detail api
1436
+ * @brief 设置视频采集参数,用于调整和设置视频采集相关的参数。
1437
+ * @order 6
1438
+ * @param config 视频采集参数,详情请参见 [VeLiveVideoCaptureConfiguration](#VeLivePusherDef-VeLiveVideoCaptureConfiguration)。
1439
+ * @return 推流引擎初始化配置对象,详情请参见 [VeLivePusherConfiguration](#VeLivePusherConfiguration)。
1440
+ *
1441
+ */
840
1442
  /** {en}
841
1443
  * @detail api
842
1444
  * @brief Sets the video capture configurations.
@@ -847,7 +1449,14 @@ export declare class VeLivePusherConfiguration {
847
1449
  *
848
1450
  */
849
1451
  setVideoCaptureConfig(config: VeLiveVideoCaptureConfiguration): void;
850
-
1452
+ /** {zh}
1453
+ * @platform android
1454
+ * @detail api
1455
+ * @brief 设置推流器推流失败后尝试重连的时间间隔。
1456
+ * @param interval 时间间隔,单位为 s,默认值为 5
1457
+ * @order 2
1458
+ *
1459
+ */
851
1460
  /** {en}
852
1461
  * @platform android
853
1462
  * @detail api
@@ -857,7 +1466,15 @@ export declare class VeLivePusherConfiguration {
857
1466
  *
858
1467
  */
859
1468
  android_setReconnectIntervalSeconds(interval: number): this;
860
-
1469
+ /** {zh}
1470
+ * @platform android
1471
+ * @detail api
1472
+ * @brief 获取推流器推流失败后尝试重连的时间间隔。
1473
+ * @order 3
1474
+ * @return <br>
1475
+ * 时间间隔,单位为 s。
1476
+ *
1477
+ */
861
1478
  /** {en}
862
1479
  * @platform android
863
1480
  * @detail api
@@ -868,7 +1485,14 @@ export declare class VeLivePusherConfiguration {
868
1485
  *
869
1486
  */
870
1487
  android_getReconnectIntervalSeconds(): number;
871
-
1488
+ /** {zh}
1489
+ * @platform android
1490
+ * @detail api
1491
+ * @brief 设置推流器推流失败后尝试重连的次数。
1492
+ * @param maxCount 重连次数,默认值为 3
1493
+ * @order 4
1494
+ *
1495
+ */
872
1496
  /** {en}
873
1497
  * @platform android
874
1498
  * @detail api
@@ -878,7 +1502,15 @@ export declare class VeLivePusherConfiguration {
878
1502
  *
879
1503
  */
880
1504
  android_setReconnectCount(maxCount: number): this;
881
-
1505
+ /** {zh}
1506
+ * @platform android
1507
+ * @detail api
1508
+ * @brief 获取推流器推流失败后尝试重连的次数。
1509
+ * @order 5
1510
+ * @return <br>
1511
+ * 重连次数。
1512
+ *
1513
+ */
882
1514
  /** {en}
883
1515
  * @platform android
884
1516
  * @detail api
@@ -889,7 +1521,14 @@ export declare class VeLivePusherConfiguration {
889
1521
  *
890
1522
  */
891
1523
  android_getReconnectCount(): number;
892
-
1524
+ /** {zh}
1525
+ * @platform android
1526
+ * @detail api
1527
+ * @brief 获取视频采集参数,用于调整和设置视频采集相关的参数。
1528
+ * @order 7
1529
+ * @return 视频采集参数配置对象,详情请参见 [VeLiveVideoCaptureConfiguration](#VeLivePusherDef-VeLiveVideoCaptureConfiguration)。
1530
+ *
1531
+ */
893
1532
  /** {en}
894
1533
  * @platform android
895
1534
  * @detail api
@@ -899,7 +1538,15 @@ export declare class VeLivePusherConfiguration {
899
1538
  *
900
1539
  */
901
1540
  android_getVideoCaptureConfig(): $p_a.VeLiveVideoCaptureConfiguration;
902
-
1541
+ /** {zh}
1542
+ * @platform android
1543
+ * @detail api
1544
+ * @brief 设置音频采集参数,用于调整和设置音频采集相关的参数。
1545
+ * @order 7
1546
+ * @param config 音频采集参数,详情请参见 [VeLiveAudioCaptureConfiguration](#VeLivePusherDef-VeLiveAudioCaptureConfiguration)。
1547
+ * @return 推流引擎初始化配置对象,详情请参见 [VeLiveAudioCaptureConfiguration](#VeLivePusherDef-VeLiveAudioCaptureConfiguration)。
1548
+ *
1549
+ */
903
1550
  /** {en}
904
1551
  * @platform android
905
1552
  * @detail api
@@ -910,7 +1557,14 @@ export declare class VeLivePusherConfiguration {
910
1557
  *
911
1558
  */
912
1559
  android_setAudioCaptureConfig(config: $p_a.VeLiveAudioCaptureConfiguration): this;
913
-
1560
+ /** {zh}
1561
+ * @platform android
1562
+ * @detail api
1563
+ * @brief 获取音频采集参数,用于调整和设置音频采集相关的参数。
1564
+ * @order 8
1565
+ * @return 音频采集参数配置对象,详情请参见 [VeLiveAudioCaptureConfiguration](#VeLivePusherDef-VeLiveAudioCaptureConfiguration)。
1566
+ *
1567
+ */
914
1568
  /** {en}
915
1569
  * @platform android
916
1570
  * @detail api
@@ -920,7 +1574,15 @@ export declare class VeLivePusherConfiguration {
920
1574
  *
921
1575
  */
922
1576
  android_getAudioCaptureConfig(): $p_a.VeLiveAudioCaptureConfiguration;
923
-
1577
+ /** {zh}
1578
+ * @platform android
1579
+ * @detail api
1580
+ * @brief 设置应用上下文。
1581
+ * @order 9
1582
+ * @param context 应用上下文。
1583
+ * @return 推流引擎初始化配置对象,详情请参见 [VeLivePusherConfiguration](#VeLivePusherConfiguration)。
1584
+ *
1585
+ */
924
1586
  /** {en}
925
1587
  * @platform android
926
1588
  * @detail api
@@ -931,7 +1593,15 @@ export declare class VeLivePusherConfiguration {
931
1593
  *
932
1594
  */
933
1595
  android_setContext(context: $p_a.Context): this;
934
-
1596
+ /** {zh}
1597
+ * @platform android
1598
+ * @detail api
1599
+ * @brief 获取应用上下文。
1600
+ * @order 10
1601
+ * @return <br>
1602
+ * 应用上下文。
1603
+ *
1604
+ */
935
1605
  /** {en}
936
1606
  * @platform android
937
1607
  * @detail api
@@ -942,7 +1612,16 @@ export declare class VeLivePusherConfiguration {
942
1612
  *
943
1613
  */
944
1614
  android_getContext(): $p_a.Context;
945
-
1615
+ /** {zh}
1616
+ * @platform android
1617
+ * @detail api
1618
+ * @brief 设置扩展参数,默认不需要设置。如果需要使用,您可通过提交工单联系[技术支持](https://console.volcengine.com/workorder/create?step=3&SubProductID=P00000076)。
1619
+ * @order 11
1620
+ * @param params 扩展参数。
1621
+ * @return
1622
+ * 推流引擎初始化配置对象,详情请参见 [VeLivePusherConfiguration](#VeLivePusherConfiguration)。
1623
+ *
1624
+ */
946
1625
  /** {en}
947
1626
  * @platform android
948
1627
  * @detail api
@@ -953,7 +1632,15 @@ export declare class VeLivePusherConfiguration {
953
1632
  *
954
1633
  */
955
1634
  android_setExtraParameters(params: string): this;
956
-
1635
+ /** {zh}
1636
+ * @platform android
1637
+ * @detail api
1638
+ * @brief 获取扩展参数。
1639
+ * @order 12
1640
+ * @return <br>
1641
+ * 扩展参数。
1642
+ *
1643
+ */
957
1644
  /** {en}
958
1645
  * @platform android
959
1646
  * @detail api
@@ -964,7 +1651,14 @@ export declare class VeLivePusherConfiguration {
964
1651
  *
965
1652
  */
966
1653
  android_getExtraParams(): $p_a.LiveSdkSetting;
967
-
1654
+ /** {zh}
1655
+ * @platform android
1656
+ * @detail api
1657
+ * @brief 构造推流引擎。
1658
+ * @order 1
1659
+ * @return 推流引擎,详情请参见 [VeLivePusher](147517#VeLivePusher)。
1660
+ *
1661
+ */
968
1662
  /** {en}
969
1663
  * @platform android
970
1664
  * @detail api
@@ -975,12 +1669,24 @@ export declare class VeLivePusherConfiguration {
975
1669
  */
976
1670
  android_build(): $p_a.VeLivePusher;
977
1671
  }
978
-
1672
+ /** {zh}
1673
+ * @detail api
1674
+ * @brief 相机设备管理对象。
1675
+ */
979
1676
  export declare class VeLiveCameraDevice {
980
1677
  protected _instance: any;
981
1678
  protected __init(...args: any[]): void;
982
1679
  protected __new_instance(...args: any[]): any;
983
-
1680
+ /** {zh}
1681
+ * @platform android
1682
+ * @detail api
1683
+ * @brief 获取相机支持帧率范围。
1684
+ * @notes <br>需要在调用 [startVideoCapture](#VeLivePusher-startvideocapture) 启动相机采集后,调用本方法。
1685
+ * @order 3
1686
+ * @return <br>
1687
+ * 相机支持帧率范围。
1688
+ *
1689
+ */
984
1690
  /** {en}
985
1691
  * @platform android
986
1692
  * @detail api
@@ -992,7 +1698,19 @@ export declare class VeLiveCameraDevice {
992
1698
  *
993
1699
  */
994
1700
  android_getRealFpsRange(): Array<$p_a.int>;
995
-
1701
+ /** {zh}
1702
+ * @detail api
1703
+ * @brief 开启/关闭闪光灯。
1704
+ * @notes <br>需要在调用 [startVideoCapture](#VeLivePusher-startvideocapture) 启动相机采集后,调用本方法。
1705
+ * @order 8
1706
+ * @param enable 是否开启闪光灯。默认为 false。 <br>
1707
+ * - true:开启;
1708
+ * - false:关闭。
1709
+ * @return <br>
1710
+ * - 0:开启/关闭成功;
1711
+ * - ≠0:开启/关闭失败。
1712
+ *
1713
+ */
996
1714
  /** {en}
997
1715
  * @detail api
998
1716
  * @brief Enables or disables the flashlight.
@@ -1007,7 +1725,17 @@ export declare class VeLiveCameraDevice {
1007
1725
  *
1008
1726
  */
1009
1727
  enableTorch(enable: boolean): number;
1010
-
1728
+ /** {zh}
1729
+ * @detail api
1730
+ * @brief 设置摄像头的缩放倍数。
1731
+ * @notes <br>需要在调用 [startVideoCapture](#VeLivePusher-startvideocapture) 启动相机采集后,调用本方法。
1732
+ * @order 5
1733
+ * @param ratio 缩放倍数。默认为原尺寸。缩放倍数的取值范围为 [[getMinZoomRatio](#VeLiveCameraDevice-getminzoomratio),[getMaxZoomRatio](#VeLiveCameraDevice-getmaxzoomratio)]。
1734
+ * @return <br>
1735
+ * - 0:缩放成功;
1736
+ * - ≠0:缩放失败。
1737
+ *
1738
+ */
1011
1739
  /** {en}
1012
1740
  * @detail api
1013
1741
  * @brief Sets the zoom factor of the camera.
@@ -1020,7 +1748,16 @@ export declare class VeLiveCameraDevice {
1020
1748
  *
1021
1749
  */
1022
1750
  setZoomRatio(ratio: number): number;
1023
-
1751
+ /** {zh}
1752
+ * @detail api
1753
+ * @brief 获取摄像头当前的缩放倍数。
1754
+ * @notes <br>需要在调用 [startVideoCapture](#VeLivePusher-startvideocapture) 启动相机采集后,调用本方法。
1755
+ * @order 4
1756
+ * @return <br>
1757
+ * - ≤0:表示不支持缩放;
1758
+ * - >0:支持缩放,数值表示当前缩放倍数。
1759
+ *
1760
+ */
1024
1761
  /** {en}
1025
1762
  * @detail api
1026
1763
  * @brief Gets the current zoom factor of the camera.
@@ -1032,7 +1769,16 @@ export declare class VeLiveCameraDevice {
1032
1769
  *
1033
1770
  */
1034
1771
  getCurrentZoomRatio(): number;
1035
-
1772
+ /** {zh}
1773
+ * @detail api
1774
+ * @brief 获取摄像头的最大缩放倍数。
1775
+ * @notes <br>需要在调用 [startVideoCapture](#VeLivePusher-startvideocapture) 启动相机采集后,调用本方法。
1776
+ * @order 6
1777
+ * @return <br>
1778
+ * - ≤0:表示不支持缩放;
1779
+ * - >0:支持缩放,数值表示最大缩放倍数。
1780
+ *
1781
+ */
1036
1782
  /** {en}
1037
1783
  * @detail api
1038
1784
  * @brief Gets the maximum zoom factor of the camera.
@@ -1044,7 +1790,16 @@ export declare class VeLiveCameraDevice {
1044
1790
  *
1045
1791
  */
1046
1792
  getMaxZoomRatio(): number;
1047
-
1793
+ /** {zh}
1794
+ * @detail api
1795
+ * @brief 获取摄像头的最小缩放倍数。
1796
+ * @notes <br>需要在调用 [startVideoCapture](#VeLivePusher-startvideocapture) 启动相机采集后,调用本方法。
1797
+ * @order 7
1798
+ * @return <br>
1799
+ * - ≤0:表示不支持缩放;
1800
+ * - >0:支持缩放,数值表示最小缩放倍数。
1801
+ *
1802
+ */
1048
1803
  /** {en}
1049
1804
  * @detail api
1050
1805
  * @brief Gets the minimum zoom factor of the camera.
@@ -1056,7 +1811,16 @@ export declare class VeLiveCameraDevice {
1056
1811
  *
1057
1812
  */
1058
1813
  getMinZoomRatio(): number;
1059
-
1814
+ /** {zh}
1815
+ * @detail api
1816
+ * @brief 是否支持自动对焦。
1817
+ * @notes <br>需要在调用 [startVideoCapture](#VeLivePusher-startvideocapture) 启动相机采集后,调用本方法。
1818
+ * @order 9
1819
+ * @return <br>
1820
+ * - true:支持;
1821
+ * - false:不支持。
1822
+ *
1823
+ */
1060
1824
  /** {en}
1061
1825
  * @detail api
1062
1826
  * @brief Checks whether autofocus is supported.
@@ -1068,7 +1832,19 @@ export declare class VeLiveCameraDevice {
1068
1832
  *
1069
1833
  */
1070
1834
  isAutoFocusEnabled(): boolean;
1071
-
1835
+ /** {zh}
1836
+ * @detail api
1837
+ * @brief 开启/关闭自动对焦功能。
1838
+ * @notes <br>需要在调用 [startVideoCapture](#VeLivePusher-startvideocapture) 启动相机采集后,调用本方法。
1839
+ * @order 10
1840
+ * @param enable 是否开启自动对焦,默认为 true。
1841
+ * - true:开启;
1842
+ * - false:关闭。
1843
+ * @return <br>
1844
+ * - 0:开启/关闭成功;
1845
+ * - ≠0:开启/关闭失败。
1846
+ *
1847
+ */
1072
1848
  /** {en}
1073
1849
  * @detail api
1074
1850
  * @brief Enables or disables autofocus.
@@ -1083,7 +1859,20 @@ export declare class VeLiveCameraDevice {
1083
1859
  *
1084
1860
  */
1085
1861
  enableAutoFocus(enable: boolean): number;
1086
-
1862
+ /** {zh}
1863
+ * @detail api
1864
+ * @brief 设置摄像头的对焦位置。
1865
+ * @notes 需要在调用 [startVideoCapture](#VeLivePusher-startvideocapture) 启动相机采集后,调用本方法。
1866
+ * @order 11
1867
+ * @param viewW 当前视图宽度。
1868
+ * @param viewH 当前视图高度。
1869
+ * @param x 以左上角为原点,对焦点距当前视图的横向坐标值。
1870
+ * @param y 以左上角为原点,对焦点距当前视图的纵向坐标值。
1871
+ * @return <br>
1872
+ * - 0:设置成功;
1873
+ * - ≠0:设置失败。
1874
+ *
1875
+ */
1087
1876
  /** {en}
1088
1877
  * @detail api
1089
1878
  * @brief Sets the focus position of the camera.
@@ -1099,7 +1888,15 @@ export declare class VeLiveCameraDevice {
1099
1888
  *
1100
1889
  */
1101
1890
  setFocusPosition(viewW: number, viewH: number, x: number, y: number): number;
1102
-
1891
+ /** {zh}
1892
+ * @detail api
1893
+ * @brief 检查当前使用的摄像头是否支持手动设置曝光点。
1894
+ * @notes 必须已调用 [startVideoCapture](#VeLivePusher-startvideocapture) 使用 SDK 内部采集模块进行视频采集时,才能检查曝光点设置能力。
1895
+ * @order 12
1896
+ * @return - YES:支持;
1897
+ * - NO:不支持。
1898
+ *
1899
+ */
1103
1900
  /** {en}
1104
1901
  * @detail api
1105
1902
  * @brief Checks if manual exposure setting is available for the currently used camera.
@@ -1110,7 +1907,20 @@ export declare class VeLiveCameraDevice {
1110
1907
  *
1111
1908
  */
1112
1909
  isExposurePositionSupported(): boolean;
1113
-
1910
+ /** {zh}
1911
+ * @detail api
1912
+ * @brief 设置当前使用的摄像头的曝光点。
1913
+ * @notes - 必须已调用 [startVideoCapture](#VeLivePusher-startvideocapture) 使用 SDK 内部采集模块进行视频采集,并且使用 SDK 内部渲染时,才能设置曝光点;
1914
+ * - 调用 [stopVideoCapture](#VeLivePusher-stopvideocapture) 关闭内部采集后,设置的曝光点失效。
1915
+ * @order 13
1916
+ * @param viewW 当前视图宽度。
1917
+ * @param viewH 当前视图高度。
1918
+ * @param x 以左上角为原点,对焦点距当前视图的横向坐标值。
1919
+ * @param y 以左上角为原点,对焦点距当前视图的纵向坐标值。
1920
+ * @return - =0:成功;
1921
+ * - ≠0:失败。
1922
+ *
1923
+ */
1114
1924
  /** {en}
1115
1925
  * @detail api
1116
1926
  * @brief Sets the manual exposure position for the currently used camera.
@@ -1126,7 +1936,15 @@ export declare class VeLiveCameraDevice {
1126
1936
  *
1127
1937
  */
1128
1938
  setExposurePosition(viewW: number, viewH: number, x: number, y: number): number;
1129
-
1939
+ /** {zh}
1940
+ * @detail api
1941
+ * @brief 获取摄像头的最小曝光补偿值。
1942
+ * @notes 需要在调用 [startVideoCapture](#VeLivePusher-startvideocapture) 启动相机采集后,调用本方法。
1943
+ * @order 14
1944
+ * @return - ≤0:表示不支持曝光补偿;
1945
+ * - >0:支持曝光补偿,数值表示最小曝光补偿。
1946
+ *
1947
+ */
1130
1948
  /** {en}
1131
1949
  * @detail api
1132
1950
  * @brief Gets the minimum exposure compensation of the camera.
@@ -1137,7 +1955,15 @@ export declare class VeLiveCameraDevice {
1137
1955
  *
1138
1956
  */
1139
1957
  getMinExposureCompensation(): number;
1140
-
1958
+ /** {zh}
1959
+ * @detail api
1960
+ * @brief 获取摄像头的最大曝光补偿值。
1961
+ * @notes 需要在调用 [startVideoCapture](#VeLivePusher-startvideocapture) 启动相机采集后,调用本方法。
1962
+ * @order 15
1963
+ * @return - ≤0:表示不支持曝光补偿;
1964
+ * - >0:支持曝光补偿,数值表示最大曝光补偿。
1965
+ *
1966
+ */
1141
1967
  /** {en}
1142
1968
  * @detail api
1143
1969
  * @brief Gets the maximum exposure compensation of the camera.
@@ -1148,7 +1974,17 @@ export declare class VeLiveCameraDevice {
1148
1974
  *
1149
1975
  */
1150
1976
  getMaxExposureCompensation(): number;
1151
-
1977
+ /** {zh}
1978
+ * @detail api
1979
+ * @brief 设置当前使用的摄像头的曝光补偿。
1980
+ * @notes - 必须已调用 [startVideoCapture](#VeLivePusher-startvideocapture) 使用 SDK 内部采集模块进行视频采集时,才能设置曝光补偿。
1981
+ * - 调用 [stopVideoCapture](#VeLivePusher-stopvideocapture) 关闭内部采集后,设置的曝光补偿失效。
1982
+ * @order 16
1983
+ * @param value 曝光补偿值,取值范围 [[getMinExposureCompensation](#VeLiveCameraDevice-getminexposurecompensation),[getMaxExposureCompensation](#VeLiveCameraDevice-getmaxexposurecompensation)],0 为系统默认值,表示没有曝光补偿。
1984
+ * @return - =0:设置成功;
1985
+ * - ≠0:设置失败。
1986
+ *
1987
+ */
1152
1988
  /** {en}
1153
1989
  * @detail api
1154
1990
  * @brief Sets the exposure compensation for the currently used camera.
@@ -1162,7 +1998,16 @@ export declare class VeLiveCameraDevice {
1162
1998
  *
1163
1999
  */
1164
2000
  setExposureCompensation(value: number): number;
1165
-
2001
+ /** {zh}
2002
+ * @platform ios
2003
+ * @detail api
2004
+ * @brief 是否支持闪光灯。
2005
+ * @notes 需要在调用 [startVideoCapture:](#VeLivePusher-startvideocapture) 启动相机采集后,调用本方法。
2006
+ * @order 49
2007
+ * @return <br>
2008
+ * - YES:支持;
2009
+ * - NO:不支持。
2010
+ */
1166
2011
  /** {en}
1167
2012
  * @platform ios
1168
2013
  * @detail api
@@ -1173,7 +2018,14 @@ export declare class VeLiveCameraDevice {
1173
2018
  * - NO: Not supported.
1174
2019
  */
1175
2020
  ios_isTorchSupported(): boolean;
1176
-
2021
+ /** {zh}
2022
+ * @platform ios
2023
+ * @detail api
2024
+ * @brief 设置相机参数。
2025
+ * @notes 需要在调用 [startVideoCapture:](#VeLivePusher-startvideocapture) 启动相机采集后,调用本方法。
2026
+ * @order 64
2027
+ * @param parameter 相机参数字典,包含要设置的参数名称(键)和对应的值
2028
+ */
1177
2029
  /** {en}
1178
2030
  * @platform ios
1179
2031
  * @detail api
@@ -1183,7 +2035,16 @@ export declare class VeLiveCameraDevice {
1183
2035
  * @param parameter The parameter name (key) and the corresponding value.
1184
2036
  */
1185
2037
  ios_setParameter(parameter: $p_i.NSDictionary): void;
1186
-
2038
+ /** {zh}
2039
+ * @platform ios
2040
+ * @detail api
2041
+ * @brief 获取相机参数。
2042
+ * @notes 需要在调用 [startVideoCapture:](#VeLivePusher-startvideocapture) 启动相机采集后,调用本方法。
2043
+ * @order 65
2044
+ * @param key 需要获取的相机参数的名称。
2045
+ * @return <br>
2046
+ * 相机参数的值,具体类型需要根据参数名称确定。
2047
+ */
1187
2048
  /** {en}
1188
2049
  * @platform ios
1189
2050
  * @detail api
@@ -1196,12 +2057,24 @@ export declare class VeLiveCameraDevice {
1196
2057
  */
1197
2058
  ios_getParameter(key: string): $p_i.id;
1198
2059
  }
1199
-
2060
+ /** {zh}
2061
+ * @detail api
2062
+ * @brief 视频特效管理对象。用于管理和设置视频特效,包括美颜、美形、美体、美妆、滤镜等。
2063
+ */
1200
2064
  export declare class VeLiveVideoEffectManager {
1201
2065
  protected _instance: any;
1202
2066
  protected __init(...args: any[]): void;
1203
2067
  protected __new_instance(...args: any[]): any;
1204
-
2068
+ /** {zh}
2069
+ * @detail api
2070
+ * @brief 视频特效许可证配置,用于初始化视频特效管理对象。
2071
+ * @order 89
2072
+ * @param config 特效初始化配置,详情请参见 [VeLiveVideoEffectLicenseConfiguration](147521#VeLivePusherDef-VeLiveVideoEffectLicenseConfiguration)。
2073
+ * @return <br>
2074
+ * - 0:调用成功;
2075
+ * - -1:调用失败。
2076
+ *
2077
+ */
1205
2078
  /** {en}
1206
2079
  * @detail api
1207
2080
  * @brief Initializes the special effects manager.
@@ -1213,7 +2086,15 @@ export declare class VeLiveVideoEffectManager {
1213
2086
  *
1214
2087
  */
1215
2088
  setupWithConfig(config: VeLiveVideoEffectLicenseConfiguration): number;
1216
-
2089
+ /** {zh}
2090
+ * @detail api
2091
+ * @brief 如果您使用在线 License 认证方式,在许可证过期后,可调用该方法更新 License;
2092
+ * @notes - 需要通过调用 [setupWithConfig](#VeLiveVideoEffectManager-setupwithconfig) 设置视频特效许可证后调用;
2093
+ * - 本方法为异步操作。
2094
+ * @order 90
2095
+ * @param callback 结果回调信息
2096
+ *
2097
+ */
1217
2098
  /** {en}
1218
2099
  * @detail api
1219
2100
  * @brief Updates the special effects license. This method is effective only if you authenticate the license online.
@@ -1225,7 +2106,22 @@ export declare class VeLiveVideoEffectManager {
1225
2106
  *
1226
2107
  */
1227
2108
  updateLicense(callback: (result: number, message: string) => void): void;
1228
-
2109
+ /** {zh}
2110
+ * @detail api
2111
+ * @brief 创建/销毁特效引擎。
2112
+ * @notes - 该方法需要在调用 [setupWithConfig](#VeLiveVideoEffectManager-setupwithconfig) 和 [setAlgorithmModelPath](#VeLiveVideoEffectManager-setalgorithmmodelpath) 后调用;
2113
+ * - 该方法不直接开启/关闭视频特效,您需要在调用该方法后,调用 [setComposeNodes](#VeLiveVideoEffectManager-setcomposenodes) 开启视频特效;
2114
+ * - 通用场景下,特效引擎会随 EffectManager 销毁而销毁。如果您对性能有较高要求,也可以在不使用特效相关功能时,调用该方法销毁特效引擎;
2115
+ * - 如果重复创建/销毁特效引擎,会产生时间消耗。
2116
+ * @order 92
2117
+ * @param enable 是否创建特效引擎。默认为 false。 <br>
2118
+ * - true:创建;
2119
+ * - false:销毁。
2120
+ * @param callback 视频特效回调 [VeLiveVideoEffectCallback](147519#VeLivePusherDef-VeLiveVideoEffectCallback)。
2121
+ * @return - 0:成功;
2122
+ * - -1:失败。
2123
+ *
2124
+ */
1229
2125
  /** {en}
1230
2126
  * @detail api
1231
2127
  * @brief Creates or destroys the special effects engine.
@@ -1245,7 +2141,18 @@ export declare class VeLiveVideoEffectManager {
1245
2141
  *
1246
2142
  */
1247
2143
  setEnable(enable: boolean, callback: (result: number, msg: string) => void): void;
1248
-
2144
+ /** {zh}
2145
+ * @platform android
2146
+ * @detail api
2147
+ * @brief 设置特效算法模型包的路径。
2148
+ * @notes <br>需要通过调用 [setupWithConfig](#VeLiveVideoEffectManager-setupwithconfig) 设置视频特效许可证后调用。
2149
+ * @order 91
2150
+ * @param path 特效算法模型包的路径
2151
+ * @return <br>
2152
+ * - 0:调用成功;
2153
+ * - -1:调用失败。
2154
+ *
2155
+ */
1249
2156
  /** {en}
1250
2157
  * @platform android
1251
2158
  * @detail api
@@ -1260,7 +2167,20 @@ export declare class VeLiveVideoEffectManager {
1260
2167
  *
1261
2168
  */
1262
2169
  android_setAlgorithmModelPath(path: string): number;
1263
-
2170
+ /** {zh}
2171
+ * @detail api
2172
+ * @brief 设置视频特效组合。支持设置 ComposeMakeup.bundle 中的功能,包括美颜、美形、美体、美妆等。
2173
+ * @notes <br>
2174
+ * - 需要在调用 [setEnable](#VeLiveVideoEffectManager-setenable) 创建特效引擎后,调用本方法;
2175
+ * - 重复调用本方法,仅最后一次调用生效;
2176
+ * - 如果需要在当前的视频特效组合中叠加特效,可调用 [appendComposeNodes](#VeLiveVideoEffectManager-appendcomposenodes) 方法。
2177
+ * @order 93
2178
+ * @param nodes 视频特效素材包路径数组
2179
+ * @return <br>
2180
+ * - 0:调用成功;
2181
+ * - -1:调用失败。
2182
+ *
2183
+ */
1264
2184
  /** {en}
1265
2185
  * @detail api
1266
2186
  * @brief Sets the special effects you want to apply to the video. You can choose effects from ComposeMakeup.bundle.
@@ -1276,7 +2196,17 @@ export declare class VeLiveVideoEffectManager {
1276
2196
  *
1277
2197
  */
1278
2198
  setComposeNodes(nodes: Array<string>): number;
1279
-
2199
+ /** {zh}
2200
+ * @detail api
2201
+ * @brief 在已有的视频特效组合上,叠加视频特效素材包,您可以调用 [setComposeNodes](#VeLiveVideoEffectManager-setcomposenodes) 设置视频特效组合。
2202
+ * @notes 需要在调用 [setEnable](#VeLiveVideoEffectManager-setenable) 创建特效引擎后,调用本方法。
2203
+ * @order 94
2204
+ * @param nodes 视频特效素材包路径数组
2205
+ * @return <br>
2206
+ * - 0:调用成功;
2207
+ * - -1:调用失败。
2208
+ *
2209
+ */
1280
2210
  /** {en}
1281
2211
  * @detail api
1282
2212
  * @brief Adds one or more effects to the existing effects settings that you have configured by calling setComposeNodes {@link #VeLiveVideoEffectManager#setComposeNodes}.
@@ -1289,7 +2219,17 @@ export declare class VeLiveVideoEffectManager {
1289
2219
  *
1290
2220
  */
1291
2221
  appendComposeNodes(nodes: Array<string>): number;
1292
-
2222
+ /** {zh}
2223
+ * @detail api
2224
+ * @brief 调用本方法,可移除调用 [setComposeNodes](#VeLiveVideoEffectManager-setcomposenodes) 和 [appendComposeNodes](#VeLiveVideoEffectManager-appendcomposenodes) 设置的视频特效资源。
2225
+ * @notes 需要在调用 [setEnable](#VeLiveVideoEffectManager-setenable) 创建特效引擎后,调用本方法。
2226
+ * @order 94
2227
+ * @param nodes 视频特效素材包路径数组
2228
+ * @return <br>
2229
+ * - 0:调用成功;
2230
+ * - -1:调用失败。
2231
+ *
2232
+ */
1293
2233
  /** {en}
1294
2234
  * @detail api
1295
2235
  * @brief Removes one or more special effects resource set by the [setComposeNodes](#VeLiveVideoEffectManager-setcomposenodes) or [appendComposeNodes](#VeLiveVideoEffectManager-appendcomposenodes) methods.
@@ -1302,7 +2242,21 @@ export declare class VeLiveVideoEffectManager {
1302
2242
  *
1303
2243
  */
1304
2244
  removeComposeNodes(nodes: Array<string>): number;
1305
-
2245
+ /** {zh}
2246
+ * @detail api
2247
+ * @brief 设置视频特效强度。
2248
+ * @notes <br>
2249
+ * - 需要在调用 [setComposeNodes](#VeLiveVideoEffectManager-setcomposenodes) 设置视频特效组合或调用 [appendComposeNodes](#VeLiveVideoEffectManager-appendcomposenodes) 叠加视频特效素材包后,调用本方法;
2250
+ * - 该方法仅适用于同时含有上述三个参数的特效资源,对于没有强度参数的特效(如贴纸),该方法无效。
2251
+ * @order 95
2252
+ * @param node 视频特效素材包路径
2253
+ * @param key 需要设置的素材 key 名称
2254
+ * @param intensity 需要设置的强度值。取值范围为 [0.0,1.0]
2255
+ * @return <br>
2256
+ * - 0:调用成功;
2257
+ * - -1:调用失败。
2258
+ *
2259
+ */
1306
2260
  /** {en}
1307
2261
  * @detail api
1308
2262
  * @brief Sets the intensity of a special effect.
@@ -1319,7 +2273,17 @@ export declare class VeLiveVideoEffectManager {
1319
2273
  *
1320
2274
  */
1321
2275
  updateComposerNodeIntensity(node: string, key: string, intensity: number): number;
1322
-
2276
+ /** {zh}
2277
+ * @detail api
2278
+ * @brief 设置颜色滤镜。
2279
+ * @notes <br>请在调用 [setEnable](#VeLiveVideoEffectManager-setenable) 开启视频特效后,调用该方法。
2280
+ * @order 96
2281
+ * @param path 滤镜资源包绝对路径
2282
+ * @return <br>
2283
+ * - 0:调用成功;
2284
+ * - -1:调用失败。
2285
+ *
2286
+ */
1323
2287
  /** {en}
1324
2288
  * @detail api
1325
2289
  * @brief Sets the color filter.
@@ -1333,7 +2297,16 @@ export declare class VeLiveVideoEffectManager {
1333
2297
  *
1334
2298
  */
1335
2299
  setFilter(path: string): number;
1336
-
2300
+ /** {zh}
2301
+ * @detail api
2302
+ * @brief 设置已启用的颜色滤镜强度。
2303
+ * @notes <br>请在调用 [setFilter](#VeLiveVideoEffectManager-setfilter) 设置颜色滤镜后调用。
2304
+ * @order 97
2305
+ * @param intensity 滤镜强度,取值范围为 [0.0,1.0]。
2306
+ * @return - 0:调用成功;
2307
+ * - -1:调用失败。
2308
+ *
2309
+ */
1337
2310
  /** {en}
1338
2311
  * @detail api
1339
2312
  * @brief Sets the intensity of the color filter.
@@ -1346,7 +2319,17 @@ export declare class VeLiveVideoEffectManager {
1346
2319
  *
1347
2320
  */
1348
2321
  updateFilterIntensity(intensity: number): number;
1349
-
2322
+ /** {zh}
2323
+ * @detail api
2324
+ * @brief 设置贴纸特效。
2325
+ * @notes <br>请在调用 [setEnable](#VeLiveVideoEffectManager-setenable) 开启视频特效后,调用该方法。
2326
+ * @order 98
2327
+ * @param path 贴纸素材包的绝对路径
2328
+ * @return <br>
2329
+ * - 0:调用成功;
2330
+ * - -1:调用失败。
2331
+ *
2332
+ */
1350
2333
  /** {en}
1351
2334
  * @detail api
1352
2335
  * @brief Sets the sticker.
@@ -1360,7 +2343,16 @@ export declare class VeLiveVideoEffectManager {
1360
2343
  *
1361
2344
  */
1362
2345
  setSticker(path: string): number;
1363
-
2346
+ /** {zh}
2347
+ * @detail api
2348
+ * @brief 智能美化特效的高级功能。
2349
+ * @notes 请在调用 [setEnable](#VeLiveVideoEffectManager-setenable) 开启视频特效后,调用该方法,不要在主线程中频繁执行同步操作。
2350
+ * @order 99
2351
+ * @param callback 将 handle 作为参数的回调函数。
2352
+ * @param isGLThread 是否在 GL 线程回调 callback。
2353
+ * @param isAsync 是否同步执行 callback。
2354
+ *
2355
+ */
1364
2356
  /** {en}
1365
2357
  * @detail api
1366
2358
  * @brief Advanced functions of BytePlus Effects.
@@ -1373,7 +2365,18 @@ export declare class VeLiveVideoEffectManager {
1373
2365
  *
1374
2366
  */
1375
2367
  setAdvancedFeature(callback: (handle: void) => void, isGLThread: boolean, isAsync: boolean): number;
1376
-
2368
+ /** {zh}
2369
+ * @platform ios
2370
+ * @detail api
2371
+ * @brief 设置特效算法模型包的路径。
2372
+ * @notes <br>
2373
+ * 需要通过调用 setupWithConfig:{@link #VeLiveVideoEffectManager#setupWithConfig} 设置视频特效许可证后调用。
2374
+ * @order 4
2375
+ * @param path 特效算法模型包的路径。
2376
+ * @return <br>
2377
+ * - 0:调用成功;
2378
+ * - -1:调用失败。
2379
+ */
1377
2380
  /** {en}
1378
2381
  * @platform ios
1379
2382
  * @detail api
@@ -1388,12 +2391,21 @@ export declare class VeLiveVideoEffectManager {
1388
2391
  */
1389
2392
  ios_setAlgoModelPath(path: string): number;
1390
2393
  }
1391
-
2394
+ /** {zh}
2395
+ * @detail api
2396
+ * @brief 音频设备管理类。该类提供了用于管理和控制音频设备,包括设置音量、获取当前音量的方法。
2397
+ */
1392
2398
  export declare class VeLiveAudioDevice {
1393
2399
  protected _instance: any;
1394
2400
  protected __init(...args: any[]): void;
1395
2401
  protected __new_instance(...args: any[]): any;
1396
-
2402
+ /** {zh}
2403
+ * @detail api
2404
+ * @brief 设置音量响度。
2405
+ * @order 74
2406
+ * @param level 音量响度等级,取值范围为 [0.0,4.0]。
2407
+ *
2408
+ */
1397
2409
  /** {en}
1398
2410
  * @detail api
1399
2411
  * @brief Sets the volume.
@@ -1402,7 +2414,14 @@ export declare class VeLiveAudioDevice {
1402
2414
  *
1403
2415
  */
1404
2416
  setVoiceLoudness(level: number): void;
1405
-
2417
+ /** {zh}
2418
+ * @detail api
2419
+ * @brief 获取当前音量响度。
2420
+ * @order 75
2421
+ * @return <br>
2422
+ * 当前音量响度等级。
2423
+ *
2424
+ */
1406
2425
  /** {en}
1407
2426
  * @detail api
1408
2427
  * @brief Gets the current volume.
@@ -1412,7 +2431,15 @@ export declare class VeLiveAudioDevice {
1412
2431
  *
1413
2432
  */
1414
2433
  getVoiceLoudness(): number;
1415
-
2434
+ /** {zh}
2435
+ * @platform ios
2436
+ * @detail api
2437
+ * @brief 查询是否支持硬件耳返。
2438
+ * @return <br>
2439
+ * - YES:支持;
2440
+ * - NO:不支持。
2441
+ * @order 62
2442
+ */
1416
2443
  /** {en}
1417
2444
  * @platform ios
1418
2445
  * @detail api
@@ -1423,7 +2450,17 @@ export declare class VeLiveAudioDevice {
1423
2450
  * @order 62
1424
2451
  */
1425
2452
  ios_isSupportHardwareEcho(): boolean;
1426
-
2453
+ /** {zh}
2454
+ * @platform ios
2455
+ * @detail api
2456
+ * @brief 是否开启耳返功能。
2457
+ * @param enable 耳返功能开关。默认值为 NO。<br>
2458
+ * - YES:开启;
2459
+ * - NO:关闭。
2460
+ * @notes
2461
+ * 需要在调用 [startAudioCapture:](#VeLivePusher-startaudiocapture) 启动音频采集后,调用本方法。
2462
+ * @order 64
2463
+ */
1427
2464
  /** {en}
1428
2465
  * @platform ios
1429
2466
  * @detail api
@@ -1436,7 +2473,17 @@ export declare class VeLiveAudioDevice {
1436
2473
  * @order 64
1437
2474
  */
1438
2475
  ios_enableEcho(enable: boolean): void;
1439
-
2476
+ /** {zh}
2477
+ * @platform ios
2478
+ * @detail api
2479
+ * @brief 获取当前耳返开启状态。
2480
+ * @notes
2481
+ * 需要在调用 [startAudioCapture:](#VeLivePusher-startaudiocapture) 启动音频采集后,调用本方法。
2482
+ * @order 65
2483
+ * @return <br>
2484
+ * - YES:开启;
2485
+ * - NO:关闭。
2486
+ */
1440
2487
  /** {en}
1441
2488
  * @platform ios
1442
2489
  * @detail api