Added in API level 29

Summary: Constants | Methods | Inherited Methods

GroupCall

Kotlin |Java

public class GroupCall
extends Object implements AutoCloseable

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

Class used to represent a single MBMS group call. After a call has been started with MbmsGroupCallSession#startGroupCall, this class is used to hold information about the call and control it.

Summary

Constants
`int`	`REASON_BY_USER_REQUEST` State changed due to a call to `close()` or `MbmsGroupCallSession#startGroupCall`
`int`	`REASON_FREQUENCY_CONFLICT` State changed due to a frequency conflict with another requested call.
`int`	`REASON_LEFT_MBMS_BROADCAST_AREA` State changed due to the device leaving the area where this call 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` Indicates that the group call is stalled.
`int`	`STATE_STARTED` Indicates that the group call is started.
`int`	`STATE_STOPPED` Indicates that the group call is in a stopped state This can be reported after network action or after calling `close()`.

Public methods
`void`	`close()` Stop this group call.
`long`	`getTmgi()` Retrieve the TMGI (Temporary Mobile Group Identity) corresponding to this call.
`void`	`updateGroupCall(List<Integer> saiList, List<Integer> frequencyList)` Send an update to the middleware when the SAI (Service Area Identifier) list and frequency information of the group call has * changed.

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

REASON_BY_USER_REQUEST

Added in API level 29

public static final int REASON_BY_USER_REQUEST

State changed due to a call to close() or MbmsGroupCallSession#startGroupCall

Constant Value: 1 (0x00000001)

REASON_FREQUENCY_CONFLICT

Added in API level 29

public static final int REASON_FREQUENCY_CONFLICT

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

Constant Value: 3 (0x00000003)

REASON_LEFT_MBMS_BROADCAST_AREA

Added in API level 29

public static final int REASON_LEFT_MBMS_BROADCAST_AREA

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

Constant Value: 6 (0x00000006)

REASON_NONE

Added in API level 29

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 29

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 29

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 29

public static final int STATE_STALLED

Indicates that the group call is stalled. This may be due to a network issue or the device being temporarily out of range.

Constant Value: 3 (0x00000003)

STATE_STARTED

Added in API level 29

public static final int STATE_STARTED

Indicates that the group call is started. Data can be transmitted and received in this state.

Constant Value: 2 (0x00000002)

STATE_STOPPED

Added in API level 29

public static final int STATE_STOPPED

Indicates that the group call is in a stopped state This can be reported after network action or after calling close().

Constant Value: 1 (0x00000001)

Public methods

close

Added in API level 29

public void close ()

Stop this group call. Further operations on this object will fail with an IllegalStateException. May throw an IllegalStateException

getTmgi

Added in API level 29

public long getTmgi ()

Retrieve the TMGI (Temporary Mobile Group Identity) corresponding to this call.

Returns
`long`

updateGroupCall

Added in API level 29

public void updateGroupCall (List<Integer> saiList, 
                List<Integer> frequencyList)

Send an update to the middleware when the SAI (Service Area Identifier) list and frequency information of the group call has * changed. Callers must obtain this information from the wireless carrier independently.

Parameters
`saiList`	`List`: New list of SAIs that the call is available on. This value cannot be `null`.
`frequencyList`	`List`: New list of frequencies that the call is available on. This value cannot be `null`.