Описание

Услуга "Отображение изображения вызывающего абонента (cpip)" ("Calling Picture Identification Presentation") позволяет выбрать формат отображения изображения на телефонном аппарате. Услуга устанавливается на стороне вызываемого абонента.

Для передачи изображения вызывающего абонента в INVITE добавляется заголовок Call-Info:

Call-Info: <URL>;purpose=icon 

где URL - адрес для получения изображения. Источник - адресная книга.

Доступ к изображению осуществляется через restfs.


В заголовке Call-Info будет указан URL-адрес restfs с аргументом caller_id - вызывающий номер:


Call-Info: <http://system.restfs.ecss:9990?caller_id=...>;purpose=icon
 
Если активирована только услуга CPIP, то изображение будет получено из адресной книги по вызывающему номеру. Подробнее - см. разделы "Удаленная адресная книга", "Генерация изображений (Picture)". Если активированы еще подобные услуги по генерации изображений, то приоритет услуг (по возрастанию): cpip << avatar << distinctive-picture.

Существует два вида отображения:

  • icon — изображения отображается в фактическом разрешении;
  • fullscreen — изображения растягивается на весь экран. При этом в заголовке Call-Info параметр purpose будет wallpaper:

    Call-Info: <URL>;purpose=wallpaper 

Использование

Абонент хочет видеть на экране телефонного аппарата изображение вызывающего абонента.
Для этого нужно активировать ему услугу "Отображение изображения вызывающего абонента (cpip)" по примеру настройки.

Управление услугой с телефонного аппарата

Активация
только через оператора
Деактивация
только через оператора
Использование услуги
только через оператора

Настройка параметров услуги через интерфейс командной строки

Для активации услуги "cpip" через интерфейс командной строки выполните следующую команду:

  • для администратора системы:

    Установите разрешение на использование услуги:

    /cluster/storage/<CLUSTER>/ss/enable <DOMAIN> <ADDRESS> cpip

    Активируйте услугу:

    /cluster/storage/<CLUSTER>/ss/activate <DOMAIN> <ADDRESS> cpip display_mode = <MODE>

  • для оператора виртуальной АТС:

    Установите разрешение на использование услуги:

    /domain/<DOMAIN>/ss/find_me/enable <DOMAIN> <ADDRESS> cpip

    Активируйте услугу:

    /domain/<DOMAIN>/ss/activate <ADDRESS> cpip display_mode = <MODE>

где

  • <CLUSTER> — имя кластера хранения долговременных данных (DS);
  • <DOMAIN> — имя виртуальной АТС, которой принадлежит абонент(ы);
  • <ADDRESS> — номер(а) абонентов, для которых выполняется настройка услуги, символ "*" используется для указания всех абонентов заданной виртуальной АТС;
  • <MODE>  (icon/fullscreen) — режим отображения изображения.

Диапазоны номеров указываются в фигурных скобках. Например: 71{1-2,9} соответствует номерам 711, 712, 719.

Описание команд для управления услугами через интерфейс командной строки CLI приведено в Справочнике команд CLI, разделы /cluster/storage/<STORAGE>/ss и /domain/<DOMAIN>/ss.

Пример настройки

Активировать услугу"Отображение изображения вызывающего абонента (cpip)" для абонента с номером 240101 виртуальной АТС "biysk.local" отображением иконки.

Активация услуги через интерфейс командной строки:

admin@ds1@ecss1:/$ domain/biysk.local/ss/enable 240101 cpip 
1 users divided into 1 parts
[**********************************************************************] 104mks   

Success: Supplementary service cpip enabled for domain "biysk.local", address "240101"

Read properties from enabled supplementary services
[**********************************************************************] 143mks   


[exec at: 19.04.2022 22:32:29, exec time: 40ms, nodes: ds1@ecss1 v.3.14.11.265]

admin@ds1@ecss1:/$ 
admin@ds1@ecss1:/$ domain/biysk.local/ss/activate 240101 cpip display_mode = icon
1 users divided into 1 parts
[**********************************************************************] 104mks   

Success: Supplementary service cpip activated for domain "biysk.local" address "240101"

[exec at: 19.04.2022 22:32:54, exec time: 26ms, nodes: ds1@ecss1 v.3.14.11.265]

Описание команд для управления услугами через интерфейс командной строки CLI приведено в Справочнике команд CLI, разделы /cluster/storage/<STORAGE>/ss и /domain/<DOMAIN>/ss.

Настройка параметров услуги через web-конфигуратор

Настройки выполняются в разделе "Supplementary services" ("Дополнительные услуги") приложения "Subscriber card" ("Карточка абонента").

Настройка услуги для всех абонентов определенной виртуальной АТС, а также для определенного абонента в отдельности выполняется в приложении "Subscriber card" ("Карточка абонента").

Для активации услуги установите флаг напротив значения "Отображение изображения вызывающего абонента (cpip)".

Для деактивации услуги — снимите флаг.

Для сохранения настроек нажмите кнопку "Save" ("Сохранить").

Пример настройки

Активация услуги через web-конфигуратор:

  1. Выберите номер телефона абонента — 240101;
  2. Разрешите использовать услугу абоненту — установите . Установите флаг напротив услуги "Отображение изображения вызывающего абонента (cpip)".
  3. Установите режим отображения - icon или fullscreen;
  4. Для сохранения настроек нажмите кнопку "Save" ("Сохранить").



Поддерживаемые модели телефонов Yealink

Данную услугу поддерживают следующие модели телефонов: VP59, T58A с камерой, SIP-T58A, SIP-T57W, SIP-T54W, SIP-T48S, SIP-T46S, SIP-VP-T49G, SIP-T48G, SIP-T46G.

Поддерживаемые разрешения вывода изображения:

  1. T29G — 100*100 px;
  2. T46G — 100*100 px;
  3. T48G — 108*108 px;
  4. T49G — 108*108 px.

Особенности отображения:

  • размер: без ограничений;
  • поддерживаемые форматы: jpg, bmp, png;
  • разрешение: без ограничений;
  • разрешение вывода: ~100x100.

Для отображения изображения на экране требуется настроить данный параметр

account.<номер аккаунта>.picture_info_enable=1

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

Поддерживаемые модели телефонов Grandstream

Данную услугу поддерживают следующие модели телефонов: GXP2130, GXP2135, GXP2140, GXP2160 и GXP2170.

Услуга доступна начиная с версии 1.0.8.46

Поддерживаемые модели телефонов Snom

Данную услугу поддерживают следующие модели телефонов: snom 821, snom 870, snom m9, snom D375, snom 760, snomD 765, snom 820.

Особенности отображения:

  • Размер до 500 кб, если размер будет превышать 20% от свободной памяти, то оно не будет загружаться;
  • Макс. разрешение: 640х480;
  • Глубина цвета: 32;
  • Форматы: jpeg, gif, png.

Поддерживаемые модели телефонов Htek

Данную услугу поддерживают следующие модели телефонов: UC926E, UC926, UC924E, UC924, UC862, UC860P, UC842, UC840P.

Особенности отображения:

  • услуга поддерживается начиная с версии прошивки 2.0.4.4.46,
  • поддерживаются форматы jpeg, png;
  • размер до 10 кб;
  • разрешение вывода: 80х80.