IntentServer QML Type
The System-UI side singleton representing the Intents sub-system. More...
|Import Statement:||import QtApplicationManager.SystemUI 2.0|
- intentList : list<Intent>
- disambiguationRequest(requestId, list<Intent> potentialIntents, var parameters)
- acknowledgeDisambiguationRequest(requestId, Intent selectedIntent)
- Intent find(intentId, string applicationId, var parameters)
This singleton serves two purposes: for one, it gives the System-UI access to the database of all the available intents via intentList, plus it exposes the API to deal with ambigous intent requests. Intent requests can be ambigous if the requesting party only specified the
intentId, but not the targeted
applicationId in its call to IntentClient::sendIntentRequest(). In these cases, it is the responsibility of the System-UI to disambiguate these requests by reacting on the disambiguationRequest() signal.
This signal is emitted when the IntentServer receives an intent request that could potentially be handled by more than one application.
Note: This signal is only emitted, if there is a receiver connected at all. If the signal is not connected, an arbitrary application from the list of potential matches will be chosen to handle this request.
The receiver of this signal gets the requested requestId and its parameters. It can then either call acknowledgeDisambiguationRequest() to choose from one of the supplied potentialIntents or call rejectDisambiguationRequest() to reject the intent request completely. In both cases the unique requestId needs to be sent along to identify the intent request.
Not calling one of these two functions will result in memory leaks.
See also IntentClient::sendIntentRequest.
Emitted when a new intent gets added to the intentList (e.g. on application installation).
Emitted when either a new intent gets added to or an existing intent is remove from the intentList.
Emitted when an existing intent is removed from the intentList (e.g. on application deinstallation).
acknowledgeDisambiguationRequest(requestId, Intent selectedIntent)
If no matching Intent is found, the function will return an invalid Intent.
© 2019 Luxoft Sweden AB. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.