Intents interface

Интерфейс Intents — это интерфейс Client API RuntimeManager. Он предоставляет клиентам возможность вызывать и обрабатывать интенты. Подробнее…

Примечание. ОС определяет некоторые интенты (имена, допустимые параметры и возвращаемые значения), но приложения могут регистрировать произвольные интенты, если их имя начинается с символов "X-".

Методы

invoke(const QString &intentName, const QJsonObject &hints, const QJsonObject &params)
QUri intentToUri(const QString &intentName, const QJsonObject &hints, const QJsonObject &params)

Cигналы

replyReceived(const QJsonObject &reply, const Error &error)

Подробное описание

Интерфейс Intents предоставляет клиентам возможность вызывать и обрабатывать интенты. Позволяет приложениям вызывать действия в других приложениях.

Стандартные интенты:

Start — для запуска каких-либо действий или процессов.
OpenURI — для открытия определенного URI.

Описание методов

invoke(const QString &intentName, const QJsonObject &hints, const QJsonObject &params)

Предназначен для вызова интента. Этот метод может быть использован для вызова как стандартных, так и нестандартных интентов (нужно убедиться, что имя для нестандартного интента начинается с префикса X-). Поскольку намерения требуют времени для обработки, ответ будет доставлен асинхронно сигналом replyReceived().

Передаваемые аргументы:

intentName — имя вызываемого интента;
hints — подсказки для службы RuntimeManager, например:
- preferredHandler — для указания идентификатора приложения желаемого обработчика. Если предпочтительный обработчик и приложение не принадлежат одной организации, этот флаг игнорируется.
params — параметры интента.

QUri intentToUri(const QString &intentName, const QJsonObject &hints, const QJsonObject &params)

Предназначен для преобразования интента в URI. Тип возвращаемого значения QUri.

Передаваемые аргументы:

intentName — имя вызываемого интента;
hints — подсказки для службы RuntimeManager, подробнее в методе invoke;
params — параметры интента.

Описание сигналов

replyReceived(const QJsonObject &reply, const Error &error)

Обратный вызов для завершения. Этот сигнал будет отправлен, когда будет получен ответ. Сообщение об ошибке будет пустым при действительном ответе.

reply — данные ответа. Семантика зависит от интента;
error — устанавливает значение допустимой ошибки, если произошла ошибка.