IImsRegistrationListener.aidl revision d4e44bbdbf2d1bd7307501658b694b3c92fd668b
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 17package com.android.ims.internal; 18 19import com.android.ims.ImsReasonInfo; 20 21/** 22 * A listener type for receiving notifications about the changes to 23 * the IMS connection(registration). 24 * 25 * {@hide} 26 */ 27interface IImsRegistrationListener { 28 /** 29 * Notifies the application when the device is connected to the IMS network. 30 * 31 * @deprecated see {@link registrationConnectedWithRadioTech} 32 */ 33 void registrationConnected(); 34 35 /** 36 * Notifies the application when the device is trying to connect the IMS network. 37 * 38 * @deprecated see {@link registrationProgressingWithRadioTech} 39 */ 40 void registrationProgressing(); 41 42 /** 43 * Notifies the application when the device is connected to the IMS network. 44 * 45 * @param imsRadioTech the radio access technology. Valid values are {@code 46 * RIL_RADIO_TECHNOLOGY_*} defined in {@link ServiceState}. 47 */ 48 void registrationConnectedWithRadioTech(int imsRadioTech); 49 50 /** 51 * Notifies the application when the device is trying to connect the IMS network. 52 * 53 * @param imsRadioTech the radio access technology. Valid values are {@code 54 * RIL_RADIO_TECHNOLOGY_*} defined in {@link ServiceState}. 55 */ 56 void registrationProgressingWithRadioTech(int imsRadioTech); 57 58 59 /** 60 * Notifies the application when the device is disconnected from the IMS network. 61 */ 62 void registrationDisconnected(in ImsReasonInfo imsReasonInfo); 63 64 /** 65 * Notifies the application when its suspended IMS connection is resumed, 66 * meaning the connection now allows throughput. 67 */ 68 void registrationResumed(); 69 70 /** 71 * Notifies the application when its current IMS connection is suspended, 72 * meaning there is no data throughput. 73 */ 74 void registrationSuspended(); 75 76 /** 77 * Notifies the application when its current IMS connection is updated 78 * since the service setting is changed or the service is added/removed. 79 * 80 * @param serviceClass a service class specified in {@link ImsServiceClass} 81 * @param event an event type when this callback is called 82 * If {@code event} is 0, meaning the specified service is removed from the IMS connection. 83 * Else ({@code event} is 1), meaning the specified service is added to the IMS connection. 84 */ 85 void registrationServiceCapabilityChanged(int serviceClass, int event); 86 87 /** 88 * Notifies the application when features on a particular service enabled or 89 * disabled successfully based on user preferences. 90 * 91 * @param serviceClass a service class specified in {@link ImsServiceClass} 92 * @param enabledFeatures features enabled as defined in com.android.ims.ImsConfig#FeatureConstants. 93 * @param disabledFeatures features disabled as defined in com.android.ims.ImsConfig#FeatureConstants. 94 */ 95 void registrationFeatureCapabilityChanged(int serviceClass, 96 in int[] enabledFeatures, in int[] disabledFeatures); 97 98 /** 99 * Updates the application with the waiting voice message count. 100 * @param count The number of waiting voice messages. 101 */ 102 void voiceMessageCountUpdate(int count); 103} 104