Выполняет подключение обработчика звонков. Обработчик вызывается со следующими параметрами: НомерТелефона - тип Строка. Номер телефона, с которого приходит вызов или на который отправляется вызов. Дата - тип Дата. Время возникновения события. ВариантСобытия - тип ВариантСобытияЗвонкаСредствТелефонии. Одно из значений перечисления. ТипЗвонка - тип ТипЗвонкаЖурналаЗвонков: входящий, исходящий или пропущенный (если вызов был завершен при входящем звонке). Дополнительный параметр (если используется ОписаниеОповещения). Данный метод поддерживается не на всех устройствах. Для проверки совместимости устройства перед вызовом данного метода следует использовать метод ПоддерживаетсяОбработкаЗвонков.
Синтаксис
ПодключитьОбработчикЗвонков(<ИмяПроцедуры>)Полное описание, параметры и ограничения
СредстваТелефонии.ПодключитьОбработчикЗвонков (TelephonyTools.AttachCallsHandler)
СредстваТелефонии (TelephonyTools)
ПодключитьОбработчикЗвонков (AttachCallsHandler)
Доступен, начиная с версии 8.3.9.
Синтаксис:
ПодключитьОбработчикЗвонков(<ИмяПроцедуры>)
Параметры:
<ИмяПроцедуры> (обязательный)
Тип: Строка, ОписаниеОповещения.
Имя процедуры, подключаемой в качестве обработчика.
Описание:
Выполняет подключение обработчика звонков.
Обработчик вызывается со следующими параметрами:
НомерТелефона - тип Строка. Номер телефона, с которого приходит вызов или на который отправляется вызов.
Дата - тип Дата. Время возникновения события.
ВариантСобытия - тип ВариантСобытияЗвонкаСредствТелефонии. Одно из значений перечисления.
ТипЗвонка - тип ТипЗвонкаЖурналаЗвонков: входящий, исходящий или пропущенный (если вызов был завершен при входящем звонке).
Дополнительный параметр (если используется ОписаниеОповещения).
Данный метод поддерживается не на всех устройствах. Для проверки совместимости устройства перед вызовом данного метода следует использовать метод ПоддерживаетсяОбработкаЗвонков.
Доступность:
Мобильный клиент, мобильное приложение (клиент).
См. также:
ВариантСобытияЗвонкаСредствТелефонии
СредстваТелефонии, метод ПоддерживаетсяОбработкаЗвонков
Использование в версии:
Доступен, начиная с версии 8.3.9.
Методическая информация
Практические примеры
События звонков без вывода номера телефона
Подключаем обработчик звонков, показываем событие и тип звонка, затем отключаем наблюдение.
Где и как запускать
Модуль управляемой формы: &НаКлиенте; мобильный клиент или мобильное приложение (клиент).
Подготовка
Поместите весь блок в модуль своей мобильной формы; кнопки вызывают ПодключитьЗвонки и ОтключитьЗвонки.
Для ручного опыта нужен собственный Android с телефонным модулем и необходимыми разрешениями; подключайте один раз до отключения.
&НаКлиенте
Процедура ПодключитьЗвонки()
Если СредстваТелефонии.ПоддерживаетсяОбработкаЗвонков() Тогда
Описание = Новый ОписаниеОповещения("ПриЗвонке", ЭтотОбъект, "Учебный звонок");
СредстваТелефонии.ПодключитьОбработчикЗвонков(Описание);
КонецЕсли;
КонецПроцедуры
&НаКлиенте
Процедура ПриЗвонке(НомерТелефона, Дата, ВариантСобытия, ТипЗвонка, ДополнительныеПараметры) Экспорт
Сообщить(ДополнительныеПараметры + "; " + Строка(Дата)
+ "; " + Строка(ВариантСобытия) + "; " + Строка(ТипЗвонка));
Сообщить("Номер передан: " + Строка(СтрДлина(НомерТелефона) > 0));
КонецПроцедуры
&НаКлиенте
Процедура ОтключитьЗвонки()
СредстваТелефонии.ОтключитьОбработчикЗвонков();
КонецПроцедурыРазбор по шагам
Кнопка проверяет поддержку обработки звонков.
При своем учебном звонке платформа вызывает экспортную процедуру с пятью параметрами.
Кнопка отключения прекращает наблюдение.
Как проверить результат
Сопоставьте время и вариант события со своим учебным звонком.
Убедитесь, что код не выводит сам номер телефона.
Ожидаемый результат
Наблюдаемые системные события звонков; номер используется только для проверки наличия.
На что обратить внимание
Обработчик не создает звонков. Название типа звонка в отдельных страницах справки отличается; здесь значение только преобразуется в строку. Не вызывайте обработчик вручную и не обещайте мгновенную доставку событий.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.