Interface CameraVideoTrackInitConfig

PropertiesCopy Anchor Link

cameraIdCopy Anchor Link

cameraId: string

指定摄像头的设备 ID。

你可以通过 AgoraRTC.getCameras 来获取当前的摄像头设备列表。

encoderConfigCopy Anchor Link

encoderConfig: VideoEncoderConfiguration|VideoEncoderConfigurationPreset

控制视频的编码配置。

你可以通过以下方式设置该属性：

• 通过 VideoEncoderConfigurationPreset 传入 SDK 内置的编码配置。
• 通过传入一个 VideoEncoderConfiguration 对象来自定义视频编码配置。
• 不传或留空，使用 SDK 的默认值 "480p_1"（分辨率 640 × 480、帧率 15 fps、码率 500 Kbps）。

facingModeCopy Anchor Link

facingMode: VideoFacingModeEnum

指定使用前置/后置摄像头来采集视频。

在移动设备上，可以设置该参数选择使用前置或后置摄像头：

• "user": 前置摄像头
• "environment": 后置摄像头

optimizationModeCopy Anchor Link

optimizationMode: OptimizationMode

设置视频传输优化模式。

你可以在视频通话、视频直播或屏幕共享过程中调用此方法动态调整视频的传输优化模式。例如你想要把屏幕共享内容从演示文稿切换为视频时，你可以将传输优化模式从 "detail" 切换为 "motion"，确保视频画面在网络波动时不会出现卡顿。

paramCopy Anchor Link

视频传输优化模式：

• "detail": 清晰优先。

  • 浏览器会自动根据你的采集分辨率和帧率设定一个最小码率。即使遭遇网络波动，发送码率也不会低于这个值，从而确保清晰的视频画面。
  • 大部分情况下，浏览器不会降低发送分辨率，但是可能会降低帧率。

• "motion": 自 4.21.0 开始，浏览器默认开启流畅优先模式。

  • 浏览器不会启用最小码率策略。遭遇网络波动时，发送端会降低码率来确保接收端的视频画面不会出现中断和卡顿。
  • 大部分情况下，浏览器不会降低帧率，但是可能会降低发送分辨率。