[AUTO] Generate codes by terra (#1155)

Co-authored-by: guoxianzhe <[email protected]>

Author: sda-rob

ts/Private/AgoraBase.ts

@@ -222,7 +222,7 @@ export enum MediaSourceType {
    */
   PrimaryCameraSource = 2,
   /**
-   * 3: The secondary camera.
+   * 3: A secondary camera.
    */
   SecondaryCameraSource = 3,
   /**
@@ -234,7 +234,7 @@ export enum MediaSourceType {
    */
   SecondaryScreenSource = 5,
   /**
-   * @ignore
+   * 6. Custom video source.
    */
   CustomVideoSource = 6,
   /**
@@ -726,7 +726,7 @@ export class VideoFrame {
    */
   pixelBuffer?: Uint8Array;
   /**
-   * @ignore
+   * The meta information in the video frame. To use this parameter, please.
    */
   metaInfo?: IVideoFrameMetaInfo;
 }
@@ -754,15 +754,17 @@ export enum MediaPlayerSourceType {
  */
 export enum VideoModulePosition {
   /**
-   * 1: The post-capturer position, which corresponds to the video data in the onCaptureVideoFrame callback.
+   * 1: The location of the locally collected video data after preprocessing corresponds to the onCaptureVideoFrame callback. The observed video here has the effect of video pre-processing, which can be verified by enabling image enhancement, virtual background, or watermark.
    */
   PositionPostCapturer = 1 << 0,
   /**
    * 2: The pre-renderer position, which corresponds to the video data in the onRenderVideoFrame callback.
    */
   PositionPreRenderer = 1 << 1,
   /**
-   * 4: The pre-encoder position, which corresponds to the video data in the onPreEncodeVideoFrame callback.
+   * 4: The pre-encoder position, which corresponds to the video data in the onPreEncodeVideoFrame callback. The observed video here has the effects of video pre-processing and encoding pre-processing.
+   *  To verify the pre-processing effects of the video, you can enable image enhancement, virtual background, or watermark.
+   *  To verify the pre-encoding processing effect, you can set a lower frame rate (for example, 5 fps).
    */
   PositionPreEncoder = 1 << 2,
 }
@@ -1210,7 +1212,7 @@ export enum MediaRecorderStreamType {
  */
 export enum RecorderState {
   /**
-   * -1: An error occurs during the recording. See RecorderErrorCode for the reason.
+   * -1: An error occurs during the recording. See RecorderReasonCode for the reason.
    */
   RecorderStateError = -1,
   /**
@@ -1224,27 +1226,27 @@ export enum RecorderState {
 }
 
 /**
- * The reason for the state change.
+ * @ignore
  */
 export enum RecorderErrorCode {
   /**
-   * 0: No error.
+   * @ignore
    */
   RecorderErrorNone = 0,
   /**
-   * 1: The SDK fails to write the recorded data to a file.
+   * @ignore
    */
   RecorderErrorWriteFailed = 1,
   /**
-   * 2: The SDK does not detect any audio and video streams, or audio and video streams are interrupted for more than five seconds during recording.
+   * @ignore
    */
   RecorderErrorNoStream = 2,
   /**
-   * 3: The recording duration exceeds the upper limit.
+   * @ignore
    */
   RecorderErrorOverMaxDuration = 3,
   /**
-   * 4: The recording configuration changes.
+   * @ignore
    */
   RecorderErrorConfigChanged = 4,
 }

ts/Private/AgoraMediaBase.ts

@@ -70,67 +70,67 @@ export enum MediaPlayerState {
 }
 
 /**
- * Error codes of the media player.
+ * @ignore
  */
 export enum MediaPlayerError {
   /**
-   * 0: No error.
+   * @ignore
    */
   PlayerErrorNone = 0,
   /**
-   * -1: Invalid arguments.
+   * @ignore
    */
   PlayerErrorInvalidArguments = -1,
   /**
-   * -2: Internal error.
+   * @ignore
    */
   PlayerErrorInternal = -2,
   /**
-   * -3: No resource.
+   * @ignore
    */
   PlayerErrorNoResource = -3,
   /**
-   * -4: Invalid media resource.
+   * @ignore
    */
   PlayerErrorInvalidMediaSource = -4,
   /**
-   * -5: The media stream type is unknown.
+   * @ignore
    */
   PlayerErrorUnknownStreamType = -5,
   /**
-   * -6: The object is not initialized.
+   * @ignore
    */
   PlayerErrorObjNotInitialized = -6,
   /**
-   * -7: The codec is not supported.
+   * @ignore
    */
   PlayerErrorCodecNotSupported = -7,
   /**
-   * -8: Invalid renderer.
+   * @ignore
    */
   PlayerErrorVideoRenderFailed = -8,
   /**
-   * -9: An error with the internal state of the player occurs.
+   * @ignore
    */
   PlayerErrorInvalidState = -9,
   /**
-   * -10: The URL of the media resource cannot be found.
+   * @ignore
    */
   PlayerErrorUrlNotFound = -10,
   /**
-   * -11: Invalid connection between the player and the Agora Server.
+   * @ignore
    */
   PlayerErrorInvalidConnectionState = -11,
   /**
-   * -12: The playback buffer is insufficient.
+   * @ignore
    */
   PlayerErrorSrcBufferUnderflow = -12,
   /**
-   * -13: The playback is interrupted.
+   * @ignore
    */
   PlayerErrorInterrupted = -13,
   /**
-   * -14: The SDK does not support the method being called.
+   * @ignore
    */
   PlayerErrorNotSupported = -14,
   /**
@@ -142,7 +142,7 @@ export enum MediaPlayerError {
    */
   PlayerErrorIpExpired = -16,
   /**
-   * -17: An unknown error.
+   * @ignore
    */
   PlayerErrorUnknown = -17,
 }
@@ -370,15 +370,15 @@ export class CacheStatistics {
  */
 export class PlayerUpdatedInfo {
   /**
-   * The ID of a media player.
+   * @ignore
    */
   playerId?: string;
   /**
    * The ID of a deivce.
    */
   deviceId?: string;
   /**
-   * The statistics about the media file being cached. If you call the openWithMediaSource method and set enableCache as true, the statistics about the media file being cached is updated every second after the media file is played. See CacheStatistics.
+   * @ignore
    */
   cacheStatistics?: CacheStatistics;
 }
@@ -411,7 +411,7 @@ export class MediaSource {
    */
   enableCache?: boolean;
   /**
-   * @ignore
+   * Whether to allow the selection of different audio tracks when playing this media file: true : Allow to select different audio tracks. false : (Default) Do not allow to select different audio tracks. If you need to set different audio tracks for local playback and publishing to the channel, you need to set this parameter to true, and then call the selectMultiAudioTrack method to select the audio track.
    */
   enableMultiAudioTrack?: boolean;
   /**

ts/Private/AgoraMediaPlayerTypes.ts

@@ -76,7 +76,7 @@ export class LogConfig {
    */
   filePath?: string;
   /**
-   * The size (KB) of an agorasdk.log file. The value range is [128, 20480]. The default value is 1,024 KB. If you set fileSizeInKByte smaller than 128 KB, the SDK automatically adjusts it to 128 KB; if you set fileSizeInKByte greater than 20,480 KB, the SDK automatically adjusts it to 20,480 KB.
+   * The size (KB) of an agorasdk.log file. The value range is [128,20480]. The default value is 2,048 KB. If you set fileSizeInKByte smaller than 128 KB, the SDK automatically adjusts it to 128 KB; if you set fileSizeInKByte greater than 20,480 KB, the SDK automatically adjusts it to 20,480 KB.
    */
   fileSizeInKB?: number;
   /**

ts/Private/IAgoraLog.ts

@@ -174,10 +174,10 @@ export abstract class IMediaEngine {
   /**
    * Creates a custom audio track.
    *
-   * To publish a custom audio source to multiple channels, see the following steps:
+   * Ensure that you call this method before joining a channel. To publish a custom audio source, see the following steps:
    *  Call this method to create a custom audio track and get the audio track ID.
-   *  In ChannelMediaOptions of each channel, set publishCustomAduioTrackId to the audio track ID that you want to publish, and set publishCustomAudioTrack to true.
-   *  If you call pushAudioFrame, and specify trackId as the audio track ID set in step 2, you can publish the corresponding custom audio source in multiple channels.
+   *  Call joinChannel to join the channel. In ChannelMediaOptions, set publishCustomAduioTrackId to the audio track ID that you want to publish, and set publishCustomAudioTrack to true.
+   *  Call pushAudioFrame and specify trackId as the audio track ID set in step 2. You can then publish the corresponding custom audio source in the channel.
    *
    * @param trackType The type of the custom audio track. See AudioTrackType. If AudioTrackDirect is specified for this parameter, you must set publishMicrophoneTrack to false in ChannelMediaOptions when calling joinChannel to join the channel; otherwise, joining the channel fails and returns the error code -2.
    * @param config The configuration of the custom audio track. See AudioTrackConfig.
@@ -232,9 +232,14 @@ export abstract class IMediaEngine {
   ): number;
 
   /**
-   * Pushes the external raw video frame to the SDK.
-   *
-   * If you call createCustomVideoTrack method to get the video track ID, set the customVideoTrackId parameter to the video track ID you want to publish in the ChannelMediaOptions of each channel, and set the publishCustomVideoTrack parameter to true, you can call this method to push the unencoded external video frame to the SDK.
+   * Pushes the external raw video frame to the SDK through video tracks.
+   *
+   * To publish a custom video source, see the following steps:
+   *  Call createCustomVideoTrack to create a video track and get the video track ID.
+   *  Call joinChannel to join the channel. In ChannelMediaOptions, set customVideoTrackId to the video track ID that you want to publish, and set publishCustomVideoTrack to true.
+   *  Call this method and specify videoTrackId as the video track ID set in step 2. You can then publish the corresponding custom video source in the channel. After calling this method, even if you stop pushing external video frames to the SDK, the custom video stream will still be counted as the video duration usage and incur charges. Agora recommends that you take appropriate measures based on the actual situation to avoid such video billing.
+   *  If you no longer need to capture external video data, you can call destroyCustomVideoTrack to destroy the custom video track.
+   *  If you only want to use the external video data for local preview and not publish it in the channel, you can call muteLocalVideoStream to cancel sending video stream or call updateChannelMediaOptions to set publishCustomVideoTrack to false.
    *
    * @param frame The external raw video frame to be pushed. See ExternalVideoFrame.
    * @param videoTrackId The video track ID returned by calling the createCustomVideoTrack method. The default value is 0.