com.smartdevicelink.streaming.video

Class RTPH264Packetizer

java.lang.Object

com.smartdevicelink.streaming.AbstractPacketizer

com.smartdevicelink.streaming.video.RTPH264Packetizer

All Implemented Interfaces:

IVideoStreamListener, Runnable

public class RTPH264Packetizer
extends AbstractPacketizer
implements IVideoStreamListener, Runnable

This class receives H.264 byte stream (in Annex-B format), parses it, construct RTP packets from it based on RFC 6184, then frame the packets based on RFC 4571. The primary purpose of using RTP is to carry timestamp information along with the data.

Field Summary

Fields inherited from class com.smartdevicelink.streaming.AbstractPacketizer

_request, _rpcSessionID, _serviceType, _session, _streamListener, _wiproVersion, buffer, bufferSize, is

Constructor Summary

Constructors

Constructor and Description
RTPH264Packetizer(IStreamListener streamListener, SessionType serviceType, byte sessionID, SdlSession session) Constructor

Method Summary

Modifier and Type	Method and Description
void	pause() Pauses this packetizer.
void	resume() Resumes this packetizer.
void	run() The thread routine.
void	sendFrame(byte[] data, int offset, int length, long presentationTimeUs) Called by the app and encoder.
void	sendFrame(ByteBuffer data, long presentationTimeUs) Called by the app and encoder.
void	setPayloadType(byte type) Sets the Payload Type (PT) of RTP header field.
void	setSSRC(int ssrc) Sets the SSRC of RTP header field.
void	start() Starts this packetizer.
void	stop() Stops this packetizer.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

RTPH264Packetizer

public RTPH264Packetizer(IStreamListener streamListener,
                         SessionType serviceType,
                         byte sessionID,
                         SdlSession session)
                  throws IOException

Constructor

Parameters:

streamListener - The listener which this packetizer outputs SDL frames to

serviceType - The value of "Service Type" field in SDL frames

sessionID - The value of "Session ID" field in SDL frames

session - The SdlSession instance that this packetizer belongs to

Throws:

IOException

Method Detail

setPayloadType

public void setPayloadType(byte type)

Sets the Payload Type (PT) of RTP header field.

Use this method if PT needs to be specified. The value should be between 0 and 127. Otherwise, a default value (96) is used.

Parameters:

type - A value indicating the Payload Type

setSSRC

public void setSSRC(int ssrc)

Sets the SSRC of RTP header field.

Use this method if SSRC needs to be specified. Otherwise, a random value is generated and used.

Parameters:

ssrc - An integer value representing SSRC

start

public void start()
           throws IOException

Starts this packetizer.

It is recommended that the video encoder is started after the packetizer is started.

Specified by:

start in class AbstractPacketizer

Throws:

IOException

stop

public void stop()

Stops this packetizer.

It is recommended that the video encoder is stopped prior to the packetizer.

Specified by:

stop in class AbstractPacketizer

pause

public void pause()

Pauses this packetizer.

This pauses the packetizer but does not pause the video encoder.

Specified by:

pause in class AbstractPacketizer

resume

public void resume()

Resumes this packetizer.

Specified by:

resume in class AbstractPacketizer

run

public void run()

The thread routine.

Specified by:

run in interface Runnable

sendFrame

public void sendFrame(byte[] data,
                      int offset,
                      int length,
                      long presentationTimeUs)
               throws ArrayIndexOutOfBoundsException

Called by the app and encoder.

Specified by:

sendFrame in interface IVideoStreamListener

Parameters:

data - Byte array containing a video frame

offset - Starting offset in 'data'

length - Length of the data

presentationTimeUs - Presentation timestamp (PTS) of this frame, in microseconds. It must be greater than the previous timestamp. Specify -1 if unknown.

Throws:

ArrayIndexOutOfBoundsException - When offset does not satisfy 0 <= offset && offset <= data.length or length does not satisfy 0 < length && offset + length <= data.length

See Also:

IVideoStreamListener.sendFrame(byte[], int, int, long)

sendFrame

public void sendFrame(ByteBuffer data,
                      long presentationTimeUs)

Called by the app and encoder.

Specified by:

sendFrame in interface IVideoStreamListener

Parameters:

data - Data chunk to send. Its position will be updated upon return.

presentationTimeUs - Presentation timestamp (PTS) of this frame, in microseconds. It must be greater than the previous timestamp. Specify -1 if unknown.

See Also:

IVideoStreamListener.sendFrame(ByteBuffer, long)