com.vodafone.v10.system.device
Interface RingStateListener

All Known Implementing Classes:
ResidentMIDlet

public interface RingStateListener

RingStateListener is an interface for implementing a listener to wait for state changes in incoming call notification to the user (ringing).

If the MIDlet is resident, notification to the user of incoming calls, mail arrival or scheduled alarms is made in the native system. RingStateListener is then used as an interface for implementing a listener to wait for the events indicating the start and end of this user notification. To register a listener implementing this interface, call the DeviceControl setRingStateListener() method.


Method Summary
 void ringStarted()
          Called when call incoming notification was started.
 void ringStopped()
          Called when ringing stops.
 

Method Detail

ringStarted

public void ringStarted()
Called when call incoming notification was started.

Before this method is called, any media player handling sound or sound player is stopped. Vibrator and LCD backlight control is stopped as well.

A RuntimeException will be thrown if a sound-using media player, sound player, vibrator, or LCD backlight is used after this method is called and before ringStopped() is called (except when used inside ringStopped()).


ringStopped

public void ringStopped()
Called when ringing stops.

A media player or sound player stopped when ringStarted() was called will not be resumed automatically.

After this method has been called, a stopped media player or sound player can be resumed.



Copyright 2002,2003 Aplix Corporation. All rights reserved. Aplix Confidential and Restricted.