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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (54) hide show
  1. package/lib/commonjs/index.js +2 -2
  2. package/lib/commonjs/typescript/codegen/android/api.d.ts +93 -869
  3. package/lib/commonjs/typescript/codegen/android/callback.d.ts +31 -243
  4. package/lib/commonjs/typescript/codegen/android/errorcode.d.ts +15 -60
  5. package/lib/commonjs/typescript/codegen/android/keytype.d.ts +219 -1173
  6. package/lib/commonjs/typescript/codegen/ios/api.d.ts +102 -899
  7. package/lib/commonjs/typescript/codegen/ios/callback.d.ts +28 -162
  8. package/lib/commonjs/typescript/codegen/ios/errorcode.d.ts +25 -100
  9. package/lib/commonjs/typescript/codegen/ios/keytype.d.ts +180 -692
  10. package/lib/commonjs/typescript/codegen/pack/api.d.ts +133 -1180
  11. package/lib/commonjs/typescript/codegen/pack/callback.d.ts +35 -243
  12. package/lib/commonjs/typescript/codegen/pack/errorcode.d.ts +16 -69
  13. package/lib/commonjs/typescript/codegen/pack/keytype.d.ts +271 -1460
  14. package/lib/commonjs/typescript/core/api.d.ts +1 -8
  15. package/lib/commonjs/typescript/core/effect.d.ts +1 -5
  16. package/lib/module/index.js +2 -2
  17. package/lib/module/typescript/codegen/android/api.d.ts +93 -869
  18. package/lib/module/typescript/codegen/android/callback.d.ts +31 -243
  19. package/lib/module/typescript/codegen/android/errorcode.d.ts +15 -60
  20. package/lib/module/typescript/codegen/android/keytype.d.ts +219 -1173
  21. package/lib/module/typescript/codegen/ios/api.d.ts +102 -899
  22. package/lib/module/typescript/codegen/ios/callback.d.ts +28 -162
  23. package/lib/module/typescript/codegen/ios/errorcode.d.ts +25 -100
  24. package/lib/module/typescript/codegen/ios/keytype.d.ts +180 -692
  25. package/lib/module/typescript/codegen/pack/api.d.ts +133 -1180
  26. package/lib/module/typescript/codegen/pack/callback.d.ts +35 -243
  27. package/lib/module/typescript/codegen/pack/errorcode.d.ts +16 -69
  28. package/lib/module/typescript/codegen/pack/keytype.d.ts +271 -1460
  29. package/lib/module/typescript/core/api.d.ts +1 -8
  30. package/lib/module/typescript/core/effect.d.ts +1 -5
  31. package/lib/typescript/codegen/android/api.d.ts +93 -869
  32. package/lib/typescript/codegen/android/callback.d.ts +31 -243
  33. package/lib/typescript/codegen/android/errorcode.d.ts +15 -60
  34. package/lib/typescript/codegen/android/keytype.d.ts +219 -1173
  35. package/lib/typescript/codegen/ios/api.d.ts +102 -899
  36. package/lib/typescript/codegen/ios/callback.d.ts +28 -162
  37. package/lib/typescript/codegen/ios/errorcode.d.ts +25 -100
  38. package/lib/typescript/codegen/ios/keytype.d.ts +180 -692
  39. package/lib/typescript/codegen/pack/api.d.ts +133 -1180
  40. package/lib/typescript/codegen/pack/callback.d.ts +35 -243
  41. package/lib/typescript/codegen/pack/errorcode.d.ts +16 -69
  42. package/lib/typescript/codegen/pack/keytype.d.ts +271 -1460
  43. package/lib/typescript/core/api.d.ts +1 -8
  44. package/lib/typescript/core/effect.d.ts +1 -5
  45. package/package.json +1 -1
  46. package/lib/commonjs/typescript/core/logger.d.ts +0 -1
  47. package/lib/commonjs/typescript/platforms/android/AppLogWrapper.d.ts +0 -8
  48. package/lib/commonjs/typescript/platforms/ios/RangersAppLog.d.ts +0 -4
  49. package/lib/module/typescript/core/logger.d.ts +0 -1
  50. package/lib/module/typescript/platforms/android/AppLogWrapper.d.ts +0 -8
  51. package/lib/module/typescript/platforms/ios/RangersAppLog.d.ts +0 -4
  52. package/lib/typescript/core/logger.d.ts +0 -1
  53. package/lib/typescript/platforms/android/AppLogWrapper.d.ts +0 -8
  54. package/lib/typescript/platforms/ios/RangersAppLog.d.ts +0 -4
@@ -3,17 +3,7 @@ import { VeLiveFileRecorderConfiguration, VeLivePusherLogLevel, VeLivePusherConf
3
3
  import { VeLiveMediaPlayerListener, VeLiveMediaPlayerFrameListener, VeLivePusherObserver, VeLivePusherStatisticsObserver, VeLiveVideoFrameListener, VeLiveAudioFrameListener, VeLiveScreenCaptureStatusObserver, VeLiveFileRecordingListener, VeLiveVideoFrameFilter, VeLiveAudioFrameFilter, VeLiveSnapshotListener } from './callback';
4
4
  import { UIView } from './external';
5
5
  export declare class VeLiveFileRecorderManager {
6
- /** {zh}
7
- * @detail api
8
- * @brief 开始直播录制。
9
- * @notes - 请在调用 [startPush:](#VeLivePusher-startpush) 推流成功之后,调用该方法,直播过程中的音视频数据将保存到本地;
10
- * - 本方法为异步操作;
11
- * - 开始录制后,会触发 [onFileRecordingStarted](155319#VeLiveFileRecordingListener-onfilerecordingstarted) 回调消息;
12
- * - 录制出现错误,会触发 [onFileRecordingError:message:](155319#VeLiveFileRecordingListener-onfilerecordingerror-message) 回调消息。
13
- * @param path 录制文件保存路径,不能为空。
14
- * @param config 直播录制配置。详情请参见 [VeLiveFileRecorderConfiguration](155321#VeLiveFileRecorderConfiguration)。
15
- * @order 43
16
- */
6
+
17
7
  /** {en}
18
8
  * @detail api
19
9
  * @brief Start live recording.
@@ -26,15 +16,7 @@ export declare class VeLiveFileRecorderManager {
26
16
  * @order 43
27
17
  */
28
18
  startRecord(path: NSString, config: VeLiveFileRecorderConfiguration): void;
29
- /** {zh}
30
- * @detail api
31
- * @brief 停止本地直播录制。
32
- * @notes - 请在调用 [startRecord:config:](#VeLiveFileRecorderManager-startrecord-config) 成功开始录制之后,调用该方法;
33
- * - 本方法为异步操作;
34
- * - 停止录制,会触发 [onFileRecordingStopped](155319#VeLiveFileRecordingListener-onfilerecordingstopped) 回调消息;
35
- * - 录制出现错误,会触发 [onFileRecordingError:message:](155319#VeLiveFileRecordingListener-onfilerecordingerror-message) 回调消息。
36
- * @order 45
37
- */
19
+
38
20
  /** {en}
39
21
  * @detail api
40
22
  * @brief Stop local live recording.
@@ -48,15 +30,7 @@ export declare class VeLiveFileRecorderManager {
48
30
  init(): this;
49
31
  }
50
32
  export declare class VeLiveCameraDevice {
51
- /** {zh}
52
- * @detail api
53
- * @brief 是否支持闪光灯。
54
- * @notes 需要在调用 [startVideoCapture:](#VeLivePusher-startvideocapture) 启动相机采集后,调用本方法。
55
- * @order 49
56
- * @return <br>
57
- * - YES:支持;
58
- * - NO:不支持。
59
- */
33
+
60
34
  /** {en}
61
35
  * @detail api
62
36
  * @brief Checks whether flashlight is supported.
@@ -66,17 +40,7 @@ export declare class VeLiveCameraDevice {
66
40
  * - NO: Not supported.
67
41
  */
68
42
  isTorchSupported(): BOOL;
69
- /** {zh}
70
- * @detail api
71
- * @brief 开启/关闭闪光灯。
72
- * @notes 需要在调用 [startVideoCapture:](#VeLivePusher-startvideocapture) 启动相机采集后,调用本方法。
73
- * @order 51
74
- * @param enable 是否开启闪光灯。默认为 NO。 <br>
75
- * - YES:开启;
76
- * - NO:关闭。
77
- * @return - =0:开启/关闭成功;
78
- * - ≠0:开启/关闭失败。
79
- */
43
+
80
44
  /** {en}
81
45
  * @detail api
82
46
  * @brief Enables or disables the flashlight.
@@ -89,16 +53,7 @@ export declare class VeLiveCameraDevice {
89
53
  * - ≠ 0: Failure.
90
54
  */
91
55
  enableTorch(enable: BOOL): int;
92
- /** {zh}
93
- * @detail api
94
- * @brief 设置摄像头的缩放倍数。
95
- * @notes 需要在调用 [startVideoCapture:](#VeLivePusher-startvideocapture) 启动相机采集后,调用本方法。
96
- * @order 52
97
- * @param ratio 缩放倍数。默认为原尺寸,缩放倍数的取值范围为 [[getMinZoomRatio](#VeLiveCameraDevice-getminzoomratio),[getMaxZoomRatio](#VeLiveCameraDevice-getmaxzoomratio)]。
98
- * @return <br>
99
- * - =0:缩放成功;
100
- * - ≠0:缩放失败。
101
- */
56
+
102
57
  /** {en}
103
58
  * @detail api
104
59
  * @brief Sets the zoom factor of the camera.
@@ -109,14 +64,7 @@ export declare class VeLiveCameraDevice {
109
64
  * - ≠ 0: Failure.
110
65
  */
111
66
  setZoomRatio(ratio: float): int;
112
- /** {zh}
113
- * @detail api
114
- * @brief 获取摄像头当前的缩放倍数。
115
- * @notes 需要在调用 [startVideoCapture:](#VeLivePusher-startvideocapture) 启动相机采集后,调用本方法。
116
- * @order 53
117
- * @return - ≤0:表示不支持缩放;
118
- * - >0:支持缩放,数值表示当前缩放倍数。
119
- */
67
+
120
68
  /** {en}
121
69
  * @detail api
122
70
  * @brief Gets the current zoom factor of the camera.
@@ -126,15 +74,7 @@ export declare class VeLiveCameraDevice {
126
74
  * - >0: The zoom factor.
127
75
  */
128
76
  getCurrentZoomRatio(): float;
129
- /** {zh}
130
- * @detail api
131
- * @brief 获取摄像头的最大缩放倍数。
132
- * @notes 需要在调用 [startVideoCapture:](#VeLivePusher-startvideocapture) 启动相机采集后,调用本方法。
133
- * @order 54
134
- * @return <br>
135
- * - ≤0:表示不支持缩放;
136
- * - >0:支持缩放,数值表示最大缩放倍数。
137
- */
77
+
138
78
  /** {en}
139
79
  * @detail api
140
80
  * @brief Gets the maximum zoom factor of the camera.
@@ -144,15 +84,7 @@ export declare class VeLiveCameraDevice {
144
84
  * - >0: The maximum zoom factor.
145
85
  */
146
86
  getMaxZoomRatio(): float;
147
- /** {zh}
148
- * @detail api
149
- * @brief 获取摄像头的最小缩放倍数。
150
- * @notes 需要在调用 [startVideoCapture:](#VeLivePusher-startvideocapture) 启动相机采集后,调用本方法。
151
- * @order 55
152
- * @return <br>
153
- * - ≤0:表示不支持缩放;
154
- * - >0:支持缩放,数值表示最小缩放倍数。
155
- */
87
+
156
88
  /** {en}
157
89
  * @detail api
158
90
  * @brief Gets the minimum zoom factor of the camera.
@@ -162,15 +94,7 @@ export declare class VeLiveCameraDevice {
162
94
  * - >0: The minimum zoom factor.
163
95
  */
164
96
  getMinZoomRatio(): float;
165
- /** {zh}
166
- * @detail api
167
- * @brief 是否支持自动对焦。
168
- * @notes 需要在调用 [startVideoCapture:](#VeLivePusher-startvideocapture) 启动相机采集后,调用本方法。
169
- * @order 56
170
- * @return <br>
171
- * - YES:支持;
172
- * - NO:不支持。
173
- */
97
+
174
98
  /** {en}
175
99
  * @detail api
176
100
  * @brief Checks whether autofocus is supported.
@@ -180,18 +104,7 @@ export declare class VeLiveCameraDevice {
180
104
  * - NO: Not supported.
181
105
  */
182
106
  isAutoFocusEnabled(): BOOL;
183
- /** {zh}
184
- * @detail api
185
- * @brief 开启/关闭自动对焦功能。
186
- * @notes 需要在调用 [startVideoCapture:](#VeLivePusher-startvideocapture) 启动相机采集后,调用本方法。
187
- * @order 57
188
- * @param enable 是否开启自动对焦,默认为 YES。
189
- * - YES:开启;
190
- * - NO:关闭。
191
- * @return <br>
192
- * - =0:开启/关闭成功;
193
- * - ≠0:开启/关闭失败。
194
- */
107
+
195
108
  /** {en}
196
109
  * @detail api
197
110
  * @brief Enables or disables autofocus.
@@ -204,16 +117,7 @@ export declare class VeLiveCameraDevice {
204
117
  * - ≠0: Failure.
205
118
  */
206
119
  enableAutoFocus(enable: BOOL): int;
207
- /** {zh}
208
- * @detail api
209
- * @brief 设置摄像头的对焦位置。
210
- * @notes 需要在调用 [startVideoCapture:](#VeLivePusher-startvideocapture) 启动相机采集后,调用本方法。
211
- * @order 58
212
- * @param position 以左上角为原点,对焦点距当前视图的坐标值。
213
- * @return <br>
214
- * - =0:设置成功;
215
- * - ≠0:设置失败。
216
- */
120
+
217
121
  /** {en}
218
122
  * @detail api
219
123
  * @brief Sets the focus position of the camera.
@@ -225,15 +129,7 @@ export declare class VeLiveCameraDevice {
225
129
  * - ≠0: Failure.
226
130
  */
227
131
  setFocusPosition(position: CGPoint): int;
228
- /** {zh}
229
- * @detail api
230
- * @brief 检查当前使用的摄像头是否支持手动设置曝光点。
231
- * @notes 必须已调用 [startVideoCapture:](#VeLivePusher-startvideocapture) 使用 SDK 内部采集模块进行视频采集时,才能检查曝光点设置能力。
232
- * @order 59
233
- * @return <br>
234
- * - YES: 支持。 <br>
235
- * - NO: 不支持。
236
- */
132
+
237
133
  /** {en}
238
134
  * @detail api
239
135
  * @brief Checks if manual exposure setting is available for the currently used camera.
@@ -243,18 +139,7 @@ export declare class VeLiveCameraDevice {
243
139
  * - NO: Unavailable.
244
140
  */
245
141
  isExposurePositionSupported(): BOOL;
246
- /** {zh}
247
- * @detail api
248
- * @brief 设置当前使用的摄像头的曝光点。
249
- * @param position 曝光点坐标。以本地预览画布的左上为坐标原点,`position`的`x`字段为曝光点水平方向归一化坐标,`y`字段为曝光点垂直方向归一化坐标,取值范围为 [0, 1]。
250
- * @notes - 必须已调用 [startVideoCapture:](#VeLivePusher-startvideocapture) 使用 SDK 内部采集模块进行视频采集,并且使用 SDK 内部渲染时,才能设置曝光点。
251
- * - 曝光点设置为画布中央(即`x`和`y`均取 0.5)时,恢复系统默认值。
252
- * - 调用 [stopVideoCapture:](155318#VeLivePusher-stopvideocapture) 关闭内部采集后,设置的曝光点失效。
253
- * @order 60
254
- * @return <br>
255
- * - =0: 成功。
256
- * - ≠0: 失败。
257
- */
142
+
258
143
  /** {en}
259
144
  * @detail api
260
145
  * @brief Sets the manual exposure position for the currently used camera.
@@ -267,16 +152,7 @@ export declare class VeLiveCameraDevice {
267
152
  * - ≠0: Failure.
268
153
  */
269
154
  setExposurePosition(position: CGPoint): int;
270
- /** {zh}
271
- * @detail api
272
- * @brief 设置当前使用的摄像头的曝光补偿。
273
- * @notes - 必须已调用 [startVideoCapture:](#VeLivePusher-startvideocapture) 使用 SDK 内部采集模块进行视频采集时,才能设置曝光补偿。
274
- * - 调用 [stopVideoCapture:](#VeLivePusher-stopvideocapture) 关闭内部采集后,设置的曝光补偿失效。
275
- * @order 61
276
- * @param value 曝光补偿值,取值范围 [[getMinExposureCompensation](#VeLiveCameraDevice-getminexposurecompensation), [getMaxExposureCompensation](#VeLiveCameraDevice-getmaxexposurecompensation)],0 为系统默认值表示没有曝光补偿。
277
- * @return - =0:设置成功;
278
- * - ≠0:设置失败。
279
- */
155
+
280
156
  /** {en}
281
157
  * @detail api
282
158
  * @brief Sets the exposure compensation for the currently used camera.
@@ -288,15 +164,7 @@ export declare class VeLiveCameraDevice {
288
164
  * - ≠0: Failure.
289
165
  */
290
166
  setExposureCompensation(value: float): int;
291
- /** {zh}
292
- * @detail api
293
- * @brief 获取摄像头的最小曝光补偿。
294
- * @notes 需要在调用 [startVideoCapture:](#VeLivePusher-startvideocapture) 启动相机采集后,调用本方法。
295
- * @order 62
296
- * @return <br>
297
- * - ≤0:表示不支持曝光补偿;
298
- * - >0:支持曝光补偿,数值表示最小曝光补偿。
299
- */
167
+
300
168
  /** {en}
301
169
  * @detail api
302
170
  * @brief Gets the minimum exposure compensation of the camera.
@@ -306,15 +174,7 @@ export declare class VeLiveCameraDevice {
306
174
  * - >0: The minimum exposure compensation.
307
175
  */
308
176
  getMinExposureCompensation(): float;
309
- /** {zh}
310
- * @detail api
311
- * @brief 获取摄像头的最大曝光补偿。
312
- * @notes 需要在调用 [startVideoCapture:](#VeLivePusher-startvideocapture) 启动相机采集后,调用本方法。
313
- * @order 63
314
- * @return <br>
315
- * - ≤0:表示不支持曝光补偿;
316
- * - >0:支持曝光补偿,数值表示最大曝光补偿。
317
- */
177
+
318
178
  /** {en}
319
179
  * @detail api
320
180
  * @brief Gets the maximum exposure compensation of the camera.
@@ -325,13 +185,7 @@ export declare class VeLiveCameraDevice {
325
185
  * - >0: The maximum exposure compensation.
326
186
  */
327
187
  getMaxExposureCompensation(): float;
328
- /** {zh}
329
- * @detail api
330
- * @brief 设置相机参数。
331
- * @notes 需要在调用 [startVideoCapture:](#VeLivePusher-startvideocapture) 启动相机采集后,调用本方法。
332
- * @order 64
333
- * @param parameter 相机参数字典,包含要设置的参数名称(键)和对应的值
334
- */
188
+
335
189
  /** {en}
336
190
  * @detail api
337
191
  * @brief Sets camera parameters.
@@ -340,15 +194,7 @@ export declare class VeLiveCameraDevice {
340
194
  * @param parameter The parameter name (key) and the corresponding value.
341
195
  */
342
196
  setParameter(parameter: NSDictionary): void;
343
- /** {zh}
344
- * @detail api
345
- * @brief 获取相机参数。
346
- * @notes 需要在调用 [startVideoCapture:](#VeLivePusher-startvideocapture) 启动相机采集后,调用本方法。
347
- * @order 65
348
- * @param key 需要获取的相机参数的名称。
349
- * @return <br>
350
- * 相机参数的值,具体类型需要根据参数名称确定。
351
- */
197
+
352
198
  /** {en}
353
199
  * @detail api
354
200
  * @brief Gets camera parameters.
@@ -362,15 +208,7 @@ export declare class VeLiveCameraDevice {
362
208
  init(): this;
363
209
  }
364
210
  export declare class VeLiveMediaPlayer {
365
- /** {zh}
366
- * @detail api
367
- * @brief 设置文件路径。支持的文件格式包括 MP3、AAC、M4A、WAV。
368
- * @order 1
369
- * @param url 文件路径。
370
- * @return <br>
371
- * - 0:成功;
372
- * - ≠0:失败。
373
- */
211
+
374
212
  /** {en}
375
213
  * @detail api
376
214
  * @brief Sets the file path. Supported file formats include MP3, AAC, M4A, and WAV.
@@ -380,24 +218,14 @@ export declare class VeLiveMediaPlayer {
380
218
  * - ≠ 0: Failure.
381
219
  */
382
220
  prepare(url: NSString): int;
383
- /** {zh}
384
- * @detail api
385
- * @brief 销毁播放器实例。
386
- * @order 3
387
- */
221
+
388
222
  /** {en}
389
223
  * @detail api
390
224
  * @brief Destroys the media player instance.
391
225
  * @order 3
392
226
  */
393
227
  destroy(): void;
394
- /** {zh}
395
- * @detail api
396
- * @brief 设置播放状态的监听。
397
- * @notes 重复调用本方法,仅最后一次调用生效。
398
- * @order 4
399
- * @param listener 播放状态监听。详情请参见 [VeLiveMediaPlayerListener](155319#VeLiveMediaPlayerListener)。
400
- */
228
+
401
229
  /** {en}
402
230
  * @detail api
403
231
  * @brief Sets the observer for playback statuses.
@@ -406,14 +234,7 @@ export declare class VeLiveMediaPlayer {
406
234
  * @order 4
407
235
  */
408
236
  setListener(listener: id<VeLiveMediaPlayerListener>): void;
409
- /** {zh}
410
- * @detail api
411
- * @brief 设置音视频帧回调的监听。
412
- * @notes <br>
413
- * 重复调用本方法,仅最后一次调用生效。
414
- * @order 5
415
- * @param listener 音视频帧回调监听。详情请参见 [VeLiveMediaPlayerFrameListener](155319#VeLiveMediaPlayerFrameListener)。
416
- */
237
+
417
238
  /** {en}
418
239
  * @detail api
419
240
  * @brief Sets the observer for audio and video frames.
@@ -423,14 +244,7 @@ export declare class VeLiveMediaPlayer {
423
244
  * @order 5
424
245
  */
425
246
  setFrameListener(listener: id<VeLiveMediaPlayerFrameListener>): void;
426
- /** {zh}
427
- * @detail api
428
- * @brief 开启/关闭音频是否混音到直播流。
429
- * @param enable 开启/关闭,默认为 NO。 <br>
430
- * - YES:开启;
431
- * - NO:关闭。
432
- * @order 6
433
- */
247
+
434
248
  /** {en}
435
249
  * @detail api
436
250
  * @brief Enables or disables mixing the audio to the live stream.
@@ -440,13 +254,7 @@ export declare class VeLiveMediaPlayer {
440
254
  * @order 6
441
255
  */
442
256
  enableMixer(enable: BOOL): void;
443
- /** {zh}
444
- * @detail api
445
- * @brief 开启/关闭自动音量均衡。
446
- * @order 7
447
- * @param sourceLufs 源响度。
448
- * @param targetLufs 目标响度。
449
- */
257
+
450
258
  /** {en}
451
259
  * @detail api
452
260
  * @brief Enables or disables automatic volume equalization.
@@ -456,12 +264,7 @@ export declare class VeLiveMediaPlayer {
456
264
  * @param targetLufs The target volume.
457
265
  */
458
266
  enableAutoEq(sourceLufs: float, targetLufs: float): void;
459
- /** {zh}
460
- * @detail api
461
- * @brief 支持 MP4 格式的视频渲染。
462
- * @param view 渲染视图。
463
- * @order 93
464
- */
267
+
465
268
  /** {en}
466
269
  * @detail api
467
270
  * @brief Sets the view for rendering the video. Supports MP4 format.
@@ -469,14 +272,7 @@ export declare class VeLiveMediaPlayer {
469
272
  * @order 93
470
273
  */
471
274
  setRenderView(view: UIView): void;
472
- /** {zh}
473
- * @detail api
474
- * @brief 设置是否循环播放。
475
- * @param enable 是否循环播放。默认为 NO。<br>
476
- * - YES:循环播放;
477
- * - NO:不循环播放。
478
- * @order 8
479
- */
275
+
480
276
  /** {en}
481
277
  * @detail api
482
278
  * @brief Sets whether to loop the media file.
@@ -486,17 +282,7 @@ export declare class VeLiveMediaPlayer {
486
282
  * @order 8
487
283
  */
488
284
  enableBGMLoop(enable: BOOL): void;
489
- /** {zh}
490
- * @detail api
491
- * @brief 开始播放。
492
- * @notes
493
- * - 需要在调用 [prepare:](#VeLiveMediaPlayer-prepare) 设置文件路径后,调用本方法;
494
- * - 此方法为异步操作。当 SDK 收到开始播放 [onStart](155319#VeLiveMediaPlayerListener-onstart) 的回调后,开始播放。
495
- * @order 9
496
- * @return <br>
497
- * - 0:成功;
498
- * - ≠0:失败。
499
- */
285
+
500
286
  /** {en}
501
287
  * @detail api
502
288
  * @brief Starts playback.
@@ -509,16 +295,7 @@ export declare class VeLiveMediaPlayer {
509
295
  * - ≠ 0: Failure.
510
296
  */
511
297
  start(): Promise<int>;
512
- /** {zh}
513
- * @detail api
514
- * @brief 停止播放。
515
- * @notes
516
- * 需要在调用 [start](#VeLiveMediaPlayer-start) 开始播放后,调用本方法。
517
- * @order 10
518
- * @return <br>
519
- * - 0:成功;
520
- * - ≠0:失败。
521
- */
298
+
522
299
  /** {en}
523
300
  * @detail api
524
301
  * @brief Stops playback.
@@ -530,13 +307,7 @@ export declare class VeLiveMediaPlayer {
530
307
  * - ≠ 0: Failure.
531
308
  */
532
309
  stop(): Promise<int>;
533
- /** {zh}
534
- * @detail api
535
- * @brief 暂停播放。
536
- * @notes
537
- * 需要在调用 [start](#VeLiveMediaPlayer-start) 开始播放后,调用本方法。
538
- * @order 11
539
- */
310
+
540
311
  /** {en}
541
312
  * @detail api
542
313
  * @brief Pauses playback.
@@ -545,13 +316,7 @@ export declare class VeLiveMediaPlayer {
545
316
  * @order 11
546
317
  */
547
318
  pause(): Promise<void>;
548
- /** {zh}
549
- * @detail api
550
- * @brief 恢复播放。
551
- * @notes
552
- * 需要在调用 [pause](#VeLiveMediaPlayer-pause) 暂停播放后,调用本方法。
553
- * @order 12
554
- */
319
+
555
320
  /** {en}
556
321
  * @detail api
557
322
  * @brief Resumes playback.
@@ -560,15 +325,7 @@ export declare class VeLiveMediaPlayer {
560
325
  * @order 12
561
326
  */
562
327
  resume(): Promise<void>;
563
- /** {zh}
564
- * @detail api
565
- * @brief 设置播放进度。
566
- * @order 13
567
- * @param pos 播放时间,单位为 ms。
568
- * @return <br>
569
- * - 0:成功;
570
- * - ≠0:失败。
571
- */
328
+
572
329
  /** {en}
573
330
  * @detail api
574
331
  * @brief Sets the playback progress.
@@ -579,16 +336,7 @@ export declare class VeLiveMediaPlayer {
579
336
  * - ≠ 0: Failure.
580
337
  */
581
338
  seek(pos: long): int;
582
- /** {zh}
583
- * @detail api
584
- * @brief 获取文件的总时长,单位为 ms。
585
- * @notes
586
- * 需要在调用 [start](#VeLiveMediaPlayer-start) 开始播放后,调用本方法。
587
- * @order 2
588
- * @return <br>
589
- * - >0:成功,音频文件时长;
590
- * - ≤0:失败。
591
- */
339
+
592
340
  /** {en}
593
341
  * @detail api
594
342
  * @brief Gets the duration of the media file.
@@ -600,12 +348,7 @@ export declare class VeLiveMediaPlayer {
600
348
  * - ≤ 0: Failure.
601
349
  */
602
350
  getDuration(): long;
603
- /** {zh}
604
- * @detail api
605
- * @brief 设置播放音频的音量。
606
- * @order 14
607
- * @param volume 播放音频音量,取值范围为 [0.0,4.0]。
608
- */
351
+
609
352
  /** {en}
610
353
  * @detail api
611
354
  * @brief Sets the playback volume.
@@ -613,14 +356,7 @@ export declare class VeLiveMediaPlayer {
613
356
  * @order 14
614
357
  */
615
358
  setBGMVolume(volume: float): void;
616
- /** {zh}
617
- * @detail api
618
- * @brief 设置音频采集音量。
619
- * @notes
620
- * 需要在调用 [start](#VeLiveMediaPlayer-start) 开始播放背景音乐后,调用本方法。
621
- * @order 15
622
- * @param volume 音频采集音量,取值范围为 [0.0,4.0]。
623
- */
359
+
624
360
  /** {en}
625
361
  * @detail api
626
362
  * @brief Sets the audio capture volume.
@@ -633,12 +369,7 @@ export declare class VeLiveMediaPlayer {
633
369
  init(): this;
634
370
  }
635
371
  export declare class VeLiveAudioDevice {
636
- /** {zh}
637
- * @detail api
638
- * @brief 设置音量响度。
639
- * @order 60
640
- * @param level 音量响度等级,取值范围为 [0.0,4.0]。
641
- */
372
+
642
373
  /** {en}
643
374
  * @detail api
644
375
  * @brief Sets the volume.
@@ -646,13 +377,7 @@ export declare class VeLiveAudioDevice {
646
377
  * @order 60
647
378
  */
648
379
  setVoiceLoudness(level: float): void;
649
- /** {zh}
650
- * @detail api
651
- * @brief 获取当前音量响度。
652
- * @order 61
653
- * @return <br>
654
- * 当前音量响度等级。
655
- */
380
+
656
381
  /** {en}
657
382
  * @detail api
658
383
  * @brief Gets the current volume.
@@ -661,14 +386,7 @@ export declare class VeLiveAudioDevice {
661
386
  * The current volume.
662
387
  */
663
388
  getVoiceLoudness(): float;
664
- /** {zh}
665
- * @detail api
666
- * @brief 查询是否支持硬件耳返。
667
- * @return <br>
668
- * - YES:支持;
669
- * - NO:不支持。
670
- * @order 62
671
- */
389
+
672
390
  /** {en}
673
391
  * @detail api
674
392
  * @brief Checks whether in-ear monitoring is supported.
@@ -678,16 +396,7 @@ export declare class VeLiveAudioDevice {
678
396
  * @order 62
679
397
  */
680
398
  isSupportHardwareEcho(): BOOL;
681
- /** {zh}
682
- * @detail api
683
- * @brief 是否开启耳返功能。
684
- * @param enable 耳返功能开关。默认值为 NO。<br>
685
- * - YES:开启;
686
- * - NO:关闭。
687
- * @notes
688
- * 需要在调用 [startAudioCapture:](#VeLivePusher-startaudiocapture) 启动音频采集后,调用本方法。
689
- * @order 64
690
- */
399
+
691
400
  /** {en}
692
401
  * @detail api
693
402
  * @brief Enables or disables in-ear monitoring.
@@ -699,16 +408,7 @@ export declare class VeLiveAudioDevice {
699
408
  * @order 64
700
409
  */
701
410
  enableEcho(enable: BOOL): void;
702
- /** {zh}
703
- * @detail api
704
- * @brief 获取当前耳返开启状态。
705
- * @notes
706
- * 需要在调用 [startAudioCapture:](#VeLivePusher-startaudiocapture) 启动音频采集后,调用本方法。
707
- * @order 65
708
- * @return <br>
709
- * - YES:开启;
710
- * - NO:关闭。
711
- */
411
+
712
412
  /** {en}
713
413
  * @detail api
714
414
  * @brief Checks whether in-ear monitoring is enabled.
@@ -723,12 +423,7 @@ export declare class VeLiveAudioDevice {
723
423
  init(): this;
724
424
  }
725
425
  export declare class VeLivePusher {
726
- /** {zh}
727
- * @detail api
728
- * @brief 设置输出到控制台的日志等级。
729
- * @order 50
730
- * @param level 输出的日志级别,默认值为 `VeLivePusherLogLevelNone`,表示关闭日志。级别详情请参见 [VeLivePusherLogLevel](155321#VeLivePusherLogLevel)。
731
- */
426
+
732
427
  /** {en}
733
428
  * @detail api
734
429
  * @brief Sets the log level sent to the console.
@@ -736,12 +431,7 @@ export declare class VeLivePusher {
736
431
  * @order 50
737
432
  */
738
433
  static setLogLevel(level: VeLivePusherLogLevel): void;
739
- /** {zh}
740
- * @detail api
741
- * @param applicationGroupIdentifier iOS app group 标识符。
742
- * @brief 开启屏幕采集。
743
- * @order 20
744
- */
434
+
745
435
  /** {en}
746
436
  * @detail api
747
437
  * @param applicationGroupIdentifier iOS app group identifier.
@@ -749,13 +439,7 @@ export declare class VeLivePusher {
749
439
  * @order 20
750
440
  */
751
441
  startScreenCapture(applicationGroupIdentifier: NSString): void;
752
- /** {zh}
753
- * @detail api
754
- * @brief 停止屏幕采集。
755
- * @notes <br>
756
- * 该方法用于结束当前屏幕采集流程,并释放相关资源。调用本方法后,`pauseScreenCapture` 和 `resumeScreenCapture` 将不再生效。
757
- * @order 21
758
- */
442
+
759
443
  /** {en}
760
444
  * @detail api
761
445
  * @brief Stops the screen capturing process.
@@ -764,13 +448,7 @@ export declare class VeLivePusher {
764
448
  * @order 21
765
449
  */
766
450
  stopScreenCapture(): void;
767
- /** {zh}
768
- * @detail api
769
- * @brief 暂停屏幕采集。
770
- * @notes <br>
771
- * 调用该方法后,屏幕采集将暂停输出数据,但不会销毁内部资源。您可通过 `resumeScreenCapture` 来恢复采集。如果当前采集已经停止或尚未开始,调用本方法不会产生任何效果。
772
- * @order 22
773
- */
451
+
774
452
  /** {en}
775
453
  * @detail api
776
454
  * @brief Pauses the screen capturing process.
@@ -779,13 +457,7 @@ export declare class VeLivePusher {
779
457
  * @order 22
780
458
  */
781
459
  pauseScreenCapture(): void;
782
- /** {zh}
783
- * @detail api
784
- * @brief 恢复屏幕采集。
785
- * @notes <br>
786
- * 在调用 `pauseScreenCapture` 暂停后,通过本方法可以恢复屏幕采集输出。如果屏幕采集已经停止或尚未开始,调用本方法不会产生任何效果。
787
- * @order 23
788
- */
460
+
789
461
  /** {en}
790
462
  * @detail api
791
463
  * @brief Resumes the screen capturing process.
@@ -795,12 +467,7 @@ export declare class VeLivePusher {
795
467
  */
796
468
  resumeScreenCapture(): void;
797
469
  init(): this;
798
- /** {zh}
799
- * @detail api
800
- * @brief 初始化推流器。
801
- * @order 0
802
- * @param config 推流配置类。详细信息请参见 [VeLivePusherConfiguration](155321#VeLivePusherConfiguration)。
803
- */
470
+
804
471
  /** {en}
805
472
  * @detail api
806
473
  * @brief Initializes the live pusher.
@@ -808,26 +475,14 @@ export declare class VeLivePusher {
808
475
  * @order 0
809
476
  */
810
477
  initWithConfig(config: VeLivePusherConfiguration): this;
811
- /** {zh}
812
- * @detail api
813
- * @brief 停止采集和推流,并销毁推流器。通常在调用 [stopPush](#VeLivePusher-stoppush) 结束推流后调用此方法进行清理。
814
- * @order 2
815
- */
478
+
816
479
  /** {en}
817
480
  * @detail api
818
481
  * @brief Stops capturing and pushing streams and destroys the live pusher. Call this method after [stopPush](#VeLivePusher-stoppush) is called.
819
482
  * @order 2
820
483
  */
821
484
  destroy(): void;
822
- /** {zh}
823
- * @detail api
824
- * @brief 设置推流器回调,通过设置回调,监听推流器的推流错误、状态、网络质量、设备、首帧等回调事件。
825
- * @notes <br>
826
- * - 需要在创建推流引擎后,调用本方法;
827
- * - 重复调用本方法,仅最后一次调用生效。
828
- * @order 4
829
- * @param observer 推流器回调对象,详细信息请参见 [VeLivePusherObserver](155319#VeLivePusherObserver)。
830
- */
485
+
831
486
  /** {en}
832
487
  * @detail api
833
488
  * @brief Sets an observer to listen for live pusher events, including errors, statuses, network quality, device information, and first frame rendering.
@@ -838,16 +493,7 @@ export declare class VeLivePusher {
838
493
  * @order 4
839
494
  */
840
495
  setObserver(observer: id<VeLivePusherObserver>): void;
841
- /** {zh}
842
- * @detail api
843
- * @brief 设置推流器周期性回调,用于定期获取推流状态信息。
844
- * @notes <br>
845
- * - 需要在创建推流引擎后,调用本方法;
846
- * - 重复调用本方法,仅最后一次调用生效。
847
- * @order 6
848
- * @param observer 推流器周期性回调对象,详细信息请参见 [VeLivePusherStatisticsObserver](155319#VeLivePusherStatisticsObserver)。
849
- * @param interval 周期性回调的时间间隔,单位为 s,默认值为 5。
850
- */
496
+
851
497
  /** {en}
852
498
  * @detail api
853
499
  * @brief Sets an observer to periodically report push-stream statistics.
@@ -859,15 +505,7 @@ export declare class VeLivePusher {
859
505
  * @order 6
860
506
  */
861
507
  setStatisticsObserver(observer: id<VeLivePusherStatisticsObserver>, interval: int): void;
862
- /** {zh}
863
- * @detail api
864
- * @brief 添加视频帧的监听回调,用于获取推流器输出的视频帧。
865
- * @order 51
866
- * @param listener 视频帧的监听回调,详细信息请参见 [VeLiveVideoFrameListener](155319#VeLiveVideoFrameListener)。
867
- * @return <br>
868
- * - 0:成功;
869
- * - ≠0:失败。
870
- */
508
+
871
509
  /** {en}
872
510
  * @detail api
873
511
  * @brief Adds a video frame listener.
@@ -878,17 +516,7 @@ export declare class VeLivePusher {
878
516
  * - ≠ 0: Failure.
879
517
  */
880
518
  addVideoFrameListener(listener: id<VeLiveVideoFrameListener>): int;
881
- /** {zh}
882
- * @detail api
883
- * @brief 移除已添加的视频帧监听回调。
884
- * @notes <br>
885
- * 如果没有添加过此监听回调或者监听回调已被移除,调用此方法将返回失败。
886
- * @order 52
887
- * @param listener 视频帧的监听回调,详细信息请参见 [VeLiveVideoFrameListener](155319#VeLiveVideoFrameListener)。
888
- * @return <br>
889
- * - 0:成功;
890
- * - <0:失败。
891
- */
519
+
892
520
  /** {en}
893
521
  * @detail api
894
522
  * @brief Removes the video frame listener.
@@ -901,15 +529,7 @@ export declare class VeLivePusher {
901
529
  * - <0: Failure.
902
530
  */
903
531
  removeVideoFrameListener(listener: id<VeLiveVideoFrameListener>): int;
904
- /** {zh}
905
- * @detail api
906
- * @brief 添加音频帧的监听回调,用于获取推流器输出的音频帧。
907
- * @order 53
908
- * @param listener 音频帧监听回调,详细信息请参见 [VeLiveAudioFrameListener](155319#VeLiveAudioFrameListener)。
909
- * @return <br>
910
- * - 0:成功;
911
- * - <0:失败。
912
- */
532
+
913
533
  /** {en}
914
534
  * @detail api
915
535
  * @brief Adds an audio frame listener.
@@ -920,17 +540,7 @@ export declare class VeLivePusher {
920
540
  * - <0: Failure.
921
541
  */
922
542
  addAudioFrameListener(listener: id<VeLiveAudioFrameListener>): int;
923
- /** {zh}
924
- * @detail api
925
- * @brief 移除已添加的音频帧监听回调。
926
- * @notes <br>
927
- * 如果没有添加过此监听回调或者监听回调已被移除,调用此方法将返回失败。
928
- * @order 54
929
- * @param listener 音频帧的监听回调,详细信息请参见 [VeLiveAudioFrameListener](155319#VeLiveAudioFrameListener)。
930
- * @return <br>
931
- * - 0:成功;
932
- * - <0:失败。
933
- */
543
+
934
544
  /** {en}
935
545
  * @detail api
936
546
  * @brief Removes the audio frame listener.
@@ -943,18 +553,7 @@ export declare class VeLivePusher {
943
553
  * - <0: Failure.
944
554
  */
945
555
  removeAudioFrameListener(listener: id<VeLiveAudioFrameListener>): int;
946
- /** {zh}
947
- * @detail api
948
- * @brief 添加屏幕采集的监听。
949
- * @notes <br>
950
- * 如果没有添加过此监听回调或者监听回调已被移除,调用此方法将返回失败。
951
- * @param listener 屏幕采集事件监听回调,详细信息请参见 VeLiveScreenCaptureStatusObserver{@link #VeLiveScreenCaptureStatusObserver}
952
- * @param observer 录屏推流事件监听器。详情见 [VeLiveScreenCaptureStatusObserver](155319#VeLiveScreenCaptureStatusObserver)。
953
- * @order 5
954
- * @return <br>
955
- * - 0:成功;
956
- * - <0:失败。
957
- */
556
+
958
557
  /** {en}
959
558
  * @brief Sets the observer for screen capturing events.
960
559
  * @notes Calling this method will return a failure if the listener has not been added or has been removed.
@@ -964,12 +563,7 @@ export declare class VeLivePusher {
964
563
  * - <0: Failure.
965
564
  */
966
565
  setScreenCaptureObserver(observer: id<VeLiveScreenCaptureStatusObserver>): int;
967
- /** {zh}
968
- * @detail api
969
- * @brief 设置本地预览视图。如您对采集到的画面进行了美颜等处理,View 中显示的是美颜后的画面。
970
- * @order 7
971
- * @param view 本地预览视图。
972
- */
566
+
973
567
  /** {en}
974
568
  * @detail api
975
569
  * @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.
@@ -977,12 +571,7 @@ export declare class VeLivePusher {
977
571
  * @order 7
978
572
  */
979
573
  setRenderView(view: UIView): Promise<void>;
980
- /** {zh}
981
- * @detail api
982
- * @order 10
983
- * @brief 设置本地预览填充模式。
984
- * @param fillMode 本地预览填充模式,默认值为 VeLivePusherRenderModeFill,即视频帧自适应画布的填充模式,详细信息请参见 [VeLivePusherRenderMode](155321#VeLivePusherRenderMode)。
985
- */
574
+
986
575
  /** {en}
987
576
  * @detail api
988
577
  * @order 10
@@ -990,15 +579,7 @@ export declare class VeLivePusher {
990
579
  * @param fillMode The fill mode. See VeLivePusherRenderMode {@link #VeLivePusherRenderMode} for details.
991
580
  */
992
581
  setRenderFillMode(fillMode: VeLivePusherRenderMode): void;
993
- /** {zh}
994
- * @detail api
995
- * @brief 开启/关闭镜像。该方法可用于配置预览和推流画面是否镜像。
996
- * @order 8
997
- * @param type 镜像类型,详细信息请参见 [VeLiveVideoMirrorType](155321#VeLiveVideoMirrorType)。
998
- * @param enable 是否开启镜像。<br>
999
- * - YES:开启;
1000
- * - NO:关闭。
1001
- */
582
+
1002
583
  /** {en}
1003
584
  * @detail api
1004
585
  * @brief Enables or disables mirroring for the local preview and the streamed video.
@@ -1009,12 +590,7 @@ export declare class VeLivePusher {
1009
590
  * - NO: Disable.
1010
591
  */
1011
592
  setVideoMirror(type: VeLiveVideoMirrorType, enable: BOOL): void;
1012
- /** {zh}
1013
- * @detail api
1014
- * @brief 开始推流。
1015
- * @order 24
1016
- * @param url 推流地址,用于将直播流推送到目标服务器。
1017
- */
593
+
1018
594
  /** {en}
1019
595
  * @detail api
1020
596
  * @brief Starts streaming.
@@ -1022,14 +598,7 @@ export declare class VeLivePusher {
1022
598
  * @order 24
1023
599
  */
1024
600
  startPush(url: NSString): void;
1025
- /** {zh}
1026
- * @detail api
1027
- * @brief 开始推流,支持备用推流地址。
1028
- * @notes <br>
1029
- * 当数组中第一个推流地址不可用时,会自动切换到后面的备用推流地址继续推流。
1030
- * @order 25
1031
- * @param urls 推流地址列表,包含一个或多个推流地址。
1032
- */
601
+
1033
602
  /** {en}
1034
603
  * @detail api
1035
604
  * @brief Starts streaming with one or more push stream addresses.
@@ -1039,13 +608,7 @@ export declare class VeLivePusher {
1039
608
  * @order 25
1040
609
  */
1041
610
  startPushWithUrls(urls: NSArray<NSString>): void;
1042
- /** {zh}
1043
- * @detail api
1044
- * @brief 停止推流。
1045
- * @notes
1046
- * 停止推流后,可以通过调用 [startPush:](#VeLivePusher-startpush) 或 [startPushWithUrls:](#VeLivePusher-startpushwithurls) 方法重新开始推流。
1047
- * @order 26
1048
- */
611
+
1049
612
  /** {en}
1050
613
  * @detail api
1051
614
  * @brief Stops streaming.
@@ -1054,15 +617,7 @@ export declare class VeLivePusher {
1054
617
  * @order 26
1055
618
  */
1056
619
  stopPush(): void;
1057
- /** {zh}
1058
- * @detail api
1059
- * @brief 当前是否正在推流中,可用来查询推流器的当前状态。
1060
- * @order 27
1061
- * @return <br>
1062
- * 是否正在推流。<br>
1063
- * - YES:正在推流中;
1064
- * - NO:已经停止推流。
1065
- */
620
+
1066
621
  /** {en}
1067
622
  * @detail api
1068
623
  * @brief Checks whether the streaming is currently ongoing. You can use this method to query the status of the live pusher.
@@ -1073,14 +628,7 @@ export declare class VeLivePusher {
1073
628
  * - NO: The streaming has stopped.
1074
629
  */
1075
630
  isPushing(): BOOL;
1076
- /** {zh}
1077
- * @detail api
1078
- * @brief 开始视频采集。
1079
- * @notes
1080
- * 调用该接口后,可以通过调用接口 [stopVideoCapture](#VeLivePusher-stopvideocapture) 停止视频采集。
1081
- * @order 11
1082
- * @param type 视频采集类型,详细信息请参见 [VeLiveVideoCaptureType](155321#VeLiveVideoCaptureType)。
1083
- */
631
+
1084
632
  /** {en}
1085
633
  * @detail api
1086
634
  * @brief Starts video capture.
@@ -1090,13 +638,7 @@ export declare class VeLivePusher {
1090
638
  * @order 11
1091
639
  */
1092
640
  startVideoCapture(type: VeLiveVideoCaptureType): void;
1093
- /** {zh}
1094
- * @detail api
1095
- * @brief 停止视频采集。
1096
- * @notes
1097
- * 调用该接口后,可以通过调用接口 [startVideoCapture:](#VeLivePusher-startvideocapture) 开始视频采集。
1098
- * @order 12
1099
- */
641
+
1100
642
  /** {en}
1101
643
  * @detail api
1102
644
  * @brief Stops video capture.
@@ -1105,14 +647,7 @@ export declare class VeLivePusher {
1105
647
  * @order 12
1106
648
  */
1107
649
  stopVideoCapture(): void;
1108
- /** {zh}
1109
- * @detail api
1110
- * @brief 切换视频采集类型。
1111
- * @notes
1112
- * 该接口必须在调用接口 [startVideoCapture:](#VeLivePusher-startvideocapture) 后调用才能生效。
1113
- * @order 13
1114
- * @param type 视频采集类型,详细信息请参见 [VeLiveVideoCaptureType](155321#VeLiveVideoCaptureType)。
1115
- */
650
+
1116
651
  /** {en}
1117
652
  * @detail api
1118
653
  * @brief Switches the video capture type.
@@ -1122,14 +657,7 @@ export declare class VeLivePusher {
1122
657
  * @param type The video capture type. See VeLiveVideoCaptureType{@link #VeLiveVideoCaptureType} for details.
1123
658
  */
1124
659
  switchVideoCapture(type: VeLiveVideoCaptureType): void;
1125
- /** {zh}
1126
- * @detail api
1127
- * @brief 开始音频采集。
1128
- * @notes
1129
- * 调用该接口后,可以通过调用接口 [[stopAudioCapture](#VeLivePusher-stopaudiocapture) 停止音频采集。
1130
- * @order 15
1131
- * @param type 音频采集类型,详细信息请参见 [VeLiveAudioCaptureType](155321#VeLiveAudioCaptureType)。
1132
- */
660
+
1133
661
  /** {en}
1134
662
  * @detail api
1135
663
  * @brief Starts audio capture.
@@ -1139,13 +667,7 @@ export declare class VeLivePusher {
1139
667
  * @order 15
1140
668
  */
1141
669
  startAudioCapture(type: VeLiveAudioCaptureType): void;
1142
- /** {zh}
1143
- * @detail api
1144
- * @brief 停止音频采集。
1145
- * @notes
1146
- * 调用该接口后,可以通过调用接口 [startAudioCapture:](#VeLivePusher-startaudiocapture) 开始音频采集。
1147
- * @order 16
1148
- */
670
+
1149
671
  /** {en}
1150
672
  * @detail api
1151
673
  * @brief Stops audio capture.
@@ -1154,14 +676,7 @@ export declare class VeLivePusher {
1154
676
  * @order 16
1155
677
  */
1156
678
  stopAudioCapture(): void;
1157
- /** {zh}
1158
- * @detail api
1159
- * @brief 切换音频采集类型。
1160
- * @notes
1161
- * 该接口必须在调用接口 [startAudioCapture:](#VeLivePusher-startaudiocapture) 后调用才能生效。
1162
- * @order 17
1163
- * @param type 音频采集类型,详细信息请参见 [VeLiveAudioCaptureType](155321#VeLiveAudioCaptureType)。
1164
- */
679
+
1165
680
  /** {en}
1166
681
  * @detail api
1167
682
  * @brief Switches audio capture type.
@@ -1171,13 +686,7 @@ export declare class VeLivePusher {
1171
686
  * @order 17
1172
687
  */
1173
688
  switchAudioCapture(type: VeLiveAudioCaptureType): void;
1174
- /** {zh}
1175
- * @detail api
1176
- * @brief 获取当前视频采集类型。
1177
- * @order 14
1178
- * @return <br>
1179
- * 视频采集类型,详细信息请参见 VeLiveVideoCaptureType{@link #VeLiveVideoCaptureType}。
1180
- */
689
+
1181
690
  /** {en}
1182
691
  * @detail api
1183
692
  * @brief Gets the current video capture type.
@@ -1186,13 +695,7 @@ export declare class VeLivePusher {
1186
695
  * The video capture type. See [VeLiveVideoCaptureType](docs-broadcast-sdk-for-ios-type-definition#VeLiveVideoCaptureType) for details.
1187
696
  */
1188
697
  getCurrentVideoCaptureType(): VeLiveVideoCaptureType;
1189
- /** {zh}
1190
- * @detail api
1191
- * @brief 获取当前音频采集类型。
1192
- * @order 18
1193
- * @return <br>
1194
- * 音频采集类型,详细信息请参见 VeLiveAudioCaptureType{@link #VeLiveAudioCaptureType}。
1195
- */
698
+
1196
699
  /** {en}
1197
700
  * @detail api
1198
701
  * @brief Gets the current audio capture type.
@@ -1201,12 +704,7 @@ export declare class VeLivePusher {
1201
704
  * The audio capture type. See [VeLiveAudioCaptureType](docs-broadcast-sdk-for-ios-type-definition#VeLiveAudioCaptureType) for details.
1202
705
  */
1203
706
  getCurrentAudioCaptureType(): VeLiveAudioCaptureType;
1204
- /** {zh}
1205
- * @detail api
1206
- * @brief 自定义静态图,适用于静态图推流采集类型。使用该接口时,需要将视频采集类型设置为 VeLiveVideoCaptureCustomImage,您可调用 [startVideoCapture:](#VeLivePusher-startvideocapture) 方法,将 [VeLiveVideoCaptureType](155321#VeLiveVideoCaptureType) 设置为 VeLiveVideoCaptureCustomImage。
1207
- * @order 19
1208
- * @param image 静态图片,用于在静态图推流采集类型下设置静态图。
1209
- */
707
+
1210
708
  /** {en}
1211
709
  * @detail api
1212
710
  * @brief Sets a static image to push. When using this method, you must call [startVideoCapture:](#VeLivePusher-startvideocapture) and set [VeLiveVideoCaptureType](docs-broadcast-sdk-for-ios-type-definition#VeLiveVideoCaptureType) to `VeLiveVideoCaptureCustomImage`.
@@ -1214,14 +712,7 @@ export declare class VeLivePusher {
1214
712
  * @param image The static image to push.
1215
713
  */
1216
714
  updateCustomImage(image: UIImage): Promise<void>;
1217
- /** {zh}
1218
- * @detail api
1219
- * @brief 设置静音。
1220
- * @param mute 是否设置为静音。默认为 NO。<br>
1221
- * - YES:静音推流;
1222
- * - NO:正常推流。
1223
- * @order 22
1224
- */
715
+
1225
716
  /** {en}
1226
717
  * @detail api
1227
718
  * @brief Sets whether to mute the stream.
@@ -1231,14 +722,7 @@ export declare class VeLivePusher {
1231
722
  * @order 22
1232
723
  */
1233
724
  setMute(mute: BOOL): void;
1234
- /** {zh}
1235
- * @detail api
1236
- * @brief 当前是否是静音状态。
1237
- * @order 23
1238
- * @return <br>
1239
- * - YES:当前是静音状态;
1240
- * - NO:当前非静音状态。
1241
- */
725
+
1242
726
  /** {en}
1243
727
  * @detail api
1244
728
  * @brief Checks whether the stream is muted.
@@ -1248,14 +732,7 @@ export declare class VeLivePusher {
1248
732
  * - NO: The stream is not muted.
1249
733
  */
1250
734
  isMute(): BOOL;
1251
- /** {zh}
1252
- * @detail api
1253
- * @brief 设置推流视频编码参数。
1254
- * @notes <br>
1255
- * 该接口可在推流开始前或开始后调用。
1256
- * @order 29
1257
- * @param config 推流视频参数,支持设置推流视频分辨率、编码格式、目标码率和视频 GOP 大小等信息。详情请参见 [VeLiveVideoEncoderConfiguration](155321#VeLiveVideoEncoderConfiguration)。
1258
- */
735
+
1259
736
  /** {en}
1260
737
  * @detail api
1261
738
  * @brief Sets video encoding parameters for the pushed stream.
@@ -1265,14 +742,7 @@ export declare class VeLivePusher {
1265
742
  * @order 29
1266
743
  */
1267
744
  setVideoEncoderConfiguration(config: VeLiveVideoEncoderConfiguration): void;
1268
- /** {zh}
1269
- * @detail api
1270
- * @brief 设置推流音频编码参数。
1271
- * @notes
1272
- * 该接口需要在 [startPush:](#VeLivePusher-startpush) 或 [startPushWithUrls:](#VeLivePusher-startpushwithurls) 方法之前调用。
1273
- * @order 28
1274
- * @param config 推流音频编码参数,详情请参见 [VeLiveAudioEncoderConfiguration](155321#VeLiveAudioEncoderConfiguration)。
1275
- */
745
+
1276
746
  /** {en}
1277
747
  * @detail api
1278
748
  * @brief Sets audio encoding parameters for the pushed stream.
@@ -1282,14 +752,7 @@ export declare class VeLivePusher {
1282
752
  * @order 28
1283
753
  */
1284
754
  setAudioEncoderConfiguration(config: VeLiveAudioEncoderConfiguration): void;
1285
- /** {zh}
1286
- * @detail api
1287
- * @brief 开始本地文件录制。
1288
- * @order 44
1289
- * @param path 录制文件保存路径,不能为空。
1290
- * @param config 文件录制设置,详情请参见 [VeLiveFileRecorderConfiguration](155321#VeLiveFileRecorderConfiguration)。
1291
- * @param listener 本地文件录制的监听,详情请参见 [VeLiveFileRecordingListener](155319#VeLiveFileRecordingListener)。
1292
- */
755
+
1293
756
  /** {en}
1294
757
  * @detail api
1295
758
  * @brief Starts local recording.
@@ -1299,13 +762,7 @@ export declare class VeLivePusher {
1299
762
  * @order 44
1300
763
  */
1301
764
  startFileRecording(path: NSString, config: VeLiveFileRecorderConfiguration, listener: id<VeLiveFileRecordingListener>): void;
1302
- /** {zh}
1303
- * @detail api
1304
- * @brief 停止本地文件录制。
1305
- * @notes
1306
- * 该接口需要在 [startFileRecording](#VeLivePusher-startfilerecording-config-listener) 方法之后调用。
1307
- * @order 46
1308
- */
765
+
1309
766
  /** {en}
1310
767
  * @detail api
1311
768
  * @brief Stops local recording.
@@ -1314,18 +771,7 @@ export declare class VeLivePusher {
1314
771
  * @order 46
1315
772
  */
1316
773
  stopFileRecording(): void;
1317
- /** {zh}
1318
- * @detail api
1319
- * @brief 获取相机设备管理对象 `VeLiveCameraDevice`。通过设备管理,您可以使用以下功能。
1320
- * - 控制闪光灯开关
1321
- * - 设置摄像头缩放比例
1322
- * - 设置自动对焦
1323
- * @notes
1324
- * 该接口需要在 [startVideoCapture:](#VeLivePusher-startvideocapture) 方法中设置 [VeLiveVideoCaptureType](155321#VeLiveVideoCaptureType) 为 VeLiveVideoCaptureFrontCamera 或 VeLiveVideoCaptureBackCamera。
1325
- * @order 32
1326
- * @return
1327
- * 相机设备管理对象 [VeLiveCameraDevice](#VeLiveCameraDevice)。
1328
- */
774
+
1329
775
  /** {en}
1330
776
  * @detail api
1331
777
  * @brief Gets the camera manager. With the camera manager, you can do the following:
@@ -1339,15 +785,7 @@ export declare class VeLivePusher {
1339
785
  * The camera manager. See [VeLiveCameraDevice](#VeLiveCameraDevice) for details.
1340
786
  */
1341
787
  getCameraDevice(): VeLiveCameraDevice;
1342
- /** {zh}
1343
- * @detail api
1344
- * @brief 获取音频模块管理对象。
1345
- * @notes
1346
- * 该接口需要在 [startAudioCapture:](#VeLivePusher-startaudiocapture) 方法中设置 [VeLiveAudioCaptureType](155321#VeLiveAudioCaptureType) 为 VeLiveAudioCaptureMicrophone。
1347
- * @order 33
1348
- * @return
1349
- * 音频模块管理对象 [VeLiveAudioDevice](#VeLiveAudioDevice)。
1350
- */
788
+
1351
789
  /** {en}
1352
790
  * @detail api
1353
791
  * @brief Gets the audio device manager.
@@ -1358,20 +796,7 @@ export declare class VeLivePusher {
1358
796
  * The audio device manager. See [VeLiveAudioDevice](#VeLiveAudioDevice) for details.
1359
797
  */
1360
798
  getAudioDevice(): VeLiveAudioDevice;
1361
- /** {zh}
1362
- * @detail api
1363
- * @brief 获取视频特效管理对象 `VeLiveVideoEffectManager`。通过视频特效管理,您可以使用以下功能。
1364
- * - 设置美颜
1365
- * - 设置特效
1366
- * - 设置素材
1367
- * - 设置贴纸
1368
- * - 设置滤镜
1369
- * @notes
1370
- * 该接口需要集成智能美化特效 SDK 后才能使用。
1371
- * @order 31
1372
- * @return
1373
- * 视频特效管理对象 [VeLiveVideoEffectManager](#VeLiveVideoEffectManager)。
1374
- */
799
+
1375
800
  /** {en}
1376
801
  * @detail api
1377
802
  * @brief Gets the special effects manager. With the special effects manager, you can do the following:
@@ -1387,13 +812,7 @@ export declare class VeLivePusher {
1387
812
  * The special effects manager. See [VeLiveVideoEffectManager](#VeLiveVideoEffectManager) for details.
1388
813
  */
1389
814
  getVideoEffectManager(): VeLiveVideoEffectManager;
1390
- /** {zh}
1391
- * @detail api
1392
- * @brief 创建播放器。
1393
- * @order 3
1394
- * @return
1395
- * 播放器管理对象 [VeLiveMediaPlayer](#VeLiveMediaPlayer)。
1396
- */
815
+
1397
816
  /** {en}
1398
817
  * @detail api
1399
818
  * @brief Creates the media player.
@@ -1402,12 +821,7 @@ export declare class VeLivePusher {
1402
821
  * The media player. See [VeLiveMediaPlayer](#VeLiveMediaPlayer) for details.
1403
822
  */
1404
823
  createPlayer(): VeLiveMediaPlayer;
1405
- /** {zh}
1406
- * @detail api
1407
- * @brief 自定义视频处理。
1408
- * @param filter 视频帧滤镜对象 VeLiveVideoFrameFilter{@link #VeLiveVideoFrameFilter}。
1409
- * @order 36
1410
- */
824
+
1411
825
  /** {en}
1412
826
  * @detail api
1413
827
  * @brief Sets a protocol for custom video processing.
@@ -1415,12 +829,7 @@ export declare class VeLivePusher {
1415
829
  * @order 36
1416
830
  */
1417
831
  setVideoFrameFilter(filter: id<VeLiveVideoFrameFilter>): void;
1418
- /** {zh}
1419
- * @detail api
1420
- * @brief 自定义音频处理。
1421
- * @param filter 音频帧滤镜对象 VeLiveAudioFrameFilter{@link #VeLiveAudioFrameFilter}。
1422
- * @order 40
1423
- */
832
+
1424
833
  /** {en}
1425
834
  * @detail api
1426
835
  * @brief Sets custom audio processing.
@@ -1428,12 +837,7 @@ export declare class VeLivePusher {
1428
837
  * @order 40
1429
838
  */
1430
839
  setAudioFrameFilter(filter: id<VeLiveAudioFrameFilter>): void;
1431
- /** {zh}
1432
- * @detail api
1433
- * @brief 设置推流视频帧朝向。默认为竖屏推流。
1434
- * @param orientation 视频帧朝向。
1435
- * @order 9
1436
- */
840
+
1437
841
  /** {en}
1438
842
  * @detail api
1439
843
  * @brief Sets the orientation of the pushed video frame. The default orientation is portrait.
@@ -1441,18 +845,7 @@ export declare class VeLivePusher {
1441
845
  * @order 9
1442
846
  */
1443
847
  setOrientation(orientation: UIInterfaceOrientation): void;
1444
- /** {zh}
1445
- * @detail api
1446
- * @brief 设置推流水印。
1447
- * @order 35
1448
- * @param image 水印图片。取值为 null 时,表示禁用水印。
1449
- * @param x 水印的水平偏移量,即水印图片相对视频流左上角的横向偏移与视频流宽度的比值,取值范围为 [0.0,1.0]。
1450
- * @param y 水印的垂直偏移量,即水印图片相对视频流左上角的纵向偏移与视频流高度的比值,取值范围为 [0.0,1.0]。
1451
- * @param scale 水印图片的缩放比例,取值范围为 [0.0,1.0]。
1452
- * @return <br>
1453
- * - 0:水印设置成功;
1454
- * - <0:水印设置失败。
1455
- */
848
+
1456
849
  /** {en}
1457
850
  * @detail api
1458
851
  * @brief Sets a watermark for the pushed stream.
@@ -1466,12 +859,7 @@ export declare class VeLivePusher {
1466
859
  * - <0: Failure.
1467
860
  */
1468
861
  setWatermark(image: UIImage, x: float, y: float, scale: float): Promise<int>;
1469
- /** {zh}
1470
- * @detail api
1471
- * @brief 视频截图。
1472
- * @order 34
1473
- * @param listener 截图监听对象,详情请参见 [VeLiveSnapshotListener](155319#VeLiveSnapshotListener)。
1474
- */
862
+
1475
863
  /** {en}
1476
864
  * @detail api
1477
865
  * @brief Takes a screenshot.
@@ -1479,25 +867,7 @@ export declare class VeLivePusher {
1479
867
  * @order 34
1480
868
  */
1481
869
  snapshot(listener: id<VeLiveSnapshotListener>): void;
1482
- /** {zh}
1483
- * @detail api
1484
- * @brief 通过视频帧发送 SEI 消息。
1485
- * @notes
1486
- * 该接口需要在调用 [startPush:](#VeLivePusher-startpush) 或 [startPushWithUrls:](#VeLivePusher-startpushwithurls) 方法之后调用。
1487
- * @order 41
1488
- * @param key SEI 消息为 JSON 格式的字符串。此参数为 JSON 结构中的 Key。
1489
- * @param value SEI 消息为 JSON 格式的字符串。此参数为 JSON 结构中的 Value。
1490
- * @param repeat 消息发送重复的次数。例如,`repeat` 取值为 20,`isKeyFrame` 取值为 YES,则会在调用该方法后连续 20 个关键帧中添加 SEI 消息。
1491
- * @param isKeyFrame 是否仅在关键帧中包含 SEI 消息。<br>
1492
- * - YES:仅在关键帧中包含;
1493
- * - NO:所有帧中均包含。
1494
- * @param allowsCovered 是否允许覆盖。<br>
1495
- * - YES:允许;
1496
- * - NO:不允许。
1497
- * @return <br>
1498
- * - 0:成功;
1499
- * - <0:失败。
1500
- */
870
+
1501
871
  /** {en}
1502
872
  * @detail api
1503
873
  * @brief Sends an SEI message through the video frame. The SEI messages are strings in JSON format.
@@ -1518,17 +888,7 @@ export declare class VeLivePusher {
1518
888
  * - <0: Failure.
1519
889
  */
1520
890
  sendSeiMessage(key: NSString, value: id, repeat: int, isKeyFrame: BOOL, allowsCovered: BOOL): int;
1521
- /** {zh}
1522
- * @detail api
1523
- * @brief 推送外部视频帧数据。
1524
- * @notes
1525
- * 该接口需要在 [startVideoCapture:](#VeLivePusher-startvideocapture) 方法中设置 [VeLiveVideoCaptureType](155321#VeLiveVideoCaptureType) 为 VeLiveVideoCaptureExternal。
1526
- * @order 37
1527
- * @param frame 视频帧的数据信息,详情请参见 [VeLiveVideoFrame](155321#VeLiveVideoFrame)。
1528
- * @return <br>
1529
- * - 0:成功;
1530
- * - <0:失败。
1531
- */
891
+
1532
892
  /** {en}
1533
893
  * @detail api
1534
894
  * @brief Pushes an external video frame.
@@ -1541,17 +901,7 @@ export declare class VeLivePusher {
1541
901
  * - <0: Failure.
1542
902
  */
1543
903
  pushExternalVideoFrame(frame: VeLiveVideoFrame): int;
1544
- /** {zh}
1545
- * @detail api
1546
- * @brief 推送外部视频编码数据。
1547
- * @notes
1548
- * 该接口需要在 [startVideoCapture:](#VeLivePusher-startvideocapture) 方法中设置 [VeLiveVideoCaptureType](155321#VeLiveVideoCaptureType) 为 VeLiveVideoCaptureFrontCamera 或 VeLiveVideoCaptureExternal。
1549
- * @order 38
1550
- * @param encodeFrame 视频编码帧的数据信息,详情请参见 [VeLiveVideoEncodeFrame](155321#VeLiveVideoEncodeFrame)。
1551
- * @return <br>
1552
- * - 0:成功;
1553
- * - <0:失败。
1554
- */
904
+
1555
905
  /** {en}
1556
906
  * @detail api
1557
907
  * @brief Pushes an external encoded video frame.
@@ -1564,17 +914,7 @@ export declare class VeLivePusher {
1564
914
  * - <0: Failure.
1565
915
  */
1566
916
  pushExternalVideoEncodeFrame(encodeFrame: VeLiveVideoEncodeFrame): int;
1567
- /** {zh}
1568
- * @detail api
1569
- * @brief 推送外部音频帧数据。
1570
- * @notes
1571
- * 该接口需要在 [startAudioCapture:](#VeLivePusher-startaudiocapture) 方法中设置 [VeLiveAudioCaptureType](155321#VeLiveAudioCaptureType) 为 VeLiveAudioCaptureExternal。
1572
- * @order 39
1573
- * @param frame 外部音频数据。详情请参见 [VeLiveAudioFrame](155321#VeLiveAudioFrame)。
1574
- * @return <br>
1575
- * - 0:成功;
1576
- * - <0:失败。
1577
- */
917
+
1578
918
  /** {en}
1579
919
  * @detail api
1580
920
  * @brief Pushes an external audio frame.
@@ -1587,16 +927,7 @@ export declare class VeLivePusher {
1587
927
  * - <0: Failure.
1588
928
  */
1589
929
  pushExternalAudioFrame(frame: VeLiveAudioFrame): int;
1590
- /** {zh}
1591
- * @detail api
1592
- * @brief 高级配置。您可通过提交工单联系[技术支持](https://console.volcengine.com/workorder/create?step=3&SubProductID=P00000076),了解配置方法。
1593
- * @order 42
1594
- * @param key 推流高级配置为 JSON 格式的字符串,此参数为 JSON 结构中的 Key。
1595
- * @param value 推流高级配置为 JSON 格式的字符串,此参数为 JSON 结构中的 Value。建议传入 NSDictionary 或者 NSString 对象。
1596
- * @return <br>
1597
- * - 0:成功;
1598
- * - -1:失败,参数错误。
1599
- */
930
+
1600
931
  /** {en}
1601
932
  * @detail api
1602
933
  * @brief Set advanced configurations. You can [create a ticket](https://console.byteplus.com/workorder/create?step=2&SubProductID=P00000980) to contact BytePlus technical support for more information about how to use this method.
@@ -1608,13 +939,7 @@ export declare class VeLivePusher {
1608
939
  * - -1: Failure.
1609
940
  */
1610
941
  setProperty(key: NSString, value: id): int;
1611
- /** {zh}
1612
- * @detail api
1613
- * @brief 强制请求 IDR 帧,发起请求以编码一个新的 IDR 帧。
1614
- * @notes
1615
- * 该接口需要在调用 [startPush:](#VeLivePusher-startpush) 或 [startPushWithUrls:](#VeLivePusher-startpushwithurls) 方法之后调用。
1616
- * @order 49
1617
- */
942
+
1618
943
  /** {en}
1619
944
  * @detail api
1620
945
  * @brief Request to encode a new IDR frame.
@@ -1625,15 +950,7 @@ export declare class VeLivePusher {
1625
950
  requestIDRFrame(): void;
1626
951
  }
1627
952
  export declare class VeLiveVideoEffectManager {
1628
- /** {zh}
1629
- * @detail api
1630
- * @brief 视频特效许可证配置,用于初始化视频特效管理对象。
1631
- * @order 2
1632
- * @param config 特效初始化配置,详情请参见 [VeLiveVideoEffectLicenseConfiguration](155321#VeLiveVideoEffectLicenseConfiguration)。
1633
- * @return <br>
1634
- * - 0:调用成功;
1635
- * - -1:调用失败。
1636
- */
953
+
1637
954
  /** {en}
1638
955
  * @detail api
1639
956
  * @brief Initializes the special effects manager.
@@ -1644,15 +961,7 @@ export declare class VeLiveVideoEffectManager {
1644
961
  * - -1: Failure.
1645
962
  */
1646
963
  setupWithConfig(config: VeLiveVideoEffectLicenseConfiguration): int;
1647
- /** {zh}
1648
- * @detail api
1649
- * @brief 在许可证过期后,可调用该方法更新 License,本方法仅对在线 License 有效。
1650
- * @notes
1651
- * - 需要通过调用 [setupWithConfig:](155318#VeLiveVideoEffectManager-setupwithconfig) 设置视频特效许可证后调用;
1652
- * - 本方法为异步操作。
1653
- * @order 3
1654
- * @param completion 结果回调信息。
1655
- */
964
+
1656
965
  /** {en}
1657
966
  * @detail api
1658
967
  * @brief Updates the special effects license after the existing license expires. This method is effective only if you authenticate the license online.
@@ -1663,17 +972,7 @@ export declare class VeLiveVideoEffectManager {
1663
972
  * @order 76
1664
973
  */
1665
974
  updateLicense(completion: (result: number, message: string) => void): void;
1666
- /** {zh}
1667
- * @detail api
1668
- * @brief 设置特效算法模型包的路径。
1669
- * @notes <br>
1670
- * 需要通过调用 setupWithConfig:{@link #VeLiveVideoEffectManager#setupWithConfig} 设置视频特效许可证后调用。
1671
- * @order 4
1672
- * @param path 特效算法模型包的路径。
1673
- * @return <br>
1674
- * - 0:调用成功;
1675
- * - -1:调用失败。
1676
- */
975
+
1677
976
  /** {en}
1678
977
  * @detail api
1679
978
  * @brief Sets the path to the algorithm models of the special effects.
@@ -1686,22 +985,7 @@ export declare class VeLiveVideoEffectManager {
1686
985
  * - -1: Failure.
1687
986
  */
1688
987
  setAlgoModelPath(path: NSString): int;
1689
- /** {zh}
1690
- * @detail api
1691
- * @brief 创建/销毁特效引擎。
1692
- * @notes
1693
- * - 该方法需要在调用 [setupWithConfig:](#VeLiveVideoEffectManager-setupwithconfig) 和 [setAlgoModelPath:](#VeLiveVideoEffectManager-setalgomodelpath) 后调用;
1694
- * - 该方法不直接开启/关闭视频特效,您需要在调用该方法后,调用 [setComposeNodes:](#VeLiveVideoEffectManager-setcomposenodes) 开启视频特效;
1695
- * - 通用场景下,特效引擎会随 EffectManager 销毁而销毁。如果您对性能有较高要求,也可以在不使用特效相关功能时,调用该方法销毁特效引擎;
1696
- * - 如果重复创建/销毁特效引擎,会产生时间消耗。
1697
- * @order 5
1698
- * @param enable 是否创建特效引擎。默认为 NO。 <br>
1699
- * - YES:创建;
1700
- * - NO:销毁。
1701
- * @return <br>
1702
- * - 0:调用成功;
1703
- * - -1:调用失败。
1704
- */
988
+
1705
989
  /** {en}
1706
990
  * @detail api
1707
991
  * @brief Creates or destroys the special effects engine.
@@ -1719,19 +1003,7 @@ export declare class VeLiveVideoEffectManager {
1719
1003
  * - -1: Failure.
1720
1004
  */
1721
1005
  setEnable(enable: BOOL): int;
1722
- /** {zh}
1723
- * @detail api
1724
- * @brief 设置视频特效组合。支持设置 ComposeMakeup.bundle 中的功能,包括美颜、美形、美体、美妆等。
1725
- * @notes
1726
- * - 需要在调用 [setEnable:](#VeLiveVideoEffectManager-setenable) 创建特效引擎后,调用本方法;
1727
- * - 重复调用本方法,仅最后一次调用生效;
1728
- * - 如果需要在当前的视频特效组合中叠加特效,可调用 [appendComposeNodes:](#VeLiveVideoEffectManager-appendcomposenodes) 方法。
1729
- * @order 6
1730
- * @param nodes 视频特效素材包路径数组。
1731
- * @return <br>
1732
- * - 0:调用成功;
1733
- * - -1:调用失败。
1734
- */
1006
+
1735
1007
  /** {en}
1736
1008
  * @detail api
1737
1009
  * @brief Sets the special effects you want to apply to the video. You can choose effects from ComposeMakeup.bundle.
@@ -1746,16 +1018,7 @@ export declare class VeLiveVideoEffectManager {
1746
1018
  * - -1: Failure.
1747
1019
  */
1748
1020
  setComposeNodes(nodes: NSArray<NSString>): int;
1749
- /** {zh}
1750
- * @detail api
1751
- * @brief 调用本方法,会在 [setComposeNodes:](#VeLiveVideoEffectManager-setcomposenodes) 设置的视频特效组合的基础上叠加特效。
1752
- * @notes 需要在调用 [setEnable:](#VeLiveVideoEffectManager-setenable) 创建特效引擎后,调用本方法。
1753
- * @order 7
1754
- * @param nodes 视频特效素材包路径数组。
1755
- * @return <br>
1756
- * - 0:调用成功;
1757
- * - -1:调用失败。
1758
- */
1021
+
1759
1022
  /** {en}
1760
1023
  * @detail api
1761
1024
  * @brief Adds one or more effects to the existing effects settings that you have configured with [setComposeNodes:](#VeLiveVideoEffectManager-setcomposenodes).
@@ -1767,16 +1030,7 @@ export declare class VeLiveVideoEffectManager {
1767
1030
  * - -1: Failure.
1768
1031
  */
1769
1032
  appendComposeNodes(nodes: NSArray<NSString>): int;
1770
- /** {zh}
1771
- * @detail api
1772
- * @brief 调用本方法,可移除调用 [setComposeNodes:](#VeLiveVideoEffectManager-setcomposenodes) 和 [ppendComposeNodes:](#VeLiveVideoEffectManager-appendcomposenodes) 设置的视频特效资源。
1773
- * @notes 需要在调用 [setEnable:](#VeLiveVideoEffectManager-setenable) 创建特效引擎后,调用本方法。
1774
- * @order 8
1775
- * @param nodes 视频特效素材包路径数组。
1776
- * @return <br>
1777
- * - 0:调用成功;
1778
- * - -1:调用失败。
1779
- */
1033
+
1780
1034
  /** {en}
1781
1035
  * @detail api
1782
1036
  * @brief Removes one or more special effects resources set by the [setComposeNodes:](#VeLiveVideoEffectManager-setcomposenodes) or [ppendComposeNodes:](#VeLiveVideoEffectManager-appendcomposenodes) methods.
@@ -1788,20 +1042,7 @@ export declare class VeLiveVideoEffectManager {
1788
1042
  * - -1: Failure.
1789
1043
  */
1790
1044
  removeComposeNodes(nodes: NSArray<NSString>): int;
1791
- /** {zh}
1792
- * @detail api
1793
- * @brief 设置视频特效强度。
1794
- * @notes
1795
- * - 需要在调用 [setComposeNodes:](#VeLiveVideoEffectManager-setcomposenodes) 设置视频特效组合或调用 [appendComposeNodes:](#VeLiveVideoEffectManager-appendcomposenodes) 叠加视频特效素材包后,调用本方法;
1796
- * - 该方法仅适用于同时含有上述三个参数的特效资源,对于没有强度参数的特效(如贴纸),该方法无效。
1797
- * @order 9
1798
- * @param node 视频特效素材包路径。
1799
- * @param key 需要设置的素材 key 名称
1800
- * @param intensity 需要设置的强度值。取值范围为 [0.0,1.0]。
1801
- * @return <br>
1802
- * - 0:调用成功;
1803
- * - -1:调用失败。
1804
- */
1045
+
1805
1046
  /** {en}
1806
1047
  * @detail api
1807
1048
  * @brief Sets the intensity of a special effect.
@@ -1817,17 +1058,7 @@ export declare class VeLiveVideoEffectManager {
1817
1058
  * - -1: Failure.
1818
1059
  */
1819
1060
  updateComposerNodeIntensity(node: NSString, key: NSString, intensity: float): int;
1820
- /** {zh}
1821
- * @detail api
1822
- * @brief 设置颜色滤镜。
1823
- * @notes
1824
- * 请在调用 [setEnable:](#VeLiveVideoEffectManager-setenable) 开启视频特效后,调用该方法。
1825
- * @order 11
1826
- * @param path 滤镜资源包绝对路径。
1827
- * @return <br>
1828
- * - 0:调用成功;
1829
- * - -1:调用失败。
1830
- */
1061
+
1831
1062
  /** {en}
1832
1063
  * @detail api
1833
1064
  * @brief Sets the color filter.
@@ -1840,17 +1071,7 @@ export declare class VeLiveVideoEffectManager {
1840
1071
  * - -1: Failure.
1841
1072
  */
1842
1073
  setFilter(path: NSString): int;
1843
- /** {zh}
1844
- * @detail api
1845
- * @brief 设置已启用的颜色滤镜强度。
1846
- * @notes
1847
- * 请在调用 [setFilter:](#VeLiveVideoEffectManager-setfilter) 设置颜色滤镜后调用。
1848
- * @order 12
1849
- * @param intensity 滤镜强度,取值范围为 [0.0,1.0]。
1850
- * @return <br>
1851
- * - 0:调用成功;
1852
- * - -1:调用失败。
1853
- */
1074
+
1854
1075
  /** {en}
1855
1076
  * @detail api
1856
1077
  * @brief Sets the intensity of the color filter.
@@ -1863,17 +1084,7 @@ export declare class VeLiveVideoEffectManager {
1863
1084
  * - -1: Failure.
1864
1085
  */
1865
1086
  updateFilterIntensity(intensity: float): int;
1866
- /** {zh}
1867
- * @detail api
1868
- * @brief 设置贴纸特效。
1869
- * @notes
1870
- * 请在调用 [setEnable:](#VeLiveVideoEffectManager-setenable) 开启视频特效后,调用该方法。
1871
- * @order 10
1872
- * @param path 贴纸素材包的绝对路径。
1873
- * @return <br>
1874
- * - 0:调用成功;
1875
- * - -1:调用失败。
1876
- */
1087
+
1877
1088
  /** {en}
1878
1089
  * @detail api
1879
1090
  * @brief Sets the sticker.
@@ -1886,15 +1097,7 @@ export declare class VeLiveVideoEffectManager {
1886
1097
  * - -1: Failure.
1887
1098
  */
1888
1099
  setSticker(path: NSString): int;
1889
- /** {zh}
1890
- * @detail api
1891
- * @brief 智能美化特效(简称 CV)高级接口。
1892
- * @notes
1893
- * 请在调用 [setEnable:](#VeLiveVideoEffectManager-setenable) 开启视频特效后,调用该方法,不要在主线程中频繁执行同步操作。
1894
- * @param callback 回调 CV 的 handle。
1895
- * @param isGLThread 是否在 GL 线程回调 callback。
1896
- * @param isAsync 是否同步执行 callback。
1897
- */
1100
+
1898
1101
  /** {en}
1899
1102
  * @detail api
1900
1103
  * @brief Advanced settings for special effects.