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