В текущем разделе описаны команды управления медиа-профилями.
В ряде случаев необходимо иметь возможность ограничивать список кодеков, которые используются для установления соединения, выбирать кодеки с определенным приоритетом, а также управлять разрешением исходящего и входящего видеопотока. Эти предпочтения могут быть установлены как глобально для домена, так и индивидуально для абонента или для транка.

Настроенный медиа-профиль устанавливается на уровне алиасов, параметрами media-profile и/или media-profile-outgoing (если нужно использовать отдельный медиа-профиль для исходящей связи).

В домене по умолчанию используются установки медиа-профиля default.

Созданные медиа-профили назначаются на alias. Более подробно описано на странице /domain/<DOMAIN>/alias/ - команды управления алиасами.

copy

Команда для копирования медиа-профилей

Путь команды:

/domain/<DOMAIN>/media-profile/copy

Синтаксис:

copy <OLD_MEDIA_PROFILE_NAME> <NEW_MEDIA_PROFILE_NAME> [<NEW_DESCRIPTION>]

Параметры:

<OLD_MEDIA_PROFILE_NAME> — имя медиа-профиля, которое нужно скопировать;
<NEW_MEDIA_PROFILE_NAME-TYPE> — имя нового медиа-профиля;
[<NEW_DESCRIPTION>] — строка, описание медиа-профиля одним словом или предложением, записывается в двойных кавычках.

Пример:

admin@mycelium1@ecss1:/$ domain/biysk.local/media-profile/copy profile_k508 new_mp "Новый профиль"
Media-profile general information:

┌──────────────────┬─────────────┐
│    Parameter     │    Value    │
├──────────────────┼─────────────┤
│name              │new_mp       │
│description       │Новый профиль│
│codecs-priority   │user         │
│dtmf-receive-type │auto         │
│dtmf-transmit-type│transit      │
└──────────────────┴─────────────┘

Media type configuration:
┌──────────┬────────────┬─────┐
│Codec type│  Property  │Value│
├──────────┼────────────┼─────┤
│<other>   │offroad     │false│
│          │rtcp-enabled│true │
│audio     │offroad     │true │
└──────────┴────────────┴─────┘

Codec type: audio codecs configuration:
┌───────┬─────┬──┬──────────┬─────┐
│Enabled│Codec│PT│ Property │Value│
├───────┼─────┼──┼──────────┼─────┤
│       │G722 │9 │clock-rate│*    │
│       │PCMU │0 │          │     │
│       │PCMA │8 │          │     │
└───────┴─────┴──┴──────────┴─────┘

Codec type: <other> codecs configuration:
┌───────┬───────┬──┬────────┬─────┐
│Enabled│ Codec │PT│Property│Value│
├───────┼───────┼──┼────────┼─────┤
│       │<other>│* │        │     │
└───────┴───────┴──┴────────┴─────┘

Legend:
 Enabled  - is codec enabled. Empty means true.
 Codec    - list of codec names and special value <other>.
 PT       - Payload Type, * means any value.
 Property - name of attribute.
 Value    - value of attribute.
If attribute not specified in table it has Default value.

[exec at: 18.02.2021 11:55:18, exec time: 37ms, nodes: ds1@ecss1 v.3.14.7.589]

codecs-add

Команда для добавления одного или нескольких аудио-кодеков определенного типа в медиа-профиль.

Путь команды:

/domain/<DOMAIN>/media-profile/codecs-add

Синтаксис:

codecs-add <MEDIA_PROFILE_NAME> <CODECS-TYPE> <CODEC-NAME> <CODEC-PT> <CODECS-ATTRIBUTES>

Параметры:

<MEDIA_PROFILE_NAME> — имя медиа-профиля;
<CODECS-TYPE> — тип кодеков: audio | video | image | <other>;
<CODEC-NAME> — имя кодека из SDP. В подсказках система показывает все кодеки, которые указаны в IANA, также можно ввести своё дополнительное имя кодека, если оно нестандартное. В качестве специального имени кодека можно использовать имя <other>, которое означает любой кодек, который не перечислен;
<CODEC-PT> — Payload Type для кодека, это числовой параметр, система будет предлагать автоматически стандартное PT по имени кодека согласно IANA, но можно задать свой PT, если он нестандартный;
<CODECS-ATTRIBUTES>:
- --enabled — показывает, разрешен кодек или нет. (true | false). По умолчанию: true;
- --media-proto — транспортный протокол (строка или *). По умолчанию: *;
- --port-number — количество медиа-портов. По умолчанию: 1;
- --clock-rate — частота дискретизации. По умолчанию: *;
- --enc-parameter — количество аудио-каналов. По умолчанию: undefined.

Добавление кодеков производится в конец существующего списка кодеков, но специальный кодек <OTHER> всегда остается последним в списке.

Пример:

admin@mycelium1@ecss1:/$ domain/biysk.local/media-profile/codecs-add profile_k508 audio PCMA 8 PCMU 0 G722 9 --clock-rate * --enabled true           
Media-profile: profile_k508 adds audio codecs successfully.
Media type configuration:
┌──────────┬────────────┬─────┐
│Codec type│  Property  │Value│
├──────────┼────────────┼─────┤
│audio     │offroad     │true │
│<other>   │offroad     │false│
│          │rtcp-enabled│true │
└──────────┴────────────┴─────┘

Codec type: audio codecs configuration:
┌───────┬─────┬──┬──────────┬─────┐
│Enabled│Codec│PT│ Property │Value│
├───────┼─────┼──┼──────────┼─────┤
│       │G722 │9 │clock-rate│*    │
│       │PCMU │0 │          │     │
│       │PCMA │8 │          │     │
└───────┴─────┴──┴──────────┴─────┘

Legend:
 Enabled  - is codec enabled. Empty means true.
 Codec    - list of codec names and special value <other>.
 PT       - Payload Type, * means any value.
 Property - name of attribute.
 Value    - value of attribute.
If attribute not specified in table it has Default value.

[exec at: 18.02.2021 09:54:56, exec time: 29ms, nodes: ds1@ecss1 v.3.14.7.589]

codecs-change

Команда для изменения одного и нескольких кодеков определенного типа в медиа-профиле.

Путь команды:

/domain/<DOMAIN>/media-profile/codecs-change

Синтаксис:

codecs-change <MEDIA_PROFILE_NAME> <CODECS-TYPE> [<CODEC-ATTRIBUTES> ... ] [<CODEC-DESCRIPTION> ...]

Параметры:

<MEDIA_PROFILE_NAME> — имя медиа-профиля;
<CODECS-TYPE> — тип кодеков: audio | video | image | <other>;
<CODEC-NAME> — имя кодека из SDP. В подсказках система показывает все кодеки, которые указаны в IANA, также можно ввести своё дополнительное имя кодека, если оно нестандартное. В качестве специального имени кодека можно использовать имя <other>, которое означает любой кодек, который не перечислен;
<CODEC-PT> — Payload Type для кодека, это числовой параметр, система будет предлагать автоматически стандартное PT по имени кодека согласно IANA, но можно задать свой PT, если он нестандартный;
<CODECS-ATTRIBUTES>:
- --enabled — показывает, разрешен кодек или нет. (true | false). По умолчанию: true;
- --media-proto — транспортный протокол (строка или *). По умолчанию: *;
- --port-number — количество медиа-портов. По умолчанию: 1;
- --clock-rate — частота дискретизации. По умолчанию: *;
- --enc-parameter — количество аудио-каналов. По умолчанию: undefined.

Пример:

admin@mycelium1@ecss1:/$ domain/biysk.local/media-profile/codecs-change new_mp audio G722 9 --clock-rate 48000 --port-number 2   
Media-profile: new_mp updates audio codecs successfully.
Media type configuration:
┌──────────┬────────────┬─────┐
│Codec type│  Property  │Value│
├──────────┼────────────┼─────┤
│audio     │offroad     │true │
│<other>   │offroad     │false│
│          │rtcp-enabled│true │
└──────────┴────────────┴─────┘

Codec type: audio codecs configuration:
┌───────┬─────┬──┬───────────┬─────┐
│Enabled│Codec│PT│ Property  │Value│
├───────┼─────┼──┼───────────┼─────┤
│       │G722 │9 │port-number│2    │
│       │     │  │clock-rate │48000│
│       │PCMU │0 │           │     │
│       │PCMA │8 │           │     │
└───────┴─────┴──┴───────────┴─────┘

Legend:
 Enabled  - is codec enabled. Empty means true.
 Codec    - list of codec names and special value <other>.
 PT       - Payload Type, * means any value.
 Property - name of attribute.
 Value    - value of attribute.
If attribute not specified in table it has Default value.

[exec at: 18.02.2021 12:03:54, exec time: 27ms, nodes: ds1@ecss1 v.3.14.7.589]

codecs-get

Команда для получения списка аудио-кодеков медиа-профиля определенного типа в формате, пригодном для модификации и последующей установки в профиль.

Путь команды:

/domain/<DOMAIN>/media-profile/codecs-get

Синтаксис:

codecs-get <MEDIA_PROFILE_NAME> <CODECS-TYPE>

Параметры:

<MEDIA_PROFILE_NAME> — имя медиа-профиля;
<CODECS-TYPE> — тип кодеков: audio/video/image/<other>.

Команда возвращает список настроек аудио-кодеков в формате, пригодном для команды codecs-set.

Пример:

admin@mycelium1@ecss1:/$ domain/biysk.local/media-profile/codecs-get new_mp audio              
--offroad true G722 9 --enabled true --'port-number' 2 --'clock-rate' 48000 PCMU 0 --enabled true PCMA 8 --enabled true 

[exec at: 18.02.2021 12:05:26, exec time: 4ms, nodes: ds1@ecss1 v.3.14.7.589]

codecs-priority

Команда для изменения приоритета кодека выбранного типа в медиа-профиле.

Путь команды:

/domain/<DOMAIN>/media-profile/codecs-priority

Синтаксис:

codecs-priority <MEDIA_PROFILE_NAME> <CODECS-TYPE> <CODEC-NAME> <CODEC-PT> up|down|set <LEVEL>

Параметры:

<MEDIA_PROFILE_NAME> — имя медиа-профиля.
<CODECS-TYPE> — тип кодеков: audio/video/image/<other>.
<CODEC-NAME> — имя кодека из SDP. В подсказках система показывает все кодеки, которые указаны в IANA, также можно ввести своё дополнительное имя кодека, если оно нестандартное. В качестве специального имени кодека можно использовать имя <other>, которое означает любой кодек, который не перечислен;
<CODEC-PT> — Payload Type для кодека, это числовой параметр, система будет предлагать автоматически стандартное PT по имени кодека согласно IANA, но можно задать свой PT, если он нестандартный;
<LEVEL> — целое число больше 0, указывающее позицию кодека в списке согласно приоритету кодека.

Примеры:

admin@mycelium1@ecss1:/$ domain/biysk.local/media-profile/codecs-priority profile_k508 audio G722 9 set 1
Media-profile: profile_k508 priority changed for audio codecs successfully.
Media type configuration:
┌──────────┬────────────┬─────┐
│Codec type│  Property  │Value│
├──────────┼────────────┼─────┤
│audio     │offroad     │true │
│<other>   │offroad     │false│
│          │rtcp-enabled│true │
└──────────┴────────────┴─────┘

Codec type: audio codecs configuration:
┌───────┬─────┬──┬──────────┬─────┐
│Enabled│Codec│PT│ Property │Value│
├───────┼─────┼──┼──────────┼─────┤
│       │G722 │9 │clock-rate│*    │
│       │PCMU │0 │          │     │
│       │PCMA │8 │          │     │
└───────┴─────┴──┴──────────┴─────┘

Legend:
 Enabled  - is codec enabled. Empty means true.
 Codec    - list of codec names and special value <other>.
 PT       - Payload Type, * means any value.
 Property - name of attribute.
 Value    - value of attribute.
If attribute not specified in table it has Default value.

[exec at: 18.02.2021 12:06:45, exec time: 27ms, nodes: ds1@ecss1 v.3.14.7.589]

admin@mycelium1@ecss1:/$ domain/biysk.local/media-profile/codecs-priority profile_k508 audio G722 9 down 2
Media-profile: profile_k508 priority changed for audio codecs successfully.
Media type configuration:
┌──────────┬────────────┬─────┐
│Codec type│  Property  │Value│
├──────────┼────────────┼─────┤
│audio     │offroad     │true │
│<other>   │offroad     │false│
│          │rtcp-enabled│true │
└──────────┴────────────┴─────┘

Codec type: audio codecs configuration:
┌───────┬─────┬──┬──────────┬─────┐
│Enabled│Codec│PT│ Property │Value│
├───────┼─────┼──┼──────────┼─────┤
│       │PCMU │0 │          │     │
│       │G722 │9 │clock-rate│*    │
│       │PCMA │8 │          │     │
└───────┴─────┴──┴──────────┴─────┘

Legend:
 Enabled  - is codec enabled. Empty means true.
 Codec    - list of codec names and special value <other>.
 PT       - Payload Type, * means any value.
 Property - name of attribute.
 Value    - value of attribute.
If attribute not specified in table it has Default value.

[exec at: 18.02.2021 12:07:21, exec time: 25ms, nodes: ds1@ecss1 v.3.14.7.589]

codecs-remove

Команда удаления одного или нескольких кодеков определенного типа из медиа-профиля.

Путь команды:

/domain/<DOMAIN>/media-profile/codecs-remove

Синтаксис:

codecs-remove <MEDIA_PROFILE_NAME> <CODECS-TYPE> <CODEC-NAME> <CODEC-PT>

Параметры:

<MEDIA_PROFILE_NAME> — имя медиа-профиля;
<CODECS-TYPE> — тип кодеков: audio/video/image/<other>;
<CODEC-NAME> — имя кодека из SDP. В подсказках система показывает все кодеки, которые указаны в IANA, также можно ввести своё дополнительное имя кодека, если оно нестандартное. В качестве специального имени кодека можно использовать имя <other>, которое означает любой кодек, который не перечислен;
<CODEC-PT> — Payload Type для кодека, это числовой параметр, система будет предлагать автоматически стандартное PT по имени кодека согласно IANA, но можно задать свой PT, если он нестандартный.

Пример:

admin@mycelium1@ecss1:/$ domain/biysk.local/media-profile/codecs-remove new_mp video H263-1998 *          
Media-profile: new_mp removes video codecs successfully.
Media type configuration:
┌──────────┬────────────┬─────┐
│Codec type│  Property  │Value│
├──────────┼────────────┼─────┤
│audio     │offroad     │true │
│video     │offroad     │true │
│<other>   │offroad     │false│
│          │rtcp-enabled│true │
└──────────┴────────────┴─────┘

Codec type: video codecs configuration:
┌───────┬────────┬──┬────────┬─────┐
│Enabled│ Codec  │PT│Property│Value│
├───────┼────────┼──┼────────┼─────┤
│       │H264-AVC│* │        │     │
└───────┴────────┴──┴────────┴─────┘

Legend:
 Enabled  - is codec enabled. Empty means true.
 Codec    - list of codec names and special value <other>.
 PT       - Payload Type, * means any value.
 Property - name of attribute.
 Value    - value of attribute.
If attribute not specified in table it has Default value.

[exec at: 18.02.2021 12:09:51, exec time: 27ms, nodes: ds1@ecss1 v.3.14.7.589]

codecs-set

Команда установки набора кодеков определенного типа, заменяющая все ранее добавленные.

Путь команды:

/domain/<DOMAIN>/media-profile/codecs-set

Синтаксис:

codecs-set <name> <codecs-type> [<media-attributes> ... ] <codec-description> [<codec-description> ...]

Параметры:

<name> — имя медиа-профиля, должно быть уникальное в домене;
<codecs-type> — тип кодеков: [audio | video | image | <other>];
<codec-description> — описание параметров кодека:
- <codec-name> <codec-pt> [<codec-attributes>] — для аудио, видео, <other> типов кодеков;
- <codec-name> [<codec-attributes>] — для типа image;
  - <codec-name> — имя кодека из SDP. В подсказках система показывает все доступные кодеки, также можно ввести своё дополнительное имя кодека, если оно нестандартное. В качестве специального имени кодека можно использовать имя <other>, которое означает любой кодек;
  - <codec-pt> — Payload Type для кодека, это числовой параметр, система будет предлагать автоматически стандартное PT по имени кодека согласно IANA, но можно задать свой PT, если он нестандартный;
  - <codec-attributes> — расширенные настройки кодека: <attribute-key> <attribute-value>:
    - --enabled — включен или выключен. Возможные значения: true | false. По умолчанию true;
    - --media-proto — транспортный протокол media, по умолчанию *. Возможные значения:
      - udp — означает, что данные передаются непосредственно в UDP без дополнительного кадрирования;
      - RTP/AVP — [RFC 3550]/[RFC 3551], работает через UDP;
      - RTP/SAVP — [RFC 3711], работает через UDP;
      - RTP/SAVPF — SRTP по [RFC 5124], работает через UDP;
    - --port-number — количество портов для медиа (количество RTP-сессий). По умолчанию 1 (только для audio, video или <other>);
    - --clock-rate — частота, по умолчанию *;
    - --enc-parameter — количество аудио-каналов. Возможные значения: целое число или *. Значение по умолчанию: undefined. Для атрибутов кодека подстановочный знак * означает любое неуказанное значение.

В этой команде список кодеков должен быть исчерпывающим. В дальнейшем добавлять или удалять кодеки возможно командами codecs-add/codecs-remove соответственно.

Пример:

admin@ds1@ecss1:/$ domain/biysk.local/media-profile/codecs-set test_mp audio G722 * --enabled true --media-proto RTP/AVP PCMA 8 --enabled true PCMU 0 --enabled true telephone-event *
Media-profile: test_mp set audio codecs successfully.
Media type configuration:
┌──────────┬────────────┬─────┐
│Codec type│  Property  │Value│
├──────────┼────────────┼─────┤
│audio     │offroad     │true │
│<other>   │offroad     │false│
│          │rtcp-enabled│true │
└──────────┴────────────┴─────┘

Codec type: audio codecs configuration:
┌───────┬───────────────┬──┬───────────┬───────┐
│Enabled│     Codec     │PT│ Property  │ Value │
├───────┼───────────────┼──┼───────────┼───────┤
│       │telephone-event│* │           │       │
│       │PCMU           │0 │           │       │
│       │PCMA           │8 │           │       │
│       │G722           │* │media-proto│RTP/AVP│
└───────┴───────────────┴──┴───────────┴───────┘

Legend:
 Enabled  - is codec enabled. Empty means true.
 Codec    - list of codec names and special value <other>.
 PT       - Payload Type, * means any value.
 Property - name of attribute.
 Value    - value of attribute.
If attribute not specified in table it has Default value.

[exec at: 14.10.2022 07:41:37, exec time: 28ms, nodes: ds1@ecss1 v.3.14.12.492]

declare

Команда предназначена для создания нового медиа-профиля.

Путь команды:

/domain/<DOMAIN>/media-profile/declare

Синтаксис:

declare <MEDIA_PROFILE_NAME> <DESCRIPTION> <PRIORITY>

Параметры:

<MEDIA_PROFILE_NAME> — имя медиа-профиля;
<DESCRIPTION> — строка, описание медиа-профиля одним словом или предложением, записывается в двойных кавычках;
<PRIORITY> — user|system, определяет предпочтения по кодекам, в варианте user порядок кодеков заданный пользователем в offer SDP сохраняется, а в варианте system порядок кодеков в SDP перестраивается согласно системных предпочтений (в каком порядке заданы кодеки в профиле);

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

Пример:

admin@mycelium1@ecss1:/$ domain/biysk.local/media-profile/declare profile_k508 "for tester k.508" user
Media-profile: profile_k508 declared successfully.

Media-profile detailed information:

┌───────────────┬────────────────┐
│   Parameter   │     Value      │
├───────────────┼────────────────┤
│name           │profile_k508    │
│description    │for tester k.508│
│codecs-priority│user            │
└───────────────┴────────────────┘

Media type configuration:
┌──────────┬────────────┬─────┐
│Codec type│  Property  │Value│
├──────────┼────────────┼─────┤
│<other>   │offroad     │false│
│          │rtcp-enabled│true │
└──────────┴────────────┴─────┘

Codec type: <other> codecs configuration:
┌───────┬───────┬──┬────────┬─────┐
│Enabled│ Codec │PT│Property│Value│
├───────┼───────┼──┼────────┼─────┤
│       │<other>│* │        │     │
└───────┴───────┴──┴────────┴─────┘

Legend:
 Enabled  - is codec enabled. Empty means true.
 Codec    - list of codec names and special value <other>.
 PT       - Payload Type, * means any value.
 Property - name of attribute.
 Value    - value of attribute.
If attribute not specified in table it has Default value.

[exec at: 18.02.2021 09:28:07, exec time: 26ms, nodes: ds1@ecss1 v.3.14.7.589]

info

Команда для просмотра параметров конкретного медиа-профиля.

Путь команды:

/domain/<DOMAIN>/media-profile/info

Синтаксис:

info <MEDIA_PROFILE_NAME>

Параметры:

<MEDIA_PROFILE_NAME> — имя медиа-профиля;

Результатом выполнения команды будет полная информация о указанном медиа-профиле.

Пример:

admin@mycelium1@ecss1:/$ domain/biysk.local/media-profile/set with_video send-video-resolution HD(1280x720) 
Media-profile: with_video set send-video-resolution successfully.

Media-profile detailed information:

┌─────────────────────┬─────────────────────────────────────────┐
│      Parameter      │                  Value                  │
├─────────────────────┼─────────────────────────────────────────┤
│name                 │with_video                               │
│description          │Default media profile for current domain.│
│codecs-priority      │user                                     │
│dtmf-receive-type    │auto                                     │
│dtmf-transmit-type   │transit                                  │
│recv-video-resolution│HD(1280x720)                             │
│send-video-resolution│HD(1280x720)                             │
└─────────────────────┴─────────────────────────────────────────┘

Media type configuration:
┌──────────┬────────────┬───────┐
│Codec type│  Property  │ Value │
├──────────┼────────────┼───────┤
│<other>   │offroad     │false  │
│          │rtcp-enabled│true   │
│audio     │media-proto │<<"*">>│
│          │offroad     │true   │
│image     │offroad     │true   │
│video     │offroad     │true   │
└──────────┴────────────┴───────┘

Codec type: audio codecs configuration:
┌───────┬───────────────┬──┬───────────┬─────┐
│Enabled│     Codec     │PT│ Property  │Value│
├───────┼───────────────┼──┼───────────┼─────┤
│       │G722           │* │media-proto│*    │
│       │G729           │* │media-proto│*    │
│       │PCMU           │* │media-proto│*    │
│       │PCMA           │* │media-proto│*    │
│       │telephone-event│* │media-proto│*    │
└───────┴───────────────┴──┴───────────┴─────┘

Codec type: video codecs configuration:
┌───────┬─────────┬───────────┬─────┐
│Enabled│  Codec  │ Property  │Value│
├───────┼─────────┼───────────┼─────┤
│       │H263-1998│media-proto│*    │
│       │H264     │media-proto│*    │
└───────┴─────────┴───────────┴─────┘

Codec type: image codecs configuration:
┌───────┬───────┬───────────┬─────┐
│Enabled│ Codec │ Property  │Value│
├───────┼───────┼───────────┼─────┤
│       │<other>│media-proto│*    │
└───────┴───────┴───────────┴─────┘

Codec type: <other> codecs configuration:
┌───────┬───────┬──┬────────┬─────┐
│Enabled│ Codec │PT│Property│Value│
├───────┼───────┼──┼────────┼─────┤
│       │<other>│* │        │     │
└───────┴───────┴──┴────────┴─────┘

Legend:
 Enabled  - is codec enabled. Empty means true.
 Codec    - list of codec names and special value <other>.
 PT       - Payload Type, * means any value.
 Property - name of attribute.
 Value    - value of attribute.
If attribute not specified in table it has Default value.

[exec at: 16.03.2023 21:17:21, exec time: 8ms, nodes: ds1@ecss1 v.3.14.14.5]

list

Команда для просмотра списка медиа-профилей, сконфигурированных в домене.

Путь команды:

/domain/<DOMAIN>/media-profile/list

Синтаксис:

list <MEDIA_PROFILE_NAME>

Параметры:

<MEDIA_PROFILE_NAME> — имя медиа-профиля.

Пример:

admin@mycelium1@ecss1:/$ domain/biysk.local/media-profile/list
List of media-profiles:
┌─────────────┬─────────────────────────────────────────┐
│    Name     │               Description               │
├─────────────┼─────────────────────────────────────────┤
│default      │Default media profile for current domain.│
│profile_k508 │for tester k.508                         │
│remote_users │Для абонентов MSAN                       │
│video_support│С поддержкой видео                       │
└─────────────┴─────────────────────────────────────────┘

[exec at: 18.02.2021 09:39:08, exec time: 20ms, nodes: ds1@ecss1 v.3.14.7.589]

remove

Команда для удаления медиа-профиля.

Путь команды:

/domain/<DOMAIN>/media-profile/remove

Синтаксис:

remove <MEDIA_PROFILE_NAME>

Параметры:

<MEDIA_PROFILE_NAME> — имя медиа-профиля.

Команда должна выполнить проверку использования этого профиля в каких-либо сущностях системы (установлен для домена/абонента/транка). При положительном ответе запрашивает подтверждение об удалении (можно показать список сущностей, где используется профиль).
Если подтверждение об удалении было получено, то происходит удаление профиля и подчистка информации о медиа-профиле у всех сущностей, которые его использовали (для домена профиль устанавливается в default).
Профиль default удалить нельзя.

Пример:

admin@mycelium1@ecss1:/$ domain/biysk.local/media-profile/remove profile_k508
Media profile: profile_k508 removed successfully.

[exec at: 18.02.2021 12:33:29, exec time: 22ms, nodes: ds1@ecss1 v.3.14.7.589]

set

Команда для изменения общих параметров медиа-профиля.

Путь команды:

/domain/<DOMAIN>/media-profile/set

Синтаксис:

remove <MEDIA_PROFILE_NAME> <PARAM> <VALUE>

Параметры:

<MEDIA_PROFILE_NAME> — имя медиа-профиля.
<PARAM> — имя параметра для изменения, может быть address-type, description, codec-priority, offroad, address-type, fax-detector-type, rtcp-enabled, dtmf-receive-type, dtmf-transmit-type, recv-video-resolution, send-video-resolution
<VALUE> — значение для выбранного параметра.

address-type = IPv4 | IPv6 — тип адреса;
description — описание профиля;
codec-priority = user|system — определяет предпочтения по кодекам, в варианте user порядок кодеков заданный пользователем в offer SDP сохраняется, а в варианте system порядок кодеков в SDP перестраивается согласно системным предпочтениям (в каком порядке заданы кодеки в профиле);
offroad = для <other> | audio | image | video — значение true/false;
fax-detector-type = ctyp | ftmd none — метод детектора факса;
rtcp-enabled = для <other> | audio | image | video — значение true/false;
dtmf-receive-type = auto :: signalling | none | auto | rfc2833 | inband — метод детекции DTMF:
- none — не принимать DTMF с данного интерфейса;
- auto — автоматически детектировать источник DTMF по первому полученному сообщению;
- signalling — детектировать DTMF на основе SIP Info;
- rfc2833 — детектировать DTMF из RTP по rfc2833;
- inband — детектировать DTMF из RTP по INBAND.
dtmf-transmit_type = transit :: signalling | none | transit | rfc2833 | inband — метод передачи DTMF:
- none — не передавать DTMF на данный интерфейс;
- transit — передавать DTMF в том формате, в котором он был получен;
- signalling — передавать DTMF в SIP Info;
- rfc2833 — передавать DTMF через RTP по rfc2833;
- inband — передавать DTMF через RTP по INBAND.
recv-video-resolution — входящее разрешение видеопотока. По умолчанию: undefined;
send-video-resolution — исходящее разрешение видеопотока. По умолчанию: undefined;

Список c предопределенными форматами исходящего и входящего разрешения видеопотока всплывает в подсказке:

2CIF(704x240) 4CIF(704x576) CIF(352x288) DVGA(960x640)

FWVGA(854x480) HD(1280x720) HQVGA(240x160) HQVGA(256x160)

HVGA(480x270) HVGA(480x320) HVGA(480x360) HVGA(640x240)

MPEG1(352x288) NTSC(352x240) PAL(352x288) QCIF(176x144)

QHD(960x540) QQVGA(160x120) QVGA(320x240) SQCIF(128x96)

SVGA(800x600) VGA(640x480) WQVGA(360x240) WQVGA(376x240)

WQVGA(384x240) WQVGA(400x240) WQVGA(428x240) WQVGA(432x240)

WQVGA(480x272) WVGA(640x360) WVGA(640x384) WVGA(720x480)2

WVGA(768x480) WVGA(800x450) WVGA(800x480) WVGA(848x480)

WVGA(852x480) WVGA(853x480) WVGA(854x480) WXVGA(1200x600)

XGA(1024x768) XGA(1152x864) undefined

Для того чтобы очистить параметр, выберите undefined.

Пример:

admin@mycelium1@ecss1:/$ domain/biysk.local/media-profile/set profile_k508 recv-video-resolution HD(1280x720)     
Media-profile: profile_k508 set recv-video-resolution successfully.

Media-profile detailed information:

┌─────────────────────┬──────────── ┐
│      Parameter      │   Value     │
├─────────────────────┼──────────── ┤
│name                 │profile_k508 │
│description          │Новый профиль│
│codecs-priority      │user         │
│addr-type            │IP4          │
│dtmf-receive-type    │auto         │
│dtmf-transmit-type   │transit      │
│recv-video-resolution│HD(1280x720) │
└─────────────────────┴──────────── ┘

Media type configuration:
┌──────────┬────────────┬─────┐
│Codec type│  Property  │Value│
├──────────┼────────────┼─────┤
│<other>   │offroad     │false│
│          │rtcp-enabled│true │
│audio     │offroad     │true │
└──────────┴────────────┴─────┘

Codec type: audio codecs configuration:
┌───────┬─────┬──┬──────────┬─────┐
│Enabled│Codec│PT│ Property │Value│
├───────┼─────┼──┼──────────┼─────┤
│       │PCMA │8 │          │     │
│       │G722 │9 │clock-rate│*    │
│       │PCMU │0 │          │     │
└───────┴─────┴──┴──────────┴─────┘

Codec type: <other> codecs configuration:
┌───────┬───────┬──┬────────┬─────┐
│Enabled│ Codec │PT│Property│Value│
├───────┼───────┼──┼────────┼─────┤
│       │<other>│* │        │     │
└───────┴───────┴──┴────────┴─────┘


Legend:
 Enabled  - is codec enabled. Empty means true.
 Codec    - list of codec names and special value <other>.
 PT       - Payload Type, * means any value.
 Property - name of attribute.
 Value    - value of attribute.
If attribute not specified in table it has Default value.

[exec at: 24.11.2022 16:35:19, exec time: 41ms, nodes: ds1@ecss1 v.3.14.12.592]