=head1 NAME Net::SIP::Simple::RTP - simple RTP handling for L<Net::SIP::Simple> =head1 SYNOPSIS my $echo_10 = Net::SIP::Simple->rtp( 'media_recv_echo', 'output.pcmu-8000', 10 ); my $announce = Net::SIP::Simple->rtp( 'media_send_recv', 'announce.pcmu-8000', 2 ); =head1 DESCRIPTION This package handles simple RTP stuff for testing and small applications. It provides methods for receiving PCUM/8000 data and for echoing them back or for sending and receiving PCMU/8000 data. It's used from method B<rtp> in L<Net::SIP::Simple>. =head1 SUBROUTINES =over 4 =item media_recv_echo ( [ OUTPUT, DELAY ] ) Receives RTP data and echoes them back to the sender. If OUTPUT is given it will be used as the file for saving the received data without the RTP header. OUTPUT might also be a callback which gets the payload as argument. If DELAY is >0 the data will not be echoed back immediately but with a delay of DELAY packets (e.g. with DELAY 10 it will send back the first packet after it received the 10th packet). If DELAY is <0 the data will not be echoed back. If DELAY is not given or equal 0 the data will be echoed back immediately. If no traffic comes in for more then 10 seconds it will hang up the call because of inactivity. =item media_send_recv ( INPUT, [ REPEAT, OUTPUT ] ) Will read data from file INPUT and send them as RTP to peer. It will assume that each data block in INPUT consists of 160 bytes, which is right for PCMU/8000 without RTP header. The RTP header will be added to the data. If it reaches the end of the file it will stop unless REPEAT is given in which case it will repeat the sending REPEAT times (if REPEAT is less 0 it will repeat forever e.g. until the other party hangs up). On stopping it will invoke the callback B<cb_rtp_done> from the connection params for the L<Net::SIP::Simple::Call> or if this is not given it will close the call by issuing a BYE. INPUT might also be a callback usable by B<invoke_callback> in L<Net::SIP::Util> which returns the data to send. In this case REPEAT is not used. Incoming data will be written to the optional OUTPUT file like in B<media_recv_echo>. The content from OUTPUT has the same format as INPUT or OUTPUT from B<media_recv_echo>. OUTPUT might also be a callback which gets the payload as an argument. If no traffic comes in for more then 10 seconds it will hang up the call because of inactivity. =back