====== adv.volumeMeter() ======
wrtc.adv.volumeMeter() is used to measure local microphone volume.

Once started volume information will be reported using [[ixnx:wrtc:js:api:wrtc:onvolume|wrtc.onVolume()]] events.

<WRAP center round important 100%>
Audio volume is only measured during calls. To measure volume without any ongoing calls see [[ixnx:wrtc:js:api:wrtc:adv.createloopbackcall|wrtc.adv.createLoopBackCall()]]

Measuring audio volume is only implemented in Chrome and Firefox browsers. wrtc.adv.volumeMeter() will fail silently on other browsers and no [[ixnx:wrtc:js:api:wrtc:onvolume|wrtc.onVolume()]] events will occur.

Measuring audio volume results in several [[ixnx:wrtc:js:api:wrtc:onvolume|wrtc.onVolume()]] events per second that can be very processor intensive to handle. Use wrtc.adv.volumeMeter() only if absolutely necessary.
</WRAP>

The number of [[ixnx:wrtc:js:api:wrtc:onvolume|wrtc.onVolume()]] events per second is determined by [[ixnx:wrtc:js:api:call:adv.stats_ms|call.adv.stats_ms]]


===== Usage =====
wrtc.adv.volumeMeter(true) - start microphone volume measurement.

wrtc.adv.volumeMeter(false) - stop all microphone volume measurements.

wrtc.adv.volumeMeter(call) - start microphone volume measurement using outgoing media stream of specified call.

===== Returns =====
Nothing.

===== Events =====
[[ixnx:wrtc:js:api:wrtc:onvolume|wrtc.onVolume()]] events reporting current audio volume.

===== See Also =====
[[ixnx:wrtc:js:api:wrtc:adv.createloopbackcall|wrtc.adv.createLoopBackCall()]]