<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html>
<html lang="en">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<!-- radiooverview.qdoc -->
<title>Radio Overview | Qt Multimedia 5.9</title>
<link rel="stylesheet" type="text/css" href="style/offline-simple.css" />
<script type="text/javascript">
document.getElementsByTagName("link").item(0).setAttribute("href", "style/offline.css");
// loading style sheet breaks anchors that were jumped to before
// so force jumping to anchor again
setTimeout(function() {
var anchor = location.hash;
// need to jump to different anchor first (e.g. none)
location.hash = "#";
setTimeout(function() {
location.hash = anchor;
}, 0);
}, 0);
</script>
</head>
<body>
<div class="header" id="qtdocheader">
<div class="main">
<div class="main-rounded">
<div class="navigationbar">
<table><tr>
<td >Qt 5.9</td><td ><a href="qtmultimedia-index.html">Qt Multimedia</a></td><td >Radio Overview</td></tr></table><table class="buildversion"><tr>
<td id="buildversion" width="100%" align="right">Qt 5.9.4 Reference Documentation</td>
</tr></table>
</div>
</div>
<div class="content">
<div class="line">
<div class="content mainContent">
<div class="sidebar">
<div class="toc">
<h3><a name="toc">Contents</a></h3>
<ul>
<li class="level1"><a href="#radio-features">Radio Features</a></li>
<li class="level1"><a href="#radio-implementation-details">Radio Implementation Details</a></li>
<li class="level1"><a href="#examples">Examples</a></li>
<li class="level2"><a href="#radio-example">Radio Example</a></li>
<li class="level2"><a href="#declarative-radio-example">Declarative Radio Example</a></li>
<li class="level1"><a href="#reference-documentation">Reference documentation</a></li>
<li class="level2"><a href="#c-classes">C++ Classes</a></li>
<li class="level2"><a href="#qml-types">QML Types</a></li>
</ul>
</div>
<div class="sidebar-content" id="sidebar-content"></div></div>
<h1 class="title">Radio Overview</h1>
<span class="subtitle"></span>
<!-- $$$radiooverview.html-description -->
<div class="descr"> <a name="details"></a>
<p>The Qt Multimedia API provides a number of radio related classes for control over the radio tuner of the system, and gives access to Radio Data System (RDS) information for radio stations that broadcasts it.</p>
<a name="radio-features"></a>
<h2 id="radio-features">Radio Features</h2>
<p>The Radio API consists of two separate components. The radio tuner, <a href="qradiotuner.html">QRadioTuner</a> or the <a href="qml-qtmultimedia-radio.html">Radio</a> QML type, which handles control of the radio hardware as well as tuning. The other is the radio data component, either <a href="qradiodata.html">QRadioData</a> or the <a href="qml-qtmultimedia-radiodata.html">RadioData</a> QML type, which gives access to RDS information.</p>
<a name="radio-implementation-details"></a>
<h2 id="radio-implementation-details">Radio Implementation Details</h2>
<p>The actual level of support depends on the underlying system support. It should be noted that only analog radio is supported, and the properties of the radio data component will only be populated if the system radio tuner supports RDS.</p>
<a name="examples"></a>
<h2 id="examples">Examples</h2>
<p>There are two examples showing the usage of the Radio API. One shows how to use the <a href="qradiotuner.html">QRadioTuner</a> class from C++. The other shows how to implement a similar application using QML and <a href="qml-qtmultimedia-radio.html">Radio</a>.</p>
<a name="radio-example"></a>
<h3 >Radio Example</h3>
<p>This image shows the example using the <a href="qradiotuner.html">QRadioTuner</a> API.</p>
<p class="centerAlign"><img src="images/radio-example.png" alt="" /></p><p>The example reads the frequency from the radio tuner, and sets the "Got Signal" text based on the signal strength. The buttons allow the user to tune and scan up and down the frequency band, while the slider to the side allows volume adjustments.</p>
<p>Only the FM frequency band is used in this example.</p>
<a name="declarative-radio-example"></a>
<h3 >Declarative Radio Example</h3>
<p class="centerAlign"><img src="images/declarative-radio-example.png" alt="" /></p><p>This example has the same functionality of the regular radio example mentioned above, but it includes a nice horizontal dial showing the position of the current frequency inside the band.</p>
<a name="reference-documentation"></a>
<h2 id="reference-documentation">Reference documentation</h2>
<a name="c-classes"></a>
<h3 >C++ Classes</h3>
<div class="table"><table class="annotated">
<tr class="odd topAlign"><td class="tblName"><p><a href="qradiodata.html">QRadioData</a></p></td><td class="tblDescr"><p>Interfaces to the RDS functionality of the system radio</p></td></tr>
<tr class="even topAlign"><td class="tblName"><p><a href="qradiotuner.html">QRadioTuner</a></p></td><td class="tblDescr"><p>Interface to the systems analog radio device</p></td></tr>
</table></div>
<a name="qml-types"></a>
<h3 >QML Types</h3>
<div class="table"><table class="annotated">
<tr class="odd topAlign"><td class="tblName"><p><a href="qml-qtmultimedia-radio.html">Radio</a></p></td><td class="tblDescr"><p>Access radio functionality from a QML application</p></td></tr>
<tr class="even topAlign"><td class="tblName"><p><a href="qml-qtmultimedia-radiodata.html">RadioData</a></p></td><td class="tblDescr"><p>Access RDS data from a QML application</p></td></tr>
</table></div>
</div>
<!-- @@@radiooverview.html -->
</div>
</div>
</div>
</div>
</div>
<div class="footer">
<p>
<acronym title="Copyright">©</acronym> 2017 The Qt Company Ltd.
Documentation contributions included herein are the copyrights of
their respective owners.<br> The documentation provided herein is licensed under the terms of the <a href="http://www.gnu.org/licenses/fdl.html">GNU Free Documentation License version 1.3</a> as published by the Free Software Foundation.<br> Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property
of their respective owners. </p>
</div>
</body>
</html>
