This document describes LBS privacy notifiers and the data types that licensees can use to create notifiers to notify a user of privacy requests. A licensee must implement either a Privacy Controller or the Privacy Notifiers described in this document to handle privacy requests. See
Note that use of the LBS Privacy Notifiers described in this document is the recommended way of creating notifiers for LBS. The alternative Privacy Q&N Notifiers are deprecated.
Some knowledge of the
Figure 1 shows the LBS Privacy Notifiers within the context of the
To use the LBS Privacy Notifiers, a licensee must implement two notifiers:
A Privacy Verification Notifier that receives a privacy verification request from the LBS subsystem and returns a privacy response. This notifier is used to obtain user approval to send the location.
A Privacy Notification Notifier that receives a privacy notification request from the LBS subsystem and does not return any response. This notifier is used simply to notify the user that their location is being sent.
The LBS Privacy Notifiers are standard Symbian notifiers that use the Symbian
Classes and types
The following table lists the main classes and types of the Privacy Data Types. Further details can be found by following the links to other sections of this document and to Symbian Developer Library reference documentation.
The Privacy Notifiers types have
Licensees who choose to use LBS Privacy Notifiers must implement two of them, one for privacy request verification and one for privacy request notification. Both notifiers can be packaged in the same ECOM plug-in DLL.
The header file
Privacy Notifiers API class diagram
The LBS Privacy Notifier data classes and types are defined in
Libraries
The LBS Privacy Notifiers are packaged in
Capabilities
Privacy Notifiers require the
LBS Configuration
The LBS Administration setting
Sequential processing of privacy requests
The LBS subsystem sends privacy requests sequentially to Privacy Notifiers. If multiple privacy requests are received how they are handled depends on the interface via which the privacy request was received:
Request received from a
A second privacy request forces LBS to cancel an outstanding privacy request (but not emergency requests). The Privacy Notifier in use for the first privacy request is cancelled. The Privacy Notifier is then restarted to handle the second privacy request.
Request received via the
Privacy notification and verification requests are sent sequentially to Privacy Notifiers. A Privacy Notifier must have responded to one privacy request (or LBS must have sent a timeout response) before the next request can be sent to the notifier. The maximum number of privacy requests that can be outstanding in the LBS subsystem is defined by the LBS administration setting
This document describes LBS privacy notifiers and the data types that licensees can use to create notifiers to notify a user of privacy requests. A licensee must implement either a Privacy Controller or the Privacy Notifiers described in this document to handle privacy requests. See
Note that use of the LBS Privacy Notifiers described in this document is the recommended way of creating notifiers for LBS. The alternative Privacy Q&N Notifiers are deprecated.
Some knowledge of the
Figure 1 shows the LBS Privacy Notifiers within the context of the
To use the LBS Privacy Notifiers, a licensee must implement two notifiers:
A Privacy Verification Notifier that receives a privacy verification request from the LBS subsystem and returns a privacy response. This notifier is used to obtain user approval to send the location.
A Privacy Notification Notifier that receives a privacy notification request from the LBS subsystem and does not return any response. This notifier is used simply to notify the user that their location is being sent.
The LBS Privacy Notifiers are standard Symbian notifiers that use the Symbian
Classes and types
The following table lists the main classes and types of the Privacy Data Types. Further details can be found by following the links to other sections of this document and to Symbian Developer Library reference documentation.
The Privacy Notifiers types have
Licensees who choose to use LBS Privacy Notifiers must implement two of them, one for privacy request verification and one for privacy request notification. Both notifiers can be packaged in the same ECOM plug-in DLL.
The header file
Privacy Notifiers API class diagram
The LBS Privacy Notifier data classes and types are defined in
Libraries
The LBS Privacy Notifiers are packaged in
Capabilities
Privacy Notifiers require the
LBS Configuration
The LBS Administration setting
Sequential processing of privacy requests
The LBS subsystem sends privacy requests sequentially to Privacy Notifiers. If multiple privacy requests are received how they are handled depends on the interface via which the privacy request was received:
Request received from a
A second privacy request forces LBS to cancel an outstanding privacy request (but not emergency requests). The Privacy Notifier in use for the first privacy request is cancelled. The Privacy Notifier is then restarted to handle the second privacy request.
Request received via the
Privacy notification and verification requests are sent sequentially to Privacy Notifiers. A Privacy Notifier must have responded to one privacy request (or LBS must have sent a timeout response) before the next request can be sent to the notifier. The maximum number of privacy requests that can be outstanding in the LBS subsystem is defined by the LBS administration setting