Class UdpDataSource
- java.lang.Object
-
- com.google.android.exoplayer2.upstream.BaseDataSource
-
- com.google.android.exoplayer2.upstream.UdpDataSource
-
- All Implemented Interfaces:
DataReader,DataSource
@Deprecated public final class UdpDataSource extends BaseDataSource
Deprecated.com.google.android.exoplayer2 is deprecated. Please migrate to androidx.media3 (which contains the same ExoPlayer code). See the migration guide for more details, including a script to help with the migration.A UDPDataSource.
-
-
Nested Class Summary
Nested Classes Modifier and Type Class Description static classUdpDataSource.UdpDataSourceExceptionDeprecated.Thrown when an error is encountered when trying to read from aUdpDataSource.-
Nested classes/interfaces inherited from interface com.google.android.exoplayer2.upstream.DataSource
DataSource.Factory
-
-
Field Summary
Fields Modifier and Type Field Description static intDEFAULT_MAX_PACKET_SIZEDeprecated.The default maximum datagram packet size, in bytes.static intDEFAULT_SOCKET_TIMEOUT_MILLISDeprecated.The default socket timeout, in milliseconds.static intUDP_PORT_UNSETDeprecated.
-
Constructor Summary
Constructors Constructor Description UdpDataSource()Deprecated.UdpDataSource(int maxPacketSize)Deprecated.Constructs a new instance.UdpDataSource(int maxPacketSize, int socketTimeoutMillis)Deprecated.Constructs a new instance.
-
Method Summary
All Methods Instance Methods Concrete Methods Deprecated Methods Modifier and Type Method Description voidclose()Deprecated.Closes the source.intgetLocalPort()Deprecated.Returns the local port number opened for the UDP connection, orUDP_PORT_UNSETif no connection is openUrigetUri()Deprecated.When the source is open, returns theUrifrom which data is being read.longopen(DataSpec dataSpec)Deprecated.Opens the source to read the specified data.intread(byte[] buffer, int offset, int length)Deprecated.Reads up tolengthbytes of data from the input.-
Methods inherited from class com.google.android.exoplayer2.upstream.BaseDataSource
addTransferListener, bytesTransferred, transferEnded, transferInitializing, transferStarted
-
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
-
Methods inherited from interface com.google.android.exoplayer2.upstream.DataSource
getResponseHeaders
-
-
-
-
Field Detail
-
DEFAULT_MAX_PACKET_SIZE
public static final int DEFAULT_MAX_PACKET_SIZE
Deprecated.The default maximum datagram packet size, in bytes.- See Also:
- Constant Field Values
-
DEFAULT_SOCKET_TIMEOUT_MILLIS
public static final int DEFAULT_SOCKET_TIMEOUT_MILLIS
Deprecated.The default socket timeout, in milliseconds.- See Also:
- Constant Field Values
-
UDP_PORT_UNSET
public static final int UDP_PORT_UNSET
Deprecated.- See Also:
- Constant Field Values
-
-
Constructor Detail
-
UdpDataSource
public UdpDataSource()
Deprecated.
-
UdpDataSource
public UdpDataSource(int maxPacketSize)
Deprecated.Constructs a new instance.- Parameters:
maxPacketSize- The maximum datagram packet size, in bytes.
-
UdpDataSource
public UdpDataSource(int maxPacketSize, int socketTimeoutMillis)Deprecated.Constructs a new instance.- Parameters:
maxPacketSize- The maximum datagram packet size, in bytes.socketTimeoutMillis- The socket timeout in milliseconds. A timeout of zero is interpreted as an infinite timeout.
-
-
Method Detail
-
open
public long open(DataSpec dataSpec) throws UdpDataSource.UdpDataSourceException
Deprecated.Description copied from interface:DataSourceOpens the source to read the specified data. If anIOExceptionis thrown, callers must still callDataSource.close()to ensure that any partial effects of the invocation are cleaned up.The following edge case behaviors apply:
- If the
requested positionis within the resource, but therequested lengthextends beyond the end of the resource, thenDataSource.open(com.google.android.exoplayer2.upstream.DataSpec)will succeed and data from the requested position to the end of the resource will be made available throughDataReader.read(byte[], int, int). - If the
requested positionis equal to the length of the resource, thenDataSource.open(com.google.android.exoplayer2.upstream.DataSpec)will succeed, andDataReader.read(byte[], int, int)will immediately returnC.RESULT_END_OF_INPUT. - If the
requested positionis greater than the length of the resource, thenDataSource.open(com.google.android.exoplayer2.upstream.DataSpec)will throw anIOExceptionfor whichDataSourceException.isCausedByPositionOutOfRange(java.io.IOException)will betrue.
- Parameters:
dataSpec- Defines the data to be read.- Returns:
- The number of bytes that can be read from the opened source. For unbounded requests
(i.e., requests where
DataSpec.lengthequalsC.LENGTH_UNSET) this value is the resolved length of the request, orC.LENGTH_UNSETif the length is still unresolved. For all other requests, the value returned will be equal to the request'sDataSpec.length. - Throws:
UdpDataSource.UdpDataSourceException
- If the
-
read
public int read(byte[] buffer, int offset, int length) throws UdpDataSource.UdpDataSourceExceptionDeprecated.Description copied from interface:DataReaderReads up tolengthbytes of data from the input.If
readLengthis zero then 0 is returned. Otherwise, if no data is available because the end of the opened range has been reached, thenC.RESULT_END_OF_INPUTis returned. Otherwise, the call will block until at least one byte of data has been read and the number of bytes read is returned.- Parameters:
buffer- A target array into which data should be written.offset- The offset into the target array at which to write.length- The maximum number of bytes to read from the input.- Returns:
- The number of bytes read, or
C.RESULT_END_OF_INPUTif the input has ended. This may be less thanlengthbecause the end of the input (or available data) was reached, the method was interrupted, or the operation was aborted early for another reason. - Throws:
UdpDataSource.UdpDataSourceException
-
getUri
@Nullable public Uri getUri()
Deprecated.Description copied from interface:DataSourceWhen the source is open, returns theUrifrom which data is being read. The returnedUriwill be identical to the one passedDataSource.open(DataSpec)in theDataSpecunless redirection has occurred. If redirection has occurred, theUriafter redirection is returned.- Returns:
- The
Urifrom which data is being read, or null if the source is not open.
-
close
public void close()
Deprecated.Description copied from interface:DataSourceCloses the source. This method must be called even if the corresponding call toDataSource.open(DataSpec)threw anIOException.
-
getLocalPort
public int getLocalPort()
Deprecated.Returns the local port number opened for the UDP connection, orUDP_PORT_UNSETif no connection is open
-
-