API Reference for web - Interface: CameraVideoTrackInitConfig

更新时间: 2023-10-23 16:45:52

# Interface: CameraVideoTrackInitConfig

interface/StreamInterface.CameraVideoTrackInitConfig

创建摄像头视频流时的配置对象,用于 CoreRTC.createCameraVideoTrack.

# Properties

# cameraId

Optional cameraId: string

指定摄像头的设备 ID。

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


# encoderConfig

Optional encoderConfig: VideoEncoderConfiguration | "90p" | "90p_1" | "120p" | "120p_1" | "120p_3" | "120p_4" | "180p" | "180p_1" | "180p_3" | "180p_4" | "240p" | "240p_1" | "240p_3" | "240p_4" | "360p" | "360p_1" | "360p_3" | "360p_4" | "360p_6" | "360p_7" | "360p_8" | "360p_9" | "360p_10" | "360p_11" | "480p" | "480p_1" | "480p_2" | "480p_3" | "480p_4" | "480p_6" | "480p_8" | "480p_9" | "480p_10" | "720p" | "720p_1" | "720p_2" | "720p_3" | "720p_5" | "720p_6" | "1080p" | "1080p_1" | "1080p_2" | "1080p_3" | "1080p_5" | "1440p" | "1440p_1" | "1440p_2" | "4k" | "4k_1" | "4k_3"

控制视频的编码配置。

  • 可以通过 [[VideoEncoderConfigurationPreset]] 传入 SDK 内置的编码配置;
  • 也可以通过传入一个 [[VideoEncoderConfiguration]] 来自定义视频编码配置。

# facingMode

Optional facingMode: "user" | "environment"

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

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

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

# optimizationMode

Optional optimizationMode: "motion" | "detail"

暂缓支持

传输优化模式。设置该值后,SDK 会自动调整码率配置以及使用不同的回退策略。

  • "detail": 清晰优先。
    • SDK 会自动根据你的采集分辨率和帧率设定一个最小码率。即使遭遇网络波动,发送码率也不会低于这个值,从而确保清晰的视频画面。
    • 大部分情况下,SDK 不会降低发送分辨率,但是可能会降低帧率。
  • "motion": 流畅优先。
  • SDK 不会启用最小码率策略。遭遇网络波动时,发送端会降低码率来确保接收端的视频画面不会出现中断和卡顿。
  • 大部分情况下,SDK 不会降低帧率,但是可能会降低发送分辨率。
  • 留空: 默认优化策略,兼顾清晰和流畅,也就是说弱网条件下,帧率和分辨率都会被调整。

注意事项:该方法只支持 Chrome 浏览器。