nertc_engine_defines.h

浏览该文件的文档.

 
#ifndef NERTC_ENGINE_DEFINES_H
#define NERTC_ENGINE_DEFINES_H
 
#include <string.h>
#include "nertc_base_types.h"
#define kNERtcCommonMaxCount 16
#define kNERtcMaxPlaneCount 4
#define kNERtcEncryptByteLength 128
#define kNERtcCustomInfoLength 128
#define kNERtcMaxChannelNameLength 64
#define kNERtcMaxTokenLength 256
#define kNERtcMaxDeviceIDLength 256
#define kNERtcMaxDeviceNameLength 256
#define kNERtcMaxURILength 256
#define kNERtcMaxTaskIDLength 64
#define kNERtcMaxBuffLength 1024
#define kNERtcMaxSEIBufferLength 4096

#define kDefaultAudioMixProgressInterval 1000

#define kMinAudioMixProgressInterval 100

#define kMaxAudioMixProgressInterval 10000

#define kNERtcExternalVideoDeviceID "nertc-video-external-device"

#define kNERtcExternalSubVideoDeviceID "nertc-subvideo-external-device"

#define kNERtcAudioDeviceAutoID "nertc-audio-device-auto"

namespace nertc {
typedef uint64_t uid_t;
typedef uint64_t channel_id_t;
typedef void* source_id_t;

typedef enum {
    kNERtcIIDAudioDeviceManager = 1,
    kNERtcIIDVideoDeviceManager = 2,
} NERtcInterfaceIdType;

typedef enum {
    kNERtcClientRoleBroadcaster = 0,
    kNERtcClientRoleAudience = 1,
} NERtcClientRole;

typedef enum {
    kNERtcChannelProfileCommunication = 0,
    kNERtcChannelProfileLiveBroadcasting = 1,
    kNERtcChannelProfileVideoCall = 3,
    
    kNERtcChannelProfileHighQualityVideoCall = 4,
    
    kNERtcChannelProfileChatroom = 5,
    
    kNERtcChannelProfileHighQualityChatroom = 6,
    
    kNERtcChannelProfileMeeting = 7,
    
    kNERtcChannelProfileKaraoke = 8,
} NERtcChannelProfileType;

typedef enum {
    kNERtcMediaPriorityHigh = 50,
    kNERtcMediaPriorityNormal = 100,
} NERtcMediaPriorityType;

typedef enum {
  kNERtcLayoutFloatingRightVertical = 0,
  kNERtcLayoutFloatingLeftVertical,
  kNERtcLayoutSplitScreen,
  kNERtcLayoutSplitScreenScaling,
  kNERtcLayoutCustom,
  kNERtcLayoutAudioOnly,
} NERtcLiveStreamLayoutMode;

struct NERtcLiveStreamTaskOption {
    char task_id[kNERtcMaxTaskIDLength];
    char stream_url[kNERtcMaxURILength];
    bool server_record_enabled;
    NERtcLiveStreamLayoutMode layout_mode;
    uid_t main_picture_account_id;
    char layout_parameters[kNERtcMaxBuffLength];
 
    NERtcLiveStreamTaskOption()
        : server_record_enabled(false), layout_mode(kNERtcLayoutFloatingRightVertical), main_picture_account_id(0) {
        memset(task_id, 0, sizeof(task_id));
        memset(stream_url, 0, sizeof(stream_url));
        memset(layout_parameters, 0, sizeof(layout_parameters));
    }
};

typedef enum {
    kNERtcLsModeVideo = 0,
    kNERtcLsModeAudio = 1,
} NERtcLiveStreamMode;

typedef enum {
    kNERtcLsModeVideoScaleFit = 0,
    kNERtcLsModeVideoScaleCropFill = 1,
} NERtcLiveStreamVideoScaleMode;

typedef enum {
    kNERTCVideoStreamMain = 0,
    kNERTCVideoStreamSub = 1,
    kNERTCVideoStreamThird = 2,
    kNERTCVideoStreamFourth = 3,
} NERtcVideoStreamType;

struct NERtcLiveStreamUserTranscoding {
    uid_t uid;
    bool video_push;
    NERtcLiveStreamVideoScaleMode adaption;
    int x;
    int y;
    int width;
    int height;
    bool audio_push;
    int z_order;
    NERtcVideoStreamType video_stream_type;
 
    NERtcLiveStreamUserTranscoding()
        : uid(0)
        , video_push(true)
        , adaption(kNERtcLsModeVideoScaleFit)
        , x(0)
        , y(0)
        , width(0)
        , height(0)
        , audio_push(true)
        , z_order(0)
        , video_stream_type(kNERTCVideoStreamMain) {}
};

struct NERtcLiveStreamImageInfo {
    char url[kNERtcMaxURILength];
    int x;
    int y;
    int width;
    int height;

    int z_order;
 
    NERtcLiveStreamImageInfo() : x(0), y(0), width(0), height(0), z_order(0) { memset(url, 0, sizeof(url)); }
};

struct NERtcLiveStreamLayout {
    int width;
    int height;
    unsigned int background_color;
    unsigned int user_count;
    NERtcLiveStreamUserTranscoding* users;
    NERtcLiveStreamImageInfo* bg_image;

    int bg_image_count;
 
    NERtcLiveStreamLayout()
        : width(0), height(0), background_color(0), user_count(0), users(NULL), bg_image(NULL), bg_image_count(1) {}
};

typedef enum {
    kNERtcLiveStreamAudioSampleRate32000 = 32000,
    kNERtcLiveStreamAudioSampleRate44100 = 44100,
    kNERtcLiveStreamAudioSampleRate48000 = 48000,
} NERtcLiveStreamAudioSampleRate;

typedef enum {
    kNERtcLiveStreamAudioCodecProfileLCAAC = 0,
    kNERtcLiveStreamAudioCodecProfileHEAAC = 1,
} NERtcLiveStreamAudioCodecProfile;

struct NERtcLiveConfig {
    bool single_video_passthrough;
    int audio_bitrate;

    NERtcLiveStreamAudioSampleRate sampleRate;

    int channels;

    NERtcLiveStreamAudioCodecProfile audioCodecProfile;

    bool interrupted_place_image;
 
    NERtcLiveConfig()
        : single_video_passthrough(false)
        , audio_bitrate(0)
        , sampleRate(kNERtcLiveStreamAudioSampleRate48000)
        , channels(2)
        , audioCodecProfile(kNERtcLiveStreamAudioCodecProfileLCAAC)
        , interrupted_place_image(false) {}
};

struct NERtcLiveStreamTaskInfo {
    char task_id[kNERtcMaxTaskIDLength];
    char stream_url[kNERtcMaxURILength];
    bool server_record_enabled;
    NERtcLiveStreamMode ls_mode;
    NERtcLiveStreamLayout layout;
    NERtcLiveConfig config;
    char extraInfo[kNERtcMaxSEIBufferLength];
 
    NERtcLiveStreamTaskInfo() : server_record_enabled(false), ls_mode(kNERtcLsModeVideo) {
        memset(task_id, 0, sizeof(task_id));
        memset(stream_url, 0, sizeof(stream_url));
        memset(extraInfo, 0, sizeof(extraInfo));
    }
};

typedef enum {
    kNERtcLsStatePushing = 505,
    kNERtcLsStatePushFail = 506,
    kNERtcLsStatePushStopped = 511,
    kNERtcLsStateImageError = 512,
} NERtcLiveStreamStateCode;

typedef enum {
    kNERtcOSiOS = 1,
    kNERtcOSAndroid = 2,
    kNERtcOSPC = 3,
    kNERtcOSWebRTC = 4,
} NERtcOSCategory;

typedef enum {
    kNERtcAudioProfileDefault = 0,
    kNERtcAudioProfileStandard = 1,
    kNERtcAudioProfileStandardExtend = 2,
    kNERtcAudioProfileMiddleQuality = 3,
    kNERtcAudioProfileMiddleQualityStereo = 4,
    kNERtcAudioProfileHighQuality = 5,
    kNERtcAudioProfileHighQualityStereo = 6,
} NERtcAudioProfileType;

typedef enum {
    kNERtcAudioScenarioDefault = 0,
    kNERtcAudioScenarioSpeech = 1,
    kNERtcAudioScenarioMusic = 2,
} NERtcAudioScenarioType;

typedef enum {
    kNERtcVoiceChangerOff = 0,
    kNERtcVoiceChangerRobot = 1,
    kNERtcVoiceChangerGaint = 2,
    kNERtcVoiceChangerHorror = 3,
    kNERtcVoiceChangerMature = 4,
    kNERtcVoiceChangerManToWoman = 5,
    kNERtcVoiceChangerWomanToMan = 6,
    kNERtcVoiceChangerManToLoli = 7,
    kNERtcVoiceChangerWomanToLoli = 8,
} NERtcVoiceChangerType;

typedef enum {
    kNERtcVoiceBeautifierOff = 0,
    kNERtcVoiceBeautifierMuffled = 1,
    kNERtcVoiceBeautifierMellow = 2,
    kNERtcVoiceBeautifierClear = 3,
    kNERtcVoiceBeautifierMagnetic = 4,
    kNERtcVoiceBeautifierRecordingstudio = 5,
    kNERtcVoiceBeautifierNature = 6,
    kNERtcVoiceBeautifierKTV = 7,
    kNERtcVoiceBeautifierRemote = 8,
    kNERtcVoiceBeautifierChurch = 9,
    kNERtcVoiceBeautifierBedroom = 10,
    kNERtcVoiceBeautifierLive = 11,
} NERtcVoiceBeautifierType;

typedef enum {
    kNERtcVoiceEqualizationBand_31 = 0,
    kNERtcVoiceEqualizationBand_62 = 1,
    kNERtcVoiceEqualizationBand_125 = 2,
    kNERtcVoiceEqualizationBand_250 = 3,
    kNERtcVoiceEqualizationBand_500 = 4,
    kNERtcVoiceEqualizationBand_1K = 5,
    kNERtcVoiceEqualizationBand_2K = 6,
    kNERtcVoiceEqualizationBand_4K = 7,
    kNERtcVoiceEqualizationBand_8K = 8,
    kNERtcVoiceEqualizationBand_16K = 9,
} NERtcVoiceEqualizationBand;

typedef enum {
    kNERtcAudioAINSOff = 0,
    kNERtcAudioAINSNormal = 1,
    
    kNERtcAudioAINSEnhance = 2,
  
    kNERtcAudioAINSVoiceprint = 3,
} NERtcAudioAINSMode;

typedef enum {
    kNERtcVideoColorSpaceRangeInvalid = 0,
    kNERtcVideoColorSpaceRangeLimited = 1,
    kNERtcVideoColorSpaceRangeFull = 2,
    kNERtcVideoColorSpaceRangeDerived = 3,
} NERtcVideoColorSpaceRange;

typedef enum {
    kNERtcVideoColorSpaceMatrixRGB = 0,
    kNERtcVideoColorSpaceMatrixBT709 = 1,
    kNERtcVideoColorSpaceMatrixUNSPECIFIED = 2,
    kNERtcVideoColorSpaceMatrixFCC = 4,
    kNERtcVideoColorSpaceMatrixBT470BG = 5,
    kNERtcVideoColorSpaceMatrixSMPTE170M = 6,
    kNERtcVideoColorSpaceMatrixSMPTE240M = 7,
    kNERtcVideoColorSpaceMatrixYCOCG = 8,
    kNERtcVideoColorSpaceMatrixBT2020NCL = 9,
    kNERtcVideoColorSpaceMatrixBT2020CL = 10,
    kNERtcVideoColorSpaceMatrixSMPTE2085 = 11,
    kNERtcVideoColorSpaceMatrixCDNCLS = 12,
    kNERtcVideoColorSpaceMatrixCDCLS = 13,
    kNERtcVideoColorSpaceMatrixBT2100ICTCP = 14,
    kNERtcVideoColorSpaceMatrixInvalid = 63,
} NERtcVideoColorSpaceMatrix;

typedef enum {
    kNERtcVideoColorSpacePrimaryInvalid = 0,
    kNERtcVideoColorSpacePrimaryBT709 = 1,
    kNERtcVideoColorSpacePrimaryUNSPECIFIED = 2,
    kNERtcVideoColorSpacePrimaryBT470M = 4,
    kNERtcVideoColorSpacePrimaryBT470BG = 5,
    kNERtcVideoColorSpacePrimarySMPTE170M = 6,
    kNERtcVideoColorSpacePrimarySMPTE240M = 7,
    kNERtcVideoColorSpacePrimaryFILM = 8,
    kNERtcVideoColorSpacePrimaryBT2020 = 9,
    kNERtcVideoColorSpacePrimarySMPTEST428 = 10,
    kNERtcVideoColorSpacePrimarySMPTEST431 = 11,
    kNERtcVideoColorSpacePrimarySMPTEST432 = 12,
    kNERtcVideoColorSpacePrimaryJEDECP22 = 22,
} NERtcVideoColorSpacePrimary;

typedef enum {
    kNERtcVideoColorSpaceTransferInvalid = 0,
    kNERtcVideoColorSpaceTransferBT709 = 1,
    kNERtcVideoColorSpaceTransferUNSPECIFIED = 2,
    kNERtcVideoColorSpaceTransferGAMMA22 = 4,
    kNERtcVideoColorSpaceTransferGAMMA28 = 5,
    kNERtcVideoColorSpaceTransferSMPTE170M = 6,
    kNERtcVideoColorSpaceTransferSMPTE240M = 7,
    kNERtcVideoColorSpaceTransferLINEAR = 8,
    kNERtcVideoColorSpaceTransferLOG = 9,
    kNERtcVideoColorSpaceTransferLOG_SQRT = 10,
    kNERtcVideoColorSpaceTransferIEC61966_2_4 = 11,
    kNERtcVideoColorSpaceTransferBT1361_ECG = 12,
    kNERtcVideoColorSpaceTransferIEC61966_2_1 = 13,
    kNERtcVideoColorSpaceTransferBT2020_10 = 14,
    kNERtcVideoColorSpaceTransferBT2020_12 = 15,
    kNERtcVideoColorSpaceTransferSMPTEST2084 = 16,
    kNERtcVideoColorSpaceTransferSMPTEST428 = 17,
    kNERtcVideoColorSpaceTransferARIB_STD_B67 = 18,
} NERtcVideoColorSpaceTransfer;

struct NERtcCameraCaptureConfig {
    int captureWidth;
    int captureHeight;

    NERtcVideoColorSpaceRange colorSpaceRange;
 
    NERtcCameraCaptureConfig() : captureWidth(0), captureHeight(0), colorSpaceRange(kNERtcVideoColorSpaceRangeInvalid) {}
};

typedef enum {
    kNERtcVideoProfileLowest = 0,
    kNERtcVideoProfileLow = 1,
    kNERtcVideoProfileStandard = 2,
    kNERtcVideoProfileHD720P = 3,
    kNERtcVideoProfileHD1080P = 4,
    kNERtcVideoProfileNone = 5,
    kNERtcVideoProfileMAX = kNERtcVideoProfileHD1080P,
} NERtcVideoProfileType;

typedef enum {
    kNERtcRemoteVideoStreamTypeHigh = 0,
    kNERtcRemoteVideoStreamTypeLow = 1,
    kNERtcRemoteVideoStreamTypeMid = 2,
    kNERtcRemoteVideoStreamTypeNone = 3,
} NERtcRemoteVideoStreamType;

typedef enum {
    kNERtcAudioDeviceUnknown = 0,
    kNERtcAudioDeviceRecord,
    kNERtcAudioDevicePlayout,
} NERtcAudioDeviceType;

typedef enum {
    kNERtcAudioDeviceActive = 0,
    kNERtcAudioDeviceUnactive,
    kNERtcAudioDeviceSelectChanged = 100,
} NERtcAudioDeviceState;

typedef enum {
    kNERtcAudioDeviceTransportTypeUnknown = 0,
    kNERtcAudioDeviceTransportTypeBluetooth = 1,
    kNERtcAudioDeviceTransportTypeBluetoothA2DP = 2,
    kNERtcAudioDeviceTransportTypeBluetoothLE = 3,
    kNERtcAudioDeviceTransportTypeUSB = 4,
    kNERtcAudioDeviceTransportTypeHDMI = 5,
    kNERtcAudioDeviceTransportTypeBuiltIn = 6,
    kNERtcAudioDeviceTransportTypeThunderbolt = 7,
    kNERtcAudioDeviceTransportTypeAirPlay = 8,
    kNERtcAudioDeviceTransportTypeVirtual = 9,
    kNERtcAudioDeviceTransportTypeOther = 10,
} NERtcAudioDeviceTransportType;

typedef enum {
    kNERtcVideoDeviceTransportTypeUnknown = 0,
    kNERtcVideoDeviceTransportTypeUSB = 1,
    kNERtcVideoDeviceTransportTypeVirtual = 2,
    kNERtcVideoDeviceTransportTypeOther = 3,
} NERtcVideoDeviceTransportType;

struct NERtcDeviceInfo {
    char device_id[kNERtcMaxDeviceIDLength];
    char device_name[kNERtcMaxDeviceNameLength];
    int transport_type;
    bool suspected_unavailable;
    bool system_default_device;
    bool select_priority_device;
    NERtcDeviceInfo()
        : transport_type(0), suspected_unavailable(false), system_default_device(false), select_priority_device(false) {
      memset(device_id, 0, kNERtcMaxDeviceIDLength);
      memset(device_name, 0, kNERtcMaxDeviceNameLength);
    }
};

typedef enum {
    kNERtcVideoDeviceUnknown = 0,
    kNERtcVideoDeviceCapture,
} NERtcVideoDeviceType;

typedef enum {
    kNERtcVideoDeviceAdded = 0,
    kNERtcVideoDeviceRemoved,
} NERtcVideoDeviceState;

typedef enum {
    kNERtcVideoScaleFit = 0,
    kNERtcVideoScaleFullFill = 1,
    kNERtcVideoScaleCropFill = 2,
} NERtcVideoScalingMode;

typedef enum {
    kNERtcVideoMirrorModeAuto = 0,
    kNERtcVideoMirrorModeEnabled = 1,
    kNERtcVideoMirrorModeDisabled = 2,
} NERtcVideoMirrorMode;

typedef enum {

    kNERtcVideoOutputOrientationModeAdaptative = 0,

    kNERtcVideoOutputOrientationModeFixedLandscape = 1,

    kNERtcVideoOutputOrientationModeFixedPortrait = 2,
 
} NERtcVideoOutputOrientationMode;

typedef enum {
    kNERtcConnectionStateDisconnected = 1,
    kNERtcConnectionStateConnecting = 2,
    kNERtcConnectionStateConnected = 3,
    kNERtcConnectionStateReconnecting = 4,
    kNERtcConnectionStateFailed = 5,
} NERtcConnectionStateType;

typedef enum {
    kNERtcReasonConnectionChangedLeaveChannel = 1,
    kNERtcReasonConnectionChangedChannelClosed = 2,
    kNERtcReasonConnectionChangedBeKicked = 3,
    kNERtcReasonConnectionChangedTimeOut = 4,
    kNERtcReasonConnectionChangedJoinChannel = 5,
    kNERtcReasonConnectionChangedJoinSucceed = 6,
    kNERtcReasonConnectionChangedReJoinSucceed = 7,
    kNERtcReasonConnectionChangedMediaConnectionDisconnected = 8,
    kNERtcReasonConnectionChangedSignalDisconnected = 9,
    kNERtcReasonConnectionChangedRequestChannelFailed = 10,
    kNERtcReasonConnectionChangedJoinChannelFailed = 11,
    kNERtcReasonConnectionChangedReDispatch = 12,
    kNERtcReasonConnectionChangedSettingProxyServer = 13
 
} NERtcReasonConnectionChangedType;

typedef enum {
    kNERtcNetworkConnectionTypeNone = 0,
    kNERtcNetworkConnectionTypeUnknown = 1,
    kNERtcNetworkConnectionType2G = 2,
    kNERtcNetworkConnectionType3G = 3,
    kNERtcNetworkConnectionType4G = 4,
    kNERtcNetworkConnectionType5G = 5,
    kNERtcNetworkConnectionTypeWiFi = 6,
    kNERtcNetworkConnectionTypeWWAN = 7,
    
    kNERtcNetworkConnectionTypeEthernet = 8,
 
} NERtcNetworkConnectionType;

typedef enum {
    kNERtcVideoLowlightEnhanceLevelQuality = 1,

    kNERtcVideoLowlightEnhanceLevelBalance = 2,

    kNERtcVideoLowlightEnhanceLevelAuto = 3,
} NERtcVideoLowlightEnhanceLevel;

struct NERtcAudioVolumeInfo {
    uid_t uid;
    unsigned int volume;
    
    unsigned int sub_stream_volume;
};

struct NERtcStats {
    uint32_t cpu_app_usage;
    uint32_t cpu_idle_usage;
    uint32_t cpu_total_usage;
    uint32_t memory_app_usage;
    uint32_t memory_total_usage;
    uint32_t memory_app_kbytes;
    int total_duration;
    uint64_t tx_bytes;
    uint64_t rx_bytes;
    uint64_t tx_audio_bytes;
    uint64_t tx_video_bytes;
    uint64_t rx_audio_bytes;
    uint64_t rx_video_bytes;
    int tx_audio_kbitrate;
    int rx_audio_kbitrate;
    int tx_video_kbitrate;
    int rx_video_kbitrate;
    int up_rtt;
    int down_rtt;
    int tx_audio_packet_loss_rate;
    int tx_video_packet_loss_rate;
    int tx_audio_packet_loss_sum;
    int tx_video_packet_loss_sum;
    int tx_audio_jitter;
    int tx_video_jitter;
    int rx_audio_packet_loss_rate;
    int rx_video_packet_loss_rate;
    int rx_audio_packet_loss_sum;
    int rx_video_packet_loss_sum;
    int rx_audio_jitter;
    int rx_video_jitter;
};

struct NERtcVideoLayerSendStats {
    int layer_type;
    int width;
    int height;
    int capture_width;
    int capture_height;
    int capture_frame_rate;
    int render_frame_rate;
    int encoder_frame_rate;
    int sent_frame_rate;
    int sent_bitrate;
    int target_bitrate;
    int encoder_bitrate;
    char codec_name[kNERtcMaxDeviceNameLength];
    bool drop_bandwidth_strategy_enabled;
 
    NERtcVideoLayerSendStats() {
        memset(this, 0, sizeof(NERtcVideoLayerSendStats));
    }
};

struct NERtcVideoSendStats {
    NERtcVideoLayerSendStats* video_layers_list;
    int video_layers_count;
};

struct NERtcVideoLayerRecvStats {
    int layer_type;
    int width;
    int height;
    int received_bitrate;
    int received_frame_rate;
    int decoder_frame_rate;
    int render_frame_rate;
    int packet_loss_rate;
    int total_frozen_time;
    int frozen_rate;
    char codec_name[kNERtcMaxDeviceNameLength];
    int peer_to_peer_delay;
 
    NERtcVideoLayerRecvStats() {
        memset(this, 0, sizeof(*this));
    }
};

struct NERtcVideoRecvStats {
    uid_t uid;
    NERtcVideoLayerRecvStats* video_layers_list;
    int video_layers_count;
};

typedef enum {
    kNERtcAudioStreamTypeMain = 0,

    kNERtcAudioStreamTypeSub = 1,
} NERtcAudioStreamType;

struct NERtcAudioLayerSendStats {
    NERtcAudioStreamType stream_type;
    int num_channels;
    int sent_sample_rate;
    int sent_bitrate;
    int audio_loss_rate;
    int64_t rtt;
    unsigned int volume;
    unsigned int cap_volume;
};

struct NERtcAudioSendStats {
    NERtcAudioLayerSendStats* audio_layers_list;
    int audio_layers_count;
};

struct NERtcAudioLayerRecvStats {
    NERtcAudioStreamType stream_type;
    int received_bitrate;
    int total_frozen_time;
    int frozen_rate;
    int audio_loss_rate;
    unsigned int volume;
    int av_timestamp_diff;
    int peer_to_peer_delay;
};

struct NERtcAudioRecvStats {
    uid_t uid;
    NERtcAudioLayerRecvStats* audio_layers_list;
    int audio_layers_count;
};

typedef enum {
    kNERtcNetworkQualityUnknown = 0,
    kNERtcNetworkQualityExcellent = 1,
    kNERtcNetworkQualityGood = 2,
    kNERtcNetworkQualityPoor = 3,
    kNERtcNetworkQualityBad = 4,
    kNERtcNetworkQualityVeryBad = 5,
    kNERtcNetworkQualityDown = 6,
} NERtcNetworkQualityType;

struct NERtcNetworkQualityInfo {
    uid_t uid;
    NERtcNetworkQualityType tx_quality;
    NERtcNetworkQualityType rx_quality;
};

typedef enum {
    kNERtcVideoCropModeDefault = 0,
    kNERtcVideoCropMode16x9 = 1,
    kNERtcVideoCropMode4x3 = 2,
    kNERtcVideoCropMode1x1 = 3,
} NERtcVideoCropMode;

typedef enum {
    kNERtcVideoFramerateFpsDefault = 0,
    kNERtcVideoFramerateFps_7 = 7,
    kNERtcVideoFramerateFps_10 = 10,
    kNERtcVideoFramerateFps_15 = 15,
    kNERtcVideoFramerateFps_24 = 24,
    kNERtcVideoFramerateFps_30 = 30,
    kNERtcVideoFramerateFps_60 = 60,
} NERtcVideoFramerateType;

typedef enum {
    kNERtcDegradationDefault = 0,
    kNERtcDegradationMaintainFramerate = 1,
    kNERtcDegradationMaintainQuality = 2,
    kNERtcDegradationBalanced = 3,
} NERtcDegradationPreference;

struct NERtcVideoConfig {
    NERtcVideoProfileType max_profile;
    uint32_t width;
    uint32_t height;
    NERtcVideoCropMode crop_mode_;
    NERtcVideoFramerateType framerate;
    NERtcVideoFramerateType min_framerate;
    uint32_t bitrate;
    uint32_t min_bitrate;
    NERtcDegradationPreference degradation_preference;
    NERtcVideoMirrorMode mirror_mode;
    NERtcVideoOutputOrientationMode orientation_mode;
 
    NERtcVideoConfig()
        : max_profile(kNERtcVideoProfileHD720P)
        , width(0)
        , height(0)
        , crop_mode_(kNERtcVideoCropModeDefault)
        , framerate(kNERtcVideoFramerateFpsDefault)
        , min_framerate(kNERtcVideoFramerateFpsDefault)
        , bitrate(0)
        , min_bitrate(0)
        , degradation_preference(kNERtcDegradationDefault)
        , mirror_mode(kNERtcVideoMirrorModeAuto)
        , orientation_mode(kNERtcVideoOutputOrientationModeAdaptative) {}
};

typedef void (*onFrameDataCallback)(uid_t uid, void* data, uint32_t type, uint32_t width, uint32_t height,
                                    uint32_t count, uint32_t offset[4], uint32_t stride[4], uint32_t rotation,
                                    void* user_data);

struct NERtcVideoCallbackFrame {
  void* data;          // 数据指针
  uint32_t type;       // 数据类型
  uint32_t width;      // 宽度
  uint32_t height;     // 高度
  uint32_t count;      // 数据类型个数
  uint32_t offsets[4];  // 每类数据偏移
  uint32_t strides[4];  // 每类数据步进
  uint32_t rotation;   // 画面旋转角度
  NERtcVideoColorSpaceRange color_space_range;  // 颜色空间范围
  NERtcVideoColorSpaceMatrix color_space_matrix;  // 颜色空间矩阵
  NERtcVideoColorSpacePrimary color_space_primary;  // 颜色空间主色
  NERtcVideoColorSpaceTransfer color_space_transfer;  // 颜色空间传输
};

typedef void (*onNERtcVideoFrameDataCallback)(uid_t uid, const NERtcVideoCallbackFrame& frame, void* user_data);

typedef enum {
    kNERtcScreenProfile480P = 0,
    kNERtcScreenProfileHD720P = 1,
    kNERtcScreenProfileHD1080P = 2,
    kNERtcScreenProfileCustom = 3,
    kNERtcScreenProfileNone = 4,
    kNERtcScreenProfileMAX = kNERtcScreenProfileHD1080P,
} NERtcScreenProfileType;

typedef enum {
    kScreenCaptureStatusStart = 1,

    kScreenCaptureStatusPause = 2,

    kScreenCaptureStatusResume = 3,

    kScreenCaptureStatusStop = 4,

    kScreenCaptureStatusCovered = 5,

    kScreenCaptureStatusAbort = 6,
    
    kScreenCaptureStatusExcludeWndError = 101,
} NERtcScreenCaptureStatus;

struct NERtcRectangle {
    int x;
    int y;
    int width;
    int height;
 
    NERtcRectangle() : x(0), y(0), width(0), height(0) {}
    NERtcRectangle(int xx, int yy, int ww, int hh) : x(xx), y(yy), width(ww), height(hh) {}
};

typedef enum {
  kUnknown = -1,
  kWindow = 0,
  kScreen = 1,
  kCustom = 2,
} NERtcScreenCaptureSourceType;

typedef enum {
  kSetPos = 0,
  kSetAbove = 1,
  kSetBelow = 2,
  kHide = 3,
  kShow = 4,
} NERtcScreenCaptureCustomHLBorderAction;

struct NERtcScreenCaptureSourceData {
  NERtcScreenCaptureSourceType type;

  source_id_t source_id;

  NERtcScreenCaptureStatus status;

  NERtcScreenCaptureCustomHLBorderAction action;

  NERtcRectangle capture_rect;

  int level;
 
  NERtcScreenCaptureSourceData()
    : type(kUnknown)
    , source_id(0)
    , status(kScreenCaptureStatusStart)
    , action(kSetPos)
    , level(0) {}
};

struct NERtcVideoDimensions {
    int width;
    int height;
 
    NERtcVideoDimensions() : width(0), height(0) {}
    NERtcVideoDimensions(int ww, int hh) : width(ww), height(hh) {}
};
 
typedef NERtcVideoDimensions NERtcDimensions;

typedef enum {
    kNERtcSubStreamContentPreferMotion = 0,
    kNERtcSubStreamContentPreferDetails = 1, 
} NERtcSubStreamContentPrefer;

struct NERtcScreenCaptureParameters {
    NERtcScreenProfileType profile;
    NERtcVideoDimensions dimensions;
    int frame_rate;
    int min_framerate;
    int bitrate;
    int min_bitrate;
    bool capture_mouse_cursor;
    bool window_focus;
    source_id_t* excluded_window_list;
    int excluded_window_count;
    NERtcSubStreamContentPrefer prefer;

    NERtcDegradationPreference degradation_preference;

    bool enable_high_performance;

    bool enable_high_light;

    int high_light_width;

    unsigned int high_light_color;

    int high_light_length;

    bool exclude_highlight_box;
  
    bool force_update_data;

    NERtcVideoColorSpaceRange prefer_color_space_range;
 
    NERtcScreenCaptureParameters()
        : profile(kNERtcScreenProfileHD1080P)
        , frame_rate(5)
        , min_framerate(0)
        , bitrate(0)
        , min_bitrate(0)
        , capture_mouse_cursor(true)
        , window_focus(true)
        , excluded_window_list(NULL)
        , excluded_window_count(0)
        , prefer(kNERtcSubStreamContentPreferMotion)
        , degradation_preference(kNERtcDegradationMaintainQuality)
        , enable_high_performance(true)
        , enable_high_light(true)
        , high_light_width(6)
        , high_light_color(0xFF7EDE00)
        , high_light_length(120)
        , exclude_highlight_box(true)
        , force_update_data(false)
        , prefer_color_space_range(kNERtcVideoColorSpaceRangeInvalid) {}
};

struct NERtcVideoCanvas {
    onFrameDataCallback cb = nullptr;

    onNERtcVideoFrameDataCallback on_video_frame_data_callback = nullptr;
    void* user_data = nullptr;
    void* window = nullptr;
    NERtcVideoScalingMode scaling_mode = kNERtcVideoScaleFit;

    NERtcVideoMirrorMode mirror_mode = kNERtcVideoMirrorModeDisabled;

    uint32_t background_color = 0x000000;
 
    NERtcVideoCanvas()
        : user_data(nullptr)
        , window(nullptr)
        , cb(nullptr)
        , on_video_frame_data_callback(nullptr)
        , scaling_mode(kNERtcVideoScaleFit)
        , mirror_mode(kNERtcVideoMirrorModeDisabled)
        , background_color(0) {}
};

typedef enum {
    kNERtcRecordTypeAll = 0,
    kNERtcRecordTypeMix = 1,
    kNERtcRecordTypeSingle = 2,
 
} NERtcRecordType;

typedef enum {
    kNERtcAudioTypePCM16 = 0,
} NERtcAudioType;

typedef enum {
    kNERtcRawAudioFrameOpModeReadOnly = 0,
    kNERtcRawAudioFrameOpModeReadWrite,
} NERtcRawAudioFrameOpModeType;

struct NERtcAudioFrameRequestFormat {
    uint32_t channels;
    uint32_t sample_rate;
    NERtcRawAudioFrameOpModeType mode;
 
    NERtcAudioFrameRequestFormat() : channels(0), sample_rate(0), mode(kNERtcRawAudioFrameOpModeReadWrite) {}
};

struct NERtcAudioFormat {
    NERtcAudioType type;
    uint32_t channels;
    uint32_t sample_rate;
    uint32_t bytes_per_sample;
    uint32_t samples_per_channel;
 
    NERtcAudioFormat()
        : type(kNERtcAudioTypePCM16), channels(1), sample_rate(48000), bytes_per_sample(2), samples_per_channel(480) {}
};

struct NERtcAudioFrame {
    NERtcAudioFormat format;
    void* data;
    int64_t sync_timestamp;
 
    NERtcAudioFrame() : data(NULL), sync_timestamp(-1) {}
};

typedef enum {
    kNERtcAudioPayloadTypeOPUS = 111,
} NERtcAudioPayloadType;

struct NERtcAudioEncodedFrame {
    unsigned char* data;
    int64_t timestamp_us;
    int sample_rate;
    int channels;
    int samples_per_channel;
    int encoded_len;
    int encoded_timestamp;
    NERtcAudioPayloadType payload_type;

    uint8_t rms_level;
    NERtcAudioEncodedFrame()
        : data(nullptr)
        , timestamp_us(0)
        , sample_rate(0)
        , channels(0)
        , samples_per_channel(0)
        , encoded_len(0)
        , encoded_timestamp(0)
        , payload_type(kNERtcAudioPayloadTypeOPUS)
        , rms_level(100) {}
};

class INERtcAudioFrameObserver {
public:
    virtual ~INERtcAudioFrameObserver() {}
    virtual void onAudioFrameDidRecord(NERtcAudioFrame* frame) {
        (void)frame;
    }

    virtual void onSubStreamAudioFrameDidRecord(NERtcAudioFrame* frame) {
        (void)frame;
    }
  
    virtual void onAudioFrameWillPlayback(NERtcAudioFrame* frame) {
        (void)frame;
    }

    virtual void onMixedAudioFrame(NERtcAudioFrame* frame) {
        (void)frame;
    }

    virtual void onPlaybackAudioFrameBeforeMixing(uint64_t userID, NERtcAudioFrame* frame) {
        (void)userID;
        (void)frame;
    }

    virtual void onPlaybackAudioFrameBeforeMixing(uint64_t userID, NERtcAudioFrame* frame, channel_id_t cid) {
        (void)userID;
        (void)frame;
        (void)cid;
    }

    virtual void onPlaybackSubStreamAudioFrameBeforeMixing(uint64_t userID, NERtcAudioFrame* frame,
                                                           channel_id_t cid) {
        (void)userID;
        (void)frame;
        (void)cid;
    }

    virtual void onPlaybackAudioFrameBeforeMixingForPlayStreaming(const char* stream_id, NERtcAudioFrame* frame) {
        (void)stream_id;
        (void)frame;
    }
};

typedef enum {
    kNERtcVideoTypeI420 = 0,
    kNERtcVideoTypeNV12 = 1,
    kNERtcVideoTypeNV21 = 2,
    kNERtcVideoTypeBGRA = 3,
    kNERtcVideoTypeARGB = 4,
    kNERtcVideoTypeCVPixelBuffer = 5,
    kNERtcVideoTypeRGBA = 6,
} NERtcVideoType;

typedef enum {
    kNERtcVideoRotation_0 = 0,
    kNERtcVideoRotation_90 = 90,
    kNERtcVideoRotation_180 = 180,
    kNERtcVideoRotation_270 = 270,
} NERtcVideoRotation;

struct NERtcVideoFrame {
    NERtcVideoType format;
    uint64_t timestamp;
    uint32_t width;
    uint32_t height;
    NERtcVideoRotation rotation;
    void* buffer;

    NERtcVideoColorSpaceRange color_space_range;

    NERtcVideoColorSpaceMatrix color_space_matrix;

    NERtcVideoColorSpacePrimary color_space_primary;

    NERtcVideoColorSpaceTransfer color_space_transfer;
 
    NERtcVideoFrame()
        : format(kNERtcVideoTypeI420)
        , timestamp(0)
        , width(0)
        , height(0)
        , rotation(kNERtcVideoRotation_0)
        , buffer(NULL)
        , color_space_range(kNERtcVideoColorSpaceRangeInvalid)
        , color_space_matrix(kNERtcVideoColorSpaceMatrixRGB)
        , color_space_primary(kNERtcVideoColorSpacePrimaryInvalid)
        , color_space_transfer(kNERtcVideoColorSpaceTransferInvalid) {}
};

typedef enum {
    kNERtcVideoCodecTypeH264 = 3,
} NERtcVideoCodecType;

typedef enum {
    kNERtcNalFrameTypeIDR = 1,
    kNERtcNalFrameTypeI = 2,
    kNERtcNalFrameTypeP = 3,
} NERtcNalFrameType;

struct NERtcVideoEncodedFrame {
    NERtcVideoCodecType codec_type;
    NERtcNalFrameType frame_type;
    int nal_count;
    int* nal_length;
    unsigned char* nal_data;
    int64_t timestamp_us;
    int width;
    int height;
};

typedef enum {
    kNERtcSessionLeaveNormal = 0,
    kNERtcSessionLeaveForFailOver = 1,
    kNERtcSessionLeaveUpdate = 2,
    kNERtcSessionLeaveForKick = 3,
    kNERtcSessionLeaveTimeOut = 4,
} NERtcSessionLeaveReason;

typedef enum {
    kNERtcAudioMixingStateFinished = 0,
    kNERtcAudioMixingStateFailed = 1,
} NERtcAudioMixingState;

struct NERtcCreateAudioMixingOption {
    char path[kNERtcMaxURILength];
    int loop_count;
    bool send_enabled;
    uint32_t send_volume;
    bool playback_enabled;
    uint32_t playback_volume;

    uint64_t start_timestamp;

    NERtcAudioStreamType send_with_audio_type;

    uint32_t progress_interval;
 
    NERtcCreateAudioMixingOption()
        : loop_count(1)
        , send_enabled(true)
        , send_volume(100)
        , playback_enabled(true)
        , playback_volume(100)
        , start_timestamp(0)
        , send_with_audio_type(kNERtcAudioStreamTypeMain)
        , progress_interval(kDefaultAudioMixProgressInterval) {
        memset(path, 0, sizeof(path));
    }
};

struct NERtcCreateAudioEffectOption {
    char path[kNERtcMaxURILength];
    int loop_count;
    bool send_enabled;
    uint32_t send_volume;
    bool playback_enabled;
    uint32_t playback_volume;

    NERtcAudioStreamType send_with_audio_type;

    uint64_t start_timestamp;

    uint32_t progress_interval;
 
    NERtcCreateAudioEffectOption()
        : loop_count(1)
        , send_enabled(true)
        , send_volume(100)
        , playback_enabled(true)
        , playback_volume(100)
        , send_with_audio_type(kNERtcAudioStreamTypeMain)
        , start_timestamp(0)
        , progress_interval(kDefaultAudioMixProgressInterval) {
        memset(path, 0, sizeof(path));
    }
};
 
typedef enum {
    kNERtcVideoStreamLayerCountOne = 1,
    kNERtcVideoStreamLayerCountTwo = 2,
    kNERtcVideoStreamLayerCountThree = 3,
} NERtcVideoStreamLayerCount;

typedef enum {
  kNERTCVirtualBackground = 0,
 
 
} NERtcFeatureType;

typedef enum {
  kNERTCFeatureSupportFull = 0,
  
  kNERTCFeatureSupportHardwareLimit = 1,
  
  kNERTCFeatureSupportPerformanceLimit = 2
} NERTCFeatureSupportType;

typedef enum {
    kNERtcChannelMediaRelayStateIdle = 0,
    kNERtcChannelMediaRelayStateConnecting = 1,
    kNERtcChannelMediaRelayStateRunning = 2,
    kNERtcChannelMediaRelayStateFailure = 3,
} NERtcChannelMediaRelayState;

typedef enum {
    kNERtcChannelMediaRelayEventDisconnect = 0,
    kNERtcChannelMediaRelayEventConnecting = 1,
    kNERtcChannelMediaRelayEventConnected = 2,
    kNERtcChannelMediaRelayEventVideoSentToDestChannelSuccess = 3,
    kNERtcChannelMediaRelayEventAudioSentToDestChannelSuccess = 4,
    kNERtcChannelMediaRelayEventOtherStreamSentToDestChannelSuccess = 5,
    kNERtcChannelMediaRelayEventFailure = 100,
} NERtcChannelMediaRelayEvent;

struct NERtcChannelMediaRelayInfo {
    char channel_name[kNERtcMaxChannelNameLength];
    char channel_token[kNERtcMaxTokenLength];
    uid_t uid;
 
    NERtcChannelMediaRelayInfo() : uid(0) {
        memset(channel_name, 0, sizeof(channel_name));
        memset(channel_token, 0, sizeof(channel_token));
    }
};

struct NERtcChannelMediaRelayConfiguration {
    NERtcChannelMediaRelayInfo* src_infos;
    NERtcChannelMediaRelayInfo* dest_infos;
    int dest_count;
 
    NERtcChannelMediaRelayConfiguration() : src_infos(NULL), dest_infos(NULL), dest_count(0) {}
};

enum NERtcLocalVideoWatermarkState {
    kNERtcLocalWatermarkStateSetSuccess,
    kNERtcLocalWatermarkStateDeviceNotSupported,
    kNERtcLocalWatermarkStateImgFormatNotSupported,
    kNERtcLocalWatermarkStateImgNumError,
    kNERtcLocalWatermarkStateImgSizeError,
    kNERtcLocalWatermarkStateFPSError,
    kNERtcLocalWatermarkStateFontError,
    kNERtcLocalWatermarkStateWmAlphaError,
    kNERtcLocalWatermarkStateTextContentEmptyError,
    kNERtcLocalWatermarkStateCancel = 20
};
 
 
struct NERtcVideoWatermarkImageConfig {
  char image_paths[10][kNERtcMaxURILength];

  float wm_alpha;

  int wm_width;

  int wm_height;

  int offset_x;

  int offset_y;
  unsigned int fps;
  bool loop;
 
  NERtcVideoWatermarkImageConfig() : wm_alpha(1.0f), wm_width(0), wm_height(0), offset_x(0), offset_y(0), fps(0), loop(true) {
    memset(image_paths, 0, sizeof(image_paths));
  }
};
 
 
 

struct NERtcVideoWatermarkTextConfig {
  char content[kNERtcMaxBuffLength];
  char font_name[kNERtcMaxURILength];
  int font_color;
  int font_size;
  int wm_color;
  float wm_alpha;
  int wm_width;
  int wm_height;
  int offset_x;
  int offset_y;
 
  NERtcVideoWatermarkTextConfig()
      : font_color(0xFFFFFFFF),
        font_size(15),
        wm_color(0x88888888),
        wm_alpha(1.0f),
        wm_width(0),
        wm_height(0),
        offset_x(0),
        offset_y(0) {
    memset(content, 0, sizeof(content));
    memset(font_name, 0, sizeof(font_name));
  }
};

struct NERtcVideoWatermarkTimestampConfig {
  char font_name[kNERtcMaxURILength];
  int font_color;
  int font_size;
  int wm_color;
  float wm_alpha;
  int wm_width;
  int wm_height;
  int offset_x;
  int offset_y;
 
  NERtcVideoWatermarkTimestampConfig()
      : font_color(0xFFFFFFFF),
        font_size(15),
        wm_color(0x88888888),
        wm_alpha(1.0f),
        wm_width(0),
        wm_height(0),
        offset_x(0),
        offset_y(0) {
    memset(font_name, 0, sizeof(font_name));
  }
};

struct NERtcVideoWatermarkConfig {
    enum NERtcWatermarkType {
        kNERtcWatermarkTypeImage = 0,
        kNERtcWatermarkTypeText,
        kNERtcWatermarkTypeTimestamp
    };

    NERtcWatermarkType watermark_type;

    NERtcVideoWatermarkImageConfig image_watermarks;
    NERtcVideoWatermarkTextConfig text_watermarks;
    NERtcVideoWatermarkTimestampConfig timestamp_watermark;
 
    NERtcVideoWatermarkConfig() : watermark_type(kNERtcWatermarkTypeImage) {}
};
 
 
 

class NERtcTakeSnapshotCallback {
public:
    virtual ~NERtcTakeSnapshotCallback() {}
    virtual void onTakeSnapshotResult(int errorCode, const char* image) = 0;
};
 
class INERtcRemoteVideoFrameObserver {
 public:
  virtual ~INERtcRemoteVideoFrameObserver() {}

  virtual void onRemoteVideoFrame(NERtcVideoStreamType video_stream_type, uid_t uid, const NERtcVideoCallbackFrame& frame) {
    (void)video_stream_type;
    (void)uid;
    (void)frame;
  }

  virtual void onPlayStreamingVideoFrame(const char* stream_id, const NERtcVideoCallbackFrame& frame) {
    (void)stream_id;
    (void)frame;
  }
};

typedef enum {
    kNERtcLogLevelFatal = 0,
    kNERtcLogLevelError = 1,
    kNERtcLogLevelWarning = 2,
    kNERtcLogLevelInfo = 3,
    kNERtcLogLevelDetailInfo = 4,
    kNERtcLogLevelVerbos = 5,
    kNERtcLogLevelDebug = 6,
    kNERtcLogLevelOff = 7,
} NERtcLogLevel;
 

typedef enum {
    kNERtcAreaCodeTypeDefault = 0,
    kNERtcAreaCodeTypeCN = 1,
    kNERtcAreaCodeTypeOverseaDefault = 2,
} NERtcAreaCodeType;

typedef enum {
  kNERtcIPAddrV4Only = 0,
  kNERtcIPAddrV4AndV6 = 1,
} NERtcIPAddrMode;

typedef enum {
    kNERtcSendOnPubNone = 0,
    kNERtcSendOnPubHigh = 1,
    kNERtcSendOnPubLow = 1 << 1,
    kNERtcSendOnPubAll = kNERtcSendOnPubLow | kNERtcSendOnPubHigh,
} NERtcSendOnPubType;

struct NERtcServerAddresses {
    char lbs_server[kNERtcMaxURILength];
    char channel_server[kNERtcMaxURILength];
    char statistics_server[kNERtcMaxURILength];
    char statistics_dispatch_server[kNERtcMaxURILength];
    char statistics_backup_server[kNERtcMaxURILength];
    char room_server[kNERtcMaxURILength];
    char compat_server[kNERtcMaxURILength];
    char nos_lbs_server[kNERtcMaxURILength];
    char nos_upload_sever[kNERtcMaxURILength];
    char nos_token_server[kNERtcMaxURILength];
    char cloud_proxy_server[kNERtcMaxURILength];
    char websocket_proxy_server[kNERtcMaxURILength];
    char quic_proxy_server[kNERtcMaxURILength];
    char media_proxy_server[kNERtcMaxURILength];
    char low_latency_server[kNERtcMaxURILength];
    bool use_ipv6;
 
    NERtcServerAddresses() {
        memset(this, 0, sizeof(NERtcServerAddresses));
        use_ipv6 = false;
    }
};

typedef enum {
    kNERtcAudioRecordingQualityLow = 0,
    kNERtcAudioRecordingQualityMedium = 1,
    kNERtcAudioRecordingQualityHigh = 2,
} NERtcAudioRecordingQuality;
 
typedef enum {
    // 录制本地和所有远端用户混音后的音频（默认）
    kNERtcAudioRecordingPositionMixedRecordingAndPlayback = 0,
    // 仅录制本地用户的音频
    kNERtcAudioRecordingPositionRecording = 1,
    // 仅录制所有远端用户的音频
    kNERtcAudioRecordingPositionMixedPlayback = 2
} NERtcAudioRecordingPosition;
 
typedef enum {
    // 音频录制缓存时间为 0，实时写文件（默认）
    kNERtcAudioRecordingCycleTime0 = 0,
    // 音频录制缓存时间为 10s，StopAudioRectording()后，将缓存都写到文件，文件数据时间跨度为: [0,10s]
    kNERtcAudioRecordingCycleTime10 = 10,
    // 音频录制缓存时间为 60s，StopAudioRectording()后，将缓存都写到文件，文件数据时间跨度为: [0,60s]
    kNERtcAudioRecordingCycleTime60 = 60,
    // 音频录制缓存时间为 360s，StopAudioRectording()后，将缓存都写到文件，文件数据时间跨度为: [0,360s]
    kNERtcAudioRecordingCycleTime360 = 360,
    // 音频录制缓存时间为 900s，StopAudioRectording()后，将缓存都写到文件，文件数据时间跨度为: [0,900s]
    kNERtcAudioRecordingCycleTime900 = 900
} NERtcAudioRecordingCycleTime;
 
struct NERtcAudioRecordingConfiguration {
    // 录音文件在本地保存的绝对路径，需要精确到文件名及格式。例如：sdcard/xxx/audio.aac。请确保指定的路径存在并且可写。目前仅支持
    // WAV 或 AAC 文件格式。
    char filePath[kNERtcMaxURILength];
 
    // 录音采样率（Hz），可以设为 16000、32000（默认）、44100 或 48000。
    int sampleRate;
 
    // 录音音质，只在 AAC 格式下有效。详细信息请参考 {@link NERtcAudioRecordingQuality}。
    NERtcAudioRecordingQuality quality;
 
    // 录音文件所包含的内容。详细信息请参考 {@link NERtcAudioRecordingPosition}。
    NERtcAudioRecordingPosition position;
 
    // 录制过程中，循环缓存的最大时间长度，单位(s)。详细信息请参考 {@link NERtcAudioRecordingCycleTime}。
    NERtcAudioRecordingCycleTime cycleTime;
 
    NERtcAudioRecordingConfiguration()
        : sampleRate(32000)
        , quality(kNERtcAudioRecordingQualityLow)
        , position(kNERtcAudioRecordingPositionMixedRecordingAndPlayback)
        , cycleTime(kNERtcAudioRecordingCycleTime0) {
        memset(filePath, 0, sizeof(filePath));
    }
};

typedef enum {
    kNERtcAudioRecordErrorSuffix = 1,
    kNERtcAudioRecordOpenFileFailed = 2,
    kNERtcAudioRecordStart = 3,
    kNERtcAudioRecordError = 4,
    kNERtcAudioRecordFinish = 5,
} NERtcAudioRecordingCode;

typedef enum {
    kNERtcStreamFallbackDisabled = 0,

    kNERtcStreamFallbackVideoStreamLow = 1,

    kNERtcStreamFallbackAudioOnly = 2,
} NERtcStreamFallbackOption;

typedef enum {
    kNERtcGMCryptoSM4ECB = 0,
  NERtcEncryptionModeCustom,
} NERtcEncryptionMode;

struct NERtcMediaPacket {
  // 需要发送或接收的数据的缓存地址
  const unsigned char* buffer;
  // 需要发送或接收的数据的缓存大小
  long size;
};

class INERtcPacketObserver {
 public:
  virtual ~INERtcPacketObserver() {}
 
  virtual bool onSendAudioPacket(NERtcMediaPacket& packet) = 0;
  virtual bool onSendVideoPacket(NERtcMediaPacket& packet) = 0;
  virtual bool onReceiveAudioPacket(NERtcMediaPacket& packet) = 0;
  virtual bool onReceiveVideoPacket(NERtcMediaPacket& packet) = 0;
};

struct NERtcEncryptionConfig {
    NERtcEncryptionMode mode;
    char key[kNERtcEncryptByteLength];
    INERtcPacketObserver* observer = nullptr;
 
    NERtcEncryptionConfig() : mode(kNERtcGMCryptoSM4ECB) { memset(key, 0, sizeof(key)); }
};

struct NERtcLastmileProbeConfig {
    bool probe_uplink;
    bool probe_downlink;
    uint32_t expected_uplink_bitratebps;
    uint32_t expected_downlink_bitratebps;
 
    NERtcLastmileProbeConfig()
        : probe_uplink(true)
        , probe_downlink(true)
        , expected_uplink_bitratebps(2000000)
        , expected_downlink_bitratebps(2000000) {}
};

typedef enum {
    kNERtcLastmileProbeResultComplete = 1,
    kNERtcLastmileProbeResultIncompleteNoBwe = 2,
    kNERtcLastmileProbeResultUnavailable = 3,
} NERtcLastmileProbeResultState;

struct NERtcLastmileProbeOneWayResult {
    uint32_t jitter;
    uint32_t packet_loss_rate;
    uint32_t available_band_width;
};

struct NERtcLastmileProbeResult {
    uint32_t rtt;
    NERtcLastmileProbeResultState state;
    NERtcLastmileProbeOneWayResult uplink_report;
    NERtcLastmileProbeOneWayResult downlink_report;
};
 
typedef enum {
    kNERtcTransportTypeNoneProxy = 0,
    kNERtcTransportTypeUDPProxy = 1,
} NERtcTransportType;

typedef enum {
    kNERtcInstallCastAudioDriverSuccess = 0,
    kNERtcInstallCastAudioDriverNotAuthorized = 1,
    kNERtcInstallCastAudioDriverFailed = 2,
} NERtcInstallCastAudioDriverResult;

enum NERtcVirtualBackgroundSourceStateReason {
    kNERtcVirtualBackgroundSourceStateReasonSuccess = 0,
    kNERtcVirtualBackgroundSourceStateReasonImageNotExist = 1,
    kNERtcVirtualBackgroundSourceStateReasonImageFormatNotSupported = 2,
    kNERtcVirtualBackgroundSourceStateReasonColorFormatNotSupported = 3,
    kNERtcVirtualBackgroundSourceStateReasonDeviceNotSupported = 4,
    kNERtcVirtualBackgroundSourceStateReasonVideoDecodeFail = 5
};

struct VirtualBackgroundSource {
    enum NERtcBackgroundSourceType {
        kNERtcBackgroundColor = 1,

        kNERtcBackgroundImage,
      
        kNERtcBackgroundVideo = 4,
    };

    NERtcBackgroundSourceType background_source_type;

    unsigned int color;

     char* source;
 
    VirtualBackgroundSource() : background_source_type(kNERtcBackgroundColor), color(0xffffff), source(NULL) {}
};

typedef enum {
    NERtcAudioDumpTypePCM = 0,
    NERtcAudioDumpTypeAll = 1,
    NERtcAudioDumpTypeWAV = 2
} NERtcAudioDumpType;

typedef enum {
    NERtcVideoDumpTypeClear = 0,
    NERtcVideoDumpTypeStopAndUpload = 1,
    NERtcVideoDumpTypeSendAndReceive = 2,
    NERtcVideoDumpTypeSend = 3,
    NERtcVideoDumpTypeReceive = 4,
    NERtcVideoDumpTypeSendAndReceiveLoop = 5,
    NERtcVideoDumpTypeSendAndLoop = 6,
    NERtcVideoDumpTypeReceiveAndLoop = 7
} NERtcVideoDumpType;

struct NERtcReverbParam {
    float wetGain;
    float dryGain;
    float damping;
    float roomSize;
    float decayTime;
    float preDelay;
};

struct NERtcLowLatencyOptions {
    bool enable_low_latency;
    unsigned int play_timeout;
    NERtcVideoCanvas* play_canvas;
   
    NERtcLowLatencyOptions() : enable_low_latency(false), play_timeout(60), play_canvas(nullptr) {
    }
};

struct NERtcJoinChannelOptions {
    char custom_info[kNERtcCustomInfoLength];
    char* permission_key;
    NERtcLowLatencyOptions low_latency_options;
 
    NERtcJoinChannelOptions() : permission_key(NULL) { 
        memset(custom_info, 0, sizeof(custom_info)); 
    }
};
 
typedef enum {
    NERtcRangeAudioModeDefault = 0,
    NERtcRangeAudioModeTeam = 1,
} NERtcRangeAudioMode;
 
struct NERtcJoinChannelOptionsEx {
    char custom_info[kNERtcCustomInfoLength];
    char* permission_key;
    int32_t team_id;
    NERtcRangeAudioMode mode;
    int audible_distance;
 
    NERtcJoinChannelOptionsEx() : permission_key(NULL), team_id(-1), mode(NERtcRangeAudioModeDefault), audible_distance(-1) { 
        memset(custom_info, 0, sizeof(custom_info)); 
    }
};

struct NERtcUserJoinExtraInfo {
    char custom_info[kNERtcCustomInfoLength];
    NERtcUserJoinExtraInfo(){ 
        memset(custom_info, 0, sizeof(custom_info));
    }
};

typedef enum {
    NERtcMediaPubTypeAudio
} NERtcMediaPubType;

typedef enum {
    kNERtcBeautyWhiteTeeth = 0,

    kNERtcBeautyLightEye,

    kNERtcBeautyWhiten,

    kNERtcBeautySmooth,

    kNERtcBeautySmallNose,

    kNERtcBeautyEyeDis,

    kNERtcBeautyEyeAngle,

    kNERtcBeautyMouth,

    kNERtcBeautyBigEye,

    kNERtcBeautySmallFace,

    kNERtcBeautyJaw,

    kNERtcBeautyThinFace,

    kNERtcBeautyFaceRuddy,

    kNERtcBeautyLongNose,

    kNERtcBeautyRenZhong,

    kNERtcBeautyMouthAngle,

    kNERtcBeautyRoundEye,

    kNERtcBeautyOpenEyeAngle,

    kNERtcBeautyVFace,

    kNERtcBeautyThinUnderjaw,

    kNERtcBeautyNarrowFace,

    kNERtcBeautyCheekBone,

    kNERtcBeautyFaceSharpen,

    kNERtcBeautyMouthWider,
    
    kNERtcBeautyForeheadWrinkles,
    
    kNERtcBeautyDarkCircles,
    
    kNERtcBeautySmileLines,
    
    kNERtcBeautyShortFace
} NERtcBeautyEffectType;
 
struct NERtcSize {
  int width;
  int height;
 
  NERtcSize() : width(0), height(0) {}
  NERtcSize(int w, int h) : width(w), height(h) {}
};

struct NERtcThumbImageBuffer {
  const char* buffer;
  unsigned int length;
  unsigned int width;
  unsigned int height;
 
  NERtcThumbImageBuffer() : buffer(nullptr), length(0), width(0), height(0) {}
};

struct NERtcScreenCaptureSourceInfo {
  NERtcScreenCaptureSourceType type;
  source_id_t source_id;
  const char* source_name;
  NERtcThumbImageBuffer thumb_image;
  NERtcThumbImageBuffer icon_image;
  const char* process_path;
  const char* source_title;
  bool primaryMonitor;
  
  NERtcScreenCaptureSourceInfo()
    : type(kUnknown)
    , source_id(nullptr)
    , source_name(nullptr)
    , process_path(nullptr)
    , source_title(nullptr)
    , primaryMonitor(false) {}
};

class IScreenCaptureSourceList {
protected:
  virtual ~IScreenCaptureSourceList() {};
 
public:
  virtual unsigned int getCount() = 0;
  virtual NERtcScreenCaptureSourceInfo getSourceInfo(unsigned int index) = 0;
  virtual void release() = 0;
};

typedef enum {
  kNERtcSpatializerRoomCapacitySmall = 0,

  kNERtcSpatializerRoomCapacityMedium = 1,

  kNERtcSpatializerRoomCapacityLarge = 2,

  kNERtcSpatializerRoomCapacityHuge = 3,

  kNERtcSpatializerRoomCapacityNone = 4
} NERtcSpatializerRoomCapacity;

typedef enum {
  kNERtcSpatializerMaterialTransparent = 0,
  kNERtcSpatializerMaterialAcousticCeilingTiles,
  kNERtcSpatializerMaterialBrickBare,
  kNERtcSpatializerMaterialBrickPainted,
  kNERtcSpatializerMaterialConcreteBlockCoarse,
  kNERtcSpatializerMaterialConcreteBlockPainted,
  kNERtcSpatializerMaterialCurtainHeavy,
  kNERtcSpatializerMaterialFiberGlassInsulation,
  kNERtcSpatializerMaterialGlassThin,
  kNERtcSpatializerMaterialGlassThick,
  kNERtcSpatializerMaterialGrass,
  kNERtcSpatializerMaterialLinoleumOnConcrete,
  kNERtcSpatializerMaterialMarble,
  kNERtcSpatializerMaterialMetal,
  kNERtcSpatializerMaterialParquetOnConcrete,
  kNERtcSpatializerMaterialPlasterRough,
  kNERtcSpatializerMaterialPlasterSmooth,
  kNERtcSpatializerMaterialPlywoodPanel,
  kNERtcSpatializerMaterialPolishedConcreteOrTile,
  kNERtcSpatializerMaterialSheetrock,
  kNERtcSpatializerMaterialWaterOrIceSurface,
  kNERtcSpatializerMaterialWoodCeiling,
  kNERtcSpatializerMaterialWoodPanel,
  kNERtcSpatializerMaterialUniform
} NERtcSpatializerMaterialName;

typedef enum {
  kNERtcSpatializerRenderStereoPanning = 0,
  kNERtcSpatializerRenderBinauralLowQuality,
  kNERtcSpatializerRenderBinauralMediumQuality,
  kNERtcSpatializerRenderBinauralHighQuality,
  kNERtcSpatializerRenderRoomEffectsOnly
} NERtcSpatializerRenderMode;

typedef enum {
  kNERtcDistanceRolloffLogarithmic = 0,
  kNERtcDistanceRolloffLinear,
  kNERtcDistanceRolloffNone,
  kNERtcDistanceRolloffLinearOnly,
} NERtcDistanceRolloffModel;

struct NERtcPositionInfo {
  float speaker_position[3];
  float speaker_quaternion[4];
  float head_position[3];
  float head_quaternion[4];
};

struct NERtcSpatializerRoomProperty {
  NERtcSpatializerRoomCapacity room_capacity;
  NERtcSpatializerMaterialName material;
  float reflection_scalar;
  float reverb_gain;
  float reverb_time;
  float reverb_brightness;
};
 

struct NERtcStreamingRoomInfo {

  uint64_t uid;

  const char* channel_name;
  const char* token;
};
 

struct NERtcPushStreamingConfig {
  const char* streaming_url;

  NERtcStreamingRoomInfo streaming_room_info;
};
 

struct NERtcPlayStreamingConfig {
  const char* streaming_url;

  uint32_t playout_delay;
  
  uint32_t reconnect_timeout;

  bool mute_audio_play;

  bool mute_video_play;

  bool pause_play_streaming;
 
  NERtcPlayStreamingConfig()
      : streaming_url(nullptr),
        playout_delay(2000),
        reconnect_timeout(30000),
        mute_audio_play(false),
        mute_video_play(false),
        pause_play_streaming(false) {}
};

typedef enum {
  kNERtcLocalRecorderStatusNone = 0,

  kNERtcLocalRecorderStatusFlvStart,

  kNERtcLocalRecorderStatusFlvEnd,

  kNERtcLocalRecorderStatusMp4Start,

  kNERtcLocalRecorderStatusMp4End,

  kNERtcLocalRecorderStatusRemuxStart,

  kNERtcLocalRecorderStatusRemuxEnd,

  kNERtcLocalRecorderStatusComplete
} NERtcLocalRecorderStatus;

typedef enum {
  kNERtcLocalRecorderErrorNone = 0,

  kNERtcLocalRecorderFileOpenFailed,

  kNERtcLocalRecorderWriteFailed,

  kNERtcLocalRecorderWriteTrailerFailed,

  kNERtcLocalRecorderFailed,

  kNERtcLocalRecorderCallbackConflict,

  kNERtcLocalRecorderTaskAlreadyExist,

  kNERtcLocalRecorderTaskNotFound,

  kNERtcLocalRecorderSourceNotFoundForTask,

  kNERtcLocalRecorderInputOpenFailed,

  kNERtcLocalRecorderVideoStreamCreateFailed,

  kNERtcLocalRecorderAudioStreamCreateFailed,

  kNERtcLocalRecorderCoverImageParseFailed,

  kNERtcLocalRecorderPlaceholderImageParseFailed,

  kNERtcLocalRecorderAudioConfigInvalid,

  kNERtcLocalRecorderRemuxPrcocessRunning,

  kNERtcLocalRecorderOutputOpenFailed
} NERtcLocalRecorderError;

typedef enum {
  kNERtcLocalRecordingFileTypeMp4 = 0,

  kNERtcLocalRecordingFileTypeFlv = 1,
} NERtcLocalRecordingFileType;
 

typedef enum {
  kNERtcLocalRecorderAudioFormatAac = 0,
} NERtcLocalRecordingAudioFormat;
 

typedef enum {
  kNERtcLocalRecorderVideoWithAudio = 0,
  kNERtcLocalRecorderVideoWithoutAudio = 1,
} NERtcLocalRecordingVideoMode;

struct NERtcLocalRecordingConfig {
  char file_path[kNERtcMaxBuffLength];
  char file_name[kNERtcMaxBuffLength];
  int width = 0;
  int height = 0;
  int framerate = 15;
  NERtcLocalRecordingFileType record_file_type = kNERtcLocalRecordingFileTypeMp4;
  bool remux_to_mp4 = false;
  bool video_merge = false;
  bool record_audio = false;
  NERtcLocalRecordingAudioFormat audio_format = kNERtcLocalRecorderAudioFormatAac;
  bool record_video = true;
  NERtcLocalRecordingVideoMode video_record_mode = kNERtcLocalRecorderVideoWithAudio;
  NERtcVideoWatermarkConfig *watermark_list = nullptr;
  int watermark_count = 0;
  char cover_file_path[kNERtcMaxBuffLength];
  NERtcVideoWatermarkConfig* cover_watermark_list = nullptr;
  int cover_watermark_count = 0;
  char default_cover_file_path[kNERtcMaxBuffLength];
  NERtcLocalRecordingConfig() {
    memset(file_path, 0, kNERtcMaxBuffLength);
    memset(file_name, 0, kNERtcMaxBuffLength);
    memset(cover_file_path, 0, kNERtcMaxBuffLength);
    memset(default_cover_file_path, 0, kNERtcMaxBuffLength);
  };
};

struct NERtcLocalRecordingLayoutConfig
{
  int offset_x = 0;
  int offset_y = 0;
  int width = 0;
  int height = 0;
  NERtcVideoScalingMode scaling_mode = kNERtcVideoScaleFullFill;
  NERtcVideoWatermarkConfig* watermark_list = nullptr;
  int watermark_count = 0;
  bool is_screen_share = false;
  uint32_t bg_color = 0;
};

struct NERtcLocalRecordingStreamInfo {
  uid_t uid;
  NERtcVideoStreamType stream_type;
  int stream_layer;
  NERtcLocalRecordingLayoutConfig layout_config;
 
  NERtcLocalRecordingStreamInfo() : uid(0), stream_type(kNERTCVideoStreamMain), stream_layer(0) {}
};
 

typedef enum {
  kNERtcAsrCaptionStartFailed = 0,
  kNERtcAsrCaptionStateStopFailed = 1,
  kNERtcAsrCaptionStateStarted = 2,
  kNERtcAsrCaptionStateStopped = 3
} NERtcAsrCaptionState;

struct NERtcASRCaptionConfig {
  char src_language[kNERtcMaxTokenLength];
  char dst_language[kNERtcMaxTokenLength];
  char src_languages[kNERtcCommonMaxCount][kNERtcMaxTaskIDLength];
  int src_languages_count;
  char dst_languages[kNERtcCommonMaxCount][kNERtcMaxTaskIDLength];
  int dst_languages_count;
  
  bool need_translate_same_language;
  
  NERtcASRCaptionConfig() {
    memset(this, 0, sizeof(NERtcASRCaptionConfig));
  }
};

struct NERtcAsrCaptionResult {
  uint64_t user_id;
  bool is_local_user;
  uint64_t timestamp;
  const char* content;
  const char* language;
  bool have_translation;
  const char* translated_text;
  const char* translation_language;
  bool is_final;
  
  NERtcAsrCaptionResult() {
    memset(this, 0, sizeof(NERtcAsrCaptionResult));
  }
};

typedef enum {
  kNERtcPlayStreamStateIdle = 0,
  kNERtcPlayStreamStatePlaying = 1,
  kNERtcPlayStreamStatePaused = 2,
  kNERtcPlayStreamStateReconnecting = 3,
  kNERtcPlayStreamStateStopped = 4,
} NERtcPlayStreamState;

struct NERtcFrameNormalizedRect {
  float x;
  float y;
  float w;
  float h;
 
  NERtcFrameNormalizedRect() {
    memset(this, 0, sizeof(NERtcFrameNormalizedRect));
  }
 
  bool isValid() const {
    return x >= 0.0f && y >= 0.0f && w > 0.0f && h > 0.0f && (x + w) <= 1.0f && (y + h) <= 1.0f;
  }
};
 
/*
 * @if Chinese
 * 混合外部视频配置
 * @endif
 * @if English
 * Blend external video config
 * @endif
*/
struct NERtcVideoExternalBlendConfig {
  float x = 0.0f;
  float y = 0.0f;
  float w = 0.0f;
  float h = 0.0f;
  bool mirror = false;

  NERtcVideoScalingMode scaling_mode = kNERtcVideoScaleFit;
  uint32_t bg_color = 0;

  bool overlay = false;
 
  NERtcVideoExternalBlendConfig() {
    memset(this, 0, sizeof(NERtcVideoExternalBlendConfig));
  }
};
 
struct NERtcVoiceprintInfo {
  char device_id[kNERtcMaxDeviceIDLength];
  char* voiceprint;
  int size;
  
  NERtcVoiceprintInfo() {
    memset(this, 0, sizeof(NERtcVoiceprintInfo));
  }
};

#define kNERtcKeyRecordHostEnabled "record_host_enabled"
#define kNERtcKeyRecordAudioEnabled "record_audio_enabled"
#define kNERtcKeyRecordVideoEnabled "record_video_enabled"
#define kNERtcKeyRecordType "record_type"
#define kNERtcKeyAutoSubscribeAudio "auto_subscribe_audio"
#define kNERtcKeyPublishSelfStreamEnabled "publish_self_stream_enabled"
#define kNERtcKeyLogLevel "log_level"
#define kNERtcKeyAudioProcessingAECEnable "audio_processing_aec_enable"
#define kNERtcKeyAudioAECLowLevelEnable "audio_aec_low_level_enable"
#define kNERtcKeyAudioProcessingAGCEnable "audio_processing_agc_enable"
#define kNERtcKeyAudioProcessingNSEnable "audio_processing_ns_enable"
#define kNERtcKeyAudioProcessingAINSEnable "audio_processing_ai_ns_enable"
#define kNERtcKeyAudioProcessingExternalAudioMixEnable "audio_processing_external_audiomix_enable"
#define kNERtcKeyAudioProcessingEarphone "audio_processing_earphone"
#define kNERtcKeyVideoSendOnPubType "video_sendonpub_type"
#define kNERtcKeyChannel1V1ModeEnabled "channel_1v1_mode_enabled"
#define kNERtcKeyExtraInfo "extra_info"
#define kNERtcKeyAudioDeviceAutoSelectType "audio_device_auto_select_type"
#define kNERtcKeyEnableReportVolumeWhenMute "enable_report_volume_when_mute"

#define kNERtcKeyDisableFirstUserCreateChannel "disable_first_user_create_channel"

#define kNERtcKeyAutoSubscribeVideo "auto_subscribe_video"

#define kNERtcKeyAutoSubscribeData "auto_subscribe_data"
#define kNERtcKeyEnableVideoCaptureObserver "video_frame_capture"

#define kNERtcKeyDisableVideoDecoder "disable_video_decoder"

#define kNERtcKeyVideoRenderType "sdk.prefer.video.render"
 
} // namespace nertc
 
#endif