|
|
| Line 2: |
Line 2: |
| {{GstNetBalancer/Head|previous=Getting Started/Building and installation guide|next=Examples}} | | {{GstNetBalancer/Head|previous=Getting Started/Building and installation guide|next=Examples}} |
| </noinclude> | | </noinclude> |
|
| |
| == Element usage ==
| |
|
| |
| Bandwidth requirements for network streaming are a vital part of most multimedia applications, and it plays a critical role in wireless streaming applications such as wifi or radio links. For most wireless streaming applications, going beyond the limited bandwidth causes artifacts in the video content such as green and blocky regions or ghosting effects
| |
|
| |
| The netbalancer element is used for flattening the data transmission curve of a network in order to get the most out of a connection.
| |
| This is achieved by introducing dynamic delays between packets; the element keeps track of the amount of data that has been transmitted in a limited time frame. In case a new package wants to be sent but the data cap for that time frame has already been reached, then the packets are delayed until a new time window starts. This ensures that the data transmission is always under a specified bandwidth.
| |
|
| |
| The netbalancer does not modify the contents of any of the packets or the way they are sent. The characteristics of the packets remain the same; the only thing that varies is the rate at which these packets enter and exit the element pads. The netbalancer then does not replace any of the elements in a pipeline; it is not intended for packaging data nor sending it over a network. A netbalancer element is usually added at the end of the streaming pipeline; just before an <code>udpsink</code> or <code>rtspsink</code> element, but can be added anywhere where the packet rate wants to be controlled.
| |
|
| |
| An ideal use case for the netbalancer element happens when there are spikes of data transmitted in a very small time frame; meaning that the network load is not constant, so it is heavily stressed for a short time and idle the rest of the time.
| |
|
| |
| A real world example of this is the transmission of compressed video where I-frames are significantly larger so they periodically stress the network and these frames don't need to be immediately available on the receiver since the stream works at a fixed framerate. The netbalancer can space out the packets that make up the I-frames and send them at a pace that alleviates the network and keeps the framerate requirements.
| |
|
| |
| The following image represents the netbalancer theoretical functionality:
| |
|
| |
| [[File:GstNetbalancerRepresntation.png|center|frame|Figure 1. netbalancer properties behavior representation]]
| |
|
| |
|
| |
|
| == Main Properties == | | == Main Properties == |
| This element balances the network load by distributing the packages over time. To do so netbalancer provides 3 main properties: | | This element balances the network load by distributing the packages over time. To do so netbalancer provides 3 main properties: |
| | |
| | [[File:Netbalancer parameters.png|center|frame|Figure 1. netbalancer properties behavior representation]] |
|
| |
|
| * '''bandwidth''': defines the maximum desired bandwidth in kbps. | | * '''bandwidth''': defines the maximum desired bandwidth in kbps. |
