QBluetoothServiceDiscoveryAgent Class Reference

 #include <QBluetoothServiceDiscoveryAgent>

     QBluetoothServiceDiscoveryAgent *discoveryAgent = new QBluetoothServiceDiscoveryAgent(this);

     connect(discoveryAgent, SIGNAL(serviceDiscovered(const QBluetoothServiceInfo&)),
             this, SLOT(serviceDiscovered(const QBluetoothServiceInfo&)));

     // Automatically delete agent when service discovery finishes.
     connect(discoveryAgent, SIGNAL(finished()), this, SLOT(deleteLater()));

     discoveryAgent->start();

Member Function Documentation

QBluetoothServiceDiscoveryAgent::QBluetoothServiceDiscoveryAgent ( QObject * parent = 0 )

Constructs a new QBluetoothServiceDiscoveryAgent with parent. Services will be discovered on all contactable devices.

QBluetoothServiceDiscoveryAgent::QBluetoothServiceDiscoveryAgent ( const QBluetoothAddress & remoteAddress, QObject * parent = 0 )

Constructs a new QBluetoothServiceDiscoveryAgent for remoteAddress and with parent.

If remoteAddress is null services will be discovred on all contactable Bluetooth devices.

QBluetoothServiceDiscoveryAgent::~QBluetoothServiceDiscoveryAgent ()

Destructor for QBluetoothServiceDiscoveryAgent

void QBluetoothServiceDiscoveryAgent::canceled () [signal]

Signals the cancellation of the service discovery.

void QBluetoothServiceDiscoveryAgent::clear () [slot]

Clears the results of a previous service discovery.

QList<QBluetoothServiceInfo> QBluetoothServiceDiscoveryAgent::discoveredServices () const

Returns the list of all discovered services.

Error QBluetoothServiceDiscoveryAgent::error () const

Returns the type of error that last occurred. If service discovery is done on a signle address it will returns errors when trying to discover services on that device. If the alternate constructor is used and devices are discovered by a scan, then errors doing service discovery on individual devices are not saved and no signals are emitted. In this case errors are fairly normal since some devices may not respond to discovery or may no longer be in range. As such errors are surpressed. If no services are returned, it can be assumed no services could be discovered.

void QBluetoothServiceDiscoveryAgent::error ( QBluetoothServiceDiscoveryAgent::Error error ) [signal]

This signal is emitted when an error occurs. The error parameter describes the error that occurred.

QString QBluetoothServiceDiscoveryAgent::errorString () const

Returns a human-readable description of the last error that occurred when doing service discovery on a single device.

void QBluetoothServiceDiscoveryAgent::finished () [signal]

This signal is emitted when Bluetooth service discovery completes.

bool QBluetoothServiceDiscoveryAgent::isActive () const

Returns true if service discovery is currently active, otherwise returns false.

void QBluetoothServiceDiscoveryAgent::serviceDiscovered ( const QBluetoothServiceInfo & info ) [signal]

This signal is emitted when the Bluetooth service described by info is discovered.

void QBluetoothServiceDiscoveryAgent::setUuidFilter ( const QList<QBluetoothUuid> & uuids )

Sets the UUID filter to uuids. Only services matching the UUIDs in uuids will be returned.

An empty UUID list is equivalent to a list containing only QBluetoothUuid::PublicBrowseGroup.

See also uuidFilter().

void QBluetoothServiceDiscoveryAgent::setUuidFilter ( const QBluetoothUuid & uuid )

This is an overloaded member function, provided for convenience.

Sets the UUID filter to a list containing the single element uuid.

See also uuidFilter().

void QBluetoothServiceDiscoveryAgent::start ( DiscoveryMode mode = MinimalDiscovery ) [slot]

Starts service discovery. mode specifies the type of service discovery to perform.

See also DiscoveryMode.

void QBluetoothServiceDiscoveryAgent::stop () [slot]

Stops service discovery.

QList<QBluetoothUuid> QBluetoothServiceDiscoveryAgent::uuidFilter () const

Returns the UUID filter.

See also setUuidFilter().