/mgc/media-profile/ - команды управления медиа-профилями медиа шлюзов.

В текущем разделе описаны команды управления медиа-профилями медиа шлюзов. Они необходимы для корректного формирования SDP (ограничение кодеков и т.п.).

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

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

codecs-add

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

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

/mgc/media-profile/codecs-add

Синтаксис:

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

Параметры:

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

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

Пример:

/mgc/media-profile/codecs-add new_media_profile audio G729 18 true
Media-profile: new_media_profile adds audio codecs successfully.

Codec type: audio codecs configuration:
┌───────┬─────┬──┐
│Enabled│Codec│PT│
├───────┼─────┼──┤
│       │PCMA │8 │
│       │G729 │18│
└───────┴─────┴──┘

Legend:
 Enabled - is codec enabled. Empty means true.
 Codec   - list of codec names and special value <other>.
 PT      - Paylad Type, * means any value.

codecs-get

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

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

/mgc/media-profile/codecs-get

Синтаксис:

codecs-get <MEDIA_PROFILE_NAME> <CODECS-TYPE>

Параметры:

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

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

Пример:

/mgc/media-profile/codecs-get new_media_profile audio

PCMA 8 true G729 18 false

codecs-priority

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

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

/mgc/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, указывающее позицию кодека в списке согласно приоритету кодека.

Пример:

/mgc/media-profile/codecs-priority new_media_profile audio G729 18 up

Media-profile: new_media_profile priority changed for audio codecs successfully.

Codec type: audio codecs configuration:
┌───────┬─────┬──┐
│Enabled│Codec│PT│
├───────┼─────┼──┤
│false  │G729 │18│
│       │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.

codecs-remove

/mgc/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, если он не стандартный

Пример:

/mgc/media-profile/codecs-remove new_media_profile audio G729 18

Media-profile: new_media_profile removes audio codecs successfully.

Codec type: audio codecs configuration:
┌───────┬─────┬──┐
│Enabled│Codec│PT│
├───────┼─────┼──┤
│       │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.

codecs-set

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

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

/mgc/media-profile/codecs-set

Синтаксис:

codecs-set <MEDIA_PROFILE_NAME> <CODECS-TYPE> <CODEC-NAME> <CODEC-PT> <ENABLED>

Параметры:

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

В этой команде список кодеков должен быть исчерпывающим.

Пример:

/mgc/media-profile/codecs-set new_media_profile audio PCMA 8 true G723 4 true GSM 3 true telephone-event * true

Media-profile: new_media_profile set audio codecs successfully.

Media-profile detailed information:
┌───────────────┬─────────────────┐
│   Parameter   │      Value      │
├───────────────┼─────────────────┤
│name           │new_media_profile│
│description    │new_profile      │
│codecs-priority│user             │
└───────────────┴─────────────────┘

Codec type: audio codecs configuration:
┌───────┬───────────────┬──┐
│Enabled│     Codec     │PT│
├───────┼───────────────┼──┤
│       │PCMA           │8 │
│       │G723           │4 │
│       │GSM            │3 │
│       │telephone-event│* │
└───────┴───────────────┴──┘

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

Legend:
 Enabled - is codec enabled. Empty means true.
 Codec   - list of codec names and special value <other>.
 PT      - Payload Type, * means any value.

declare

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

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

/mgc/media-profile/declare

Синтаксис:

declare <MEDIA_PROFILE_NAME> <DESCRIPTION> <PRIORITY>

Параметры:

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

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

Пример:

/mgc/media-profile/declare new_media_profile new_profile user

Media-profile: new_media_profile declared successfully.

Media-profile detailed information:
┌───────────────┬─────────────────┐
│   Parameter   │      Value      │
├───────────────┼─────────────────┤
│name           │new_media_profile│
│description    │new_profile      │
│codecs-priority│user             │
└───────────────┴─────────────────┘

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

Legend:
 Enabled - is codec enabled. Empty means true.
 Codec   - list of codec names and special value <other>.
 PT      - Payload Type, * means any value.

info

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

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

/mgc/media-profile/declare

Синтаксис:

declare <MEDIA_PROFILE_NAME> <DESCRIPTION> <PRIORITY>

Параметры:

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

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

Пример:

/mgc/media-profile/info default

Media-profile general information:
╭───────────────┬─────────────────────╮
│   Parameter   │        Value        │
├───────────────┼─────────────────────┤
│name           │default              │
│description    │Default media profile│
│codecs-priority│user                 │
└───────────────┴─────────────────────┘

Codecs type: audio codecs configuration:
╭───────┬───────────────┬──╮
│Enabled│     Codec     │PT│
├───────┼───────────────┼──┤
│       │G722           │9 │
│       │PCMA           │8 │
│       │PCMU           │0 │
│       │G726-32        │2 │
│       │G729           │18│
│       │telephone-event│96│
│false  │opus           │* │
│false  │SILK           │* │
│       │<other>        │* │
└───────┴───────────────┴──┘

Codecs type: video codecs configuration:
╭───────┬───────┬──╮
│Enabled│ Codec │PT│
├───────┼───────┼──┤
│       │H263   │34│
│       │H264   │* │
│       │<other>│* │
└───────┴───────┴──┘

Codecs type: image codecs configuration:
╭───────┬───────┬──╮
│Enabled│ Codec │PT│
├───────┼───────┼──┤
│       │T38    │* │
│false  │JPEG   │26│
│false  │<other>│* │
└───────┴───────┴──┘

Codecs type: image codecs configuration:
╭───────┬───────┬──╮
│Enabled│ Codec │PT│
├───────┼───────┼──┤
│       │<other>│* │
└───────┴───────┴──┘

Legend:
 Enabled - is codec enabled. Empty means true.
 Codec   - list of codec names and special value <other>.
 PT      - PayloadType, * means any value

list

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

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

/mgc/media-profile/list

Синтаксис:

list <MEDIA_PROFILE_NAME>

Параметры:

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

Пример:

/mgc/media-profile/list

List of media-profiles:
╭─────────────┬────────────────────────╮
│  Name       │          Description   │
├─────────────┼────────────────────────┤
│default      │Default media profile   │
│RTK          │Profile for RTK gateway │
└─────────────┴────────────────────────┘

remove

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

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

/mgc/media-profile/remove

Синтаксис:

remove <MEDIA_PROFILE_NAME>

Параметры:

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

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

Пример:

/mgc/media-profile/remove new_media_profile

Media profile: new_media_profile removed successfully.

set

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

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

/mgc/media-profile/set

Синтаксис:

remove <MEDIA_PROFILE_NAME> <PARAM> <VALUE>

Параметры:

<MEDIA_PROFILE_NAME> - имя медиа-профиля.
<PARAM> - имя параметра для изменения, может быть description или codecs-priority offroad
<VALUE> - значение для выбранного параметра: строка для параметра description, system или user для параметра codecs-priority, и audio, image, video для параметра offroad

Пример:

/mgc/media-profile/set new_media_profile codecs-priority system

Media-profile: new_media_profile set codecs-priority successfully.

Media-profile detailed information:
┌───────────────┬─────────────────┐
│   Parameter   │      Value      │
├───────────────┼─────────────────┤
│name           │new_media_profile│
│description    │new_profile      │
│codecs-priority│system           │
└───────────────┴─────────────────┘

Codec type: audio codecs configuration:
┌───────┬───────────────┬──┐
│Enabled│     Codec     │PT│
├───────┼───────────────┼──┤
│       │PCMA           │8 │
│       │G723           │4 │
│       │GSM            │3 │
│       │telephone-event│* │
└───────┴───────────────┴──┘

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

Legend:
 Enabled - is codec enabled. Empty means true.
 Codec   - list of codec names and special value <other>.
 PT      - Payload Type, * means any value.

Были добавлены параметры:

Взамен параметра dtmf_source на уровне медиа-профиля добавить два свойства:

dtmf-receive = 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 = transit :: signalling | none | transit | rfc2833 | inband - метод передачи DTMF
- none - не передавать DTMF на данный интерфейса;
- transit - передавать DTMF в том формате, в котором он был получен;
- signalling - передавать DTMF в SIP Info;
- rfc2833 - передавать DTMF через RTP по rfc2833;
- inband - передавать DTMF через RTP по INBAND
  2.1 Команда для изменения свойств dtmf-receive, dtmf-transmit медиа-профиля:

Дерево страниц

/mgc/media-profile/ - команды управления медиа-профилями медиа шлюзов.

codecs-add

codecs-get

codecs-priority

codecs-remove

codecs-set

declare

info

list

remove

set