Added in API level 28

Summary: Constants | Methods | Inherited Methods

StreamingService

Kotlin |Java

public class StreamingService
extends Object implements AutoCloseable

java.lang.Object
↳	android.telephony.mbms.StreamingService

Class used to represent a single MBMS stream. After a stream has been started with MbmsStreamingSession#startStreaming(StreamingServiceInfo, java.util.concurrent.Executor, StreamingServiceCallback), this class is used to hold information about the stream and control it.

Summary

Constants
`int`	`BROADCAST_METHOD` The method of transmission currently used for a stream, reported via `StreamingServiceCallback#onStreamMethodUpdated`
`int`	`REASON_BY_USER_REQUEST` State changed due to a call to `close()` or `MbmsStreamingSession#startStreaming(StreamingServiceInfo, java.util.concurrent.Executor, StreamingServiceCallback)`
`int`	`REASON_END_OF_SESSION` State changed due to the streaming session ending at the carrier.
`int`	`REASON_FREQUENCY_CONFLICT` State changed due to a frequency conflict with another requested stream.
`int`	`REASON_LEFT_MBMS_BROADCAST_AREA` State changed due to the device leaving the where this stream is being broadcast.
`int`	`REASON_NONE` Indicates that the middleware does not have a reason to provide for the state change.
`int`	`REASON_NOT_CONNECTED_TO_HOMECARRIER_LTE` State changed due to the device leaving the home carrier's LTE network.
`int`	`REASON_OUT_OF_MEMORY` State changed due to the middleware running out of memory
`int`	`STATE_STALLED`
`int`	`STATE_STARTED`
`int`	`STATE_STOPPED`
`int`	`UNICAST_METHOD`

Public methods
`void`	`close()` Stop streaming this service.
`StreamingServiceInfo`	`getInfo()` Retrieve the `StreamingServiceInfo` corresponding to this stream.
`Uri`	`getPlaybackUri()` Retrieve the Uri used to play this stream.

Inherited methods

From class


        
          java.lang.Object

`Object`	`clone()` Creates and returns a copy of this object.
`boolean`	`equals(Object obj)` Indicates whether some other object is "equal to" this one.
`void`	`finalize()` Called by the garbage collector on an object when garbage collection determines that there are no more references to the object.
`final Class<?>`	`getClass()` Returns the runtime class of this `Object`.
`int`	`hashCode()` Returns a hash code value for the object.
`final void`	`notify()` Wakes up a single thread that is waiting on this object's monitor.
`final void`	`notifyAll()` Wakes up all threads that are waiting on this object's monitor.
`String`	`toString()` Returns a string representation of the object.
`final void`	`wait(long timeoutMillis, int nanos)` Causes the current thread to wait until it is awakened, typically by being notified or interrupted, or until a certain amount of real time has elapsed.
`final void`	`wait(long timeoutMillis)` Causes the current thread to wait until it is awakened, typically by being notified or interrupted, or until a certain amount of real time has elapsed.
`final void`	`wait()` Causes the current thread to wait until it is awakened, typically by being notified or interrupted.

From interface


        
          java.lang.AutoCloseable


      close()

Closes this resource, relinquishing any underlying resources.

Constants

BROADCAST_METHOD

Added in API level 28

public static final int BROADCAST_METHOD

The method of transmission currently used for a stream, reported via StreamingServiceCallback#onStreamMethodUpdated

Constant Value: 1 (0x00000001)

REASON_BY_USER_REQUEST

Added in API level 28

public static final int REASON_BY_USER_REQUEST

State changed due to a call to close() or MbmsStreamingSession#startStreaming(StreamingServiceInfo, java.util.concurrent.Executor, StreamingServiceCallback)

Constant Value: 1 (0x00000001)

REASON_END_OF_SESSION

Added in API level 28

public static final int REASON_END_OF_SESSION

State changed due to the streaming session ending at the carrier.

Constant Value: 2 (0x00000002)

REASON_FREQUENCY_CONFLICT

Added in API level 28

public static final int REASON_FREQUENCY_CONFLICT

State changed due to a frequency conflict with another requested stream.

Constant Value: 3 (0x00000003)

REASON_LEFT_MBMS_BROADCAST_AREA

Added in API level 28

public static final int REASON_LEFT_MBMS_BROADCAST_AREA

State changed due to the device leaving the where this stream is being broadcast.

Constant Value: 6 (0x00000006)

REASON_NONE

Added in API level 28

public static final int REASON_NONE

Indicates that the middleware does not have a reason to provide for the state change.

Constant Value: 0 (0x00000000)

REASON_NOT_CONNECTED_TO_HOMECARRIER_LTE

Added in API level 28

public static final int REASON_NOT_CONNECTED_TO_HOMECARRIER_LTE

State changed due to the device leaving the home carrier's LTE network.

Constant Value: 5 (0x00000005)

REASON_OUT_OF_MEMORY

Added in API level 28

public static final int REASON_OUT_OF_MEMORY

State changed due to the middleware running out of memory

Constant Value: 4 (0x00000004)

STATE_STALLED

Added in API level 28

public static final int STATE_STALLED

Constant Value: 3 (0x00000003)

STATE_STARTED

Added in API level 28

public static final int STATE_STARTED

Constant Value: 2 (0x00000002)

STATE_STOPPED

Added in API level 28

public static final int STATE_STOPPED

Constant Value: 1 (0x00000001)

UNICAST_METHOD

Added in API level 28

public static final int UNICAST_METHOD

Constant Value: 2 (0x00000002)

Public methods

close

Added in API level 28

public void close ()

Stop streaming this service. Further operations on this object will fail with an IllegalStateException. May throw an IllegalArgumentException or an IllegalStateException

getInfo

Added in API level 28

public StreamingServiceInfo getInfo ()

Retrieve the StreamingServiceInfo corresponding to this stream.

Returns
`StreamingServiceInfo`

getPlaybackUri

Added in API level 28

public Uri getPlaybackUri ()

Retrieve the Uri used to play this stream. May throw an IllegalArgumentException or an IllegalStateException.

Returns
`Uri`	The `Uri` to pass to the streaming client, or `null` if an error occurred.