org.jitsi.service.neomedia.RTPExtension Maven / Gradle / Ivy
/*
* Copyright @ 2015 Atlassian Pty Ltd
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package org.jitsi.service.neomedia;
import java.net.*;
/**
* RTP extensions are defined by RFC 5285 and they allow attaching additional
* information to some or all RTP packets of an RTP stream. This class describes
* RTP extensions in a way that makes them convenient for use in SDP
* generation/parsing.
*
* @author Emil Ivov
*/
public class RTPExtension
{
/**
* The URN identifying the RTP extension that allows mixers to send to
* conference participants the audio levels of all contributing sources.
* Defined in RFC6465.
*/
public static final String CSRC_AUDIO_LEVEL_URN
= "urn:ietf:params:rtp-hdrext:csrc-audio-level";
/**
* The URN identifying the RTP extension that allows clients to send to
* conference mixers the audio level of their packet payload. Defined in
* RFC6464.
*/
public static final String SSRC_AUDIO_LEVEL_URN
= "urn:ietf:params:rtp-hdrext:ssrc-audio-level";
/**
* The URN identifying the abs-send-time RTP extension.
* Defined at
* abs-send-time
*/
public static final String ABS_SEND_TIME_URN
= "http://www.webrtc.org/experiments/rtp-hdrext/abs-send-time";
/**
* The URN which identifies the framemarking RTP extension defined at
* draft-ietf-avtext-framemarking-03
*/
public static final String FRAME_MARKING_URN
= "http://tools.ietf.org/html/draft-ietf-avtext-framemarking-07";
/**
* The URN which identifies the Original Header Block RTP extension defined
* in draft-ietf-perc-double-02.
*/
public static final String ORIGINAL_HEADER_BLOCK_URN
= "urn:ietf:params:rtp-hdrext:ohb";
/**
* The URN which identifies the Transport-Wide Congestion Control RTP
* extension.
*/
public static final String TRANSPORT_CC_URN
= "http://www.ietf.org/id/draft-holmer-rmcat-transport-wide-cc-extensions-01";
/**
* The URN which identifies the rtp-stream-id extensions
* in draft-ietf-mmusic-rid-10.
*/
public static final String RTP_STREAM_ID_URN
= "urn:ietf:params:rtp-hdrext:sdes:rtp-stream-id";
/**
* The URN which identifies the transmission time-offset extensions
* in rfc5450.
*/
public static final String TOF_URN = "urn:ietf:params:rtp-hdrext:toffset";
/**
* The URN which identifies the RTP Header Extension for Video Content Type.
*/
public static final String VIDEO_CONTENT_TYPE_URN
= "http://www.webrtc.org/experiments/rtp-hdrext/video-content-type";
/**
* The direction that this extension will be transmitted in.
*/
private MediaDirection direction = MediaDirection.SENDRECV;
/**
* The URI identifier of this extension.
*/
private final URI extensionURI;
/**
* Extension specific attributes.
*/
private String extensionAttributes = null;
/**
* Creates an RTPExtension instance for the specified
* extensionURI using a default SENDRECV direction and no
* extension attributes.
*
* @param extensionURI the URI (possibly a URN) of the RTP
* extension that we'd like to create.
*/
public RTPExtension(URI extensionURI)
{
this(extensionURI, MediaDirection.SENDRECV);
}
/**
* Creates an RTPExtension instance for the specified
* extensionURI and direction.
*
* @param extensionURI the URI (possibly a URN) of the RTP
* extension that we'd like to create.
* @param direction a MediaDirection instance indication how this
* extension will be transmitted.
*/
public RTPExtension(URI extensionURI, MediaDirection direction)
{
this(extensionURI, direction, null);
}
/**
* Creates an RTPExtension instance for the specified
* extensionURI using a default SENDRECV direction and
* extensionAttributes.
*
* @param extensionURI the URI (possibly a URN) of the RTP
* extension that we'd like to create.
* @param extensionAttributes any attributes that we'd like to add to this
* extension.
*/
public RTPExtension(URI extensionURI, String extensionAttributes)
{
this(extensionURI, MediaDirection.SENDRECV, extensionAttributes);
}
/**
* Creates an RTPExtension instance for the specified
* extensionURI and direction and sets the specified
* extensionAttributes.
*
* @param extensionURI the URI (possibly a URN) of the RTP
* extension that we'd like to create.
* @param direction a MediaDirection instance indication how this
* extension will be transmitted.
* @param extensionAttributes any attributes that we'd like to add to this
* extension.
*/
public RTPExtension(URI extensionURI,
MediaDirection direction,
String extensionAttributes)
{
this.extensionURI = extensionURI;
this.direction = direction;
this.extensionAttributes = extensionAttributes;
}
/**
* Returns the direction that the corresponding MediaDevice
* supports for this extension. By default RTP extension headers inherit
* the direction of a stream. When explicitly specified SENDONLY
* direction indicates an ability to attach the extension in outgoing RTP
* packets; a RECVONLY direction indicates a desire to receive
* the extension in incoming packets; a SENDRECV direction
* indicates both. An INACTIVE direction indicates neither, but
* later re-negotiation may make an extension active.
*
* @return the direction that the corresponding MediaDevice
* supports for this extension.
*/
public MediaDirection getDirection()
{
return direction;
}
/**
* Returns the URI that identifies the format and meaning of this
* extension.
*
* @return the URI (possibly a URN) that identifies the format and
* meaning of this extension.
*/
public URI getURI()
{
return extensionURI;
}
/**
* Returns the extension attributes associated with this
* RTPExtension or null if this extension does not have
* any.
*
* @return A String containing the extension attributes associated
* with this RTPExtension or null if this extension does
* not have any.
*/
public String getExtensionAttributes()
{
return extensionAttributes;
}
/**
* Returns a String representation of this RTPExtension's
* URI.
*
* @return a String representation of this RTPExtension's
* URI.
*/
@Override
public String toString()
{
return extensionURI.toString() + ";" + getDirection();
}
/**
* Returns true if and only if o is an instance of
* RTPExtension and o's URI is equal to this
* extension's URI. The method returns false otherwise.
*
* @param o the Object that we'd like to compare to this
* RTPExtension.
*
* @return true when o's URI is equal to this
* extension's URI and false otherwise.
*/
@Override
public boolean equals(Object o)
{
return (o instanceof RTPExtension)
&& ((RTPExtension)o).getURI().equals(getURI());
}
/**
* Returns the hash code of this extension instance which is actually the
* hash code of the URI that this extension is encapsulating.
*
* @return the hash code of this extension instance which is actually the
* hash code of the URI that this extension is encapsulating.
*/
@Override
public int hashCode()
{
return getURI().hashCode();
}
}
© 2015 - 2025 Weber Informatics LLC | Privacy Policy