|
Home · All Namespaces · All Classes · Grouped Classes · Modules · Functions | |
The QBluetoothAbstractService class provides a base interface class for Bluetooth services within Qtopia. More...
#include <QBluetoothAbstractService>
Inherits QObject.
Inherited by QBluetoothHandsfreeService, QBluetoothHeadsetService, and QBluetoothSerialPortService.
The QBluetoothAbstractService class provides a base interface class for Bluetooth services within Qtopia.
To create a Qt Extended Bluetooth service, subclass QBluetoothAbstractService and implement the start(), stop() and setSecurityOptions() methods. Your service will automatically be registered and accessible as a Bluetooth service within Qtopia. This means the service will be accessible to external parties through QBluetoothServiceController. It will also be shown in the list of local services in the Bluetooth settings application, allowing end users to modify the service's settings.
Naturally, it is possible to implement Bluetooth services outside of Qt Extended by using the BlueZ libraries and standard Linux tools. However, such services will not be accessible through Qtopia.
See also Tutorial: Creating a Bluetooth service.
Possible errors that might occur.
| Constant | Value | Description |
|---|---|---|
| QBluetoothAbstractService::NoError | 0 | No error. |
| QBluetoothAbstractService::InvalidArguments | 1 | Invalid arguments were passed. |
| QBluetoothAbstractService::NotConnected | 2 | The remote device is not connected. |
| QBluetoothAbstractService::NotAuthorized | 3 | The service trying to perform the action does not have permission to manipulate the resource. |
| QBluetoothAbstractService::NotAvailable | 4 | The resource is not available. |
| QBluetoothAbstractService::DoesNotExist | 5 | The requested resource does not exist. |
| QBluetoothAbstractService::Failed | 6 | Operation failed. |
| QBluetoothAbstractService::Rejected | 7 | Authorization request was rejected by the user or it was not accepted in due time. |
| QBluetoothAbstractService::Canceled | 8 | Authorization request was canceled. |
| QBluetoothAbstractService::UnknownError | 9 | Unknown error. |
Constructs a Bluetooth service. The name is a unique name that identifies the service, and displayName is a user-friendly, internationalized name for this service that can be displayed to the end user. The parent is the QObject parent for this service.
Constructs a Bluetooth service. The name is a unique name that identifies the service. The displayName is a user-friendly, internationalized name for this service that can be displayed to the end user. The description is a translated description that might be displayed to the user. The parent is the QObject parent of this object.
Destroys a Bluetooth service.
This signal will be emitted when the authorization request has denied.
See also authorizationSucceeded(), error(), and errorString().
This signal will be emitted when the authorization request has been granted.
See also authorizationFailed().
Cancel the previous authorization request. The remote and uuid parameters must match the parameters sent with the authorization request.
Returns true if the request could be canceled.
See also requestAuthorization() and authorizationFailed().
Returns the description for this service.
See also name() and displayName().
Returns the user-friendly, internationalized name for this service that can be displayed to the end user.
See also name() and description().
Returns the last error that has occurred.
See also errorString().
Returns an error message for the last error that has occurred.
See also error().
Returns the unique name that identifies this service.
See also displayName() and description().
Registers the SDP service record record for this Bluetooth service and returns the service record handle of the newly registered service. Returns zero if the registration failed.
See also unregisterRecord() and updateRecord().
This is an overloaded member function, provided for convenience.
Uses the XML data from the file filename to register the SDP service record for this Bluetooth service and returns the service record handle of the newly registered service. Returns zero if the registration failed.
See Using a XML-formatted SDP record for details on how to generate a XML-formatted SDP reord.
Warning: The given file must be UTF-8 encoded to be parsed correctly.
See also unregisterRecord() and updateRecord().
Request authorization for the use of this service by Bluetooth device with remote address. The uuid parameter can be used to identify the service (e.g. can be the UUID of the service as used in the SDP service record).
Returns true if the request could be started, and false otherwise.
See also authorizationSucceeded(), cancelAuthorization(), and authorizationFailed().
Sets the security options for this service to the given options.
This method will be called by Qt Extended when the security options should be changed.
Subclasses must override this to set the security options for this service.
Starts this service.
This method will be called by Qt Extended when the service should be started. This may be because an external party has required that the service be started (for example, through QBluetoothServiceController, or through the Bluetooth Settings application) or because Qt Extended has been configured to start the service automatically.
Subclasses must override this to start the service appropriately. The subclass must emit started() when the service has started, or failed while trying to start, to announce the result of the start() invocation.
Warning: This function must be implementated in such a way that any intermediate objects (which have been created up to the point where the error occurred) are cleaned up before the error signal is emitted.
See also started() and stop().
When implementing the start() function, this signal must be emitted by the subclass when the service has started or failed while attempting to start, to announce the result of the start() invocation.
If the service failed to start, error should be true and description should be a human-readable description of the error. Otherwise, error should be false and description should be a null QString.
See also start() and stopped().
Stops this service.
This method will be called by Qt Extended when the service should be stopped.
Subclasses must override this to stop the service appropriately. The subclass must emit stopped() to announce that the service has stopped.
See also stopped() and start().
This signal must be emitted by the subclass inside the implementation of the stop() function, to announce that the service has stopped.
See also started() and stop().
Unregisters the SDP service record with the service record handle handle.
Returns whether the record was successfully unregistered.
See also registerRecord() and updateRecord().
Updates the already registered SDP service record with handle to the contents of the new record.
Returns true if the update succeeded, and false otherwise.
See also unregisterRecord() and registerRecord().
This is an overloaded member function, provided for convenience.
Uses the XML data from the file filename to update the already registered SDP record with handle. Returns true if the update succeeded and false otherwise.
Warning: The given file must be UTF-8 encoded to be parsed correctly.
See also unregisterRecord() and registerRecord().
| Copyright © 2009 Nokia | Trademarks | Qt Extended 4.4.3 |