RTP Tasks - Version 1.0

This document describes the RTP Tasks, provided as custom tasks that must be installed with PureLoad/PureTest on each machine using these tasks.

Read more about installation and how to load and use custom tasks.

The RTP Tasks

The provided tasks supports basic testing and simulation of RTP clients.

The RTP tasks is designed to be used together with a nother signaling protocol such as SIP but can also be used as is to test simple RTP clients.

Limitations

Current version of the RTP tasks have limitations and does not support everything described in the RTP specification RFC 3550. This includes:

Provided tasks



RtpInitTask

Task used to Initiate RTP client and RTP session.

Multiple client/sessions can be used in one scenario if identified using the Session ID parameter.

RTP and RTCP ports are allocated in consecutive pairs where RTP port are even and that each associated RTCP port be the next higher odd number. The allocated port are saved using the specified variable names.

Parameters

Local Host Local RTP host or IP Adress to bind to (empty to bind to any local address)
Local Port Local RTP port (0 to pick any free ephemeral ports). RTCP port is the next higher odd number
Payload Type RTP payload type (RFC 3551) used for the session
RTP Port Variable Save allocated local RTP port using specified variable
RCTP Port Variablet Save allocated local RTCP port using specified variable


RtpCloseTask

Task used to close RTP session and release used resources.



RtpAddParticipantTask

Task used to add a remote participant for the a session. Must be specified to send data to a remote participant.

Parameters

Remote Address Remote host or IP address of participant.
Remote RTP Port Remote RTP port of participant
Remote RTCP Port Remote RTCP port of participant


RtpReceiveDataTask

Task used to Receive RTP data.

If Wait For RTCP BYE parameter is selected the task will wait until RTCP BYE is received. If not the task will wait until any data received. If not received within the specified Wait Time a timeout will be reported.

If not data or session terminated within the specified Wait Time a timeout will be reported.

Result will include information about number of bytes received and information received using RTCP RR packets (if any). This information is set as result data and can be parsed using ExtracTask as needed.

Parameters

Wait Time Time (milli-seconds) to wait for data received
Wait For RTCP BYE Select to wait until RTCP BYE is received.


RtpSendDataTask

Task used to Send specified data in one RTP packet.

Data is specified in string format and converted to bytes (UTF-8) before sent.

Parameters

Data Data to be send in string format (UTF-8).


RtpSendAudioTask

Task used to read an audio file and send data using multiple RTP packets.

No actual encoding is done, but sent RTP packets are timed based to the audio information in the read audio file.

The audio file must be in a file format accepted by Java (WAVE, AU or AIFF). Audio data must be PCM and only one channel is supported.

Parameters

File Path File path to audio file.