Класс Call

(ru::auroraos::call::Call)

Представляет существующий голосовой вызов. Подробнее…

Подключение:

#include <call.h>

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

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

enum

Status

Свойства

• acceptedAt : const qint64
• active : const bool
• callId : const QString
• holdable : const bool
• incoming : const bool
• initiatedAt : const qint64
• localHandle : const QString
• localName : const QString
• remoteHandle : const QString
• remoteName : const QString
• status : const Status
• uri : const QString

Публичные функции

	Call(CallManager *manager, const QString &id, const QVariantMap &parameters, QObject *parent = nullptr)
virtual	~Call()
qint64	acceptedAt() const
bool	active() const
void	addInterfaces(const QList<QObject *> &handlers)
QString	callId() const
bool	holdable() const
bool	incoming() const
qint64	initiatedAt() const
QString	localHandle() const
QString	localName() const
QDBusObjectPath	objectPath() const
QString	remoteHandle() const
QString	remoteName() const
Status	status() const
QString	uri() const

Публичные слоты

void	setStatus(Status status)

Сигналы

void	accepted()
void	activeChanged(bool active)
void	disconnected()
void	heldChanged(bool held)
void	rejected()
void	statusChanged(Status status)

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

Представляет существующий голосовой вызов.

Описание типов-членов

enum Call::Status

Статус Call

Изменения в Call::Status

Валидные переходы для исходящих вызовов:

Dialing --> Active --> Disconnecting --> Disconnected
              ^        ^
              |        |
              v        |
             Held------/

Валидные переходы для входящих вызовов:

Ringing --> Accepting --> Active -> Rejecting --> Disconnected
                            ^       ^
                            |       |
                            v       |
                           Held-----/

Другие переходы могут игнорироваться ОС.

Константа	Значение	Описание
ru::auroraos::call::Call::Unknown	0	ОС игнорирует вызовы с таким статусом.
ru::auroraos::call::Call::Disconnected	1	Вызов завершен, ОС скрывает пользовательский интерфейс вызова.
ru::auroraos::call::Call::Dialing	2	Исходящий вызов создан, соединение установлено, но абонент еще не принял вызов. В ОС отображается экран телефона со статусом "Dialing".
ru::auroraos::call::Call::Ringing	3	Входящий вызов создан, соединение установлено. Операционная система индицирует наличие входящего вызова: аудио-визуальный сигнал, вибрация.
ru::auroraos::call::Call::Rejecting	4	Вызов будет завершен, но соединение еще не закрыто. ОС скрывает пользовательский интерфейс телефона.
ru::auroraos::call::Call::Accepting	5	Входящий вызов принят пользователем, но его медиапотоки еще не запущены.
ru::auroraos::call::Call::Active	6	Идет вызов, и медиапотоки запущены. В ОС отображается пользовательский интерфейс телефона с таймером выполнения вызова.
ru::auroraos::call::Call::Held	7	Вызов находится в процессе, медиапотоки запущены, но находятся в режиме удержания или в активном состоянии находится другой вызов. В ОС отображается пользовательский интерфейс телефона со статусом "Hold".

Описание свойств

acceptedAt : const qint64

Это свойство содержит значение AcceptedAt.

Содержит количество секунд с начала эпохи (timestamp UTC) для события принятия вызова.

Необязательный параметр. Для использования в будущем.

Функции доступа:

qint64

acceptedAt() const

Cм. также CallManager::newCall.

active : const bool

Это свойство отображает состояние аудиопотока.

Это свойство будет равно true, если разрешён запуск аудиопотоков (Call::status равен Call::Active или Call::Accepting).

Функции доступа:

bool	active() const

Сигнал уведомления:

void	activeChanged(bool active)

См. также Call::setStatus.

callId : const QString

В этом свойстве хранится идентификатор вызова, переданный в CallManager::newCall.

Функции доступа:

QString

callId() const

Cм. также CallManager::newCall.

holdable : const bool

Это свойство содержит значение Holdable для данного вызова.

Если holdable установлено, ОС переведет этот вызов в режим удержания при появлении другого активного вызова и будет выдано Call::heldChanged, в противном случае вызов будет сброшен вызовом Reject на интерфейсе D-Bus этого вызова. Тогда будет издан сигнал Call::rejected.

Необязательный параметр.

Функции доступа:

bool	holdable() const

См. также Call::heldChanged, Call::rejected и CallManager::newCall.

incoming : const bool

Это свойство содержит значение Incoming для данного вызова.

Функции доступа:

bool	incoming() const

Cм. также CallManager::newCall.

initiatedAt : const qint64

Это свойство содержит значение InitiatedAt.

Содержит количество секунд с начала эпохи (timestamp UTC) для события создания вызова.

Необязательный параметр. Для использования в будущем.

Функции доступа:

qint64

initiatedAt() const

Cм. также CallManager::newCall.

localHandle : const QString

Это свойство содержит значение LocalHandle.

Здесь отображается внутренний идентификатор локальной учётной записи для этого вызова.

Необязательный параметр. Для использования в будущем.

Функции доступа:

QString

localHandle() const

Cм. также CallManager::newCall.

localName : const QString

Это свойство содержит значение LocalName.

Здесь отображается удобочитаемое имя локальной учётной записи для этого вызова. Это значение будет показано ОС в пользовательском интерфейсе приложения "Телефон".

Необязательный параметр. Для использования в будущем.

Функции доступа:

QString

localName() const

Cм. также CallManager::newCall.

remoteHandle : const QString

Это свойство содержит значение RemoteHandle.

Представляет внутренний идентификатор вызываемого абонента.

Необязательный параметр. Для использования в будущем.

Функции доступа:

QString

remoteHandle() const

Cм. также CallManager::newCall.

remoteName : const QString

Это свойство содержит значение RemoteName.

Здесь отображается удобочитаемое имя вызываемого абонента. Это значение будет показано ОС в пользовательском интерфейсе приложения "Телефон".

Обязательный параметр.

Функции доступа:

QString

remoteName() const

Cм. также CallManager::newCall.

status : const Status

Это свойство содержит текущий статус данного вызова.

Функции доступа:

Status

status() const

Сигнал уведомления:

void	statusChanged(Status status)

См. также Call::Status.

uri : const QString

Это свойство содержит значение uRI для данного вызова.

Если необходимо сохранить этот вызов в журнале вызовов, нужно установить значение URI, представляющее абонента. ОС должна иметь возможность повторить этот вызов, вызвав приложение по D-Bus с помощью zone.domain.app-name.openUri с аргументом типа 'as'. Этот URI будет передан в качестве первого элемента списка.

Длина URI не должна превышать 255 символов, иначе он будет считаться пустым.

Необязательный параметр.

Функции доступа:

QString

uri() const

Cм. также CallManager::newCall.

Описание функций-членов

Call::Call(CallManager *manager, const QString &id, const QVariantMap &parameters, QObject *parent = nullptr)

Создает экземпляр Call.

[virtual] Call::~Call()

Уничтожает экземпляр Call. ОС будет считать этот вызов завершенным.

[signal] void Call::accepted()

Сигнализирует о том, что вызов принят пользователем с помощью пользовательского интерфейса приложения "Телефон".

void Call::addInterfaces(const QList<QObject *> &handlers)

Подключение дополнительных интерфейсов для управления этим вызовом.

Новые обработчики перечислены в handlers. Обработчик должен наследовать как QObject, так один или несколько интерфейсов управления, например DTMFInterface. Не нужно вызывать Call::addInterfaces, если все дополнительные интерфейсы управления предоставляются экземпляром Call, созданным с помощью пользовательской фабрики Call.

Cм. также CallFactoryInterface и DTMFInterface.

[signal] void Call::disconnected()

Сигнализирует о том, что Call находится в состоянии Call::Disconnected.

[signal] void Call::heldChanged(bool held)

Сигнализирует об изменении свойства Call::held.

Если это свойство устанавливается в true, вызов переводится в режим удержания пользователем с помощью пользовательского интерфейса приложения "Телефон" или удерживаемый вызов прерывается другим активным вызовом.

Если значение held становится false, пользователь отменяет удержание этого вызова с помощью пользовательского интерфейса приложения "Телефон".

QDBusObjectPath Call::objectPath() const

Возвращает путь к объекту D-Bus соответствующего объекта ru.auroraos.call.Call1.

[signal] void Call::rejected()

Сигнализирует о том, что Call отклонен.

Call отклонен пользователем с помощью пользовательского интерфейса приложения "Телефон" или вызов, не поддерживающий hold, прерван другим активным вызовом. Следующее состояние — Call::Disconnected.

[slot] void Call::setStatus(Status status)

Изменение статуса вызова.

В соответствии с этим значением ОС будет изменять состояние устройства.

См. также status() и Call::Status.