org.jitsi.service.neomedia.RTPTranslator Maven / Gradle / Ivy

Go to download
/*
 * 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 net.sf.fmj.media.rtp.*;
import org.jitsi.impl.neomedia.rtp.*;

import java.util.*;

/**
 * Represents an RTP translator which forwards RTP and RTCP traffic between
 * multiple MediaStreams.
 *
 * @author Lyubomir Marinov
 */
public interface RTPTranslator
{
    /**
     * Finds the {@code StreamRTPManager} which receives a specific SSRC.
     *
     * @param receiveSSRC the SSRC of the RTP stream received by the
     * {@code StreamRTPManager} to be returned
     * @return the {@code StreamRTPManager} which receives {@code receiveSSRC}
     * of {@code null}
     */
    public StreamRTPManager findStreamRTPManagerByReceiveSSRC(int receiveSSRC);

    /**
     * Returns a list of StreamRTPManagers currently attached to
     * this RTPTranslator. This is
     * admittedly wrong, to expose the bare SSRCCache to the use of
     * of the StreamRTPManager. We should find a better way of exposing
     * this information. Currently it is necessary for RTCP termination.
     *
     * @return a list of StreamRTPManagers currently attached to
     * this RTPTranslator.
     */
    public List getStreamRTPManagers();

    /**
     * Provides access to the underlying SSRCCache that holds
     * statistics information about each SSRC that we receive.
     *
     * @return the underlying SSRCCache that holds statistics
     * information about each SSRC that we receive.
     */
    public SSRCCache getSSRCCache();

    /**
     * Defines a packet filter which allows an observer of an
     * RTPTranslator to disallow the writing of specific packets into
     * a specific destination identified by a MediaStream.
     */
    public interface WriteFilter
    {
        public boolean accept(
                MediaStream source,
                RawPacket pkt,
                MediaStream destination,
                boolean data);
    }

    /**
     * Adds a WriteFilter to this RTPTranslator.
     *
     * @param writeFilter the WriteFilter to add to this
     * RTPTranslator
     */
    public void addWriteFilter(WriteFilter writeFilter);

    /**
     * Releases the resources allocated by this instance in the course of its
     * execution and prepares it to be garbage collected.
     */
    public void dispose();

    /**
     * Removes a WriteFilter from this RTPTranslator.
     *
     * @param writeFilter the WriteFilter to remove from this
     * RTPTranslator
     */
    public void removeWriteFilter(WriteFilter writeFilter);
}