...

Параметры видео

Parameter	Values available	Description
Audio parameters
codec	opus mpeg4-generic speex	Audio codec usedto use
rate	8000 11025 12000 16000 22050 24000 32000 44100 48000	Audio sample rate, kHz
channels	1 2	Channels quantity: mono or stereo
Video parameters
codec	h264 vp8	Video codec to use
width	Depends on quality required and bandwith available	Picture width
height	Depends on quality required and bandwith available	Picture height
codeImpl	FF OPENH264	Video codec used: based on FFmpeg or OpenH.264
gop	Depends on quality required and bandwith available	Key frames frequency (GOP)
fps	Depends on quality required and bandwith available	Frames frequency per second

...

REST query

REST query body example

REST response example

Response states

Description

/cdn/stream/show_routes

Code Block

language	js
theme	RDark

{
 "streamName":"test-webrtc-144"
}

Code Block

language	js
theme	RDark

{
    "1REQUESTED-PROFILE-192.168.1.220": [
        "AUDIO{bitrate=0, codec='opus', rate=48000, channels=2}",
        "VIDEO{width=0256, height=0144, gop=null, fps=null, bitrate=0, codec='H264h264', codecImpl='nullOPENH264', quality=null}",
    ],
    "VIDEO{width=320, height=180, gop=null, fps=null, "1-PROFILE-192.168.1.220": [
        "AUDIO{bitrate=0, codec='H264opus', codecImplrate='FF'48000, qualitychannels=null2}",
        "VIDEO{width=2560, height=1440, gop=null, fps=null, bitrate=0, codec='H264', codecImpl='OPENH264null', quality=null}"
],
    "2-STREAM-192.168.1.220": [
        "AUDIO{bitrate=0, codec='opus', rate=48000, channels=2}",
        "VIDEO"VIDEO{width=0320, height=0180, gop=null, fps=null, bitrate=0, codec='H264', codecImpl='FF', quality=null}",
        "VIDEO{width=320256, height=180144, gop=null, fps=null, bitrate=0, codec='H264', codecImpl='FFOPENH264', quality=null}",
    ],
    "VIDEO{width=256, height=144, gop=null, fps=null, 2-STREAM-192.168.1.220": [
        "AUDIO{bitrate=0, codec='H264opus', codecImplrate='OPENH264'48000, qualitychannels=null2}",
    ],
    "3-NEW-TRANSCODER-192.168.1.220": [],
    "4-PROXY-192.168.1.219": [
        "AUDIO{VIDEO{width=0, height=0, gop=null, fps=null, bitrate=0, codec='opusH264', ratecodecImpl=48000'', channelsquality=2null}",
        "VIDEO{width=0320, height=0180, gop=null, fps=null, bitrate=0, codec='H264', codecImpl='FF', quality=null}",
        "VIDEO{width=256, height=144,  ]
}

200 – OK

500 – Internal Server Error

Show CDN stream routes

Parameters

2-STREAM220AUDIO{bitrate=0, codec=320180FF

Description

Example

Stream name (including transcoding profile if necessary)

test-webrtc-144

Transcoder stream parameters

Transcoding profiles used by Transcoder parameters

1-PROFILE-

gop=null, fps=null, bitrate=0, codec='H264', codecImpl='OPENH264', quality=null}"
    ],
    "3-NEW-TRANSCODER-192.168.1.220

Stream pulled from Origin by Transcoder parameters

": [],
    "4-PROXY-192.168.1.

Audio parameters

219": [
        "AUDIO{bitrate=0, codec='opus', rate=48000, channels=2}

Video parameters (according to transcoding profiles used)

",
        "VIDEO{width=

0, height=

0, gop=null, fps=null, bitrate=0, codec='H264', codecImpl='

', quality=null}

Stream parameters that Transcoder can pull from Origin

3-NEW-TRANSCODER-192.168.1.220

Origin stream parameters

Stream published to Origin parameters

4-PROXY-192.168.1.219

"
    ]
}

200 – OK

500 – Internal Server Error

Show CDN stream routes

Parameters

Description	Example
Stream name (including transcoding profile if necessary)	test-webrtc-144
Transcoding profile requested parameters
Profile requested parameters	REQUESTED-PROFILE
Audio parameters	AUDIO{bitrate=0, codec='opus', rate=48000, channels=2}
Video parameters	VIDEO{width=0256, height=0144, gop=null, fps=null, bitrate=0, codec='H264h264', codecImpl='OPENH264', quality=null}
Transcoder stream parameters
Transcoding profiles used by Transcoder parameters	1-PROFILE-192.168.1.220
Stream pulled from Origin by Transcoder parameters	2-STREAM-192.168.1.220
Audio parameters	AUDIO{bitrate=0, codec='opus', rate=48000, channels=2}
Video parameters (according to transcoding profiles used)	VIDEO{width=320, height=180, gop=null, fps=null, bitrate=0, codec='H264', codecImpl='FF', quality=null}
Stream parameters that Transcoder can pull from Origin	3-NEW-TRANSCODER-192.168.1.220
Origin stream parameters
Stream published to Origin parameters	4-PROXY-192.168.1.219
Audio parameters	AUDIO{bitrate=0, codec='opus', rate=48000, channels=2}
Video parameters	VIDEO{width=0, height=0, gop=null, fps=null, bitrate=0, codec='H264', codecImpl='', quality=null}

CDN routes checking examples

Let's look how to check some CDN routes for stream playback.

For example we use three nodes CDN:

192.168.1.219 - Origin
192.168.1.220 - Transcoder
192.168.1.221 - Edge

WebRTC H264+opus (48 kHz, stereo) stream named test is published to Origin

Stream pulling from Origin without transcoding if publishing and playback profiles are equal

Stream named test is played on Edge by profile

Code Block

language	yml
theme	RDark

 -webrtc-opus-video-proxy:
  audio:
    codec : opus
    rate : 48000
    channels : 2
  video:
    codec: h264

The response to this query

Code Block

language	js
theme	RDark

http://192.168.1.221:8081/rest-api/cdn/stream/show_routes
{
    "streamName": "test-webrtc-opus-video-proxy"
}

should be interpreted as follows:

1. Profile requested parameters:

Code Block

language	js
theme	RDark

    "REQUESTED-PROFILE": [
        "AUDIO{bitrate=0, codec='opus', rate=48000, channels=2}",
        "VIDEO{width=0, height=0, gop=null, fps=null, bitrate=0, codec='h264', codecImpl='null', quality=null}"
    ],

2. Stream is pulled from Origin:

Code Block

language	js
theme	RDark

    "1-PROXY-PROFILE-192.168.1.219": [
        "AUDIO{bitrate=0, codec='opus', rate=48000, channels=2}",
        "VIDEO{width=0, height=0, gop=null, fps=null, bitrate=0, codec='H264', codecImpl='', quality=null}"
    ],

3. Stream can be pulled from Transcoder

Code Block

language	js
theme	RDark

    "2-NEW-TRANSCODER-192.168.1.220": [],

4. But is pulled from Origin because stream publishing parameters are equal to requested playback parameters:

Code Block

language	js
theme	RDark

    "3-PROXY-192.168.1.219": [
        "AUDIO{bitrate=0, codec='opus', rate=48000, channels=2}",
        "VIDEO{width=0, height=0, gop=null, fps=null, bitrate=0, codec='H264', codecImpl='', quality=null}"
    ]

Stream pulling from Transcoder with audio transcoding

Stream named test is played on Edge by profile

Code Block

language	yml
theme	RDark

 -webrtc-pcma-video-proxy:
  audio:
    codec : pcma
    rate : 8000
    channels : 1

The response to this query

Code Block

language	js
theme	RDark

http://192.168.1.221:8081/rest-api/cdn/stream/show_routes
{
    "streamName": "test-webrtc-pcma-video-proxy"
}

should be interpreted as follows:

1. Profile requested parameters:

Code Block

language	js
theme	RDark

    "REQUESTED-PROFILE": [
        "AUDIO{bitrate=0, codec='pcma', rate=8000, channels=1}"
    ],

2. Transcoding profile is created on Transcoder:

Code Block

language	js
theme	RDark

    "1-PROFILE-192.168.1.220": [
        "AUDIO{bitrate=0, codec='opus', rate=48000, channels=2}",
        "VIDEO{width=0, height=0, gop=null, fps=null, bitrate=0, codec='H264', codecImpl='null', quality=null}",
        "AUDIO{bitrate=0, codec='PCMA', rate=8000, channels=1}"
    ],

3. Stream is pulled from Transcoder

Code Block

language	js
theme	RDark

    "2-STREAM-192.168.1.220": [
        "AUDIO{bitrate=0, codec='opus', rate=48000, channels=2}",
        "VIDEO{width=0, height=0, gop=null, fps=null, bitrate=0, codec='H264', codecImpl='null', quality=null}",
        "AUDIO{bitrate=0, codec='PCMA', rate=8000, channels=1}"
    ],
    "3-NEW-TRANSCODER-192.168.1.220": [],

4. Stream publishing to Origin parameters:

Code Block

language	js
theme	RDark

    "3-PROXY-192.168.1.219": [
        "AUDIO{bitrate=0, codec='opus', rate=48000, channels=2}",
        "VIDEO{width=0, height=0, gop=null, fps=null, bitrate=0, codec='H264', codecImpl='', quality=null}"
    ]

Stream pulling from Transcoder with video transcoding

Stream named test is played on Edge by profile

Code Block

language	yml
theme	RDark

 -opus-vp8:
  audio:
    codec : opus
    rate : 48000
    channels : 2
  video:
    width : 320
    height : 240
    gop : 60
    fps : 30
    codec : vp8
    codecImpl : FF

The response to this query

Code Block

language	js
theme	RDark

http://192.168.1.221:8081/rest-api/cdn/stream/show_routes
{
    "streamName": "test-webrtc-opus-vp8"
}

should be interpreted as follows:

1. Profile requested parameters:

Code Block

language	js
theme	RDark

    "REQUESTED-PROFILE": [
        "AUDIO{bitrate=0, codec='opus', rate=48000, channels=2}",
        "VIDEO{width=320, height=240, gop=60, fps=30, bitrate=0, codec='vp8', codecImpl='FF', quality=null}"
    ],

2. Transcoding profile is created on Transcoder:

Code Block

language	js
theme	RDark

    "1-PROFILE-192.168.1.220": [
        "AUDIO{bitrate=0, codec='opus', rate=48000, channels=2}",
        "VIDEO{width=0, height=0, gop=null, fps=null, bitrate=0, codec='H264', codecImpl='', quality=null}",
        "VIDEO{width=320, height=240, gop=60, fps=30, bitrate=0, codec='VP8', codecImpl='FF', quality=null}"
    ],

3. Stream is pulled from Transcoder

Code Block

language	js
theme	RDark

    "2-STREAM-192.168.1.220": [
        "AUDIO{bitrate=0, codec='opus', rate=48000, channels=2}",
        "VIDEO{width=0, height=0, gop=null, fps=null, bitrate=0, codec='H264', codecImpl='', quality=null}",
        "VIDEO{width=320, height=240, gop=60, fps=30, bitrate=0, codec='VP8', codecImpl='FF', quality=null}"
    ],
    "3-NEW-TRANSCODER-192.168.1.220": [],

4. Stream publishing to Origin parameters:

Code Block

language	js
theme	RDark

    "3-PROXY-192.168.1.219": [
        "AUDIO{bitrate=0, codec='opus', rate=48000, channels=2}",
        "VIDEO{width=0, height=0, gop=null, fps=null, bitrate=0, codec='H264', codecImpl='', quality=null}"
    ]

Backward compatibility with CDN 2.0

CDN 2.1 backward compatibility with CDN 2.0 is supported in the following cases:

1. Edge 2.0 can pull streams from Origin 2.1

2. Edge 2.1 can pull streams from Origin 2.0

In these cases transcoding works according to codecs and SDP setup as defined for CDN 2.0.

Space shortcuts

Page tree

Versions Compared

Old Version 2

New Version 3

Key

Parameters

Parameters

CDN routes checking examples

Stream pulling from Origin without transcoding if publishing and playback profiles are equal

Stream pulling from Transcoder with audio transcoding

Stream pulling from Transcoder with video transcoding

Backward compatibility with CDN 2.0

Space shortcuts

Page tree

Page History

Versions Compared

Old Version 2

New Version 3

Key

Parameters

Parameters

CDN routes checking examples

Stream pulling from Origin without transcoding if publishing and playback profiles are equal

Stream pulling from Transcoder with audio transcoding

Stream pulling from Transcoder with video transcoding

Backward compatibility with CDN 2.0