...
connect | Установить соединение с WCS сервером |
urlServer | Этот параметр будет использован WCS JavaScript API для соединения с сервером. |
appKey | По этому параметру WCS получит REST - URL для данного приложения. Для просмотра и добавления приложений воспользуйтесь Интерфейсом Командной Строки (CLI). |
sipRegisterRequired | Если этот параметр true, будет произведена регистрация на SIP сервере путем вызова SIP REGISTER. Если параметр false, регистрация на SIP-сервере произведена не будет. В этом случае web-страница не сможет принимать входящие звонки с SIP, но по прежнему сможет осуществлять исходящие вызовы, если SIP сервер позволяет исходящие звонки без SIP-регистрации. |
sipLogin | SIP имя пользователя. |
sipAuthenticationName | SIP имя пользователя, которое используется для SIP аутентификации. Может отличаться от sipLogin. |
sipPassword | SIP пароль. Используется для SIP аутентификации. |
sipVisibleName | SIP имя пользователя, которое будет отображаться абонентам, получающим от этого пользователя входящий звонок. |
sipDomain | SIP домен. FQDN или IP-адрес. |
sipOutboundProxy | SIP прокси сервер. FQDN или IP адрес. Может отличаться от sipDomain. |
sipPort | SIP порт, который используется на SIP сервере для обработки SIP трафика. |
sipContactParams | Строка пользовательских произвольных параметров, которая будет добавлена в SIP Contact header REGISTER запроса. |
status | |
mediaProviders | Массив с доступными типами медиа на WCS JavaScript API: "WebRTC", "Flash" |
restClientConfig | JSON - объект, описывающий конфигурацию управления взаимодействием с web-сервером. Если объект не был передан, используются значения по умолчанию. См. RestClientConfig. |
width | Максимальная ширина видео, в пикселях |
height | Максимальная высота видео, в пикселях |
custom | Объект с произвольным содержимым для идентификации клиента на бэкенд сервере |
ConnectionStatusEvent | Изменение статуса соединения |
sipRegisterRequired | |
sipLogin | |
sipPassword | |
sipVisibleName | |
sipDomain | |
sipOutboundProxy | |
sipPort | |
sipContactParams | |
status | Статус соединения с WCS сервером: PENDING, ESTABLISHED, FAILED, DISCONNECTED. |
info | В это поле может быть добавлена дополнительная информация. Например если status==FAILED, в info будет передано описание причины. |
authToken | Ключ использующийся WCS JavaScript API для подключения Flash составляющей к WCS серверу по протоколу RTMFP. |
mediaProviders | |
nodeId | |
sessionId | |
appKey | |
custom | Объект с произвольным содержимым для идентификации клиента на бэкенд сервере, переданный в /connect |
RegistrationStatusEvent | Изменение статуса SIP регистрации |
status | Статусы регистрации: REGISTERED, UNREGISTERED, FAILED. |
info | |
sipMessageRaw | Исходное SIP-сообщение с заголовками. SIP Response на REGISTER Request. |
nodeId | |
sessionId | |
appKey | |
call | Исходящий звонок |
callId | Уникальный идентификатор звонка. |
callee | Вызываемый абонент в формате SIP URI, tel URI или телефонный номер. |
caller | Вызывающий абонент в формате SIP URI. |
visibleName | Надпись, которая будет отображаться у вызываемого абонента. |
hasVideo | Если true, то это видео звонок. |
inviteParameters | Параметры, которые будут добавлены в SIP INVITE Request URI. |
isMsrp | Если true, то это не голосовой вызов, а установление MSRP-соединения для передачи данных. |
status | |
incoming | Если true, то это звонок поступивший с SIP стороны |
mediaProvider | Используемое медиа на WCS JavaScript API, возможные значения: "WebRTC", "Flash" |
sdp | SDP сформированное WCS JavaScript API, присутствует при mediaProvider==WebRTC |
OnCallEvent | Входящий звонок |
callId | ` |
callee | |
caller | |
visibleName | |
hasVideo | |
sipMessageRaw | SIP INVITE сообщение, на основе которого создвется событие входящего звонка. |
incoming | |
status | |
mediaProvider | |
sdp | |
nodeId | |
sessionId | |
appKey | |
CallStatusEvent | Изменение статуса звонка |
callId | |
incoming | Если true, то звонок входящий |
status | Статусы звонка: TRYING, RING, SESSION_PROGRESS, BUSY, ESTABLISHED, HOLD, FINISH, FAILED |
info | |
sipMessageRaw | Исходное сообщение, соответствующее передаваемому событию. Например, в случае TRYING, это будет SIP 100 TRYING Response, в случае ESTABLISHED это будет SIP 200 OK Response, в случае HOLD это будет SIP 200 OK Response на re-INVITE, и т.д. |
sipStatus | Статус полученный от SIP стороны |
caller | |
callee | |
hasVideo | |
visibleName | |
mediaProvider | |
nodeId | |
sessionId | |
appKey | |
answer | Ответить на входящий звонок |
callId | |
incoming | |
sipStatus | |
caller | |
callee | |
hasVideo | |
visibleName | |
mediaProvider | |
sdp | |
status | |
nodeId | |
sessionId | |
appKey | |
hangup | Завершить звонок |
callId | |
hasVideo | |
nodeId | |
sessionId | |
appKey | |
hold | Поставить звонок на удержание |
callId | |
hasVideo | |
nodeId | |
sessionId | |
appKey | |
unhold | Снять звонок с удержания |
callId | |
hasVideo | |
nodeId | |
sessionId | |
appKey | |
transfer | Сделать трансфер звонка |
callId | |
target | Номер или SIP URI абонента, которому будет осуществлен трансфер звонка. |
nodeId | |
sessionId | |
appKey | |
OnTransferEvent | Входящий трансфер |
callId | |
incoming | |
target | |
hasVideo | |
nodeId | |
sessionId | |
appKey | |
TransferStatusEvent | Изменение статуса трансфера звонка |
callId | |
incoming | Если true, то этот трансфер был инициирован другой стороной. |
status | Статусы трансфера звонка: ACCEPTED, TRYING, COMPLETED, FAILED. Если статус не распознан будет передан статус полученный от SIP стороны. |
info | |
sipMessageRaw | |
hasVideo | |
nodeId | |
sessionId | |
appKey | |
sendDTMF | Отправить DTMF сигнал |
callId | |
dtmf | Символ в текстовом виде, который передается в DTMF: 1-16, *, #. |
type | Тип DTMF сигнала: INFO, INFO_RELAY, RFC2833. |
nodeId | |
sessionId | |
appKey | |
sendMessage | Отправить сообщение |
id | Уникальный идентификатор сообщения. |
from | Номер или SIP URI отправителя сообщения. |
to | Номер, логин или SIP URI получателя сообщения. |
body | Текст сообщения. |
contentType | text/plain - сообщение будет отправлено как SIP MESSAGE с заголовком 'Content-Type : text/plain' и с текстом в теле сообщения. message/cpim - сообщение будет отправлено как SIP MESSAGE с заголовком 'Content-Type:message/cpim' и сообщением text/plain в теле CPIM-сообщения. multipart/mixed - сообщение будет отправлено как SIP MESSAGE с заголовком 'Content-Type:multipart/mixed' и CPIM сообщениями в теле, каждое из которых в своем теле имеет text/plain сообщение. |
isImdnRequired | Если флаг установлен в true, для типов message/cpim и multipart/mixed в тело CPIM сообщения будет добавлена информация, запрашивающая уведомление о доставке через IMDN |
recipients | Список получателей сообщения, разделенный запятой. Через запятую должны быть перечислены SIP URI, tel URI или SIP логины получателей. Поле используется только в том случае, если задан ContentType multipart/mixed. Это поле будет корректно работать только тогда, когда SIP-сервер поддерживает отправку сообщений нескольким абонентам на основе multipart/mixed. WCS отправит SIP серверу multipart/mixed сообщение с несколькими адресатами. Если ваш SIP-сервер не поддерживает такую отправку, оставьте это поле пустым и попытайтесь отправить несколько отдельных сообщений. |
nodeId | |
sessionId | |
appKey | |
OnMessageEvent | Входящее сообщение |
id | |
from | |
to | |
body | |
contentType | |
isImdnRequired | Если входящее сообщение имеет такой флаг, то будет высылаться уведомление о доставке IMDN. |
sipMessageRaw | SIP MESSAGE сообщение, соответствующее событию входящего сообщения OnMessageEvent. |
status | |
nodeId | |
sessionId | |
appKey | |
MessageStatusEvent | Изменение статуса сообщения |
id | |
from | |
to | |
contentType | |
isImdnRequired | |
body | |
status | Статусы сообщений: RECEIVED, ACCEPTED, FAILED, IMDN_DELIVERED, IMDN_FAILED, IMDN_NOTIFICATION_SENT |
info | |
sipMessageRaw | SIP сообщение, соответствующее статусу: RECEIVED - Получено входящее сообщение в SIP INVITE ACCEPTED - SIP 200 OK or 202 ACCEPTED Response на SIP MESSAGE Request. FAILED - SIP 4xx Response от SIP-сервера. IMDN_DELIVERED - Получено входящее уведомление о доставке SIP MESSAGE со статусом 'Delivered'. IMDN_FAILED - Получено уведомление о доставке со статусом 'Delivery Failed'. IMDN_NOTIFICATION_SENT - Отправлено IMDN-сообщение. |
nodeId | |
sessionId | |
appKey | |
subscribe | SIP subscribe - подписка на уведомления SIP сервера. RFC3265. |
event | Тип события: reg |
expires | Интервал в секундах. Внутри этого интервала WCS-сервер будет делать re-SUBSCRIBE. |
terminate | |
nodeId | |
sessionId | |
appKey | |
SubscriptionStatusEvent | Изменение статуса SIP-подписки |
event | |
expires | |
terminate | Если true то подписка должна быть деактивирована |
requestBody | Поле содержащее пришедший XML с SIP стороны |
status | Статусы подписки: Active, Terminated |
info | |
sipMessageRaw | SIP сообщение, изменяющее статус подписки: Active - SIP 200 OK Response on SUBSCRIBE Request. Terminated - SIP 200 OK Response on SUBSCRIBE Request with expires:0. Terminated - SIP NOTIFY Request с статусом 'terminated' внутри тела NOTIFY сообщения. |
nodeId | |
sessionId | |
appKey | |
sendXcapRequest | Отправка XCAP запроса |
url | URL для XCAP запроса. |
nodeId | |
sessionId | |
appKey | |
XcapStatusEvent | Получение XCAP ответа |
url | |
responseBody | Тело XCAP-ответа |
publishStream | Публикация потока на сервер |
name | Имя публикуемого потока. Должно быть уникальным. Если поток с таким именем уже опубликован, публикация данного потока будет запрещена. |
mediaSessionId | Идентификатор медиа сессии |
published | Если true, то поток является опубликованным |
hasVideo | Сигнализирует присутствие видео в потоке |
status | |
sdp | SDP, полученное от клиента |
nodeId | |
sessionId | |
appKey | |
record | Если true, то опубликованный поток записывается |
custom | Объект с произвольным содержимым для идентификации клиента на бэкенд сервере |
unPublishStream | Остановка публикации потока |
name | |
mediaSessionId | |
published | |
hasVideo | |
status | |
sdp | |
nodeId | |
sessionId | |
appKey | |
record | |
custom | Объект с произвольным содержимым для идентификации клиента на бэкенд сервере, переданный в publushStream |
playStream | Воспроизведение потока |
name | Имя воспроизводимого потока. |
mediaSession | |
published | |
hasVideo | |
status | |
sdp | |
nodeId | |
sessionId | |
appKey | |
custom | Объект с произвольным содержимым для идентификации клиента на бэкенд сервере |
playHLS | Воспроизведение HLS потока |
name | |
mediaSessionId | |
mediaProvider | |
nodeId | |
sessionId | |
appKey | |
token | Токен клиента |
playRTSP | Воспроизведение RTSP потока |
name | |
mediaSessionId | |
mediaProvider | |
nodeId | |
sessionId | |
appKey | |
rtspUrl | URL RTSP потока |
User-Agent | User-Agent клиента |
stopStream | Остановка воспроизведения потока |
name | |
mediaSessionId | |
published | |
hasVideo | |
status | |
sdp | |
nodeId | |
sessionId | |
appKey | |
custom | Объект с произвольным содержимым для идентификации клиента на бэкенд сервере, переданный в /playStream |
StreamStatusEvent | Изменение статуса потока |
name | |
status | Статус потока: PUBLISHING, UNPUBLISHED, PLAYING, STOPPED |
mediaSessionId | |
published | |
hasVideo | |
sdp | |
info | |
nodeId | |
sessionId | |
appKey | |
record | |
custom | Объект с произвольным содержимым для идентификации клиента на бэкенд сервере, переданный в /publishStream или /playStream |
StreamKeepAliveEvent | Keep-alive REST-запрос для потока |
nodeId | |
appKey | |
sessionId | |
mediaSessionId | |
name | |
published | |
hasVideo | |
status | Статус потока: PLAYING, PUBLISHING |
info | |
mediaProvider | Используемое медиа на WCS JavaScript API, возможные значения: "WebRTC", "Flash" |
record | |
sendData | Отправка данных |
operationId | Уникальный идентификатор для отправляемых данных. |
payload | JSON объект с данными. |
nodeId | |
sessionId | |
appKey | |
OnDataEvent | Получение входящих данных |
operationId | |
payload | |
nodeId | |
sessionId | |
appKey | |
DataStatusEvent | Изменение статуса отправленных данных |
operationId | |
status | ACCEPTED, FAILED |
info | |
nodeId | |
sessionId | |
appKey | |
ErrorEvent | Неклассифицированная ошибка |
info | Дополнительная информация об ошибке. |
sendBugReport | Отправка отчета об ошибке для сохранения на сервере |
text | Краткое пользовательское описание ошибки. |
type | Если тип no_media сервер включит дамп трафика перед созданием этого багрепорта чтобы убедиться в том, что трафик идет правильно для этого пользователя. Отправка багрепортов такого типа может быть полезна при диагностике проблемы когда звук передается только в одну сторону. |
nodeId | |
sessionId | |
appKey | |
BugReportStatusEvent | Подтверждение отправки отчета об ошибке с выводом имени сохраненного файла |
filename | Имя файла на сервере, под которым был сохранен багрепорт. |
nodeId | |
sessionId | |
appKey | |
sendStreamEvent | Событие, сигнализирующее изменение состояния публикуемого потока |
info | Дополнительная информация |
type | Тип изменения: audioMuted, videoMuted, audioUnmuted, videoUnmuted |
mediaSessionId | Идентификатор публикующей медиасессии |
nodeId | |
sessionId | |
appKey | |
StreamEvent | Событие, сигнализирующее изменение состояния потока для подписчиков |
info | Дополнительная информация |
type | Тип изменения: audioMuted, videoMuted, audioUnmuted, videoUnmuted |
mediaSessionId | Идентификатор медиасессии подписчика |
nodeId | |
sessionId | |
appKey | |
Context Parameters | Параметры контекста. Используются для всех вызовов от WCS к Web-серверу. |
nodeId | Уникальный идентификатор инстанса WCS сервера. |
sessionId | Уникальный идентификатор коннекта клиента на этом инстансе. |
appKey | Идентификатор приложения на WCS сервере, с которым пользователь установил соединение. |