React Native API Reference
Hierarchy
- VideoEncoderConfiguration
Index
Constructors
Properties
Constructors
constructor
-
Parameters
-
Optional params: undefined | { bitrate?: undefined | number; degradationPrefer?: DegradationPreference; dimensions?: VideoDimensions; frameRate?: VideoFrameRate; minBitrate?: undefined | number; minFrameRate?: VideoFrameRate; mirrorMode?: VideoMirrorMode; orientationMode?: VideoOutputOrientationMode }
Returns VideoEncoderConfiguration
-
Properties
Optional bitrate
视频编码的码率。单位为 Kbps。你可以根据场景需要，参考下面的视频基准码率参考表，手动设置你想要的码率。 若设置的视频码率超出合理范围，SDK 会自动按照合理区间处理码率。 你也可以直接选择如下任意一种模式进行设置：
Standard：（推荐）标准码率模式。该模式下，视频在通信和直播场景下的码率有所不同：- 通信场景下，码率与基准码率一致。
- 直播场景下，码率对照基准码率翻倍。
Compatible：适配码率模式。该模式下，视频在通信和直播场景下的码率均与基准码率一致。直播下如果选择该模式，视频帧率可能会低于设置的值。
声网在通信和直播场景下采用不同的编码方式，以提升不同场景下的用户体验。通信场景保证流畅，而直播场景则更注重画面质量，因此直播场景对码率的需求大于通信场景。所以声网推荐将该参数设置为 Standard。
视频码率参考表
| 分辨率 | 帧率 (fps) |
基准码率 （通信场景，Kbps） |
直播码率 （直播场景，Kbps） |
|---|---|---|---|
| 160*120 | 15 | 65 | 130 |
| 120*120 | 15 | 50 | 100 |
| 320*180 | 15 | 140 | 280 |
| 180*180 | 15 | 100 | 200 |
| 240*180 | 15 | 120 | 240 |
| 320*240 | 15 | 200 | 400 |
| 240*240 | 15 | 140 | 280 |
| 424*240 | 15 | 220 | 440 |
| 640*360 | 15 | 400 | 800 |
| 360*360 | 15 | 260 | 520 |
| 640*360 | 30 | 600 | 1200 |
| 360*360 | 30 | 400 | 800 |
| 480*360 | 15 | 320 | 640 |
| 480*360 | 30 | 490 | 980 |
| 640*480 | 15 | 500 | 1000 |
| 480*480 | 15 | 400 | 800 |
| 640*480 | 30 | 750 | 1500 |
| 480*480 | 30 | 600 | 1200 |
| 848*480 | 15 | 610 | 1220 |
| 848*480 | 30 | 930 | 1860 |
| 640*480 | 10 | 400 | 800 |
| 1280*720 | 15 | 1130 | 2260 |
| 1280*720 | 30 | 1710 | 3420 |
| 960*720 | 15 | 910 | 1820 |
| 960*720 | 30 | 1380 | 2760 |
Note
该表中的基准码率适用于通信场景。直播场景下通常需要较大码率来提升视频质量。
声网推荐通过设置 Standard 来实现。你也可以直接将码率值设为基准码率值 x 2。
Optional degradationPrefer
带宽受限时，视频编码降级偏好。
Optional dimensions
视频编码的分辨率 (px)，用于衡量编码质量，以长 × 宽表示，默认值为 640 × 360。用户可以自行设置分辨率，也可以在如下列表中直接选择想要的分辨率：
- 120x120：视频分辨率为 120 × 120
- 160x120：视频分辨率为 160 × 120
- 180x180：视频分辨率为 180 × 180
- 240x180：视频分辨率为 240 × 180
- 320x180：视频分辨率为 320 × 180
- 240x240：视频分辨率为 240 × 240
- 320x240：视频分辨率为 320 × 240
- 424x240：视频分辨率为 424 × 240
- 360x360：视频分辨率为 360 × 360
- 480x360：视频分辨率为 480 × 360
- 640x360：视频分辨率为 640 × 360
- 480x480：视频分辨率为 480 × 480
- 640x480：视频分辨率为 640 × 480
- 840x480：视频分辨率为 840 × 480
- 960x720：视频分辨率为 960 × 720
- 1280x720：视频分辨率为 1280 × 720
Note
- 该值不代表最终视频输出的方向。请查阅
VideoOutputOrientationMode了解设置视频方向。 - 视频能否达到 720P 的分辨率取决于设备的性能，在性能配备较低的设备上有可能无法实现。如果采用 720P 分辨率而设备性能跟不上，则有可能出现帧率过低的情况。
Optional frameRate
视频编码的帧率（fps），默认值为 15。用户可以自行设置帧率，也可以在 VideoFrameRate 直接选择想要的帧率。建议不要超过 30 帧。
Optional minBitrate
最低视频编码码率。单位为 Kbps。
声网 SDK 会根据网络条件进行码率自适应。 该参数强制视频编码器输出高质量图片。如果将参数设为高于默认值， 在网络状况不佳情况下可能会导致网络丢包，并影响视频播放的流畅度。因此如非对画质有特殊需求， 声网建议不要修改该参数的值。
Optional minFrameRate
最低视频编码帧率（fps）。默认值为 Min，表示使用系统默认的最低编码帧率。
Optional mirrorMode
本地发送视频的镜像模式，只影响远端用户看到的视频画面。
Optional orientationMode
视频编码的方向模式。
视频编码属性的定义。