Call.Call1
Интерфейс ru.auroraos.Call.Call1 для работы с Call API.
Call.Call1 используется для управления самим вызовом.
Подробнее…
| Шина: | пользовательская |
| Служба: | определяется приложением |
| Объект: | определяется приложением |
| Интерфейс: | ru.auroraos.Call.Call1 |
Свойства
- Holdable: bool [только для чтения, опционально]
- Incoming: bool [только для чтения, опционально]
- LocalHandle: QString [только для чтения, опционально]
- LocalName: QString [только для чтения, опционально]
- RemoteHandle: QString [только для чтения, опционально]
- RemoteName: QString [только для чтения, обязательно]
- Status: uint [только для чтения, обязательно]
- Uri: QString [только для чтения, опционально]
Методы
Сигналы
- StatusChanged(uint32 status)
Подробное описание
Для сигнализации о новом звонке приложение должно зарегистрировать
на сессионной шине объект с интерфейсом ru.auroraos.Call.Call1.
Через него приложение предоставит ОС информацию о звонке и будет происходить управление звонком.
При появлении нового звонка в статусе Dialing, Ringing, Active система отображает
графический интерфейс приложения Телефон.
Если статус равен Ringing и звонок имеет свойство Incoming равное true,
то проигрывается сигнал уведомления о входящем звонке.
Пользователь взаимодействует с интерфейсом Телефона, что приводит к вызовам ru.auroraos.Call.Call1.Accept
или ru.auroraos.Call.Call1.Reject при приёме или отклонении звонка.
В некоторых случаях ОС вызывает Call.Call1.Reject автоматически, например,
при наличии нескольких конкурирующих звонков.
Если свойство Incoming равно false или отсутствует, то отображается интерфейс исходящего звонка,
см. описание поля Status.
При изменении статуса звонка, например (для исходящих вызовов
Dialing → Active → Rejecting → Disconnected, для входящих
Ringing → Accepting → Rejecting → Disconnected) необходимо уведомить ОС вызовом сигнала
ru.auroraos.Call.Call1.StatusChanged.
Описание свойств
Holdable: bool [только для чтения, опционально]
SetHold() вызывается операционной системой при переводе звонка на удержание,
в противном случае будет вызван Reject.
Incoming: bool [только для чтения, опционально]
Необходимо установить для Incoming значение true для входящих вызовов.
В зависимости от значения этого поля будет отображён интерфейс
приложения Телефон для входящего (true) или исходящего (false) вызовов.
LocalHandle: QString [только для чтения, опционально]
Произвольная строка для идентификации локальной учетной записи.
LocalName: QString [только для чтения, опционально]
Легко читаемая строка для идентификации локальной учетной записи.
RemoteHandle: QString [только для чтения, опционально]
Произвольная строка для идентификации удаленной учетной записи.
RemoteName: QString [только для чтения, обязательно]
Легко читаемая строка для идентификации удаленной учетной записи. Служит для отображения на экране имени или номера вызываемого или вызывающего абонента.
Status: uint [только для чтения, обязательно]
Status принимает следующие значения в зависимости от статуса звонка:
- 0 — Unknown — зарезервированное значение, не используется;
- 1 — Disconnected — сообщает ОС, что звонок окончательно завершён, после чего объект звонка можно удалить;
- 2 — Dialing — сигнализирует ОС, что происходит вызов абонента, исходящий звонок;
- 3 — Ringing — сигнализирует ОС, что есть неотвеченный входящий вызов;
- 4 — Rejecting — удалённой стороне отправлено уведомление о завершении звонка, но соединение ещё не разорвано;
- 5 — Accepting — удалённой стороне отправлено уведомление о принятии входящего звонка, но передача медиа ещё не начата;
- 6 — Active — звонок активен и продолжается;
- 7 — Held — звонок на удержании.
Uri: QString [только для чтения, опционально]
URI, специфичный для реализации, идентифицирующий этот вызов.
Эта строка будет передаваться в интент OpenURI всякий раз, когда пользователь захочет
повторить этот вызов, например, щелкнув по записи в истории вызовов.
Приложение может зарегистрировать свой собственный MIME-тип и обрабатывать такие URL-адреса
с помощью записей MimeType=x-scheme-handler/..., X-Maemo-Service и X-Maemo-Method
в desktop-файле, см. соответствующую документацию.
Эта строка должна быть пустой, если необходимо скрыть вызов из истории вызовов. Она также будет рассматриваться как пустая, если длина строки превышает 255 символов.
Описание методов
Accept() [без ответа]
Вызывается операционной системой, когда пользователь принимает вызов через графический интерфейс. Этот метод может использоваться для входящих вызовов.
Reject (uint32 reason) [без ответа]
Вызывается операционной системой, когда пользователь или операционная система отклоняет вызов.
Принимаемый аргумент:
reason— причина отклонения звонка:- 0 — Unknown - зарезервировано, не используется;
- 1 — User - отклонено пользователем;
- 2 — System - отклонено операционной системой.
SetHold (bool hold) [без ответа]
Вызывается операционной системой, когда пользователь или сама операционная система переводит звонок на удержание.
Принимаемые аргументы:
hold— состояние перехода звонка на удержание.
Описание сигналов
StatusChanged(uint32 status)
Приложение должно испускать этот сигнал, чтобы уведомить ОС об изменении статуса звонка.
status— значение статуса.