Класс CallHistory

(Sailfish::Mdm::CallHistory)

Класс CallHistory предоставляет доступ к истории телефонных вызовов. Подробнее…

Заголовочный файл:

#include <mdm-CallHistory.h>

• Список всех членов класса, включая унаследованные

Публичные типы

• class Filter
• class Result
• enum CallType { AnyCallType, OutgoingCall, MissedCall, IncomingCall }

Публичные методы

• CallHistory(QObject *parent = 0)
• ~CallHistory()
• void search(const Sailfish::Mdm::CallHistory::Filter &filter)

Сигналы

• void searchFinished(bool success, const QList<Sailfish::Mdm::CallHistory::Result> &results)

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

Класс CallHistory предоставляет доступ к истории телефонных вызовов.

Для использования данного класса в qmake-настройки проекта клиента следует добавить следующее:

 CONFIG += link_pkgconfig
 PKGCONFIG += sailfishmdm

и затем #include <mdm-callhistory.h>.

Пример использования:

 #include <mdm-callhistory.h>

 using namespace Sailfish::Mdm;

 void printCallHistory(QObject *parent)
 {
     CallHistory filter;
     filter.callType = CallHistory::MissedCall;
     filter.start = QDateTime(QDate(2000, 1, 1));

     CallHistory *history = new CallHistory(parent);
     QString fileName = "/tmp/callhistory.log";
     history->search(filter);

     QObject::connect(stats, &CallHistory::searchFinished, [stats, &intervalFormat](bool success, const QList<Sailfish::Mdm::CallHistory::Result> &results) {
         if (success) {
             for (const CallHistory::Result &result : results) {
                 qInfo() << result.when.toString(intervalFormat) << result.finish.toString(intervalFormat) << result.phoneNumber << "вызовы";
             }
             qInfo() << "Удачно получена история вызовов";
         } else {
             qInfo() << "Не удалось собрать историю вызовов!";
         }
     });
 }

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

Описание типов класса

enum CallHistory::CallType

Типы телефонных вызовов для использования в классе Filter.

Константа	Значение	Описание
Sailfish::Mdm::CallHistory::AnyCallType	0	Любой тип телефонных вызовов
Sailfish::Mdm::CallHistory::OutgoingCall	1	Исходящие телефонные вызовы
Sailfish::Mdm::CallHistory::MissedCall	2	Пропущенные телефонные вызовы
Sailfish::Mdm::CallHistory::IncomingCall	3	Принятые телефонные вызовы

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

CallHistory::CallHistory(QObject *parent = 0)

Конструктор для класса CallHistory с родительским элементом, указанным в параметре parent.

CallHistory::~CallHistory()

Деструктор для класса CallHistory.

void CallHistory::search(const Sailfish::Mdm::CallHistory::Filter &filter)

Получает историю вызовов, отфильтрованную по заданному параметру filter.

[signal] void CallHistory::searchFinished(bool success, const QList<Sailfish::Mdm::CallHistory::Result> &results)

Испускается по завершении поиска, выполненного в результате вызова метода search().

Значением параметра success является true, если вызов метода был выполнен успешно. Параметр results содержит список результатов поиска.