====== adv.requestVideoEncoding() ======
call.adv.requestVideoEncoding() controls the video stream received in the call. It can be used to ask other end of call to limit maximum bandwidth and framerate, and downscale the video it transmits to us.

Client at other end of call will automatically perform a [[ixnx:wrtc:js:api:call:adv.setvideoencoding|call.adv.setVideoEncoding()]] with supplied arguments.

<WRAP center round important 100%>
call.adv.requestVideoEncoding() works **only** if client at other end of call uses wrtc_kit.\\
SIP clients will ignore these requests.
</WRAP>

===== Arguments =====
call.adv.requestVideoEncoding(maxBitrate, maxFramerate, scaleDown)
  * maxBitrate - (optional) maximum video bandwidth, in kbps
  * maxFramerate - (optional) maximum frames per second
  * scaleDown - (optional) video frame size downscale factor
Missing values keep old settings.

[[ixnx:wrtc:js:api:call:adv.setvideoencoding|Read more here.]]

===== Returns =====
nothing

===== Example =====
Request a low resolution "postage stamp" image transmitted to us:
  call.adv.requestVideoEncoding(100, 5, 4);

Request full image transmitted to us again:
  call.adv.requestVideoEncoding(wrtc.adv.requestBandwidth, 50, 1);

===== Different ways of controlling video quality =====
[[ixnx:wrtc:js:api:call:adv.setvideoencoding#different_ways_of_controlling_video_quality|Read here.]]

===== See Also =====
[[ixnx:wrtc:js:api:call:adv.setvideoencoding|call.adv.setVideoEncoding()]]

[[ixnx:wrtc:js:api:wrtc:adv.videoconstraints|wrtc.adv.videoConstraints]]

[[ixnx:wrtc:js:api:wrtc:videobandwidth|wrtc.videoBandwidth]]

[[ixnx:wrtc:js:api:wrtc:adv.requestbandwidth|wrtc.adv.requestBandwidth]]