/domain/<DOMAIN>/media-profile/ - команды управления медиа-профилями
В текущем разделе описаны команды управления медиа-профилями.
В ряде случаев необходимо иметь возможность ограничивать список кодеков, которые используются для установления соединения, выбирать кодеки с определенным приоритетом, а также управлять разрешением исходящего и входящего видеопотока. Эти предпочтения могут быть установлены как глобально для домена, так и индивидуально для абонента или для транка.
Настроенный медиа-профиль устанавливается на уровне алиасов, параметрами 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, по умолчанию *. Возможные значения:
- --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]