telephony/java/com/android/internal/telephony/ITelephony.aidl - platform/frameworks/base - Git at Google

 /*
  * Copyright (C) 2007 The Android Open Source Project
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
  * You may obtain a copy of the License at
  *
  *      http://www.apache.org/licenses/LICENSE-2.0
  *
  * Unless required by applicable law or agreed to in writing, software
  * distributed under the License is distributed on an "AS IS" BASIS,
  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */

 package com.android.internal.telephony;

 import android.os.Bundle;
 import android.telephony.CellInfo;
 import android.telephony.NeighboringCellInfo;

 import com.android.internal.telephony.ITelephonyListener;

 import java.util.List;

 /**
  * Interface used to interact with the phone.  Mostly this is used by the
  * TelephonyManager class.  A few places are still using this directly.
  * Please clean them up if possible and use TelephonyManager insteadl.
  *
  * {@hide}
  */
 interface ITelephony {

     /**
      * Dial a number. This doesn't place the call. It displays
      * the Dialer screen.
      * @param number the number to be dialed. If null, this
      * would display the Dialer screen with no number pre-filled.
      */
     void dial(String number);

     /**
      * Place a call to the specified number.
      * @param number the number to be called.
      */
     void call(String callingPackage, String number);

     /**
      * If there is currently a call in progress, show the call screen.
      * The DTMF dialpad may or may not be visible initially, depending on
      * whether it was up when the user last exited the InCallScreen.
      *
      * @return true if the call screen was shown.
      */
     boolean showCallScreen();

     /**
      * Variation of showCallScreen() that also specifies whether the
      * DTMF dialpad should be initially visible when the InCallScreen
      * comes up.
      *
      * @param showDialpad if true, make the dialpad visible initially,
      *                    otherwise hide the dialpad initially.
      * @return true if the call screen was shown.
      *
      * @see showCallScreen
      */
     boolean showCallScreenWithDialpad(boolean showDialpad);

     /**
      * End call if there is a call in progress, otherwise does nothing.
      *
      * @return whether it hung up
      */
     boolean endCall();

     /**
      * Answer the currently-ringing call.
      *
      * If there's already a current active call, that call will be
      * automatically put on hold.  If both lines are currently in use, the
      * current active call will be ended.
      *
      * TODO: provide a flag to let the caller specify what policy to use
      * if both lines are in use.  (The current behavior is hardwired to
      * "answer incoming, end ongoing", which is how the CALL button
      * is specced to behave.)
      *
      * TODO: this should be a oneway call (especially since it's called
      * directly from the key queue thread).
      */
     void answerRingingCall();

     /**
      * Silence the ringer if an incoming call is currently ringing.
      * (If vibrating, stop the vibrator also.)
      *
      * It's safe to call this if the ringer has already been silenced, or
      * even if there's no incoming call.  (If so, this method will do nothing.)
      *
      * TODO: this should be a oneway call too (see above).
      *       (Actually *all* the methods here that return void can
      *       probably be oneway.)
      */
     void silenceRinger();

     /**
      * Check if we are in either an active or holding call
      * @return true if the phone state is OFFHOOK.
      */
     boolean isOffhook();

     /**
      * Check if an incoming phone call is ringing or call waiting.
      * @return true if the phone state is RINGING.
      */
     boolean isRinging();

     /**
      * Check if the phone is idle.
      * @return true if the phone state is IDLE.
      */
     boolean isIdle();

     /**
      * Check to see if the radio is on or not.
      * @return returns true if the radio is on.
      */
     boolean isRadioOn();

     /**
      * Check if the SIM pin lock is enabled.
      * @return true if the SIM pin lock is enabled.
      */
     boolean isSimPinEnabled();

     /**
      * Cancels the missed calls notification.
      */
     void cancelMissedCallsNotification();

     /**
      * Supply a pin to unlock the SIM.  Blocks until a result is determined.
      * @param pin The pin to check.
      * @return whether the operation was a success.
      */
     boolean supplyPin(String pin);

     /**
      * Supply puk to unlock the SIM and set SIM pin to new pin.
      *  Blocks until a result is determined.
      * @param puk The puk to check.
      *        pin The new pin to be set in SIM
      * @return whether the operation was a success.
      */
     boolean supplyPuk(String puk, String pin);

     /**
      * Supply a pin to unlock the SIM.  Blocks until a result is determined.
      * Returns a specific success/error code.
      * @param pin The pin to check.
      * @return retValue[0] = Phone.PIN_RESULT_SUCCESS on success. Otherwise error code
      *         retValue[1] = number of attempts remaining if known otherwise -1
      */
     int[] supplyPinReportResult(String pin);

     /**
      * Supply puk to unlock the SIM and set SIM pin to new pin.
      * Blocks until a result is determined.
      * Returns a specific success/error code
      * @param puk The puk to check
      *        pin The pin to check.
      * @return retValue[0] = Phone.PIN_RESULT_SUCCESS on success. Otherwise error code
      *         retValue[1] = number of attempts remaining if known otherwise -1
      */
     int[] supplyPukReportResult(String puk, String pin);

     /**
      * Handles PIN MMI commands (PIN/PIN2/PUK/PUK2), which are initiated
      * without SEND (so <code>dial</code> is not appropriate).
      *
      * @param dialString the MMI command to be executed.
      * @return true if MMI command is executed.
      */
     boolean handlePinMmi(String dialString);

     /**
      * Toggles the radio on or off.
      */
     void toggleRadioOnOff();

     /**
      * Set the radio to on or off
      */
     boolean setRadio(boolean turnOn);

     /**
      * Set the radio to on or off unconditionally
      */
     boolean setRadioPower(boolean turnOn);

     /**
      * Request to update location information in service state
      */
     void updateServiceLocation();

     /**
      * Enable location update notifications.
      */
     void enableLocationUpdates();

     /**
      * Disable location update notifications.
      */
     void disableLocationUpdates();

     /**
      * Enable a specific APN type.
      */
     int enableApnType(String type);

     /**
      * Disable a specific APN type.
      */
     int disableApnType(String type);

     /**
      * Allow mobile data connections.
      */
     boolean enableDataConnectivity();

     /**
      * Disallow mobile data connections.
      */
     boolean disableDataConnectivity();

     /**
      * Report whether data connectivity is possible.
      */
     boolean isDataConnectivityPossible();

     Bundle getCellLocation();

     /**
      * Returns the neighboring cell information of the device.
      */
     List<NeighboringCellInfo> getNeighboringCellInfo(String callingPkg);

      int getCallState();
      int getDataActivity();
      int getDataState();

     /**
      * Returns the current active phone type as integer.
      * Returns TelephonyManager.PHONE_TYPE_CDMA if RILConstants.CDMA_PHONE
      * and TelephonyManager.PHONE_TYPE_GSM if RILConstants.GSM_PHONE
      */
     int getActivePhoneType();

     /**
      * Returns the CDMA ERI icon index to display
      */
     int getCdmaEriIconIndex();

     /**
      * Returns the CDMA ERI icon mode,
      * 0 - ON
      * 1 - FLASHING
      */
     int getCdmaEriIconMode();

     /**
      * Returns the CDMA ERI text,
      */
     String getCdmaEriText();

     /**
      * Returns true if OTA service provisioning needs to run.
      * Only relevant on some technologies, others will always
      * return false.
      */
     boolean needsOtaServiceProvisioning();

     /**
       * Returns the unread count of voicemails
       */
     int getVoiceMessageCount();

     /**
       * Returns the network type for data transmission
       */
     int getNetworkType();

     /**
       * Returns the network type for data transmission
       */
     int getDataNetworkType();

     /**
       * Returns the network type for voice
       */
     int getVoiceNetworkType();

     /**
      * Return true if an ICC card is present
      */
     boolean hasIccCard();

     /**
      * Return if the current radio is LTE on CDMA. This
      * is a tri-state return value as for a period of time
      * the mode may be unknown.
      *
      * @return {@link Phone#LTE_ON_CDMA_UNKNOWN}, {@link Phone#LTE_ON_CDMA_FALSE}
      * or {@link PHone#LTE_ON_CDMA_TRUE}
      */
     int getLteOnCdmaMode();

     /**
      * Returns the all observed cell information of the device.
      */
     List<CellInfo> getAllCellInfo();

     /**
      * Sets minimum time in milli-seconds between onCellInfoChanged
      */
     void setCellInfoListRate(int rateInMillis);

     /**
      * Opens a logical channel to the ICC card.
      *
      * Input parameters equivalent to TS 27.007 AT+CCHO command.
      *
      * @param AID Application id. See ETSI 102.221 and 101.220.
      * @return The logical channel id which is set to -1 on error.
      */
     int iccOpenLogicalChannel(String AID);

     /**
      * Closes a previously opened logical channel to the ICC card.
      *
      * Input parameters equivalent to TS 27.007 AT+CCHC command.
      *
      * @param channel is the channel id to be closed as retruned by a
      *            successful iccOpenLogicalChannel.
      * @return true if the channel was closed successfully.
      */
     boolean iccCloseLogicalChannel(int channel);

     /**
      * Transmit an APDU to the ICC card over a logical channel.
      *
      * Input parameters equivalent to TS 27.007 AT+CGLA command.
      *
      * @param channel is the channel id to be closed as retruned by a
      *            successful iccOpenLogicalChannel.
      * @param cla Class of the APDU command.
      * @param instruction Instruction of the APDU command.
      * @param p1 P1 value of the APDU command.
      * @param p2 P2 value of the APDU command.
      * @param p3 P3 value of the APDU command. If p3 is negative a 4 byte APDU
      *            is sent to the SIM.
      * @param data Data to be sent with the APDU.
      * @return The APDU response from the ICC card with the status appended at
      *            the end. If an error occurs, an empty string is returned.
      */
     String iccTransmitApduLogicalChannel(int channel, int cla, int instruction,
             int p1, int p2, int p3, String data);

     /**
      * Read one of the NV items defined in {@link RadioNVItems} / {@code ril_nv_items.h}.
      * Used for device configuration by some CDMA operators.
      *
      * @param itemID the ID of the item to read.
      * @return the NV item as a String, or null on any failure.
      */
     String nvReadItem(int itemID);

     /**
      * Write one of the NV items defined in {@link RadioNVItems} / {@code ril_nv_items.h}.
      * Used for device configuration by some CDMA operators.
      *
      * @param itemID the ID of the item to read.
      * @param itemValue the value to write, as a String.
      * @return true on success; false on any failure.
      */
     boolean nvWriteItem(int itemID, String itemValue);

     /**
      * Update the CDMA Preferred Roaming List (PRL) in the radio NV storage.
      * Used for device configuration by some CDMA operators.
      *
      * @param preferredRoamingList byte array containing the new PRL.
      * @return true on success; false on any failure.
      */
     boolean nvWriteCdmaPrl(in byte[] preferredRoamingList);

     /**
      * Perform the specified type of NV config reset. The radio will be taken offline
      * and the device must be rebooted after the operation. Used for device
      * configuration by some CDMA operators.
      *
      * @param resetType the type of reset to perform (1 == factory reset; 2 == NV-only reset).
      * @return true on success; false on any failure.
      */
     boolean nvResetConfig(int resetType);

     /**
      * Get the preferred network type.
      * Used for device configuration by some CDMA operators.
      *
      * @return the preferred network type, defined in RILConstants.java.
      */
     int getPreferredNetworkType();

     /**
      * Set the preferred network type.
      * Used for device configuration by some CDMA operators.
      *
      * @param networkType the preferred network type, defined in RILConstants.java.
      * @return true on success; false on any failure.
      */
     boolean setPreferredNetworkType(int networkType);

     /**
      * Put a call on hold.
      */
      void toggleHold();

      /**
       * Merge foreground and background calls.
       */
      void merge();

      /**
       * Swap foreground and background calls.
       */
      void swap();

      /**
       * Mute the phone.
       */
      void mute(boolean mute);

     /**
      * Start playing DTMF tone for the specified digit.
      *
      * @param digit the digit that corresponds with the desired tone.
      * @param timedShortcode whether the specified digit should be played as a timed short code.
      */
      void playDtmfTone(char digit, boolean timedShortCode);

      /**
       * Stop playing DTMF tones.
       */
      void stopDtmfTone();

      /**
        * Register a callback.
        */
       void addListener(ITelephonyListener listener);

       /**
        * Unregister a callback.
        */
       void removeListener(ITelephonyListener listener);
 }
	/*
	* Copyright (C) 2007 The Android Open Source Project
	*
	* Licensed under the Apache License, Version 2.0 (the "License");
	* you may not use this file except in compliance with the License.
	* You may obtain a copy of the License at
	*
	* http://www.apache.org/licenses/LICENSE-2.0
	*
	* Unless required by applicable law or agreed to in writing, software
	* distributed under the License is distributed on an "AS IS" BASIS,
	* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
	* See the License for the specific language governing permissions and
	* limitations under the License.
	*/

	package com.android.internal.telephony;

	import android.os.Bundle;
	import android.telephony.CellInfo;
	import android.telephony.NeighboringCellInfo;

	import com.android.internal.telephony.ITelephonyListener;

	import java.util.List;

	/**
	* Interface used to interact with the phone. Mostly this is used by the
	* TelephonyManager class. A few places are still using this directly.
	* Please clean them up if possible and use TelephonyManager insteadl.
	*
	* {@hide}
	*/
	interface ITelephony {

	/**
	* Dial a number. This doesn't place the call. It displays
	* the Dialer screen.
	* @param number the number to be dialed. If null, this
	* would display the Dialer screen with no number pre-filled.
	*/
	void dial(String number);

	/**
	* Place a call to the specified number.
	* @param number the number to be called.
	*/
	void call(String callingPackage, String number);

	/**
	* If there is currently a call in progress, show the call screen.
	* The DTMF dialpad may or may not be visible initially, depending on
	* whether it was up when the user last exited the InCallScreen.
	*
	* @return true if the call screen was shown.
	*/
	boolean showCallScreen();

	/**
	* Variation of showCallScreen() that also specifies whether the
	* DTMF dialpad should be initially visible when the InCallScreen
	* comes up.
	*
	* @param showDialpad if true, make the dialpad visible initially,
	* otherwise hide the dialpad initially.
	* @return true if the call screen was shown.
	*
	* @see showCallScreen
	*/
	boolean showCallScreenWithDialpad(boolean showDialpad);

	/**
	* End call if there is a call in progress, otherwise does nothing.
	*
	* @return whether it hung up
	*/
	boolean endCall();

	/**
	* Answer the currently-ringing call.
	*
	* If there's already a current active call, that call will be
	* automatically put on hold. If both lines are currently in use, the
	* current active call will be ended.
	*
	* TODO: provide a flag to let the caller specify what policy to use
	* if both lines are in use. (The current behavior is hardwired to
	* "answer incoming, end ongoing", which is how the CALL button
	* is specced to behave.)
	*
	* TODO: this should be a oneway call (especially since it's called
	* directly from the key queue thread).
	*/
	void answerRingingCall();

	/**
	* Silence the ringer if an incoming call is currently ringing.
	* (If vibrating, stop the vibrator also.)
	*
	* It's safe to call this if the ringer has already been silenced, or
	* even if there's no incoming call. (If so, this method will do nothing.)
	*
	* TODO: this should be a oneway call too (see above).
	* (Actually all the methods here that return void can
	* probably be oneway.)
	*/
	void silenceRinger();

	/**
	* Check if we are in either an active or holding call
	* @return true if the phone state is OFFHOOK.
	*/
	boolean isOffhook();

	/**
	* Check if an incoming phone call is ringing or call waiting.
	* @return true if the phone state is RINGING.
	*/
	boolean isRinging();

	/**
	* Check if the phone is idle.
	* @return true if the phone state is IDLE.
	*/
	boolean isIdle();

	/**
	* Check to see if the radio is on or not.
	* @return returns true if the radio is on.
	*/
	boolean isRadioOn();

	/**
	* Check if the SIM pin lock is enabled.
	* @return true if the SIM pin lock is enabled.
	*/
	boolean isSimPinEnabled();

	/**
	* Cancels the missed calls notification.
	*/
	void cancelMissedCallsNotification();

	/**
	* Supply a pin to unlock the SIM. Blocks until a result is determined.
	* @param pin The pin to check.
	* @return whether the operation was a success.
	*/
	boolean supplyPin(String pin);

	/**
	* Supply puk to unlock the SIM and set SIM pin to new pin.
	* Blocks until a result is determined.
	* @param puk The puk to check.
	* pin The new pin to be set in SIM
	* @return whether the operation was a success.
	*/
	boolean supplyPuk(String puk, String pin);

	/**
	* Supply a pin to unlock the SIM. Blocks until a result is determined.
	* Returns a specific success/error code.
	* @param pin The pin to check.
	* @return retValue[0] = Phone.PIN_RESULT_SUCCESS on success. Otherwise error code
	* retValue[1] = number of attempts remaining if known otherwise -1
	*/
	int[] supplyPinReportResult(String pin);

	/**
	* Supply puk to unlock the SIM and set SIM pin to new pin.
	* Blocks until a result is determined.
	* Returns a specific success/error code
	* @param puk The puk to check
	* pin The pin to check.
	* @return retValue[0] = Phone.PIN_RESULT_SUCCESS on success. Otherwise error code
	* retValue[1] = number of attempts remaining if known otherwise -1
	*/
	int[] supplyPukReportResult(String puk, String pin);

	/**
	* Handles PIN MMI commands (PIN/PIN2/PUK/PUK2), which are initiated
	* without SEND (so <code>dial</code> is not appropriate).
	*
	* @param dialString the MMI command to be executed.
	* @return true if MMI command is executed.
	*/
	boolean handlePinMmi(String dialString);

	/**
	* Toggles the radio on or off.
	*/
	void toggleRadioOnOff();

	/**
	* Set the radio to on or off
	*/
	boolean setRadio(boolean turnOn);

	/**
	* Set the radio to on or off unconditionally
	*/
	boolean setRadioPower(boolean turnOn);

	/**
	* Request to update location information in service state
	*/
	void updateServiceLocation();

	/**
	* Enable location update notifications.
	*/
	void enableLocationUpdates();

	/**
	* Disable location update notifications.
	*/
	void disableLocationUpdates();

	/**
	* Enable a specific APN type.
	*/
	int enableApnType(String type);

	/**
	* Disable a specific APN type.
	*/
	int disableApnType(String type);

	/**
	* Allow mobile data connections.
	*/
	boolean enableDataConnectivity();

	/**
	* Disallow mobile data connections.
	*/
	boolean disableDataConnectivity();

	/**
	* Report whether data connectivity is possible.
	*/
	boolean isDataConnectivityPossible();

	Bundle getCellLocation();

	/**
	* Returns the neighboring cell information of the device.
	*/
	List<NeighboringCellInfo> getNeighboringCellInfo(String callingPkg);

	int getCallState();
	int getDataActivity();
	int getDataState();

	/**
	* Returns the current active phone type as integer.
	* Returns TelephonyManager.PHONE_TYPE_CDMA if RILConstants.CDMA_PHONE
	* and TelephonyManager.PHONE_TYPE_GSM if RILConstants.GSM_PHONE
	*/
	int getActivePhoneType();

	/**
	* Returns the CDMA ERI icon index to display
	*/
	int getCdmaEriIconIndex();

	/**
	* Returns the CDMA ERI icon mode,
	* 0 - ON
	* 1 - FLASHING
	*/
	int getCdmaEriIconMode();

	/**
	* Returns the CDMA ERI text,
	*/
	String getCdmaEriText();

	/**
	* Returns true if OTA service provisioning needs to run.
	* Only relevant on some technologies, others will always
	* return false.
	*/
	boolean needsOtaServiceProvisioning();

	/**
	* Returns the unread count of voicemails
	*/
	int getVoiceMessageCount();

	/**
	* Returns the network type for data transmission
	*/
	int getNetworkType();

	/**
	* Returns the network type for data transmission
	*/
	int getDataNetworkType();

	/**
	* Returns the network type for voice
	*/
	int getVoiceNetworkType();

	/**
	* Return true if an ICC card is present
	*/
	boolean hasIccCard();

	/**
	* Return if the current radio is LTE on CDMA. This
	* is a tri-state return value as for a period of time
	* the mode may be unknown.
	*
	* @return {@link Phone#LTE_ON_CDMA_UNKNOWN}, {@link Phone#LTE_ON_CDMA_FALSE}
	* or {@link PHone#LTE_ON_CDMA_TRUE}
	*/
	int getLteOnCdmaMode();

	/**
	* Returns the all observed cell information of the device.
	*/
	List<CellInfo> getAllCellInfo();

	/**
	* Sets minimum time in milli-seconds between onCellInfoChanged
	*/
	void setCellInfoListRate(int rateInMillis);

	/**
	* Opens a logical channel to the ICC card.
	*
	* Input parameters equivalent to TS 27.007 AT+CCHO command.
	*
	* @param AID Application id. See ETSI 102.221 and 101.220.
	* @return The logical channel id which is set to -1 on error.
	*/
	int iccOpenLogicalChannel(String AID);

	/**
	* Closes a previously opened logical channel to the ICC card.
	*
	* Input parameters equivalent to TS 27.007 AT+CCHC command.
	*
	* @param channel is the channel id to be closed as retruned by a
	* successful iccOpenLogicalChannel.
	* @return true if the channel was closed successfully.
	*/
	boolean iccCloseLogicalChannel(int channel);

	/**
	* Transmit an APDU to the ICC card over a logical channel.
	*
	* Input parameters equivalent to TS 27.007 AT+CGLA command.
	*
	* @param channel is the channel id to be closed as retruned by a
	* successful iccOpenLogicalChannel.
	* @param cla Class of the APDU command.
	* @param instruction Instruction of the APDU command.
	* @param p1 P1 value of the APDU command.
	* @param p2 P2 value of the APDU command.
	* @param p3 P3 value of the APDU command. If p3 is negative a 4 byte APDU
	* is sent to the SIM.
	* @param data Data to be sent with the APDU.
	* @return The APDU response from the ICC card with the status appended at
	* the end. If an error occurs, an empty string is returned.
	*/
	String iccTransmitApduLogicalChannel(int channel, int cla, int instruction,
	int p1, int p2, int p3, String data);

	/**
	* Read one of the NV items defined in {@link RadioNVItems} / {@code ril_nv_items.h}.
	* Used for device configuration by some CDMA operators.
	*
	* @param itemID the ID of the item to read.
	* @return the NV item as a String, or null on any failure.
	*/
	String nvReadItem(int itemID);

	/**
	* Write one of the NV items defined in {@link RadioNVItems} / {@code ril_nv_items.h}.
	* Used for device configuration by some CDMA operators.
	*
	* @param itemID the ID of the item to read.
	* @param itemValue the value to write, as a String.
	* @return true on success; false on any failure.
	*/
	boolean nvWriteItem(int itemID, String itemValue);

	/**
	* Update the CDMA Preferred Roaming List (PRL) in the radio NV storage.
	* Used for device configuration by some CDMA operators.
	*
	* @param preferredRoamingList byte array containing the new PRL.
	* @return true on success; false on any failure.
	*/
	boolean nvWriteCdmaPrl(in byte[] preferredRoamingList);

	/**
	* Perform the specified type of NV config reset. The radio will be taken offline
	* and the device must be rebooted after the operation. Used for device
	* configuration by some CDMA operators.
	*
	* @param resetType the type of reset to perform (1 == factory reset; 2 == NV-only reset).
	* @return true on success; false on any failure.
	*/
	boolean nvResetConfig(int resetType);

	/**
	* Get the preferred network type.
	* Used for device configuration by some CDMA operators.
	*
	* @return the preferred network type, defined in RILConstants.java.
	*/
	int getPreferredNetworkType();

	/**
	* Set the preferred network type.
	* Used for device configuration by some CDMA operators.
	*
	* @param networkType the preferred network type, defined in RILConstants.java.
	* @return true on success; false on any failure.
	*/
	boolean setPreferredNetworkType(int networkType);

	/**
	* Put a call on hold.
	*/
	void toggleHold();

	/**
	* Merge foreground and background calls.
	*/
	void merge();

	/**
	* Swap foreground and background calls.
	*/
	void swap();

	/**
	* Mute the phone.
	*/
	void mute(boolean mute);

	/**
	* Start playing DTMF tone for the specified digit.
	*
	* @param digit the digit that corresponds with the desired tone.
	* @param timedShortcode whether the specified digit should be played as a timed short code.
	*/
	void playDtmfTone(char digit, boolean timedShortCode);

	/**
	* Stop playing DTMF tones.
	*/
	void stopDtmfTone();

	/**
	* Register a callback.
	*/
	void addListener(ITelephonyListener listener);

	/**
	* Unregister a callback.
	*/
	void removeListener(ITelephonyListener listener);
	}