<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html>
<html lang="en">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<!-- qdeclarativebluetoothservice.cpp -->
<title>BluetoothService QML Type | Qt Bluetooth 5.12.6</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.12</td><td ><a href="qtbluetooth-index.html">Qt Bluetooth</a></td><td ><a href="qtbluetooth-qmlmodule.html">QML Types</a></td><td >BluetoothService QML Type</td></tr></table><table class="buildversion"><tr>
<td id="buildversion" width="100%" align="right"><a href="qtbluetooth-index.html">Qt 5.12.6 Reference Documentation</a></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="#properties">Properties</a></li>
<li class="level1"><a href="#signals">Signals</a></li>
<li class="level1"><a href="#details">Detailed Description</a></li>
</ul>
</div>
<div class="sidebar-content" id="sidebar-content"></div></div>
<h1 class="title">BluetoothService QML Type</h1>
<span class="subtitle"></span>
<!-- $$$BluetoothService-brief -->
<p>Provides information about a particular Bluetooth service. <a href="#details">More...</a></p>
<!-- @@@BluetoothService -->
<div class="table"><table class="alignedsummary">
<tr><td class="memItemLeft rightAlign topAlign"> Import Statement:</td><td class="memItemRight bottomAlign"> import QtBluetooth 5.12</td></tr><tr><td class="memItemLeft rightAlign topAlign"> Since:</td><td class="memItemRight bottomAlign"> Qt 5.2</td></tr></table></div><ul>
<li><a href="qml-qtbluetooth-bluetoothservice-members.html">List of all members, including inherited members</a></li>
</ul>
<a name="properties"></a>
<h2 id="properties">Properties</h2>
<ul>
<li class="fn"><b><b><a href="qml-qtbluetooth-bluetoothservice.html#deviceAddress-prop">deviceAddress</a></b></b> : string</li>
<li class="fn"><b><b><a href="qml-qtbluetooth-bluetoothservice.html#deviceName-prop">deviceName</a></b></b> : string</li>
<li class="fn"><b><b><a href="qml-qtbluetooth-bluetoothservice.html#registered-prop">registered</a></b></b> : string</li>
<li class="fn"><b><b><a href="qml-qtbluetooth-bluetoothservice.html#serviceDescription-prop">serviceDescription</a></b></b> : string</li>
<li class="fn"><b><b><a href="qml-qtbluetooth-bluetoothservice.html#serviceName-prop">serviceName</a></b></b> : string</li>
<li class="fn"><b><b><a href="qml-qtbluetooth-bluetoothservice.html#serviceProtocol-prop">serviceProtocol</a></b></b> : enumeration</li>
<li class="fn"><b><b><a href="qml-qtbluetooth-bluetoothservice.html#serviceUuid-prop">serviceUuid</a></b></b> : string</li>
</ul>
<a name="signals"></a>
<h2 id="signals">Signals</h2>
<ul>
<li class="fn"><b><b><a href="qml-qtbluetooth-bluetoothservice.html#detailsChanged-signal">detailsChanged</a></b></b>()</li>
</ul>
<!-- $$$BluetoothService-description -->
<a name="details"></a>
<h2 id="details">Detailed Description</h2>
<p>It allows a QML project to get information about a remote service, or describe a service for a <a href="qml-qtbluetooth-bluetoothsocket.html">BluetoothSocket</a> to connect to.</p>
<p><b>See also </b><a href="qbluetoothaddress.html">QBluetoothAddress</a> and <a href="qbluetoothsocket.html">QBluetoothSocket</a>.</p>
<!-- @@@BluetoothService -->
<h2>Property Documentation</h2>
<!-- $$$deviceAddress -->
<div class="qmlitem"><div class="qmlproto">
<div class="table"><table class="qmlname">
<tr valign="top" class="odd" id="deviceAddress-prop">
<td class="tblQmlPropNode"><p>
<a name="deviceAddress-prop"></a><span class="name">deviceAddress</span> : <span class="type">string</span></p></td></tr>
</table></div>
</div><div class="qmldoc"><p>This property holds the remote device's MAC address. It must be a valid address to connect to a remote device using a Bluetooth socket. Changing this property emits the <a href="qml-qtbluetooth-bluetoothservice.html#detailsChanged-signal">detailsChanged</a> signal.</p>
</div></div><!-- @@@deviceAddress -->
<br/>
<!-- $$$deviceName -->
<div class="qmlitem"><div class="qmlproto">
<div class="table"><table class="qmlname">
<tr valign="top" class="odd" id="deviceName-prop">
<td class="tblQmlPropNode"><p>
<a name="deviceName-prop"></a><span class="name">deviceName</span> : <span class="type">string</span></p></td></tr>
</table></div>
</div><div class="qmldoc"><p>This property holds the name of the remote device. Changing this property emits the <a href="qml-qtbluetooth-bluetoothservice.html#detailsChanged-signal">detailsChanged</a> signal.</p>
</div></div><!-- @@@deviceName -->
<br/>
<!-- $$$registered -->
<div class="qmlitem"><div class="qmlproto">
<div class="table"><table class="qmlname">
<tr valign="top" class="odd" id="registered-prop">
<td class="tblQmlPropNode"><p>
<a name="registered-prop"></a><span class="name">registered</span> : <span class="type">string</span></p></td></tr>
</table></div>
</div><div class="qmldoc"><p>This property holds the registration/publication status of the service. If true, the service is published during service discovery.</p>
</div></div><!-- @@@registered -->
<br/>
<!-- $$$serviceDescription -->
<div class="qmlitem"><div class="qmlproto">
<div class="table"><table class="qmlname">
<tr valign="top" class="odd" id="serviceDescription-prop">
<td class="tblQmlPropNode"><p>
<a name="serviceDescription-prop"></a><span class="name">serviceDescription</span> : <span class="type">string</span></p></td></tr>
</table></div>
</div><div class="qmldoc"><p>This property holds the description provided by the remote service. Changing this property emits the <a href="qml-qtbluetooth-bluetoothservice.html#detailsChanged-signal">detailsChanged</a> signal.</p>
</div></div><!-- @@@serviceDescription -->
<br/>
<!-- $$$serviceName -->
<div class="qmlitem"><div class="qmlproto">
<div class="table"><table class="qmlname">
<tr valign="top" class="odd" id="serviceName-prop">
<td class="tblQmlPropNode"><p>
<a name="serviceName-prop"></a><span class="name">serviceName</span> : <span class="type">string</span></p></td></tr>
</table></div>
</div><div class="qmldoc"><p>This property holds the name of the remote service if available. Changing this property emits the <a href="qml-qtbluetooth-bluetoothservice.html#detailsChanged-signal">detailsChanged</a> signal.</p>
</div></div><!-- @@@serviceName -->
<br/>
<!-- $$$serviceProtocol -->
<div class="qmlitem"><div class="qmlproto">
<div class="table"><table class="qmlname">
<tr valign="top" class="odd" id="serviceProtocol-prop">
<td class="tblQmlPropNode"><p>
<a name="serviceProtocol-prop"></a><span class="name">serviceProtocol</span> : <span class="type">enumeration</span></p></td></tr>
</table></div>
</div><div class="qmldoc"><p>This property holds the protocol used for the service. Changing this property emits the <a href="qml-qtbluetooth-bluetoothservice.html#detailsChanged-signal">detailsChanged</a> signal.</p>
<p>Possible values for this property are:</p>
<div class="table"><table class="generic">
<thead><tr class="qt-style"><th >Property</th><th >Description</th></tr></thead>
<tr valign="top" class="odd"><td ><code>BluetoothService.RfcommProtocol</code></td><td >The Rfcomm protocol is used.</td></tr>
<tr valign="top" class="even"><td ><code>BluetoothService.L2capProtocol</code></td><td >The L2cap protocol is used.</td></tr>
<tr valign="top" class="odd"><td ><code>BluetoothService.UnknownProtocol</code></td><td >The protocol is unknown.</td></tr>
</table></div>
<p><b>See also </b><a href="qbluetoothserviceinfo.html#Protocol-enum">QBluetoothServiceInfo::Protocol</a>.</p>
</div></div><!-- @@@serviceProtocol -->
<br/>
<!-- $$$serviceUuid -->
<div class="qmlitem"><div class="qmlproto">
<div class="table"><table class="qmlname">
<tr valign="top" class="odd" id="serviceUuid-prop">
<td class="tblQmlPropNode"><p>
<a name="serviceUuid-prop"></a><span class="name">serviceUuid</span> : <span class="type">string</span></p></td></tr>
</table></div>
</div><div class="qmldoc"><p>This property holds the UUID of the remote service. Service UUID, and the address must be set to connect to a remote service. Changing this property emits the <a href="qml-qtbluetooth-bluetoothservice.html#detailsChanged-signal">detailsChanged</a> signal.</p>
</div></div><!-- @@@serviceUuid -->
<br/>
<h2>Signal Documentation</h2>
<!-- $$$detailsChanged -->
<div class="qmlitem"><div class="qmlproto">
<div class="table"><table class="qmlname">
<tr valign="top" class="odd" id="detailsChanged-signal">
<td class="tblQmlFuncNode"><p>
<a name="detailsChanged-signal"></a><span class="name">detailsChanged</span>()</p></td></tr>
</table></div>
</div><div class="qmldoc"><p>This signal is emitted when any of the following properties changes:</p>
<ul>
<li><a href="qml-qtbluetooth-bluetoothservice.html#deviceAddress-prop">deviceAddress</a></li>
<li><a href="qml-qtbluetooth-bluetoothservice.html#deviceName-prop">deviceName</a></li>
<li><a href="qml-qtbluetooth-bluetoothservice.html#serviceDescription-prop">serviceDescription</a></li>
<li><a href="qml-qtbluetooth-bluetoothservice.html#serviceName-prop">serviceName</a></li>
<li><a href="qml-qtbluetooth-bluetoothservice.html#serviceProtocol-prop">serviceProtocol</a></li>
<li><a href="qml-qtbluetooth-bluetoothservice.html#serviceUuid-prop">serviceUuid</a></li>
</ul>
<p>The corresponding handler is <code>onDetailsChanged</code>.</p>
</div></div><!-- @@@detailsChanged -->
<br/>
</div>
</div>
</div>
</div>
</div>
<div class="footer">
<p>
<acronym title="Copyright">©</acronym> 2019 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>
