How to:
Example:
Open a terminal: python Server.py 1025 Open another terminal: python ClientLauncher.py 127.0.0.1 1025 5008 video.mjpeg Start the server with the command line
python Server.py server_port Where server_port is the port your server listens to for incoming RTSP connections # 1025 # Standard RTSP port is 554 # But need to choose a #port > 1024 Open a new terminal
Start the client with the command line python ClientLauncher.py server_host server_port RTP_port video_file Where # server_host : the name of the machine where server is running (here "127.0.0.1") Use command line hostname to get the hostname(IP address,human readable hostname may not work) # server_port : port the server is listening on (here "1025") # RTP_port : port where the RTP packets are received (here "5008") # video_file : name of video file you want to request,here "video.mjpeg" @ file format Lab`s` proprietary MJPEG(Motion JPEG) format # The server streams a video which has been encoded into a proprietary MJPEG file format # This format stores the video as concatenated JPEG-encoded images # Each image being preceded by a 5-Byte header which indicates the bit size of the image # Server parses the bitstream of MJPEG file to extract the JPEG images # Server sends the images to client at periodic intervals # Client then displays the individual JPEG images sent from server @ Client # Send RTSP commands to server by pressing buttons: > RTSP(Real Time Streaming Protocol) * A network control protocol designed for use in entertainment and communications system to control streaming media servers * Used for establishing and controlling media sessions between end points * Clients issue VCR-style commands e.g play, pause .. to facilitate real-time control of playback of media files from server # Most RTSP servers use the RTP(Real-time Transport Protocol) in conjunction with RTCP(Real-time Control Protocol) for media stream delivery. # Commands > SETUP * Send SETUP request to the server * Insert Transport header(specify port for RTP data socket you just created) * RTP : Real-time Transport Protocol * Read server`s` response * Parse Session header(from response) to get RTSP Session ID * Create a datagram socket for receiving RTP data * Set timeout on socket to 0.5 seconds > PLAY * Send PLAY request * Insert Session header * Use the Session ID(returned in the SETUP response) * Not put the Transport header in the request * Read the Server`s` response > PAUSE * Send PAUSE request * Insert the Session header * Use the Session ID returned in the SETUP response * Not put the Transport header in this request * Read the server`s` response > TEARDOWN * Send TEARDOWN request * Insert the Session header * Use the Session ID returned in the SETUP response * Not put the Transport header in this request * Read the server`s` response *** Must insert CSeq header in every request you send Which starts at 1 and incremented by one for each request you send What we need to implement
@ Client.py # SETUP function # PLAY function # PAUSE function # TEARDOWN function @ RtpPacket.py # Set the RTP-version filed(V) = 2 # Set padding(P), extension(X), # of contributing sources(CC), and marker(M) fields => all to 0 # Set payload type field(PT). we use MJPEG type, type number is 26 # Set sequence number.(frameNbr argument) # Set timestamp (via Python time module) # Set source identifier(SSRC)(identifies the server,pick an ID you like) # We have no other contributing sources(field CC == 0), the CSRC-field does not exist. The packet header is 12 bytes