Услуга "Аватар абонента (avatar)" ("Picture for outgoing calls (avatar)") позволяет заменить изображение, передаваемое вызываемым абонентам.

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

Call-Info: <URL>;purpose=icon 

либо

Call-Info: icon="URL" 

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

Пример INVITE сообщения с заголовком Call-Info:

INVITE sip:803@10.25.88.63:5260;transport=UDP SIP/2.0
v: SIP/2.0/UDP 10.25.88.28:5060;branch=z9hG4bK-o-1548917061633031-040560-101
f: <sip:801@10.25.88.28;user=phone>;tag=ecssO1548917061633040040560
t: <sip:803@10.25.88.63;user=phone>
i: BA:7edbdc68d51a6fd8:7edbdc6ce8925c4a
CSeq: 1 INVITE
User-Agent: Eltex ECSS-10 SIP 3.14.0.87
Max-Forwards: 69
m: <sip:801@10.25.88.28:5060;line=89d088c8080cc588>
Accept: multipart/mixed, application/sdp
Allow: INVITE, ACK, BYE, CANCEL, PRACK, REGISTER, INFO, REFER, NOTIFY, OPTIONS, SUBSCRIBE, MESSAGE, UPDATE, PUBLISH
u: presence, dialog, conference
Call-Info: <http://system.restfs.ecss:9990/proxy/sites.psu.edu/siowfa16/files/2016/10/YeDYzSR-10apkm4-300x295.png?https=true>;purpose=icon
Category: 10
x: 1800;refresher=uac
Min-SE: 300
k: 100rel, timer, replaces
P-Eltex-Info: d.local 803@10.25.88.28/- 2437449096 sip1@igorbulanov <0.4056.0>/1 outgoing
c: application/sdp
l: 577

v=0
o=- 3757905861 3757905861 IN IP4 127.0.0.1
s=pjmedia
b=AS:3166
t=0 0
m=audio 12418 RTP/AVP 8 0 9 96
c=IN IP4 127.0.0.1
a=rtpmap:8 PCMA/8000/1
a=rtpmap:0 PCMU/8000/1
a=rtpmap:9 G722/8000/1
a=rtpmap:96 telephone-event/8000
a=fmtp:96 0-16
a=rtcp:12419 IN IP4 127.0.0.1
a=sendrecv
m=video 12420 RTP/AVP 97 96
c=IN IP4 127.0.0.1
b=TIAS:3000000
a=rtpmap:97 H264/90000
a=fmtp:97 packetization-mode=0;profile-level-id=42e01E
a=rtpmap:96 H263-1998/90000
a=fmtp:96 CIF=1;QCIF=1
a=rtcp:12421 IN IP4 127.0.0.1
a=sendrecv
a=imageattr:* recv [x=640,y=480,q=0.50]

Запрос к требуемому URL проксируется через RestFS.

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

Абонент хочет установить в качестве аватара изображение из Интернета.

При звонке на других абонентов у них будет отображаться установленная картинка.

Для этого нужно активировать ему услугу "Аватар абонента (avatar)" по примеру настройки.

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

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

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

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

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

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

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

  /cluster/storage/<CLUSTER>/ss/activate <DOMAIN> <ADDRESS> avatar pic_addr = <URL>


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

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

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

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

  /domain/<DOMAIN>/ss/activate <ADDRESS> avatar pic_addr = <URL>


где

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

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

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

Активировать услугу "Аватар абонента (avatar)" для абонента с номером 240101 виртуальной АТС "biysk.local".

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

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

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

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


[exec at: 19.04.2022 07:48:10, exec time: 40ms, nodes: ds1@ecss1 v.3.14.11.265]

admin@ds1@ecss1:/$ domain/biysk.local/ss/activate  240101 avatar pic_addr = http://sites.psu.edu/siowfa16/files/2016/10/YeDYzSR-10apkm4-300x295.png 
1 users divided into 1 parts
[**********************************************************************] 300mks   

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

[exec at: 19.04.2022 07:49:31, exec time: 29ms, nodes: ds1@ecss1 v.3.14.11.265]

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

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

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

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

Для активации услуги установите флаг напротив значения "Аватар абонента (avatar)".

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

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

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

1. Выберите номер телефона абонента — 240101;
2. Разрешите использовать услугу абоненту — установите . Установите флаг напротив услуги "Аватар абонента (avatar)".
3. Введите "Адрес (URL) картинки" ("Picture address").
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.