Home | History | Annotate | Download | only in telephony
      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 
     17 package android.telephony;
     18 
     19 import android.annotation.PrivateApi;
     20 
     21 /** @hide */
     22 @PrivateApi
     23 public 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