Home · All Namespaces · All Classes · Grouped Classes · Modules · Functions

BluetoothServiceManager Class Reference
[QtBluetoothModule]

The BluetoothServiceManager class controls Bluetooth services. More...

    #include <BluetoothServiceManager>

Inherits QObject.

• List of all members, including inherited members

Public Functions

• BluetoothServiceManager ( QObject * parent = 0 )
• ~BluetoothServiceManager ()

• 29 public functions inherited from QObject

Additional Inherited Members

• 1 property inherited from QObject
• 1 public slot inherited from QObject
• 1 signal inherited from QObject
• 1 public type inherited from QObject
• 4 static public members inherited from QObject
• 7 protected functions inherited from QObject
• 2 protected variables inherited from QObject

Detailed Description

The BluetoothServiceManager class controls Bluetooth services.

The Bluetooth Service Manager communicates over IPC with the Bluetooth services in order to control and track their states and attributes. It also communicates with other parties, such as the Bluetooth settings application, who are interested in controlling and tracking Bluetooth services.

The presence of the Bluetooth Service Manager provides several benefits:

• It automatically starts a Bluetooth service when it is created if it was still running at the end of the last Qt Extended session (or whenever it was last terminated).
• It records generic Bluetooth service settings across Qt Extended sessions. When a service is created, if it has previously registered with the Bluetooth Service Manager, the manager will set the service to use the the security options that were previously assigned to the service.
• External parties can control and access Qt Extended Bluetooth services through QBluetoothServiceController.

Without the presence of the Bluetooth Service Manager, components such as the QBluetoothServiceController class and the Bluetooth settings application will not function properly, as they rely on communication with the Bluetooth Service Manager in order to access and control Bluetooth services.

You can create custom Bluetooth services that will be automatically integrated into the Qt Extended Bluetooth framework, and which will be accessible by the Bluetooth Service Manager, by subclassing QBluetoothAbstractService. This is how the built-in Bluetooth services, such as QBluetoothHandsfreeService and QbluetoothHeadsetServices, are implemented.

The manager stores persistent service settings in BluetoothServices.conf. A default configuration file is provided at etc/default/Trolltech/BluetoothServices.conf. This can be modified to provide default settings for services.

See the Bluetooth Service Management Framework page for more details on the Bluetooth Service Manager's communication architecture.

This class is part of the Qt Extended server and cannot be used by other QtopiaApplications.

Member Function Documentation

BluetoothServiceManager::BluetoothServiceManager ( QObject * parent = 0 )

Constructs a BluetoothServiceManager with the given parent.

BluetoothServiceManager::~BluetoothServiceManager ()

Destructor.