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