@agora-js/media 4.20.1 → 4.20.2-1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/media.d.ts CHANGED
@@ -803,7 +803,7 @@ export declare interface CameraVideoTrackInitConfig {
803
803
  */
804
804
  cameraId?: string;
805
805
  /**
806
- * **自从**
806
+ * @自从
807
807
  * <br>&emsp;&emsp;&emsp;*4.0.0*
808
808
  *
809
809
  * 传输优化模式。设置该值后,SDK 会自动调整码率配置以及使用不同的回退策略。
@@ -818,7 +818,7 @@ export declare interface CameraVideoTrackInitConfig {
818
818
  * > 注意事项:该方法只支持 Chrome 浏览器。
819
819
  */
820
820
  /** @en
821
- * **Since**
821
+ * @since
822
822
  * <br>&emsp;&emsp;&emsp;*4.0.0*
823
823
  *
824
824
  * Transmission optimization mode. Whether to prioritize video quality or smoothness:
@@ -835,7 +835,7 @@ export declare interface CameraVideoTrackInitConfig {
835
835
  optimizationMode?: "motion" | "detail";
836
836
  /**
837
837
  * @ignore
838
- * **自从**
838
+ * @自从
839
839
  * <br>&emsp;&emsp;&emsp;*4.18.0*
840
840
  *
841
841
  * SVC (可伸缩视频编码)配置。
@@ -845,7 +845,7 @@ export declare interface CameraVideoTrackInitConfig {
845
845
  /** @en
846
846
  * @ignore
847
847
  *
848
- * **Since**
848
+ * @since
849
849
  * <br>&emsp;&emsp;&emsp;*4.18.0*
850
850
  *
851
851
  * Configurations for Scalable Video Coding (SVC).
@@ -1002,7 +1002,7 @@ export declare interface CustomVideoTrackInitConfig {
1002
1002
  */
1003
1003
  mediaStreamTrack: MediaStreamTrack;
1004
1004
  /**
1005
- * **自从**
1005
+ * @自从
1006
1006
  * <br>&emsp;&emsp;&emsp;*4.17.1*
1007
1007
  *
1008
1008
  * 视频的分辨率宽。
@@ -1012,7 +1012,7 @@ export declare interface CustomVideoTrackInitConfig {
1012
1012
  * 关于约束对象的详细说明可以参考 [ConstrainLong]{@link ConstrainLong}。
1013
1013
  */
1014
1014
  /** @en
1015
- * **Since**
1015
+ * @since
1016
1016
  * <br>&emsp;&emsp;&emsp;*4.17.1*
1017
1017
  *
1018
1018
  * Width of the video.
@@ -1023,7 +1023,7 @@ export declare interface CustomVideoTrackInitConfig {
1023
1023
  */
1024
1024
  width?: number | ConstrainLong;
1025
1025
  /**
1026
- * **自从**
1026
+ * @自从
1027
1027
  * <br>&emsp;&emsp;&emsp;*4.17.1*
1028
1028
  *
1029
1029
  * 视频的分辨率高。
@@ -1033,7 +1033,7 @@ export declare interface CustomVideoTrackInitConfig {
1033
1033
  * 关于约束对象的详细说明可以参考 [ConstrainLong]{@link ConstrainLong}。
1034
1034
  */
1035
1035
  /** @en
1036
- * **Since**
1036
+ * @since
1037
1037
  * <br>&emsp;&emsp;&emsp;*4.17.1*
1038
1038
  *
1039
1039
  * Height of the video.
@@ -1044,7 +1044,7 @@ export declare interface CustomVideoTrackInitConfig {
1044
1044
  */
1045
1045
  height?: number | ConstrainLong;
1046
1046
  /**
1047
- * **自从**
1047
+ * @自从
1048
1048
  * <br>&emsp;&emsp;&emsp;*4.17.1*
1049
1049
  *
1050
1050
  * 视频帧率,单位为 fps。
@@ -1054,7 +1054,7 @@ export declare interface CustomVideoTrackInitConfig {
1054
1054
  * 关于约束对象的详细说明可以参考 [ConstrainLong]{@link ConstrainLong}。
1055
1055
  */
1056
1056
  /** @en
1057
- * **Since**
1057
+ * @since
1058
1058
  * <br>&emsp;&emsp;&emsp;*4.17.1*
1059
1059
  *
1060
1060
  * Frame rate of the video (fps).
@@ -1079,7 +1079,7 @@ export declare interface CustomVideoTrackInitConfig {
1079
1079
  */
1080
1080
  bitrateMax?: number;
1081
1081
  /**
1082
- * **自从**
1082
+ * @自从
1083
1083
  * <br>&emsp;&emsp;&emsp;*4.0.0*
1084
1084
  *
1085
1085
  * 传输优化模式。设置该值后,SDK 会自动调整码率配置以及使用不同的回退策略。
@@ -1094,7 +1094,7 @@ export declare interface CustomVideoTrackInitConfig {
1094
1094
  * > 注意事项:该方法只支持 Chrome 浏览器。
1095
1095
  */
1096
1096
  /** @en
1097
- * **Since**
1097
+ * @since
1098
1098
  * <br>&emsp;&emsp;&emsp;*4.0.0*
1099
1099
  *
1100
1100
  * Transmission optimization mode. Whether to prioritize video quality or smoothness:
@@ -1111,7 +1111,7 @@ export declare interface CustomVideoTrackInitConfig {
1111
1111
  optimizationMode?: "motion" | "detail";
1112
1112
  /**
1113
1113
  * @ignore
1114
- * **自从**
1114
+ * @自从
1115
1115
  * <br>&emsp;&emsp;&emsp;*4.18.0*
1116
1116
  *
1117
1117
  * SVC (可伸缩视频编码)配置。
@@ -1121,7 +1121,7 @@ export declare interface CustomVideoTrackInitConfig {
1121
1121
  /** @en
1122
1122
  * @ignore
1123
1123
  *
1124
- * **Since**
1124
+ * @since
1125
1125
  * <br>&emsp;&emsp;&emsp;*4.18.0*
1126
1126
  *
1127
1127
  * Configurations for Scalable Video Coding (SVC).
@@ -1355,7 +1355,7 @@ declare function event_beauty_effect_overload(): void;
1355
1355
  declare function event_first_frame_decoded(): void;
1356
1356
 
1357
1357
  /**
1358
- * **自从**
1358
+ * @自从
1359
1359
  * <br>&emsp;&emsp;&emsp;*4.20.1*
1360
1360
  *
1361
1361
  * 从 H.264 视频流中解析出 SEI 数据时触发,此事件会返回 SEI 数据。
@@ -1365,7 +1365,7 @@ declare function event_first_frame_decoded(): void;
1365
1365
  * @event
1366
1366
  */
1367
1367
  /** @en
1368
- * **Since**
1368
+ * @since
1369
1369
  * <br>&emsp;&emsp;&emsp;*4.20.1*
1370
1370
  *
1371
1371
  * Parsing SEI data from the H.264 video stream triggers this event, which returns the SEI data.
@@ -1500,7 +1500,7 @@ declare function event_user_datachannel_message(data: ArrayBuffer): void;
1500
1500
  declare function event_user_datachannel_open(): void;
1501
1501
 
1502
1502
  /**
1503
- * **自从**
1503
+ * @自从
1504
1504
  * <br>&emsp;&emsp;&emsp;*4.8.0*
1505
1505
  *
1506
1506
  * 提示 HTML `<video>` 标签的可见状态和不可见原因。SDK 每 30 秒触发一次该事件。
@@ -1512,7 +1512,7 @@ declare function event_user_datachannel_open(): void;
1512
1512
  * @event
1513
1513
  */
1514
1514
  /** @en
1515
- * **Since**
1515
+ * @since
1516
1516
  * <br>&emsp;&emsp;&emsp;*4.8.0*
1517
1517
  *
1518
1518
  * Indicates the visibility of the `<video>` HTML tag.
@@ -1528,7 +1528,7 @@ declare function event_user_datachannel_open(): void;
1528
1528
  declare function event_video_element_visible_status(data?: CheckVideoVisibleResult): void;
1529
1529
 
1530
1530
  /**
1531
- * **自从**
1531
+ * @自从
1532
1532
  * <br>&emsp;&emsp;&emsp;*4.8.0*
1533
1533
  *
1534
1534
  * 提示 HTML `<video>` 标签的可见状态和不可见原因。SDK 每 30 秒触发一次该事件。
@@ -1540,7 +1540,7 @@ declare function event_video_element_visible_status(data?: CheckVideoVisibleResu
1540
1540
  * @event
1541
1541
  */
1542
1542
  /** @en
1543
- * **Since**
1543
+ * @since
1544
1544
  * <br>&emsp;&emsp;&emsp;*4.8.0*
1545
1545
  *
1546
1546
  * Indicates the visibility of the `<video>` HTML tag.
@@ -1705,7 +1705,7 @@ export declare interface IBufferSourceAudioTrack extends ILocalAudioTrack {
1705
1705
  */
1706
1706
  duration: number;
1707
1707
  /**
1708
- * **自从**
1708
+ * @自从
1709
1709
  * <br>&emsp;&emsp;&emsp;*4.18.0*
1710
1710
  *
1711
1711
  * 当前音频文件的播放速度。取值范围为 [50,400],其中:
@@ -1714,7 +1714,7 @@ export declare interface IBufferSourceAudioTrack extends ILocalAudioTrack {
1714
1714
  * - `400`: 4 倍速。
1715
1715
  */
1716
1716
  /** @en
1717
- * **Since**
1717
+ * @since
1718
1718
  * <br>&emsp;&emsp;&emsp;*4.18.0*
1719
1719
  *
1720
1720
  * The playback speed of the current audio file. Valid range is [50, 400], where:
@@ -1805,7 +1805,7 @@ export declare interface IBufferSourceAudioTrack extends ILocalAudioTrack {
1805
1805
  */
1806
1806
  stopProcessAudioBuffer(): void;
1807
1807
  /**
1808
- * **自从**
1808
+ * @自从
1809
1809
  * <br>&emsp;&emsp;&emsp;*4.18.0*
1810
1810
  *
1811
1811
  * 设置当前音频文件的播放速度。
@@ -1818,7 +1818,7 @@ export declare interface IBufferSourceAudioTrack extends ILocalAudioTrack {
1818
1818
  * - `400`: 4 倍速。
1819
1819
  */
1820
1820
  /** @en
1821
- * **Since**
1821
+ * @since
1822
1822
  * <br>&emsp;&emsp;&emsp;*4.18.0*
1823
1823
  *
1824
1824
  * Sets the playback speed for the current audio file.
@@ -1874,7 +1874,7 @@ export declare interface ICameraVideoTrack extends ILocalVideoTrack {
1874
1874
  deviceId: string;
1875
1875
  }>): Promise<void>;
1876
1876
  /**
1877
- * **自从**
1877
+ * @自从
1878
1878
  * <br>&emsp;&emsp;&emsp;*4.0.0*
1879
1879
  *
1880
1880
  * 启用/禁用该轨道。
@@ -1890,7 +1890,7 @@ export declare interface ICameraVideoTrack extends ILocalVideoTrack {
1890
1890
  * - `false`: 禁用该轨道.
1891
1891
  */
1892
1892
  /** @en
1893
- * **Since**
1893
+ * @since
1894
1894
  * <br>&emsp;&emsp;&emsp;*4.0.0*
1895
1895
  *
1896
1896
  * Enables/Disables the track.
@@ -1907,7 +1907,7 @@ export declare interface ICameraVideoTrack extends ILocalVideoTrack {
1907
1907
  */
1908
1908
  setEnabled(enabled: boolean): Promise<void>;
1909
1909
  /**
1910
- * **自从**
1910
+ * @自从
1911
1911
  * <br>&emsp;&emsp;&emsp;*4.19.0*
1912
1912
  *
1913
1913
  * 复制当前的视频轨道对象,生成一个新的视频轨道。
@@ -1919,7 +1919,7 @@ export declare interface ICameraVideoTrack extends ILocalVideoTrack {
1919
1919
  * @returns 新生成的视频轨道。
1920
1920
  */
1921
1921
  /** @en
1922
- * **Since**
1922
+ * @since
1923
1923
  * <br>&emsp;&emsp;&emsp;*4.19.0*
1924
1924
  *
1925
1925
  * Clones the current video track to create a new video track.
@@ -2065,7 +2065,7 @@ export declare interface ILocalAudioTrack extends ILocalTrack {
2065
2065
  */
2066
2066
  play(): void;
2067
2067
  /**
2068
- * **自从**
2068
+ * @自从
2069
2069
  * <br>&emsp;&emsp;&emsp;*4.1.0*
2070
2070
  *
2071
2071
  * > 注意事项:
@@ -2076,7 +2076,7 @@ export declare interface ILocalAudioTrack extends ILocalTrack {
2076
2076
  * @param deviceId 设备 ID,可以通过 [[getPlaybackDevices]] 方法获取。
2077
2077
  */
2078
2078
  /** @en
2079
- * **Since**
2079
+ * @since
2080
2080
  * <br>&emsp;&emsp;&emsp;*4.1.0*
2081
2081
  *
2082
2082
  * > Note:
@@ -2090,17 +2090,17 @@ export declare interface ILocalAudioTrack extends ILocalTrack {
2090
2090
  /**
2091
2091
  * 获取本地音频轨道的质量相关信息。
2092
2092
  *
2093
- * **DEPRECATED**
2093
+ * @deprecated
2094
2094
  * 自 v4.1.0 起废弃,请使用 [AgoraRTCClient.getLocalVideoStats]{@link IAgoraRTCClient.getLocalVideoStats} 和 [AgoraRTCClient.getLocalAudioStats]{@link IAgoraRTCClient.getLocalAudioStats}。
2095
2095
  */
2096
2096
  /** @en
2097
2097
  * Gets the statistics of a local audio track.
2098
2098
  *
2099
- * **DEPRECATED** from v4.1.0. Use [AgoraRTCClient.getLocalVideoStats]{@link IAgoraRTCClient.getLocalVideoStats} and [AgoraRTCClient.getLocalAudioStats]{@link IAgoraRTCClient.getLocalAudioStats} instead.
2099
+ * @deprecated from v4.1.0. Use [AgoraRTCClient.getLocalVideoStats]{@link IAgoraRTCClient.getLocalVideoStats} and [AgoraRTCClient.getLocalAudioStats]{@link IAgoraRTCClient.getLocalAudioStats} instead.
2100
2100
  */
2101
2101
  getStats(): LocalAudioTrackStats;
2102
2102
  /**
2103
- * **自从**
2103
+ * @自从
2104
2104
  * <br>&emsp;&emsp;&emsp;*4.10.0*
2105
2105
  *
2106
2106
  * 将 `Processor` 注入本地音频轨道。
@@ -2117,26 +2117,26 @@ export declare interface ILocalAudioTrack extends ILocalTrack {
2117
2117
  */
2118
2118
  pipe(processor: IAudioProcessor): IAudioProcessor;
2119
2119
  /**
2120
- * **自从**
2120
+ * @自从
2121
2121
  * <br>&emsp;&emsp;&emsp;*4.10.0*
2122
2122
  *
2123
2123
  * 取消本地音频轨道上注入的 `Processor`。
2124
2124
  */
2125
2125
  /** @en
2126
- * **Since**
2126
+ * @since
2127
2127
  * <br>&emsp;&emsp;&emsp;*4.10.0*
2128
2128
  *
2129
2129
  * Removes the `Processor` inserted to the local audio track.
2130
2130
  */
2131
2131
  unpipe(): void;
2132
2132
  /**
2133
- * **自从**
2133
+ * @自从
2134
2134
  * <br>&emsp;&emsp;&emsp;*4.10.0*
2135
2135
  *
2136
2136
  * 本地音频轨道上当前媒体处理链路的最终节点。
2137
2137
  */
2138
2138
  /** @en
2139
- * **Since**
2139
+ * @since
2140
2140
  * <br>&emsp;&emsp;&emsp;*4.10.0*
2141
2141
  *
2142
2142
  * The destination of the current processing pipeline on the local audio track.
@@ -2187,7 +2187,7 @@ export declare interface ILocalTrack extends ITrack {
2187
2187
  */
2188
2188
  on(event: "transceiver-updated", listener: typeof event_transceiver_updated): void;
2189
2189
  /**
2190
- * **自从**
2190
+ * @自从
2191
2191
  * <br>&emsp;&emsp;&emsp;*4.0.0*
2192
2192
  *
2193
2193
  * 启用/禁用该轨道。
@@ -2203,7 +2203,7 @@ export declare interface ILocalTrack extends ITrack {
2203
2203
  * - `false`: 禁用该轨道。
2204
2204
  */
2205
2205
  /** @en
2206
- * **Since**
2206
+ * @since
2207
2207
  * <br>&emsp;&emsp;&emsp;*4.0.0*
2208
2208
  *
2209
2209
  * Enables/Disables the track.
@@ -2220,7 +2220,7 @@ export declare interface ILocalTrack extends ITrack {
2220
2220
  */
2221
2221
  setEnabled(enabled: boolean): Promise<void>;
2222
2222
  /**
2223
- * **DEPRECATED**
2223
+ * @deprecated
2224
2224
  * 自 v4.1.0 起废弃,请使用 [AgoraRTCClient.getLocalVideoStats]{@link IAgoraRTCClient.getLocalVideoStats} 和 [AgoraRTCClient.getLocalAudioStats]{@link IAgoraRTCClient.getLocalAudioStats}。
2225
2225
  *
2226
2226
  * 获取本地轨道相关信息。
@@ -2228,7 +2228,7 @@ export declare interface ILocalTrack extends ITrack {
2228
2228
  * > 注意事项:获取本地视频轨道数据时,iOS 上无法获取到 `encodeDelay` 字段。
2229
2229
  */
2230
2230
  /** @en
2231
- * **DEPRECATED** from v4.1.0. Use [AgoraRTCClient.getLocalVideoStats]{@link IAgoraRTCClient.getLocalVideoStats} and [AgoraRTCClient.getLocalAudioStats]{@link IAgoraRTCClient.getLocalAudioStats} instead.
2231
+ * @deprecated from v4.1.0. Use [AgoraRTCClient.getLocalVideoStats]{@link IAgoraRTCClient.getLocalVideoStats} and [AgoraRTCClient.getLocalAudioStats]{@link IAgoraRTCClient.getLocalAudioStats} instead.
2232
2232
  *
2233
2233
  * Gets the statistics of a local track.
2234
2234
  *
@@ -2255,7 +2255,7 @@ export declare interface ILocalTrack extends ITrack {
2255
2255
  /**
2256
2256
  * 发送或暂停发送该轨道的媒体数据。
2257
2257
  *
2258
- * **自从**
2258
+ * @自从
2259
2259
  * <br>&emsp;&emsp;&emsp;*4.6.0*
2260
2260
  *
2261
2261
  * 如果该轨道已发布,调用 `setMuted(true)` 后,远端会触发 [user-unpublished]{@link IAgoraRTCClient.event_user_unpublished} 事件。再调用 `setMuted(false)` 后,远端会触发 [user-published]{@link IAgoraRTCClient.event_user_published} 事件。
@@ -2270,7 +2270,7 @@ export declare interface ILocalTrack extends ITrack {
2270
2270
  /** @en
2271
2271
  * Sends or stops sending the media data of the track.
2272
2272
  *
2273
- * **Since**
2273
+ * @since
2274
2274
  * <br>&emsp;&emsp;&emsp;*4.6.0*
2275
2275
  *
2276
2276
  * If the track is published, a successful call of `setMuted(true)` triggers the [user-unpublished]{@link IAgoraRTCClient.event_user_unpublished} event on the remote client, and a successful call of `setMuted(false)` triggers the [user-published]{@link IAgoraRTCClient.event_user_published} event.
@@ -2370,18 +2370,18 @@ export declare interface ILocalVideoTrack extends ILocalTrack {
2370
2370
  /**
2371
2371
  * 获取本地视频轨道的相关信息。
2372
2372
  *
2373
- * **DEPRECATED**
2373
+ * @deprecated
2374
2374
  * 自 v4.1.0 起废弃,请使用 [AgoraRTCClient.getLocalVideoStats]{@link IAgoraRTCClient.getLocalVideoStats} 和 [AgoraRTCClient.getLocalAudioStats]{@link IAgoraRTCClient.getLocalAudioStats}。
2375
2375
  *
2376
2376
  */
2377
2377
  /** @en
2378
2378
  * Gets the statistics of a local video track.
2379
2379
  *
2380
- * **DEPRECATED** from v4.1.0. Use [AgoraRTCClient.getLocalVideoStats]{@link IAgoraRTCClient.getLocalVideoStats} and [AgoraRTCClient.getLocalAudioStats]{@link IAgoraRTCClient.getLocalAudioStats} instead.
2380
+ * @deprecated from v4.1.0. Use [AgoraRTCClient.getLocalVideoStats]{@link IAgoraRTCClient.getLocalVideoStats} and [AgoraRTCClient.getLocalAudioStats]{@link IAgoraRTCClient.getLocalAudioStats} instead.
2381
2381
  */
2382
2382
  getStats(): LocalVideoTrackStats;
2383
2383
  /**
2384
- * **自从**
2384
+ * @自从
2385
2385
  * <br>&emsp;&emsp;&emsp;*4.19.0*
2386
2386
  *
2387
2387
  * 复制当前的视频轨道对象,生成一个新的视频轨道。
@@ -2393,7 +2393,7 @@ export declare interface ILocalVideoTrack extends ILocalTrack {
2393
2393
  * @returns 新生成的视频轨道。
2394
2394
  */
2395
2395
  /** @en
2396
- * **Since**
2396
+ * @since
2397
2397
  * <br>&emsp;&emsp;&emsp;*4.19.0*
2398
2398
  *
2399
2399
  * Clones the current video track to create a new video track.
@@ -2447,7 +2447,7 @@ export declare interface ILocalVideoTrack extends ILocalTrack {
2447
2447
  */
2448
2448
  setBeautyEffect(enabled: boolean, options?: BeautyEffectOptions): Promise<void>;
2449
2449
  /**
2450
- * **自从**
2450
+ * @自从
2451
2451
  * <br>&emsp;&emsp;&emsp;*4.1.0*
2452
2452
  *
2453
2453
  * 获取当前渲染的视频帧数据。
@@ -2457,7 +2457,7 @@ export declare interface ILocalVideoTrack extends ILocalTrack {
2457
2457
  * @returns 存储了 RGBA 数据的 `ImageData` 对象。该对象为浏览器原生对象,详见 [ImageData](https://developer.mozilla.org/zh-CN/docs/Web/API/ImageData)。
2458
2458
  */
2459
2459
  /** @en
2460
- * **Since**
2460
+ * @since
2461
2461
  * <br>&emsp;&emsp;&emsp;*4.1.0*
2462
2462
  *
2463
2463
  * Gets the data of the video frame being rendered.
@@ -2476,7 +2476,7 @@ export declare interface ILocalVideoTrack extends ILocalTrack {
2476
2476
  */
2477
2477
  getCurrentFrameImage(imageType: string, quality: number): Promise<ImageTypedData>;
2478
2478
  /**
2479
- * **自从**
2479
+ * @自从
2480
2480
  * <br>&emsp;&emsp;&emsp;*4.2.0*
2481
2481
  *
2482
2482
  * 设置视频传输优化模式。
@@ -2497,7 +2497,7 @@ export declare interface ILocalVideoTrack extends ILocalTrack {
2497
2497
  * - 大部分情况下,SDK 不会降低帧率,但是可能会降低发送分辨率。
2498
2498
  */
2499
2499
  /** @en
2500
- * **Since**
2500
+ * @since
2501
2501
  * <br>&emsp;&emsp;&emsp;*4.2.0*
2502
2502
  *
2503
2503
  * Sets the video transmission optimization mode.
@@ -2519,7 +2519,7 @@ export declare interface ILocalVideoTrack extends ILocalTrack {
2519
2519
  */
2520
2520
  setOptimizationMode(mode: "balanced" | "motion" | "detail"): Promise<void>;
2521
2521
  /**
2522
- * * **自从**
2522
+ * * @自从
2523
2523
  * <br>&emsp;&emsp;&emsp;*4.8.0*
2524
2524
  *
2525
2525
  * 获取 HTML `<video>` 标签的可见状态和不可见原因。
@@ -2532,7 +2532,7 @@ export declare interface ILocalVideoTrack extends ILocalTrack {
2532
2532
  * - `<video>` 标签不是通过 `play` 方法调用产生的。
2533
2533
  */
2534
2534
  /** @en
2535
- * **Since**
2535
+ * @since
2536
2536
  * <br>&emsp;&emsp;&emsp;*4.8.0*
2537
2537
  *
2538
2538
  * Gets the visibility of the `<video>` HTML tag.
@@ -2546,7 +2546,7 @@ export declare interface ILocalVideoTrack extends ILocalTrack {
2546
2546
  */
2547
2547
  getVideoElementVisibleStatus(): CheckVideoVisibleResult | undefined;
2548
2548
  /**
2549
- * **自从**
2549
+ * @自从
2550
2550
  * <br>&emsp;&emsp;&emsp;*4.10.0*
2551
2551
  *
2552
2552
  * 将 `Processor` 注入本地视频轨道。
@@ -2563,33 +2563,33 @@ export declare interface ILocalVideoTrack extends ILocalTrack {
2563
2563
  */
2564
2564
  pipe(processor: IBaseProcessor): IBaseProcessor;
2565
2565
  /**
2566
- * **自从**
2566
+ * @自从
2567
2567
  * <br>&emsp;&emsp;&emsp;*4.10.0*
2568
2568
  *
2569
2569
  * 取消本地视频轨道上注入的 `Processor`。
2570
2570
  */
2571
2571
  /** @en
2572
- * **Since**
2572
+ * @since
2573
2573
  * <br>&emsp;&emsp;&emsp;*4.10.0*
2574
2574
  *
2575
2575
  * Removes the `Processor` inserted to the local video track.
2576
2576
  */
2577
2577
  unpipe(): void;
2578
2578
  /**
2579
- * **自从**
2579
+ * @自从
2580
2580
  * <br>&emsp;&emsp;&emsp;*4.10.0*
2581
2581
  *
2582
2582
  * 本地视频轨道上当前媒体处理链路的最终节点。
2583
2583
  */
2584
2584
  /** @en
2585
- * **Since**
2585
+ * @since
2586
2586
  * <br>&emsp;&emsp;&emsp;*4.10.0*
2587
2587
  *
2588
2588
  * The destination of the current processing pipeline on the local video track.
2589
2589
  */
2590
2590
  processorDestination: IBaseProcessor;
2591
2591
  /**
2592
- * **自从**
2592
+ * @自从
2593
2593
  * <br>&emsp;&emsp;&emsp;*4.17.0*
2594
2594
  *
2595
2595
  * 替换本地视频轨道。
@@ -2627,7 +2627,7 @@ export declare interface ILocalVideoTrack extends ILocalTrack {
2627
2627
  * - 保留原有的视频轨道。
2628
2628
  */
2629
2629
  /** @en
2630
- * **Since**
2630
+ * @since
2631
2631
  * <br>&emsp;&emsp;&emsp;*4.17.0*
2632
2632
  *
2633
2633
  * Replaces the local video track.
@@ -2721,7 +2721,7 @@ export declare interface IMicrophoneAudioTrack extends ILocalAudioTrack {
2721
2721
  */
2722
2722
  setDevice(deviceId: string): Promise<void>;
2723
2723
  /**
2724
- * **自从**
2724
+ * @自从
2725
2725
  * <br>&emsp;&emsp;&emsp;*4.0.0*
2726
2726
  *
2727
2727
  * 启用/禁用该轨道。
@@ -2737,7 +2737,7 @@ export declare interface IMicrophoneAudioTrack extends ILocalAudioTrack {
2737
2737
  * - `false`: 禁用该轨道.
2738
2738
  */
2739
2739
  /** @en
2740
- * **Since**
2740
+ * @since
2741
2741
  * <br>&emsp;&emsp;&emsp;*4.0.0*
2742
2742
  *
2743
2743
  * Enables/Disables the track.
@@ -2801,7 +2801,7 @@ export declare interface IRemoteAudioTrack extends IRemoteTrack {
2801
2801
  */
2802
2802
  play(): void;
2803
2803
  /**
2804
- * **自从**
2804
+ * @自从
2805
2805
  * <br>&emsp;&emsp;&emsp;*4.1.0*
2806
2806
  *
2807
2807
  * 设置音频播放设备,比如扬声器。
@@ -2810,7 +2810,7 @@ export declare interface IRemoteAudioTrack extends IRemoteTrack {
2810
2810
  * @param deviceId 设备 ID,可以通过 [[getPlaybackDevices]] 方法获取。
2811
2811
  */
2812
2812
  /** @en
2813
- * **Since**
2813
+ * @since
2814
2814
  * <br>&emsp;&emsp;&emsp;*4.1.0*
2815
2815
  *
2816
2816
  * Sets the audio playback device, for example, the speaker.
@@ -2891,7 +2891,7 @@ export declare interface IRemoteAudioTrack extends IRemoteTrack {
2891
2891
  */
2892
2892
  getVolumeLevel(): number;
2893
2893
  /**
2894
- * **自从**
2894
+ * @自从
2895
2895
  * <br>&emsp;&emsp;&emsp;*4.13.0*
2896
2896
  *
2897
2897
  * 将 `Processor` 注入远端音频轨道。
@@ -2901,7 +2901,7 @@ export declare interface IRemoteAudioTrack extends IRemoteTrack {
2901
2901
  * @returns `Processor` 实例。
2902
2902
  */
2903
2903
  /** @en
2904
- * **Since**
2904
+ * @since
2905
2905
  * <br>&emsp;&emsp;&emsp;*4.13.0*
2906
2906
  *
2907
2907
  * Inserts a `Processor` to the remote audio track.
@@ -2912,26 +2912,26 @@ export declare interface IRemoteAudioTrack extends IRemoteTrack {
2912
2912
  */
2913
2913
  pipe(processor: IAudioProcessor): IAudioProcessor;
2914
2914
  /**
2915
- * **自从**
2915
+ * @自从
2916
2916
  * <br>&emsp;&emsp;&emsp;*4.13.0*
2917
2917
  *
2918
2918
  * 取消远端音频轨道上注入的 `Processor`。
2919
2919
  */
2920
2920
  /** @en
2921
- * **Since**
2921
+ * @since
2922
2922
  * <br>&emsp;&emsp;&emsp;*4.13.0*
2923
2923
  *
2924
2924
  * Removes the `Processor` inserted to the remote audio track.
2925
2925
  */
2926
2926
  unpipe(): void;
2927
2927
  /**
2928
- * **自从**
2928
+ * @自从
2929
2929
  * <br>&emsp;&emsp;&emsp;*4.13.0*
2930
2930
  *
2931
2931
  * 远端音频轨道上当前媒体处理链路的最终节点。
2932
2932
  */
2933
2933
  /** @en
2934
- * **Since**
2934
+ * @since
2935
2935
  * <br>&emsp;&emsp;&emsp;*4.13.0*
2936
2936
  *
2937
2937
  * The destination of the current processing pipeline on the remote audio track.
@@ -2995,7 +2995,7 @@ export declare interface IRemoteTrack extends ITrack {
2995
2995
  /**
2996
2996
  * 获取远端轨道相关信息。
2997
2997
  *
2998
- * **DEPRECATED**
2998
+ * @deprecated
2999
2999
  *
3000
3000
  * 自 v4.1.0 起废弃,请使用 [AgoraRTCClient.getRemoteVideoStats]{@link IAgoraRTCClient.getRemoteVideoStats} 和 [AgoraRTCClient.getRemoteAudioStats]{@link IAgoraRTCClient.getRemoteAudioStats}。
3001
3001
  * @return [[RemoteAudioTrackStats]] 或 [[RemoteVideoTrackStats]] 对象。
@@ -3003,7 +3003,7 @@ export declare interface IRemoteTrack extends ITrack {
3003
3003
  /** @en
3004
3004
  * Gets the statistics of a remote track.
3005
3005
  *
3006
- * **DEPRECATED** from v4.1.0. Use [AgoraRTCClient.getRemoteVideoStats]{@link IAgoraRTCClient.getRemoteVideoStats} and [AgoraRTCClient.getRemoteAudioStats]{@link IAgoraRTCClient.getRemoteAudioStats} instead.
3006
+ * @deprecated from v4.1.0. Use [AgoraRTCClient.getRemoteVideoStats]{@link IAgoraRTCClient.getRemoteVideoStats} and [AgoraRTCClient.getRemoteAudioStats]{@link IAgoraRTCClient.getRemoteAudioStats} instead.
3007
3007
  * @return An [[RemoteAudioTrackStats]] or [[RemoteVideoTrackStats]] object.
3008
3008
  */
3009
3009
  getStats(): RemoteAudioTrackStats | RemoteVideoTrackStats;
@@ -3099,7 +3099,7 @@ export declare interface IRemoteVideoTrack extends IRemoteTrack {
3099
3099
  */
3100
3100
  play(element: string | HTMLElement, config?: VideoPlayerConfig): void;
3101
3101
  /**
3102
- * **自从**
3102
+ * @自从
3103
3103
  * <br>&emsp;&emsp;&emsp;*4.1.0*
3104
3104
  *
3105
3105
  * 获取当前渲染的视频帧数据。
@@ -3109,7 +3109,7 @@ export declare interface IRemoteVideoTrack extends IRemoteTrack {
3109
3109
  * @returns 存储了 RGBA 数据的 `ImageData` 对象。该对象为浏览器原生对象,详见 [ImageData](https://developer.mozilla.org/zh-CN/docs/Web/API/ImageData)。
3110
3110
  */
3111
3111
  /** @en
3112
- * **Since**
3112
+ * @since
3113
3113
  * <br>&emsp;&emsp;&emsp;*4.1.0*
3114
3114
  *
3115
3115
  * Gets the data of the video frame being rendered.
@@ -3120,7 +3120,7 @@ export declare interface IRemoteVideoTrack extends IRemoteTrack {
3120
3120
  */
3121
3121
  getCurrentFrameData(): ImageData;
3122
3122
  /**
3123
- * * **自从**
3123
+ * * @自从
3124
3124
  * <br>&emsp;&emsp;&emsp;*4.8.0*
3125
3125
  *
3126
3126
  * 获取 HTML `<video>` 标签的可见状态和不可见原因。
@@ -3133,7 +3133,7 @@ export declare interface IRemoteVideoTrack extends IRemoteTrack {
3133
3133
  * - `<video>` 标签不是通过 `play` 方法调用产生的。
3134
3134
  */
3135
3135
  /** @en
3136
- * **Since**
3136
+ * @since
3137
3137
  * <br>&emsp;&emsp;&emsp;*4.8.0*
3138
3138
  *
3139
3139
  * Gets the visibility of the `<video>` HTML tag.
@@ -3147,7 +3147,7 @@ export declare interface IRemoteVideoTrack extends IRemoteTrack {
3147
3147
  */
3148
3148
  getVideoElementVisibleStatus(): CheckVideoVisibleResult | undefined;
3149
3149
  /**
3150
- * **自从**
3150
+ * @自从
3151
3151
  * <br>&emsp;&emsp;&emsp;*4.13.0*
3152
3152
  *
3153
3153
  * 将 `Processor` 注入远端视频轨道。
@@ -3157,7 +3157,7 @@ export declare interface IRemoteVideoTrack extends IRemoteTrack {
3157
3157
  * @returns `Processor` 实例。
3158
3158
  */
3159
3159
  /** @en
3160
- * **Since**
3160
+ * @since
3161
3161
  * <br>&emsp;&emsp;&emsp;*4.13.0*
3162
3162
  *
3163
3163
  * Inserts a `Processor` to the remote video track.
@@ -3168,26 +3168,26 @@ export declare interface IRemoteVideoTrack extends IRemoteTrack {
3168
3168
  */
3169
3169
  pipe(processor: IBaseProcessor): IBaseProcessor;
3170
3170
  /**
3171
- * **自从**
3171
+ * @自从
3172
3172
  * <br>&emsp;&emsp;&emsp;*4.13.0*
3173
3173
  *
3174
3174
  * 取消远端视频轨道上注入的 `Processor`。
3175
3175
  */
3176
3176
  /** @en
3177
- * **Since**
3177
+ * @since
3178
3178
  * <br>&emsp;&emsp;&emsp;*4.13.0*
3179
3179
  *
3180
3180
  * Removes the `Processor` inserted to the remote video track.
3181
3181
  */
3182
3182
  unpipe(): void;
3183
3183
  /**
3184
- * **自从**
3184
+ * @自从
3185
3185
  * <br>&emsp;&emsp;&emsp;*4.13.0*
3186
3186
  *
3187
3187
  * 远端视频轨道上当前媒体处理链路的最终节点。
3188
3188
  */
3189
3189
  /** @en
3190
- * **Since**
3190
+ * @since
3191
3191
  * <br>&emsp;&emsp;&emsp;*4.13.0*
3192
3192
  *
3193
3193
  * The destination of the current processing pipeline on the remote video track.
@@ -4581,7 +4581,7 @@ export declare interface ScreenVideoTrackInitConfig {
4581
4581
  */
4582
4582
  extensionId?: string;
4583
4583
  /**
4584
- * **DEPRECATED**
4584
+ * @deprecated
4585
4585
  *
4586
4586
  * 自 v4.17.1 起废弃,请改用 {@link displaySurface}。
4587
4587
  *
@@ -4589,13 +4589,13 @@ export declare interface ScreenVideoTrackInitConfig {
4589
4589
  */
4590
4590
  /** @en
4591
4591
  *
4592
- * **DEPRECATED** from v4.17.1. Use {@link displaySurface} instead.
4592
+ * @deprecated from v4.17.1. Use {@link displaySurface} instead.
4593
4593
  *
4594
4594
  * The type of the source for screen sharing.
4595
4595
  */
4596
4596
  screenSourceType?: ScreenSourceType;
4597
4597
  /**
4598
- * **自从**
4598
+ * @自从
4599
4599
  * <br>&emsp;&emsp;&emsp;*4.0.0*
4600
4600
  *
4601
4601
  * 传输优化模式。设置该值后,SDK 会自动调整码率配置以及使用不同的回退策略。
@@ -4609,7 +4609,7 @@ export declare interface ScreenVideoTrackInitConfig {
4609
4609
  * > 注意事项:该方法只支持 Chrome 浏览器。
4610
4610
  */
4611
4611
  /** @en
4612
- * **Since**
4612
+ * @since
4613
4613
  * <br>&emsp;&emsp;&emsp;*4.0.0*
4614
4614
  *
4615
4615
  * Transmission optimization mode. Whether to prioritize video quality or smoothness:
@@ -4626,7 +4626,7 @@ export declare interface ScreenVideoTrackInitConfig {
4626
4626
  /**
4627
4627
  * @ignore
4628
4628
  *
4629
- * **自从**
4629
+ * @自从
4630
4630
  * <br>&emsp;&emsp;&emsp;*4.18.0*
4631
4631
  *
4632
4632
  * SVC (可伸缩视频编码)配置。
@@ -4636,7 +4636,7 @@ export declare interface ScreenVideoTrackInitConfig {
4636
4636
  /** @en
4637
4637
  * @ignore
4638
4638
  *
4639
- * **Since**
4639
+ * @since
4640
4640
  * <br>&emsp;&emsp;&emsp;*4.18.0*
4641
4641
  *
4642
4642
  * Configurations for Scalable Video Coding (SVC).
@@ -4647,7 +4647,7 @@ export declare interface ScreenVideoTrackInitConfig {
4647
4647
  */
4648
4648
  scalabiltyMode?: SVCConfiguration | SVCConfigurationPreset;
4649
4649
  /**
4650
- * **自从**
4650
+ * @自从
4651
4651
  * <br>&emsp;&emsp;&emsp;*4.17.1*
4652
4652
  *
4653
4653
  * 默认选中的共享内容类型,支持设为标签页、应用窗口(如下图)、或屏幕。详见 [displaySurface](https://developer.chrome.com/docs/web-platform/screen-sharing-controls/#displaySurface)。
@@ -4659,7 +4659,7 @@ export declare interface ScreenVideoTrackInitConfig {
4659
4659
  */
4660
4660
  /** @en
4661
4661
  *
4662
- * **Since**
4662
+ * @since
4663
4663
  * <br>&emsp;&emsp;&emsp;*4.17.1*
4664
4664
  *
4665
4665
  * The pre-selected pane in the media picker. See [displaySurface](https://developer.chrome.com/docs/web-platform/screen-sharing-controls/#displaySurface) for details.
@@ -4668,7 +4668,7 @@ export declare interface ScreenVideoTrackInitConfig {
4668
4668
  */
4669
4669
  displaySurface?: "browser" | "window" | "monitor";
4670
4670
  /**
4671
- * **自从**
4671
+ * @自从
4672
4672
  * <br>&emsp;&emsp;&emsp;*4.17.1*
4673
4673
  *
4674
4674
  * 是否允许用户共享当前标签页:
@@ -4683,7 +4683,7 @@ export declare interface ScreenVideoTrackInitConfig {
4683
4683
  */
4684
4684
  /** @en
4685
4685
  *
4686
- * **Since**
4686
+ * @since
4687
4687
  * <br>&emsp;&emsp;&emsp;*4.17.1*
4688
4688
  *
4689
4689
  * Whether to allow the user to share the current tab:
@@ -4698,7 +4698,7 @@ export declare interface ScreenVideoTrackInitConfig {
4698
4698
  */
4699
4699
  selfBrowserSurface?: "include" | "exclude";
4700
4700
  /**
4701
- * **自从**
4701
+ * @自从
4702
4702
  * <br>&emsp;&emsp;&emsp;*4.17.1*
4703
4703
  *
4704
4704
  * 是否允许用户动态切换共享的标签页:
@@ -4711,7 +4711,7 @@ export declare interface ScreenVideoTrackInitConfig {
4711
4711
  */
4712
4712
  /** @en
4713
4713
  *
4714
- * **Since**
4714
+ * @since
4715
4715
  * <br>&emsp;&emsp;&emsp;*4.17.1*
4716
4716
  *
4717
4717
  * Whether to allow the user to dynamically switch between shared tabs:
@@ -4724,7 +4724,7 @@ export declare interface ScreenVideoTrackInitConfig {
4724
4724
  */
4725
4725
  surfaceSwitching?: "include" | "exclude";
4726
4726
  /**
4727
- * **自从**
4727
+ * @自从
4728
4728
  * <br>&emsp;&emsp;&emsp;*4.17.1*
4729
4729
  *
4730
4730
  * 是否允许采集系统音频:
@@ -4737,7 +4737,7 @@ export declare interface ScreenVideoTrackInitConfig {
4737
4737
  */
4738
4738
  /** @en
4739
4739
  *
4740
- * **Since**
4740
+ * @since
4741
4741
  * <br>&emsp;&emsp;&emsp;*4.17.1*
4742
4742
  *
4743
4743
  * Whether to capture system audio:
@@ -4802,7 +4802,7 @@ export declare const SUPPORT_VIDEO_ENCODER_CONFIG_LIST: Record<string, VideoEnco
4802
4802
 
4803
4803
  /**
4804
4804
  * @ignore
4805
- * **自从**
4805
+ * @自从
4806
4806
  * <br>&emsp;&emsp;&emsp;*4.18.0*
4807
4807
  *
4808
4808
  * 自定义的 SVC 编码配置。
@@ -4814,7 +4814,7 @@ export declare const SUPPORT_VIDEO_ENCODER_CONFIG_LIST: Record<string, VideoEnco
4814
4814
  */
4815
4815
  /** @en
4816
4816
  * @ignore
4817
- * **Since**
4817
+ * @since
4818
4818
  * <br>&emsp;&emsp;&emsp;*4.18.0*
4819
4819
  *
4820
4820
  * Custom SVC encoding configurations.
@@ -4844,7 +4844,7 @@ export declare interface SVCConfiguration {
4844
4844
  /**
4845
4845
  * @ignore
4846
4846
  *
4847
- * **自从**
4847
+ * @自从
4848
4848
  * <br>&emsp;&emsp;&emsp;*4.18.0*
4849
4849
  *
4850
4850
  * SDK 预设的 SVC 编码配置:
@@ -4861,7 +4861,7 @@ export declare interface SVCConfiguration {
4861
4861
  /** @en
4862
4862
  * @ignore
4863
4863
  *
4864
- * **Since**
4864
+ * @since
4865
4865
  * <br>&emsp;&emsp;&emsp;*4.18.0*
4866
4866
  *
4867
4867
  * The preset SVC configurations provided by the SDK.