华为云用户手册

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自动订阅。

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}]

自采集自渲染 表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 √ √ √ √

HR TCS hareSourceInfoChangedType 表97 HRT CS hareSourceInfoChangedType 属性 描述 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 发生异常

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 异常退出跨房

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 日志开关

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 到服务器的延迟

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自动订阅和选看

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] 原因描述

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] 结构体数组

HRTCLocalAudioStreamStateReason 表63 本地音频状态变化原因 枚举值 描述 HRTC_LOCAL_AUDIO_REASON_ERROR_OK 本地音频流状态正常 HRTC_LOCAL_AUDIO_REASON_ERROR_FAILURE 本地音频流出错原因不明确 HRTC_LOCAL_AUDIO_REASON_ERROR_RECORD_FAILURE 本地音频流录制失败，建议您检查录制设备是否正常工作 HRTC_LOCAL_AUDIO_REASON_ERROR_STOP_FAILURE 关闭采集失败 HRTC_LOCAL_AUDIO_REASON_ERROR_AC CES S_DENIED 音频设备无法访问，可能是设备隐私权限设置问题 HRTC_LOCAL_AUDIO_REASON_ERROR_ON_EXCLUSIVE_MODE 音频设备处于独占模式，且被其他应用独占，可以通知用户取消独占模式 HRTC_LOCAL_AUDIO_REASON_ERROR_ENDPOINT_CREATE_FAILED 音频设备终端创建失败，音频设备被拔出，或者已重新配置，禁用，删除了音频硬件或关联的硬件资源不可用。使用其他音频设备，重启或者更新驱动（仅适用于Windows） HRTC_LOCAL_AUDIO_REASON_ERROR_MMSYSERR_INVALPARAM 音频设备API非法参数，目前已知是杀毒软件导致（仅适用于Windows） HRTC_LOCAL_AUDIO_REASON_ERROR_MMSYSERR_NODRIVER 音频设备API返回无驱动，需要用户升级驱动（仅适用于Windows） HRTC_LOCAL_AUDIO_REASON_ERROR_AUDIO_SERVER_NOT_RUNNING 用户windows audio服务未启动，或者启动失败（仅适用于Windows） HRTC_LOCAL_AUDIO_REASON_ERROR_NO_DEVICE 没有设备（仅适用于Windows） HRTC_LOCAL_AUDIO_REASON_ERROR_RESTART_FAILED 扬声器播放无数据，重启失败

HRTCEngineConfig 表71 引擎初始化配置 属性 类型 描述 appId const char * 应用ID，只有App ID相同的应用程序才能进入同一个房间进行互动。appId获取方法请参见应用管理。 countryCode const char * 国家码，具体值请参见国家码对照表 enableHaTrace bool 打点开关 muteAudioRoute bool 是否禁音频路由 enableAudio bool 音频模块开关 enableVideo bool 视频模块开关 enableShare bool 共享模块开关 audioScene HRTCAudioSceneType 音频场景，会议/音乐 audioQualityLevel HRTCAudioQualityLevel 音频档位，16k/48k

HRTCRemoteVideoStreamStateReason 表45 远端视频状态变化原因 枚举值 描述 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 本端已开启选看远端视频流

HRTCScreenShareSourceInfo 表57 共享屏幕对象信息 属性 描述 void* sourceId 采集源ID，如果是窗口共享，则为窗口句柄(HWND) char sourceName[HRTCConstant::HRTC_MAX_SOURCE_NAME_LEN + 1] 采集源名称，如果是窗口共享，则为窗口对应名称 HRTCScreenShareType type 共享类型，具体请参见HRTCScreenShareType void* icon type是HRTC_WINDOW_CAPTURE才有效，返回类型是Windows资源类型HICON

HRTCRemoteAudioMode 表69 远端音频流收流模式 枚举值 描述 HRTC_REMOTE_AUDIO_SUBSCRIBED = 0 订阅模式（自主订阅） HRTC_REMOTE_AUDIO_TOP_THREE = 1 TopN模式（收音量最大的三路流） HRTC_REMOTE_AUDIO_P2P = 2 P2P模式 HRTC_REMOTE_AUDIO_RTSA_CMD = 3 RTSA-CMD模式

HRTCNetworkQualityLevel 表49 网络质量信号等级 枚举值 描述 HRTC_NETWORK_QUALITY_UNKNOWN=0 网络质量未知 HRTC_NETWORK_QUALITY_EXCELLENT 网络质量非常好 HRTC_NETWORK_QUALITY_GOOD 网络质量好 HRTC_NETWORK_QUALITY_POOR 网络质量一般 HRTC_NETWORK_QUALITY_BAD 网络质量差 HRTC_NETWORK_QUALITY_VBAD 网络质量非常差

HRTCLocalVideoStreamStateReason 表65 本地视频状态变化原因 枚举值 描述 HRTC_LOCAL_VIDEO_REASON_ERROR_OK 本地视频流状态正常 HRTC_LOCAL_VIDEO_REASON_ERROR_FAILURE 本地视频流出错原因不明确 HRTC_LOCAL_VIDEO_REASON_ERROR_CAPTURE_FAILURE 本地视频流录制失败，建议您检查录制设备是否正常工作 HRTC_LOCAL_VIDEO_REASON_ERROR_STOP_FAILURE 关闭采集失败 HRTC_LOCAL_VIDEO_REASON_ERROR_CAPTURE_DEVICE_NO_PERMISSION 没有摄像头权限 HRTC_LOCAL_VIDEO_REASON_ERROR_CAPTURE_DEVICE_BUSY 摄像头设备已占用 HRTC_LOCAL_VIDEO_REASON_ERROR_CAPTURE_APP_IN_BACKGROUND 应用处于后台，仅适用Android和iOS HRTC_LOCAL_VIDEO_REASON_ERROR_CAPTURE_OPEN_CAMERA_FAILED 打开摄像头设备失败 HRTC_LOCAL_VIDEO_REASON_ERROR_CAPTURE_MULTIPLE_FOREGROUND_APP 应用窗口处于侧拉、分屏、画中画模式（仅适用于iOS） HRTC_LOCAL_VIDEO_REASON_ERROR_CAPTURE_DEVICE_DISCONNECTED 本地视频采集设备未连接（仅适用Windows和macOS）

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度