...
Отключение транскодинга не влияет на микшер, при использовании микшера транскодинг будет включаться.
Управление транскодингом при помощи REST API
REST-запрос должен быть HTTP/HTTPS POST запросом в таком виде:
- HTTP: http://test.flashphoner.com:8081/rest-api/transcoder/startup
- HTTPS: https://test.flashphoner.com:8444/rest-api/transcoder/startup
Здесь:
- test.flashphoner.com - адрес WCS-сервера
- 8081 - стандартный REST / HTTP порт WCS-сервера
- 8444 - стандартный HTTPS порт
- rest-api - обязательная часть URL
- /transcoder/startup - используемый REST-метод
REST-методы и статусы ответа
REST-метод | Пример тела REST-запроса | Пример тела REST-ответа | Статусы ответа | Описание | ||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
/transcoder/startup |
| 409 - Conflict 500 - Internal error | Создать транскодер с указанными параметрами для заданного потока | |||||||||||||||
/transcoder/find |
|
| 200 – транскодеры найдены 404 – транскодеры не найдены | Найти транскодер по указанным критериям | ||||||||||||||
/transcoder/find_all |
| 200 – транскодеры найдены 404 – транскодеры не найдены | Найти все транскодеры | |||||||||||||||
/transcoder/terminate |
| 200 - транскодер завершен 404 - транскодер не найден | Остановить транскодер и его выходной поток |
Параметры
Имя параметра | Описание | Пример |
---|---|---|
uri | URL транскодера | transcoder://tcode1 |
localStreamName | Имя выходного потока транскодера | testT |
remoteStreamName | Имя транскодируемого потока | test |
localMediaSessionId | Идентификатор медиасессии транскодера | 42a92132-bcd1-4436-a96f-3fec36b32b37 |
status | Текущий статус транскодера | PROCESSED_LOCAL |
hasAudio | Выходной поток содержит видео | true |
hasVideo | Выходной поток содержит аудио | true |
record | Выходной поток записывается | false |
Параметры кодирования | ||
width | Ширина картинки | 640 |
height | Высота картинки | 480 |
keyFrameInterval | Частота генерации ключевых кадров (GOP) | 30 |
fps | Частота кадров в секунду | 30 |
bitrate | Битрейт в кб/с | 500 |
type | Кодек | OPENH264 |
Краткое руководство по тестированию
1. Для тестирования используем
- WCS-сервер;
- Веб-приложение Two Way Streaming для публикации потока;
- Веб-приложение Player для воспроизведения выходного потока транскодера;
- браузер Chrome и REST-клиент для отправки запросов на сервер
2. Откройте приложение Two Way Streaming, опубликуйте поток test
3. Откройте REST-клиент, отправьте запрос /transcoder/startup
4. Откройте веб-приложение Player, укажите в поле Stream имя потока testT и нажмите Start
5. Откройте REST-клиент, отправьте запрос /transcoder/terminate
6. Воспроизведение потока останавливается в связи с остановкой транскодера