数据结构

通过阅读本文,您可以了解Mac SDK涉及的数据类型。

目录

数据类型

描述

AliRtcUserVolumeInfo

用户音量信息。

AliRtcAudioDataSample

音频样本。

AliRtcVideoDataSample

视频样本。

AliRtcChannelProfile

频道模式。

AliRtcClientRole

用户角色。

AliRtcStats

会话数据统计信息。

AliRtcLocalVideoStats

本地视频统计信息。

AliRtcRemoteVideoStats

远端视频统计信息。

AliRtcLocalAudioStats

本地音频统计信息。

AliRtcRemoteAudioStats

远端音频统计信息。

AliRtcVideoObserPosition

视频数据输出位置。

AliRtcVideoFormat

视频数据格式。

AliRtcExternalDeviceType

外接设备类型。

AliRtcExternalDeviceState

外接设备状态。

AliRtcConnectionStatus

网络连接状态。

AliRtcConnectionStatusChangeReason

网络连接状态变更原因。

AliRtcVideoTrack

视频流类型。

AliRtcPublishState

推流状态。

AliRtcSubscribeState

订阅状态。

AliRtcUserOfflineReason

用户离线原因。

AliRtcVideoStreamType

相机流类型。

AliRtcAudioTrack

音频流类型。

AliRtcNetworkQuality

网络质量。

AliRtcRenderMode

渲染模式。

AliRtcRenderMirrorMode

镜像模式。

AliRtcRotationMode

旋转角度。

AliRtcLogLevel

日志级别。

AliRtcAudioNumChannel

音频声道数。

AliRtcAudioSampleRate

录制音频采样率。

AliRtcRecordType

录制类型。

AliRtcRecordFormat

录制格式

AliRtcAudioQuality

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

AliRtcVideoQuality

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

AliRtcVideoCodecType

视频编解码器类型。

AliRtcVideoEncodeCodecType

视频编码类型。

AliRtcTranportAudioQuality

音频质量。

AliRtcAudioProfile

音频质量模式。

AliRtcAudioScenario

音频场景模式参数。

AliRtcMuteLocalAudioMode

本地静音模式。

AliRtcRecordAudioConfig

录制音频设置。

AliRtcRecordVideoConfig

录制视频设置。

AliRtcRecordVideoCanvasConfig

录制视频设置的画布大小。

AliRtcDeviceInfo

设备信息。

AliRtcOnByeType

OnBye类型枚举。

AliRtcAudioEffectVoiceChangerMode

变声音效模式。

AliRtcAudioEffectReverbMode

音效混响模式。

AliRtcAudioEffectReverbParamType

音效混响参数。

AliVideoCanvas

渲染画布。

AliRtcTrascodingLiveStreamErrorCode

旁路推流错误码。

AliRtcWatermarkConfig

水印图片的设置。

AliRtcCameraCapturerConfiguration

相机采集偏好属性。

AliRtcCameraCaptureProfile

指定摄像头采集分辨率。

AliRtcCaptureOutputPreference

摄像头采集偏好。

AliRtcVideoEncoderFrameRate

视频编码帧率。

AliRtcVideoEncoderBitrate

视频编码码率。

AliRtcVideoEncoderMirrorMode

编码视频镜像模式。

AliRtcVideoEncoderOrientationMode

编码视频旋转模式。

AliRtcVideoEncoderConfiguration

视频编码偏好。

AliRtcScreenShareEncoderConfiguration

屏幕分享编码偏好。

AliRtcScreenShareConfig

屏幕分享配置。

AliRtcScreenShareRegion

屏幕分享区域。

AliRtcScreenSourceInfo

屏幕分享源信息。

AliRtcScreenShareInfo

屏幕分享配置信息。

AliRtcScreenShareType

屏幕分享类型。

AliRtcAuthInfo

鉴权信息。

AliRtcVideoSource

视频裸数据源类型。

AliRtcAudioSource

音频裸数据源类型。

AliRtcBufferType

视频数据类型。

AliRtcErrorCode

错误码。

AliRtcVideoObserAlignment

视频输出宽度对齐方式。

AliRtcShowDebugViewType

显示仪表盘类型。

AliRtcTrascodingLiveTaskStatus

旁路推流LiveStream状态。

AliRtcLiveTranscodingDisplayType

旁路直播图片显示类型。

AliRtcLiveTranscodingFontType

旁路直播文字类型。

AliRtcLiveTranscodingSegmentType

旁路直播输入类型。

AliRtcLiveTranscodingSourceType

旁路直播输入类型。

AliRtcVideoState

视频流状态变化。

AliRtcVideoReason

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

AliRtcLiveTranscodingCropMode

旁路直播裁剪模式。

AliRtcLiveTranscodingMediaProcessMode

旁路直播媒体处理模式。

AliRtcLiveTranscodingStreamType

旁路直播转推流类型。

AliRtcLiveTranscodingMixMode

旁路直播模式。

AliRtcLiveTranscodingState

旁路直播状态。

AliRtcLiveTranscodingText

旁路直播文本信息。

AliRtcLiveTranscodingImage

旁路直播图片信息。

AliRtcLiveTranscodingUser

旁路直播用户自定义流信息。

AliRtcLiveTranscodingParam

旁路直播配置。

AliRtcLiveTranscodingMixParam

旁路模式混流参数。

AliRtcLiveTranscodingSingleParam

旁路模式单路参数。

AliRtcLiveTranscodingTaskProfile

旁路直播计费规格。

AliRtcLiveTranscodingEncodeParam

旁路直播编码参数。

AliRtcLiveTranscodingAudioSampleRate

旁路直播音频采样率。

AliRtcLiveTranscodingClockWidget

旁路直播时钟小工具。

AliRtcNetworkQuality

网络质量。

AliRtcCapabilityProfile

功能聚合的profile,入会参数之一。

AliRtcChannelParam

入会参数。

AliRtcNetworkQualityProbeConfig

网络探测的参数配置。

AliRtcNetworkQualityProbeResult

网络探测的结果。

AliRtcAudioFrame

音频帧结构体。

AliRtcVideoPipelineMirrorMode:视频链路镜像类型。

视频链路镜像类型。

AliRtcCapturePipelineScaleMode:采集链路缩放类型。

采集链路缩放类型。

AliRtcAudioAccompanyConfig

音频伴奏播放配置。

AliRtcAudioFileInfo

音频文件信息。

AliRtcVideoDataSample

视频裸数据。

AliRtcDataChannelMsg

data消息定义。

AliRtcDataMsgType:data消息类型。

data消息类型。

AliRtcLocalDeviceType

本地设备类型。

AliRtcLocalDeviceExceptionType

当前设备异常类型。

AliRtcLocalAudioStateType

本地音频采集状态回调。

AliRtcLocalVideoStateType

本地视频采集状态回调。

AliRtcAudioAccompanyStateCode

音乐伴奏播放状态。

AliRtcAudioAccompanyErrorCode

音乐伴奏播放错误码。

AliRtcLiveTranscodingVideoCodec

旁路直播视频编码器。

详情

  • AliRtcUserVolumeInfo:用户音量信息。

参数

类型

描述

uid

NSString * _Nonnull

当前用户的UID,取值:

  • 0:表示本地。

  • 1:表示远端混音。

  • 其他:表示远端用户。

volume

int

当前回调的音量。

speech_state

BOOL

true表示正在说话,false表示没有说话。

  • AliRtcAudioDataSample:音频样本。

参数

类型

描述

dataPtr

long

音频数据指针。

numOfSamples

int

每个声道的采样点数。

bytesPerSample

int

每个采样点的字节数:对于PCM来说,一般使用16 bit,即两个字节。

numOfChannels

int

声道数量,取值:

  • 1:单声道。

  • 2:双声道。

samplesPerSec

int

每声道每秒的采样点数,即采样率。

  • AliRtcVideoDataSample:视频样本。

参数

类型

描述

format

AliRtcVideoFormat

视频数据格式。

type

AliRtcBufferType

视频数据类型。

pixelBuffer

CVPixelBufferRef _Nullable

pixelBuffer数据。

dataPtr

long

yuv数据指针。

dataYPtr

long

Y分量指针。

dataUPtr

long

U分量指针。

dataVPtr

long

V分量指针。

dataLength

long

数据大小。

strideY

int

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

strideU

int

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

strideV

int

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

stride

int

RGB类型的stride

height

int

视频帧的高。

width

int

视频帧的宽。

rotation

int

视频帧的旋转角度。

timeStamp

long long

时间戳。

encodeCostMs

int

编码耗时。

  • AliRtcChannelProfile:频道模式。

枚举名

描述

AliRtcCommunication

通信模式。

AliRtcInteractivelive

互动模式。

AliRtcInteractiveWithLowLatencyLive

低延迟互动直播模式。

  • AliRtcClientRole:用户角色。

枚举名

描述

AliRtcClientRoleInteractive

主播角色。

AliRtcClientRolelive

观众角色。

  • AliRtcStats:会话数据统计信息。

参数

类型

描述

sent_kbitrate

long long

发送码率。

rcvd_kbitrate

long long

接收码率。

sent_bytes

long long

发送字节数。

rcvd_bytes

long long

接收字节数。

systemCpuUsage

float

系统CPU使用率。

cpu_usage

float

RTC进程CPU使用率。

video_rcvd_kbitrate

long

视频接收码率。

video_sent_kbitrate

long

视频发送码率。

call_duration

long

通话时长,单位:秒。

sent_loss_rate

long

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

sent_loss_pkts

long long

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

sent_expected_pkts

long long

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

rcvd_loss_rate

long long

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

rcvd_loss_pkts

long long

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

rcvd_expected_pkts

long long

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

lastmile_delay

int

延时时长,单位:毫秒。

available_sent_kbitrate

long long

可用带宽(kb)。

  • AliRtcLocalVideoStats:本地视频统计信息。

参数

类型

描述

track

AliRtcVideoTrack

流类型。

capture_width

unsigned int

采集宽度。

capture_height

unsigned int

采集高度。

encode_width

unsigned int

编码宽度。

encode_height

unsigned int

编码高度。

sent_bitrate

unsigned int

发布比特率。

sent_fps

unsigned int

发布帧率。

encode_fps

unsigned int

编码帧率。

target_encode_bitrate

unsigned int

目标编码码率。

actual_encode_bitrate

unsigned int

实际编码码率。

capture_fps

unsigned int

采集帧率。

  • AliRtcRemoteVideoStats:远端视频统计信息。

参数

类型

描述

userId

NSString * _Nonnull

用户ID。

track

AliRtcVideoTrack

视频流类型。

width

unsigned int

宽。

height

unsigned int

高。

decode_fps

unsigned int

编码器输出帧率。

render_fps

unsigned int

渲染器输出帧率。

frozen_times

iunsigned int

卡顿次数。

video_total_frozen_time

unsigned int

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

video_total_frozen_rate

unsigned int

视频播放的累计卡顿率,单位% 计算方法 视频播放卡顿率=视频播放的累计卡顿时长/视频播放的总时长。

  • AliRtcLocalAudioStats:本地音频统计信息。

参数

类型

描述

track

AliRtcAudioTrack

音频流类型。

sent_bitrate

int

发送码率,单位:Kbps。

sent_samplerate

int

发送的采样率。

num_channel

int

声道数。

send_loss

int

发送丢包率。

  • AliRtcRemoteAudioStats:远端音频统计信息。

参数

类型

描述

userId

NSString * _Nonnull

远端用户UID。

track

AliRtcAudioTrack

音频流类型。

sample_rate

unsigned int

采样率。

channels

unsigned int

声道数。

quality

unsigned int

音质。

audio_loss_rate

unsigned int

回调周期内的音频丢帧率。

rcvd_bitrate

unsigned int

接收流的瞬时码率,单位:Kbps。

totalFrozenTimes

unsigned int

卡顿次数。

network_transport_delay

unsigned int

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

jitter_buffer_delay

unsigned int

接受端到网络抖动缓存的网络延时,单位:毫秒。

  • AliRtcVideoObserPosition:视频数据输出位置。

枚举名

描述

AliRtcPositionPostCapture

采集视频数据。

AliRtcPositionPreRender

渲染视频数据。

AliRtcPositionPreEncoder

编码前视频数据。

  • AliRtcVideoFormat:视频数据格式。

枚举名

描述

AliRtcVideoFormat_UNKNOW

未知。

AliRtcVideoFormat_BGRA

BGRA。

AliRtcVideoFormat_I420

I420。

AliRtcVideoFormat_NV21

NV21。

AliRtcVideoFormat_NV12

NV12。

AliRtcVideoFormat_RGBA

RGBA。

AliRtcVideoFormat_I422

I422。

AliRtcVideoFormat_ARGB

ARGB。

AliRtcVideoFormat_ABGR

ABGR。

AliRtcVideoFormat_RGB24

RGB24。

AliRtcVideoFormat_BGR24

BGR24。

AliRtcVideoFormat_RGB565

RGB565。

AliRtcVideoFormat_TextureOES

OES纹理。

AliRtcVideoFormat_Texture2D

Texture2D纹理。

AliRtcVideoFormat_H264

H264编码流。

AliRtcVideoFormat_H265

H265编码流。

AliRtcVideoFormat_File

文件。

  • AliRtcLiveTranscodingVideoCodec:旁路直播视频编码器。

枚举名

描述

AliRtcLiveTranscodingVideoCodec_H264

h264

AliRtcLiveTranscodingVideoCodec_H265

h265

  • AliRtcConnectionStatus:网络连接状态。

枚举名

描述

AliRtcConnectionStatusInit

初始化完成。

AliRtcConnectionStatusDisconnected

网络连接断开。

AliRtcConnectionStatusConnecting

建立网络连接中。

AliRtcConnectionStatusConnected

网络已连接。

AliRtcConnectionStatusReconnecting

重新建立网络连接中。

AliRtcConnectionStatusFailed

网络连接失败。

  • AliRtcConnectionStatusChangeReason:网络连接状态变更原因。

枚举名

描述

AliRtcConnectionChangedDummyReason

未知原因。

AliRtcConnectionChangedMediaPathChanged

媒体通道变更。

AliRtcConnectionChangedSignalingHeartbeatTimeout

心跳超时。

AliRtcConnectionChangedSignalingHeartbeatAlive

心跳恢复。

AliRtcConnectionChangedSignalingHttpdnsResolved

DNS解析成功。

AliRtcConnectionChangedSignalingHttpdnsFailure

DNS解析失败。

AliRtcConnectionChangedSignalingGslbFailure

GSLB请求失败。

AliRtcConnectionChangedSignalingGslbSucccess

GSLB请求成功。

AliRtcConnectionChangedSignalingJoinChannelFailure

加入频道失败。

AliRtcConnectionChangedSignalingJoinChannelSuccess

加入频道成功。

AliRtcConnectionChangedSignalingLeaveRoom

离开频道。

AliRtcConnectionChangedSignalingConnecting

信令建立连接。

  • 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:网络质量。

枚举名

描述

Network_Excellent

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

Network_Good

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

Network_Poor

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

Network_Bad

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

Network_VeryBad

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

Network_Disconnected

网络中断。

Network_Unknow

未知原因。

  • AliRtcRenderMode:渲染模式。

枚举名

描述

AliRtcRenderModeAuto

自动。

AliRtcRenderModeStretch

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

AliRtcRenderModeFill

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

AliRtcRenderModeClip

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

  • AliRtcRenderMirrorMode:镜像模式。

枚举名

描述

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

采样率8000Hz。

AliRtcAudioSampleRate_11025

采样率11025Hz。

AliRtcAudioSampleRate_16000

采样率16000Hz。

AliRtcAudioSampleRate_22050

采样率22050Hz。

AliRtcAudioSampleRate_32000

采样率32000Hz。

AliRtcAudioSampleRate_44100

采样率44100Hz。

AliRtcAudioSampleRate_48000

采样率48000Hz。

AliRtcAudioSampleRate_Unknown

未知采样率,某些场合使用。

  • AliRtcRecordType:录制类型。

枚举名

描述

AliRtcRecordTypeAudio

录制纯音频文件。

AliRtcRecordTypeVideo

录制视频文件。

  • AliRtcRecordFormat:录制格式。

枚举名

描述

AliRtcRecordFormatAAC

AAC文件。

AliRtcRecordFormatWAV

WAV文件。

AliRtcRecordFormatMP4

MP4文件。

  • AliRtcAudioQuality:录制音频质量。

枚举名

描述

AliRtcAudioQualityLow

低。

AliRtcAudioQualityMidium

中。

AliRtcAudioQualityHigh

高。

  • AliRtcVideoQuality:录制视频质量。

枚举名

描述

AliRtcVideoQualityDefault

默认和采集保持一致。

  • AliRtcTranportAudioQuality:音频质量。

枚举名

描述

AliRtcAudioQulityUnknow

质量未知。

AliRtcAudioQulityExcellent

质量极好。

AliRtcAudioQulityGood

用户主观感觉和极好差不多,但码率可能略低于极好。

AliRtcAudioQulityPoor

用户主观感受有瑕疵,但不影响沟通。

AliRtcAudioQulityBad

勉强能沟通但不顺畅。

AliRtcAudioQulityVeryBad

网络质量非常差,基本不能沟通。

AliRtcAudioQulityNetworkDisconnected

网络连接已断开,完全无法沟通。

  • AliRtcAudioProfile:音频质量模式。

枚举名

描述

AliRtcEngineLowQualityMode

音频低音质模式。

AliRtcEngineBasicQualityMode

标准音质模式。

AliRtcEngineHighQualityMode

高音质模式。

AliRtcEngineStereoHighQualityMode

立体声高音质模式。

AliRtcEngineSuperHighQualityMode

超高音质模式。

AliRtcEngineStereoSuperHighQualityMode

立体声超高音质模式。

  • AliRtcAudioScenario:音频场景模式。

枚举名

描述

AliRtcSceneDefaultMode

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

AliRtcSceneEducationMode

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

AliRtcSceneMediaMode

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

AliRtcSceneMusicMode

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

AliRtcSceneChatroomMode

聊天室场景,适用于频繁上下麦的聊天场景。

  • AliRtcMuteLocalAudioMode:本地静音模式。

枚举名

描述

AliRtcMuteAudioModeDefault

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

AliRtcMuteAllAudioMode

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

AliRtcMuteOnlyMicAudioMode

只静音麦克风。

AliRtcMuteLocalAudioMax

占位符。

  • AliRtcRecordAudioConfig:录制音频设置。

参数

类型

描述

sampleRate

AliRtcAudioSampleRate

音频采样率。

quality

AliRtcAudioQuality

音频质量。

enableRecordExternalRenderPCM

bool

是否允许录制外部PCM输入渲染数据。

enableRecordExternalCapturePCM

bool

是否允许录制外部pcm输入采集数据

  • AliRtcRecordVideoConfig:录制视频设置。

参数

类型

描述

quality

AliRtcVideoQuality

视频质量。

  • AliRtcBeautyConfig:基础美颜设置。

参数

类型

描述

whiteningLevel

float

美白,取值范围:[0,1],数值越大美白效果越好。

smoothnessLevel

float

磨皮,取值范围:[0,1],数值越大磨皮效果越好。

  • AliRtcOnByeType:OnBye类型枚举。

枚举名

描述

AliRtcOnByeBeKickedOut

被踢出。

AliRtcOnByeChannelTerminated

频道已结束,需要离开会议。

AliRtcOnByeUserReplaced

相同用户ID在其他设备加入频道,当前设备被下线。

AliRtcOnByeExpire 

超时。

AliRtcOnByeReconnect 

重新连接。

AliRtcOnByeBeBaned 

被封禁。

  • AliRtcAudioEffectVoiceChangerMode:变声音效模式。

枚举名

描述

AliRtcAudioEffectvVoiceChanger_OFF

关闭。

AliRtcAudioEffectvVoiceChanger_OLD_MAN

老人。

AliRtcAudioEffectvVoiceChanger_BABYBOY

男孩。

AliRtcAudioEffectvVoiceChanger_BABYGILR

女孩。

AliRtcAudioEffectvVoiceChanger_ROBOT

机器人。

AliRtcAudioEffectvVoiceChanger_DAIMO

大魔王。

AliRtcAudioEffectvVoiceChanger_KTV

KTV。

AliRtcAudioEffectvVoiceChangerR_ECHO

回声。

AliRtcAudioEffectvVoiceChangerR_DIALECT

方言。

AliRtcAudioEffectvVoiceChangerR_HOWL

怒吼。

AliRtcAudioEffectvVoiceChangerR_ELECTRONIC

电音。

AliRtcAudioEffectvVoiceChangerR_PHONOGRAPH

留声机。

AliRtcAudioEffectvVoiceChanger_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

教堂走廊。

AliRtcAudioEffectReverb_Cathedral

大教堂。

AliRtcAudioEffectReverb_Mode_Max

占位符,无含义。

  • AliRtcAudioEffectReverbParamType:音效混响参数。

枚举名

描述

AliRtcAudioEffectReverb_Room_Size

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

AliRtcAudioEffectReverb_Pre_Delay

预延时,单位:ms,取值范围:[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]。

AliRtcAudioEffectReverb_Type_Max

占位符,无含义。

  • AliVideoCanvas:渲染画布。

参数

类型

描述

view

UIView * _Nonnull

渲染view,不可为nil。

renderMode

AliRtcRenderMode

渲染模式,默认AliRtcRenderModeAuto。

mirrorMode

AliRtcRenderMirrorMode

镜像模式。默认AliRtcRenderMirrorModeOnlyFront。

backgroundColor

int

背景颜色,格式为RGBHex。

rotationMode

AliRtcRotationMode

视频旋转角度,默认不旋转。

  • AliRtcTrascodingLiveStreamErrorCode:旁路推流错误码。

枚举名

描述

AliRtcTrascodingLiveStreamErrorPublishOk

推流成功。

AliRtcTrascodingLiveStreamErrorStreamNotFound

错误:找不到流。

AliRtcTrascodingLiveStreamErrorStreamAlreadyExist

错误:目标流已存在。

AliRtcTrascodingLiveStreamErrorInvalidParam

错误:非法的参数。

AliRtcTrascodingLiveStreamErrorInternalError

错误:内部错误。

AliRtcTrascodingLiveStreamErrorRtmpServerError

错误:RTMP服务异常。

AliRtcTrascodingLiveStreamErrorRtmpStreamUrlError

错误:URL异常。

AliRtcTrascodingLiveStreamErrorPublishTimeout

错误:任务超时。

AliRtcTrascodingLiveStreamErrorNotAuthorized

错误:操作未授权。

  • AliRtcWatermarkConfig:水印图片的设置。

参数

类型

描述

visibleInPreview

BOOL

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

positionInLandscapeMode

CGRect

横屏时的水印坐标。

positionInPortraitMode

CGRect

竖屏时的水印坐标。

alpha

float

透明度。

normalized

BOOL

是否归一化。

  • AliRtcCameraCapturerConfiguration:相机采集偏好属性。

参数

类型

描述

preference

AliRtcCaptureOutputPreference

采集偏好。

fps

int

每秒帧数。

cameraCaptureProfile

AliRtcCameraCaptureProfile

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

disableVideoCaptureReverse

int

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

captureObserverOriginal

int

是否回调原始的videoframe数据。

nativeBufferObserver

int

回调textureid。

captureCallbackCvpixelbufferToRaw

int

视频采集callback使用cvPixelBuffer回调。

  • AliRtcCameraCaptureProfile:指定摄像头采集分辨率。

枚举名

描述

AliRtcCameraCaptureProfileDefault

默认。

AliRtcCameraCaptureProfile1080P

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

  • AliRtcCaptureOutputPreference:摄像头采集偏好。

枚举名

描述

AliRtcCaptureOutputPreferenceAuto

自动调整采集参数。

AliRtcCaptureOutputPreferencePerformance

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

AliRtcCaptureOutputPreferencePreview

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

  • 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

编码视频不镜像。

  • AliRtcVideoCodecType :视频编解码类型。

枚举名

描述

AliRtcVideoCodecTypeDefault

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

AliRtcVideoCodecTypeSoftware

软件视频编码器。

AliRtcVideoCodecTypeHardware

硬件视频编码器。

  • AliRtcVideoEncodeCodecType:编码器类型。

枚举名

描述

AliRtcVideoEncodeCodecTypeDefault

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

AliRtcVideoEncodeCodecTypeH264

h264编码。

AliRtcVideoEncodeCodecTypeHevc

hevc编码。

  • AliRtcVideoEncoderOrientationMode:编码视频旋转模式。

枚举名

描述

AliRtcVideoEncoderOrientationModeAdaptive

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

AliRtcVideoEncoderOrientationModeFixedLandscape

固定横屏。

AliRtcVideoEncoderOrientationModeFixedPortrait

固定竖屏。

  • AliRtcVideoEncoderConfiguration:视频编码偏好。

参数

类型

描述

dimensions

CGSize

视频分辨率。

frameRate

NSInteger

视频编码帧率。

bitrate

NSInteger

视频编码码率。

min_bitrate

NSInteger

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

keyFrameInterval

NSInteger

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

forceStrictKeyFrameInterval

bool

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

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

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

mirrorMode

AliRtcVideoEncoderMirrorMode

编码视频镜像模式。

orientationMode

AliRtcVideoEncoderOrientationMode

编码视频旋转模式。

rotationMode

AliRtcRotationMode

视频旋转角度。

codecType

AliRtcVideoCodecType

编解码器类型。

encoderType

AliRtcVideoEncodeCodecType

视频编码类型。

seiForceFrontIFrame

NSInteger

SEI发送前强制I帧。

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

enableDynamicEncode

NSInteger

启用动态编码。

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

disableDipenseResolutionChange

NSInteger

关闭QoS降低分辨率能力。

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

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

enableDowngrade

NSInteger

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

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

enableH264BFrame

NSInteger

是否打开h264 B帧支持。

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

重要

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

enableHevcBFrame

NSInteger

是否打开HEVC B帧支持。

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

重要

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

  • AliRtcScreenShareEncoderConfiguration:屏幕分享编码偏好。

参数

类型

描述

dimensions

CGSize

视频分辨率。

frameRate

NSInteger

视频编码帧率。

bitrate

NSInteger

视频编码码率。

rotation

AliRtcRotationMode

屏幕旋转角度。

keyFrameInterval

NSInteger

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

forceStrictKeyFrameInterval

bool

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

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

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

  • AliRtcVideoDecoderConfiguration:视频解码器设置。

参数

类型

描述

codecType

AliRtcVideoCodecType

编解码器类型。

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

enableDecoderBframe

NSInteger

是否启用解码器B

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

backgroundHardwareToSoftware

NSInteger

是否在APP切到后台后硬件解码降级到软件编码。

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


  • AliRtcAuthInfo:鉴权信息。

参数

类型

描述

channelId

NSString * _Nonnull

频道ID。

userId

NSString * _Nonnull

用户ID。

appId

NSString * _Nonnull

应用ID。

nonce

NSString * _Nonnull

随机串。

token

NSString * _Nonnull

令牌。

gslb

NSArray <NSString *> *

GSLB地址。

timestamp

long long

时间戳。

  • AliRtcDeviceVolumeType:设备音量类型(仅iOS)。

枚举名

描述

AliRtcDeviceVolumeTypeAuto

SDK自动设置音量类型(默认值)。SDK内部会自动选择合适的音量类型,如无特殊需求,不推荐自行设置。

AliRtcDeviceVolumeTypeMedia

设置为媒体音量,适合媒体播放场景,音量可以调节到零。

AliRtcDeviceVolumeTypeVOIP

设置为通话音量,适合通话场景,音量无法调节到零。

  • AliRtcVideoSource:视频裸数据源类型。

枚举名

描述

AliRtcVideosourceCameraType

视频流。

AliRtcVideosourceScreenShareType

屏幕共享流。

AliRtcVideosourceBoth

视频流+屏幕共享流。

AliRtcVideosourceTypeMax

占位符。

  • AliRtcAudioSource:音频裸数据源类型。

枚举名

描述

AliRtcAudioSourceCaptured

采集的音频数据

AliRtcAudioSourceProcessCaptured

3A后的音频数据

AliRtcAudiosourcePub

推流音频数据。

AliRtcAudioSourcePlayback

播放的音频数据

AliRtcAudioSourceMixedAll

推流和播放混音后的音频数据,暂不支持

AliRtcAudioSourceRemoteUser

拉流的远端音频数据

  • AliRtcBufferType:视频数据类型。

枚举名

描述

AliRtcBufferType_Raw_Data

YUV裸数据。

AliRtcBufferType_CVPixelBuffer

CVPixelBuffer数据。

AliRtcBufferType_Texture

纹理。

AliRtcBufferType_File

文件路径。

  • AliRtcErrorCode:错误码。

枚举名

描述

AliRtcErrNone

无。

AliRtcErrJoinBadAppId

App ID不存在。

AliRtcErrJoinInvalidAppId

App ID已失效。

AliRtcErrJoinBadChannel

频道不存在。

AliRtcErrJoinInvalidChannel

频道已失效。

AliRtcErrJoinBadToken

token不存在。

AliRtcErrJoinTimeout

加入频道超时。

AliRtcErrJoinBadParam

参数错误。

AliRtcErrJoinChannelFailed

加入频道失败

AliRtcErrLogAlreadyInit

日志模块已经初始化

AliRtcErrLogRootPathError

日志模块根路径错误,请检查路径是否存在或路径是否具有写入权限

AliRtcErrMicOpenFail

采集设备初始化失败。

AliRtcErrSpeakerOpenFail

播放设备初始化失败。

AliRtcErrMicInterrupt

采集过程中出现异常。

AliRtcErrSpeakerInterrupt

播放过程中出现异常。

AliRtcErrMicAuthFail

麦克风设备未授权。

AliRtcErrMicNotAvailable

无可用的音频采集设备。

AliRtcErrSpeakerNotAvailable

无可用的音频播放设备。

AliRtcErrCameraOpenFail

采集设备初始化失败。

AliRtcErrCameraInterrupt

采集过程中出现异常。

AliRtcErrDisplayOpenFail

渲染设备初始化失败。

AliRtcErrDisplayInterrupt

渲染过程中出现异常。

AliRtcErrIceConnectionConnectFail

媒体通道建立失败。

AliRtcErrIceConnectionReconnectFail

媒体通道重连失败。

AliRtcErrIceConnectionHeartbeatTimeout

信令心跳超时。

AliRtcErrIceConnectionMobilityFail

媒体通道mobility失败,应用层需要重走入会流程

AliRtcErrCdnLiveCommunicationFailed

低延时互动直播信令失败

AliRtcErrCdnLiveMeidaSettingFailed

低延时互动直播媒体设置错误

AliRtcErrCdnLiveNoneBroadcaster

低延时互动直播当前房间没有主播推流

AliRtcErrCdnLiveNeedRestart

低延时互动直播错误,应用层需要重新创建新的SDK实例

AliRtcErrCdnLiveNeedRestartAgainLater

低延时互动直播错误,应用层需要稍等一定时间(自定义间隔)重新创建新的SDK实例

AliRtcErrCdnLiveServiceUnavailable

低延迟互动直播服务不可用或者服务降级,客户端应该选择其它方式拉超大方会流,即不从cdn sfu拉流

AliRtcErrCdnLiveMediaConnectionInterruption

低延迟互动直播网络中断错误,销毁当前sdk实例重新创建sdk后重新走订阅流程

AliRtcErrPublishInvaild

推流无效。

AliRtcErrPublishNotJoinChannel

未进入频道推流失败。

AliRtcErrPublishAudioStreamFailed

推送音频流失败。

AliRtcErrPublishVideoStreamFailed

推送视频流失败。

AliRtcErrPublishDualStreamFailed

推送双流失败。

AliRtcErrPublishScreenShareFailed

推送屏幕共享失败。

AliRtcErrPublishScreenShareConfigError

屏幕共享配置错误。

AliRtcErrSubscribeInvaild

订阅无效。

AliRtcErrSubscribeNotJoinChannel

未进入频道订阅错误。

AliRtcErrSubscribeAudioStreamFailed

订阅音频流失败。

AliRtcErrSubscribeVideoStreamFailed

订阅视频流失败。

AliRtcErrSubscribeDualStreamFailed

订阅双流失败。

AliRtcErrSubscribeScreenShareFailed

订阅屏幕共享失败。

AliRtcErrSubscribeRtsStreamFailed

订阅RTS流失败

AliRtcErrPauseRtsStreamFailed

暂停RTS流失败

AliRtcErrSdkInvalidState

sdk状态错误。

AliRtcErrSessionRemoved

Session已经被移除。

AliRtcErrInvalidArguments

参数不匹配。

AliRtcErrAudioBufferFull

buffer队列饱和,用于外部输送裸数据功能。

AliRtcErrVideoBufferFull

buffer队列饱和,用于外部输送裸数据功能。

AliRtcErrUpdateRoleChannel

互动模式下设置角色错误。

AliRtcErrInner

其他错误。

  • AliRtcExternalDeviceType:外接设备类型。

枚举名

描述

AliRtcExternalTypeUnknown

未知类型。

AliRtcExternalTypeAudioCapture

音频采集设备。

AliRtcExternalTypeAudioPlayout

音频播放设备。

AliRtcExternalTypeVideoCapture

视频采集设备。

  • AliRtcExternalDeviceState:外接设备状态。

枚举名

描述

AliRtcExternalDeviceAdd

新增外接设备。

AliRtcExternalDeviceRemove

移除外接设备。

  • AliRtcRecordVideoCanvasConfig:录制视频设置的画布大小。

参数

类型

描述

canvasWidth

int

画布的宽。

canvasHeight

int

画布的高。

  • AliRtcRecordVideoBgColor:录制视频的背景颜色。

参数

类型

描述

r

uint8_t

颜色配比中红色的值。

g

uint8_t

颜色配比中绿色的值。

b

uint8_t

颜色配比中蓝色的值。

  • AliRtcDeviceInfo:设备信息。

参数

类型

描述

deviceName

NSString * _Nullable

设备名称。

deviceID

NSString * _Nullable

设备ID。

  • AliRtcScreenShareConfig:屏幕分享配置。

参数

类型

描述

isShareByRegion

bool

是否是区域分享。

shareRegion

AliRtcScreenShareRegion

* _Nonnull

区域分享的布局信息。

  • AliRtcScreenShareRegion:屏幕分享区域。

参数

类型

描述

originX

float

x坐标。

originY

float

y坐标。

width

float

宽度。

height

float

高度。

  • AliRtcScreenSourceInfo:屏幕分享源信息。

参数

类型

描述

sourceId

NSString * _Nonnull

分享源ID。

sourceName

NSString * _Nonnull

分享源名称。

  • AliRtcScreenShareInfo:屏幕分享配置信息。

参数

类型

描述

sourceType

AliRtcScreenShareType

分享类型。

sourceId

NSString * _Nonnull

分享源ID。

config

AliRtcScreenShareConfig

* _Nonnull

屏幕分享配置。

  • AliRtcScreenShareType:屏幕分享类型。

枚举名

描述

AliRtcScreenShareDesktop

桌面分享。

AliRtcScreenShareWindow

窗口分享。

  • AliRtcVideoObserAlignment:视频输出宽度对齐方式。

枚举名

描述

AliRtcAlignmentDefault

保持原有视频宽度(默认值)。

AliRtcAlignmentEven

宽度偶数对齐。

AliRtcAlignment4

宽度是4的倍数。

AliRtcAlignment8

宽度是8的倍数。

AliRtcAlignment16

宽度是16的倍数。

  • AliRtcShowDebugViewType:显示仪表盘类型。

枚举名

描述

AliRtcShowTypeNone

不显示。

AliRtcShowTypeAudio

音频。

AliRtcShowTypeVideo

视频。

AliRtcShowTypeNetwork

网络。

AliRtcShowTypeAll

全部

  • AliRtcTrascodingLiveTaskStatus:旁路推流LiveStream状态。

枚举名

描述

AliRtcTrascodingLiveTaskStatusStart

任务开始。

AliRtcTrascodingLiveTaskStatusUpdate

任务更新。

AliRtcTrascodingLiveTaskStatusStop

任务已停止。

  • AliRtcLiveTranscodingDisplayType:旁路直播图片显示类型。

枚举名

描述

AliRtcLiveTranscodingDisplayType_NOT_DISPLAY

不显示。

AliRtcLiveTranscodingDisplayType_ALWAYS

一直显示。

AliRtcLiveTranscodingDisplayType_WHEN_NO_VIDEO 

当没有视频时候显示。

  • 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

人像分割。

  • AliRtcLiveTranscodingSourceType:旁路直播输入类型。

枚举名

描述

AliRtcLiveTranscodingCamera

相机。

AliRtcLiveTranscodingShareScreen

共享屏幕。

  • AliRtcVideoState:视频流状态变化。

枚举名

描述

AliRtcVideoVideoClose

关闭视频流。

AliRtcVideoVideoOpen

恢复视频流。

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

枚举名

描述

AliRTCVideoChangedByClient

客户端。

AliRTCVideoChangedByServer

服务器。

  • AliRtcLiveTranscodingCropMode:旁路直播裁剪模式。

枚举名

描述

AliRtcLiveTranscodingCrop

保持比例裁剪。

AliRtcLiveTranscodingFill

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

  • AliRtcLiveTranscodingMediaProcessMode:旁路直播媒体处理模式。

枚举名

描述

AliRtcLiveTranscodingNormal

通用模式。

AliRtcLiveTranscodingVirtualBackground

虚拟背景模式。

  • AliRtcLiveTranscodingStreamType:旁路直播转推流类型。

枚举名

描述

AliRtcLiveTranscodingOrigin

转推原始流。

AliRtcLiveTranscodingAudio

仅转推音频流。

AliRtcLiveTranscodingVideo

仅转推视频流。

  • AliRtcLiveTranscodingMixMode:旁路直播模式。

枚举名

描述

AliRtcLiveTranscodingSINGLE

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

AliRtcLiveTranscodingMIX

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

  • AliRtcLiveTranscodingState:旁路直播状态。

枚举名

描述

AliRtcLiveTranscodingState_IDLE

推流空闲。

AliRtcLiveTranscodingState_CONNNECT

正在连接推流服务器。

AliRtcLiveTranscodingState_RUNNING

推流正在进行。

AliRtcLiveTranscodingState_RECOVERING

正在恢复推流。

AliRtcLiveTranscodingState_FAILURE

推流失败。

AliRtcLiveTranscodingState_END

推流结束。

  • AliRtcLiveTranscodingText:旁路直播文本信息。

参数

类型

描述

text

NSString

文本信息。

x

int

坐标X(像素)。

y

int

坐标Y(像素)。

fontType

AliRtcLiveTranscodingFontType

旁路直播字体。

fontSize

int

字体大小。

zOrder

int

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

fontColor

int

字体颜色。

  • AliRtcLiveTranscodingImage:旁路直播图片信息。

参数

类型

描述

url

NSString

图片URL。

alpha

float

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

display

AliRtcLiveTranscodingDisplayType

图片显示。

x

int

坐标X(像素)。

y

int

坐标Y(像素)。

width

int

图片宽。

height

int

图片高。

zOrder

int

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

  • AliRtcLiveTranscodingUser:旁路直播用户自定义流信息。

参数

类型

描述

x

int

坐标X(像素)。

y

int

坐标Y(像素)。

width

int

窗格宽。

height

int

窗格高。

zOrder

int

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

userId

NSString *

用户ID。

streamType

AliRtcLiveTranscodingStreamType

旁路直播转推流模式。

sourceType

AliRtcLiveTranscodingSourceType

流类型。

segmentType

AliRtcLiveTranscodingSegmentType

旁路直播输入类型。

images

NSArray<AliRtcLiveTranscodingImage

*> *

旁路直播图片信息。

texts

NSArray<AliRtcLiveTranscodingText

*> *

旁路直播文本信息。

  • AliRtcLiveTranscodingParam:旁路直播配置。

参数

类型

描述

mixMode

AliRtcLiveTranscodingMixMode

旁路直播模式。

singleParam

AliRtcLiveTranscodingSingleParam

*

旁路直播单流参数。

mixParam

AliRtcLiveTranscodingMixParam

旁路直播混流参数。

  • AliRtcLiveTranscodingMixParam:旁路模式混流参数。

参数

类型

描述

taskProfile

AliRtcLiveTranscodingTaskProfile

旁路直播计费规格。

encodeParam

AliRtcLiveTranscodingEncodeParam

*

旁路直播编码参数。

users

NSArray<AliRtcLiveTranscodingUser

*> *

旁路直播用户列表。

backgroundColor

int

背景色。

backgrounds

NSArray<AliRtcLiveTranscodingImage

*> *

背景图片列表。

watermarks

NSArray<AliRtcLiveTranscodingImage

*> *

水印图片列表。

clockWidgets

NSArray<AliRtcLiveTranscodingClockWidget

*> *

时钟小部件列表。

cropMode

AliRtcLiveTranscodingCropMode

旁路直播裁剪模式。

mediaProcessMode

AliRtcLiveTranscodingMediaProcessMode

旁路直播媒体处理模式。

  • AliRtcLiveTranscodingSingleParam:旁路模式单路参数。

参数

类型

描述

userId

NSString *

用户ID。

streamType

AliRtcLiveTranscodingStreamType

旁路直播转推流类型。

sourceType

AliRtcLiveTranscodingSourceType

旁路直播视频流类型。

  • 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

纯音频。

  • AliRtcLiveTranscodingEncodeParam:旁路直播编码参数。

参数

类型

描述

videoWidth

int

宽。

videoHeight

int

高。

videoFramerate

int

帧率。

videoBitrate

int

码率。

videoGop

int

GOP。

videoCodec

AliRtcLiveTranscodingVideoCodec

旁路直播视频编码器

audioSamplerate

AliRtcLiveTranscodingAudioSampleRate

旁路直播音频采样率。

audioBitrate

int

音频码率。

audioChannels

int

音频声道数。

  • AliRtcLiveTranscodingAudioSampleRate:旁路直播音频采样率。

枚举名

描述

AliRtcLiveTranscoding_HZ_48000

采样率48000Hz。

AliRtcLiveTranscoding_HZ_44100

采样率44100Hz。

AliRtcLiveTranscoding_HZ_32000

采样率32000Hz。

AliRtcLiveTranscoding_HZ_16000

采样率16000Hz。

AliRtcLiveTranscoding_HZ_8000

采样率8000Hz。

  • AliRtcLiveTranscodingClockWidget:旁路直播时钟小工具。

参数

类型

描述

x

int

坐标X(像素)。

y

int

坐标Y(像素)。

fontSize

int

旁路直播字体大小。

zOrder

int

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

fontColor

int

旁路直播字体颜色。

fontType

AliRtcLiveTranscodingFontType

旁路直播字体。

  • AliRtcVideoPipelineMirrorMode:视频链路镜像类型。

枚举名

描述

AliRtcVideoPipelineMirrorModeNoMirror

预览和编码均关闭镜像。

AliRtcVideoPipelineMirrorModeBothMirror

预览和编码均打开镜像。

AliRtcVideoPipelineMirrorModeOnlyPreviewMirror

仅预览打开镜像。

AliRtcVideoPipelineMirrorModeOnlyPublishMirror

仅推流打开镜像。

  • AliRtcCapturePipelineScaleMode:采集链路缩放类型。

枚举名

描述

AliRtcCapturePipelineScaleModePre

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

AliRtcCapturePipelineScaleModePost

编码时进行缩放。

  • AliRtcNetworkQuality:网络质量类型。

枚举名

描述

AlivcRtcNetworkQualityExcellent

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

AlivcRtcNetworkQualityGood

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

AlivcRtcNetworkQualityPoor

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

AlivcRtcNetworkQualityBad

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

AlivcRtcNetworkQualityVeryBad

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

AlivcRtcNetworkQualityDisconnect

网络断开。

AlivcRtcNetworkQualityUnknow

网络未知。

  • AliRtcCapabilityProfile:功能聚合的profile。

枚举名

描述

AliRtcCapabilityProfileDefault

默认值,无特殊要求。

AliRtcCapabilityProfileAiHuman

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

AliRtcCapabilityProfileAiRobot

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

  • AliRtcChannelParam:入会参数。

参数

类型

描述

channelId

NSString*

入会频道,必须和产生token时一样;可以不传,此时会默认使用产生tokenchannelId。

userId

NSString*

入会的userid,必须和产生token时一样;可以不传,此时会默认使用产生tokenuserId 。

userName

NSString*

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

capabilityProfile

AliRtcCapabilityProfile

功能profile,如在 AI agent 通话场景下有其他功能需求,可以直接选择porfile,不需要挨个打开功能。

  • AliRtcNetworkQualityProbeConfig:网络探测的参数配置。

参数

类型

描述

probeUplink

BOOL

是否探测上行,默认值:NO。

probeDownlink

BOOL

是否探测下行,默认值:NO 暂不支持。

upLinkBandWidth

int

探测上行带宽峰值,单位kbps 默认值:1000。

DownLinkBandWidth

int

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

  • AliRtcNetworkQualityProbeResult:网络探测的结果。

参数

类型

描述

rtt

int

链路的rtt 单位ms。

upLinkLossRate

int

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

upLinkJitter

int

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

upLinkBandWidth

int

上行网络带宽,单位kbps。

downLinkLossRate

int

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

downLinkJitter

int

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

downLinkBandWidth

int

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

  • AliRtcAudioAccompanyConfig:音频伴奏播放配置。

参数

类型

描述

onlyLocalPlay

BOOL

是否只本地播放。

replaceMic

BOOL

是否替换掉MIC。

loopCycles

int

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

startPosMs

NSInteger

起播位置,单位:ms。

publishVolume

int

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

playoutVolume

int

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

  • AliRtcAudioFileInfo:音频文件信息。

参数

类型

描述

filePath

NSString *

音频文件路径。

durationMs

NSInteger

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

  • AliRtcAudioFrame:音频裸数据。

参数

类型

描述

dataPtr

void *

音频数据指针。

numOfSamples

int

多少个采样。

bytesPerSample

int

每个采样的字节数。

numOfChannels

int

多少个声道。

samplesPerSec

int

采样率。

  • AliRtcDataMsgType:data消息类型。

枚举

描述

AliRtcDataMsgNone

未定义消息。

AliRtcDataMsgMusicProgress

音乐进度消息。

AliRtcDataMsgCustom

用户自定义消息。

  • AliRtcDataChannelMsg:data消息定义。

参数

类型

描述

type

AliRtcDataMsgType

音频数据指针。

networkTime

long long

网络时间戳。

progress

int

进度。

data

NSData*

数据。

  • AliRtcLocalDeviceType:本地设备类型。

枚举值

描述

AliRtcLocalDeviceTypeUnknown

未知设备类型。

AliRtcLocalDeviceTypeMic

麦克风设备。

AliRtcLocalDeviceTypeSpeaker

扬声器设备。

AliRtcLocalDeviceTypeAudioDevice

音频设备。

AliRtcLocalDeviceTypeCamera

摄像头设备。

AliRtcLocalDeviceTypeDisplay

显示设备。

AliRtcLocalDeviceTypeVideoDevice

视频设备。

  • AliRtcLocalDeviceExceptionType:本地设备异常类型。

枚举值

描述

AliRtcLocalDeviceExceptionTypeUnknown

未知异常类型。

AliRtcLocalDeviceExceptionTypeMicOpenFail

麦克风打开失败。

AliRtcLocalDeviceExceptionTypeMicInterrupt

麦克风被打断。

AliRtcLocalDeviceExceptionTypeMicAuthFail

麦克风无权限 。

AliRtcLocalDeviceExceptionTypeMicNotAvailable

无可用麦克风 。

AliRtcLocalDeviceExceptionTypeSpeakerOpenFail

扬声器打开失败。

AliRtcLocalDeviceExceptionTypeSpeakerInterrupt

扬声器被打断。

AliRtcLocalDeviceExceptionTypeSpeakerNotAvailable

无可用扬声器。

AliRtcLocalDeviceExceptionTypeAudioDeviceException

音频设备异常。

AliRtcLocalDeviceExceptionTypeCameraOpenFail

摄像头打开失败 。

AliRtcLocalDeviceExceptionTypeCameraInterrupt

摄像头被打断。

AliRtcLocalDeviceExceptionTypeCameraAuthFail

摄像头无权限 。

AliRtcLocalDeviceExceptionTypeDisplayExecption

显示设备异常。

AliRtcLocalDeviceExceptionTypeVideoDeviceException

视频设备异常。

  • AliRtcLocalAudioStateType:本地音频采集状态。

枚举值

描述

AliRtcLocalAudioStateTypeStarting

启动中。

AliRtcLocalAudioStateTypeStarted

启动结束。

AliRtcLocalAudioStateTypeStopping

关闭中。

AliRtcLocalAudioStateTypeStopped

关闭完成。

  • AliRtcLocalVideoStateType:本地视频设备状态。

枚举值

描述

AliRtcLocalVideoStateTypeStarting

启动中。

AliRtcLocalVideoStateTypeStarted

启动完成。

AliRtcLocalVideoStateTypeStopping

关闭中。

AliRtcLocalVideoStateTypeStopped

关闭完成。

  • AliRtcAudioAccompanyStateCode:音乐伴奏播放状态。

枚举值

描述

AliRtcAudioAccompanyStarted

开始播放。

AliRtcAudioAccompanyStopped

停止播放。

AliRtcAudioAccompanyPaused

播放暂停。

AliRtcAudioAccompanyResumed

播放恢复。

AliRtcAudioAccompanyEnded

播放完毕。

AliRtcAudioAccompanyBuffering

正在缓冲 。

AliRtcAudioAccompanyBufferingEnd

缓冲结束。

AliRtcAudioAccompanyFailed

播放失败。

  • AliRtcAudioAccompanyErrorCode:音乐伴奏播放错误码。

枚举值

描述

AliRtcAudioAccompanyNoError

没有错误。

AliRtcAudioAccompanyOpenFailed

打开文件失败 。

AliRtcAudioAccompanyDecodeFailed

解码文件失败。