如何配置Twilio视频优先降帧率而非分辨率，且画质可自动恢复？

1. 核心配置说明 #

你遇到的分辨率下调后无法回弹、网络差时优先降低帧率的需求，都可以通过调整Twilio连接配置实现，Twilio提供了专门的编码降级偏好参数控制自适应策略，同时开启自动质量缩放即可实现带宽恢复后分辨率自动回升。

2. 调整相机捕获初始化参数 #

首先需要在初始化相机捕获器时指定你需要的最大分辨率和帧率上限，避免底层捕获的视频尺寸本身达不到预期：

// 初始化相机捕获器时配置参数示例
final _cameraCapturer = CameraCapturer(
  CameraSource.frontCamera, // 可根据需求切换为后置摄像头
  videoParameters: VideoParameters(
    dimensions: VideoDimensions(width: 1280, height: 720), // 按需求设置最大分辨率，比如720P
    minFps: 15,
    maxFps: 30, // 最大帧率可按需调整
  ),
);

3. 完善ConnectOptions连接配置 #

在你现有连接配置基础上新增编码、降级策略相关参数即可：

final connectOptions = ConnectOptions(
  token,
  roomName: _channelName,
  preferredAudioCodecs: [OpusCodec()],
  audioTracks: [LocalAudioTrack(true)],
  dataTracks: [LocalDataTrack()],
  videoTracks: [LocalVideoTrack(true, _cameraCapturer)],
  enableNetworkQuality: true,
  networkQualityConfiguration: NetworkQualityConfiguration(
    remote: NetworkQualityVerbosity.NETWORK_QUALITY_VERBOSITY_MINIMAL,
  ),
  enableDominantSpeaker: true,
  // 新增以下配置
  encodingParameters: EncodingParameters(
    maxAudioBitrate: 16000, // 音频最大比特率，可按需调整
    maxVideoBitrate: 1500000, // 视频最大比特率，720P30帧建议设置为1.5Mbps左右
  ),
  // 核心配置：优先保留分辨率、降低帧率
  videoDegradationPreference: VideoDegradationPreference.MAINTAIN_RESOLUTION,
  // 开启自动质量缩放，带宽恢复后自动回升分辨率
  enableAutomaticVideoQualityScaling: true,
);

_room = await TwilioProgrammableVideo.connect(connectOptions);

4. 额外注意事项 #

• 如果你使用的是群组(Group)类型房间，需要确认Twilio控制台中对应房间类型的视频带宽限制没有低于你设置的maxVideoBitrate，否则本地配置会被服务端规则覆盖
• 请升级到flutter_twilio_programmable_video的最新稳定版本，早期版本存在带宽恢复后分辨率无法自动回弹的已知bug
• 测试时建议关闭设备的省电模式，省电模式会强制限制视频编码性能，可能导致分辨率异常降低

内容的提问来源于stack exchange，提问作者Yuuta Moriyama