115a4d2ffd04dc6c70f2cd17dae12ac6bc14c69abKenny Root/* 215a4d2ffd04dc6c70f2cd17dae12ac6bc14c69abKenny Root * Copyright (C) 2008 The Android Open Source Project 315a4d2ffd04dc6c70f2cd17dae12ac6bc14c69abKenny Root * 415a4d2ffd04dc6c70f2cd17dae12ac6bc14c69abKenny Root * Licensed under the Apache License, Version 2.0 (the "License"); 515a4d2ffd04dc6c70f2cd17dae12ac6bc14c69abKenny Root * you may not use this file except in compliance with the License. 615a4d2ffd04dc6c70f2cd17dae12ac6bc14c69abKenny Root * You may obtain a copy of the License at 715a4d2ffd04dc6c70f2cd17dae12ac6bc14c69abKenny Root * 815a4d2ffd04dc6c70f2cd17dae12ac6bc14c69abKenny Root * http://www.apache.org/licenses/LICENSE-2.0 915a4d2ffd04dc6c70f2cd17dae12ac6bc14c69abKenny Root * 1015a4d2ffd04dc6c70f2cd17dae12ac6bc14c69abKenny Root * Unless required by applicable law or agreed to in writing, software 1115a4d2ffd04dc6c70f2cd17dae12ac6bc14c69abKenny Root * distributed under the License is distributed on an "AS IS" BASIS, 1215a4d2ffd04dc6c70f2cd17dae12ac6bc14c69abKenny Root * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 1315a4d2ffd04dc6c70f2cd17dae12ac6bc14c69abKenny Root * See the License for the specific language governing permissions and 1415a4d2ffd04dc6c70f2cd17dae12ac6bc14c69abKenny Root * limitations under the License. 1515a4d2ffd04dc6c70f2cd17dae12ac6bc14c69abKenny Root */ 1615a4d2ffd04dc6c70f2cd17dae12ac6bc14c69abKenny Root 179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectpackage android.telephony; 189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.os.Bundle; 209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.os.Handler; 219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.os.Message; 229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.telephony.ServiceState; 23e9b06d754af03faf27012fbed1e7559ec1ba7c79Wink Savilleimport android.telephony.SignalStrength; 249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.telephony.CellLocation; 25963db55d59a170f4b17ff907c96615a19ef6fe17John Wangimport android.telephony.CellInfo; 269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.util.Log; 279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport com.android.internal.telephony.IPhoneStateListener; 299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 30b208a24cf521401912cfce16fce550a995cf1250Wink Savilleimport java.util.List; 31b208a24cf521401912cfce16fce550a995cf1250Wink Saville 329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/** 339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * A listener class for monitoring changes in specific telephony states 34767a662ecde33c3979bf02b793d392aca0403162Wink Saville * on the device, including service state, signal strength, message 359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * waiting indicator (voicemail), and others. 369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> 37767a662ecde33c3979bf02b793d392aca0403162Wink Saville * Override the methods for the state that you wish to receive updates for, and 389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * pass your PhoneStateListener object, along with bitwise-or of the LISTEN_ 399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * flags to {@link TelephonyManager#listen TelephonyManager.listen()}. 409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> 419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Note that access to some telephony information is 42767a662ecde33c3979bf02b793d392aca0403162Wink Saville * permission-protected. Your application won't receive updates for protected 43767a662ecde33c3979bf02b793d392aca0403162Wink Saville * information unless it has the appropriate permissions declared in 449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * its manifest file. Where permissions apply, they are noted in the 45767a662ecde33c3979bf02b793d392aca0403162Wink Saville * appropriate LISTEN_ flags. 469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectpublic class PhoneStateListener { 489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Stop listening for updates. 519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int LISTEN_NONE = 0; 539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Listen for changes to the network service state (cellular). 569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #onServiceStateChanged 589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see ServiceState 599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int LISTEN_SERVICE_STATE = 0x00000001; 619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Listen for changes to the network signal strength (cellular). 6445515659438964ec47f4feac247f0e9dce587c86Jaikumar Ganesh * {@more} 6545515659438964ec47f4feac247f0e9dce587c86Jaikumar Ganesh * Requires Permission: {@link android.Manifest.permission#READ_PHONE_STATE 6645515659438964ec47f4feac247f0e9dce587c86Jaikumar Ganesh * READ_PHONE_STATE} 679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> 689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #onSignalStrengthChanged 70e9b06d754af03faf27012fbed1e7559ec1ba7c79Wink Saville * 71cc6ff2bc6011294367d9a8c644f811449e952eb7Wink Saville * @deprecated by {@link #LISTEN_SIGNAL_STRENGTHS} 729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 73cc6ff2bc6011294367d9a8c644f811449e952eb7Wink Saville @Deprecated 749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int LISTEN_SIGNAL_STRENGTH = 0x00000002; 759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Listen for changes to the message-waiting indicator. 7845515659438964ec47f4feac247f0e9dce587c86Jaikumar Ganesh * {@more} 7945515659438964ec47f4feac247f0e9dce587c86Jaikumar Ganesh * Requires Permission: {@link android.Manifest.permission#READ_PHONE_STATE 8045515659438964ec47f4feac247f0e9dce587c86Jaikumar Ganesh * READ_PHONE_STATE} 819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> 829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Example: The status bar uses this to determine when to display the 839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * voicemail icon. 849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #onMessageWaitingIndicatorChanged 869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int LISTEN_MESSAGE_WAITING_INDICATOR = 0x00000004; 889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Listen for changes to the call-forwarding indicator. 9145515659438964ec47f4feac247f0e9dce587c86Jaikumar Ganesh * {@more} 9245515659438964ec47f4feac247f0e9dce587c86Jaikumar Ganesh * Requires Permission: {@link android.Manifest.permission#READ_PHONE_STATE 9345515659438964ec47f4feac247f0e9dce587c86Jaikumar Ganesh * READ_PHONE_STATE} 949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #onCallForwardingIndicatorChanged 959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int LISTEN_CALL_FORWARDING_INDICATOR = 0x00000008; 979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 99767a662ecde33c3979bf02b793d392aca0403162Wink Saville * Listen for changes to the device's cell location. Note that 1009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * this will result in frequent callbacks to the listener. 1019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@more} 1029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Requires Permission: {@link android.Manifest.permission#ACCESS_COARSE_LOCATION 1039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * ACCESS_COARSE_LOCATION} 1049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> 105767a662ecde33c3979bf02b793d392aca0403162Wink Saville * If you need regular location updates but want more control over 106767a662ecde33c3979bf02b793d392aca0403162Wink Saville * the update interval or location precision, you can set up a listener 107767a662ecde33c3979bf02b793d392aca0403162Wink Saville * through the {@link android.location.LocationManager location manager} 108767a662ecde33c3979bf02b793d392aca0403162Wink Saville * instead. 109767a662ecde33c3979bf02b793d392aca0403162Wink Saville * 1109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #onCellLocationChanged 1119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int LISTEN_CELL_LOCATION = 0x00000010; 1139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Listen for changes to the device call state. 11645515659438964ec47f4feac247f0e9dce587c86Jaikumar Ganesh * {@more} 11745515659438964ec47f4feac247f0e9dce587c86Jaikumar Ganesh * Requires Permission: {@link android.Manifest.permission#READ_PHONE_STATE 11845515659438964ec47f4feac247f0e9dce587c86Jaikumar Ganesh * READ_PHONE_STATE} 1199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #onCallStateChanged 1209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int LISTEN_CALL_STATE = 0x00000020; 1229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Listen for changes to the data connection state (cellular). 1259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #onDataConnectionStateChanged 1279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int LISTEN_DATA_CONNECTION_STATE = 0x00000040; 1299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Listen for changes to the direction of data traffic on the data 1329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * connection (cellular). 13345515659438964ec47f4feac247f0e9dce587c86Jaikumar Ganesh * {@more} 13445515659438964ec47f4feac247f0e9dce587c86Jaikumar Ganesh * Requires Permission: {@link android.Manifest.permission#READ_PHONE_STATE 13545515659438964ec47f4feac247f0e9dce587c86Jaikumar Ganesh * READ_PHONE_STATE} 136767a662ecde33c3979bf02b793d392aca0403162Wink Saville * Example: The status bar uses this to display the appropriate 1379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * data-traffic icon. 1389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #onDataActivity 1409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int LISTEN_DATA_ACTIVITY = 0x00000080; 1429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 143e9b06d754af03faf27012fbed1e7559ec1ba7c79Wink Saville /** 144e9b06d754af03faf27012fbed1e7559ec1ba7c79Wink Saville * Listen for changes to the network signal strengths (cellular). 145e9b06d754af03faf27012fbed1e7559ec1ba7c79Wink Saville * <p> 146e9b06d754af03faf27012fbed1e7559ec1ba7c79Wink Saville * Example: The status bar uses this to control the signal-strength 147e9b06d754af03faf27012fbed1e7559ec1ba7c79Wink Saville * icon. 148e9b06d754af03faf27012fbed1e7559ec1ba7c79Wink Saville * 149e9b06d754af03faf27012fbed1e7559ec1ba7c79Wink Saville * @see #onSignalStrengthsChanged 150e9b06d754af03faf27012fbed1e7559ec1ba7c79Wink Saville */ 151e9b06d754af03faf27012fbed1e7559ec1ba7c79Wink Saville public static final int LISTEN_SIGNAL_STRENGTHS = 0x00000100; 152e9b06d754af03faf27012fbed1e7559ec1ba7c79Wink Saville 153fd2d01302781af91d77557a99874111a4fee8365Wink Saville /** 154fd2d01302781af91d77557a99874111a4fee8365Wink Saville * Listen for changes to OTASP mode. 155fd2d01302781af91d77557a99874111a4fee8365Wink Saville * 156fd2d01302781af91d77557a99874111a4fee8365Wink Saville * @see #onOtaspChanged 157fd2d01302781af91d77557a99874111a4fee8365Wink Saville * @hide 158fd2d01302781af91d77557a99874111a4fee8365Wink Saville */ 159fd2d01302781af91d77557a99874111a4fee8365Wink Saville public static final int LISTEN_OTASP_CHANGED = 0x00000200; 160fd2d01302781af91d77557a99874111a4fee8365Wink Saville 161963db55d59a170f4b17ff907c96615a19ef6fe17John Wang /** 162963db55d59a170f4b17ff907c96615a19ef6fe17John Wang * Listen for changes to observed cell info. 163963db55d59a170f4b17ff907c96615a19ef6fe17John Wang * 164963db55d59a170f4b17ff907c96615a19ef6fe17John Wang * @see #onCellInfoChanged 165963db55d59a170f4b17ff907c96615a19ef6fe17John Wang */ 166963db55d59a170f4b17ff907c96615a19ef6fe17John Wang public static final int LISTEN_CELL_INFO = 0x00000400; 167963db55d59a170f4b17ff907c96615a19ef6fe17John Wang 1689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public PhoneStateListener() { 1699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 172767a662ecde33c3979bf02b793d392aca0403162Wink Saville * Callback invoked when device service state changes. 1739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see ServiceState#STATE_EMERGENCY_ONLY 1759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see ServiceState#STATE_IN_SERVICE 1769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see ServiceState#STATE_OUT_OF_SERVICE 1779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see ServiceState#STATE_POWER_OFF 1789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void onServiceStateChanged(ServiceState serviceState) { 1809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // default implementation empty 1819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Callback invoked when network signal strength changes. 1859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see ServiceState#STATE_EMERGENCY_ONLY 1879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see ServiceState#STATE_IN_SERVICE 1889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see ServiceState#STATE_OUT_OF_SERVICE 1899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see ServiceState#STATE_POWER_OFF 190b149ee883502af8ae71757f9098c8e98c8548d25Scott Main * @deprecated Use {@link #onSignalStrengthsChanged(SignalStrength)} 1919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1924a51c20ce607c74914f90fd897f04080121ac13bDianne Hackborn @Deprecated 1939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void onSignalStrengthChanged(int asu) { 1949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // default implementation empty 1959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 198767a662ecde33c3979bf02b793d392aca0403162Wink Saville * Callback invoked when the message-waiting indicator changes. 1999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void onMessageWaitingIndicatorChanged(boolean mwi) { 2019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // default implementation empty 2029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 205767a662ecde33c3979bf02b793d392aca0403162Wink Saville * Callback invoked when the call-forwarding indicator changes. 2069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void onCallForwardingIndicatorChanged(boolean cfi) { 2089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // default implementation empty 2099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 212767a662ecde33c3979bf02b793d392aca0403162Wink Saville * Callback invoked when device cell location changes. 2139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void onCellLocationChanged(CellLocation location) { 2159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // default implementation empty 2169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 219767a662ecde33c3979bf02b793d392aca0403162Wink Saville * Callback invoked when device call state changes. 2209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 2219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see TelephonyManager#CALL_STATE_IDLE 2229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see TelephonyManager#CALL_STATE_RINGING 2239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see TelephonyManager#CALL_STATE_OFFHOOK 2249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void onCallStateChanged(int state, String incomingNumber) { 2269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // default implementation empty 2279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 230767a662ecde33c3979bf02b793d392aca0403162Wink Saville * Callback invoked when connection state changes. 2319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 2329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see TelephonyManager#DATA_DISCONNECTED 2339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see TelephonyManager#DATA_CONNECTING 2349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see TelephonyManager#DATA_CONNECTED 2359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see TelephonyManager#DATA_SUSPENDED 2369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void onDataConnectionStateChanged(int state) { 2389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // default implementation empty 2399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 24298e0b146b80670b52805b4b210ef5582dad6bb68Robert Greenwalt * same as above, but with the network type. Both called. 24398e0b146b80670b52805b4b210ef5582dad6bb68Robert Greenwalt */ 24498e0b146b80670b52805b4b210ef5582dad6bb68Robert Greenwalt public void onDataConnectionStateChanged(int state, int networkType) { 24598e0b146b80670b52805b4b210ef5582dad6bb68Robert Greenwalt } 24698e0b146b80670b52805b4b210ef5582dad6bb68Robert Greenwalt 24798e0b146b80670b52805b4b210ef5582dad6bb68Robert Greenwalt /** 248767a662ecde33c3979bf02b793d392aca0403162Wink Saville * Callback invoked when data activity state changes. 2499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 2509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see TelephonyManager#DATA_ACTIVITY_NONE 2519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see TelephonyManager#DATA_ACTIVITY_IN 2529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see TelephonyManager#DATA_ACTIVITY_OUT 2539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see TelephonyManager#DATA_ACTIVITY_INOUT 254e9b06d754af03faf27012fbed1e7559ec1ba7c79Wink Saville * @see TelephonyManager#DATA_ACTIVITY_DORMANT 2559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void onDataActivity(int direction) { 2579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // default implementation empty 2589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 261e9b06d754af03faf27012fbed1e7559ec1ba7c79Wink Saville * Callback invoked when network signal strengths changes. 262e9b06d754af03faf27012fbed1e7559ec1ba7c79Wink Saville * 263e9b06d754af03faf27012fbed1e7559ec1ba7c79Wink Saville * @see ServiceState#STATE_EMERGENCY_ONLY 264e9b06d754af03faf27012fbed1e7559ec1ba7c79Wink Saville * @see ServiceState#STATE_IN_SERVICE 265e9b06d754af03faf27012fbed1e7559ec1ba7c79Wink Saville * @see ServiceState#STATE_OUT_OF_SERVICE 266e9b06d754af03faf27012fbed1e7559ec1ba7c79Wink Saville * @see ServiceState#STATE_POWER_OFF 267e9b06d754af03faf27012fbed1e7559ec1ba7c79Wink Saville */ 268e9b06d754af03faf27012fbed1e7559ec1ba7c79Wink Saville public void onSignalStrengthsChanged(SignalStrength signalStrength) { 269e9b06d754af03faf27012fbed1e7559ec1ba7c79Wink Saville // default implementation empty 270e9b06d754af03faf27012fbed1e7559ec1ba7c79Wink Saville } 271e9b06d754af03faf27012fbed1e7559ec1ba7c79Wink Saville 272fd2d01302781af91d77557a99874111a4fee8365Wink Saville 273fd2d01302781af91d77557a99874111a4fee8365Wink Saville /** 274fd2d01302781af91d77557a99874111a4fee8365Wink Saville * The Over The Air Service Provisioning (OTASP) has changed. Requires 275fd2d01302781af91d77557a99874111a4fee8365Wink Saville * the READ_PHONE_STATE permission. 276fd2d01302781af91d77557a99874111a4fee8365Wink Saville * @param otaspMode is integer <code>OTASP_UNKNOWN=1<code> 277fd2d01302781af91d77557a99874111a4fee8365Wink Saville * means the value is currently unknown and the system should wait until 278fd2d01302781af91d77557a99874111a4fee8365Wink Saville * <code>OTASP_NEEDED=2<code> or <code>OTASP_NOT_NEEDED=3<code> is received before 279fd2d01302781af91d77557a99874111a4fee8365Wink Saville * making the decisision to perform OTASP or not. 280fd2d01302781af91d77557a99874111a4fee8365Wink Saville * 281fd2d01302781af91d77557a99874111a4fee8365Wink Saville * @hide 282fd2d01302781af91d77557a99874111a4fee8365Wink Saville */ 283fd2d01302781af91d77557a99874111a4fee8365Wink Saville public void onOtaspChanged(int otaspMode) { 284fd2d01302781af91d77557a99874111a4fee8365Wink Saville // default implementation empty 285fd2d01302781af91d77557a99874111a4fee8365Wink Saville } 286fd2d01302781af91d77557a99874111a4fee8365Wink Saville 287e9b06d754af03faf27012fbed1e7559ec1ba7c79Wink Saville /** 288b208a24cf521401912cfce16fce550a995cf1250Wink Saville * Callback invoked when a observed cell info has changed, 289b208a24cf521401912cfce16fce550a995cf1250Wink Saville * or new cells have been added or removed. 290b208a24cf521401912cfce16fce550a995cf1250Wink Saville * @param cellInfo is the list of currently visible cells. 291963db55d59a170f4b17ff907c96615a19ef6fe17John Wang */ 292b208a24cf521401912cfce16fce550a995cf1250Wink Saville public void onCellInfoChanged(List<CellInfo> cellInfo) { 293963db55d59a170f4b17ff907c96615a19ef6fe17John Wang } 294963db55d59a170f4b17ff907c96615a19ef6fe17John Wang 295963db55d59a170f4b17ff907c96615a19ef6fe17John Wang /** 2969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The callback methods need to be called on the handler thread where 2979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * this object was created. If the binder did that for us it'd be nice. 2989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IPhoneStateListener callback = new IPhoneStateListener.Stub() { 3009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void onServiceStateChanged(ServiceState serviceState) { 3019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Message.obtain(mHandler, LISTEN_SERVICE_STATE, 0, 0, serviceState).sendToTarget(); 3029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void onSignalStrengthChanged(int asu) { 3059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Message.obtain(mHandler, LISTEN_SIGNAL_STRENGTH, asu, 0, null).sendToTarget(); 3069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void onMessageWaitingIndicatorChanged(boolean mwi) { 3099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Message.obtain(mHandler, LISTEN_MESSAGE_WAITING_INDICATOR, mwi ? 1 : 0, 0, null) 3109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project .sendToTarget(); 3119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void onCallForwardingIndicatorChanged(boolean cfi) { 3149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Message.obtain(mHandler, LISTEN_CALL_FORWARDING_INDICATOR, cfi ? 1 : 0, 0, null) 3159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project .sendToTarget(); 3169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void onCellLocationChanged(Bundle bundle) { 3199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project CellLocation location = CellLocation.newFromBundle(bundle); 3209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Message.obtain(mHandler, LISTEN_CELL_LOCATION, 0, 0, location).sendToTarget(); 3219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void onCallStateChanged(int state, String incomingNumber) { 3249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Message.obtain(mHandler, LISTEN_CALL_STATE, state, 0, incomingNumber).sendToTarget(); 3259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 32798e0b146b80670b52805b4b210ef5582dad6bb68Robert Greenwalt public void onDataConnectionStateChanged(int state, int networkType) { 32802648a4b8422733ed401f07edf8e426318bb2f8dRobert Greenwalt Message.obtain(mHandler, LISTEN_DATA_CONNECTION_STATE, state, networkType). 32998e0b146b80670b52805b4b210ef5582dad6bb68Robert Greenwalt sendToTarget(); 3309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void onDataActivity(int direction) { 3339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Message.obtain(mHandler, LISTEN_DATA_ACTIVITY, direction, 0, null).sendToTarget(); 3349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 335fd2d01302781af91d77557a99874111a4fee8365Wink Saville 336e9b06d754af03faf27012fbed1e7559ec1ba7c79Wink Saville public void onSignalStrengthsChanged(SignalStrength signalStrength) { 337e9b06d754af03faf27012fbed1e7559ec1ba7c79Wink Saville Message.obtain(mHandler, LISTEN_SIGNAL_STRENGTHS, 0, 0, signalStrength).sendToTarget(); 338e9b06d754af03faf27012fbed1e7559ec1ba7c79Wink Saville } 339fd2d01302781af91d77557a99874111a4fee8365Wink Saville 340fd2d01302781af91d77557a99874111a4fee8365Wink Saville public void onOtaspChanged(int otaspMode) { 341fd2d01302781af91d77557a99874111a4fee8365Wink Saville Message.obtain(mHandler, LISTEN_OTASP_CHANGED, otaspMode, 0).sendToTarget(); 342fd2d01302781af91d77557a99874111a4fee8365Wink Saville } 343963db55d59a170f4b17ff907c96615a19ef6fe17John Wang 344b208a24cf521401912cfce16fce550a995cf1250Wink Saville public void onCellInfoChanged(List<CellInfo> cellInfo) { 345b208a24cf521401912cfce16fce550a995cf1250Wink Saville Message.obtain(mHandler, LISTEN_CELL_INFO, 0, 0, cellInfo).sendToTarget(); 346963db55d59a170f4b17ff907c96615a19ef6fe17John Wang } 3479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project }; 3489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Handler mHandler = new Handler() { 3509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void handleMessage(Message msg) { 3519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //Log.d("TelephonyRegistry", "what=0x" + Integer.toHexString(msg.what) + " msg=" + msg); 3529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project switch (msg.what) { 3539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project case LISTEN_SERVICE_STATE: 3549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project PhoneStateListener.this.onServiceStateChanged((ServiceState)msg.obj); 3559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project break; 3569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project case LISTEN_SIGNAL_STRENGTH: 3579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project PhoneStateListener.this.onSignalStrengthChanged(msg.arg1); 3589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project break; 3599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project case LISTEN_MESSAGE_WAITING_INDICATOR: 3609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project PhoneStateListener.this.onMessageWaitingIndicatorChanged(msg.arg1 != 0); 3619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project break; 3629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project case LISTEN_CALL_FORWARDING_INDICATOR: 3639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project PhoneStateListener.this.onCallForwardingIndicatorChanged(msg.arg1 != 0); 3649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project break; 3659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project case LISTEN_CELL_LOCATION: 3669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project PhoneStateListener.this.onCellLocationChanged((CellLocation)msg.obj); 3679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project break; 3689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project case LISTEN_CALL_STATE: 3699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project PhoneStateListener.this.onCallStateChanged(msg.arg1, (String)msg.obj); 3709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project break; 3719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project case LISTEN_DATA_CONNECTION_STATE: 37298e0b146b80670b52805b4b210ef5582dad6bb68Robert Greenwalt PhoneStateListener.this.onDataConnectionStateChanged(msg.arg1, msg.arg2); 3739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project PhoneStateListener.this.onDataConnectionStateChanged(msg.arg1); 3749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project break; 3759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project case LISTEN_DATA_ACTIVITY: 3769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project PhoneStateListener.this.onDataActivity(msg.arg1); 3779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project break; 378e9b06d754af03faf27012fbed1e7559ec1ba7c79Wink Saville case LISTEN_SIGNAL_STRENGTHS: 379e9b06d754af03faf27012fbed1e7559ec1ba7c79Wink Saville PhoneStateListener.this.onSignalStrengthsChanged((SignalStrength)msg.obj); 380e9b06d754af03faf27012fbed1e7559ec1ba7c79Wink Saville break; 381fd2d01302781af91d77557a99874111a4fee8365Wink Saville case LISTEN_OTASP_CHANGED: 382fd2d01302781af91d77557a99874111a4fee8365Wink Saville PhoneStateListener.this.onOtaspChanged(msg.arg1); 383fd2d01302781af91d77557a99874111a4fee8365Wink Saville break; 384963db55d59a170f4b17ff907c96615a19ef6fe17John Wang case LISTEN_CELL_INFO: 385b208a24cf521401912cfce16fce550a995cf1250Wink Saville PhoneStateListener.this.onCellInfoChanged((List<CellInfo>)msg.obj); 3869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project }; 3899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project} 390