Класс SimVoiceCallFilter
(Sailfish::Mdm::SimVoiceCallFilter)
Класс SimVoiceCallFilter управляет доступом к функциям голосового вызова. Подробнее…
Заголовочный файл: | #include <mdm-simvoicecallfilter.h> |
Свойства
- defaultDialAction : SimFilter::Action
- defaultIncomingAction : SimFilter::Action
- dialRules : SimFilter::RuleList
- incomingRules : SimFilter::RuleList
- ready : const bool
Публичные методы
- SimVoiceCallFilter(QObject *parent = 0)
- ~SimVoiceCallFilter()
- bool clearDialRules()
- bool clearIncomingRules()
- SimFilter::Action defaultDialAction() const
- SimFilter::Action defaultIncomingAction() const
- SimFilter::RuleList dialRules() const
- bool hasDialRuleForImsi(const QString &imsi) const
- bool hasIncomingRuleForImsi(const QString &imsi) const
- SimFilter::RuleList incomingRules() const
- bool ready() const
- bool removeDialRule(const QString &imsi)
- bool removeIncomingRule(const QString &imsi)
- bool setDefaultDialAction(SimFilter::Action action)
- bool setDefaultIncomingAction(SimFilter::Action action)
- bool setDialRule(const SimFilter::Rule &rule)
- bool setDialRules(const SimFilter::RuleList &rules)
- bool setIncomingRule(const SimFilter::Rule &rule)
- bool setIncomingRules(const SimFilter::RuleList &rules)
Сигналы
- void defaultDialActionChanged()
- void defaultIncomingActionChanged()
- void dialRuleAdded(const Sailfish::Mdm::SimFilter::Rule &rule)
- void dialRuleRemoved(const QString &imsi)
- void dialRulesChanged(const Sailfish::Mdm::SimFilter::RuleList &oldRules, const Sailfish::Mdm::SimFilter::RuleList &newRules)
- void incomingRuleAdded(const Sailfish::Mdm::SimFilter::Rule &rule)
- void incomingRuleRemoved(const QString &imsi)
- void incomingRulesChanged(const Sailfish::Mdm::SimFilter::RuleList &oldRules, const Sailfish::Mdm::SimFilter::RuleList &newRules)
- void readyChanged()
Подробное описание
Класс SimVoiceCallFilter управляет доступом к функциям голосового вызова.
С его помощью можно задавать правила фильтрации для входящих и исходящих голосовых вызовов.
Для использования данного класса в qmake-настройки проекта клиента следует добавить следующее:
CONFIG += link_pkgconfig
PKGCONFIG += sailfishmdm
и затем #include <mdm-simvoicecallfilter.h>
.
Пример использования:
#include <mdm-simvoicecallfilter.h>
int main(int argc, char **argv)
{
QCoreApplication app(arg, argv);
SimVoiceCallFilter *vcFilter = new SimVoiceCallFilter;
QObject::connect(vcFilter, &SimVoiceCallFilter::readyChanged, [vcFilter] {
qInfo() << vcFilter->dialRules().count() << "правила работы с исходящими и"
<< vcFilter->incomingRules().count() << "входящими вызовами заданы";
SimFilter::Rule rule("123456789", SimFilter::Block);
vcFilter->addDialRule(rule); // блокируются исходящие голосовые вызовы для SIM-карты с идентификатором IMSI
QObject::connect(vcFilter, &SimVoiceCallFilter::dialRuleAdded, [rule] {
qInfo() << "Правило работы с исходящими голосовыми вызовами добавлено для IMSI" << rule.imsi;
app.quit();
});
});
return app.exec();
}
Описание свойств
defaultDialAction : SimFilter::Action
Действие по умолчанию для исходящих голосовых вызовов.
Методы доступа:
- SimFilter::Action defaultDialAction() const
- bool setDefaultDialAction(SimFilter::Action action)
Сигнал уведомления:
- void defaultDialActionChanged()
defaultIncomingAction : SimFilter::Action
Действие по умолчанию для входящих голосовых вызовов.
Методы доступа:
- SimFilter::Action defaultIncomingAction() const
- bool setDefaultIncomingAction(SimFilter::Action action)
Сигнал уведомления:
- void defaultIncomingActionChanged()
dialRules : SimFilter::RuleList
Правило фильтрации для исходящих голосовых вызовов.
Методы доступа:
- SimFilter::RuleList dialRules() const
- bool setDialRules(const SimFilter::RuleList &rules)
Сигнал уведомления:
- void dialRulesChanged(const Sailfish::Mdm::SimFilter::RuleList &oldRules, const Sailfish::Mdm::SimFilter::RuleList &newRules)
incomingRules : SimFilter::RuleList
Правило фильтрации для входящих голосовых вызовов.
Методы доступа:
- SimFilter::RuleList incomingRules() const
- bool setIncomingRules(const SimFilter::RuleList &rules)
Сигнал уведомления:
- void incomingRulesChanged(const Sailfish::Mdm::SimFilter::RuleList &oldRules, const Sailfish::Mdm::SimFilter::RuleList &newRules)
ready : const bool
Истинно, если фильтр голосовых вызовов готов к использованию, свойствам заданы корректные значения.
Методы доступа:
- bool ready() const
Сигнал уведомления:
- void readyChanged()
Описание методов класса
SimVoiceCallFilter::SimVoiceCallFilter(QObject *parent = 0)
Конструктор по умолчанию для класса SimVoiceCallFilter.
SimVoiceCallFilter::~SimVoiceCallFilter()
Деструктор для класса SimVoiceCallFilter.
bool SimVoiceCallFilter::clearDialRules()
Очищает список правил фильтрации исходящих голосовых вызовов.
Данный запрос является асинхронным. По его завершении испускается сигнал dialRulesChanged().
Возвращает true, если асинхронный запрос был отправлен. Возвращает false и не выполняет никаких действий, если в текущий момент нет никаких правил работы с текстовыми сообщениями.
bool SimVoiceCallFilter::clearIncomingRules()
Очищает список правил фильтрации входящих голосовых вызовов.
Данный запрос является асинхронным. По его завершении испускается сигнал dialRulesChanged().
Возвращает true, если асинхронный запрос был отправлен. Возвращает false и не выполняет никаких действий, если в текущий момент нет никаких правил работы с текстовыми сообщениями.
[signal] void SimVoiceCallFilter::dialRuleAdded(const Sailfish::Mdm::SimFilter::Rule &rule)
Сигнал испускается после добавления нового правила rule для исходящих голосовых вызовов.
[signal] void SimVoiceCallFilter::dialRuleRemoved(const QString &imsi)
Сигнал испускается после удаления правила работы с исходящими голосовыми вызовами. Правило определяется по идентификатору IMSI, передаваемому в параметре imsi.
[signal] void SimVoiceCallFilter::dialRulesChanged(const Sailfish::Mdm::SimFilter::RuleList &oldRules, const Sailfish::Mdm::SimFilter::RuleList &newRules)
Сигнал испускается при изменении правил работы с исходящими голосовыми вызовами. Старая версия списка правил передается в параметре oldRules, новая версия — в параметре newRules. Список правил считается изменившимся при изменении хотя бы одного правила.
Примечание: сигнал уведомления для свойства dialRules.
bool SimVoiceCallFilter::hasDialRuleForImsi(const QString &imsi) const
Определяет, существует ли правило исходящих голосовых вызовов для идентификатора IMSI, переданного в параметре imsi.
bool SimVoiceCallFilter::hasIncomingRuleForImsi(const QString &imsi) const
Определяет, существует ли правило входящих голосовых вызовов для идентификатора IMSI, переданного в параметре imsi.
[signal] void SimVoiceCallFilter::incomingRuleAdded(const Sailfish::Mdm::SimFilter::Rule &rule)
Испускается после добавления нового правила rule для входящих голосовых вызовов.
[signal] void SimVoiceCallFilter::incomingRuleRemoved(const QString &imsi)
Сигнал испускается после удаления правила работы с входящими голосовыми вызовами. Правило определяется по идентификатору IMSI, передаваемому в параметре imsi.
[signal] void SimVoiceCallFilter::incomingRulesChanged(const Sailfish::Mdm::SimFilter::RuleList &oldRules, const Sailfish::Mdm::SimFilter::RuleList &newRules)
Сигнал испускается при изменении правил работы с входящими голосовыми вызовами. Старая версия списка правил передается в параметре oldRules, новая версия — в параметре newRules. Список правил считается изменившимся при изменении хотя бы одного правила.
Примечание — Cигнал уведомления для свойства incomingRules.
bool SimVoiceCallFilter::removeDialRule(const QString &imsi)
Удаляет правило из списка правил работы с исходящими голосовыми вызовами. Правило определяется по идентификатору IMSI, передаваемому в параметре imsi.
Данный запрос является асинхронным. По его завершении испускаются сигналы dialRulesChanged() и dialRuleRemoved().
Возвращает true, если асинхронный запрос был отправлен. Возвращает false и не выполняет никаких действий, если идентификатор IMSI является недействительным или если для этого идентификатора не существует правила.
bool SimVoiceCallFilter::removeIncomingRule(const QString &imsi)
Удаляет правило из списка правил работы с входящими голосовыми вызовами. Правило определяется по идентификатору IMSI, передаваемому в параметре imsi.
Данный запрос является асинхронным. По его завершении испускаются сигналы incomingRulesChanged() и incomingRuleRemoved().
Возвращает true, если асинхронный запрос был отправлен. Возвращает false и не выполняет никаких действий, если идентификатор IMSI является недействительным или если для этого идентификатора не существует правила.
bool SimVoiceCallFilter::setDialRule(const SimFilter::Rule &rule)
Добавляет или изменяет правило rule в списке правил работы с исходящими голосовыми вызовами.
Данный запрос является асинхронным. По его завершении испускается сигнал dialRulesChanged(). Если это новое правило, то также испускается сигнал dialRuleAdded().
Возвращает true, если асинхронный запрос был отправлен. Возвращает false и не выполняет никаких действий, если идентификатор IMSI является недействительным или если уже есть правило с таким же идентификатором IMSI и действием.
bool SimVoiceCallFilter::setDialRules(const SimFilter::RuleList &rules)
Применяет список правил работы с исходящими голосовыми вызовами, переданный в параметре rules.
Данный запрос является асинхронным. По его завершении испускается сигнал dialRulesChanged().
Возвращает true, если асинхронный запрос был отправлен. Возвращает false и не выполняет никаких действий, если идентификатор IMSI является недействительным или если задаваемый список правил полностью соответствует существующему списку правил.
Примечание — Задающий метод для свойства dialRules.
См. также dialRules().
bool SimVoiceCallFilter::setIncomingRule(const SimFilter::Rule &rule)
Добавляет или изменяет правило rule в списке правил работы с входящими голосовыми вызовами.
Данный запрос является асинхронным. По его завершении испускается сигнал incomingRulesChanged(). Если это новое правило, то также испускается сигнал incomingRuleAdded().
Возвращает true, если асинхронный запрос был отправлен. Возвращает false и не выполняет никаких действий, если идентификатор IMSI является недействительным или если уже есть правило с таким же идентификатором IMSI и действием.
bool SimVoiceCallFilter::setIncomingRules(const SimFilter::RuleList &rules)
Применяет список правил работы с входящими голосовыми вызовами, переданный в параметре rules.
Данный запрос является асинхронным. По его завершении испускается сигнал incomingRulesChanged().
Возвращает true, если асинхронный запрос был отправлен. Возвращает false и не выполняет никаких действий, если идентификатор IMSI является недействительным или если задаваемый список правил полностью соответствует существующему списку правил.
Примечание — Задающий метод для свойства incomingRules.
См. также incomingRules().