Wink Saville | f8458ff | 2014-06-25 16:08:02 -0700 | [diff] [blame] | 1 | /* |
| 2 | * Copyright (c) 2013 The Android Open Source Project |
| 3 | * |
| 4 | * Licensed under the Apache License, Version 2.0 (the "License"); |
| 5 | * you may not use this file except in compliance with the License. |
| 6 | * You may obtain a copy of the License at |
| 7 | * |
| 8 | * http://www.apache.org/licenses/LICENSE-2.0 |
| 9 | * |
| 10 | * Unless required by applicable law or agreed to in writing, software |
| 11 | * distributed under the License is distributed on an "AS IS" BASIS, |
| 12 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. |
| 13 | * See the License for the specific language governing permissions and |
| 14 | * limitations under the License. |
| 15 | */ |
| 16 | |
| 17 | package com.android.ims.internal; |
| 18 | |
Jordan Liu | 8218ddd | 2018-11-28 11:22:39 -0800 | [diff] [blame] | 19 | import android.telephony.CallQuality; |
Brad Ebinger | 0e370b4 | 2018-01-22 13:51:52 -0800 | [diff] [blame] | 20 | import android.telephony.ims.ImsStreamMediaProfile; |
| 21 | import android.telephony.ims.ImsCallProfile; |
| 22 | import android.telephony.ims.ImsReasonInfo; |
| 23 | import android.telephony.ims.ImsConferenceState; |
Wink Saville | f8458ff | 2014-06-25 16:08:02 -0700 | [diff] [blame] | 24 | import com.android.ims.internal.IImsCallSession; |
Brad Ebinger | 0e370b4 | 2018-01-22 13:51:52 -0800 | [diff] [blame] | 25 | import android.telephony.ims.ImsSuppServiceNotification; |
Wink Saville | f8458ff | 2014-06-25 16:08:02 -0700 | [diff] [blame] | 26 | |
| 27 | /** |
| 28 | * A listener type for receiving notification on IMS call session events. |
| 29 | * When an event is generated for an {@link IImsCallSession}, the application is notified |
| 30 | * by having one of the methods called on the {@link IImsCallSessionListener}. |
| 31 | * {@hide} |
| 32 | */ |
Brad Ebinger | 14c4f3d | 2017-07-27 12:57:03 -0700 | [diff] [blame] | 33 | oneway interface IImsCallSessionListener { |
Wink Saville | f8458ff | 2014-06-25 16:08:02 -0700 | [diff] [blame] | 34 | /** |
| 35 | * Notifies the result of the basic session operation (setup / terminate). |
| 36 | */ |
Andrei Onea | 903da37 | 2019-02-27 15:45:08 +0000 | [diff] [blame] | 37 | @UnsupportedAppUsage |
Wink Saville | f8458ff | 2014-06-25 16:08:02 -0700 | [diff] [blame] | 38 | void callSessionProgressing(in IImsCallSession session, in ImsStreamMediaProfile profile); |
Andrei Onea | 903da37 | 2019-02-27 15:45:08 +0000 | [diff] [blame] | 39 | @UnsupportedAppUsage |
Wink Saville | f8458ff | 2014-06-25 16:08:02 -0700 | [diff] [blame] | 40 | void callSessionStarted(in IImsCallSession session, in ImsCallProfile profile); |
Andrei Onea | 903da37 | 2019-02-27 15:45:08 +0000 | [diff] [blame] | 41 | @UnsupportedAppUsage |
Wink Saville | f8458ff | 2014-06-25 16:08:02 -0700 | [diff] [blame] | 42 | void callSessionStartFailed(in IImsCallSession session, in ImsReasonInfo reasonInfo); |
Andrei Onea | 903da37 | 2019-02-27 15:45:08 +0000 | [diff] [blame] | 43 | @UnsupportedAppUsage |
Wink Saville | f8458ff | 2014-06-25 16:08:02 -0700 | [diff] [blame] | 44 | void callSessionTerminated(in IImsCallSession session, in ImsReasonInfo reasonInfo); |
| 45 | |
| 46 | /** |
| 47 | * Notifies the result of the call hold/resume operation. |
| 48 | */ |
Andrei Onea | 903da37 | 2019-02-27 15:45:08 +0000 | [diff] [blame] | 49 | @UnsupportedAppUsage |
Wink Saville | f8458ff | 2014-06-25 16:08:02 -0700 | [diff] [blame] | 50 | void callSessionHeld(in IImsCallSession session, in ImsCallProfile profile); |
Andrei Onea | 903da37 | 2019-02-27 15:45:08 +0000 | [diff] [blame] | 51 | @UnsupportedAppUsage |
Wink Saville | f8458ff | 2014-06-25 16:08:02 -0700 | [diff] [blame] | 52 | void callSessionHoldFailed(in IImsCallSession session, in ImsReasonInfo reasonInfo); |
Andrei Onea | 903da37 | 2019-02-27 15:45:08 +0000 | [diff] [blame] | 53 | @UnsupportedAppUsage |
Wink Saville | f8458ff | 2014-06-25 16:08:02 -0700 | [diff] [blame] | 54 | void callSessionHoldReceived(in IImsCallSession session, in ImsCallProfile profile); |
Andrei Onea | 903da37 | 2019-02-27 15:45:08 +0000 | [diff] [blame] | 55 | @UnsupportedAppUsage |
Wink Saville | f8458ff | 2014-06-25 16:08:02 -0700 | [diff] [blame] | 56 | void callSessionResumed(in IImsCallSession session, in ImsCallProfile profile); |
Andrei Onea | 903da37 | 2019-02-27 15:45:08 +0000 | [diff] [blame] | 57 | @UnsupportedAppUsage |
Wink Saville | f8458ff | 2014-06-25 16:08:02 -0700 | [diff] [blame] | 58 | void callSessionResumeFailed(in IImsCallSession session, in ImsReasonInfo reasonInfo); |
Andrei Onea | 903da37 | 2019-02-27 15:45:08 +0000 | [diff] [blame] | 59 | @UnsupportedAppUsage |
Wink Saville | f8458ff | 2014-06-25 16:08:02 -0700 | [diff] [blame] | 60 | void callSessionResumeReceived(in IImsCallSession session, in ImsCallProfile profile); |
| 61 | |
| 62 | /** |
Tyler Gunn | f764e80 | 2014-10-24 14:06:40 -0700 | [diff] [blame] | 63 | * Notifies the result of call merge operation. |
Wink Saville | f8458ff | 2014-06-25 16:08:02 -0700 | [diff] [blame] | 64 | */ |
Andrei Onea | 903da37 | 2019-02-27 15:45:08 +0000 | [diff] [blame] | 65 | @UnsupportedAppUsage |
Tyler Gunn | f764e80 | 2014-10-24 14:06:40 -0700 | [diff] [blame] | 66 | void callSessionMergeStarted(in IImsCallSession session, |
Wink Saville | f8458ff | 2014-06-25 16:08:02 -0700 | [diff] [blame] | 67 | in IImsCallSession newSession, in ImsCallProfile profile); |
Andrei Onea | 903da37 | 2019-02-27 15:45:08 +0000 | [diff] [blame] | 68 | @UnsupportedAppUsage |
Tyler Gunn | f764e80 | 2014-10-24 14:06:40 -0700 | [diff] [blame] | 69 | void callSessionMergeComplete(in IImsCallSession session); |
Andrei Onea | 903da37 | 2019-02-27 15:45:08 +0000 | [diff] [blame] | 70 | @UnsupportedAppUsage |
Wink Saville | f8458ff | 2014-06-25 16:08:02 -0700 | [diff] [blame] | 71 | void callSessionMergeFailed(in IImsCallSession session, |
| 72 | in ImsReasonInfo reasonInfo); |
| 73 | |
| 74 | /** |
| 75 | * Notifies the result of call upgrade / downgrade or any other call updates. |
| 76 | */ |
Andrei Onea | 903da37 | 2019-02-27 15:45:08 +0000 | [diff] [blame] | 77 | @UnsupportedAppUsage |
Wink Saville | f8458ff | 2014-06-25 16:08:02 -0700 | [diff] [blame] | 78 | void callSessionUpdated(in IImsCallSession session, |
| 79 | in ImsCallProfile profile); |
| 80 | void callSessionUpdateFailed(in IImsCallSession session, |
| 81 | in ImsReasonInfo reasonInfo); |
| 82 | void callSessionUpdateReceived(in IImsCallSession session, |
| 83 | in ImsCallProfile profile); |
| 84 | |
| 85 | /** |
| 86 | * Notifies the result of conference extension. |
| 87 | */ |
| 88 | void callSessionConferenceExtended(in IImsCallSession session, |
| 89 | in IImsCallSession newSession, in ImsCallProfile profile); |
| 90 | void callSessionConferenceExtendFailed(in IImsCallSession session, |
| 91 | in ImsReasonInfo reasonInfo); |
| 92 | void callSessionConferenceExtendReceived(in IImsCallSession session, |
| 93 | in IImsCallSession newSession, in ImsCallProfile profile); |
| 94 | |
| 95 | /** |
| 96 | * Notifies the result of the participant invitation / removal to/from the conference session. |
| 97 | */ |
Andrei Onea | 903da37 | 2019-02-27 15:45:08 +0000 | [diff] [blame] | 98 | @UnsupportedAppUsage |
Wink Saville | f8458ff | 2014-06-25 16:08:02 -0700 | [diff] [blame] | 99 | void callSessionInviteParticipantsRequestDelivered(in IImsCallSession session); |
Andrei Onea | 903da37 | 2019-02-27 15:45:08 +0000 | [diff] [blame] | 100 | @UnsupportedAppUsage |
Wink Saville | f8458ff | 2014-06-25 16:08:02 -0700 | [diff] [blame] | 101 | void callSessionInviteParticipantsRequestFailed(in IImsCallSession session, |
| 102 | in ImsReasonInfo reasonInfo); |
| 103 | void callSessionRemoveParticipantsRequestDelivered(in IImsCallSession session); |
| 104 | void callSessionRemoveParticipantsRequestFailed(in IImsCallSession session, |
| 105 | in ImsReasonInfo reasonInfo); |
| 106 | |
| 107 | /** |
| 108 | * Notifies the changes of the conference info. in the conference session. |
| 109 | */ |
Andrei Onea | 903da37 | 2019-02-27 15:45:08 +0000 | [diff] [blame] | 110 | @UnsupportedAppUsage |
Wink Saville | f8458ff | 2014-06-25 16:08:02 -0700 | [diff] [blame] | 111 | void callSessionConferenceStateUpdated(in IImsCallSession session, |
| 112 | in ImsConferenceState state); |
| 113 | |
| 114 | /** |
| 115 | * Notifies the incoming USSD message. |
| 116 | */ |
| 117 | void callSessionUssdMessageReceived(in IImsCallSession session, |
| 118 | int mode, String ussdMessage); |
Shriram Ganesh | af9a696 | 2014-07-21 14:06:53 -0700 | [diff] [blame] | 119 | |
| 120 | /** |
| 121 | * Notifies of handover information for this call |
| 122 | */ |
Andrei Onea | 903da37 | 2019-02-27 15:45:08 +0000 | [diff] [blame] | 123 | @UnsupportedAppUsage |
Shriram Ganesh | af9a696 | 2014-07-21 14:06:53 -0700 | [diff] [blame] | 124 | void callSessionHandover(in IImsCallSession session, |
| 125 | in int srcAccessTech, in int targetAccessTech, in ImsReasonInfo reasonInfo); |
Andrei Onea | 903da37 | 2019-02-27 15:45:08 +0000 | [diff] [blame] | 126 | @UnsupportedAppUsage |
Shriram Ganesh | af9a696 | 2014-07-21 14:06:53 -0700 | [diff] [blame] | 127 | void callSessionHandoverFailed(in IImsCallSession session, |
| 128 | in int srcAccessTech, in int targetAccessTech, in ImsReasonInfo reasonInfo); |
Anju Mathapati | f9c1c97 | 2017-03-27 15:43:20 -0700 | [diff] [blame] | 129 | void callSessionMayHandover(in IImsCallSession session, |
| 130 | in int srcAccessTech, in int targetAccessTech); |
Shriram Ganesh | 69f35c8 | 2014-09-11 22:33:03 +0530 | [diff] [blame] | 131 | |
| 132 | /** |
| 133 | * Notifies the TTY mode change by remote party. |
| 134 | * @param mode one of the following: |
| 135 | * - {@link com.android.internal.telephony.Phone#TTY_MODE_OFF} |
| 136 | * - {@link com.android.internal.telephony.Phone#TTY_MODE_FULL} |
| 137 | * - {@link com.android.internal.telephony.Phone#TTY_MODE_HCO} |
| 138 | * - {@link com.android.internal.telephony.Phone#TTY_MODE_VCO} |
| 139 | */ |
Andrei Onea | 903da37 | 2019-02-27 15:45:08 +0000 | [diff] [blame] | 140 | @UnsupportedAppUsage |
Shriram Ganesh | 69f35c8 | 2014-09-11 22:33:03 +0530 | [diff] [blame] | 141 | void callSessionTtyModeReceived(in IImsCallSession session, in int mode); |
Tyler Gunn | 6b91ebf | 2015-04-01 09:36:19 -0700 | [diff] [blame] | 142 | |
| 143 | /** |
| 144 | * Notifies of a change to the multiparty state for this {@code ImsCallSession}. |
| 145 | * |
| 146 | * @param session The call session. |
| 147 | * @param isMultiParty {@code true} if the session became multiparty, {@code false} otherwise. |
| 148 | */ |
Andrei Onea | 903da37 | 2019-02-27 15:45:08 +0000 | [diff] [blame] | 149 | @UnsupportedAppUsage |
Tyler Gunn | 6b91ebf | 2015-04-01 09:36:19 -0700 | [diff] [blame] | 150 | void callSessionMultipartyStateChanged(in IImsCallSession session, in boolean isMultiParty); |
Shriram Ganesh | ddf570e | 2015-05-31 09:18:48 -0700 | [diff] [blame] | 151 | |
| 152 | /** |
| 153 | * Notifies the supplementary service information for the current session. |
| 154 | */ |
Andrei Onea | 903da37 | 2019-02-27 15:45:08 +0000 | [diff] [blame] | 155 | @UnsupportedAppUsage |
Shriram Ganesh | ddf570e | 2015-05-31 09:18:48 -0700 | [diff] [blame] | 156 | void callSessionSuppServiceReceived(in IImsCallSession session, |
| 157 | in ImsSuppServiceNotification suppSrvNotification); |
Anju Mathapati | 7e177da | 2017-01-24 11:58:28 -0800 | [diff] [blame] | 158 | |
| 159 | /** |
| 160 | * Device received RTT modify request from Remote UE |
| 161 | * @param session ImsCallProfile with updated attribute |
| 162 | */ |
| 163 | void callSessionRttModifyRequestReceived(in IImsCallSession session, |
| 164 | in ImsCallProfile callProfile); |
| 165 | |
Jordan Liu | 8218ddd | 2018-11-28 11:22:39 -0800 | [diff] [blame] | 166 | /** |
| 167 | * Device issued RTT modify request and inturn received response |
Anju Mathapati | 7e177da | 2017-01-24 11:58:28 -0800 | [diff] [blame] | 168 | * from Remote UE |
| 169 | * @param status Will be one of the following values from: |
| 170 | * - {@link Connection.RttModifyStatus} |
| 171 | */ |
| 172 | void callSessionRttModifyResponseReceived(in int status); |
| 173 | |
Jordan Liu | 8218ddd | 2018-11-28 11:22:39 -0800 | [diff] [blame] | 174 | /** |
Anju Mathapati | 7e177da | 2017-01-24 11:58:28 -0800 | [diff] [blame] | 175 | * While in call, device received RTT message from Remote UE |
| 176 | * @param rttMessage Received RTT message |
| 177 | */ |
| 178 | void callSessionRttMessageReceived(in String rttMessage); |
Wileen Chiu | f2ec298 | 2018-07-01 14:21:50 -0700 | [diff] [blame] | 179 | |
Jordan Liu | 8218ddd | 2018-11-28 11:22:39 -0800 | [diff] [blame] | 180 | /** |
Wileen Chiu | f2ec298 | 2018-07-01 14:21:50 -0700 | [diff] [blame] | 181 | * While in call, there has been a change in RTT audio indicator. |
| 182 | * @param profile updated ImsStreamMediaProfile |
| 183 | */ |
| 184 | void callSessionRttAudioIndicatorChanged(in ImsStreamMediaProfile profile); |
Jordan Liu | 8218ddd | 2018-11-28 11:22:39 -0800 | [diff] [blame] | 185 | |
| 186 | /** |
| 187 | * Notifies of a change to the call quality. |
| 188 | * @param callQuality then updated call quality |
| 189 | */ |
| 190 | void callQualityChanged(in CallQuality callQuality); |
Wink Saville | f8458ff | 2014-06-25 16:08:02 -0700 | [diff] [blame] | 191 | } |