...
Таким образом могут быть остановлены публикация или воспроизведение потока, или и то, и другое.
Чтобы различить опубликованные и воспроизводимые потоки, скрипт web-сервера должен обрабатывать 'published' параметр метода StreamKeepAliveEvent
REST API
Сконфигурируйте web-сервер с REST Hooks. Он должен обрабатывать keep-alive запросы от WCS-сервера, используя, например, PHP-скрипт, и определять restClientConfig для метода StreamKeepAliveEvent
Code Block | ||||
---|---|---|---|---|
| ||||
"StreamKeepAliveEvent" : { "clientExclude" : "", "restExclude" : "sdp", "restOnError" : "FAIL", "restPolicy" : "NOTIFY", "restOverwrite" : "" } |
...
1) Включить настройку keep-alive в flashphoner.properties
Code Block | ||||
---|---|---|---|---|
| ||||
keep_alive_streaming_sessions_enabled=true |
...
Может быть использовано другое, чем 'defaultApp', приложение.
Используйте Command Line Interface, команду 'show apps', чтобы просмотреть список приложений и их ключи.
3) Добавить к этому приложению REST-метод StreamKeepAliveEvent, используя следующую команду
...
Code Block | ||||
---|---|---|---|---|
| ||||
update app defaultApp http://my-web-server.com/MyAPI |
Здесь:
- my-web-server.com - это адрес web-сервера,
- MyAPI - это путь, по которому расположен REST API.
...
REST-запрос должен быть HTTP/HTTPS POST запросом в таком виде:
- HTTP: http://streaming.flashphoner.com:8081/rest-api/stream/terminate
- HTTPS: https://streaming.flashphoner.com:8444/rest-api/stream/terminate
Здесь:
- streaming.flashphoner.com - адрес WCS-сервера
- 8081 - стандартный REST / HTTP порт WCS-сервера
- 8444 - стандартный HTTPS порт
- rest-api - обязательная часть URL
- /stream/terminate - используемый REST-метод
REST-методы и статусы ответа
REST-метод | Пример тела REST-запроса | Пример тела REST-ответа | Статусы ответа | |||||||
---|---|---|---|---|---|---|---|---|---|---|
/stream/terminate |
| 200 - Команда на завершение потока принята 404 - Поток не найден |
Параметры
Имя параметра | Описание | Пример |
---|---|---|
mediaSessionId | Идентификатор медиа сессии | 41c3f621-a847-4639 |
name | Имя потока | streamName |
published | Если true, то поток является опубликованным; если false, то поток воспроизводится | true |
status | Текущий статус потока | PUBLISHING |
Фильтрация потоков по параметрам
...
Code Block | ||||
---|---|---|---|---|
| ||||
{"name": "streamName","published": false} |
Можно остановить все публикации публикацию по статусу
Code Block | ||||
---|---|---|---|---|
| ||||
{"name": "streamName","status": "PUBLISHING"} |
Также можно остановить все потоки в определенных медиасессиях
Code Block | ||||
---|---|---|---|---|
| ||||
{"mediaSessionIds":["41c3f621-a847-4639", "554916e0-931c-2479"]} |
Запрос без параметров остановит все потоки на сервереили в одной медиасессии
Code Block | ||||
---|---|---|---|---|
| ||||
{"mediaSessionId":"41c3f621-a847-4639"} |
Отправка REST-запроса к WCS-серверу
...
Симптомы: В случае остановки со стороны сервера RTMFP-потока, опубликованного с использованием клиента client2/examples/demo/streaming/flash_client/chat.html, публикация потока останавливается, однако сессия потока не уничтожается. В логе flashphoner.log появляются сообщения "Can't find mediasession".
Решение: Для завершения сессии необходимо кликнуть кнопку 'Stop video' на странице клиента.
...