华为云用户手册

HWRtcLocalAudioStats 表63 本端音频统计回调 属性 描述 @(strong, nonatomic) NSString *userId; 用户ID（本地音频信息为空） @ (assign, nonatomic) NSUInteger sampleRate; 音频采样率 @ (assign, nonatomic) NSUInteger channels; 音频声道数 @ (assign, nonatomic) NSUInteger bitRate; 音频码率 @ (assign, nonatomic) NSUInteger packetLoss; 音频丢包率 @ (assign, nonatomic) NSUInteger delay; 音频时延 @ (assign, nonatomic) NSUInteger jitter; 音频抖动

HWRtcNetworkQualityLevel 表54 网络质量等级 属性 描述 HWRtcNetworkQualityUnknown 网络质量未知 HWRtcNetworkQualityExcellent 网络质量非常好 HWRtcNetworkQualityGood 网络质量好 HWRtcNetworkQualityPoor 网络质量一般 HWRtcNetworkQualityBad 网络质量差 HWRtcNetworkQualityVbad 网络质量非常差

HWRtcRemoteAudioMode 表55 远端音频流收流模式 枚举值 描述 HWRtcRemoteAudioSubscribe= 0 订阅模式（自主订阅） HWRtcRemoteAudioTopThre= 1 TopN模式（收音量最大的三路流） HRTC_REMOTE_AUDIO_P2P= 2 P2P模式 HRTC_REMOTE_AUDIO_RTSA_CMD =3 RTSA-CMD模式 表56 不同分辨率下帧率和码率的推荐值 分辨率 分辨率类型 比例 最小帧率（fps） 最大帧率（fps） 最小码率 最大码率 320 X 180 SD 16:9 10 30 80 600 480 X 270 HD 16:9 10 30 160 1050 640 X 360 HD 16:9 10 30 200 1700 800 X 450 FHD 16:9 10 30 300 2100 960 X 540 FHD 16:9 10 30 400 2400 1120 X 630 FHD 16:9 10 30 450 2800 1280 X 720 FHD 16:9 10 30 500 4000 120 X 90 LD 4:3 10 30 64 240 160 X 120 SD 4:3 10 30 64 270 240 X 180 SD 4:3 10 30 80 450 320 X 240 HD 4:3 10 30 100 600 400 X 300 HD 4:3 10 30 200 900 480 X 360 HD 4:3 10 30 200 1000 640 X 480 FHD 4:3 10 30 250 1800 960 X 720 FHD 4:3 10 30 450 3000 表57 不同场景下帧率和码率的推荐值 分辨率 推荐帧率 通信场景推荐码率 直播场景推荐码率 160 X 90 15 90 180 320 X 180 15 200 400 480 X 270 15 350 700 640 X 360 15 450 900 640 X 360 30 850 1700 800 X 450 15 700 1400 800 X 450 30 1050 2100 960 X 540 15 850 1700 960 X 540 30 1200 2400 1120 X 630 15 950 1900 1120 X 630 30 1400 2800 1280 X 720 15 1200 2400 1280 X 720 30 2000 4000 120 X 90 15 80 160 160 X 120 15 90 180 240 X 180 15 150 300 320 X 240 15 200 400 400 X 300 15 300 600 480 X 360 15 350 700 480 X 360 30 500 1000 640 X 480 15 600 1200 640 X 480 30 900 1800 960 X 720 15 1000 2000 960 X 720 30 1500 3000

HWRtcStartAudioFileParam 表38 音频文件信息 属性 描述 @property (nonatomic, strong) NSString * _Nonnull fullFilePath; 文件路径 @property (nonatomic, assign) HWRtcAudioFilePlayMode playMode; 播放类型，具体请参见HWRtcAudioFilePlayMode @property (nonatomic, assign) NSUInteger cycle; 循环次数 @property (nonatomic, assign) NSUInteger replace; 远端模式下面是否需要和麦克风做混音

HWRtcQualityInfo 表53 网络质量信息 属性 描述 @property (strong, nonatomic) NSString *userId; 用户ID @property (assign, nonatomic) HWRtcNetworkQualityLevel level; 网络质量等级 @property (assign, nonatomic) NSUInteger width; 宽度 @property (assign, nonatomic) NSUInteger height; 高度

HWRtcNetworkTestConfig 表39 入会前网络检测配置 属性 描述 @property (strong, nonatomic) NSString * _Nonnull userId 用户id @property (strong, nonatomic) NSString * _Nonnull roomId 房间ID，roomid建议由userid+随机数组成 @property (strong, nonatomic) NSString *signature 必选，签名信息 @property (nonatomic, assign) long long ctime 必选，系统时间 @property (assign, nonatomic) BOOL enableUplinkTest 启动上行网络检测开关 @property (assign, nonatomic) BOOL enableDownlinkTest 启动下行网络检测开关 @property (nonatomic, assign) NSUInteger expectedUplinkBitrate 用户期望的最高发送码率，单位为bps，范围为0以及[100000, 5000000]，设为0表示由SDK指定最高码率 @property (nonatomic, assign) NSUInteger expectedDownlinkBitrate 用户期望的最高接收码率，单位为bps，范围为0以及[100000, 5000000]，设为0表示由SDK指定最高码率

HWRtcLocalAudioStateReason 表50 本地音频流状态变化原因 属性 描述 HWRtcLocalAudioReasonErrorOk 本地音频流状态正常 HWRtcLocalAudioReasonErrorFailure 本地音频流出错原因不明确 HWRtcLocalAudioReasonErrorRecordFailure 本地音频流录制失败，建议您检查录制设备是否正常工作 HWRtcLocalAudioReasonErrorStopFailure 关闭采集失败 HWRtcLocalAudioReasonErrorAccessDenied 音频设备API无法访问，可能是设备隐私权限设置问题 HWRtcLocalAudioReasonErrorOnExclusiveMode 音频设备处于独占模式，且被其他应用独占 HWRtcLocalAudioReasonErrorMmsyserrInvalparam 音频设备API非法参数（仅适用于windows） HWRtcLocalAudioReasonErrorMmsyserrNodriver 音频设备API返回无驱动，需要用户升级驱动（仅适用于windows） HWRtcLocalAudioReasonErrorAudioServerNotRunning 用户windows audio服务未启动，或者启动失败（仅适用于windows） HWRtcLocalAudioReasonErrorNoDevice 没有设备（仅适用于windows） HWRtcLocalAudioReasonErrorRestartFailed 扬声器播放无数据，重启失败

HWRtcNetworkTestResultParam 表42 检测网络回调信息 属性 描述 @property (nonatomic, assign) NSInteger bitRate 码率 @property (nonatomic, assign) NSInteger packetLoss 丢包 @property (nonatomic, assign) NSInteger delay 延时 @property (nonatomic, assign) NSInteger jitter 抖动

HWRtcVideoStatsInfo 表43 视频信息 属性 描述 @(strong, nonatomic) NSString *userId; 用户ID（本地视频信息为空） @ (assign, nonatomic) NSUInteger width; 视频宽 @ (assign, nonatomic) NSUInteger height; 视频高 @ (assign, nonatomic) NSUInteger bitRate; 视频码率 @ (assign, nonatomic) NSUInteger frameRate; 视频帧率 @ (assign, nonatomic) NSUInteger packetLoss; 视频丢包率 @ (assign, nonatomic) NSUInteger delay; 视频时延 @ (assign, nonatomic) NSUInteger jitter; 视频抖动

HWRtcNetworkQualityLevel 表45 检测网络质量等级 属性 描述 HWRtcNetworkQualityUnknown 网络质量未知 HWRtcNetworkQualityExcellent 网络质量非常好 HWRtcNetworkQualityGood 网络质量好 HWRtcNetworkQualityPoor 网络质量一般 HWRtcNetworkQualityBad 网络质量差 HWRtcNetworkQualityVbad 网络质量非常差

HWRtcNetworkTestResult 表40 属性 描述 @property (assign, nonatomic) HWRtcNetworkTestState state 检测网络状态，具体请参见HWRtcNetworkTestState @property (nonatomic, strong) HWRtcNetworkTestResultParam *uplinkResult 上行网络检测状态，具体请参见HWRtcNetworkTestResultParam @property (nonatomic, strong) HWRtcNetworkTestResultParam * downlinkResult 下行网络检测状态，具体请参见HWRtcNetworkTestResultParam

HWRtcAudioStatsInfo 表44 音频信息 属性 描述 @(strong, nonatomic) NSString *userId; 用户ID（本地音频信息为空） @ (assign, nonatomic) NSUInteger sampleRate; 音频采样率 @ (assign, nonatomic) NSUInteger channels; 音频声道数 @ (assign, nonatomic) NSUInteger bitRate; 音频码率 @ (assign, nonatomic) NSUInteger packetLoss; 音频丢包率 @ (assign, nonatomic) NSUInteger delay; 音频时延 @ (assign, nonatomic) NSUInteger jitter; 音频抖动

HWRtcLocalVideoStateReason 表52 本地视频流状态变化原因 属性 描述 HWRtcLocalVideoReasonErrorOk 本地视频流状态正常 HWRtcLocalVideoReasonErrorFailure 本地视频流出错原因不明确 HWRtcLocalVideoReasonErrorCaptureFailure 本地视频流录制失败，建议您检查录制设备是否正常工作 HWRtcLocalVideoReasonErrorStopFailure 关闭采集失败 HWRtcLocalVideoReasonErrorCaptureDeviceNoPermission 没有摄像头权限 HWRtcLocalVideoReasonErrorCaptureDeviceBusy 摄像头设备已占用 HWRtcLocalVideoReasonErrorCaptureAppInBackground 应用处于后台 HWRtcLocalVideoReasonErrorCaptureOpenCameraFailed 打开摄像头设备失败（仅支持iOS） HWRtcLocalVideoReasonErrorCaptureMultipleForegroundApp 应用窗口处于侧拉、分屏、画中画模式（仅支持iOS） HWRtcLocalVideoReasonErrorCaptureMultipleDeviceDisconnected 本地视频采集设备未连接（仅支持macOS）

HWRtcLeaveReason 表28 离开房间原因 枚举值 描述 HWRtcLeaveReasonUserLeaveRoom 用户主动离开 HWRtcLeaveReasonServerError 服务器异常 HWRtcLeaveReasonBreakdown sfu服务故障 HWRtcLeaveReasonServiceUnreachable 服务不可达 HWRtcLeaveReasonInternalError 内部错误 HWRtcLeaveReasonKickedOff 被踢 HWRtcLeaveReasonAuthorizationExpired 签名过期 HWRtcLeaveReasonReconnectFailed 重连超时

HwRtcImageBufferFormat 表35 视频帧图片格式 属性 描述 @property HWRtcVideoImageFormat format; 视频帧图片存储格式，具体请参见HWRtcVideoImageFormat @property HWRtcVideoImageBufferType bufferType; 视频帧缓冲区存储类型，具体请参见HWRtcVideoImageBufferType

HWRtcAudioFrame 表36 音频信息 属性 描述 @property (nonatomic, assign) HWRtcAudioFrameType frameType; 音频帧类型，具体请参见HWRtcAudioFrameType @property (nonatomic, assign) NSUInteger samples; 每个声道的采样点数，iSamples=iSamplesPerSec * 10ms /1000 @property (nonatomic, assign) NSUInteger samplesPerSec; 采样率 @property (nonatomic, assign) NSUInteger bytesPerSample; // bitsPerSample 每个采样点的字节数，pcm数据一般2字节 @property (nonatomic, assign) NSUInteger channels; 声道数 @property (strong, nonatomic) NSData * _Nullable data; 数据缓冲区，长度=samples*bytesPerSample*channels

HWRtcVideoFrame 表37 视频帧信息 属性 描述 @property (assign, nonatomic) HWRtcVideoImageFormat format; 图像格式 ，具体请参见HWRtcVideoImageFormat @property (assign, nonatomic) NSUInteger width; 图像宽度，作为输入时，范围为[90,1920]，必须是4的整数倍 @property (assign, nonatomic) NSUInteger height; 图像高度，作为输入时，范围为[90,1200]，必须是2的整数倍 @property (strong, nonatomic) NSData * _Nullable data; 存储视频数据的buf地址 @property (assign, nonatomic) NSUInteger dataLen; 视频数据的长度，单位为Byte @property (strong, nonatomic) NSString *userId; 被选看的远端用户本地推流不需要赋值

HWRtcVideoDisplayMode 表12 渲染模式 枚举值 描述 HWRtcVideoDisplayModeFit 优先保证视频内容全部显示，视频尺寸等比缩放，直至视频窗口的一边与视窗边框对齐。如果视频长宽与显示窗口不同，视窗上未被填满的区域将被涂黑 HWRtcVideoDisplayModeHIDDEN, 优先保证视窗被填满，视频尺寸等比缩放，直至整个视窗被视频填满。如果视频长宽与显示窗口不同，多出的视频将被截掉 HWRtcVideoDisplayModeFill, 视频尺寸进行缩放和拉伸以充满显示视窗

HWRtcRemoteAudioStateReason 表25 远端音频状态变化原因 枚举 描述 HWRtcRemoteAudioStateReasonRemoteOffline 远端用户离线 HWRtcRemoteAudioStateReasonRemoteMuted 远端用户停止音频流发送 HWRtcRemoteAudioStateReasonRemoteUnmuted 远端用户开启音频流发送 HWRtcRemoteAudioStateReasonRemoteFirstDecoded 远端用户音频首包解码

HWRtcConnChangeReason 表19 网络连接状态改变原因 枚举值 描述 HWRtcConnChangeConnecting 正在连接 HWRtcConnChangeJoinSuccess 加入房间成功 HWRtcConnChangeReconnecting 重连中 HWRtcConnChangeReconnectSuccess 重连成功 HWRtcConnChangeJoinFailed 加入房间失败 HWRtcConnChangeReconncetFailed 重连失败 HWRtcConnChangeInterrupted 连接中断 HWRtcConnChangeKeepAliveTimeout 心跳超时 HWRtcConnChangeLeaveRoom 主动离开房间 HWRtcConnChangeJoinServerError 服务器异常 HWRtcConnChangeSFUBreakdown sfu服务故障 HWRtcConnChangeJoinRoomAuthFailed 鉴权失败，appid或者签名错误 HWRtcConnChangeJoinRoomAuthRetry 鉴权重试 HWRtcConnChangeJoinRoomAuthClockSync 时钟同步 HWRtcConnChangeUrlNotRight URL错误400 HWRtcConnChangeJoinRoomServiceUnreachable 服务不可达503 HWRtcConnChangeInternalError 内部错误 HWRtcConnChangeKickedOff 被踢 HWRtcConnChangeSignatureExpired 签名过期

HWRtcStatsInfo 表22 卡顿统计信息 属性 描述 @property (strong, nonatomic) NSString *roomId; 房间ID @property (strong, nonatomic) NSString *userId; 用户ID @property (assign, nonatomic) long long mildlyFrozenCounts; 400ms卡顿次数 @property (assign, nonatomic) long long severelyFrozenCounts; 超过1s卡顿次数 @property (assign, nonatomic) long long totalMildlyFrozenTime; 400ms卡顿总时长 @property (assign, nonatomic) long long totalSeverelyFrozenTime; 1s卡顿总时长 @property (assign, nonatomic) long long totalActiveTime; 总时间，包括每一路选看时间总和

HWRtcConnStateType 表20 网络连接状态 枚举值 描述 HWRtcConnStateTypeDisconnected 连接断开 HWRtcConnStateTypeConnecting 建立网络连接中 HWRtcConnStateTypeConnected 网络连接成功 HWRtcConnStateTypeReconnecting 重新建立网络连接中 HWRtcConnStateTypeFailed 网络连接失败 HWRtcConnStateTypeLost 失去网络10秒 HWRtcConnStateTypeInterrupted SDK在和服务器建立连接后，失去网络连接超过4秒

HWRtcRemoteVideoStateReason 表27 远端视频状态变化原因 枚举值 描述 HWRtcRemoteVideoStateReasonRemoteOffline 远端用户离线 HWRtcRemoteVideoStateReasonRemoteMuted 远端用户停止视频流发送 HWRtcRemoteVideoStateReasonRemoteUnmuted 远端用户开启视频流发送

HWRtcJoinParam 表3 入会参数 属性 类型 描述 userId NSString 用户ID，支持最大长度64，支持数字、字母大小写、下划线、中线、"."字符 userName NSString 用户昵称，支持最大长度128 ctime long long 签名时间戳，单位秒，有signature时必选 authorization NSString 签名，必填，鉴权私钥请在应用管理中获取，签名的具体生成方法请参见接入鉴权。支持最大长度为1024。 role HWRtcRole 角色 optionalInfo NSString 其他信息 roomId NSString 房间Id，支持最大长度64，支持数字、字母大小写、下划线、中线字符 autoSubscribeVideo bool 是否自动订阅视频 autoSubscribeAudio bool 是否自动订阅音频 scenario HWRtcRemoteAudioMode 使用的场景 0：主动订阅（默认） 1：TopN（千人） 2：P2P 3：RTSA CMD自动订阅

HWRtcVideoEncode 表4 编码设置 属性 类型 描述 streamFlag HWRtcStreamType 视频编码类型，根据HWRtcStreamType和表57 不同分辨率下帧率和码率的推荐值设置需要的分辨率和宽高比 width int 视频分辨率宽 height int 视频分辨率高 frameRate int 视频帧率，可以参考表56和表57进行设置 minFrameRate int 视频最小帧率，大于0，小于frameRate bitrate int 视频码率，可以参考表56和表57进行设置 minBitrate int 视频最小码率，大于0，小于bitrate disableAdjustRes bool 上行流是否自适应，推荐开启自适应（即disableAdjustRes赋NO）

HWRtcEngineConfig 表9 引擎配置 属性 类型 描述 appId NSString 应用ID，只有App ID相同的应用程序才能进入同一个房间进行互动。appId获取方法请参见应用管理 countryCode NSString 国家码，具体值请参见国家码对照表 enableHaTrace BOOL 打点开关 muteAudioRoute BOOL 是否禁音频路由 enableLog BOOL 是否记录日志 logLevel HWRtcLogLevel 日志级别，具体请参见HWRtcLogLevel，默认值为HWRtcLogLevelDebug，推荐使用HWRtcLogLevelDebug logPath NSString 日志路径，需调用方保证路径合法可用，rtc仅做基础校验 logSize int 日志大小，默认值10M，推荐10M

辅流管理 表4 辅流管理接口 接口 描述 startRemoteAuxiliaryStreamView 开启辅流渲染视图（发起辅流选看） stopRemoteAuxiliaryStreamView 关闭辅流渲染视图（停止辅流选看） updateRemoteAuxiliaryStreamRenderMode 设置辅流视图渲染模式，镜像模式 setRemoteAuxiliaryStreamViewRotation 设置辅流视图角度 setRemoteAuxiliaryStreamViewOrientation 设置辅流横屏或竖屏显示

视频管理 表3 视频管理接口 接口 描述 startRemoteStreamView 按档位选看远端用户，并设置用户窗口 stopRemoteStreamView 取消订阅远端用户，并清除此用户的窗口 updateRemoteRenderMode 设置远端视频渲染填充方式，镜像模式 pullRemoteVideo 订阅或取消订阅远端用户 pullAllRemoteVideo 订阅或取消订阅全部远端用户，对未入会用户也有影响 setupRemoteView 设置远端用户窗口 setRemoteVideoAdjustResolution 远端流自动调整分辨率开关 setPriorRemoteVideoStreamType 大小流模式，设置所有订阅的远端视频流类型 setRemoteVideoStreamType 大小流模式，设置远端视频流类型 setRemoteViewRotation 设置远端视频旋转角度 setRemoteViewOrientation 设置远端视频横屏、竖屏展示

为什么无法上传媒资？ 可能有如下原因导致无法上传媒资： 未开通该区域的点播服务，或者点播服务不支持该区域 若使用API或者SDK上传媒资，该原因可能导致上传失败，建议您先在控制台确认对应区域的点播服务是否开通，是否可以正常使用。 上传的媒资格式不满足要求 您需要确认待上传的媒资格式是否满足 视频点播 服务的上传要求，具体支持上传的媒资格式和编码请参见视频点播支持上传哪些格式的音视频文件？。 账户欠费 您需要先登录华为云费用中心完成充值，然后重新登录视频点播控制台，重新上传媒资文件。 父主题： 上传问题

如何获取音视频文件的播放URL？ 在获取音视频文件的播放URL前，请确保已完成加速 域名 配置，并开启HTTPS安全加速。 音视频文件播放URL的获取方法如下所示： 登录视频点播控制台。 在左侧导航栏中选择“音视频管理”，进入音视频管理页面。 在对应的音视频文件行单击“管理”，选择“播放地址”页签。 在“地址”列可以获取对应格式的播放URL。若配置了Key防盗链功能，则可在“操作”列单击获取鉴权URL。 图1 播放地址 您也可以通过点播服务提供的SDK或API获取音视频的播放地址。 父主题： 播放问题