nertc 命名空间参考

namespace nertc 更多...

类
class	IAudioDeviceManager
class	IDeviceCollection
struct	NERtcEngineContext
class	IRtcEngine
struct	NERtcLiveStreamTaskOption
struct	NERtcLiveStreamUserTranscoding
struct	NERtcLiveStreamImageInfo
struct	NERtcLiveStreamLayout
struct	NERtcLiveConfig
struct	NERtcLiveStreamTaskInfo
struct	NERtcCameraCaptureConfig
struct	NERtcDeviceInfo
struct	NERtcAudioVolumeInfo
struct	NERtcStats
struct	NERtcVideoLayerSendStats
struct	NERtcVideoSendStats
struct	NERtcVideoLayerRecvStats
struct	NERtcVideoRecvStats
struct	NERtcAudioLayerSendStats
struct	NERtcAudioSendStats
struct	NERtcAudioLayerRecvStats
struct	NERtcAudioRecvStats
struct	NERtcNetworkQualityInfo
struct	NERtcVideoConfig
struct	NERtcRectangle
struct	NERtcVideoDimensions
struct	NERtcScreenCaptureParameters
struct	NERtcVideoCanvas
struct	NERtcAudioFrameRequestFormat
struct	NERtcAudioFormat
struct	NERtcAudioFrame
class	INERtcAudioFrameObserver
struct	NERtcVideoFrame
struct	NERtcCreateAudioMixingOption
struct	NERtcCreateAudioEffectOption
struct	NERtcTextWatermarkConfig
struct	NERtcTimestampWatermarkConfig
struct	NERtcChannelMediaRelayInfo
struct	NERtcChannelMediaRelayConfiguration
struct	NERtcImageWatermarkConfig
struct	NERtcCanvasWatermarkConfig
class	NERtcTakeSnapshotCallback
struct	NERtcServerAddresses
struct	NERtcEncryptionConfig
struct	NERtcLastmileProbeConfig
struct	NERtcLastmileProbeOneWayResult
struct	NERtcLastmileProbeResult
class	IRtcEngineEventHandler
class	IRtcEngineEventHandlerEx
class	IRtcEngineEx
class	IRtcMediaStatsObserver
class	IVideoDeviceManager

类型定义
typedef uint64_t	uid_t
typedef uint64_t	channel_id_t
typedef void *	source_id_t
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)

枚举
enum	NERtcInterfaceIdType { kNERtcIIDAudioDeviceManager = 1 , kNERtcIIDVideoDeviceManager = 2 }
enum	NERtcClientRole { kNERtcClientRoleBroadcaster = 0 , kNERtcClientRoleAudience = 1 }
enum	NERtcChannelProfileType { kNERtcChannelProfileCommunication = 0 , kNERtcChannelProfileLiveBroadcasting = 1 }
enum	NERtcMediaPriorityType { kNERtcMediaPriorityHigh = 50 , kNERtcMediaPriorityNormal = 100 }
enum	NERtcLiveStreamLayoutMode {   kNERtcLayoutFloatingRightVertical = 0 , kNERtcLayoutFloatingLeftVertical , kNERtcLayoutSplitScreen , kNERtcLayoutSplitScreenScaling ,   kNERtcLayoutCustom , kNERtcLayoutAudioOnly }
enum	NERtcLiveStreamMode { kNERtcLsModeVideo = 0 , kNERtcLsModeAudio = 1 }
enum	NERtcLiveStreamVideoScaleMode { kNERtcLsModeVideoScaleFit = 0 , kNERtcLsModeVideoScaleCropFill = 1 }
enum	NERtcLiveStreamAudioSampleRate { kNERtcLiveStreamAudioSampleRate32000 = 32000 , kNERtcLiveStreamAudioSampleRate44100 = 44100 , kNERtcLiveStreamAudioSampleRate48000 = 48000 }
enum	NERtcLiveStreamAudioCodecProfile { kNERtcLiveStreamAudioCodecProfileLCAAC = 0 , kNERtcLiveStreamAudioCodecProfileHEAAC = 1 }
enum	NERtcLiveStreamStateCode { kNERtcLsStatePushing = 505 , kNERtcLsStatePushFail = 506 , kNERtcLsStatePushStopped = 511 , kNERtcLsStateImageError = 512 }
enum	NERtcOSCategory { kNERtcOSiOS = 1 , kNERtcOSAndroid = 2 , kNERtcOSPC = 3 , kNERtcOSWebRTC = 4 }
enum	NERtcAudioProfileType {   kNERtcAudioProfileDefault = 0 , kNERtcAudioProfileStandard = 1 , kNERtcAudioProfileStandardExtend = 2 , kNERtcAudioProfileMiddleQuality = 3 ,   kNERtcAudioProfileMiddleQualityStereo = 4 , kNERtcAudioProfileHighQuality = 5 , kNERtcAudioProfileHighQualityStereo = 6 }
enum	NERtcAudioScenarioType { kNERtcAudioScenarioDefault = 0 , kNERtcAudioScenarioSpeech = 1 , kNERtcAudioScenarioMusic = 2 }
enum	NERtcVoiceChangerType {   kNERtcVoiceChangerOff = 0 , kNERtcVoiceChangerRobot = 1 , kNERtcVoiceChangerGaint = 2 , kNERtcVoiceChangerHorror = 3 ,   kNERtcVoiceChangerMature = 4 , kNERtcVoiceChangerManToWoman = 5 , kNERtcVoiceChangerWomanToMan = 6 , kNERtcVoiceChangerManToLoli = 7 ,   kNERtcVoiceChangerWomanToLoli = 8 }
enum	NERtcVoiceBeautifierType {   kNERtcVoiceBeautifierOff = 0 , kNERtcVoiceBeautifierMuffled = 1 , kNERtcVoiceBeautifierMellow = 2 , kNERtcVoiceBeautifierClear = 3 ,   kNERtcVoiceBeautifierMagnetic = 4 , kNERtcVoiceBeautifierRecordingstudio = 5 , kNERtcVoiceBeautifierNature = 6 , kNERtcVoiceBeautifierKTV = 7 ,   kNERtcVoiceBeautifierRemote = 8 , kNERtcVoiceBeautifierChurch = 9 , kNERtcVoiceBeautifierBedroom = 10 , kNERtcVoiceBeautifierLive = 11 }
enum	NERtcVoiceEqualizationBand {   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 }
enum	NERtcCameraPreference { kNERtcCameraOutputDefault = 0 , kNERtcCameraOutputQuality = 1 , kNERtcCameraOutputManual = 2 }
enum	NERtcVideoProfileType {   kNERtcVideoProfileLowest = 0 , kNERtcVideoProfileLow = 1 , kNERtcVideoProfileStandard = 2 , kNERtcVideoProfileHD720P = 3 ,   kNERtcVideoProfileHD1080P = 4 , kNERtcVideoProfileNone = 5 , kNERtcVideoProfileMAX = kNERtcVideoProfileHD1080P , kNERtcVideoProfileFake = 6 }
enum	NERtcRemoteVideoStreamType { kNERtcRemoteVideoStreamTypeHigh = 0 , kNERtcRemoteVideoStreamTypeLow = 1 , kNERtcRemoteVideoStreamTypeNone = 2 }
enum	NERtcAudioDeviceType { kNERtcAudioDeviceUnknown = 0 , kNERtcAudioDeviceRecord , kNERtcAudioDevicePlayout }
enum	NERtcAudioDeviceState { kNERtcAudioDeviceActive = 0 , kNERtcAudioDeviceUnactive }
enum	NERtcAudioDeviceTransportType {   kNERtcAudioDeviceTransportTypeUnknown = 0 , kNERtcAudioDeviceTransportTypeBluetooth = 1 , kNERtcAudioDeviceTransportTypeBluetoothA2DP = 2 , kNERtcAudioDeviceTransportTypeBluetoothLE = 3 ,   kNERtcAudioDeviceTransportTypeUSB = 4 , kNERtcAudioDeviceTransportTypeHDMI = 5 , kNERtcAudioDeviceTransportTypeBuiltIn = 6 , kNERtcAudioDeviceTransportTypeThunderbolt = 7 ,   kNERtcAudioDeviceTransportTypeAirPlay = 8 , kNERtcAudioDeviceTransportTypeVirtual = 9 , kNERtcAudioDeviceTransportTypeOther = 10 }
enum	NERtcVideoDeviceTransportType { kNERtcVideoDeviceTransportTypeUnknown = 0 , kNERtcVideoDeviceTransportTypeUSB = 1 , kNERtcVideoDeviceTransportTypeVirtual = 2 , kNERtcVideoDeviceTransportTypeOther = 3 }
enum	NERtcVideoDeviceType { kNERtcVideoDeviceUnknown = 0 , kNERtcVideoDeviceCapture }
enum	NERtcVideoDeviceState { kNERtcVideoDeviceAdded = 0 , kNERtcVideoDeviceRemoved }
enum	NERtcVideoScalingMode { kNERtcVideoScaleFit = 0 , kNERtcVideoScaleFullFill = 1 , kNERtcVideoScaleCropFill = 2 }
enum	NERtcVideoMirrorMode { kNERtcVideoMirrorModeAuto = 0 , kNERtcVideoMirrorModeEnabled = 1 , kNERtcVideoMirrorModeDisabled = 2 }
enum	NERtcVideoOutputOrientationMode { kNERtcVideoOutputOrientationModeAdaptative = 0 , kNERtcVideoOutputOrientationModeFixedLandscape = 1 , kNERtcVideoOutputOrientationModeFixedPortrait = 2 }
enum	NERtcConnectionStateType {   kNERtcConnectionStateDisconnected = 1 , kNERtcConnectionStateConnecting = 2 , kNERtcConnectionStateConnected = 3 , kNERtcConnectionStateReconnecting = 4 ,   kNERtcConnectionStateFailed = 5 }
enum	NERtcReasonConnectionChangedType {   kNERtcReasonConnectionChangedLeaveChannel = 1 , kNERtcReasonConnectionChangedChannelClosed = 2 , kNERtcReasonConnectionChangedBeKicked = 3 , kNERtcReasonConnectionChangedTimeOut = 4 ,   kNERtcReasonConnectionChangedJoinChannel = 5 , kNERtcReasonConnectionChangedJoinSucceed = 6 , kNERtcReasonConnectionChangedReJoinSucceed = 7 , kNERtcReasonConnectionChangedMediaConnectionDisconnected = 8 ,   kNERtcReasonConnectionChangedSignalDisconnected = 9 , kNERtcReasonConnectionChangedRequestChannelFailed = 10 , kNERtcReasonConnectionChangedJoinChannelFailed = 11 , kNERtcReasonConnectionChangedReDispatch = 12 }
enum	NERtcAudioStreamType { kNERtcAudioStreamTypeMain = 0 , kNERtcAudioStreamTypeSub = 1 }
enum	NERtcNetworkQualityType {   kNERtcNetworkQualityUnknown = 0 , kNERtcNetworkQualityExcellent = 1 , kNERtcNetworkQualityGood = 2 , kNERtcNetworkQualityPoor = 3 ,   kNERtcNetworkQualityBad = 4 , kNERtcNetworkQualityVeryBad = 5 , kNERtcNetworkQualityDown = 6 }
enum	NERtcVideoCropMode { kNERtcVideoCropModeDefault = 0 , kNERtcVideoCropMode16x9 = 1 , kNERtcVideoCropMode4x3 = 2 , kNERtcVideoCropMode1x1 = 3 }
enum	NERtcVideoFramerateType {   kNERtcVideoFramerateFpsDefault = 0 , kNERtcVideoFramerateFps_7 = 7 , kNERtcVideoFramerateFps_10 = 10 , kNERtcVideoFramerateFps_15 = 15 ,   kNERtcVideoFramerateFps_24 = 24 , kNERtcVideoFramerateFps_30 = 30 , kNERtcVideoFramerateFps_60 = 60 }
enum	NERtcDegradationPreference { kNERtcDegradationDefault = 0 , kNERtcDegradationMaintainFramerate = 1 , kNERtcDegradationMaintainQuality = 2 , kNERtcDegradationBalanced = 3 }
enum	NERtcScreenProfileType {   kNERtcScreenProfile480P = 0 , kNERtcScreenProfileHD720P = 1 , kNERtcScreenProfileHD1080P = 2 , kNERtcScreenProfileCustom = 3 ,   kNERtcScreenProfileNone = 4 , kNERtcScreenProfileMAX = kNERtcScreenProfileHD1080P }
enum	NERtcScreenCaptureStatus {   kScreenCaptureStatusStart = 1 , kScreenCaptureStatusPause = 2 , kScreenCaptureStatusResume = 3 , kScreenCaptureStatusStop = 4 ,   kScreenCaptureStatusCovered = 5 }
enum	NERtcSubStreamContentPrefer { kNERtcSubStreamContentPreferMotion = 0 , kNERtcSubStreamContentPreferDetails = 1 }
enum	NERtcRecordType { kNERtcRecordTypeAll = 0 , kNERtcRecordTypeMix = 1 , kNERtcRecordTypeSingle = 2 }
enum	NERtcAudioType { kNERtcAudioTypePCM16 = 0 }
enum	NERtcRawAudioFrameOpModeType { kNERtcRawAudioFrameOpModeReadOnly = 0 , kNERtcRawAudioFrameOpModeReadWrite }
enum	NERtcVideoType {   kNERtcVideoTypeI420 = 0 , kNERtcVideoTypeNV12 = 1 , kNERtcVideoTypeNV21 = 2 , kNERtcVideoTypeBGRA = 3 ,   kNERtcVideoTypeCVPixelBuffer = 4 }
enum	NERtcVideoRotation { kNERtcVideoRotation_0 = 0 , kNERtcVideoRotation_90 = 90 , kNERtcVideoRotation_180 = 180 , kNERtcVideoRotation_270 = 270 }
enum	NERtcSessionLeaveReason {   kNERtcSessionLeaveNormal = 0 , kNERtcSessionLeaveForFailOver = 1 , kNERtcSessionLeaveUpdate = 2 , kNERtcSessionLeaveForKick = 3 ,   kNERtcSessionLeaveTimeOut = 4 }
enum	NERtcAudioMixingState { kNERtcAudioMixingStateFinished = 0 , kNERtcAudioMixingStateFailed = 1 }
enum	NERtcVideoStreamType { kNERTCVideoStreamMain = 0 , kNERTCVideoStreamSub = 1 , kNERTCVideoStreamCount }
enum	NERtcChannelMediaRelayState { kNERtcChannelMediaRelayStateIdle = 0 , kNERtcChannelMediaRelayStateConnecting = 1 , kNERtcChannelMediaRelayStateRunning = 2 , kNERtcChannelMediaRelayStateFailure = 3 }
enum	NERtcChannelMediaRelayEvent {   kNERtcChannelMediaRelayEventDisconnect = 0 , kNERtcChannelMediaRelayEventConnecting = 1 , kNERtcChannelMediaRelayEventConnected = 2 , kNERtcChannelMediaRelayEventVideoSentToDestChannelSuccess = 3 ,   kNERtcChannelMediaRelayEventAudioSentToDestChannelSuccess = 4 , kNERtcChannelMediaRelayEventOtherStreamSentToDestChannelSuccess = 5 , kNERtcChannelMediaRelayEventFailure = 100 }
enum	NERtcLogLevel {   kNERtcLogLevelFatal = 0 , kNERtcLogLevelError = 1 , kNERtcLogLevelWarning = 2 , kNERtcLogLevelInfo = 3 ,   kNERtcLogLevelDetailInfo = 4 , kNERtcLogLevelVerbos = 5 , kNERtcLogLevelDebug = 6 , kNERtcLogLevelOff = 7 }
enum	NERtcSendOnPubType { kNERtcSendOnPubNone = 0 , kNERtcSendOnPubHigh = 1 , kNERtcSendOnPubLow = 1 << 1 , kNERtcSendOnPubAll = kNERtcSendOnPubLow | kNERtcSendOnPubHigh }
enum	NERtcAudioRecordingQuality { kNERtcAudioRecordingQualityLow = 0 , kNERtcAudioRecordingQualityMedium = 1 , kNERtcAudioRecordingQualityHigh = 2 }
enum	NERtcAudioRecordingCode {   kNERtcAudioRecordErrorSuffix = 1 , kNERtcAudioRecordOpenFileFailed = 2 , kNERtcAudioRecordStart = 3 , kNERtcAudioRecordError = 4 ,   kNERtcAudioRecordFinish = 5 }
enum	NERtcStreamFallbackOption { kNERtcStreamFallbackDisabled = 0 , kNERtcStreamFallbackVideoStreamLow = 1 , kNERtcStreamFallbackAudioOnly = 2 }
enum	NERtcEncryptionMode { kNERtcGMCryptoSM4ECB = 0 }
enum	NERtcLastmileProbeResultState { kNERtcLastmileProbeResultComplete = 1 , kNERtcLastmileProbeResultIncompleteNoBwe = 2 , kNERtcLastmileProbeResultUnavailable = 3 }
enum	NERtcErrorCode {   kNERtcNoError = 0 , kNERtcErrChannelReservePermissionDenied = 403 , kNERtcErrChannelReserveTimeOut = 408 , kNERtcErrChannelReserveErrorParam = 414 ,   kNERtcErrChannelReserveServerFail = 500 , kNERtcErrChannelReserveMoreThanTwoUser = 600 , kNERtcErrLsTaskRequestInvalid = 1301 , kNERtcErrLsTaskIsInvaild = 1400 ,   kNERtcErrLsTaskRoomExited = 1401 , kNERtcErrLsTaskNumLimit = 1402 , kNERtcErrLsTaskDuplicateId = 1403 , kNERtcErrLsTaskNotFound = 1404 ,   kNERtcErrLsTaskRequestErr = 1417 , kNERtcErrLsTaskInternalServerErr = 1500 , kNERtcErrLsTaskInvalidLayout = 1501 , kNERtcErrLsTaskUserPicErr = 1512 ,   kNERtcErrChannelStartFail = 11000 , kNERtcErrChannelDisconnected = 11001 , kNERtcErrVersionSelfLow = 11002 , kNERtcErrVersionRemoteLow = 11003 ,   kNERtcErrChannelClosed = 11004 , kNERtcErrChannelKicked = 11005 , kNERtcErrDataError = 11400 , kNERtcErrInvalid = 11403 ,   kNERtcErrChannelJoinTimeOut = 20101 , kNERtcErrChannelJoinMeetingModeError = 20102 , kNERtcErrChannelJoinRtmpModeError = 20103 , kNERtcErrChannelJoinRtmpNodesError = 20104 ,   kNERtcErrChannelJoinRtmpHostError = 20105 , kNERtcErrChannelJoinRtmpCreateError = 20106 , kNERtcErrChannelJoinLayoutError = 20208 , kNERtcErrChannelJoinInvalidParam = 20400 ,   kNERtcErrChannelJoinDesKey = 20401 , kNERtcErrChannelJoinInvalidRequst = 20417 , kNERtcErrChannelServerUnknown = 20500 , kNERtcErrFatal = 30001 ,   kNERtcErrOutOfMemory = 30002 , kNERtcErrInvalidParam = 30003 , kNERtcErrNotSupported = 30004 , kNERtcErrInvalidState = 30005 ,   kNERtcErrLackOfResource = 30006 , kNERtcErrInvalidIndex = 30007 , kNERtcErrDeviceNotFound = 30008 , kNERtcErrInvalidDeviceSourceID = 30009 ,   kNERtcErrInvalidVideoProfile = 30010 , kNERtcErrCreateDeviceSourceFail = 30011 , kNERtcErrInvalidRender = 30012 , kNERtcErrDevicePreviewAlreadyStarted = 30013 ,   kNERtcErrTransmitPendding = 30014 , kNERtcErrConnectFail = 30015 , kNERtcErrCreateDumpFileFail = 30016 , kNERtcErrStartDumpFail = 30017 ,   kNERtcErrDesktopCaptureInvalidState = 30020 , kNERtcErrDesktopCaptureInvalidParam = 30021 , kNERtcErrDesktopCaptureNotReady = 30022 , kNERtcErrChannelAlreadyJoined = 30100 ,   kNERtcErrChannelNotJoined = 30101 , kNERtcErrChannelRepleatedlyLeave = 30102 , kNERtcErrRequestJoinChannelFail = 30103 , kNERtcErrSessionNotFound = 30104 ,   kNERtcErrUserNotFound = 30105 , kNERtcErrInvalidUserID = 30106 , kNERtcErrMediaNotStarted = 30107 , kNERtcErrSourceNotFound = 30108 ,   kNERtcErrSwitchChannelInvalidState = 30109 , kNERtcErrChannelMediaRelayInvalidState = 30110 , kNERtcErrChannelMediaRelayPermissionDenied = 30111 , kNERtcErrChannelMediaRelayStopFailed = 30112 ,   kNERtcErrEncryptNotSuitable = 30113 , kNERtcErrConnectionNotFound = 30200 , kNERtcErrStreamNotFound = 30201 , kNERtcErrAddTrackFail = 30202 ,   kNERtcErrTrackNotFound = 30203 , kNERtcErrMediaConnectionDisconnected = 30204 , kNERtcErrSignalDisconnected = 30205 , kNERtcErrServerKicked = 30206 ,   kNERtcErrKickedForRoomClosed = 30207 , kNERtcErrChannelLeaveBySwitchAction = 30208 , kNERtcRuntimeErrADMNoAuthorize = 40000 , kNERtcRuntimeErrVDMNoAuthorize = 50000 ,   kNERtcRuntimeErrScreenCaptureNoAuthorize = 60000 }
enum	NERtcRoomServerErrorCode {   kNERtcRoomServerErrOK = 200 , kNERtcRoomServerErrAuthError = 401 , kNERtcRoomServerErrChannelNotExist = 404 , kNERtcRoomServerErrUidNotExist = 405 ,   kNERtcRoomServerErrDataError = 417 , kNERtcRoomServerErrUnknown = 500 , kNERtcRoomServerErrServerError = 600 , kNERtcRoomServerErrInvilid = 11403 }
enum	NERtcAudioMixingErrorCode {   kNERtcAudioMixingErrorOK = 0 , kNERtcAudioMixingErrorFatal = 1 , kNERtcAudioMixingErrorCanNotOpen , kNERtcAudioMixingErrorDecode ,   kNERtcAudioMixingErrorInterrupt , kNERtcAudioMixingErrorHttpNotFound , kNERtcAudioMixingErrorOpen , kNERtcAudioMixingErrorNInfo ,   kNERtcAudioMixingErrorNStream , kNERtcAudioMixingErrorNCodec , kNERtcAudioMixingErrorNMem , kNERtcAudioMixingErrorCodecOpen ,   kNERtcAudioMixingErrorInvalidInfo , kNERtcAudioMixingErrorOpenTimeout , kNERtcAudioMixingErrorIoTimeout , kNERtcAudioMixingErrorIo }
enum	NERtcDMErrorCode {   kNERtcRuntimeErrADMInitRecording = 40001 , kNERtcRuntimeErrADMStartRecording = 40002 , kNERtcRuntimeErrADMStopRecording = 40003 , kNERtcRuntimeErrADMInitPlayout = 40004 ,   kNERtcRuntimeErrADMStartPlayout = 40005 , kNERtcRuntimeErrADMStopPlayout = 40006 , kNERtcErrVDMCameraNoFrame = 1502 , kNERtcErrVDMCameraCreateFail = 1503 }
enum	NERtcWarnCode {   kNERtcWarnInvalidView = 100 , kNERtcWarnInitVideo = 101 , kNERtcWarnPending = 102 , kNERtcWarningChannelAbilityNotMatch = 406 ,   kNERtcWarnADMRuntimePlayoutWarning = 1001 , kNERtcWarnADMRuntimeRecordingWarning = 1002 , kNERtcWarnADMRecordAudioSilence = 1003 , kNERtcWarnADMPlayoutMalfunction = 1004 ,   kNERtcWarnADMRecordMalfunction = 1005 , kNERtcWarnADMRecordAudioLowLevel = 1006 , kNERtcWarnADMPlayoutAudioLowLevel = 1007 , kNERtcWarnAPMHowling = 1008 ,   kNERtcWarnADMGlitchState = 1009 , kNERtcWarnADMImproperSettings = 1010 , kNERtcWarnADMWinCoreNoDataReadyEvent = 2000 , kNERtcWarnADMWinCoreNoRecordingDevice = 2001 ,   kNERtcWarnADMWinCoreNoPlayoutDevice = 2002 , kNERtcWarnADMWinCoreImproperCaptureRelease = 2003 }

详细描述

namespace nertc

类型定义说明

channel_id_t

typedef uint64_t nertc::channel_id_t

64位无符号整数。建议设置范围：1到 2⁶³-1，并保证唯一性。

onFrameDataCallback

typedef void(* nertc::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)

视频帧数据回调

参数

uid	用户id
data	数据指针
type	数据类型NERtcVideoType
width	宽度
height	高度
count	数据类型个数，即offset及stride的数目
offset	每类数据偏移
stride	每类数据步进
rotation	画面旋转角度NERtcVideoRotation
user_data	用户透传数据

source_id_t

typedef void* nertc::source_id_t

用于标识屏幕捕捉的源，代表某个窗口或屏幕。源为窗口时, Windows上该类型会转换为HWND, MAC上转换为整形。源为屏幕时会转换为整形。

uid_t

typedef uint64_t nertc::uid_t

64位无符号整数。建议设置范围：1到 2⁶³-1，并保证唯一性。

枚举类型说明

NERtcAudioDeviceState

enum nertc::NERtcAudioDeviceState

音频设备类型状态。

枚举值
kNERtcAudioDeviceActive	音频设备已激活
kNERtcAudioDeviceUnactive	音频设备未激活

NERtcAudioDeviceTransportType

enum nertc::NERtcAudioDeviceTransportType

音频设备连接类型。

枚举值
kNERtcAudioDeviceTransportTypeUnknown	未知设备
kNERtcAudioDeviceTransportTypeBluetooth	蓝牙设备
kNERtcAudioDeviceTransportTypeBluetoothA2DP	蓝牙立体声设备
kNERtcAudioDeviceTransportTypeBluetoothLE	蓝牙低功耗设备
kNERtcAudioDeviceTransportTypeUSB	USB设备
kNERtcAudioDeviceTransportTypeHDMI	HDMI设备
kNERtcAudioDeviceTransportTypeBuiltIn	内置设备
kNERtcAudioDeviceTransportTypeThunderbolt	雷电接口设备
kNERtcAudioDeviceTransportTypeAirPlay	AirPlay设备
kNERtcAudioDeviceTransportTypeVirtual	虚拟设备
kNERtcAudioDeviceTransportTypeOther	其他设备

NERtcAudioDeviceType

enum nertc::NERtcAudioDeviceType

音频设备类型。

枚举值
kNERtcAudioDeviceUnknown	未知音频设备
kNERtcAudioDeviceRecord	音频采集设备
kNERtcAudioDevicePlayout	音频播放设备

NERtcAudioMixingErrorCode

enum nertc::NERtcAudioMixingErrorCode

indicates error codes of audio mixing music files.

枚举值
kNERtcAudioMixingErrorOK	No error.
kNERtcAudioMixingErrorFatal	Common error.
kNERtcAudioMixingErrorCanNotOpen	Audio mixing is not enabled normally.
kNERtcAudioMixingErrorDecode	Audio decoding error.
kNERtcAudioMixingErrorInterrupt	Interruption codes in the operation.
kNERtcAudioMixingErrorHttpNotFound	404 file not found，only for http / https.
kNERtcAudioMixingErrorOpen	Fails to enable streams/files.
kNERtcAudioMixingErrorNInfo	Decoding information failures or timeouts.
kNERtcAudioMixingErrorNStream	No audio streams.
kNERtcAudioMixingErrorNCodec	No decoder.
kNERtcAudioMixingErrorNMem	No memory.
kNERtcAudioMixingErrorCodecOpen	Failures or timeouts of enabling decoders.
kNERtcAudioMixingErrorInvalidInfo	Invalid audio parameters such as channels and sample rate.
kNERtcAudioMixingErrorOpenTimeout	Streams/files enabling timeouts.
kNERtcAudioMixingErrorIoTimeout	Network io timeouts.
kNERtcAudioMixingErrorIo	Network io errors.

NERtcAudioMixingState

enum nertc::NERtcAudioMixingState

音乐文件播放状态。

枚举值
kNERtcAudioMixingStateFinished	音乐文件播放结束。
kNERtcAudioMixingStateFailed	音乐文件报错。详见: NERtcAudioMixingErrorCode

NERtcAudioProfileType

enum nertc::NERtcAudioProfileType

音频属性。设置采样率，码率，编码模式和声道数。

枚举值
kNERtcAudioProfileDefault	0: 默认设置。Speech 场景下为 kNERtcAudioProfileStandardExtend，Music 场景下为 kNERtcAudioProfileHighQuality。
kNERtcAudioProfileStandard	1: 普通质量的音频编码，16000Hz，20Kbps
kNERtcAudioProfileStandardExtend	2: 普通质量的音频编码，16000Hz，32Kbps
kNERtcAudioProfileMiddleQuality	3: 中等质量的音频编码，48000Hz，32Kbps
kNERtcAudioProfileMiddleQualityStereo	4: 中等质量的立体声编码，48000Hz * 2，64Kbps
kNERtcAudioProfileHighQuality	5: 高质量的音频编码，48000Hz，64Kbps
kNERtcAudioProfileHighQualityStereo	6: 高质量的立体声编码，48000Hz * 2，128Kbps

NERtcAudioRecordingCode

enum nertc::NERtcAudioRecordingCode

录音回调事件错误码

枚举值
kNERtcAudioRecordErrorSuffix	不支持的录音文件格式。
kNERtcAudioRecordOpenFileFailed	无法创建录音文件，原因通常包括： 应用没有磁盘写入权限。 文件路径不存在。
kNERtcAudioRecordStart	开始录制。
kNERtcAudioRecordError	录制错误。原因通常为磁盘空间已满，无法写入。
kNERtcAudioRecordFinish	完成录制。

NERtcAudioRecordingQuality

enum nertc::NERtcAudioRecordingQuality

录音音质

枚举值
kNERtcAudioRecordingQualityLow	低音质
kNERtcAudioRecordingQualityMedium	中音质
kNERtcAudioRecordingQualityHigh	高音质

NERtcAudioScenarioType

enum nertc::NERtcAudioScenarioType

音频应用场景。不同的场景设置对应不同的音频采集模式、播放模式。

枚举值
kNERtcAudioScenarioDefault	0: 默认设置 kNERtcChannelProfileCommunication下为kNERtcAudioScenarioSpeech， kNERtcChannelProfileLiveBroadcasting下为kNERtcAudioScenarioMusic。
kNERtcAudioScenarioSpeech	1: 语音场景. NERtcAudioProfileType 推荐使用 kNERtcAudioProfileMiddleQuality 及以下
kNERtcAudioScenarioMusic	2: 音乐场景。NERtcAudioProfileType 推荐使用 kNERtcAudioProfileMiddleQualityStereo 及以上

NERtcAudioStreamType

enum nertc::NERtcAudioStreamType

音频流类型

枚举值
kNERtcAudioStreamTypeMain	主流
kNERtcAudioStreamTypeSub	辅流

NERtcAudioType

enum nertc::NERtcAudioType

音频类型。

枚举值
kNERtcAudioTypePCM16	PCM 音频格式。

NERtcCameraPreference

enum nertc::NERtcCameraPreference

设置摄像头的采集偏好。

枚举值
kNERtcCameraOutputDefault	（默认）优先保证设备性能。SDK 根据设备性能，参考用户在 setVideoConfig 中设置编码器的分辨率和帧率，选择最接近的摄像头输出参数。在这种情况下，预览质量接近于编码器的输出质量。
kNERtcCameraOutputQuality	优先保证视频预览质量。SDK 自动设置画质较高的摄像头输出参数，提高预览画面质量。此时会消耗更多的 CPU 及内存做视频前处理。
kNERtcCameraOutputManual	采用用户自定义设置的摄像头输出参数。此时用户可以通过 NERtcCameraCaptureConfig 中的 captureWidth 和 captureHeight 设置本地摄像头采集的视频宽高。

NERtcChannelMediaRelayEvent

enum nertc::NERtcChannelMediaRelayEvent

媒体流转发回调事件。

枚举值
kNERtcChannelMediaRelayEventDisconnect	媒体流转发停止。
kNERtcChannelMediaRelayEventConnecting	SDK 正在连接服务器，开始尝试转发媒体流。
kNERtcChannelMediaRelayEventConnected	连接服务器成功。
kNERtcChannelMediaRelayEventVideoSentToDestChannelSuccess	视频音频媒体流成功转发到目标房间。
kNERtcChannelMediaRelayEventAudioSentToDestChannelSuccess	音频媒体流成功转发到目标房间。
kNERtcChannelMediaRelayEventOtherStreamSentToDestChannelSuccess	媒体流屏幕共享等其他流成功转发到目标房间。
kNERtcChannelMediaRelayEventFailure	媒体流转发失败。原因包括： kNERtcErrChannelReserveErrorParam(414)：请求参数错误。 kNERtcErrChannelMediaRelayInvalidState(30110)：重复调用 startChannelMediaRelay。 kNERtcErrChannelMediaRelayPermissionDenied(30111)：媒体流转发权限不足。例如调用 startChannelMediaRelay 的房间成员为主播角色、或房间为双人通话房间，不支持转发媒体流。 kNERtcErrChannelMediaRelayStopFailed(30112)：调用 stopChannelMediaRelay 前，未调用 startChannelMediaRelay。

NERtcChannelMediaRelayState

enum nertc::NERtcChannelMediaRelayState

媒体流转发状态

枚举值
kNERtcChannelMediaRelayStateIdle	初始状态。在成功调用 stopChannelMediaRelay 停止跨房间媒体流转发后， onMediaRelayStateChanged 会回调该状态。
kNERtcChannelMediaRelayStateConnecting	SDK 尝试跨房间转发媒体流。
kNERtcChannelMediaRelayStateRunning	源房间主播角色成功加入目标房间。
kNERtcChannelMediaRelayStateFailure	发生异常，详见 onMediaRelayEvent 的 error 中提示的错误信息。

NERtcChannelProfileType

enum nertc::NERtcChannelProfileType

场景模式。

枚举值
kNERtcChannelProfileCommunication	通话场景
kNERtcChannelProfileLiveBroadcasting	直播推流场景

NERtcClientRole

enum nertc::NERtcClientRole

参会者角色类型

枚举值
kNERtcClientRoleBroadcaster	（默认）直播模式中的主播，可以操作摄像头等音视频设备、发布流、配置互动直播推流任务、上下线对房间内其他用户可见。
kNERtcClientRoleAudience	直播模式中的观众，观众只能接收音视频流，不支持操作音视频设备、配置互动直播推流任务、上下线不通知其他用户。

NERtcConnectionStateType

enum nertc::NERtcConnectionStateType

连接状态

枚举值
kNERtcConnectionStateDisconnected	未加入房间。
kNERtcConnectionStateConnecting	正在加入房间。
kNERtcConnectionStateConnected	加入房间成功。
kNERtcConnectionStateReconnecting	正在尝试重新加入房间。
kNERtcConnectionStateFailed	加入房间失败。

NERtcDegradationPreference

enum nertc::NERtcDegradationPreference

NERtcDegradationPreference 视频编码策略。

枚举值
kNERtcDegradationDefault	（默认）根据场景模式调整适应性偏好。 通信场景中，选择kNERtcDegradationBalanced 模式，在编码帧率和视频质量之间保持平衡。 直播场景中，选择kNERtcDegradationMaintainQuality 模式，降低编码帧率以保证视频质量。
kNERtcDegradationMaintainFramerate	流畅优先，降低视频质量以保证编码帧率。在弱网环境下，降低视频清晰度以保证视频流畅，此时画质降低，画面会变得模糊，但可以保持视频流畅。
kNERtcDegradationMaintainQuality	清晰优先，降低编码帧率以保证视频质量。在弱网环境下，降低视频帧率以保证视频清晰，此时可能会出现一定卡顿。
kNERtcDegradationBalanced	在编码帧率和视频质量之间保持平衡。

NERtcDMErrorCode

enum nertc::NERtcDMErrorCode

Error codes.

Error codes are returned when a problem that cannot be recovered without app intervention has occurred.

枚举值
kNERtcRuntimeErrADMInitRecording	Audio device module: Errors occur when initializing recording devices. Please check whether the recording device can work properly or have limited permissions, or try reconnecting to rejoin the room.
kNERtcRuntimeErrADMStartRecording	Audio device module: Errors occur when enabling recording devices. Please check whether the recording device can work properly, or try reconnecting to rejoin the room.
kNERtcRuntimeErrADMStopRecording	Audio device module: Errors occur when running recording devices. Please check whether the recording device can work properly, or try reconnecting to rejoin the room.
kNERtcRuntimeErrADMInitPlayout	Audio device module: Errors occur when initializing playback devices. Please check whether the playback device can work properly or have limited permissions, or try reconnecting to rejoin the room.
kNERtcRuntimeErrADMStartPlayout	Audio device module: Errors occur when enabling playback devices. Please check whether the playback device can work properly, or try reconnecting to rejoin the room.
kNERtcRuntimeErrADMStopPlayout	Audio device module: Errors occur when running playback devices. Please check whether the playback device can work properly, or try reconnecting to rejoin the room.
kNERtcErrVDMCameraNoFrame	Audio device module: The Camera has no data frame. Please check the camera or switch the camera.
kNERtcErrVDMCameraCreateFail	Audio device module:Fails to enable camera. Please check whether the camera has exited or occupied.

NERtcEncryptionMode

enum nertc::NERtcEncryptionMode

媒体流加密模式。

枚举值
kNERtcGMCryptoSM4ECB	128 位 SM4 加密，ECB 模式。

NERtcErrorCode

enum nertc::NERtcErrorCode

Error codes.

Error codes are returned when a problem that cannot be recovered without app intervention has occurred.

枚举值
kNERtcNoError	No errors.
kNERtcErrChannelReservePermissionDenied	No permissions. Possible reasons: RTC 2.0 service is not enabled, whose trial period is overdue or fees are not renewed. Token is not specified in safe mode when joining a channel. Other permission-related problems.
kNERtcErrChannelReserveTimeOut	Request timeouts.
kNERtcErrChannelReserveErrorParam	Error codes are returned when parameters are requested in the server.
kNERtcErrChannelReserveServerFail	Unknown errors are returned when channels are assigned in the server.
kNERtcErrChannelReserveMoreThanTwoUser	Only two users are supported in the same channel. If the third user wants to share the same channel name, assign another channel.
kNERtcErrLsTaskRequestInvalid	Invalid permission that is replaced by following operations.
kNERtcErrLsTaskIsInvaild	Parameter format error.
kNERtcErrLsTaskRoomExited	Exited the channel.
kNERtcErrLsTaskNumLimit	Streaming tasks are over the limit.
kNERtcErrLsTaskDuplicateId	Duplicates ID of streaming tasks.
kNERtcErrLsTaskNotFound	No ID task or no channels.
kNERtcErrLsTaskRequestErr	Permission failures.
kNERtcErrLsTaskInternalServerErr	Internal errors in the server.
kNERtcErrLsTaskInvalidLayout	Layout parameter errors.
kNERtcErrLsTaskUserPicErr	Image errors of users.
kNERtcErrChannelStartFail	Fails to initiate a channel.
kNERtcErrChannelDisconnected	Disconnects the channel.
kNERtcErrVersionSelfLow	The local SDK version is too low to achieve compatibility.
kNERtcErrVersionRemoteLow	The remote SDK version is too low to achieve compatibility.
kNERtcErrChannelClosed	The channel is disabled.
kNERtcErrChannelKicked	The ID is removed from the channel.
kNERtcErrDataError	Data error.
kNERtcErrInvalid	Invalid operation.
kNERtcErrChannelJoinTimeOut	Request timeouts.
kNERtcErrChannelJoinMeetingModeError	Meeting mode error.
kNERtcErrChannelJoinRtmpModeError	rtmp users join the channel that applies the non-rtmp protocol.
kNERtcErrChannelJoinRtmpNodesError	Users capacity is exceeded in the room that applies to the rtmp protocol.
kNERtcErrChannelJoinRtmpHostError	The role of host is specified.
kNERtcErrChannelJoinRtmpCreateError	Relayed live streaming is required where the host does not create the room.
kNERtcErrChannelJoinLayoutError	Errors occur when the host customized the channel layout.
kNERtcErrChannelJoinInvalidParam	Error parameters.
kNERtcErrChannelJoinDesKey	Password encryption error.
kNERtcErrChannelJoinInvalidRequst	Error request.
kNERtcErrChannelServerUnknown	Internal errors in the server.
kNERtcErrFatal	Common errors.
kNERtcErrOutOfMemory	Out of memory.
kNERtcErrInvalidParam	Invalid parameters.
kNERtcErrNotSupported	Unsupported operation.
kNERtcErrInvalidState	Unsupported operations in the current state.
kNERtcErrLackOfResource	Depleted resources.
kNERtcErrInvalidIndex	Invalid index.
kNERtcErrDeviceNotFound	Device is not found.
kNERtcErrInvalidDeviceSourceID	Invalid device ID.
kNERtcErrInvalidVideoProfile	Invalid profile type of video.
kNERtcErrCreateDeviceSourceFail	Device creation errors.
kNERtcErrInvalidRender	Invalid rendering device.
kNERtcErrDevicePreviewAlreadyStarted	Device is already enabled.
kNERtcErrTransmitPendding	Transmission error.
kNERtcErrConnectFail	Server connection error.
kNERtcErrCreateDumpFileFail	Fails to create Audio dump file.
kNERtcErrStartDumpFail	Fails to enable Audio dump file.
kNERtcErrDesktopCaptureInvalidState	Fails to enable desktop screen recording if camera is started at the same time.
kNERtcErrDesktopCaptureInvalidParam	Parameters are invalid when the desktop screen recording is implemented.
kNERtcErrDesktopCaptureNotReady	Desktop screen recording is not ready.
kNERtcErrChannelAlreadyJoined	Repeatedly joins the channel.
kNERtcErrChannelNotJoined	Does not join the channel.
kNERtcErrChannelRepleatedlyLeave	Repeatedly leaves the channel.
kNERtcErrRequestJoinChannelFail	Fails to join the channel.
kNERtcErrSessionNotFound	Session is not found.
kNERtcErrUserNotFound	The user is not found.
kNERtcErrInvalidUserID	Invalid user ID.
kNERtcErrMediaNotStarted	Users do not connect the multi-media data.
kNERtcErrSourceNotFound	Source is not found.
kNERtcErrSwitchChannelInvalidState	Invalid state of switching channels.
kNERtcErrChannelMediaRelayInvalidState	Invalid state of relaying media streams.
kNERtcErrChannelMediaRelayPermissionDenied	Invalid permissions of relaying streams. Check whether the mode is set as audience mode or 1v1 mode.
kNERtcErrChannelMediaRelayStopFailed	If you fail to stop relaying media streams, check whether the media stream forwarding is enabled.
kNERtcErrEncryptNotSuitable	If you set the different encryption password of media streams from other members in the room, you fail to join the room. Sets new encryption password thorough enableEncryption.
kNERtcErrConnectionNotFound	Connection is not found.
kNERtcErrStreamNotFound	Media streams are not found.
kNERtcErrAddTrackFail	Fails to join the track.
kNERtcErrTrackNotFound	Track is not found.
kNERtcErrMediaConnectionDisconnected	Media disconnection.
kNERtcErrSignalDisconnected	Signalling disconnection.
kNERtcErrServerKicked	The user is removed from the room.
kNERtcErrKickedForRoomClosed	Removed for the channel is already disabled.
kNERtcErrChannelLeaveBySwitchAction	Removed for the destination room is disabled.
kNERtcRuntimeErrADMNoAuthorize	No permission of audio devices.
kNERtcRuntimeErrVDMNoAuthorize	No permission of video devices.
kNERtcRuntimeErrScreenCaptureNoAuthorize	No permission of video recording.

NERtcInterfaceIdType

enum nertc::NERtcInterfaceIdType

接口ID类型。

枚举值
kNERtcIIDAudioDeviceManager	获取音频设备管理器的接口ID
kNERtcIIDVideoDeviceManager	获取视频设备管理器的接口ID

NERtcLastmileProbeResultState

enum nertc::NERtcLastmileProbeResultState

Last mile 质量探测结果的状态。

枚举值
kNERtcLastmileProbeResultComplete	表示本次 last mile 质量探测的结果是完整的。
kNERtcLastmileProbeResultIncompleteNoBwe	表示本次 last mile 质量探测未进行带宽预测，因此结果不完整。通常原因为测试资源暂时受限。
kNERtcLastmileProbeResultUnavailable	未进行 last mile 质量探测。通常原因为网络连接中断。

NERtcLiveStreamAudioCodecProfile

enum nertc::NERtcLiveStreamAudioCodecProfile

直播推流音频编码规格

枚举值
kNERtcLiveStreamAudioCodecProfileLCAAC	（默认）LC-AAC 规格，表示基本音频编码规格。
kNERtcLiveStreamAudioCodecProfileHEAAC	HE-AAC 规格，表示高效音频编码规格。

NERtcLiveStreamAudioSampleRate

enum nertc::NERtcLiveStreamAudioSampleRate

直播推流音频采样率

枚举值
kNERtcLiveStreamAudioSampleRate32000	采样率为 32 kHz。
kNERtcLiveStreamAudioSampleRate44100	采样率为 44.1 kHz。
kNERtcLiveStreamAudioSampleRate48000	（默认）采样率为 48 kHz。

NERtcLiveStreamLayoutMode

enum nertc::NERtcLiveStreamLayoutMode

连麦方式。

NERtcLiveStreamMode

enum nertc::NERtcLiveStreamMode

直播推流模式

枚举值
kNERtcLsModeVideo	推流带视频
kNERtcLsModeAudio	推流纯音频

NERtcLiveStreamStateCode

enum nertc::NERtcLiveStreamStateCode

直播推流状态。

枚举值
kNERtcLsStatePushing	推流中
kNERtcLsStatePushFail	互动直播推流失败
kNERtcLsStatePushStopped	推流结束
kNERtcLsStateImageError	背景图片设置出错

NERtcLiveStreamVideoScaleMode

enum nertc::NERtcLiveStreamVideoScaleMode

直播推流视频裁剪模式

枚举值
kNERtcLsModeVideoScaleFit	0: 视频尺寸等比缩放。优先保证视频内容全部显示。因视频尺寸与显示视窗尺寸不一致造成的视窗未被填满的区域填充背景色。
kNERtcLsModeVideoScaleCropFill	1: 视频尺寸等比缩放。优先保证视窗被填满。因视频尺寸与显示视窗尺寸不一致而多出的视频将被截掉。

NERtcLogLevel

enum nertc::NERtcLogLevel

日志级别。

枚举值
kNERtcLogLevelFatal	Fatal 级别日志信息。
kNERtcLogLevelError	Error 级别日志信息。
kNERtcLogLevelWarning	Warning 级别日志信息。默认级别
kNERtcLogLevelInfo	Info 级别日志信息。
kNERtcLogLevelDetailInfo	Detail Info 级别日志信息。
kNERtcLogLevelVerbos	Verbos 级别日志信息。
kNERtcLogLevelDebug	Debug 级别日志信息。如果你想获取最完整的日志，可以将日志级别设为该等级。
kNERtcLogLevelOff	不输出日志信息。

NERtcMediaPriorityType

enum nertc::NERtcMediaPriorityType

媒体优先级类型。

枚举值
kNERtcMediaPriorityHigh	高优先级
kNERtcMediaPriorityNormal	（默认）普通优先级

NERtcNetworkQualityType

enum nertc::NERtcNetworkQualityType

网络质量类型。

枚举值
kNERtcNetworkQualityUnknown	0: 网络质量未知。
kNERtcNetworkQualityExcellent	1: 网络质量极好。
kNERtcNetworkQualityGood	2: 用户主观感觉和 kNERtcNetworkQualityExcellent 类似，但码率可能略低于 kNERtcNetworkQualityExcellent。
kNERtcNetworkQualityPoor	3: 用户主观感受有瑕疵但不影响沟通。
kNERtcNetworkQualityBad	4: 勉强能沟通但不顺畅。
kNERtcNetworkQualityVeryBad	5: 网络质量非常差，基本不能沟通。
kNERtcNetworkQualityDown	6: 完全无法沟通。

NERtcOSCategory

enum nertc::NERtcOSCategory

系统分类。

枚举值
kNERtcOSiOS	iOS 通用设备
kNERtcOSAndroid	Android 通用设备
kNERtcOSPC	PC device.
kNERtcOSWebRTC	WebRTC

NERtcRawAudioFrameOpModeType

enum nertc::NERtcRawAudioFrameOpModeType

音频帧请求数据的读写模式。

枚举值
kNERtcRawAudioFrameOpModeReadOnly	返回数据只读模式
kNERtcRawAudioFrameOpModeReadWrite	返回数据可读写

NERtcReasonConnectionChangedType

enum nertc::NERtcReasonConnectionChangedType

连接状态变更原因

枚举值
kNERtcReasonConnectionChangedLeaveChannel	kNERtcConnectionStateDisconnected 离开房间
kNERtcReasonConnectionChangedChannelClosed	kNERtcConnectionStateDisconnected 房间被关闭
kNERtcReasonConnectionChangedBeKicked	kNERtcConnectionStateDisconnected 用户被踢
kNERtcReasonConnectionChangedTimeOut	kNERtcConnectionStateDisconnected 服务超时
kNERtcReasonConnectionChangedJoinChannel	kNERtcConnectionStateConnected 加入房间
kNERtcReasonConnectionChangedJoinSucceed	kNERtcConnectionStateConnected 加入房间成功
kNERtcReasonConnectionChangedReJoinSucceed	kNERtcConnectionStateConnected 重新加入房间成功（重连）
kNERtcReasonConnectionChangedMediaConnectionDisconnected	kNERtcConnectionStateReconnecting 媒体连接断开
kNERtcReasonConnectionChangedSignalDisconnected	kNERtcConnectionStateReconnecting 信令连接断开
kNERtcReasonConnectionChangedRequestChannelFailed	kNERtcConnectionStateFailed 请求房间失败
kNERtcReasonConnectionChangedJoinChannelFailed	kNERtcConnectionStateFailed 加入房间失败
kNERtcReasonConnectionChangedReDispatch	kNERtcConnectionStateReconnecting 重新分配了服务端IP

NERtcRecordType

enum nertc::NERtcRecordType

录制类型。

枚举值
kNERtcRecordTypeAll	参与合流+单流录制。
kNERtcRecordTypeMix	参与合流录制模式。
kNERtcRecordTypeSingle	参与单流录制模式。

NERtcRemoteVideoStreamType

enum nertc::NERtcRemoteVideoStreamType

视频流类型。

注解

大流的分辨率及参数配置高，小流的分辨率及参数配置低。

枚举值
kNERtcRemoteVideoStreamTypeHigh	默认大流
kNERtcRemoteVideoStreamTypeLow	小流
kNERtcRemoteVideoStreamTypeNone	不订阅

NERtcRoomServerErrorCode

enum nertc::NERtcRoomServerErrorCode

The related error codes of room server. TODO:NERtcErrorCode.

枚举值
kNERtcRoomServerErrOK	Successful operation.
kNERtcRoomServerErrAuthError	Authentication error.
kNERtcRoomServerErrChannelNotExist	Channel is not found.
kNERtcRoomServerErrUidNotExist	The uid of the channel is not found.
kNERtcRoomServerErrDataError	Request data error.
kNERtcRoomServerErrUnknown	Internal error that request error occurs in the TurnServer.
kNERtcRoomServerErrServerError	Internal errors in the server.
kNERtcRoomServerErrInvilid	Invalid operation.

NERtcScreenCaptureStatus

enum nertc::NERtcScreenCaptureStatus

屏幕分享状态

枚举值
kScreenCaptureStatusStart	开始屏幕共享。
kScreenCaptureStatusPause	暂停屏幕共享。
kScreenCaptureStatusResume	恢复屏幕共享。
kScreenCaptureStatusStop	停止屏幕共享。
kScreenCaptureStatusCovered	屏幕分享的目标窗口被覆盖。 注解 在 Windows 平台中，某些窗口在被屏蔽之后，如果被置于图层最上层，此窗口图像可能会黑屏。此时会触发 onScreenCaptureStatus.kScreenCaptureStatusCovered 回调，建议应用层在触发此回调时提醒用户将待分享的窗口置于最上层。

NERtcScreenProfileType

enum nertc::NERtcScreenProfileType

屏幕共享编码参数配置。

枚举值
kNERtcScreenProfile480P	640x480, 5fps
kNERtcScreenProfileHD720P	1280x720, 5fps
kNERtcScreenProfileHD1080P	1920x1080, 5fps。默认
kNERtcScreenProfileCustom	自定义
kNERtcScreenProfileNone	无效果。
kNERtcScreenProfileMAX	1920x1080, 5fps。

NERtcSendOnPubType

enum nertc::NERtcSendOnPubType

视频推流后发送策略。

枚举值
kNERtcSendOnPubNone	不主动发送数据流，被订阅后发送。
kNERtcSendOnPubHigh	主动发送大流。
kNERtcSendOnPubLow	主动发送小流。
kNERtcSendOnPubAll	主动发送大小流。

NERtcSessionLeaveReason

enum nertc::NERtcSessionLeaveReason

用户离开原因。

枚举值
kNERtcSessionLeaveNormal	正常离开。
kNERtcSessionLeaveForFailOver	用户断线导致离开。
kNERtcSessionLeaveUpdate	用户 Failover 过程中产生的 leave。
kNERtcSessionLeaveForKick	用户被踢导致离开。
kNERtcSessionLeaveTimeOut	用户超时导致离开。

NERtcStreamFallbackOption

enum nertc::NERtcStreamFallbackOption

上行、下行弱网时的回退选项。

枚举值
kNERtcStreamFallbackDisabled	上行或下行网络较弱时，不对音视频流作回退处理，但不能保证音视频流的质量。 注解 该选项只对 setLocalPublishFallbackOption 方法有效，对 setRemoteSubscribeFallbackOption 方法无效。
kNERtcStreamFallbackVideoStreamLow	在下行网络条件较差的情况下，SDK 将只接收视频小流，即低分辨率、低码率视频流。 注解 该选项只对 setRemoteSubscribeFallbackOption 方法有效，对 setLocalPublishFallbackOption 方法无效。
kNERtcStreamFallbackAudioOnly	上行网络较弱时，只发布音频流。 下行网络较弱时，先尝试只接收视频小流，即低分辨率、低码率视频流。如果网络环境无法显示视频，则再回退到只接收音频流。

NERtcSubStreamContentPrefer

enum nertc::NERtcSubStreamContentPrefer

屏幕共享功能的编码策略倾向。

• kNERtcSubStreamContentPreferMotion: 内容类型为动画。当共享的内容是视频、电影或游戏时，推荐选择该内容类型。当用户设置内容类型为动画时，按用户设置的帧率处理。
• kNERtcSubStreamContentPreferDetails: 内容类型为细节。当共享的内容是图片或文字时，推荐选择该内容类型。当用户设置内容类型为细节时，最高允许用户设置到10帧，设置超过 10 帧时，不生效，按 10 帧处理。

枚举值
kNERtcSubStreamContentPreferMotion	动画模式。
kNERtcSubStreamContentPreferDetails	细节模式。

NERtcVideoCropMode

enum nertc::NERtcVideoCropMode

视频画面裁剪模式。

枚举值
kNERtcVideoCropModeDefault	设备默认裁剪模式。
kNERtcVideoCropMode16x9	16:9
kNERtcVideoCropMode4x3	4:3
kNERtcVideoCropMode1x1	1:1

NERtcVideoDeviceState

enum nertc::NERtcVideoDeviceState

视频设备类型状态。

枚举值
kNERtcVideoDeviceAdded	视频设备已添加
kNERtcVideoDeviceRemoved	视频设备已拔除

NERtcVideoDeviceTransportType

enum nertc::NERtcVideoDeviceTransportType

摄像头设备链接类型。

枚举值
kNERtcVideoDeviceTransportTypeUnknown	未知设备
kNERtcVideoDeviceTransportTypeUSB	USB device.
kNERtcVideoDeviceTransportTypeVirtual	虚拟设备
kNERtcVideoDeviceTransportTypeOther	其他设备

NERtcVideoDeviceType

enum nertc::NERtcVideoDeviceType

视频设备类型。

枚举值
kNERtcVideoDeviceUnknown	Video capture device.
kNERtcVideoDeviceCapture	视频采集设备

NERtcVideoFramerateType

enum nertc::NERtcVideoFramerateType

视频帧率。

枚举值
kNERtcVideoFramerateFpsDefault	默认帧率
kNERtcVideoFramerateFps_7	7帧每秒
kNERtcVideoFramerateFps_10	10帧每秒
kNERtcVideoFramerateFps_15	15帧每秒
kNERtcVideoFramerateFps_24	24帧每秒
kNERtcVideoFramerateFps_30	30帧每秒
kNERtcVideoFramerateFps_60	60帧每秒

NERtcVideoMirrorMode

enum nertc::NERtcVideoMirrorMode

视频镜像模式。

枚举值
kNERtcVideoMirrorModeAuto	0: Windows/macOS SDK 启用镜像模式。
kNERtcVideoMirrorModeEnabled	1: 启用镜像模式。
kNERtcVideoMirrorModeDisabled	2: （默认）关闭镜像模式。

NERtcVideoOutputOrientationMode

enum nertc::NERtcVideoOutputOrientationMode

视频旋转的方向模式。

枚举值
kNERtcVideoOutputOrientationModeAdaptative	（默认）该模式下 SDK 输出的视频方向与采集到的视频方向一致。接收端会根据收到的视频旋转信息对视频进行旋转。 该模式适用于接收端可以调整视频方向的场景。 如果采集的视频是横屏模式，则输出的视频也是横屏模式。 如果采集的视频是竖屏模式，则输出的视频也是竖屏模式。
kNERtcVideoOutputOrientationModeFixedLandscape	该模式下 SDK 固定输出横屏模式的视频。如果采集到的视频是竖屏模式，则视频编码器会对其进行裁剪。 该模式适用于接收端无法调整视频方向的场景，例如旁路推流。
kNERtcVideoOutputOrientationModeFixedPortrait	该模式下 SDK 固定输出竖屏模式的视频，如果采集到的视频是横屏模式，则视频编码器会对其进行裁剪。 该模式适用于接收端无法调整视频方向的场景，例如旁路推流。

NERtcVideoProfileType

enum nertc::NERtcVideoProfileType

视频编码配置。用于衡量编码质量。

注解

kNERtcVideoProfileFake:

• 表示对端发送 16*16 的 fakeVideo，即纯音频下发送 SEI，属于 SDK 内部行为，此时收到的是黑色帧，不需要显示 view。
• 因此这个档位不主动使用，属于被动接受，如果主动使用，SDK 内部会按 standard 处理。

枚举值
kNERtcVideoProfileLowest	普清（160x90/120, 15fps）
kNERtcVideoProfileLow	标清（320x180/240, 15fps）
kNERtcVideoProfileStandard	高清（640x360/480, 30fps）
kNERtcVideoProfileHD720P	超清（1280x720, 30fps）
kNERtcVideoProfileHD1080P	1080P（1920x1080, 30fps）
kNERtcVideoProfileNone	无效果。
kNERtcVideoProfileFake	FakeVideo标识，仅在回调中显示。请勿主动设置，否则 SDK 会按照 STANDARD 处理。 当远端在纯音频状态发送 SEI 时，本端将会收到远端的onUserVideoStart回调，其中 max_profile 参数为 kNERtcVideoProfileFake ， 表示对端发送 16*16 的 FakeVideo，此时如果本端需要接收远端的SEI信息，只需要订阅一下远端的视频即可，无须设置远端画布。

NERtcVideoRotation

enum nertc::NERtcVideoRotation

视频旋转角度。

枚举值
kNERtcVideoRotation_0	0°
kNERtcVideoRotation_90	90 度。
kNERtcVideoRotation_180	180 度。
kNERtcVideoRotation_270	270 度。

NERtcVideoScalingMode

enum nertc::NERtcVideoScalingMode

设置视频缩放模式。

枚举值
kNERtcVideoScaleFit	0：适应视频，视频尺寸等比缩放。优先保证视频内容全部显示。若视频尺寸与显示视窗尺寸不一致，视窗未被填满的区域填充背景色。
kNERtcVideoScaleFullFill	1：视频尺寸非等比缩放。保证视频内容全部显示，且填满视窗。
kNERtcVideoScaleCropFill	2：适应区域，视频尺寸等比缩放。保证所有区域被填满，视频超出部分会被裁剪。

NERtcVideoStreamType

enum nertc::NERtcVideoStreamType

视频流类型

枚举值
kNERTCVideoStreamMain	主流
kNERTCVideoStreamSub	辅流
kNERTCVideoStreamCount	预留参数，无需关注。

NERtcVideoType

enum nertc::NERtcVideoType

视频类型。

枚举值
kNERtcVideoTypeI420	I420 视频格式。
kNERtcVideoTypeNV12	NV12 视频格式。
kNERtcVideoTypeNV21	NV21 视频格式。
kNERtcVideoTypeBGRA	BGRA 视频格式。
kNERtcVideoTypeCVPixelBuffer	oc capture native视频格式。不支持外部视频输入

NERtcVoiceBeautifierType

enum nertc::NERtcVoiceBeautifierType

预设的美声效果

枚举值
kNERtcVoiceBeautifierOff	默认关闭
kNERtcVoiceBeautifierMuffled	低沉
kNERtcVoiceBeautifierMellow	圆润
kNERtcVoiceBeautifierClear	清澈
kNERtcVoiceBeautifierMagnetic	磁性
kNERtcVoiceBeautifierRecordingstudio	录音棚
kNERtcVoiceBeautifierNature	天籁
kNERtcVoiceBeautifierKTV	KTV
kNERtcVoiceBeautifierRemote	悠远
kNERtcVoiceBeautifierChurch	教堂
kNERtcVoiceBeautifierBedroom	卧室
kNERtcVoiceBeautifierLive	Live

NERtcVoiceChangerType

enum nertc::NERtcVoiceChangerType

变声 预设值

枚举值
kNERtcVoiceChangerOff	默认关闭
kNERtcVoiceChangerRobot	机器人
kNERtcVoiceChangerGaint	巨人
kNERtcVoiceChangerHorror	恐怖
kNERtcVoiceChangerMature	成熟
kNERtcVoiceChangerManToWoman	男变女
kNERtcVoiceChangerWomanToMan	女变男
kNERtcVoiceChangerManToLoli	男变萝莉
kNERtcVoiceChangerWomanToLoli	女变萝莉

NERtcVoiceEqualizationBand

enum nertc::NERtcVoiceEqualizationBand

音效均衡波段的中心频率

枚举值
kNERtcVoiceEqualizationBand_31	31 Hz
kNERtcVoiceEqualizationBand_62	62 Hz
kNERtcVoiceEqualizationBand_125	125 Hz
kNERtcVoiceEqualizationBand_250	250 Hz
kNERtcVoiceEqualizationBand_500	500 Hz
kNERtcVoiceEqualizationBand_1K	1 kHz
kNERtcVoiceEqualizationBand_2K	2 kHz
kNERtcVoiceEqualizationBand_4K	4 kHz
kNERtcVoiceEqualizationBand_8K	8 kHz
kNERtcVoiceEqualizationBand_16K	16 kHz

NERtcWarnCode

enum nertc::NERtcWarnCode

警告代码。 警告代码意味着 SDK 遇到问题，但有可能恢复，警告代码仅起告知作用，一般情况下应用程序可以忽略警告代码。

枚举值
kNERtcWarnInvalidView	指定的 view 无效，使用视频功能时需要指定 view，如果 view 尚未指定，则返回该警告。
kNERtcWarnInitVideo	初始化视频功能失败。有可能是因视频资源被占用导致的。用户无法看到视频画面，但不影响语音通信。
kNERtcWarnPending	请求处于待定状态。一般是由于某个模块还没准备好，请求被延迟处理。
kNERtcWarningChannelAbilityNotMatch	当前客户端设备视频编解码能力与房间不匹配，例如设备不支持 VP8 等编码类型。在此房间中可能无法成功进行视频编解码，即本端可能无法正常显示某些远端的视频画面，同样远端也可能无法显示本端画面。
kNERtcWarnADMRuntimePlayoutWarning	音频设备模块：运行时播放设备出现警告。
kNERtcWarnADMRuntimeRecordingWarning	音频设备模块：运行时录音设备出现警告。
kNERtcWarnADMRecordAudioSilence	音频设备模块：没有采集到有效的声音数据。
kNERtcWarnADMPlayoutMalfunction	音频设备模块：播放设备故障。
kNERtcWarnADMRecordMalfunction	音频设备模块：录音设备故障。
kNERtcWarnADMRecordAudioLowLevel	音频设备模块：录到的声音太低。
kNERtcWarnADMPlayoutAudioLowLevel	音频设备模块：播放的声音太低。
kNERtcWarnAPMHowling	音频设备模块：录音声音监测到啸叫。
kNERtcWarnADMGlitchState	音频设备模块：音频播放会卡顿。
kNERtcWarnADMImproperSettings	音频设备模块：音频底层设置被修改。
kNERtcWarnADMWinCoreNoDataReadyEvent	音频设备模块：音频驱动异常。解决方案：禁用并重新使能音频设备，或者重启机器，或者更新声卡驱动。
kNERtcWarnADMWinCoreNoRecordingDevice	音频设备模块：无可用音频采集设备。
kNERtcWarnADMWinCoreNoPlayoutDevice	音频设备模块：无可用音频播放设备。解决方案：插入音频设备。
kNERtcWarnADMWinCoreImproperCaptureRelease	音频设备模块：音频采集释放有误。解决方案：禁用并重新使能音频设备，或者重启机器，或者更新声卡驱动。