В текущем разделе описаны команды управления медиа-профилями медиа шлюзов. Они необходимы для корректного формирования 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 медиа-профиля:
Добавить комментарий