1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
|
/****************************************************************************
**
** Copyright (C) 2011 Nokia Corporation and/or its subsidiary(-ies).
** All rights reserved.
** Contact: Nokia Corporation (qt-info@nokia.com)
**
** This file is part of the Qt Mobility Components.
**
** $QT_BEGIN_LICENSE:LGPL$
** No Commercial Usage
** This file contains pre-release code and may not be distributed.
** You may use this file in accordance with the terms and conditions
** contained in the Technology Preview License Agreement accompanying
** this package.
**
** GNU Lesser General Public License Usage
** Alternatively, this file may be used under the terms of the GNU Lesser
** General Public License version 2.1 as published by the Free Software
** Foundation and appearing in the file LICENSE.LGPL included in the
** packaging of this file. Please review the following information to
** ensure the GNU Lesser General Public License version 2.1 requirements
** will be met: http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html.
**
** In addition, as a special exception, Nokia gives you certain additional
** rights. These rights are described in the Nokia Qt LGPL Exception
** version 1.1, included in the file LGPL_EXCEPTION.txt in this package.
**
** If you have questions regarding the use of this file, please contact
** Nokia at qt-info@nokia.com.
**
**
**
**
**
**
**
**
** $QT_END_LICENSE$
**
****************************************************************************/
#include "qbluetoothlocaldevice.h"
#include "qbluetoothlocaldevice_p.h"
#include "qbluetoothaddress.h"
#include <QtCore/QString>
#include <QDebug>
QTM_BEGIN_NAMESPACE
/*!
\class QBluetoothLocalDevice
\brief The QBluetoothLocalDevice class provides access to local Bluetooth devices.
\ingroup connectivity-bluetooth
\inmodule QtConnectivity
\since 1.2
QBluetoothLocalDevice provides functions for getting and setting the state of local Bluetooth
devices.
*/
/*!
\enum QBluetoothLocalDevice::Pairing
This enum describes the pairing state between two Bluetooth devices.
\value Unpaired The Bluetooth devices are not paired.
\value Paired The Bluetooth devices are paired. The system will prompt the user for
authorization when the remote device initiates a connection to the
local device.
\value AuthorizedPaired The Bluetooth devices are paired. The system will not prompt the user
for authorization when the remote device initiates a connection to the
local device.
*/
/*!
\enum QBluetoothLocalDevice::Error
This enum describes errors that maybe returned
\value NoError No known error
\value PairingError Error in pairing
\value UnknownError Unknown error
*/
/*!
\enum QBluetoothLocalDevice::HostMode
This enum describes the most of the local Bluetooth device.
\value HostPoweredOff Powers the device down
\value HostConnectable Remote Bluetooth devices can connect to the local Bluetooth device
if they have previously been paired with it or otherwise know its
address. This powers up the device if it was powered off.
\value HostDiscoverable Remote Bluetooth devices can discover the presence of the local
Bluetooth device. The device will also be connectable, and powered on.
\value HostDiscoverableLimitedInquiry Remote Bluetooth devices can discover the presence of the local
Bluetooth device when performing a limited inquiry. This should be used for
locating services that are only made discoverable for a limited period of time.
This can speed up discovery between games for example, since service
discovery can be skipped on devices not in limited enquiry more. This
is not supported on all platforms. The device will also be connectable, and powered on.
*/
namespace
{
class LocalDeviceRegisterMetaTypes
{
public:
LocalDeviceRegisterMetaTypes()
{
qRegisterMetaType<QBluetoothLocalDevice::HostMode>("QBluetoothLocalDevice::HostMode");
qRegisterMetaType<QBluetoothLocalDevice::Pairing>("QBluetoothLocalDevice::Pairing");
qRegisterMetaType<QBluetoothLocalDevice::Error>("QBluetoothLocalDevice::Error");
}
} _registerLocalDeviceMetaTypes;
}
/*!
Destroys the QBluetoothLocalDevice.
*/
QBluetoothLocalDevice::~QBluetoothLocalDevice()
{
delete d_ptr;
}
/*!
Returns true the QBluetoothLocalDevice represents an available local Bluetooth device;
otherwise return false.
*/
bool QBluetoothLocalDevice::isValid() const
{
return d_ptr;
}
/*!
\fn void QBluetoothLocalDevice::setHostMode(QBluetoothLocalDevice::HostMode mode)
Sets the host mode the this local Bluetooth device to \a mode.
*/
/*!
\fn QBluetoothLocalDevice::HostMode QBluetoothLocalDevice::hostMode() const
Returns the current host mode of this local Bluetooth device.
*/
/*!
\fn QBluetoothLocalDevice::name() const
Returns the name assgined by the user to this Bluetooth device.
*/
/*!
\fn QBluetoothLocalDevice::address() const
Returns the MAC address of this Bluetooth device.
*/
/*!
\fn QList<QBluetoothLocalDevice> QBluetoothLocalDevice::allDevices()
Returns a list of all available local Bluetooth devices.
*/
/*!
\fn QBluetoothLocalDevice::powerOn()
Powers on the device on returning it to the hostMode() state is was in when powered down
*/
/*!
\fn QBluetoothLocalDevice::QBluetoothLocalDevice(QObject *parent)
Constructs a QBluetoothLocalDevice with \a parent.
*/
/*!
\fn QBluetoothLocalDevice::hostModeStateChanged(QBluetoothLocalDevice::HostMode state)
The \a state of the host has transitioned to a different HostMode
*/
/*!
\fn QBluetoothLocalDevice::pairingStatus(const QBluetoothAddress &address) const
Returns the current bluetooth pairing status of \a address, if it's unpaired, paired, or paired and authorized.
*/
/*!
\fn QBluetoothLocalDevice::pairingDisplayConfirmation(const QBluetoothAddress &address, QString pin)
Signal by some platforms to display a pairing confirmation dialog for \a address. The user
is asked to confirm the \a pin is the same on both devices. QBluetoothLocalDevice::pairingConfirmation(bool)
must be called to indicate if the user accepts or rejects the displayed pin.
*/
/*!
\fn QBluetoothLocalDevice::pairingConfirmation(bool accept)
To be called after getting a pairingDisplayConfirmation(). The \a accept parameter either
accepts the pairing or rejects it.
*/
/*!
\fn QBluetoothLocalDevice::pairingDisplayPinCode(const QBluetoothAddress &address, QString pin)
Signal by some platforms to display the \a pin to the user for \a address. The pin is automatically
generated, and does not need to be confirmed.
*/
/*!
\fn QBluetoothLocalDevice::requestPairing(const QBluetoothAddress &address, Pairing pairing)
Set the \a pairing status with \a address. The results are returned via
the signal pairingFinished(). Caution: creating a pairing may take minutes, and can require
the user to acknowledge dialogs.
*/
/*!
\fn QBluetoothLocalDevice::pairingFinished(const QBluetoothAddress &address, QBluetoothLocalDevice::Pairing pairing)
Pairing has completed with \a address. Current pairing status is in \a pairing.
*/
/*!
\fn QBluetoothLocalDevice::error(QBluetoothLocalDevice::Error error)
Signal emitted for pairing if there's an exceptional \a error
*/
/*!
\fn QBluetoothLocalDevice::QBluetoothLocalDevice(const QBluetoothAddress &address, QObject *parent = 0)
Construct new QBluetoothLocalDevice for \a address.
*/
#include "moc_qbluetoothlocaldevice.cpp"
QTM_END_NAMESPACE
|
