GroupCall

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

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.