华为云用户手册

HRTCRemoteVideoStreamStateReason 表42 远端视频状态变化原因 枚举值 描述 HRTC_REMOTE_VIDEO_REASON_REMOTE_OFFLINE 远端用户离线 HRTC_REMOTE_VIDEO_REASON_REMOTE_MUTED 远端用户停止视频流发送 HRTC_REMOTE_VIDEO_REASON_REMOTE_UNMUTED 远端用户开启视频流发送 HRTC_REMOTE_VIDEO_REASON_LOCAL_MUTED 本端已取消选看远端视频流 HRTC_REMOTE_VIDEO_REASON_LOCAL_UNMUTED 本端已开启选看远端视频流

HRTCLeaveReason 表37 离开房间原因 枚举值 描述 HRTC_LEAVE_REASON_USER_LEAVE_ROOM 用户主动离开 HRTC_LEAVE_REASON_SERVER_ERROR 服务器异常 HRTC_LEAVE_REASON_BREAKDOWN sfu服务故障 HRTC_LEAVE_REASON_SERVICE_UNREACHABLE 服务不可达 HRTC_LEAVE_REASON_INTERNAL_ERROR 内部错误 HRTC_LEAVE_REASON_KICKED_OFF 被踢 HRTC_LEAVE_REASON_SIGNATURE_EXPIRED 签名过期 HRTC_LEAVE_REASON_RECONNECT_FAILED 重连超时

HRTCRemoteVideoStats 表18 远端视频流信息详情 属性 类型 描述 userId String 远端用户userId width int 视频宽 height int 视频高 bitRate int 视频码率 frameRate int 视频帧率，单位：fps packetLoss int 视频丢包率 delay int 时延，单位：ms jitter int 抖动 bytes long 字节数 rendererOutputFrameRate int 渲染帧率，单位：fps totalFrozenTime int 远端用户在加入房间后到离开房间前，发生视频卡顿的累计时长，单位：ms frozenRate int 远端用户在加入房间后到离开房间前，发生视频卡顿的累计时长占视频总有效时长的百分比，单位：%

HRTCLocalVideoStats 表16 本地视频流信息详情 属性 类型 描述 width int 视频宽 height int 视频高 bitRate int 视频码率 frameRate int 视频帧率，单位：fps packetLoss int 视频丢包率 delay int 时延，单位：ms jitter int 抖动 bytes long 字节数 sendFrameRate int 实际发送帧率，单位：fps

HRTCVideoEncParam 表12 视频编码参数属性说明 属性 类型 描述 streamType HR TCS treamType 视频流类型，根据HRT CS treamType和表14 不同分辨率下帧率和码率的推荐值设置需要的分辨率和宽高比 width int 视频宽度 height int 视频高度 frameRate int 视频帧率，可参考表14中的帧率进行设置 minFrameRate int 视频最小帧率，大于等于0，小于等于frameRate bitRate int 视频码率，可参考表14中的码率进行设置 minBitrate int 视频最小码率，大于等于0，小于等于bitrate 表13 视频编码参数方法说明 方法 描述 public HRTCVideoEncParam(HRTCStreamType streamType, int width, int height, int frameRate, int minFrameRate, int bitrate, int minBitrate)； 【功能说明】 HRTCVideoEncParam构造函数。 【请求参数】 streamType：视频流类型，具体请参见HRTCStreamType。 width：视频宽度。 height：视频高度。 frameRate：视频帧率。 minFrameRate：视频最小帧率。 bitrate：视频码率。 minBitrate：视频最小码率。 【返回参数】 HRTCVideoEncParam类对象。 public HRTCStreamType getStreamType()； 【功能说明】 获取视频流类型。 【请求参数】 无 【返回参数】 视频流类型，具体参见HRTCStreamType。 public void setStreamType(HRTCStreamType streamType)； 【功能说明】 设置视频流类型。 【请求参数】 streamType：流类型，具体请参见HRTCStreamType。 【返回参数】 视频流类型，具体参见HRTCStreamType。 表14 不同分辨率下帧率和码率的推荐值 分辨率 分辨率类型 比例 最小帧率（fps） 最大帧率（fps） 最小码率 最大码率 160 X 90 LD 16:9 10 30 64 270 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 表15 不同场景下帧率和码率的推荐值 分辨率 推荐帧率 通信场景推荐码率 直播场景推荐码率 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

HRTCStatsInfo 表11 统计信息 属性 类型 描述 mildlyFrozenCounts long 600ms卡顿次数 severelyFrozenCounts long 超过1s卡顿次数 totalMildlyFrozenTime long 600ms卡顿总时长 totalSeverelyFrozenTime long 1s卡顿总时长 totalActiveTime long 总时间，包括每一路选看的视频流启动到停止的时间总和

HRTCEncryptionConfig 表5 端到端加密参数 属性 类型 描述 cryptionMode HRTCCryptionMode 加密模式 cryptionSec String 加密秘钥，仅sdk加密模式下需要设置。必须是长度大于等于32的16进制字符串。 suiteType HRTCSuiteType 加密算法，当前仅支持HRTC_ENCRYPTION_128_CTR，sdk加密模式下需要设置 secFormat HRTCCryptionSecFormat 秘钥格式，当前只支持16进制字符串。

HRTCUserInfo 表8 用户信息 属性 类型 描述 userId String 用户ID userName String 用户名，UTF-8编码格式，可选。 ctime long 签名时间戳，单位秒，有signature时必选。 signature String 签名，可选，具体生成方法请参见接入鉴权。 role HRTCRoleType 角色 optionalInfo String 可选JSON字串[{key:param1,value:value1},{key:param2,value:value2}]

HRTCJoinParam 表9 入会参数 属性 类型 描述 userId String 用户ID，支持最大长度64，支持数字、字母大小写、下划线、中线、"."字符。 userName String 用户名，UTF-8编码格式，可选，支持最大长度128。 ctime long 签名时间戳，单位秒，有signature时必选。 authorization String 签名，必填，鉴权私钥请在应用管理中获取。签名的具体生成方法请参见接入鉴权。支持最大长度为1024。 role HRTCRoleType 角色。 optionalInfo String 可选JSON字串[{key:param1,value:value1},{key:param2,value:value2}] roomId String 房间Id，支持最大长度64，支持数字、字母大小写、下划线、中线字符。 autoSubscribeVideo boolean 是否自动订阅视频。 autoSubscribeAudio boolean 是否自动订阅音频。 scenario HRTCRemoteAudioMode 使用的场景。 0：主动订阅（默认）。 1：TopN（千人）。 2：P2P。 3：RTSA CMD自动订阅。

自采集自渲染 表8 自采集自渲染接口 接口 描述 windows是否支持 Mac是否支持 iOS是否支持 Android是否支持 setExternalVideoCapture 设置是否开启外部视频自采集 √ √ √ √ pushExternalVideoFrame 推送外部视频数据 √ √ √ √ setExternalVideoFrameOutput 设置是否开启视频流自渲染 √ √ √ √ setAuxiliaryExternalVideoFrameOutput 设置是否开启辅流自渲染 √ √ √ √ setExternalAudioCapture 设置是否开启外部音频自采集 √ √ √ √ pushExternalAudioFrame 推送外部音频数据 √ √ √ √ setExternalAudioFrameOutput 设置是否开启音频流自渲染 √ √ √ √

音频文件播放管理 表7 音频文件播放管理接口 接口 描述 windows是否支持 Mac是否支持 iOS是否支持 Android是否支持 startAudioFile 播放音频文件 √ √ √ √ stopAudioFile 停止播放音频文件 √ √ √ √ pauseAudioFile 暂停播放音频文件 √ √ √ √ resumeAudioFile 恢复播放音频文件 √ √ √ √ adjustAudioFileVolume 调整音频音量 √ √ √ √ adjustAudioFilePlayoutVolume 调整本地播放音频音量 √ √ √ √ getAudioFileVolume 获取音频音量 √ √ √ √ getAudioFilePlayoutVolume 获取本地播放音频音量 √ √ √ √ getAudioFileDuration 获取音频时长 √ √ √ √ getAudioFilePosition 获取音频播放位置 √ √ √ √ setAudioFilePosition 设置音频播放位置 √ √ √ √ getAudioClipsVolume 获取音效总音量 √ √ √ √ setAudioClipsVolume 设置音效总音量 √ √ √ √ getVolumeOfAudioClip 获取指定音效音量 √ √ √ √ setVolumeOfAudioClip 设置指定音效音量 √ √ √ √ playAudioClip 播放音效文件 √ √ √ √ stopAudioClip 停止播放指定音效 √ √ √ √ stopAllAudioClips 停止播放所有音效 √ √ √ √ pauseAudioClip 暂停播放指定音效 √ √ √ √ pauseAllAudioClips 暂停播放所有音效 √ √ √ √ resumeAudioClip 恢复播放指定音效 √ √ √ √ resumeAllAudioClips 恢复播放所有音效 √ √ √ √ getAudioClipCurrentPosition 获取指定音效当前播放位置 √ √ √ √ setAudioClipPosition 设置指定音效播放位置 √ √ √ √ getAudioClipDuration 获取音效文件时长 √ √ √ √

音频管理 表6 音频管理接口 接口 描述 windows是否支持 Mac是否支持 iOS是否支持 Android是否支持 enableLocalAudioStream 设置是否开启麦克风音频采集 √ √ √ √ adjustRecordingVolume 设置麦克风采集的音量（0-100） √ √ √ √ adjustPlaybackVolume 调整扬声器播放的音量（0-100） √ √ √ √ setShareComputerSound 设置是否开启系统音频采集、发送 √ √ x x muteLocalAudio 设置是否发送本地音频流 √ √ √ √ muteRemoteAudio 设置是否接收指定远端用户的音频流 √ √ √ √ muteAllRemoteAudio 设置是否接收远端所有用户的音频流 √ √ √ √ enableUserVolumeNotify 设置开启/关闭所有用户音量值上报并设置上报周期 √ √ √ √ setSpeakerModel 设置声音播放模式 x x √ √ echoTest 开始语音通话回路测试 √ x x x finishEchoTest 停止语音直播回路测试 √ x x x setDefaultSpeakerModel 设置默认声音播放模式 x x √ √ enableAudioTNR 设置是否开启音频降噪功能 √ √ √ √ sendAudioSeiMsg 发送音频SEI消息 √ √ √ √ setAudioFrameRecordParameters 设置音频采集回调的参数 √ √ √ √

辅流管理 表4 辅流管理接口 接口 描述 windows是否支持 Mac是否支持 iOS是否支持 Android是否支持 setRemoteAuxiliaryStreamViewRotation 设置远端辅流视图旋转角度 × x √ √ startRemoteAuxiliaryStreamView 开启辅流渲染视图（发起辅流选看） √ √ x √ stopRemoteAuxiliaryStreamView 关闭辅流渲染视图（停止辅流选看） √ √ x √ updateRemoteAuxiliaryStreamRenderMode 设置辅流视图显示模式，镜像模式 √ √ x √ setRemoteAuxiliaryStreamViewOrientation 设置远端辅流视图方向（横竖屏） × x √ √ setAuxiliaryVideoEncoderConfig 设置辅流编码参数 √ √ x √ setAuxiliaryVideoEncodeSmooth 设置是否开启辅流的流畅度优先（降低辅流选看分辨率） √ √ x √

屏幕共享 表5 屏幕共享接口 接口 描述 windows是否支持 Mac是否支持 iOS是否支持 Android是否支持 getScreenShareSources 获取屏幕可共享对象列表 √ √ x √ setScreenShareTarget 选择屏幕共享对象 √ √ x √ startScreenShare 开启屏幕共享 √ √ x √ stopScreenShare 停止屏幕共享 √ √ x √ addHiddenShareWindow 将指定窗口加入屏幕共享排除列表 √ √ x √ deleteHiddenShareWindow 将指定窗口从屏幕共享排除列表中移除 √ √ x √ removeAllHiddenShareWindow 将所有窗口从屏幕共享排除列表中移除 √ √ x √ getScreenShareSources 获取屏幕可共享对象列表，包含缩略图 √ x x x

视频管理 表3 视频管理接口 接口 描述 windows是否支持 Mac是否支持 iOS是否支持 Android是否支持 enableLocalVideo 设置是否开启本地摄像头采集视频 √ √ √ √ setVideoEncoderConfig 设置视频发流编码参数 √ √ √ √ enableSmallVideoStream 大小流模式设置是否开启小流并设置小流编码参数 √ √ √ √ startLocalPreview 开始本地预览 √ √ √ √ stopLocalPreview 关闭本地预览 √ √ √ √ setupLocalView 设置本地渲染视图 √ √ √ √ updateLocalRenderMode 设置本地视图渲染模式，镜像模式 √ √ √ √ setupRemoteView 设置远端流渲染视图（发起选看，参数置空则停止选看） √ √ √ √ updateRemoteRenderMode 设置远端用户视图渲染模式，镜像模式 √ √ √ √ setRemoteVideoStreamType 大小流模式，设置远端视频流类型 √ √ √ √ setPriorRemoteVideoStreamType 大小流模式，设置所有订阅的远端视频流类型。 √ √ √ √ pushLocalVideo 设置是否发送本地视频流 √ √ √ √ pullAllRemoteVideo 设置是否接收所有用户的视频流 √ √ √ √ startRemoteStreamView 设置远端用户渲染视图（发起选看-老接口） √ √ √ √ stopRemoteStreamView 关闭远端用户的渲染视图（停止选看） √ √ √ √ setRemoteVideoAdjustResolution 设置是否开启远端分辨率自适应 √ √ √ √ setVideoEncoderMirror 设置编码器输出的画面（本地发流）镜像模式 √ √ √ √ setCameraConfig 设置摄像头参数 × × √ √ switchCamera 切换摄像头，移动端 × x √ √ startAllRemoteView 批量设置远端流视图 √ √ √ √ setRemoteViewRotation 设置远端流视图旋转角度 × x √ √ setRemoteViewOrientation 设置远端流视图方向(横竖屏) × x √ √ setVideoPaddingImage 设置关闭视频发流时发送的图片 √ √ √ √ pullAllRemoteVideo 设置是否接收所用户的视频流 √ √ √ √ setBeautyRetouchOption 设置是否开启美颜功能 × x √ √ enableVideoBrighten 设置是否开启增亮功能 √ × x x ApplyGSensorMode 设置是否开启重力感应 × x √ x startPublishStream 开始旁路推流 √ √ √ √ updateTransCoding 更新旁路推流 √ √ √ √ stopPublishStream 停止旁路推流 √ √ √ √ setVideoWaterMark 插入/删除水印 √ x x x setBackgroundBlur 设置本地视频背景虚化 √ x x √ setBackgroundReplace 设置本地视频背景替换 √ x x √ appendLocalView 设置本地视频另一个窗口显示 √ √ x x appendRemoteView 设置远端视频另一个窗口显示 √ √ x x

房间功能 表2 房间功能接口 接口 描述 windows是否支持 Mac是否支持 iOS是否支持 Android是否支持 joinRoom 加入房间 √ √ √ √ leaveRoom 离开房间 √ √ √ √ renewAuthorization 签名更新 √ √ √ √ changeUserRole 设置用户的角色，角色切换使用 √ √ √ √ changeUserName 设置用户自己的昵称 √ √ √ √ createConnection 创建连接。跨房前需先创建连接 √ √ √ √ addMultiRoomMediaRelay 添加单个跨房 √ √ √ √ removeMultiRoomMediaRelay 删除单个跨房 √ √ √ √ stopMultiRoomMediaRelay 停止所有跨房 √ √ √ √ subscribeAISubtitles 订阅AI字幕 √ √ √ √

初始化等基础接口 表1 初始化等基础接口 接口 描述 windows是否支持 Mac是否支持 iOS是否支持 Android是否支持 createHRtcEngine 创建IHRTCEngine对象 √ √ √ √ getHRtcEngine 获取创建后的IHRTCEngine对象 √ √ √ √ enableStats 开启打点统计，在initialize前调用 √ √ √ √ initialize IHRtcEngine对象初始化函数 √ √ √ √ release 释放IHRtcEngine对象资源，退出时调用 √ √ √ √ logUpload 开启日志上传 √ √ √ √ getVersion 获取当前SDK版本号 √ √ √ √ getAudioDeviceManager 获取系统音频设备管理对象 √ √ √ √ getVideoDeviceManager 获取系统视频设备管理对象 √ √ √ √ setJniLoadParams 设置jvm context 仅安卓使用 × × × √ setEncryption 设置端到端加密模式 √ √ √ √ setAccessResourceType 设置接入环境 √ √ √ √ setNetworkBandwidth 设置网络带宽限制 √ √ √ √ renewAppid 设置Appid √ √ √ √

HRTCShareSourceInfoChangedType 表97 HRTCShareSourceInfoChangedType 属性 描述 HRTC_SHARE_SOURCE_INFO_CHANGED_DIALED_OUT 正在共享的屏幕被拨出 HRTC_SHARE_SOURCE_INFO_CHANGED_RESOLUTION_CHANGE 分辨率有变化 HRTC_SHARE_SOURCE_INFO_CHANGED_REGION_CHANGE 区域有变化 HRTC_SHARE_SOURCE_INFO_CHANGED_NUM_REDUCE 屏幕个数有减少 HRTC_SHARE_SOURCE_INFO_CHANGED_NUM_INCREASE 屏幕个数有增加 HRTC_SHARE_SOURCE_INFO_CHANGED_IS_BLOCKED 正在共享的窗口被遮挡了 HRTC_SHARE_SOURCE_INFO_CHANGED_CLOSE 正在共享的窗口关闭了 HRTC_SHARE_SOURCE_INFO_CHANGED_MINIMIZE 正在共享的窗口最小化了 HRTC_SHARE_SOURCE_INFO_CHANGED_VALID_AREA_LESS_THAN_96 窗口有效区域小于96

HRTCMultiRoomMediaRelayState 表103 跨房状态 属性 描述 HRTC_MULTI_ROOM_MEDIA_RELAY_STATE_IDLE 就绪状态 HRTC_MULTI_ROOM_MEDIA_RELAY_STATE_CONNECTING 正在连接 HRTC_MULTI_ROOM_MEDIA_RELAY_STATE_RUNNING 主播成功加入目标房间 HRTC_MULTI_ROOM_MEDIA_RELAY_STATE_FAILURE 发生异常

HRTCEngineContext 表92 引擎初始化参数 属性 类型 描述 engineConfig HRTCEngineConfig 引擎配置项，具体请参见HRTCEngineConfig。 logConfig HRTCLogConfig 日志配置项，具体请参见HRTCLogConfig。 eventHandler IHRTCEngineEventHandler 事件回调，具体请参见IHRTCEngineEventHandler。

HRTCLogConfig 表93 日志参数 属性 类型 描述 level HRTCLogLevel 日志级别，具体请参见HRTCLogLevel，默认值 HRTC_ LOG _LEVEL_DEBUG，推荐使用HRTC_LOG_LEVEL_DEBUG。 path const char * 日志路径，需调用方保证路径合法可用，rtc仅做基础校验 logSize int 日志大小，默认值10M，推荐10M enable bool 日志开关

HRTCMultiRoomMediaRelayStateCode 表104 跨房状态码 属性 描述 HRTC_MULTI_ROOM_MEDIA_RELAY_OK 正常状态 HRTC_MULTI_ROOM_MEDIA_RELAY_ERROR_SERVER_NO_RESPONSE 服务端无响应 HRTC_MULTI_ROOM_MEDIA_RELAY_ERROR_INTERNAL_ERROR 服务器内部出错 HRTC_MULTI_ROOM_MEDIA_RELAY_ERROR_USER_OVER_LIMIT 用户跨房超出限制数 HRTC_MULTI_ROOM_MEDIA_RELAY_ERROR_ROOM_OVER_LIMIT 房间跨房用户超出限制数 HRTC_MULTI_ROOM_MEDIA_RELAY_ERROR_ROOM_REQ_EMPTY 跨房请求消息体为空 HRTC_MULTI_ROOM_MEDIA_RELAY_ERROR_ROOM_OPERATION_CONFLICT 跨房请求，加入和退出存在冲突 HRTC_MULTI_ROOM_MEDIA_RELAY_ERROR_ROOM_SRC_USERINFO_INVALID 跨房请求原用户信息无效 HRTC_MULTI_ROOM_MEDIA_RELAY_ERROR_ROOM_WITH_ORI 跨房房间与原用户房间相同 HRTC_MULTI_ROOM_MEDIA_RELAY_ERROR_ROOM_REPEAT 跨房请求房间重复 HRTC_MULTI_ROOM_MEDIA_RELAY_ERROR_ROOM_USER_EXISTED 跨房用户已存在 HRTC_MULTI_ROOM_MEDIA_RELAY_ERROR_INVALID_REQUEST 无效请求 HRTC_MULTI_ROOM_MEDIA_RELAY_ERROR_ROOM_IS_NOT_EXIST 房间不存在 HRTC_MULTI_ROOM_MEDIA_RELAY_ERROR_F RAM E_TYPE_NOT_EQUAL 跨房源房间和目的房间加密模式不一致 HRTC_MULTI_ROOM_MEDIA_RELAY_ERROR_AUTHENTICATION_FAILURE 鉴权失败 HRTC_MULTI_ROOM_MEDIA_RELAY_ERROR_REMOVE_INFO_NOT_EXIST 退出跨房信息不存在 HRTC_MULTI_ROOM_MEDIA_RELAY_ERROR_EXCEPTION_STOP 异常退出跨房

HRTCAudioFileReason 表77 音频播放状态改变原因 枚举值 描述 HRTC_AUDIO_FILE_REASON_NONE 没有错误 HRTC_AUDIO_FILE_REASON_URL_NOT_FOUND 未找到URL HRTC_AUDIO_FILE_REASON_CODEC_NOT_SUPPORTED 解码器不支持该编码 HRTC_AUDIO_FILE_REASON_INVALID_ARGUMENTS 非法参数 HRTC_AUDIO_FILE_REASON_SRC_BUFFER_UNDERFLOW 播放缓冲区数据不足 HRTC_AUDIO_FILE_REASON_INTERNAL 内部错误 HRTC_AUDIO_FILE_REASON_INVALID_STATE 播放器内部状态错误 HRTC_AUDIO_FILE_REASON_NO_RESOURCE 没有该资源 HRTC_AUDIO_FILE_REASON_OBJ_NOT_INITIALIZED 对象未初始化 HRTC_AUDIO_FILE_REASON_INVALID_CONNECTION_STATE 播放器与服务器连接无效 HRTC_AUDIO_FILE_REASON_UNKNOWN_STREAM_TYPE 未知的媒体流类型 HRTC_AUDIO_FILE_REASON_VIDEO_RENDER_FAILED 渲染失败 HRTC_AUDIO_FILE_REASON_INVALID_MEDIA_SOURCE 无效的媒体资源 HRTC_AUDIO_FILE_REASON_UNKNOWN 状态未知

HRTCMediaOptions 表78 音视频自动选看和订阅选项 属性 描述 bool autoSubscribeAudio 自动订阅远端用户音频流 bool autoSubscribeVideo 自动订阅远端用户视频流 HRTCMediaOptions() { autoSubscribeAudio = true; autoSubscribeVideo = true; } 初始化构造默认true自动订阅和选看

HRTCAudioFileState 表76 访问区域 枚举值 描述 HRTC_AUDIO_FILE_OPEN_COMPLETED 成功打开音频文件 HRTC_AUDIO_FILE_OPENING 正在打开音频文件 HRTC_AUDIO_FILE_IDLE 音频文件播放就绪 HRTC_AUDIO_FILE_PLAYING 音频文件播放中 HRTC_AUDIO_FILE_PLAY_COMPLETED 音频文件播放完成 HRTC_AUDIO_FILE_PAUSED 音频文件暂停播放 HRTC_AUDIO_FILE_STOPPED 音频文件停止播放 HRTC_AUDIO_FILE_FAILED 音频文件播放失败 HRTC_AUDIO_FILE_POSITION_UPDATE 音频文件播放进度更新 HRTC_AUDIO_FILE_STATE_UNKNOWN 音频文件播放状态未知

HRTCTranscodeConfig 表84 HRTCTranscodeConfig 属性 描述 HRTCRtmpConfig config Rtmp推流通用配置，如码率等，具体请参见表85 HRTCRtmpUserInfo rtmpUserInfo[50] Rtmp推流的用户流信息，具体请参见表86 表85 HRTCRtmpConfig 属性 描述 int width 旁路推流的输出视频流的总宽度，单位为px。默认值为360，取值范围为[64-1920] int height 旁路推流的输出视频流的总高度，单位为px。默认值为640，取值范围为[64-1920] int videoBitrate 旁路推流的输出视频的码率，单位为Kbps。默认值为400Kbps，取值范围为[32-2760] int videoFramerate 旁路推流的输出视频的帧率，单位为fps。默认值为15，取值范围为[10,30] int videoGop 用于旁路直播的输出视频的GOP，单位为帧。默认值为30帧，取值范围为[1-300] int audioSampleRate 用于旁路直播的输出音频的采样率，默认为16000，取值范围为[16000-96000] int audioBitrate 旁路直播的输出音频的码率，单位为Kbps。默认值为48，最大值为128，取值范围为[1-128] int audioChannels 旁路直播的输出音频的声道数，默认为1，取值范围为[1-5] int tmplate 0表示悬浮，1表示九宫格，2表示屏幕分享，默认为0 表86 HRTCRtmpUserInfo 属性 描述 char userId[64] 用户id bool main 是否推大流 bool slides 是否推小流 bool desktop 是否推桌面流 bool audio 是否推音频流 表87 HRTCRtmpUserInfoList 属性 描述 int nSize 数组大小 HRTCRtmpUserInfo rtmpUserInfo[50] 结构体数组

HRTCOnStats 表75 统计信息 属性 描述 double cpuAppUsage app的cpu利用率 double cpuTotalUsage cpu总利用率 unsigned int memoryAppUsageInKbytes app占用内存 double memoryAppUsageRatio app内存占用率 double memoryTotalUsageRatio 总的内存利用率 int gatewayRtt 到本地网关的延迟 unsigned long long sendBytes 总的发送字节数 unsigned long long sendVideoBytes 视频的发送字节数 unsigned long long sendAudioBytes 音频的发送字节数 unsigned long long receiveBytes 总的接收字节数 unsigned long long receiveVideoBytes 视频的接收字节数 unsigned long long receiveAudioBytes 音频的接收字节数 unsigned int sendBitRate 总的发送比特率 unsigned int sendVideoBitRate 视频的发送比特率 unsigned int sendAudioBitRate 音频的发送比特率 unsigned int receiveBitRate 总的接收比特率 unsigned int receiveVideoBitRate 视频的接收比特率 unsigned int receiveAudioBitRate 音频的接收比特率 unsigned int sendLossRate 发送丢包率 unsigned int receiveLossRate 接收丢包率 unsigned int lastmileDelay 到服务器的延迟

HRTCAreaCode 表73 访问区域 枚举值 描述 HRTC_AREA_CODE_GLOB 全球（默认） HRTC_AREA_CODE_CN 中国 HRTC_AREA_CODE_NA 中北美 HRTC_AREA_CODE_SA 拉美 HRTC_AREA_CODE_EU 欧洲 HRTC_AREA_CODE_SEA 东南亚 HRTC_AREA_CODE_AF 非洲 HRTC_AREA_CODE_AS 亚洲

HRTCSetupRemoteViewResult 表74 批量选看结果 属性&函数 描述 char userId[HRTCConstant::HRTC_MAX_USERID_LEN + 1] 用户ID unsigned char result 选看结果 int code 状态码 0：成功 1：失败 char reason[HRTCConstant::HRTC_MAX_WATCH_RESULT_REASON_LEN + 1] 原因描述

HRTCRotationParam 表51 摄像头参数 属性 描述 int captureIndex 0：前置摄像头 1：后置摄像头 int captureRotation 0：不旋转 1：逆时针旋转90度 2：逆时针旋转180度 3：逆时针旋转270度 int wndType 保留参数，当前默认设置为1 int displayRotation 0：不旋转 1：逆时针旋转90度 2：逆时针旋转180度 3：逆时针旋转270度