File	Doc	Category	Size	Date	Package
SmsCbMessage.java	API Doc	Android 5.1 API	15332	Thu Mar 12 22:22:54 GMT 2015	android.telephony

SmsCbMessage

• java.lang.Object

Fields Summary
protected static final String	LOG_TAG
public static final int	GEOGRAPHICAL_SCOPE_CELL_WIDE_IMMEDIATE Cell wide geographical scope with immediate display (GSM/UMTS only).
public static final int	GEOGRAPHICAL_SCOPE_PLMN_WIDE PLMN wide geographical scope (GSM/UMTS and all CDMA broadcasts).
public static final int	GEOGRAPHICAL_SCOPE_LA_WIDE Location / service area wide geographical scope (GSM/UMTS only).
public static final int	GEOGRAPHICAL_SCOPE_CELL_WIDE Cell wide geographical scope (GSM/UMTS only).
public static final int	MESSAGE_FORMAT_3GPP GSM or UMTS format cell broadcast.
public static final int	MESSAGE_FORMAT_3GPP2 CDMA format cell broadcast.
public static final int	MESSAGE_PRIORITY_NORMAL Normal message priority.
public static final int	MESSAGE_PRIORITY_INTERACTIVE Interactive message priority.
public static final int	MESSAGE_PRIORITY_URGENT Urgent message priority.
public static final int	MESSAGE_PRIORITY_EMERGENCY Emergency message priority.
private final int	mMessageFormat Format of this message (for interpretation of service category values).
private final int	mGeographicalScope Geographical scope of broadcast.
private final int	mSerialNumber Serial number of broadcast (message identifier for CDMA, geographical scope + message code + update number for GSM/UMTS). The serial number plus the location code uniquely identify a cell broadcast for duplicate detection.
private final SmsCbLocation	mLocation Location identifier for this message. It consists of the current operator MCC/MNC as a 5 or 6-digit decimal string. In addition, for GSM/UMTS, if the Geographical Scope of the message is not binary 01, the Location Area is included for comparison. If the GS is 00 or 11, the Cell ID is also included. LAC and Cell ID are -1 if not specified.
private final int	mServiceCategory 16-bit CDMA service category or GSM/UMTS message identifier. For ETWS and CMAS warnings, the information provided by the category is also available via {@link #getEtwsWarningInfo()} or {@link #getCmasWarningInfo()}.
private final String	mLanguage Message language, as a two-character string, e.g. "en".
private final String	mBody Message body, as a String.
private final int	mPriority Message priority (including emergency priority).
private final SmsCbEtwsInfo	mEtwsWarningInfo ETWS warning notification information (ETWS warnings only).
private final SmsCbCmasInfo	mCmasWarningInfo CMAS warning notification information (CMAS warnings only).
public static final Parcelable.Creator	CREATOR

Constructors Summary
public SmsCbMessage(int messageFormat, int geographicalScope, int serialNumber, SmsCbLocation location, int serviceCategory, String language, String body, int priority, SmsCbEtwsInfo etwsWarningInfo, SmsCbCmasInfo cmasWarningInfo) Create a new SmsCbMessage with the specified data. mMessageFormat = messageFormat; mGeographicalScope = geographicalScope; mSerialNumber = serialNumber; mLocation = location; mServiceCategory = serviceCategory; mLanguage = language; mBody = body; mPriority = priority; mEtwsWarningInfo = etwsWarningInfo; mCmasWarningInfo = cmasWarningInfo;
public SmsCbMessage(android.os.Parcel in) Create a new SmsCbMessage object from a Parcel. mMessageFormat = in.readInt(); mGeographicalScope = in.readInt(); mSerialNumber = in.readInt(); mLocation = new SmsCbLocation(in); mServiceCategory = in.readInt(); mLanguage = in.readString(); mBody = in.readString(); mPriority = in.readInt(); int type = in.readInt(); switch (type) { case 'E": // unparcel ETWS warning information mEtwsWarningInfo = new SmsCbEtwsInfo(in); mCmasWarningInfo = null; break; case 'C": // unparcel CMAS warning information mEtwsWarningInfo = null; mCmasWarningInfo = new SmsCbCmasInfo(in); break; default: mEtwsWarningInfo = null; mCmasWarningInfo = null; }

Methods Summary
public int	describeContents() Describe the kinds of special objects contained in the marshalled representation. return a bitmask indicating this Parcelable contains no special objects return 0;
public SmsCbCmasInfo	getCmasWarningInfo() If this is a CMAS warning notification then this method will return an object containing the CMAS message class, category, response type, severity, urgency and certainty. The message class is always present. Severity, urgency and certainty are present for CDMA warning notifications containing a type 1 elements record and for GSM and UMTS warnings except for the Presidential-level alert category. Category and response type are only available for CDMA notifications containing a type 1 elements record. return an SmsCbCmasInfo object, or null if this is not a CMAS warning notification return mCmasWarningInfo;
public SmsCbEtwsInfo	getEtwsWarningInfo() If this is an ETWS warning notification then this method will return an object containing the ETWS warning type, the emergency user alert flag, and the popup flag. If this is an ETWS primary notification (GSM only), there will also be a 7-byte timestamp and 43-byte digital signature. As of Release 10, 3GPP TS 23.041 states that the UE shall ignore the ETWS primary notification timestamp and digital signature if received. return an SmsCbEtwsInfo object, or null if this is not an ETWS warning notification return mEtwsWarningInfo;
public int	getGeographicalScope() Return the geographical scope of this message (GSM/UMTS only). return Geographical scope return mGeographicalScope;
public java.lang.String	getLanguageCode() Get the ISO-639-1 language code for this message, or null if unspecified return Language code return mLanguage;
public SmsCbLocation	getLocation() Return the location identifier for this message, consisting of the MCC/MNC as a 5 or 6-digit decimal string. In addition, for GSM/UMTS, if the Geographical Scope of the message is not binary 01, the Location Area is included. If the GS is 00 or 11, the cell ID is also included. The {@link SmsCbLocation} object includes a method to test if the location is included within another location area or within a PLMN and CellLocation. return the geographical location code for duplicate message detection return mLocation;
public java.lang.String	getMessageBody() Get the body of this message, or null if no body available return Body, or null return mBody;
public int	getMessageFormat() Get the message format ({@link #MESSAGE_FORMAT_3GPP} or {@link #MESSAGE_FORMAT_3GPP2}). return an integer representing 3GPP or 3GPP2 message format return mMessageFormat;
public int	getMessagePriority() Get the message priority. Normal broadcasts return {@link #MESSAGE_PRIORITY_NORMAL} and emergency broadcasts return {@link #MESSAGE_PRIORITY_EMERGENCY}. CDMA also may return {@link #MESSAGE_PRIORITY_INTERACTIVE} or {@link #MESSAGE_PRIORITY_URGENT}. return an integer representing the message priority return mPriority;
public int	getSerialNumber() Return the broadcast serial number of broadcast (message identifier for CDMA, or geographical scope + message code + update number for GSM/UMTS). The serial number plus the location code uniquely identify a cell broadcast for duplicate detection. return the 16-bit CDMA message identifier or GSM/UMTS serial number return mSerialNumber;
public int	getServiceCategory() Return the 16-bit CDMA service category or GSM/UMTS message identifier. The interpretation of the category is radio technology specific. For ETWS and CMAS warnings, the information provided by the category is available via {@link #getEtwsWarningInfo()} or {@link #getCmasWarningInfo()} in a radio technology independent format. return the radio technology specific service category return mServiceCategory;
public boolean	isCmasMessage() Return whether this message is a CMAS warning alert. return true if the message is a CMAS warning notification; false otherwise return mCmasWarningInfo != null;
public boolean	isEmergencyMessage() Return whether this message is an emergency (PWS) message type. return true if the message is a public warning notification; false otherwise return mPriority == MESSAGE_PRIORITY_EMERGENCY;
public boolean	isEtwsMessage() Return whether this message is an ETWS warning alert. return true if the message is an ETWS warning notification; false otherwise return mEtwsWarningInfo != null;
public java.lang.String	toString() return "SmsCbMessage{geographicalScope=" + mGeographicalScope + ", serialNumber=" + mSerialNumber + ", location=" + mLocation + ", serviceCategory=" + mServiceCategory + ", language=" + mLanguage + ", body=" + mBody + ", priority=" + mPriority + (mEtwsWarningInfo != null ? (", " + mEtwsWarningInfo.toString()) : "") + (mCmasWarningInfo != null ? (", " + mCmasWarningInfo.toString()) : "") + '}";
public void	writeToParcel(android.os.Parcel dest, int flags) Flatten this object into a Parcel. param dest The Parcel in which the object should be written. param flags Additional flags about how the object should be written (ignored). dest.writeInt(mMessageFormat); dest.writeInt(mGeographicalScope); dest.writeInt(mSerialNumber); mLocation.writeToParcel(dest, flags); dest.writeInt(mServiceCategory); dest.writeString(mLanguage); dest.writeString(mBody); dest.writeInt(mPriority); if (mEtwsWarningInfo != null) { // parcel ETWS warning information dest.writeInt('E"); mEtwsWarningInfo.writeToParcel(dest, flags); } else if (mCmasWarningInfo != null) { // parcel CMAS warning information dest.writeInt('C"); mCmasWarningInfo.writeToParcel(dest, flags); } else { // no ETWS or CMAS warning information dest.writeInt('0"); }