MbmsGroupCallSessionCallback
interface MbmsGroupCallSessionCallback
| android.telephony.mbms.MbmsGroupCallSessionCallback |
A callback class that is used to receive information from the middleware on MBMS group-call services. An instance of this object should be passed into MbmsGroupCallSession#create(Context, int, Executor, MbmsGroupCallSessionCallback).
Summary
| Public methods | |
|---|---|
| open Unit |
onAvailableSaisUpdated(currentSais: MutableList<Int!>, availableSais: MutableList<MutableList<Int!>!>)Indicates that the list of currently available SAIs has been updated. |
| open Unit |
Called by the middleware when it has detected an error condition. |
| open Unit |
Called to indicate that the middleware has been initialized and is ready. |
| open Unit |
onServiceInterfaceAvailable(interfaceName: String, index: Int)Called soon after the app calls android. |
Public methods
onAvailableSaisUpdated
open fun onAvailableSaisUpdated(
currentSais: MutableList<Int!>,
availableSais: MutableList<MutableList<Int!>!>
): Unit
Indicates that the list of currently available SAIs has been updated. The app may use this information to filter the list of group calls when displaying available group calls to the user by matching the SAIs with a list of group calls separately negotiated with the carrier. The app may also report the aggregate list of SAIs to the group call application server so that a network entity can determine when, and where to activate the broadcast of particular group calls.
| Parameters | |
|---|---|
currentSais |
MutableList<Int!>: The available SAIs on the current cell. This value cannot be null. |
availableSais |
MutableList<MutableList<Int!>!>: A list of lists of available SAIS in neighboring cells, where each list contains the available SAIs in an individual cell. This value cannot be null. |
onError
open fun onError(
errorCode: Int,
message: String?
): Unit
Called by the middleware when it has detected an error condition. The possible error codes are listed in MbmsErrors.
onMiddlewareReady
open fun onMiddlewareReady(): Unit
Called to indicate that the middleware has been initialized and is ready. Before this method is called, calling any method on an instance of MbmsGroupCallSession will result in an IllegalStateException or an error delivered via onError(int,java.lang.String) with error code MbmsErrors.GeneralErrors#ERROR_MIDDLEWARE_NOT_YET_READY.
onServiceInterfaceAvailable
open fun onServiceInterfaceAvailable(
interfaceName: String,
index: Int
): Unit
Called soon after the app calls android.telephony.MbmsGroupCallSession#create. The information supplied via this callback may be used to establish a data-link interface with the modem. In order to establish the data-link interface, the multicast IP and port must be obtained out-of-band from the carrier. A java.net.MulticastSocket may then be constructed using a java.net.NetworkInterface with the name and interface supplied by this callback.
| Parameters | |
|---|---|
interfaceName |
String: The interface name for the data link. This value cannot be null. |
index |
Int: The index for the data link. |