loliball/media3
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Fix outdated RtpDataLoadable javadoc

Browse Source 
PiperOrigin-RevId: 469443086
This commit is contained in:
claincly 2022-08-23 13:41:49 +00:00 committed by Marc Baechinger
parent 7e5dcf2360
commit b9bcf5224f
1 changed files with 13 additions and 7 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

20
libraries/exoplayer_rtsp/src/main/java/androidx/media3/exoplayer/rtsp/RtpDataLoadable.java
View File

@ -34,14 +34,20 @@ import java.io.IOException;
import org.checkerframework.checker.nullness.qual.MonotonicNonNull;
/**
* A {@link Loader.Loadable} that sets up a sockets listening to incoming RTP traffic, carried by
* UDP packets.
* A {@link Loader.Loadable} that uses two {@link RtpDataChannel} instances to listen on incoming
* RTP and RTCP packets.
*
* <p>Uses a {@link RtpDataChannel} to listen on incoming packets. The local UDP port is selected by
* the runtime on opening; it also opens another {@link RtpDataChannel} for RTCP on the RTP UDP port
* number plus one one. Pass a listener via constructor to receive a callback when the local port is
* opened. {@link #load} will throw an {@link IOException} if either of the two data channels fails
* to open.
* <ul>
* <li>When using UDP as RTP transport, the local RTP UDP port number is selected by the runtime
* on opening the first {@link RtpDataChannel}; the second {@link RtpDataChannel} for RTCP
* uses the port number that is the RTP UDP port number plus one.
* <li>When using TCP as RTP transport, the first {@link RtpDataChannel} for RTP uses the {@link
* #trackId} as its interleaved channel number; the second {@link RtpDataChannel} for RTCP
* uses the interleaved channel number that is the RTP interleaved channel number plus one.
* </ul>
*
* <p>Pass a listener via the constructor to receive a callback when the RTSP transport is ready.
* {@link #load} will throw an {@link IOException} if either of the two data channels fails to open.
*
* <p>Received RTP packets' payloads will be extracted by an {@link RtpExtractor}, and will be
* written to the {@link ExtractorOutput} instance provided at construction.