萤石 ERTC Windows SDK 包含哪些类型定义？

做萤石二次开发的哈哈2026-07-21 9:20

ERTC SDK 类型定义-Windows.md

枚举定义

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万余位行业客户提供数智化转型升级支撑；萤石物联专有云支持专有化部署，助力中大型企业和组织的数字化转型升级。

相关推荐
十月的皮皮6 小时前
stm20260720-从新手 C 到量产 STM32 工程：程序设计推导指南
c语言·开发语言·stm32·stm32cubemx·hal库
开发笔记-阿牛6 小时前
解析一款有意思的产品||CK6159A语音芯片设计的儿童专注力训练机-舒尔特玩具
stm32·单片机·嵌入式硬件·音频
残影飞雪8 小时前
ESP32-C5下载烧录固件失败报错的原因
单片机·嵌入式硬件
搞全栈小苏9 小时前
SIMetrix_simplis8.4安装教程——附安装包
stm32·单片机·嵌入式硬件·电力电子
qq_573967829 小时前
STM32控制器
stm32·单片机·嵌入式硬件
某林21210 小时前
履带小车底盘stm32F103RCT6开发
人工智能·stm32·单片机·嵌入式硬件·架构·人机交互·ros2
sramdram11 小时前
低功耗MCU微控制器在动态血糖仪（CGM）中的应用方案
单片机·嵌入式硬件·mcu·mcu微控制器
Dlrb121111 小时前
ARM--IMX6ULL的SDK学习，BSP开发工程管理，以及链接脚本与Makefile的编写
单片机·嵌入式硬件·arm·sdk·链接脚本·i.mx6ull·cortex-a7
李永奉11 小时前
杰理可视化SDK开发-配置ANC主动降噪功能模块教程
单片机·嵌入式硬件·物联网
云泽80812 小时前
嵌入式环境搭建（一）：Keil MDK5 安装流程及 DFP 器件包配置实战
嵌入式硬件·keil5·keil mdk5·dfp器件包配置
热门推荐
012026年7月AI圈大地震：GPT-5.6被政府限制、Claude入驻Slack、Anthropic自研芯片02GitHub 镜像站点03如何新建文件夹？ 电脑新建文件夹的4种方法04幻兽帕鲁 - 服务器管理员权限与 GM 命令完全指南05AI科技热点日报 | 2026年07月01日06国内可直接用、免费额度/永久免费的大模型API清单（含 SiliconFlow、火山、阿里、智谱、百度、Kimi、DeepSeek、DMXAPI 等）07【AI前线观察】2026年国产开源大模型全面横评：从 DeepSeek V4 到 Kimi K3，谁才是开发者的最优选择？08AI 编程 IDE 全景解析 2026：Agent 全面接管开发链路092026 年 AI 大模型 & AI 编程工具实战全总结102026 国产 AI 大模型横评：DeepSeek、通义千问、Kimi、文心一言、星火、豆包谁更能打？