<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<meta http-equiv="X-UA-Compatible" content="IE=9"/>
<title>liblinphone: Obtaining information about a running call: sound volumes, quality indicators</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="jquery.js"></script>
<script type="text/javascript" src="dynsections.js"></script>
<link href="doxygen.css" rel="stylesheet" type="text/css" />
</head>
<body>
<div id="top"><!-- do not remove this div, it is closed by doxygen! -->
<div id="titlearea">
<table cellspacing="0" cellpadding="0">
<tbody>
<tr style="height: 56px;">
<td style="padding-left: 0.5em;">
<div id="projectname">liblinphone
 <span id="projectnumber">3.5.2</span>
</div>
</td>
</tr>
</tbody>
</table>
</div>
<!-- end header part -->
<!-- Generated by Doxygen 1.8.1.2 -->
<div id="navrow1" class="tabs">
<ul class="tablist">
<li><a href="index.html"><span>Main Page</span></a></li>
<li><a href="pages.html"><span>Related Pages</span></a></li>
<li><a href="modules.html"><span>Modules</span></a></li>
<li><a href="annotated.html"><span>Data Structures</span></a></li>
</ul>
</div>
</div><!-- top -->
<div class="header">
<div class="summary">
<a href="#func-members">Functions</a> </div>
<div class="headertitle">
<div class="title">Obtaining information about a running call: sound volumes, quality indicators</div> </div>
</div><!--header-->
<div class="contents">
<table class="memberdecls">
<tr class="heading"><td colspan="2"><h2><a name="func-members"></a>
Functions</h2></td></tr>
<tr class="memitem:ga7a0ca45e0ff2bf7eaca09e795bba3486"><td class="memItemLeft" align="right" valign="top">float </td><td class="memItemRight" valign="bottom"><a class="el" href="group__call__misc.html#ga7a0ca45e0ff2bf7eaca09e795bba3486">linphone_call_get_play_volume</a> (LinphoneCall *call)</td></tr>
<tr class="memitem:gac4f217936eea56196afc126974a92451"><td class="memItemLeft" align="right" valign="top">float </td><td class="memItemRight" valign="bottom"><a class="el" href="group__call__misc.html#gac4f217936eea56196afc126974a92451">linphone_call_get_record_volume</a> (LinphoneCall *call)</td></tr>
<tr class="memitem:ga62c7d3d08531b0cc634b797e273a0a73"><td class="memItemLeft" align="right" valign="top">float </td><td class="memItemRight" valign="bottom"><a class="el" href="group__call__misc.html#ga62c7d3d08531b0cc634b797e273a0a73">linphone_call_get_current_quality</a> (LinphoneCall *call)</td></tr>
<tr class="memitem:gae3aaa85596484c871b57cdefafd7fd9e"><td class="memItemLeft" align="right" valign="top">float </td><td class="memItemRight" valign="bottom"><a class="el" href="group__call__misc.html#gae3aaa85596484c871b57cdefafd7fd9e">linphone_call_get_average_quality</a> (LinphoneCall *call)</td></tr>
</table>
<a name="details" id="details"></a><h2>Detailed Description</h2>
<p>When a call is running, it is possible to retrieve in real time current measured volumes and quality indicator. </p>
<h2>Function Documentation</h2>
<a class="anchor" id="ga7a0ca45e0ff2bf7eaca09e795bba3486"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">float linphone_call_get_play_volume </td>
<td>(</td>
<td class="paramtype">LinphoneCall * </td>
<td class="paramname"><em>call</em></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Returns the measured sound volume played locally (received from remote) It is expressed in dbm0. </p>
<p>< Lowest measured that can be returned. </p>
</div>
</div>
<a class="anchor" id="gac4f217936eea56196afc126974a92451"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">float linphone_call_get_record_volume </td>
<td>(</td>
<td class="paramtype">LinphoneCall * </td>
<td class="paramname"><em>call</em></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Returns the measured sound volume recorded locally (sent to remote) It is expressed in dbm0. </p>
<p>< Lowest measured that can be returned. </p>
</div>
</div>
<a class="anchor" id="ga62c7d3d08531b0cc634b797e273a0a73"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">float linphone_call_get_current_quality </td>
<td>(</td>
<td class="paramtype">LinphoneCall * </td>
<td class="paramname"><em>call</em></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Obtain real-time quality rating of the call</p>
<p>Based on local RTP statistics and RTCP feedback, a quality rating is computed and updated during all the duration of the call. This function returns its value at the time of the function call. It is expected that the rating is updated at least every 5 seconds or so. The rating is a floating point number comprised between 0 and 5.</p>
<p>4-5 = good quality <br/>
3-4 = average quality <br/>
2-3 = poor quality <br/>
1-2 = very poor quality <br/>
0-1 = can't be worse, mostly unusable <br/>
</p>
<dl class="section return"><dt>Returns</dt><dd>The function returns -1 if no quality measurement is available, for example if no active audio stream exist. Otherwise it returns the quality rating. </dd></dl>
</div>
</div>
<a class="anchor" id="gae3aaa85596484c871b57cdefafd7fd9e"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">float linphone_call_get_average_quality </td>
<td>(</td>
<td class="paramtype">LinphoneCall * </td>
<td class="paramname"><em>call</em></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Returns call quality averaged over all the duration of the call.</p>
<p>See <a class="el" href="group__call__misc.html#ga62c7d3d08531b0cc634b797e273a0a73">linphone_call_get_current_quality()</a> for more details about quality measurement. </p>
</div>
</div>
</div><!-- contents -->
<!-- start footer part -->
<hr class="footer"/><address class="footer"><small>
Generated by  <a href="http://www.doxygen.org/index.html">
<img class="footer" src="doxygen.png" alt="doxygen"/>
</a> 1.8.1.2
</small></address>
</body>
</html>
