1/*
2 * Copyright (C) 2014 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 android.telephony;
18
19import android.annotation.PrivateApi;
20
21/** @hide */
22@PrivateApi
23public interface CallStateListener {
24    /**
25     * Notify of a new or updated call.
26     * Any time the state of a call is updated, it will alert any listeners. This includes changes
27     * of state such as when a call is put on hold or conferenced.
28     *
29     * @param callId a unique ideCntifier for a given call that can be used to track state changes
30     * @param state the new state of the call.
31     *              {@see com.android.services.telephony.common.Call$State}
32     * @param number the phone number of the call. For some states, this may be blank. However, it
33     *               will be populated for any initial state.
34     */
35    public void onCallStateChanged(int callId, int state, String number);
36}
37