数据结构

通过阅读本文,您可以了解实时音视频Android SDK涉及的数据类型。

目录

数据类型

描述

AliRtcAudioVolume

用户音量信息。

AliRtcAudioFrame

音频裸数据。

AliRtcVideoSample

视频样本。

AliRtcVideoSourceType

视频源类型。

AliRTCSdkChannelProfile

频道模式。

AliRTCSdkClientRole

用户角色。

AliRtcRawDataStreamType

原始数据流类型。

AliRtcRawDataFrame

外部视频帧数据。

AliRtcStats

会话数据统计信息。

AliRtcLocalVideoStats

本地视频统计信息。

AliRtcRemoteVideoStats

远端视频统计信息。

AliRtcLocalAudioStats

本地音频统计信息。

AliRtcRemoteAudioStats

远端音频统计信息。

AliRtcVideoObserPosition

视频数据输出位置。

AliRtcVideoFormat

视频数据输出格式。

AliRtcConnectionStatus

网络连接状态。

AliRtcConnectionStatusChangeReason

网络连接状态变更原因。

AliRtcVideoTrack

视频流类型。

AliRtcPublishState

推流状态。

AliRtcSubscribeState

订阅状态。

AliRtcUserOfflineReason

用户离线原因。

AliRtcVideoStreamType

相机大小流类型。

AliRtcAudioTrack

音频流类型。

AliRtcNetworkQuality

网络质量。

AliRtcRenderMode

渲染模式。

AliRtcRenderMirrorMode

镜像模式。

AliRtcRotationMode

旋转角度。

AliRtcLogLevel

日志级别。

AliRtcAudioNumChannel

音频声道类型。

AliRtcAudioSampleRate

音频采样率类型。

AliRtcRecordType

录制类型。

AliRtcRecordFormat

录制格式。

AliRtcAudioQuality

录制音频文件的音频质量。

AliRtcVideoQuality

录制视频文件的视频质量。

AliRtcAudioProfile

音频质量模式。

AliRtcAudioScenario

音频场景模式。

AliRtcMuteLocalAudioMode

本地静音模式。

AliRtcRecordAudioConfig

录制音频文件参数配置。

AliRtcRecordVideoConfig

录制视频文件参数配置。

AliRtcOnByeType

OnBye类型枚举。

AliRtcAudioEffectVoiceChangerMode

变声音效模式。

AliRtcAudioEffectReverbMode

音效混响模式。

AliRtcAudioEffectReverbParamType

音效混响参数。

AliRtcAudioRouteType

语音路由类型。

AliRtcRemoteTextureInfo

远端用户纹理信息。

AliRtcVideoCanvas

渲染画布。

AliRtcMpuState

旁路转推任务状态。

AliRtcRectPosition

水印图片的位置和大小。

AliRtcWatermarkConfig

水印图片的设置。

AliRtcTextureInfo

纹理信息。

AliEngineCameraCapturerConfiguration

摄像头采集偏好属性。

AliRtcCaptureOutputPreference

摄像头采集偏好。

AliRtcCameraDirection

摄像头方向。

AliRtcCameraCaptureProfile

指定视频采集的特定分辨率。

AliRtcVideoEncoderFrameRate

视频编码帧率。

AliRtcVideoEncoderBitrate

视频编码码率。

AliRtcVideoEncoderMirrorMode

编码视频镜像模式。

AliRtcVideoEncoderOrientationMode

编码视频旋转模式。

AliRtcVideoDimensions

视频分辨率。

AliRtcVideoEncoderConfiguration

设置视频编码属性。

AliRtcVideoCodecType

视频编解码器类型。

AliRtcVideoDecoderConfiguration

视频解码器设置。

AliRtcVideoEncodeCodecType

编码器类型。

AliRtcScreenShareEncoderConfiguration

设置屏幕分享编码属性。

AliRtcAuthInfo

鉴权信息。

AliRtcLiveTranscoding

旁路直播配置。

AliRtcRemoteUserInfo

远端用户信息。

AliRtcVideoReason

触发视频流状态变化的原因。

AliRtcVideoState

视频流状态变化。

AliRtcTrascodingPublishTaskStatus

旁路直播推流任务状态。

AliEngineLiveTranscodingErrorCode

旁路直播推流错误码。

AliRtcLiveTranscodingState

旁路直播状态。

AliRtcLiveTranscodingMediaProcessMode

旁路直播媒体处理模式。

AliRtcLiveTranscodingCropMode

旁路直播裁剪模式。

AliRtcLiveTranscodingFontType

旁路直播字体。

AliRtcLiveTranscodingSegmentType

旁路直播输入类型。

AliRtcLiveTranscodingAudioSampleRate

旁路直播音频采样率。

AliRtcLiveTranscodingTaskProfile

旁路直播计费规格。

AliRtcLiveTranscodingSourceType

旁路直播视频流类型。

AliRtcLiveTranscodingStreamType

旁路直播转推流类型。

AliRtcLiveTranscodingMixMode

旁路直播模式。

AliRtcVideoObserAlignment

裸数据回调数据对齐类型。

AliRtcLiveTranscodingEncodeParam

旁路直播编码参数。

AliRtcLiveTranscodingMixParam

旁路直播混流参数。

AliRtcLiveTranscodingParam

旁路直播参数。

AliRtcLiveTranscodingSingleParam

旁路直播单流参数。

TranscodingClockWidget

旁路直播时钟小工具。

TranscodingUser

旁路直播用户信息。

TranscodingText

旁路直播文本信息。

TranscodingImage

旁路直播图片信息。

DisplayType

图片显示模式。

AliRtcScreenShareMode

屏幕共享类型。

AliCapabilityProfile

功能聚合参数,入会参数中使用。

AliRTCSdkChannelParam

入会参数。

AlirtcNetworkQualityProbeConfig

探测网络的参数配置。

AlirtcNetworkQualityProbeResult

探测网络的结果。

AliRtcVideoPipelineMirrorMode

视频流镜像模式。

AliRtcCapturePipelineScaleMode

视频缩放时机。

AliRtcAudioSource

音频订阅类型。

AliRtcAudioFrameObserverConfig

音频数据回调设置。

AliRtcAudioFrameObserverOperationMode

回调音频数据读写模式。

AliRtcAudioFrameObserverUserDefinedInfoBitMask

音频数据回调自定义参数。

AliRtcOrientationMode

设备方向枚举。

AliRtcAudioAccompanyErrorCode

音乐伴奏播放错误码。

AliRtcAudioAccompanyConfig

伴奏播放的配置项。

AliRtcExternalAudioStreamConfig

外部音频流配置。

AliRtcDataChannelMsg

数据通道消息。

AliRtcDataMsgType

数据通道消息类型。

AliRtcVideoExternalEncoderParameter

网络变化反馈参数结构体。

AliRtcVideoEncodedFrameType

Qos反馈外置编码器请求帧类型。

AliRtcAudioAccompanyStateCode

音乐伴奏播放状态。

AliRtcAudioFileInfo

音频文件信息。

AliRtcEngineLocalDeviceType

本地设备类型。

API详情

AliRtcAudioVolume

用户音量信息。

参数

类型

描述

mUserId

String

当前用户ID,取值:

  • 0:本地。

  • 1:远端混音。

  • 其他表示远端用户的ID。

mVolume

int

当前回调的音量。

mSpeechstate

int

当前用户说话状态,取值:

  • 0:没有说话。

  • 1:正在说话。

AliRtcVideoSample

视频样本。

参数

类型

描述

dataFrameY

long

Y分量指针。

dataFrameU

long

U分量指针。

dataFrameV

long

V分量指针。

data

byte[]

yuv数据指针。

format

AliRtcVideoFormat

视频帧格式。

width

int

视频帧的宽。

height

int

视频帧的高。

strideY

int

YUV数据中的Y缓冲区的行跨度。

strideU

int

YUV数据中的U缓冲区的行跨度。

strideV

int

YUV数据中的V缓冲区的行跨度。

rotate

int

视频帧的旋转角度。

extraData

long

附加字段(非定制化可忽略)。

textureid

long

OpenGL 纹理 ID,用于绑定纹理。

matrix

float[]

4x4 变换矩阵,用于控制纹理的旋转、缩放或投影。

glContex

long

OpenGL 上下文指针,用于管理 GPU 渲染状态。

AliRtcVideoSourceType

视频源类型。

枚举名

描述

AliRTCSdkVideoSourceCameraType

相机流。

AliRTCSdkVideoSourceScreenShareType

屏幕分享流。

AliRTCSdkChannelProfile

频道模式。

枚举名

描述

AliRTCSdkCommunication

通信模式。

AliRTCSdkInteractiveLive

互动模式。

AliRTCSdkInteractiveWithLowLatencyLive

低延迟实时音视频模式。

AliRTCSdkClientRole

用户角色。

枚举名

描述

AliRTCSdkInteractive

主播角色。

AliRTCSdkLive

观众角色。

AliRtcRawDataStreamType

原始数据流类型。

枚举名

描述

AliRTCSdkStreameTypeCapture

相机流。

AliRTCSdkStreameTypeScreen

屏幕流。

AliRtcRawDataFrame

外部视频帧数据。

参数名

类型

描述

format

AliRtcVideoFormat

视频数据类型。

width

int

该帧的宽。

height

int

该帧的高。

rotation

int

该帧的角度。

videoFrameLength

int

该帧的长度。

lineSize

int[]

视频帧的存储,详情请参见下表。

frame

byte[]

视频的YUV字节数据。

cropLeft

int

左侧的裁剪像素点数。

cropTop

int

顶部的裁剪像素点数。

cropRight

int

右侧的裁剪像素点数。

cropBottom

int

底部的裁剪像素点数。

timeStamp

long

该帧的时间戳,单位:毫秒。

filePath

byte[]

视频文件路径,对应 format 为AliRtcVideoFormatFile 时使用。

textureId

int

该帧的Texture ID。

transformMatrix

float[]

Texture帧额外的转换。

eglContext14

EGLContext

opengl的线程相关上下文变量。

视频帧格式

视频帧存储

YUV

  • lineSize[0] = width; // Y

  • lineSize[1] = width/2; // U

  • lineSize[2] = width/2; // V

  • lineSize[3] = 0;

RGBA

  • lineSize[0] = width; // R

  • lineSize[1] = width; // G

  • lineSize[2] = width; // B

  • lineSize[3] = width; // A

AliRtcStats

会话数据统计信息。

参数

类型

描述

availableSendKbitrate

long

可用带宽(kb)。

sentKbitrate

long

发送码率。

rcvdKbitrate

long

接收码率。

sentBytes

long

发送字节数。

rcvdBytes

long

接收字节数。

systemCpuUsage

float

系统CPU使用率。

cpuUsage

float

RTC进程CPU使用率。

videoRcvdKbitrate

long

视频接收码率。

videoSentKbitrate

long

视频发送码率。

callDuration

long

通话时长,单位:秒。

sentLossRate

long

客户端到服务器的丢包率。

sentLossPkts

long

客户端到服务器的丢包数。

sentExpectedPkts

long

客户端到服务器的总包数。

rcvdLossRate

long

客户端到服务器的下行丢包率。

rcvdLossPkts

long

客户端到服务器的下行丢包数。

rcvdExpectedPkts

long

客户端到服务器的下行总包数。

lastmileDelay

long

延时时长,单位:毫秒。

AliRtcLocalVideoStats

本地视频统计信息。

参数

类型

描述

userId

String

本地用户ID。

track

AliRtcVideoTrack

流类型。

sentBitrate

int

发布比特率。

captureFps

int

采集帧率。

sentFps

int

发布帧率。

encodeFps

int

编码帧率。

targetEncodeBitrate

int

目标编码码率。

actualEncodeBitrate

int

实际编码码率。

AliRtcRemoteVideoStats

远端视频统计信息。

参数

类型

描述

userId

String

远端用户ID。

track

AliRtcVideoTrack

视频流类型。

width

int

视频帧的宽。

height

int

视频帧的高。

decodeFps

int

编码器输出帧率。

renderFps

int

渲染器输出帧率。

frozenTimes

int

卡顿次数。

videoTotalFrozenTime

int

视频播放的累计卡顿时长,单位ms。

videoTotalFrozenRate

int

视频播放的累计卡顿率,单位% 。

AliRtcLocalAudioStats

本地音频统计信息。

参数

类型

描述

track

AliRtcAudioTrack

音频流类型。

sentBitrate

int

发送码率。

sentSamplerate

int

发送的采样率。

numChannel

int

声道数。

AliRtcRemoteAudioStats

远端音频统计信息。

参数

类型

描述

userId

String

用户ID。

audioTrack

AliRtcAudioTrack

音频流类型。

quality

int

音质。

audioLossRate

int

音频丢包率。

rcvdBitrate

int

接收码率。

network_transport_delay

int

音频发送端到接收端的网络延迟,单位:毫秒。

jitter_buffer_delay

int

接收端到网络抖动缓冲的网络延迟,单位:毫秒。

AliRtcVideoObserPosition

视频数据输出位置。

枚举名

描述

AliRtcPositionPostCapture

采集数据。

AliRtcPositionPreRender

拉流数据。

AliRtcPositionPreEncoder

编码前数据。

AliRtcVideoFormat

视频数据输出格式。

枚举名

描述

AliRtcVideoFormatUNKNOW

未知格式。

AliRtcVideoFormatBGRA

BGRA。

AliRtcVideoFormatI420

I420。

AliRtcVideoFormatNV21

NV21。

AliRtcVideoFormatNV12

NV12。

AliRtcVideoFormatRGBA

RGBA。

AliRtcVideoFormatI422

I422。

AliRtcVideoFormatARGB

ARGB。

AliRtcVideoFormatABGR

ABGR。

AliRtcVideoFormatRGB24

RGB24。

AliRtcVideoFormatBGR24

BGR24。

AliRtcVideoFormatRGB565

RGB565。

AliRtcVideoFormatTextureOES

TextureOES。

AliRtcVideoFormatTexture2D

Texture2D。

AliRtcVideoFormatH264

H.264 编码视频流格式。

AliRtcVideoFormatH265

H.265 (HEVC) 编码视频流格式。

AliRtcVideoFormatFile

表示数据来自文件。

AliRtcConnectionStatus

网络连接状态。

枚举名

描述

AliRtcConnectionStatusInit

初始化完成。

AliRtcConnectionStatusDisconnected

网络连接断开。

AliRtcConnectionStatusConnecting

建立网络连接中。

AliRtcConnectionStatusConnected

网络已连接。

AliRtcConnectionStatusReconnecting

重新建立网络连接中。

AliRtcConnectionStatusFailed

网络连接失败。

AliRtcConnectionStatusChangeReason

网络连接状态变更原因。

枚举名

描述

AliRtcConnectionChangedDummyReason

未知原因。

AliRtcConnectionMediaPathChanged

媒体通道变更。

AliRtcConnectionSignalingHeartbeatTimeout

心跳超时。

AliRtcConnectionSignalingHeartbeatAlive

心跳恢复。

AliRtcConnectionSignalingHttpDnsResolved

DNS解析成功。

AliRtcConnectionSignalingHttpDnsFailure

DNS解析失败。

AliRtcConnectionSignalingGslbFailure

GSLB请求失败。

AliRtcConnectionSignalingGslbSucccess

GSLB请求成功。

AliRtcConnectionSignalingJoinRoomFailure

加入频道失败。

AliRtcConnectionSignalingJoinRoomSuccess

加入频道成功。

AliRtcConnectionSignalingLeaveRoom

离开频道。

AliRtcConnectionSignalingConnecting

信令建立连接。

AliRtcConnectionChangedNetworkInterrupted

网络连接中断。

AliRtcVideoTrack

视频流类型。

枚举名

描述

AliRtcVideoTrackNo

无视频流。

AliRtcVideoTrackCamera

摄像头流。

AliRtcVideoTrackScreen

屏幕共享流。

AliRtcVideoTrackBoth

摄像头和屏幕共享。

AliRtcPublishState

推流状态。

枚举名

描述

AliRtcStatsPublishIdle

初始状态。

AliRtcStatsNoPublish

未推流。

AliRtcStatsPublishing

推流中。

AliRtcStatsPublished

已推流。

AliRtcSubscribeState

订阅状态。

枚举名

描述

AliRtcStatsSubscribeIdle

初始状态。

AliRtcStatsNoSubscribe

未订阅。

AliRtcStatsSubscribing

订阅中。

AliRtcStatsSubscribed

已订阅。

AliRtcUserOfflineReason

用户离线原因。

枚举名

描述

AliRtcUserOfflineQuit

用户主动离开。

AliRtcUserOfflineDropped

因过长时间收不到对方数据包,超时掉线。

AliRtcUserOfflineBecomeAudience

用户身份从主播切换为观众时触发。

AliRtcVideoStreamType

相机大小流类型。

枚举名

描述

AliRtcVideoStreamTypeNone

无视频流。

AliRtcVideoStreamTypeHigh

大流。

AliRtcVideoStreamTypeLow

小流。

AliRtcAudioTrack

音频流类型。

枚举名

描述

AliRtcAudioTrackNo

无音频流。

AliRtcAudioTrackMic

麦克风流。

AliRtcAudioTrackDual

第二音频流。

AliRtcAudioTrackBoth

麦克风 + 第二音频流。

AliRtcNetworkQuality

网络质量。

枚举名

描述

AliRtcNetworkExcellent

网络极好,流程度清晰度质量好。

AliRtcNetworkGood

网络好,流畅度清晰度和极好差不多。

AliRtcNetworkPoor

网络较差,音视频流畅度清晰度有瑕疵,不影响沟通。

AliRtcNetworkBad

网络差,视频卡顿严重,音频能正常沟通。

AliRtcNetworkVeryBad

网络极差,基本无法沟通。

AliRtcNetworkDisconnected

网络断开。

AliRtcNetworkUnknow

未知原因。

AliRtcRenderMode

渲染模式。

枚举名

描述

AliRtcRenderModeAuto

自动。

AliRtcRenderModeStretch

拉伸填充视图,不保持视频比例。

AliRtcRenderModeFill

在保持视频宽高比的同时缩放,填充黑边。

AliRtcRenderModeClip

在保持视频宽高比的同时缩放,并裁剪以适合视图。

AliRtcRenderModeNoChange

不调整输入视频的宽高比,直接渲染(适合输入视频与目标分辨率完全一致的场景,或开发者自定义适配逻辑)。

AliRtcRenderMirrorMode

镜像模式。

枚举名

描述

AliRtcRenderMirrorModeOnlyFront

只有前置摄像头预览镜像,其余不镜像。

AliRtcRenderMirrorModeAllEnabled

全部镜像。

AliRtcRenderMirrorModeAllDisable

全部不镜像。

AliRtcRotationMode

旋转角度。

枚举名

描述

AliRtcRotationMode_0

不旋转。

AliRtcRotationMode_90

旋转90度。

AliRtcRotationMode_180

旋转180度。

AliRtcRotationMode_270

旋转270度。

AliRtcLogLevel

日志级别。

枚举名

描述

AliRtcLogLevelInfo

普通。

AliRtcLogLevelWarn

警告。

AliRtcLogLevelError

错误。

AliRtcLogLevelFatal

严重。

AliRtcLogLevelNone

无。

AliRtcAudioNumChannel

音频声道类型。

枚举名

描述

AliRtcMonoAudio

单声道。

AliRtcStereoAudio

双声道。

AliRtcAudioSampleRate

音频采样率类型。

枚举名

描述

AliRtcAudioSampleRate_8000

采样率8000。

AliRtcAudioSampleRate_11025

采样率11025。

AliRtcAudioSampleRate_16000

采样率16000。

AliRtcAudioSampleRate_22050

采样率22050。

AliRtcAudioSampleRate_32000

采样率32000。

AliRtcAudioSampleRate_44100

采样率44100。

AliRtcAudioSampleRate_48000

采样率48000。

AliRtcAudioSampleRate_Unknown

未知采样率。

AliRtcAudioSampleRate_Max

边界值。

AliRtcRecordType

录制类型。

枚举名

描述

AliRtcRecordTypeAudio

纯音频录制。

AliRtcRecordFormat

录制格式。

枚举名

描述

AliRtcRecordFormatAAC

AAC文件。

AliRtcRecordFormatWAV

WAV文件。

AliRtcAudioQuality

录制音频文件的音频质量。

枚举名

描述

AliRtcAudioQualityLow

低。

AliRtcAudioQualityMidium

中。

AliRtcAudioQualityHigh

高。

AliRtcVideoQuality

录制视频文件的视频质量。

枚举名

描述

AliRtcVideoQualityDefault

默认和视频采集质量保持一致(移动端不提供视频录制)。

AliRtcAudioProfile

音频质量模式。

枚举名

描述

AliRtcEngineLowQualityMode

音频低音质模式。

AliRtcEngineBasicQualityMode

标准音质模式。

AliRtcEngineHighQualityMode

高音质模式。

AliRtcEngineStereoHighQualityMode

立体声高音质模式。

AliRtcEngineSuperHighQualityMode

超高音质模式。

AliRtcEngineStereoSuperHighQualityMode

立体声超高音质模式。

AliRtcAudioScenario

音频场景模式。

枚举名

描述

AliRtcSceneDefaultMode

默认场景,一般的音视频通信场景推荐使用。

AliRtcSceneEducationMode

教育场景,优先保证音频连续性与稳定性。

AliRtcSceneMediaMode

媒体场景,保真人声与音乐音质,连麦直播间推荐使用。

AliRtcSceneMusicMode

音乐场景,高保真音乐音质,乐器教学等对音乐音质有要求的场景推荐使用。

AliRtcSceneChatroomMode

聊天室场景,适用于频繁上下麦的聊天场景,音量条始终为语音通话音量条。

AliRtcMuteLocalAudioMode

本地静音模式。

枚举名

描述

AliRtcMuteAudioModeDefault

默认模式(静音全部,包括麦克风及外部输入音频)。

AliRtcMuteAllAudioMode

静音全部(包括麦克风及外部输入音频)。

AliRtcMuteOnlyMicAudioMode

只静音麦克风。

AliRtcMuteLocalAudioMax

占位符。

AliRtcRecordAudioConfig

录制音频文件参数配置。

枚举名

描述

AliRtcAudioSampleRate

录制音频文件采样率。

AliRtcAudioQuality

录制音频文件质量。

AliRtcRecordVideoConfig

录制视频文件参数配置。

枚举名

描述

AliRtcVideoQuality

录制视频文件质量。

AliRtcOnByeType

OnBye类型枚举。

枚举名

描述

AliRtcByeTypeKickOff

被踢出。

AliRtcByeTypeDelChannel

频道被删除。

AliRtcByeTypeRestoreSession

被动离开需要恢复Session。

AliRtcAudioEffectVoiceChangerMode

变声音效模式。

枚举名

描述

AliRtcSdk_AudioEffect_Voice_Changer_OFF

关闭。

AliRtcSdk_AudioEffect_Voice_Changer_Oldman

老人。

AliRtcSdk_AudioEffect_Voice_Changer_Babyboy

男孩。

AliRtcSdk_AudioEffect_Voice_Changer_Babygirl

女孩。

AliRtcSdk_AudioEffect_Voice_Changer_Robot

机器人。

AliRtcSdk_AudioEffect_Voice_Changer_Daimo

大魔王。

AliRtcSdk_AudioEffect_Voice_Changer_Ktv

KTV。

AliRtcSdk_AudioEffect_Voice_Changer_Echo

回声。

AliRtcSdk_AudioEffect_Voice_Changer_Dialect

方言。

AliRtcSdk_AudioEffect_Voice_Changer_Howl

怒吼。

AliRtcSdk_AudioEffect_Voice_Changer_Electronic

电音。

AliRtcSdk_AudioEffect_Voice_Changer_Phonograph

留声机。

AliRtcSdk_AudioEffect_Voice_Changer_MAX

占位符,无含义。

AliRtcAudioEffectReverbMode

音效混响模式。

枚举名

描述

AliRtcAudioEffectReverb_Off

关闭。

AliRtcAudioEffectReverb_Vocal_I

人声 I。

AliRtcAudioEffectReverb_Vocal_II

人声 II。

AliRtcAudioEffectReverb_Bathroom

澡堂。

AliRtcAudioEffectReverb_Small_Room_Bright

明亮小房间。

AliRtcAudioEffectReverb_Small_Room_Dark

黑暗小房间。

AliRtcAudioEffectReverb_Medium_Room

中等房间。

AliRtcAudioEffectReverb_Large_Room

大房间。

AliRtcAudioEffectReverb_Church_Hall

教堂走廊。

AliRtcAudioEffectReverbParamType

音效混响参数。

枚举名

描述

AliRtcAudioEffectReverb_Room_Size

房间大小,取值范围:[0,100]。

AliRtcAudioEffectReverb_Pre_Delay

预延时,单位:毫秒。取值范围:[0,200]。

AliRtcAudioEffectReverb_Revetberance

混响感,取值范围:[0,100]。

AliRtcAudioEffectReverb_Hf_Damping

消声,取值范围:[0,100]。

AliRtcAudioEffectReverb_Tone_Low

低音调,取值范围:[0,100]。

AliRtcAudioEffectReverb_Tone_High

高音调,取值范围:[0,100]。

AliRtcAudioEffectReverb_Dry_Gain

干增益,取值范围:[-20,10]。

AliRtcAudioEffectReverb_Wet_Gain

湿增益,取值范围:[-20,10]。

AliRtcAudioRouteType

语音路由。

枚举名

描述

AliRtcAudioRouteType_Default

默认的语音路由。

AliRtcAudioRouteType_Headset

耳机。

AliRtcAudioRouteType_Earpiece

听筒。

AliRtcAudioRouteType_HeadsetNoMic

不带麦的耳机。

AliRtcAudioRouteType_Speakerphone

手机扬声器。

AliRtcAudioRouteType_LoudSpeaker

外接扬声器。

AliRtcAudioRouteType_BlueTooth

蓝牙耳机。

AliRtcRemoteTextureInfo

远端用户纹理信息。

参数

类型

描述

aliVideoCanvas

AliRtcVideoCanvas

渲染画布。

userId

String

远端用户ID。

videoTrack

int

视频流类型。

AliRtcVideoCanvas

渲染画布。

参数

类型

描述

textureId

int

视频数据纹理类型ID。

textureWidth

int

纹理宽。

textureHeight

int

纹理高。

sharedContext

long

opengl的线程相关上下文变量。

enableBeauty

boolean

是否开启美颜。取值:

  • true:开启。

  • false:未开启。

默认值为false。

view

View

视频显示视窗。必须是通过createRenderSurfaceView

接口创建出来的SurfaceView渲染视图,或者createRenderTextureView

创建出来的TextureView渲染视图。

renderMode

AliRtcRenderMode

视图渲染模式,默认AliRtcRenderModeAuto。

mirrorMode

AliRtcRenderMirrorMode

视图镜像模式,默认AliRtcRenderMirrorModeOnlyFront。

rotationMode

AliRtcRotationMode

视图旋转角度,默认AliRtcRotationMode_0。

backgroundColor

int

视图背景颜色。

AliRtcMpuState

旁路转推任务状态。

枚举名

描述

AliRtcMpuStateStart

旁路任务启动。

AliRtcMpuStateUpdate

旁路任务更新。

AliRtcMpuStateStop

旁路任务停止。

AliRtcMpuStateEnd

旁路任务结束。

AliRtcMpuStateConnect

旁路任务连接中。

AliRtcMpuStateRunning

旁路任务正在运行。

AliRtcMpuStateRecovering

旁路任务重新恢复。

AliRtcMpuStateFailed

旁路任务失败。

AliRtcMpuStateUnknow

旁路任务未知状态。

AliRtcRectPosition

水印图片的位置和大小。

参数名

类型

描述

x

float

左上角的横向偏移。

y

float

左上角的纵向偏移。

width

float

水印图片的宽。

height

float

水印图片的高。

AliRtcWatermarkConfig

水印图片的设置选项。

参数名

类型

描述

visibleInPreview

boolean

设置是否将水印设为预览时本地可见。

positionInLandscapeMode

AliRtcRectPosition

横屏时的水印坐标。

positionInPortraitMode

AliRtcRectPosition

竖屏时的水印坐标。

alpha

float

透明度。

normalized

boolean

归一化。

AliRtcTextureInfo

纹理信息。

参数

类型

描述

textureId

int

纹理ID。

mirrorMode

AliRtcRenderMirrorMode

镜像模式。

AliEngineCameraCapturerConfiguration

相机采集偏好属性。

参数

类型

描述

preference

AliRtcCaptureOutputPreference

采集偏好。

cameraDirection

AliRtcCameraDirection

相机方向(只支持AndroidiOS)。

fps

int

说明使用encoderfps,默认是内部fps15

cameraCaptureProfile

AliRtcCameraCaptureProfile

指定视频采集的特定分辨率

disableVideoCaptureReverse

int

不根据纵横比设置翻转采集视频帧设置

captureObserverOriginal

int

是否回调原始的videoframe数据

textureEncode

int

是否使用纹理编码

cameraTextureCapture

int

摄像头是否开启纹理采集

AliRtcCaptureOutputPreference

摄像头采集偏好。

枚举名

描述

CAPTURER_OUTPUT_PREFERENCE_AUTO

自动调整采集参数。

CAPTURER_OUTPUT_PREFERENCE_PERFORMANCE

优先保证设备性能,根据setVideoProfile设置参数选择最接近的摄像头输出参数。

CAPTURER_OUTPUT_PREFERENCE_PREVIEW

优先保证视频预览质量,选择较高的摄像头输出参数。

AliRtcCameraDirection

摄像头方向。

枚举名

描述

CAMERA_INVALID

无效。

CAMERA_REAR

使用后置摄像头。

CAMERA_FRONT

使用前置摄像头。

AliRtcCameraCaptureProfile

指定视频采集的特定分辨率。

枚举名

描述

ALIRTC_CAMERA_CAPTURER_PROFILE_DEFAULT

默认。

ALIRTC_CAMERA_CAPTURER_PROFILE_1080P

视频1080P使用,开启后摄像头使用1080P分辨率采集。

AliRtcVideoEncoderFrameRate

视频编码帧率。

枚举名

描述

AliRtcVideoEncoderFrameRate_FPS_5

5 FPS。

AliRtcVideoEncoderFrameRate_FPS_10

10 FPS。

AliRtcVideoEncoderFrameRate_FPS_15

15 FPS。

AliRtcVideoEncoderFrameRate_FPS_20

20 FPS。

AliRtcVideoEncoderFrameRate_FPS_30

30 FPS。

AliRtcVideoEncoderBitrate

视频编码码率。

枚举名

描述

AliRtcVideoEncoderStandardBitrate

标准码率模式。

AliRtcVideoEncoderMirrorMode

编码视频镜像模式。

枚举名

描述

AliRtcVideoEncoderMirrorModeDisabled

编码视频镜像。

AliRtcVideoEncoderMirrorModeEnabled

编码视频不镜像。

AliRtcVideoEncoderOrientationMode

编码视频旋转模式。

枚举名

描述

AliRtcVideoEncoderOrientationModeAdaptive

自适应,和采集视频角度保持一致。

AliRtcVideoEncoderOrientationModeFixedLandscape

固定横屏。

AliRtcVideoEncoderOrientationModeFixedPortrait

固定竖屏。

AliRtcVideoDimensions

视频分辨率。

参数名

类型

描述

width

int

视频宽度。

height

int

视频高度。

AliRtcVideoEncoderConfiguration

视频编码偏好。

参数名

类型

描述

dimensions

AliRtcVideoDimensions

视频分辨率,视频分辨率,默认值640x480,最大值1920x1080。

frameRate

int

视频编码帧率,默认值15, 最大值30。

bitrate

int

视频编码码率(kbps),默认值为 512。设置为0表示由SDK内部根据视频分辨率和码率计算合适的编码码率。

码率设置应根据分辨率和帧率有对应的合理范围,该值设置在合理范围内有效,否则SDK会自动调节码率到有效值。

minBitrate

NSInteger

最小视频编码码率(Kbps),默认值为0。

keyFrameInterval

int

关键帧间隔,单位毫秒。默认值0,表示SDK内部控制关键帧间隔。

forceStrictKeyFrameInterval

boolean

是否强制编码器严格按照设置的关键帧间隔产生关键帧,默认值false。

  • false:表示编码器会响应他人入会等关键帧请求,关键帧间隔和设置的值不严格匹配。

  • true:表示编码器不响应其他关键帧请求,严格按照设置的值产生关键帧。可能会造成订阅者首帧变慢。

mirrorMode

AliRtcVideoEncoderMirrorMode

编码视频镜像模式。

orientationMode

AliRtcVideoEncoderOrientationMode

编码视频旋转模式。

rotationMode

AliRtcRotationMode

视频旋转角度。

codecType

AliRtcVideoCodecType

编解码器类型。

encodeCodecType

AliRtcVideoEncodeCodecType

视频编码类型。

seiForceFrontIFrame

int

SEI发送前强制I帧。

-1表示使用默认值,0表示不强制,1表示强制(默认值)。

enableDynamicEncode

int

启用动态编码。

同时创建硬件编码和软件编码,在硬件编码器出问题之后降级到软件编码,-1表示使用默认值,0表示不同时创建两种编码,1表示创建两种编码。

disableDipenseResolutionChange

int

关闭QoS降低分辨率能力。

QoS探测到实时带宽下降不足以当前方分辨率进行编码,降低视频编码分辨率;

-1表示使用默认值,0表示允许降低,1表示不允许QoS降低分辨率。

enableDowngrade

int

允许QoS根据实际探测带宽降低视频编码码流。

-1表示使用默认值,0表示不允许降低编码码流大小,1允许降低编码码流大小。

enableH264BFrame

int

是否打开h264 B帧支持。

-1表示使用默认值,0表示不打开B帧支持,1表示打开B帧支持。

重要

开启该项之后,必须解码端同步开启B帧支持。

enableHevcBFrame

int

是否打开hevc B帧支持。

-1表示使用默认值,0表示不打开B帧支持,1表示打开B帧支持。

重要

开启该项之后,必须解码端同步开启B帧支持。

AliRtcVideoCodecType

视频编解码类型。

枚举名

描述

AliRtcVideoCodecTypeDefault

未设置,使用默认值(硬件编码)

AliRtcVideoCodecTypeSoftware

软件视频编解码器

AliRtcVideoCodecTypeHardware

硬件视频编解码器

AliRtcVideoCodecTypeHardwareTexture

硬件纹理编解码器

AliRtcVideoDecoderConfiguration

视频解码器设置。

参数

类型

描述

codecType

AliRtcVideoCodecType

编解码器类型

默认值是AliRtcVideoCodecTypeDefault,使用系统默认设置,

enableDecoderBframe

int

是否启用解码器B

默认设置是-1,不启用B帧为0,启用B帧设置为1,

textureBindContext

int

是否支持纹理解码绑定上下文

默认设置是-1,不启用设置为0,启用降级逻辑设置为1;

AliRtcVideoEncodeCodecType

编码器类型。

枚举名

描述

AliRtcVideoEncodeCodecTypeDefault

未设置,使用默认值(目前为h264)

AliRtcVideoEncodeCodecTypeH264

h264编码

AliRtcVideoEncodeCodecTypeHevc

hevc编码

AliRtcScreenShareEncoderConfiguration

屏幕编码偏好。

参数名

类型

描述

dimensions

AliRtcVideoDimensions

视频分辨率。

frameRate

int

视频编码帧率。

bitrate

int

视频编码码率。

rotationMode

AliRtcRotationMode

推流旋转角度。

keyFrameInterval

int

关键帧间隔,单位毫秒。默认值0,表示SDK内部控制关键帧间隔。

forceStrictKeyFrameInterval

boolean

是否强制编码器严格按照设置的关键帧间隔产生关键帧。默认值false。

  • false:表示编码器会响应他人入会等关键帧请求,关键帧间隔和设置的值不严格匹配。

  • true:表示编码器不响应其他关键帧请求,严格按照设置的值产生关键帧。可能会造成订阅者首帧变慢。

AliRtcAuthInfo

鉴权信息。

参数名

类型

描述

channelId

String

频道ID。

userId

String

用户ID。

appId

String

应用ID。

nonce

String

随机串。

timestamp

long

时间戳。

token

String

令牌。

AliRtcLiveTranscoding

旁路直播配置。

参数名

类型

描述

mMixMode

int

混流模式。取值:

  • 0:单路转推,不混流转码仅转推原始单路流,无需配置混流转码参数。

  • 1:混流转码,支持混流转码输出。

默认值为1。

mLayoutIds

List<String>

布局ID数组。

mSubSpecUsers

List<TranscodingUser>

指定混流用户列表。

mUserPanes

List<TranscodingUserPane>

用户窗格列表。

mLayouts

List<TranscodingLayout>

用户自定义布局列表。

mTaskProfile

String

任务计费配置。

mBackgroundColor

int

背景色RGB,默认值为0(黑色)。计算公式为R + G × 256 + B × 65536,R(红)、G(绿)、B(蓝)的取值范围:0~255。

mMediaEncode

int

编码选项。

mCropMode

int

视频的裁剪方式。取值:

  • 1:保持比例裁剪。

  • 2:保持比例留边。

默认值为2。

mStreamType

int

单路转推模式下转推音频流。取值:

  • 0:转推原始流。

  • 1:仅转推音频流。

  • 2:仅转推视频流。

默认值为0。

mSourceType

String

单路转推模式下用户视频输入流。取值:

  • camera:摄像头。

  • shareScreen:屏幕共享。

mExternalParam

String

拓展字段。

AliRtcRemoteUserInfo

远端用户信息。

参数名

类型

描述

userID

String

远端用户的ID。

sessionID

String

远端用户的会话ID。

displayName

String

远端用户的名称。

muteAudioPlaying

boolean

本端是否静音了此远端用户。

isOnline

boolean

远端用户是否在线。

cameraCanvas

AliRtcVideoCanvas

相机流画布。

screenCanvas

AliRtcVideoCanvas

屏幕流画布。

hasAudio

boolean

远端用户是否推送了音频流。

hasCameraMaster

boolean

远端用户是否推送了相机大流。

hasCameraSlave

boolean

远端用户是否推送了相机小流。

hasScreenSharing

boolean

远端用户是否推送了屏幕流。

subScribedAudio

boolean

本端是否拉到了此远端用户的音频流。

subScribedCamearSlave

boolean

本端是否拉到了此远端用户的相机小流。

subScribedCameraMaster

boolean

本端是否拉到了此远端用户的相机大流。

subScribedScreenSharing

boolean

本端是否拉到了此远端用户的屏幕流。

requestAudio

boolean

本端是否订阅了此远端用户的音频流。

requestCameraSlave

boolean

本端是否订阅了此远端用户的相机小流。

requestCameraMaster

boolean

本端是否订阅了此远端用户的相机大流。

requestScreenSharing

boolean

本端是否订阅了此远端用户的屏幕流。

preferCameraMaster

boolean

远端用户是否开启了大流优先。

hasCameraView

boolean

本端是否设置了此远端用户相机流的view。

hasScreenView

boolean

本端是否设置了此远端用户屏幕流的view。

AliRtcVideoReason

触发视频流状态变化的原因。

枚举名

描述

AliRTCVideoChangedByClient

客户端。

AliRTCVideoChangedByServer

服务器。

AliRtcVideoState

视频流状态变化。

枚举名

描述

AliRtcVideoVideoClose

关闭视频流。

AliRtcVideoVideoOpen

恢复视频流。

AliRtcTrascodingPublishTaskStatus

旁路直播推流任务状态。

枚举名

描述

AliRtcTrascodingPublishTaskStatusStart

旁路直播推流任务开始。

AliRtcTrascodingPublishTaskStatusUpdate

旁路直播推流任务更新。

AliRtcTrascodingPublishTaskStatusStop

旁路直播推流任务停止。

AliEngineLiveTranscodingErrorCode

旁路直播推流错误码。

枚举名

描述

AliEngineLiveTranscodingErrorPublishOk

旁路直播准备完成。

AliEngineLiveTranscodingErrorStreamNotFound

旁路直播推流地址未找到。

AliEngineLiveTranscodingErrorStreamAlreadyExist

请求的流已存在,无法重复创建。

AliEngineLiveTranscodingErrorInvalidParam

输入参数不符合规范(如格式错误、缺失等)。

AliEngineLiveTranscodingErrorInternalError

SDK 内部发生未知错误。

AliEngineLiveTranscodingErrorRtmpServerError

RTMP 服务器返回错误(如连接失败、认证失败)。

AliEngineLiveTranscodingErrorRtmpStreamUrlError

RTMP 流地址格式不正确(如缺少协议头、域名错误)。

AliEngineLiveTranscodingErrorPublishTimeout

旁路推流操作在指定时间内未完成。

AliEngineLiveTranscodingErrorNotAuthorized

用户无权限执行当前操作(如 Token 无效或过期)。

AliRtcLiveTranscodingState

旁路直播状态。

枚举名

描述

AliRtcLiveTranscodingState_IDLE

推流空闲。

AliRtcLiveTranscodingState_CONNNECT

正在连接推流服务器。

AliRtcLiveTranscodingState_RUNNING

推流正在进行。

AliRtcLiveTranscodingState_RECOVERING

正在恢复推流。

AliRtcLiveTranscodingState_FAILURE

推流失败。

AliRtcLiveTranscodingState_END

推流结束。

AliRtcLiveTranscodingMediaProcessMode

旁路直播媒体处理模式。

枚举名

描述

AliRtcLiveTranscodingNormal

通用模式。

AliRtcLiveTranscodingVirtualBackground

虚拟背景模式。

AliRtcLiveTranscodingCropMode

旁路直播裁剪模式。

枚举名

描述

AliRtcLiveTranscodingCrop

保持比例裁剪。

AliRtcLiveTranscodingFill

保持比例留边(默认值)。

AliRtcLiveTranscodingFontType

旁路直播字体。

枚举名

描述

NOTO_SERIF_CJKSC_REGULAR

思源宋体NotoSerifCJKsc-REGULAR。

ALIBABA_PUHUITI_REGULAR

阿里巴巴-普惠体-REGULAR。

ALIBABA_PUHUITI_BOLD

阿里巴巴-普惠体-BOLD。

ALIBABA_PUHUITI_Heavy

阿里巴巴-普惠体-Heavy。

ALIBABA_PUHUITI_LIGHT

阿里巴巴-普惠体-LIGHT。

ALIBABA_PUHUITI_MEDIUM

阿里巴巴-普惠体-MEDIUM。

AliRtcLiveTranscodingSegmentType

旁路直播输入类型。

枚举名

描述

AliRtcLiveTranscodingNoBody

无人像分割。

AliRtcLiveTranscodingBody

人像分割。

AliRtcLiveTranscodingAudioSampleRate

旁路直播音频采样率。

枚举名

描述

AliRtcLiveTranscoding_HZ_48000

采样率48000Hz。

AliRtcLiveTranscoding_HZ_44100

采样率44100Hz。

AliRtcLiveTranscoding_HZ_32000

采样率32000Hz。

AliRtcLiveTranscoding_HZ_16000

采样率16000Hz。

AliRtcLiveTranscoding_HZ_8000

采样率8000Hz。

AliRtcLiveTranscodingTaskProfile

旁路直播计费规格。

枚举名

描述

AliRtcLiveTranscoding_Profile_1IN_1080P

1IN_1080P。

AliRtcLiveTranscoding_Profile_1IN_720P

1IN_720P。

AliRtcLiveTranscoding_Profile_1IN_360P

1IN_360P。

AliRtcLiveTranscoding_Profile_2IN_1080P

2IN_1080P。

AliRtcLiveTranscoding_Profile_2IN_720P

2IN_720P。

AliRtcLiveTranscoding_Profile_2IN_360P

2IN_360P。

AliRtcLiveTranscoding_Profile_4IN_1080P

4IN_1080P。

AliRtcLiveTranscoding_Profile_4IN_720P

4IN_720P。

AliRtcLiveTranscoding_Profile_4IN_360P

4IN_360P。

AliRtcLiveTranscoding_Profile_9IN_1080P

9IN_1080P。

AliRtcLiveTranscoding_Profile_9IN_720P

9IN_720P。

AliRtcLiveTranscoding_Profile_9IN_360P

9IN_360P。

AliRtcLiveTranscoding_Profile_12IN_1080P

12IN_1080P。

AliRtcLiveTranscoding_Profile_12IN_720P

12IN_720P。

AliRtcLiveTranscoding_Profile_12IN_360P

12IN_360P。

AliRtcLiveTranscoding_Profile_16IN_1080P

16IN_1080P。

AliRtcLiveTranscoding_Profile_16IN_720P

16IN_720P。

AliRtcLiveTranscoding_Profile_16IN_360P

16IN_360P。

AliRtcLiveTranscoding_Profile_Mixed

纯音频。

AliRtcLiveTranscodingSourceType

旁路直播视频流类型。

枚举名

描述

AliRtcLiveTranscodingCamera

摄像头。

AliRtcLiveTranscodingShareScreen

屏幕共享。

AliRtcLiveTranscodingStreamType

旁路直播转推流类型。

枚举名

描述

AliRtcLiveTranscodingOrigin

转推原始流。

AliRtcLiveTranscodingAudio

仅转推音频流。

AliRtcLiveTranscodingVideo

仅转推视频流。

AliRtcLiveTranscodingMixMode

旁路直播模式。

枚举名

描述

AliRtcLiveTranscodingSINGLE

单路转推,不混流转码,仅转推原始单路流,无需配置混流转码参数。

AliRtcLiveTranscodingMIX

混流转码(默认值),支持混流转码输出。

AliRtcVideoObserAlignment

裸数据回调数据对齐类型。

枚举名

描述

AliRtcAlignmentDefault

不处理,直接原始数据回调。

AliRtcAlignmentEven

宽处理成偶数。

AliRtcAlignment4

宽处理成4的倍数。

AliRtcAlignment8

宽处理成8的倍数。

AliRtcAlignment16

宽处理成16的倍数。

AliRtcLiveTranscodingEncodeParam

旁路直播编码参数。

参数

类型

描述

videoWidth

int

宽。

videoHeight

int

高。

videoFramerate

int

帧率。

videoBitrate

int

码率。

videoGop

int

GOP。

videoCodec

AliRtcLiveTranscodingVideoCodec

编码器类型,H264/H265。

audioSamplerate

AliRtcLiveTranscodingAudioSampleRate

旁路直播音频采样率。

audioBitrate

int

音频码率。

audioChannels

int

音频声道数。

AliRtcLiveTranscodingMixParam

旁路直播混流参数。

参数

类型

描述

taskProfile

AliRtcLiveTranscodingTaskProfile

旁路直播计费规格。

encodeParam

AliRtcLiveTranscodingEncodeParam

旁路直播编码参数。

users

List<TranscodingUser>

旁路直播用户列表。

backgroundColor

int

背景色。

backgrounds

List<TranscodingImage>

背景图片列表。

watermarks

List<TranscodingImage>

水印图片列表。

clockWidgets

List<TranscodingClockWidget>

时钟小部件列表。

cropMode

AliRtcLiveTranscodingCropMode

旁路直播裁剪模式。

mediaProcessMode

AliRtcLiveTranscodingMediaProcessMode

旁路直播媒体处理模式。

AliRtcLiveTranscodingParam

旁路直播参数。

参数

类型

描述

mixMode

AliRtcLiveTranscodingMixMode

旁路直播模式。

singleParam

AliRtcLiveTranscodingSingleParam

旁路直播单流参数。

mixParam

AliRtcLiveTranscodingMixParam

旁路直播混流参数。

AliRtcLiveTranscodingSingleParam

旁路直播单流参数。

参数

类型

描述

userId

String

用户ID。

streamType

AliRtcLiveTranscodingStreamType

旁路直播转推流类型。

sourceType

AliRtcLiveTranscodingSourceType

旁路直播视频流类型。

TranscodingClockWidget

旁路直播时钟小工具。

参数

类型

描述

mX

int

坐标X(像素)。

mY

int

坐标Y(像素)。

mFontSize

int

旁路直播字体大小。

mZorder

int

叠放顺序,0为最底层,1层在0层之上,以此类推。

mFontColor

int

旁路直播字体颜色。

mFontType

AliRtcLiveTranscodingFontType

旁路直播字体。

TranscodingUser

旁路直播用户信息。

参数

类型

描述

mUserId

String

用户ID。

x

int

坐标X(像素)。

y

int

坐标Y(像素)。

width

int

窗格宽。

height

int

窗格高。

zOrder

int

叠放顺序,0为最底层,1层在0层之上,以此类推。

streamType

AliRtcLiveTranscodingStreamType

旁路直播转推流模式。

sourceType

AliRtcLiveTranscodingSourceType

旁路直播视频流类型。

segmentType

AliRtcLiveTranscodingSegmentType

旁路直播输入类型。

images

List<TranscodingImage>

图片列表。

texts

List<TranscodingText>

文本列表。

TranscodingText

旁路直播文本信息。

参数

类型

描述

mText

String

文本信息。

mX

int

坐标X(像素)。

mY

int

坐标Y(像素)。

mFontSize

int

字体大小。

mZorder

int

叠放顺序,0为最底层,1层在0层之上,以此类推。

mFontColor

int

字体颜色。

mFontType

AliRtcLiveTranscodingFontType

旁路直播字体。

TranscodingImage

旁路直播图片信息。

参数

类型

描述

mUrl

String

图片URL。

mAlpha

float

透明度。0.0表示透明,1.0表示完全不透明。

mDisplay

DisplayType

图片显示。

mX

int

坐标X(像素)。

mY

int

坐标Y(像素)。

mWidth

int

窗格宽。

mHeight

int

窗格高。

mZorder

int

叠放顺序,0为最底层,1层在0层之上,以此类推。

DisplayType

图片显示模式。

枚举名

描述

NOT_DISPLAY

不显示。

ALWAYS

总是显示。

WHEN_NO_VIDEO

没有视频时显示。

AliRtcScreenShareMode

枚举名

描述

AliRtcScreenShareNoneMode

不共享。

AliRtcScreenShareOnlyVideoMode

共享视频流。

AliRtcScreenShareOnlyAudioMode

共享APP音频流。

AliRtcScreenShareAllMode

共享所有音视频流。

AliCapabilityProfile

功能聚合参数,入会参数中使用。

枚举名

描述

AliCapabilityProfileDefault

默认值, 无特殊要求。

AliCapabilityProfileAiHuman

AI agent通话场景下, 真实用户的功能配置。

AliCapabilityProfileAiRobot

AI agent通话场景下, 机器人的功能配置。

AliRTCSdkChannelParam

入会参数。

参数

类型

描述

channelId

String

房间频道号。

userId

String

入会用户名。

userName

String

任意用于显示的用户名称,不是User ID;可以不传,标识没有userName。

capabilityProfile

AliCapabilityProfile

用户属性,需要在AI agent通话场景下特殊配置, 非AI agent通话场景使用默认值。

AlirtcNetworkQualityProbeConfig

网络探测的参数配置。

参数

类型

描述

probeUplink

boolean

是否探测上行带宽,默认false。

probeDownlink

boolean

是否探测下行带宽,默认false,暂不支持 。

expectedUplinkBitrateKbps

int

上行带宽探测的峰值,单位Kbps,默认1000。

expectedDownlinkBitrateKbps

int

下行带宽探测的峰值,单位Kbps。暂不支持, 默认1000。

AlirtcNetworkQualityProbeResult

网络探测的结果。

参数

类型

描述

rtt

int

链路的RTT,单位ms。

uplinkPacketLossRate

int

探测上行网络的丢包率,最大值100%。

upLinkJitter

int

探测上行网络的jitter,单位ms。

upLinkAvailableBandwidth

int

上行网络带宽,单位kbps。

downLinkPacketLossRate

int

探测下行网络的丢包率,最大值100%,暂不支持。

downLinkJitter

int

探测下行网络的jitter,单位ms,暂不支持。

downLinkAvailableBandwidth

int

下行网络带宽,单位kbps,暂不支持。

AliRtcVideoPipelineMirrorMode

视频流镜像模式。

枚举名

描述

AliRtcVideoPipelineMirrorModeNoMirror

预览和编码均关闭镜像。

AliRtcVideoPipelineMirrorModeBothMirror

预览和编码均打开镜像。

AliRtcVideoPipelineMirrorModeOnlyPreviewMirror

仅预览打开镜像。

AliRtcVideoPipelineMirrorModeOnlyPublishMirror

仅推流打开镜像。

AliRtcCapturePipelineScaleMode

视频缩放时机。

枚举名

描述

AliRtcCapturePipelineScaleModePre

采集后立即进行缩放,默认。

AliRtcCapturePipelineScaleModePost

编码时进行缩放。

AliRtcAudioFrame

音频裸数据。

参数名

类型

描述

dataPtr

long

音频数据native指针。

data

byte[]

音频数据。

numSamples

int

采样点数。

bytesPerSample

int

每个采样点字节数。

numChannels

int

声道数。

samplesPerSec

int

每秒采样数。

AliRtcAudioSource

音频订阅类型。

枚举名

描述

AliRtcAudioSourceCaptured

采集的音频数据。

AliRtcAudioSourceProcessCaptured

3A后的音频数据。

AliRtcAudioSourcePub

推流的音频数据。

AliRtcAudioSourcePlayback

播放的音频数据。

AliRtcAudioSourceMixedAll

推流和播放混音后的音频数据。

AliRtcAudioSourceRemoteUser

拉流的远端音频数据。

AliRtcAudioFrameObserverConfig

音频数据回调设置。

参数

类型

描述

sampleRate

AliRtcAudioSampleRate

回调音频采样率枚举,默认为AliRtcAudioSampleRate_48000。

channels

AliRtcAudioNumChannel

回调音频声道数,支持单声道和双声道,默认值为单声道(AliRtcMonoAudio)。

mode

AliRtcAudioFrameObserverOperationMode

回调模式,包含只读模式(0),只写模式(1),读写模式(2)。默认值为只读模式(AliRtcAudioDataObserverOperationModeReadOnly)。

userDefinedInfo

int

用户自定义参数,用于设置onMixedAllAudioFrame 回调的混流模式,默认混外部渲染的音频(AliRtcAudioFrameObserverUserDefinedInfoBitMaskMixExRender)。

AliRtcAudioFrameObserverOperationMode

回调音频数据读写模式。

枚举名

描述

AliRtcAudioDataObserverOperationModeReadOnly

只读模式。

AliRtcAudioDataObserverOperationModeWriteOnly

只写模式。

AliRtcAudioDataObserverOperationModeReadWrite

读写模式。

AliRtcAudioFrameObserverUserDefinedInfoBitMask

音频数据回调自定义参数。

枚举名

描述

AliRtcAudioFrameObserverUserDefinedInfoBitMaskMixExCapture

onMixedAllAudioFrame回调混外部推流的音频。

AliRtcAudioFrameObserverUserDefinedInfoBitMaskMixExRender

onMixedAllAudioFrame回调混外部渲染的音频。

AliRtcOrientationMode

设备方向枚举。

枚举名

描述

AliRtcOrientationModePortrait

固定竖屏模式

AliRtcOrientationModeLandscapeLeft

固定左横屏模式

AliRtcOrientationModePortraitUpsideDown

固定倒立模式

AliRtcOrientationModeLandscapeRight

固定右横屏模式

AliRtcOrientationModeAuto

自适应模式

AliRtcAudioAccompanyErrorCode

音乐伴奏播放错误码。

枚举值

描述

AliRtcAudioAccompanyNoError(0)

没有错误,正常播放。

AliRtcAudioAccompanyOpenFailed(-100)

打开音频文件失败(如路径无效、权限不足、文件损坏)。

AliRtcAudioAccompanyDecodeFailed(-101)

解码音频文件失败(如格式不支持、编码错误)。

AliRtcAudioAccompanyConfig

伴奏播放的配置项

属性

类型

描述

onlyLocalPlay

boolean

是否只本地播放,默认值:false。

replaceMic

boolean

是否替换掉MIC,默认值:false。

loopCycles

int

循环次数,可以设置-1(无限循环)或者>0的正整数次,其他值无效,默认值:-1。

startPosMs

long

起播位置,单位:ms,默认值:0。

publishVolume

int

推流音量,取值范围[0-100],默认值:50。

playoutVolume

int

播放音量,取值范围[0-100],默认值:50。

AliRtcExternalAudioStreamConfig

外部音频流配置。

参数名

类型

描述

channels

int

声道数,默认值:1。

sampleRate

int

采样率,默认值:48000,支持的采样率 8000, 12000, 16000, 24000, 32000, 44100, 48000, 96000。

playoutVolume

int

播放音量,取值范围[0-100],默认值:50。

publishVolume

int

推流音量,取值范围[0-100],默认值:50。

publishStream

int

指定绑定的音频流。

  • 0:MIC流。

  • 1:第二音频流。

enable3A

boolean

输入PCM 音频是否做3A处理,默认为 false。

AliRtcDataChannelMsg

数据通道消息。

参数名

类型

描述

type

AliRtcDataMsgType

数据通道消息的类型,使用时建议设置为AliEngineDataMsgCustom。

networkTime

long

发送消息时ntp时间,仅AliEngineDataMsgMusicProgress 时使用,仅在 KTV 场景使用,其他场景不需要设置。

progress

int

当天进度,单位毫秒,仅AliEngineDataMsgMusicProgress 时使用,仅在 KTV 场景使用,其他场景不需要设置。

data

byte[]

消息内容,可以是任意数据,包括文字、图片等。

AliRtcDataMsgType

数据通道消息类型。

枚举名

描述

AliEngineDataMsgNone

无消息。

AliEngineDataMsgMusicProgress

KTV 场景使用。

AliEngineDataMsgCustom

普通消息,其他场景建议设置为此类型。

AliRtcVideoExternalEncoderParameter

网络变化反馈参数结构体。

参数

类型

描述

width

int

宽度

height

int

高度

frame_rate

int

帧率

bitrate_bps

int

码率(单位:bps)。

AliRtcVideoEncodedFrameType

Qos反馈外置编码器请求帧类型。

枚举名

描述

AliRtcVideoEncodedFrameNULL(0)

无。

AliRtcVideoEncodedFrameIDR(1)

IDR 帧。

AliRtcVideoEncodedFrameLTR(2)

LTR 帧。

AliRtcVideoEncodedFrameB(3)

B 帧。

AliRtcAudioAccompanyStateCode

音乐伴奏播放状态。

枚举名

描述

AliRtcAudioAccompanyStarted(100)

伴奏开始播放。

AliRtcAudioAccompanyStopped (101)

伴奏停止播放。

AliRtcAudioAccompanyPaused(102)

伴奏暂停。

AliRtcAudioAccompanyResumed(103)

伴奏从暂停状态恢复播放。

AliRtcAudioAccompanyEnded(104)

伴奏播放完毕(正常结束)。

AliRtcAudioAccompanyBuffering(105)

伴奏正在缓冲(适用于网络流或大文件)。

AliRtcAudioAccompanyBufferingEnd(106)

缓冲结束,进入正常播放。

AliRtcAudioAccompanyFailed(107)

伴奏播放失败(需结合 errorCode 判断具体原因)。

AliRtcAudioFileInfo

音频文件信息。

参数

类型

描述

filePath

String

音频文件路径.

durationMs

long

音频文件时长,单位:ms。

AliRtcEngineLocalDeviceType

本地设备类型。

枚举名

描述

AliEngineLocalDeviceTypeUnknown

未知设备类型。

AliEngineLocalDeviceTypeMic

麦克风设备。

AliEngineLocalDeviceTypeSpeaker

扬声器设备。

AliEngineLocalDeviceTypeAudioDevice

音频设备。

AliEngineLocalDeviceTypeCamera

摄像头设备。

AliEngineLocalDeviceTypeDisplay

显示设备。

AliEngineLocalDeviceTypeVideoDevice

视频设备。