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 |
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 |
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
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
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
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
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
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
public static final int REASON_OUT_OF_MEMORY
State changed due to the middleware running out of memory
Constant Value: 4 (0x00000004)
STATE_STALLED
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
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
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
public void close ()
Stop this group call. Further operations on this object will fail with an
IllegalStateException
.
May throw an IllegalStateException
getTmgi
public long getTmgi ()
Retrieve the TMGI (Temporary Mobile Group Identity) corresponding to this call.
Returns | |
---|---|
long |
updateGroupCall
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 . |