开发者如何依托 ERTC 枚举配置安卓端音视频编码参数?

📅 2026/8/8 9:00:18
开发者如何依托 ERTC 枚举配置安卓端音视频编码参数?
ERTC SDK Android 类型定义.md常量定义 RTCConstant1. 码流类型类型描述ERTC_VIDEO_STREAM_TYPE_NULL码流类型,未订阅ERTC_VIDEO_STREAM_TYPE_BIG码流类型,订阅大流ERTC_VIDEO_STREAM_TYPE_SMALL码流类型,订阅小流当发布端未发布小流时会自动订阅大流当发布端小流发布后会自动切换成小流ERTC_VIDEO_STREAM_TYPE_SHARE订阅屏幕共享视频分享流2. 填充模式类型描述ERTC_VIDEO_RENDER_MODE_FILL填充模式即将画面内容居中等比缩放以充满整个显示区域超出显示区域的部分将会被裁剪掉此模式下画面可能不完整ERTC_VIDEO_RENDER_MODE_FIT适应模式即按画面长边进行缩放以适应显示区域短边部分会被填充为黑色此模式下图像完整但可能留有黑边。3. 网络质量类型onNetworkQuality回调质量参数类型描述ERTC_QUALITY_UNKNOWN网络类型——未定义ERTC_QUALITY_EXCELLENT当前网络非常好ERTC_QUALITY_GOOD当前网络一般ERTC_QUALITY_POOR当前网络较差ERTC_QUALITY_BAD当前网络很差ERTC_QUALITY_VBAD当前网络不满足 ERTC 的最低要求ERTC_QUALITY_UNSUPPORTED暂时无法检测到网络质量ERTC_QUALITY_DETECTING网络质量检测已开始还没有完成枚举定义1. BavLogLevel日志等级类型类型描述BAV_LOG_LEVEL_OFF关闭BAV_LOG_LEVEL_ERRORERROR级别BAV_LOG_LEVEL_WARNWARN级别BAV_LOG_LEVEL_INFOINFO级别BAV_LOG_LEVEL_DEBUGDEBUG级别BAV_LOG_LEVEL_TRACETRACE级别2. Scene类型描述VideoCall视频通话3. ERTCVideoResolution类型描述ERTCVideoResolution_120_120宽高比 1:1分辨率 120x120建议码率VideoCall80kbps; 建议码率LIVE120kbpsERTCVideoResolution_160_160宽高比 1:1分辨率 120x120建议码率VideoCall80kbps; 建议码率LIVE120kbpsERTCVideoResolution_270_270宽高比 1:1分辨率 270x270建议码率VideoCall200kbps; 建议码率LIVE300kbpsERTCVideoResolution_480_480宽高比 1:1分辨率 480x480建议码率VideoCall350kbps; 建议码率LIVE500kbpsERTCVideoResolution_160_120宽高比4:3分辨率 160x120建议码率VideoCall100kbps; 建议码率LIVE150kbpsERTCVideoResolution_240_180宽高比 4:3分辨率 240x180建议码率VideoCall150kbps; 建议码率LIVE250kbpsERTCVideoResolution_280_210宽高比 4:3分辨率 280x210建议码率VideoCall200kbps; 建议码率LIVE300kbpsERTCVideoResolution_320_240宽高比 4:3分辨率 320x240建议码率VideoCall250kbps; 建议码率LIVE375kbpsERTCVideoResolution_400_300宽高比 4:3分辨率 400x300建议码率VideoCall300kbps; 建议码率LIVE450kbpsERTCVideoResolution_480_360宽高比 4:3分辨率 480x360建议码率VideoCall400kbps; 建议码率LIVE600kbpsERTCVideoResolution_640_480宽高比 4:3分辨率 640x480建议码率VideoCall600kbps; 建议码率LIVE900kbpsERTCVideoResolution_960_720宽高比 4:3分辨率 960x720建议码率VideoCall1000kbps; 建议码率LIVE1500kbpsERTCVideoResolution_160_90宽高比 16:9分辨率 160x90建议码率VideoCall150kbps; 建议码率LIVE250kbpsERTCVideoResolution_256_144宽高比 16:9分辨率 256x144建议码率VideoCall200kbps; 建议码率LIVE300kbpsERTCVideoResolution_320_180宽高比 16:9分辨率 320x180建议码率VideoCall250kbps; 建议码率LIVE400kbpsERTCVideoResolution_480_270宽高比 16:9分辨率 480x270建议码率VideoCall350kbps; 建议码率LIVE550kbpsERTCVideoResolution_640_360宽高比 16:9分辨率 640x360建议码率VideoCall500kbps; 建议码率LIVE900kbpsERTCVideoResolution_960_540宽高比 16:9分辨率 960x540建议码率VideoCall850kbps; 建议码率LIVE1300kbpsERTCVideoResolution_1280_720宽高比 16:9分辨率 1280x720建议码率VideoCall1200kbps; 建议码率LIVE1800kbpsERTCVideoResolution_1920_1080宽高比 16:9分辨率 1920x1080建议码率VideoCall2000kbps; 建议码率LIVE3000kbps常用结构1. RTCEngineConfig初始化数据结构字段名类型说明contextContext上下文appIdStringappIdaccessTokenStringaccessTokenlogPathString日志路径可以不设置logLevelint日志等级 参考com.ez.baselib.utils.LogUtil1. RTCConstant.EnterParam入会数据结构字段名类型说明userIdString用户roomIdString房间号tokenStringtoken1. ERTCVideoEncParam视频编码参数字段名类型说明videoResolutionERTCVideoResolution视频分辨率 如需使用竖屏分辨率请指定 resMode 为 Portrait例如 640 × 360 Portrait 360 × 640videoFpsint视频采集帧率 15fps或20fps。5fps以下卡顿感明显。10fps以下会有轻微卡顿感。20fps以上会浪费带宽电影的帧率为24fpsvideoBitrateint目标视频码率单位KbpsSDK 会按照目标码率进行编码只有在弱网络环境下才会主动降低视频码率2. AudioVolumeInfo音量信息参数字段名类型说明userIdString说话者的 userId, 如果 userId 为0则代表是当前用户自己volumeint说话者的音量大小, 取值范围[0 - 100]3. ERTCLocalVideoStats本地视频实时数据质量监听时用public void setRtcStatsListener(RTCStatsListener rtcStatsListener)字段名类型说明widthint视频宽heightint视频高sentBitrateint视频传输码率(上行)sentFrameRateint帧率大小streamTypeint流类型 0大码流 1小码流 2屏幕共享流packetCountint发视频总包数compensateLossRateint补偿后丢包率4. ERTCLocalAudioStats本地音频实时数据质量监听时用public void setRtcStatsListener(RTCStatsListener rtcStatsListener)字段名类型说明sentBitrateint音频传输码率packetLossRateint音频丢包率packetCountint发音频总包数5. ERTCRemoteVideoStats远程视频实时数据质量监听时用public void setRtcStatsListener(RTCStatsListener rtcStatsListener)字段名类型说明userIdString远端视频用户IDreceivedBitrateint远端视频传输码率下行receivedFrameRateint远端帧率大小packetLossRateint远端视频丢包率(下行)totalFrozenTimeint远端视频总的卡顿时长frozenRateint远端视频卡顿比streamTypeint流类型 0大码流 1小码流 2屏幕共享流widthint视频宽heightint视频高packetCountint接收视频总包数uncompensateLossint视频补偿前丢包率ERTCRemoteAudioStats远端音频实时数据质量监听时用public void setRtcStatsListener(RTCStatsListener rtcStatsListener)字段名类型说明userIdString远端视频用户IDreceivedBitrateint远端音频传输码率下行packetLossRateint远端音频丢包率(下行)totalFrozenTimeint远端音频总的卡顿时长frozenRateint远端音频卡顿比packetCountint接收音频总包数plcPacketCountint音频帧补偿数量uncompensateLossint音频补偿前丢包率totalTimeint播放音频总时间SpeedTestResult速度测试结果回调数据结构 public void setSpeedTestListener(RTCSpeedTestListener listener)字段名类型说明successboolean测试是否成功qualityint内部通过评估算法测算出的网络质量upLostRateint上行丢包率取值范围是 [0 - 100]例如 30% 表示每向服务器发送 10 个数据包可能会在中途丢失 3 个downLostRateint下行丢包率取值范围是 [0 - 100]例如 20% 表示每从服务器收取 10 个数据包可能会在中途丢失 2 个rttint延迟毫秒指当前设备到 服务器的一次网络往返时间该值越小越好正常数值范围是10ms - 100msavailableUpBandwidthint上行带宽kbps-1无效值availableDownBandwidthint下行带宽kbps-1无效值stsConnectint流媒体服务器连接情况萤石致力于成为全球领先的智能视觉物联网服务商构建了全球领先的视觉物联网云平台打造了硬件产品软件云服务一体化的物联网服务体系。萤石云通过构建多数据中心就近服务点的方式服务于全球客户。截至2025 年底萤石物联网云平台在全球拥有超过120 个数据站点平台上的IoT 设备接入数超过3.6 亿其中视频类设备超过3 亿。在夯实自身平台能力的基础上萤石进一步开放技术能力将物联价值延伸至千行百业。萤石开放平台深度融合AI中台能力涵盖音视频多媒体、消息通知处理、智能算法调度、视频存储备份、ERTC、大数据、物联接入等已为智慧连锁、智慧养老、文教娱乐、畜牧养殖等42万余位行业客户提供数智化转型升级支撑萤石物联专有云支持专有化部署助力中大型企业和组织的数字化转型升级。