CronetDataSourceFactory

Artifact: androidx.media3:media3-datasource-cronet

Kotlin |Java

@UnstableApi
public final class CronetDataSourceFactory extends HttpDataSource.BaseFactory

java.lang.Object
↳	androidx.media3.datasource.HttpDataSource.BaseFactory
	↳	androidx.media3.datasource.cronet.CronetDataSourceFactory

Summary

Constants
`static final int`	`DEFAULT_CONNECT_TIMEOUT_MILLIS = 8000` The default connection timeout, in milliseconds.
`static final int`	`DEFAULT_READ_TIMEOUT_MILLIS = 8000` The default read timeout, in milliseconds.

Public constructors
`CronetDataSourceFactory( CronetEngineWrapper cronetEngineWrapper, Executor executor )` Creates an instance.
`CronetDataSourceFactory( CronetEngineWrapper cronetEngineWrapper, Executor executor, HttpDataSource.Factory fallbackFactory )` Creates an instance.
`CronetDataSourceFactory( CronetEngineWrapper cronetEngineWrapper, Executor executor, @Nullable TransferListener transferListener )` Creates an instance.
`CronetDataSourceFactory( CronetEngineWrapper cronetEngineWrapper, Executor executor, @Nullable String userAgent )` Creates an instance.
`CronetDataSourceFactory( CronetEngineWrapper cronetEngineWrapper, Executor executor, @Nullable TransferListener transferListener, HttpDataSource.Factory fallbackFactory )` Creates an instance.
`CronetDataSourceFactory( CronetEngineWrapper cronetEngineWrapper, Executor executor, @Nullable TransferListener transferListener, @Nullable String userAgent )` Creates an instance.
`CronetDataSourceFactory( CronetEngineWrapper cronetEngineWrapper, Executor executor, int connectTimeoutMs, int readTimeoutMs, boolean resetTimeoutOnRedirects, HttpDataSource.Factory fallbackFactory )` Creates an instance.
`CronetDataSourceFactory( CronetEngineWrapper cronetEngineWrapper, Executor executor, int connectTimeoutMs, int readTimeoutMs, boolean resetTimeoutOnRedirects, @Nullable String userAgent )` Creates an instance.
`CronetDataSourceFactory( CronetEngineWrapper cronetEngineWrapper, Executor executor, @Nullable TransferListener transferListener, int connectTimeoutMs, int readTimeoutMs, boolean resetTimeoutOnRedirects, HttpDataSource.Factory fallbackFactory )` Creates an instance.
`CronetDataSourceFactory( CronetEngineWrapper cronetEngineWrapper, Executor executor, @Nullable TransferListener transferListener, int connectTimeoutMs, int readTimeoutMs, boolean resetTimeoutOnRedirects, @Nullable String userAgent )` Creates an instance.

Protected methods
`HttpDataSource`	`createDataSourceInternal( HttpDataSource.RequestProperties defaultRequestProperties )` Called by createDataSource to create a `HttpDataSource` instance.

Inherited methods

From androidx.media3.datasource.DataSource.Factory

abstract DataSource

@UnstableApi
createDataSource()

Creates a DataSource instance.

From androidx.media3.datasource.HttpDataSource.BaseFactory

`final HttpDataSource`	`createDataSource()` Creates a `DataSource` instance.
`final HttpDataSource.Factory`	`@CanIgnoreReturnValue setDefaultRequestProperties( Map<String, String> defaultRequestProperties )` Sets the default request headers for `HttpDataSource` instances created by the factory.

Constants

DEFAULT_CONNECT_TIMEOUT_MILLIS

public static final int DEFAULT_CONNECT_TIMEOUT_MILLIS = 8000

The default connection timeout, in milliseconds.

DEFAULT_READ_TIMEOUT_MILLIS

public static final int DEFAULT_READ_TIMEOUT_MILLIS = 8000

The default read timeout, in milliseconds.

Public constructors

CronetDataSourceFactory

public CronetDataSourceFactory(
    CronetEngineWrapper cronetEngineWrapper,
    Executor executor
)

Creates an instance.

If the CronetEngineWrapper fails to provide a CronetEngine, a will be used instead.

Sets DEFAULT_CONNECT_TIMEOUT_MILLIS as the connection timeout, DEFAULT_READ_TIMEOUT_MILLIS as the read timeout.

Parameters
`CronetEngineWrapper cronetEngineWrapper`	A `CronetEngineWrapper`.
`Executor executor`	The `java.util.concurrent.Executor` that will perform the requests.

CronetDataSourceFactory

public CronetDataSourceFactory(
    CronetEngineWrapper cronetEngineWrapper,
    Executor executor,
    HttpDataSource.Factory fallbackFactory
)

Creates an instance.

If the CronetEngineWrapper fails to provide a CronetEngine, the provided fallback HttpDataSource.Factory will be used instead.

Sets DEFAULT_CONNECT_TIMEOUT_MILLIS as the connection timeout, DEFAULT_READ_TIMEOUT_MILLIS as the read timeout.

Parameters
`CronetEngineWrapper cronetEngineWrapper`	A `CronetEngineWrapper`.
`Executor executor`	The `java.util.concurrent.Executor` that will perform the requests.
`HttpDataSource.Factory fallbackFactory`	A `HttpDataSource.Factory` which is used as a fallback in case no suitable CronetEngine can be build.

CronetDataSourceFactory

public CronetDataSourceFactory(
    CronetEngineWrapper cronetEngineWrapper,
    Executor executor,
    @Nullable TransferListener transferListener
)

Creates an instance.

If the CronetEngineWrapper fails to provide a CronetEngine, a will be used instead.

Sets DEFAULT_CONNECT_TIMEOUT_MILLIS as the connection timeout, DEFAULT_READ_TIMEOUT_MILLIS as the read timeout.

Parameters
`CronetEngineWrapper cronetEngineWrapper`	A `CronetEngineWrapper`.
`Executor executor`	The `java.util.concurrent.Executor` that will perform the requests.
`@Nullable TransferListener transferListener`	An optional listener.

CronetDataSourceFactory

public CronetDataSourceFactory(
    CronetEngineWrapper cronetEngineWrapper,
    Executor executor,
    @Nullable String userAgent
)

Creates an instance.

If the CronetEngineWrapper fails to provide a CronetEngine, a will be used instead.

Sets DEFAULT_CONNECT_TIMEOUT_MILLIS as the connection timeout, DEFAULT_READ_TIMEOUT_MILLIS as the read timeout.

Parameters
`CronetEngineWrapper cronetEngineWrapper`	A `CronetEngineWrapper`.
`Executor executor`	The `java.util.concurrent.Executor` that will perform the requests.
`@Nullable String userAgent`	The user agent that will be used by the fallback `HttpDataSource` if needed, or `null` for the fallback to use the default user agent of the underlying platform.

CronetDataSourceFactory

public CronetDataSourceFactory(
    CronetEngineWrapper cronetEngineWrapper,
    Executor executor,
    @Nullable TransferListener transferListener,
    HttpDataSource.Factory fallbackFactory
)

Creates an instance.

If the CronetEngineWrapper fails to provide a CronetEngine, the provided fallback HttpDataSource.Factory will be used instead.

Sets DEFAULT_CONNECT_TIMEOUT_MILLIS as the connection timeout, DEFAULT_READ_TIMEOUT_MILLIS as the read timeout.

Parameters
`CronetEngineWrapper cronetEngineWrapper`	A `CronetEngineWrapper`.
`Executor executor`	The `java.util.concurrent.Executor` that will perform the requests.
`@Nullable TransferListener transferListener`	An optional listener.
`HttpDataSource.Factory fallbackFactory`	A `HttpDataSource.Factory` which is used as a fallback in case no suitable CronetEngine can be build.

CronetDataSourceFactory

public CronetDataSourceFactory(
    CronetEngineWrapper cronetEngineWrapper,
    Executor executor,
    @Nullable TransferListener transferListener,
    @Nullable String userAgent
)

Creates an instance.

If the CronetEngineWrapper fails to provide a CronetEngine, a will be used instead.

Sets DEFAULT_CONNECT_TIMEOUT_MILLIS as the connection timeout, DEFAULT_READ_TIMEOUT_MILLIS as the read timeout.

Parameters
`CronetEngineWrapper cronetEngineWrapper`	A `CronetEngineWrapper`.
`Executor executor`	The `java.util.concurrent.Executor` that will perform the requests.
`@Nullable TransferListener transferListener`	An optional listener.
`@Nullable String userAgent`	The user agent that will be used by the fallback `HttpDataSource` if needed, or `null` for the fallback to use the default user agent of the underlying platform.

CronetDataSourceFactory

public CronetDataSourceFactory(
    CronetEngineWrapper cronetEngineWrapper,
    Executor executor,
    int connectTimeoutMs,
    int readTimeoutMs,
    boolean resetTimeoutOnRedirects,
    HttpDataSource.Factory fallbackFactory
)

Creates an instance.

If the CronetEngineWrapper fails to provide a CronetEngine, the provided fallback HttpDataSource.Factory will be used instead.

Parameters
`CronetEngineWrapper cronetEngineWrapper`	A `CronetEngineWrapper`.
`Executor executor`	The `java.util.concurrent.Executor` that will perform the requests.
`int connectTimeoutMs`	The connection timeout, in milliseconds.
`int readTimeoutMs`	The read timeout, in milliseconds.
`boolean resetTimeoutOnRedirects`	Whether the connect timeout is reset when a redirect occurs.
`HttpDataSource.Factory fallbackFactory`	A `HttpDataSource.Factory` which is used as a fallback in case no suitable CronetEngine can be build.

CronetDataSourceFactory

public CronetDataSourceFactory(
    CronetEngineWrapper cronetEngineWrapper,
    Executor executor,
    int connectTimeoutMs,
    int readTimeoutMs,
    boolean resetTimeoutOnRedirects,
    @Nullable String userAgent
)

Creates an instance.

If the CronetEngineWrapper fails to provide a CronetEngine, a will be used instead.

Parameters
`CronetEngineWrapper cronetEngineWrapper`	A `CronetEngineWrapper`.
`Executor executor`	The `java.util.concurrent.Executor` that will perform the requests.
`int connectTimeoutMs`	The connection timeout, in milliseconds.
`int readTimeoutMs`	The read timeout, in milliseconds.
`boolean resetTimeoutOnRedirects`	Whether the connect timeout is reset when a redirect occurs.
`@Nullable String userAgent`	The user agent that will be used by the fallback `HttpDataSource` if needed, or `null` for the fallback to use the default user agent of the underlying platform.

CronetDataSourceFactory

public CronetDataSourceFactory(
    CronetEngineWrapper cronetEngineWrapper,
    Executor executor,
    @Nullable TransferListener transferListener,
    int connectTimeoutMs,
    int readTimeoutMs,
    boolean resetTimeoutOnRedirects,
    HttpDataSource.Factory fallbackFactory
)

Creates an instance.

If the CronetEngineWrapper fails to provide a CronetEngine, the provided fallback HttpDataSource.Factory will be used instead.

Parameters
`CronetEngineWrapper cronetEngineWrapper`	A `CronetEngineWrapper`.
`Executor executor`	The `java.util.concurrent.Executor` that will perform the requests.
`@Nullable TransferListener transferListener`	An optional listener.
`int connectTimeoutMs`	The connection timeout, in milliseconds.
`int readTimeoutMs`	The read timeout, in milliseconds.
`boolean resetTimeoutOnRedirects`	Whether the connect timeout is reset when a redirect occurs.
`HttpDataSource.Factory fallbackFactory`	A `HttpDataSource.Factory` which is used as a fallback in case no suitable CronetEngine can be build.

CronetDataSourceFactory

public CronetDataSourceFactory(
    CronetEngineWrapper cronetEngineWrapper,
    Executor executor,
    @Nullable TransferListener transferListener,
    int connectTimeoutMs,
    int readTimeoutMs,
    boolean resetTimeoutOnRedirects,
    @Nullable String userAgent
)

Creates an instance.

If the CronetEngineWrapper fails to provide a CronetEngine, a will be used instead.

Parameters
`CronetEngineWrapper cronetEngineWrapper`	A `CronetEngineWrapper`.
`Executor executor`	The `java.util.concurrent.Executor` that will perform the requests.
`@Nullable TransferListener transferListener`	An optional listener.
`int connectTimeoutMs`	The connection timeout, in milliseconds.
`int readTimeoutMs`	The read timeout, in milliseconds.
`boolean resetTimeoutOnRedirects`	Whether the connect timeout is reset when a redirect occurs.
`@Nullable String userAgent`	The user agent that will be used by the fallback `HttpDataSource` if needed, or `null` for the fallback to use the default user agent of the underlying platform.

Protected methods

createDataSourceInternal

protected HttpDataSource createDataSourceInternal(
    HttpDataSource.RequestProperties defaultRequestProperties
)

Called by createDataSource to create a HttpDataSource instance.

Parameters
`HttpDataSource.RequestProperties defaultRequestProperties`	The default `RequestProperties` to be used by the `HttpDataSource` instance.

Returns
`HttpDataSource`	A `HttpDataSource` instance.