开发者如何依托 ERTC 枚举配置音视频编码参数？

做萤石二次开发的哈哈

229人浏览 · 2026-07-27 09:28:35

做萤石二次开发的哈哈 · 2026-07-27 09:28:35 发布

ERTC SDK 类型定义-Windows.md

ERTC 类型定义

枚举定义

ERTCLogLevel

日志级别

类型	描述
ERTCLogLevelNone	不输出任何 SDK Log
ERTCLogLevelError	输出ERROR 级别的 Log
ERTCLogLevelWarn	输出WARN 级别的 Log
ERTCLogLevelInfo	输出INFO 级别的 Log
ERTCLogLevelDebug	输出Debug 级别的 Log
ERTCLogLevelTrace	输出TRACE 级别的 Log

ERTCVideoStreamType

视频流类型

类型	描述
ERTCVideoStreamTypeBig	高清大画面，一般用来传输摄像头的视频数据
ERTCVideoStreamTypeSmall	低清小画面：小画面和大画面的内容相互，但是分辨率和码率都比大画面低，因此清晰度也更低
ERTCVideoStreamTypeSub	辅流画面：一般用于屏幕分享，同一时间在同一个房间中只允许一个用户发布辅流视频，其他用户必须要等该用户关闭之后才能发布自己的辅流。

ERTCVideoResolution

视频分辨率

类型	描述
ERTCVideoResolution_120_120	宽高比 1:1；分辨率 120x120；建议码率（VideoCall）80kbps; 建议码率（LIVE）120kbps
ERTCVideoResolution_160_160	宽高比 1:1；分辨率 160x160；建议码率（VideoCall）80kbps; 建议码率（LIVE）120kbps
ERTCVideoResolution_270_270	宽高比 1:1；分辨率 270x270；建议码率（VideoCall）200kbps; 建议码率（LIVE）300kbps
ERTCVideoResolution_480_480	宽高比 1:1；分辨率 480x480；建议码率（VideoCall）350kbps; 建议码率（LIVE）500kbps
ERTCVideoResolution_160_120	宽高比4:3；分辨率 160x120；建议码率（VideoCall）100kbps; 建议码率（LIVE）150kbps
ERTCVideoResolution_240_180	宽高比 4:3；分辨率 240x180；建议码率（VideoCall）150kbps; 建议码率（LIVE）250kbps
ERTCVideoResolution_280_210	宽高比 4:3；分辨率 280x210；建议码率（VideoCall）200kbps; 建议码率（LIVE）300kbps
ERTCVideoResolution_320_240	宽高比 4:3；分辨率 320x240；建议码率（VideoCall）250kbps; 建议码率（LIVE）375kbps
ERTCVideoResolution_400_300	宽高比 4:3；分辨率 400x300；建议码率（VideoCall）300kbps; 建议码率（LIVE）450kbps
ERTCVideoResolution_480_360	宽高比 4:3；分辨率 480x360；建议码率（VideoCall）400kbps; 建议码率（LIVE）600kbps
ERTCVideoResolution_640_480	宽高比 4:3；分辨率 640x480；建议码率（VideoCall）600kbps; 建议码率（LIVE）900kbps
ERTCVideoResolution_960_720	宽高比 4:3；分辨率 960x720；建议码率（VideoCall）1000kbps; 建议码率（LIVE）1500kbps
ERTCVideoResolution_160_90	宽高比 16:9；分辨率 160x90；建议码率（VideoCall）150kbps; 建议码率（LIVE）250kbps
ERTCVideoResolution_256_144	宽高比 16:9；分辨率 256x144；建议码率（VideoCall）200kbps; 建议码率（LIVE）300kbps
ERTCVideoResolution_320_180	宽高比 16:9；分辨率 320x180；建议码率（VideoCall）250kbps; 建议码率（LIVE）400kbps
ERTCVideoResolution_480_270	宽高比 16:9；分辨率 480x270；建议码率（VideoCall）350kbps; 建议码率（LIVE）550kbps
ERTCVideoResolution_640_360	宽高比 16:9；分辨率 640x360；建议码率（VideoCall）500kbps; 建议码率（LIVE）900kbps
ERTCVideoResolution_960_540	宽高比 16:9；分辨率 960x540；建议码率（VideoCall）850kbps; 建议码率（LIVE）1300kbps
ERTCVideoResolution_1280_720	宽高比 16:9；分辨率 1280x720；建议码率（VideoCall）1200kbps; 建议码率（LIVE）1800kbps
ERTCVideoResolution_1920_1080	宽高比 16:9；分辨率 1920x1080；建议码率（VideoCall）2000kbps; 建议码率（LIVE）3000kbps

ERTCVideoFPS

视频帧率

类型	描述
ERTCVideoFPS_1	1 fps
ERTCVideoFPS_5	5 fps
ERTCVideoFPS_10	10 fps
ERTCVideoFPS_11	11 fps
ERTCVideoFPS_12	12 fps
ERTCVideoFPS_13	13 fps
ERTCVideoFPS_14	14 fps
ERTCVideoFPS_15	15 fps
ERTCVideoFPS_16	16 fps
ERTCVideoFPS_17	17 fps
ERTCVideoFPS_18	18 fps
ERTCVideoFPS_19	19 fps
ERTCVideoFPS_20	20 fps
ERTCVideoFPS_25	25 fps
ERTCVideoFPS_30	30 fps
ERTCVideoFPS_60	60 fps

ERTCVideoFillMode

视频画面填充模式

类型	描述
ERTCVideoFillMode_Fill	填充模式：即将画面内容居中等比缩放以充满整个显示区域，超出显示区域的部分将会被裁剪掉，此模式下画面可能不完整
ERTCVideoFillMode_Fit	适应模式：即按画面长边进行缩放以适应显示区域，短边部分会被填充为黑色，此模式下图像完整但可能留有黑边

ERTCVideoMirrorType

视频的镜像类型

类型	描述
ERTCVideoMirrorType_Auto	自动模式
ERTCVideoMirrorType_Enable	强制开启镜像
ERTCVideoMirrorType_Disable	强制关闭镜像

ERTCQuality

网络质量

类型	描述
ERTCQuality_Unknown	未定义
ERTCQuality_Excellent	当前网络非常好
ERTCQuality_Good	当前网络比较好
ERTCQuality_Poor	当前网络一般
ERTCQuality_Bad	当前网络较差
ERTCQuality_Vbad	当前网络很差
ERTCQuality_Down	当前网络不满足 TRTC 的最低要求
ERTCQuality_Unsupported	暂时无法检测到网络质量
ERTCQuality_Detecting	网络质量检测已开始还没有完成

ERTCConfigKey

配置类型

类型	描述
ERTCConfigQualityInterval	质量数据上抛时间间隔
ERTCConfigInputVideoFilter	本地视频采集处理设置，#ERTCVideoFilter
ERTCConfigPlayVideoFilter	远端视频播放处理设置
ERTCConfigServerLineId	配置服务器线路选择(建议在初始化前设置)，#ERTCServerLineID

常用结构

ERTCLogConfig

日志配置信息

字段名	类型	说明
filePath	char*	码流文件存储路径
level	ERTCLogLevel	日志级别

ERTCEngineContext

初始化配置

字段名	类型	说明
appId	char*	应用标识
logConfig	ERTCLogConfig	日志配置

ERTCParams

进房参数

字段名	类型	说明
userId	char*	用户标识
roomId	char*	字符串房间号
token	char*	用户签名

ERTCVideoEncParam

视频编码参数

字段名	类型	说明
videoResolution	ERTCVideoResolution	视频分辨率如需使用竖屏分辨率，请指定 resMode 为 Portrait，例如： 640 × 360 + Portrait = 360 × 640
videoFps	ERTCVideoFPS	视频采集帧率 15fps或20fps。5fps以下，卡顿感明显。10fps以下，会有轻微卡顿感。20fps以上，会浪费带宽（电影的帧率为24fps）
videoBitrate	unsigned int	目标视频码率，单位Kbps，SDK 会按照目标码率进行编码，只有在弱网络环境下才会主动降低视频码率

ERTCVolumeInfo

音量大小

字段名	类型	说明
userId	string	说话者的 userId
volume	uint32_t	说话者的音量大小, 取值范围[0 - 100]

ERTCLocalVideoStats

本地视频质量数据

字段名	类型	说明
sentBitrate	uint32_t	视频传输码率(上行)
frameRate	uint32_t	帧率大小
packetLossRate	uint16_t	视频丢包率
streamType	ERTCVideoStreamType	流类型 0：大码流 1：小码流 2：屏幕共享流
width	uint32_t	视频宽
height	uint32_t	视频高
totalPacketCount	uint32_t	发视频总包数
compensateLossRate	uint16_t	补偿后丢包率

ERTCLocalAudioStats

本地音频质量数据

字段名	类型	说明
sentBitrate	uint32_t	音频传输码率
packetLossRate	uint16_t	音频丢包率
totalPacketCount	uint32_t	发音频总包数

ERTCRemoteVideoStats

远端视频质量数据

字段名	类型	说明
userId	string	远端视频用户ID
receivedBitrate	uint32_t	远端视频传输码率（下行）
frameRate	uint32_t	远端帧率大小
totalFrozenTime	uint32_t	远端视频总的卡顿时长
videoFrozenRate	int32_t	远端视频卡顿比
packetLossRate	uint16_t	视频丢包率
streamType	ERTCVideoStreamType	流类型 0：大码流 1：小码流 2：屏幕共享流
width	uint32_t	视频宽
height	uint32_t	视频高
videoPacketCount	int32_t	接收视频总包数
uncompensateLoss	uint16_t	视频补偿前丢包率（％）

ERTCRemoteAudioStatistics

远端音频实时数据

字段名	类型	说明
userId	string	远端音频用户ID
receivedBitrate	uint32_t	远端音频传输码率（下行）
packetLossRate	uint32_t	远端音频丢包率(下行)
totalFrozenTime	uint32_t	远端音频总的卡顿时长
totalFrozenTime	uint32_t	远端音频卡顿比
totalPacketCount	int32_t	接收音频总包数
plcPacketCount	uint32_t	音频帧补偿数量
uncompensateLoss	uint32_t	音频补偿前丢包率（％）
totalTime	uint32_t	播放音频总时间

ERTCSpeedTestParams

测速参数

字段名	类型	说明
expectedUpBandwidth	uint32_t	预期的上行带宽（kbps，取值范围： 10 ～ 5000，为 0 时不测试）
expectedDownBandwidth	uint32_t	预期的下行带宽（kbps，取值范围： 10 ～ 5000，为 0 时不测试）
testInterval	uint32_t	测试时间间隔（统计间隔（毫秒）,取值范围1000ms~60000ms）

ERTCSpeedTestResult

网络测速结果

字段名	类型	说明
success	BOOL	测试是否成功
quality	ERTCQuality	网络质量
upLostRate	uint32_t	上行丢包率，取值范围是 [0 - 100]，例如 30% 表示每向服务器发送 10 个数据包可能会在中途丢失 3 个
downLostRate	uint32_t	下行丢包率，取值范围是 [0 - 100]，例如 20% 表示每从服务器收取 10 个数据包可能会在中途丢失 2 个
rtt	int32_t	延迟（毫秒），指当前设备到服务器的一次网络往返时间，该值越小越好，正常数值范围是10ms - 100ms
availableUpBandwidth	int	上行带宽（kbps，-1：无效值）
availableDownBandwidth	int	下行带宽（kbps，-1：无效值）

萤石致力于成为全球领先的智能视觉物联网服务商，构建了全球领先的视觉物联网云平台，打造了硬件产品+软件云服务一体化的物联网服务体系。萤石云通过构建多数据中心+就近服务点的方式服务于全球客户。截至2025 年底，萤石物联网云平台在全球拥有超过120 个数据站点，平台上的IoT 设备接入数超过3.6 亿，其中视频类设备超过3 亿。在夯实自身平台能力的基础上，萤石进一步开放技术能力，将物联价值延伸至千行百业。萤石开放平台深度融合AI中台能力，涵盖音视频多媒体、消息通知处理、智能算法调度、视频存储备份、ERTC、大数据、物联接入等，已为智慧连锁、智慧养老、文教娱乐、畜牧养殖等42万余位行业客户提供数智化转型升级支撑；萤石物联专有云支持专有化部署，助力中大型企业和组织的数字化转型升级。

火山引擎视频云技术社区

火山引擎视频云技术社区，是面向 AI 音视频开发者的技术交流平台。这里汇聚源自抖音、豆包等亿级 DAU 产品的 RTC、直播、点播、AI 媒体处理、音视频互动技术，提供接入指南、最佳实践、性能调优、场景案例、Demo 代码、开源项目、白皮书和 API 文档。社区汇聚官方工程师与一线开发者，为 AI 视频通话、数字人、AI 视频处理等应用的开发与落地提供技术支持。

更多推荐

洛雪音乐桌面版完整实战：找歌、攒列表、定制与排障一次讲清

装完洛雪音乐桌面版（lx-music-desktop），很多人卡在同一件事上：歌是搜到了，播放却不一定响得起来，或者听了几首歌就不知道往哪放。这个基于 Electron + Vue 3 开发的开源播放器，默认设置并不刻意迁就新手，但它的五个在线音乐源、本地列表管理、桌面歌词和音效模块，只要按顺序摸一遍，日常使用就足够了。这篇指南按"找歌 → 攒列表 → 调体验 → 进阶玩法 → 故障排查"五个环节

火山引擎视频云技术社区

基于 WebRTC-Experiment 的 Firefox 屏幕捕获扩展：从自定义域名到 AMO 发布全指南

> 本文以 [Firefox-Extensions/README.md](https://link.gitcode.com/i/d51aa89ee4d31cc869ed4221467fa333) 为主体，结合仓库内 `enable-screen-capturing` 等目录的源码，讲解如何通过 Firefox 扩展为 WebRTC 页面启用屏幕捕获能力：包括扩展的工作原理（preference 白

火山引擎视频云技术社区

洛雪音乐桌面版：5 个快捷键加 3 个启动参数，把找歌速度提上来

深夜想找那首老歌，搜索页卡了十秒。洛雪音乐聚合多个音乐源，基于 Electron+Vue 3。掌握洛雪音乐快捷键，搜索到播放只需两步。## 洛雪音乐 30 秒上手：打开、搜索、播放1. 打开软件，焦点默认在搜索框（随时按 `F1` 重新聚焦），输入歌名，结果直接出来。2. 单击歌曲即可试听，默认会先加入"我的列表"的试听列表再播放。3. 想连续听多首，按下节的顺序多选并建歌单。[!