Donate to e Foundation | Murena handsets with /e/OS | Own a part of Murena! Learn more

Commit ea72eacc authored by Tyler Gunn's avatar Tyler Gunn
Browse files

Add Connection Event for supplementary service notifications. 

These are passed up to the UI with an optional charsequence message which
the UI can choose to display to the user.

Test: Manual, added new unit tests
Bug: 65534165
Change-Id: Icdf2738ac4dfd3a65e9eacac2caa4d4a44348ab4
parent d7187c90

telephony/java/android/telephony/TelephonyManager.java

+55 −0
Original line number Diff line number Diff line
@@ -892,6 +892,61 @@ public class TelephonyManager { 
    public static final String EVENT_CALL_FORWARDED =

            "android.telephony.event.EVENT_CALL_FORWARDED";



    /**

     * {@link android.telecom.Connection} event used to indicate that a supplementary service

     * notification has been received.

     * <p>

     * Sent via {@link android.telecom.Connection#sendConnectionEvent(String, Bundle)}.

     * The {@link Bundle} parameter is expected to include the following extras:

     * <ul>

     *     <li>{@link #EXTRA_NOTIFICATION_TYPE} - the notification type.</li>

     *     <li>{@link #EXTRA_NOTIFICATION_CODE} - the notification code.</li>

     *     <li>{@link #EXTRA_NOTIFICATION_MESSAGE} - human-readable message associated with the

     *     supplementary service notification.</li>

     * </ul>

     * @hide

     */

    public static final String EVENT_SUPPLEMENTARY_SERVICE_NOTIFICATION =

            "android.telephony.event.EVENT_SUPPLEMENTARY_SERVICE_NOTIFICATION";



    /**

     * Integer extra key used with {@link #EVENT_SUPPLEMENTARY_SERVICE_NOTIFICATION} which indicates

     * the type of supplementary service notification which occurred.

     * Will be either

     * {@link com.android.internal.telephony.gsm.SuppServiceNotification#NOTIFICATION_TYPE_CODE_1}

     * or

     * {@link com.android.internal.telephony.gsm.SuppServiceNotification#NOTIFICATION_TYPE_CODE_2}

     * <p>

     * Set in the extras for the {@link #EVENT_SUPPLEMENTARY_SERVICE_NOTIFICATION} connection event.

     * @hide

     */

    public static final String EXTRA_NOTIFICATION_TYPE =

            "android.telephony.extra.NOTIFICATION_TYPE";



    /**

     * Integer extra key used with {@link #EVENT_SUPPLEMENTARY_SERVICE_NOTIFICATION} which indicates

     * the supplementary service notification which occurred.

     * <p>

     * Depending on the {@link #EXTRA_NOTIFICATION_TYPE}, the code will be one of the {@code CODE_*}

     * codes defined in {@link com.android.internal.telephony.gsm.SuppServiceNotification}.

     * <p>

     * Set in the extras for the {@link #EVENT_SUPPLEMENTARY_SERVICE_NOTIFICATION} connection event.

     * @hide

     */

    public static final String EXTRA_NOTIFICATION_CODE =

            "android.telephony.extra.NOTIFICATION_CODE";



    /**

     * {@link CharSequence} extra key used with {@link #EVENT_SUPPLEMENTARY_SERVICE_NOTIFICATION}

     * which contains a human-readable message which can be displayed to the user for the

     * supplementary service notification.

     * <p>

     * Set in the extras for the {@link #EVENT_SUPPLEMENTARY_SERVICE_NOTIFICATION} connection event.

     * @hide

     */

    public static final String EXTRA_NOTIFICATION_MESSAGE =

            "android.telephony.extra.NOTIFICATION_MESSAGE";



    /* Visual voicemail protocols */



    /**