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;
18
19import android.net.Uri;
20
21/**
22 * Listener for receiving notifications about changes to the IMS connection.
23 * It provides a state of IMS registration between UE and IMS network, the service
24 * availability of the local device during IMS registered.
25 *
26 * @hide
27 */
28public class ImsConnectionStateListener {
29    /**
30     * Called when the device is connected to the IMS network with {@param imsRadioTech}.
31     */
32    public void onImsConnected(int imsRadioTech) {
33        // no-op
34    }
35
36    /**
37     * Called when the device is trying to connect to the IMS network with {@param imsRadioTech}.
38     */
39    public void onImsProgressing(int imsRadioTech) {
40        // no-op
41    }
42
43    /**
44     * Called when the device is disconnected from the IMS network.
45     */
46    public void onImsDisconnected(ImsReasonInfo imsReasonInfo) {
47        // no-op
48    }
49
50    /**
51     * Called when its suspended IMS connection is resumed, meaning the connection
52     * now allows throughput.
53     */
54    public void onImsResumed() {
55        // no-op
56    }
57
58    /**
59     * Called when its current IMS connection is suspended, meaning there is no data throughput.
60     */
61    public void onImsSuspended() {
62        // no-op
63    }
64
65    /**
66     * Called when its current IMS connection feature capability changes.
67     */
68    public void onFeatureCapabilityChanged(int serviceClass,
69                int[] enabledFeatures, int[] disabledFeatures) {
70        // no-op
71    }
72
73    /**
74     * Called when waiting voice message count changes.
75     */
76    public void onVoiceMessageCountChanged(int count) {
77        // no-op
78    }
79
80    /**
81     * Called after IMS registration.
82     */
83    public void registrationAssociatedUriChanged(Uri[] uris) {
84        // no-op
85    }
86
87    /**
88     * Called when IMS registration attempt on {@param imsRadioTech} failed
89     */
90    public void onRegistrationChangeFailed(int imsRadioTech, ImsReasonInfo imsReasonInfo) {
91        // no-op
92    }
93}
94