public
class
ToneGenerator
extends Object
java.lang.Object | |
↳ | android.media.ToneGenerator |
This class provides methods to play DTMF tones (ITU-T Recommendation Q.23), call supervisory tones (3GPP TS 22.001, CEPT) and proprietary tones (3GPP TS 31.111). Depending on call state and routing options, tones are mixed to the downlink audio or output to the speaker phone or headset. This API is not for generating tones over the uplink audio path.
Constants | |
---|---|
int |
MAX_VOLUME
Maximum volume, for use with |
int |
MIN_VOLUME
Minimum volume setting, for use with |
int |
TONE_CDMA_ABBR_ALERT
CDMA_ABBR_ALERT tone: 1150Hz+770Hz 400ms ON |
int |
TONE_CDMA_ABBR_INTERCEPT
CDMA Abbr Intercept tone: 440Hz 250ms ON, 620Hz 250ms ON |
int |
TONE_CDMA_ABBR_REORDER
CDMA Abbr Reorder tone: 480Hz+620Hz 250ms ON, 250ms OFF repeated for 8 times |
int |
TONE_CDMA_ALERT_AUTOREDIAL_LITE
CDMA Alert Auto Redial tone: {1245Hz 62ms ON, 659Hz 62ms ON} 3 times, 1245 62ms ON |
int |
TONE_CDMA_ALERT_CALL_GUARD
CDMA ALERT CALL GUARD tone: {1319Hz 125ms ON, 125ms OFF} 3 times |
int |
TONE_CDMA_ALERT_INCALL_LITE
CDMA ALERT INCALL LITE tone: 587Hz 62ms, 784 62ms, 831Hz 62ms, 784Hz 62ms, 1109 62ms, 784Hz 62ms, 831Hz 62ms, 784Hz 62ms |
int |
TONE_CDMA_ALERT_NETWORK_LITE
CDMA Alert Network Lite tone: 1109Hz 62ms ON, 784Hz 62ms ON, 740Hz 62ms ON 622Hz 62ms ON, 1109Hz 62ms ON |
int |
TONE_CDMA_ANSWER
CDMA answer tone: silent tone - defintion Frequency 0, 0ms ON, 0ms OFF |
int |
TONE_CDMA_CALLDROP_LITE
CDMA CALLDROP LITE tone: 1480Hz 125ms, 1397Hz 125ms, 784Hz 125ms |
int |
TONE_CDMA_CALL_SIGNAL_ISDN_INTERGROUP
ISDN Call Signal Intergroup tone: {2091Hz 32ms ON, 2556 64ms ON} 8 times, 2091Hz 32ms ON, 400ms OFF, {2091Hz 32ms ON, 2556Hz 64ms ON} times, 2091Hz 32ms ON, 4s OFF. |
int |
TONE_CDMA_CALL_SIGNAL_ISDN_NORMAL
ISDN Call Signal Normal tone: {2091Hz 32ms ON, 2556 64ms ON} 20 times, 2091 32ms ON, 2556 48ms ON, 4s OFF |
int |
TONE_CDMA_CALL_SIGNAL_ISDN_PAT3
ISDN Call sign PAT3 tone: silent tone |
int |
TONE_CDMA_CALL_SIGNAL_ISDN_PAT5
ISDN Pat5 tone: silent tone |
int |
TONE_CDMA_CALL_SIGNAL_ISDN_PAT6
ISDN Pat6 tone: silent tone |
int |
TONE_CDMA_CALL_SIGNAL_ISDN_PAT7
ISDN Pat7 tone: silent tone |
int |
TONE_CDMA_CALL_SIGNAL_ISDN_PING_RING
ISDN Ping Ring tone: {2091Hz 32ms ON, 2556Hz 64ms ON} 5 times 2091Hz 20ms ON |
int |
TONE_CDMA_CALL_SIGNAL_ISDN_SP_PRI
ISDN Call Signal SP PRI tone:{2091Hz 32ms ON, 2556 64ms ON} 4 times 2091Hz 16ms ON, 200ms OFF, {2091Hz 32ms ON, 2556Hz 64ms ON} 4 times, 2091Hz 16ms ON, 200ms OFF |
int |
TONE_CDMA_CONFIRM
CDMA Confirm tone: 350Hz+440Hz 100ms ON, 100ms OFF repeated for 3 times |
int |
TONE_CDMA_DIAL_TONE_LITE
CDMA Dial tone : 425Hz continuous |
int |
TONE_CDMA_EMERGENCY_RINGBACK
CDMA EMERGENCY RINGBACK tone: {941Hz 125ms ON, 10ms OFF} 3times 4990ms OFF, REPEAT... |
int |
TONE_CDMA_HIGH_L
TONE_CDMA_HIGH_L tone: {3700Hz 25ms, 4000Hz 25ms} 40 times 4000ms OFF, Repeat .... |
int |
TONE_CDMA_HIGH_PBX_L
CDMA HIGH PBX L: {3700Hz 25ms, 4000Hz 25ms}20 times, 2000ms OFF, REPEAT.... |
int |
TONE_CDMA_HIGH_PBX_SLS
CDMA HIGH PBX SSL tone:{3700Hz 25ms, 4000Hz 25ms} 8 times 200ms OFF, {3700Hz 25ms, 4000Hz 25ms} 16 times, 200ms OFF, {3700Hz 25ms, 4000Hz 25ms} 8 times, 1000ms OFF, REPEAT.... |
int |
TONE_CDMA_HIGH_PBX_SS
CDMA HIGH PBX SS tone: {3700Hz 25ms, 4000Hz 25ms} 8 times 200 ms OFF, {3700Hz 25ms 4000Hz 25ms}8 times, 2000ms OFF, REPEAT.... |
int |
TONE_CDMA_HIGH_PBX_SSL
CDMA HIGH PBX SSL tone:{3700Hz 25ms, 4000Hz 25ms} 8 times 200ms OFF, {3700Hz 25ms, 4000Hz 25ms} 8 times, 200ms OFF, {3700Hz 25ms, 4000Hz 25ms} 16 times, 1000ms OFF, REPEAT.... |
int |
TONE_CDMA_HIGH_PBX_S_X4
CDMA HIGH PBX X S4 tone: {3700Hz 25ms 4000Hz 25ms} 8 times, 200ms OFF, {3700Hz 25ms 4000Hz 25ms} 8 times, 200ms OFF, {3700Hz 25ms 4000Hz 25ms} 8 times, 200ms OFF, {3700Hz 25ms 4000Hz 25ms} 8 times, 800ms OFF, REPEAT... |
int |
TONE_CDMA_HIGH_SLS
CDMA HIGH SLS tone: {3700Hz 25ms, 4000Hz 25ms} 10 times, 500ms OFF, {3700Hz 25ms, 4000Hz 25ms} 20 times, 500ms OFF, {3700Hz 25ms, 4000Hz 25ms} 10 times, 3000ms OFF, REPEAT |
int |
TONE_CDMA_HIGH_SS
CDMA HIGH SS tone: {3700Hz 25ms, 4000Hz 25ms} repeat 16 times, 400ms OFF, repeat .... |
int |
TONE_CDMA_HIGH_SSL
CDMA HIGH SSL tone: {3700Hz 25ms, 4000Hz 25ms} 8 times, 200ms OFF, {3700Hz 25ms, 4000Hz 25ms} repeat 8 times, 200ms OFF, {3700Hz 25ms, 4000Hz 25ms} repeat 16 times, 4000ms OFF, repeat ... |
int |
TONE_CDMA_HIGH_SS_2
CDMA HIGH SS2 tone: {3700Hz 25ms, 4000Hz 25ms} 20 times, 1000ms OFF, {3700Hz 25ms, 4000Hz 25ms} 20 times, 3000ms OFF, repeat .... |
int |
TONE_CDMA_HIGH_S_X4
CDMA HIGH S X4 tone: {3700Hz 25ms, 4000Hz 25ms} 10 times, 500ms OFF, {3700Hz 25ms, 4000Hz 25ms} 10 times, 500ms OFF, {3700Hz 25ms, 4000Hz 25ms} 10 times, 500ms OFF, {3700Hz 25ms, 4000Hz 25ms} 10 times, 2500ms OFF, REPEAT.... |
int |
TONE_CDMA_INTERCEPT
CDMA Intercept tone: 440Hz 250ms ON, 620Hz 250ms ON ... |
int |
TONE_CDMA_KEYPAD_VOLUME_KEY_LITE
CDMA KEYPAD Volume key lite tone: 941Hz+1477Hz 120ms ON |
int |
TONE_CDMA_LOW_L
TONE_CDMA_LOW_L tone: {1300Hz 25ms, 1450Hz 25ms} 40 times, 4000ms OFF, Repeat .... |
int |
TONE_CDMA_LOW_PBX_L
CDMA LOW PBX L: {1300Hz 25ms,1450Hz 25ms}20 times, 2000ms OFF, REPEAT.... |
int |
TONE_CDMA_LOW_PBX_SLS
CDMA HIGH PBX SLS tone:{1300Hz 25ms, 1450Hz 25ms} 8 times 200ms OFF, {1300Hz 25ms, 1450Hz 25ms} 16 times, 200ms OFF, {1300Hz 25ms, 1450Hz 25ms} 8 times, 1000ms OFF, REPEAT.... |
int |
TONE_CDMA_LOW_PBX_SS
CDMA LOW PBX SS tone: {1300Hz 25ms, 1450Hz 25ms} 8 times 200 ms OFF, {1300Hz 25ms 1450Hz 25ms}8 times, 2000ms OFF, REPEAT.... |
int |
TONE_CDMA_LOW_PBX_SSL
CDMA LOW PBX SSL tone:{1300Hz 25ms, 1450Hz 25ms} 8 times 200ms OFF, {1300Hz 25ms, 1450Hz 25ms} 8 times, 200ms OFF, {1300Hz 25ms, 1450Hz 25ms} 16 times, 1000ms OFF, REPEAT.... |
int |
TONE_CDMA_LOW_PBX_S_X4
CDMA LOW PBX X S4 tone: {1300Hz 25ms 1450Hz 25ms} 8 times, 200ms OFF, {1300Hz 25ms 1450Hz 25ms} 8 times, 200ms OFF, {1300Hz 25ms 1450Hz 25ms} 8 times, 200ms OFF, {1300Hz 25ms 1450Hz 25ms} 8 times, 800ms OFF, REPEAT... |
int |
TONE_CDMA_LOW_SLS
CDMA LOW SLS tone: {1300Hz 25ms, 1450Hz 25ms} 10 times, 500ms OFF, {1300Hz 25ms, 1450Hz 25ms} 20 times, 500ms OFF, {1300Hz 25ms, 1450Hz 25ms} 10 times, 3000ms OFF, REPEAT |
int |
TONE_CDMA_LOW_SS
CDMA LOW SS tone: {1300z 25ms, 1450Hz 25ms} repeat 16 times, 400ms OFF, repeat .... |
int |
TONE_CDMA_LOW_SSL
CDMA LOW SSL tone: {1300Hz 25ms, 1450Hz 25ms} 8 times, 200ms OFF, {1300Hz 25ms, 1450Hz 25ms} repeat 8 times, 200ms OFF, {1300Hz 25ms, 1450Hz 25ms} repeat 16 times, 4000ms OFF, repeat ... |
int |
TONE_CDMA_LOW_SS_2
CDMA LOW SS2 tone: {1300Hz 25ms, 1450Hz 25ms} 20 times, 1000ms OFF, {1300Hz 25ms, 1450Hz 25ms} 20 times, 3000ms OFF, repeat .... |
int |
TONE_CDMA_LOW_S_X4
CDMA LOW S X4 tone: {2600Hz 25ms, 2900Hz 25ms} 10 times, 500ms OFF, {2600Hz 25ms, 2900Hz 25ms} 10 times, 500ms OFF, {2600Hz 25ms, 2900Hz 25ms} 10 times, 500ms OFF, {2600Hz 25ms, 2900Hz 25ms} 10 times, 2500ms OFF, REPEAT.... |
int |
TONE_CDMA_MED_L
TONE_CDMA_MED_L tone: {2600Hz 25ms, 2900Hz 25ms} 40 times 4000ms OFF, Repeat .... |
int |
TONE_CDMA_MED_PBX_L
CDMA MED PBX L: {2600Hz 25ms, 2900Hz 25ms}20 times, 2000ms OFF, REPEAT.... |
int |
TONE_CDMA_MED_PBX_SLS
CDMA HIGH PBX SLS tone:{2600Hz 25ms, 2900Hz 25ms} 8 times 200ms OFF, {2600Hz 25ms, 2900Hz 25ms} 16 times, 200ms OFF, {2600Hz 25ms, 2900Hz 25ms} 8 times, 1000ms OFF, REPEAT.... |
int |
TONE_CDMA_MED_PBX_SS
CDMA MED PBX SS tone: {2600Hz 25ms, 2900Hz 25ms} 8 times 200 ms OFF, {2600Hz 25ms 2900Hz 25ms}8 times, 2000ms OFF, REPEAT.... |
int |
TONE_CDMA_MED_PBX_SSL
CDMA MED PBX SSL tone:{2600Hz 25ms, 2900Hz 25ms} 8 times 200ms OFF, {2600Hz 25ms, 2900Hz 25ms} 8 times, 200ms OFF, {2600Hz 25ms, 2900Hz 25ms} 16 times, 1000ms OFF, REPEAT.... |
int |
TONE_CDMA_MED_PBX_S_X4
CDMA MED PBX X S4 tone: {2600Hz 25ms 2900Hz 25ms} 8 times, 200ms OFF, {2600Hz 25ms 2900Hz 25ms} 8 times, 200ms OFF, {2600Hz 25ms 2900Hz 25ms} 8 times, 200ms OFF, {2600Hz 25ms 2900Hz 25ms} 8 times, 800ms OFF, REPEAT... |
int |
TONE_CDMA_MED_SLS
CDMA MED SLS tone: {2600Hz 25ms, 2900Hz 25ms} 10 times, 500ms OFF, {2600Hz 25ms, 2900Hz 25ms} 20 times, 500ms OFF, {2600Hz 25ms, 2900Hz 25ms} 10 times, 3000ms OFF, REPEAT |
int |
TONE_CDMA_MED_SS
CDMA MED SS tone: {2600Hz 25ms, 2900Hz 25ms} repeat 16 times, 400ms OFF, repeat .... |
int |
TONE_CDMA_MED_SSL
CDMA MED SSL tone: {2600Hz 25ms, 2900Hz 25ms} 8 times, 200ms OFF, {2600Hz 25ms, 2900Hz 25ms} repeat 8 times, 200ms OFF, {2600Hz 25ms, 2900Hz 25ms} repeat 16 times, 4000ms OFF, repeat ... |
int |
TONE_CDMA_MED_SS_2
CDMA MED SS2 tone: {2600Hz 25ms, 2900Hz 25ms} 20 times, 1000ms OFF, {2600Hz 25ms, 2900Hz 25ms} 20 times, 3000ms OFF, repeat .... |
int |
TONE_CDMA_MED_S_X4
CDMA MED S X4 tone: {2600Hz 25ms, 2900Hz 25ms} 10 times, 500ms OFF, {2600Hz 25ms, 2900Hz 25ms} 10 times, 500ms OFF, {2600Hz 25ms, 2900Hz 25ms} 10 times, 500ms OFF, {2600Hz 25ms, 2900Hz 25ms} 10 times, 2500ms OFF, REPEAT.... |
int |
TONE_CDMA_NETWORK_BUSY
CDMA Network Busy tone: 480Hz+620Hz 500ms ON, 500ms OFF continuous |
int |
TONE_CDMA_NETWORK_BUSY_ONE_SHOT
CDMA_NETWORK_BUSY_ONE_SHOT tone: 425Hz 500ms ON, 500ms OFF. |
int |
TONE_CDMA_NETWORK_CALLWAITING
CDMA Network Callwaiting tone: 440Hz 300ms ON |
int |
TONE_CDMA_NETWORK_USA_RINGBACK
CDMA USA Ringback: 440Hz+480Hz 2s ON, 4000 OFF ... |
int |
TONE_CDMA_ONE_MIN_BEEP
CDMA One Min Beep tone: 1150Hz+770Hz 400ms ON |
int |
TONE_CDMA_PIP
CDMA PIP tone: 480Hz 100ms ON, 100ms OFF repeated for 4 times |
int |
TONE_CDMA_PRESSHOLDKEY_LITE
CDMA PRESSHOLDKEY LITE tone: 587Hz 375ms ON, 1175Hz 125ms ON |
int |
TONE_CDMA_REORDER
CDMA Reorder tone: 480Hz+620Hz 250ms ON, 250ms OFF... |
int |
TONE_CDMA_SIGNAL_OFF
CDMA_SIGNAL_OFF - silent tone |
int |
TONE_CDMA_SOFT_ERROR_LITE
CDMA SOFT ERROR LITE tone: 1047Hz 125ms ON, 370Hz 125ms |
int |
TONE_DTMF_0
DTMF tone for key 0: 1336Hz, 941Hz, continuous |
int |
TONE_DTMF_1
DTMF tone for key 1: 1209Hz, 697Hz, continuous |
int |
TONE_DTMF_2
DTMF tone for key 2: 1336Hz, 697Hz, continuous |
int |
TONE_DTMF_3
DTMF tone for key 3: 1477Hz, 697Hz, continuous |
int |
TONE_DTMF_4
DTMF tone for key 4: 1209Hz, 770Hz, continuous |
int |
TONE_DTMF_5
DTMF tone for key 5: 1336Hz, 770Hz, continuous |
int |
TONE_DTMF_6
DTMF tone for key 6: 1477Hz, 770Hz, continuous |
int |
TONE_DTMF_7
DTMF tone for key 7: 1209Hz, 852Hz, continuous |
int |
TONE_DTMF_8
DTMF tone for key 8: 1336Hz, 852Hz, continuous |
int |
TONE_DTMF_9
DTMF tone for key 9: 1477Hz, 852Hz, continuous |
int |
TONE_DTMF_A
DTMF tone for key A: 1633Hz, 697Hz, continuous |
int |
TONE_DTMF_B
DTMF tone for key B: 1633Hz, 770Hz, continuous |
int |
TONE_DTMF_C
DTMF tone for key C: 1633Hz, 852Hz, continuous |
int |
TONE_DTMF_D
DTMF tone for key D: 1633Hz, 941Hz, continuous |
int |
TONE_DTMF_P
DTMF tone for key #: 1477Hz, 941Hz, continuous |
int |
TONE_DTMF_S
DTMF tone for key *: 1209Hz, 941Hz, continuous |
int |
TONE_PROP_ACK
Proprietary tone, positive acknowlegement: 1200Hz, 100ms ON, 100ms OFF 2 bursts |
int |
TONE_PROP_BEEP
Proprietary tone, general beep: 400Hz+1200Hz, 35ms ON |
int |
TONE_PROP_BEEP2
Proprietary tone, general double beep: twice 400Hz+1200Hz, 35ms ON, 200ms OFF, 35ms ON |
int |
TONE_PROP_NACK
Proprietary tone, negative acknowlegement: 300Hz+400Hz+500Hz, 400ms ON |
int |
TONE_PROP_PROMPT
Proprietary tone, prompt tone: 400Hz+1200Hz, 200ms ON |
int |
TONE_SUP_BUSY
Call supervisory tone, Busy: CEPT: 425Hz, 500ms ON, 500ms OFF... |
int |
TONE_SUP_CALL_WAITING
Call supervisory tone, Call Waiting: CEPT, JAPAN: 425Hz, 200ms ON, 600ms OFF, 200ms ON, 3s OFF... |
int |
TONE_SUP_CONFIRM
Call supervisory tone (IS-95), confirm tone: a 350 Hz tone added to a 440 Hz tone repeated 3 times in a 100 ms on, 100 ms off cycle |
int |
TONE_SUP_CONGESTION
Call supervisory tone, Congestion: CEPT, JAPAN: 425Hz, 200ms ON, 200ms OFF... |
int |
TONE_SUP_CONGESTION_ABBREV
Call supervisory tone (IS-95), abbreviated congestion: congestion tone limited to 4 seconds |
int |
TONE_SUP_DIAL
Call supervisory tone, Dial tone: CEPT: 425Hz, continuous ANSI (IS-95): 350Hz+440Hz, continuous JAPAN: 400Hz, continuous |
int |
TONE_SUP_ERROR
Call supervisory tone, Error/Special info: 950Hz+1400Hz+1800Hz, 330ms ON, 1s OFF... |
int |
TONE_SUP_INTERCEPT
Call supervisory tone (IS-95), intercept tone: alternating 440 Hz and 620 Hz tones, each on for 250 ms |
int |
TONE_SUP_INTERCEPT_ABBREV
Call supervisory tone (IS-95), abbreviated intercept: intercept tone limited to 4 seconds |
int |
TONE_SUP_PIP
Call supervisory tone (IS-95), pip tone: four bursts of 480 Hz tone (0.1 s on, 0.1 s off). |
int |
TONE_SUP_RADIO_ACK
Call supervisory tone, Radio path acknowlegment : CEPT, ANSI: 425Hz, 200ms ON JAPAN: 400Hz, 1s ON, 2s OFF... |
int |
TONE_SUP_RADIO_NOTAVAIL
Call supervisory tone, Radio path not available: 425Hz, 200ms ON, 200 OFF 3 bursts |
int |
TONE_SUP_RINGTONE
Call supervisory tone, Ring Tone: CEPT, JAPAN: 425Hz, 1s ON, 4s OFF... |
Public constructors | |
---|---|
ToneGenerator(int streamType, int volume)
ToneGenerator class contructor specifying output stream type and volume. |
Public methods | |
---|---|
final
int
|
getAudioSessionId()
Returns the audio session ID. |
void
|
release()
Releases resources associated with this ToneGenerator object. |
boolean
|
startTone(int toneType, int durationMs)
This method starts the playback of a tone of the specified type for the specified duration. |
boolean
|
startTone(int toneType)
This method starts the playback of a tone of the specified type. |
void
|
stopTone()
This method stops the tone currently playing playback. |
Protected methods | |
---|---|
void
|
finalize()
Called by the garbage collector on an object when garbage collection determines that there are no more references to the object. |
Inherited methods | |
---|---|
From
class
java.lang.Object
|
int MAX_VOLUME
Maximum volume, for use with ToneGenerator(int, int)
Constant Value: 100 (0x00000064)
int MIN_VOLUME
Minimum volume setting, for use with ToneGenerator(int, int)
Constant Value: 0 (0x00000000)
int TONE_CDMA_ABBR_ALERT
CDMA_ABBR_ALERT tone: 1150Hz+770Hz 400ms ON
See also:
Constant Value: 97 (0x00000061)
int TONE_CDMA_ABBR_INTERCEPT
CDMA Abbr Intercept tone: 440Hz 250ms ON, 620Hz 250ms ON
See also:
Constant Value: 37 (0x00000025)
int TONE_CDMA_ABBR_REORDER
CDMA Abbr Reorder tone: 480Hz+620Hz 250ms ON, 250ms OFF repeated for 8 times
See also:
Constant Value: 39 (0x00000027)
int TONE_CDMA_ALERT_AUTOREDIAL_LITE
CDMA Alert Auto Redial tone: {1245Hz 62ms ON, 659Hz 62ms ON} 3 times, 1245 62ms ON
See also:
Constant Value: 87 (0x00000057)
int TONE_CDMA_ALERT_CALL_GUARD
CDMA ALERT CALL GUARD tone: {1319Hz 125ms ON, 125ms OFF} 3 times
See also:
Constant Value: 93 (0x0000005d)
int TONE_CDMA_ALERT_INCALL_LITE
CDMA ALERT INCALL LITE tone: 587Hz 62ms, 784 62ms, 831Hz 62ms, 784Hz 62ms, 1109 62ms, 784Hz 62ms, 831Hz 62ms, 784Hz 62ms
See also:
Constant Value: 91 (0x0000005b)
int TONE_CDMA_ALERT_NETWORK_LITE
CDMA Alert Network Lite tone: 1109Hz 62ms ON, 784Hz 62ms ON, 740Hz 62ms ON 622Hz 62ms ON, 1109Hz 62ms ON
See also:
Constant Value: 86 (0x00000056)
int TONE_CDMA_ANSWER
CDMA answer tone: silent tone - defintion Frequency 0, 0ms ON, 0ms OFF
See also:
Constant Value: 42 (0x0000002a)
int TONE_CDMA_CALLDROP_LITE
CDMA CALLDROP LITE tone: 1480Hz 125ms, 1397Hz 125ms, 784Hz 125ms
See also:
Constant Value: 95 (0x0000005f)
int TONE_CDMA_CALL_SIGNAL_ISDN_INTERGROUP
ISDN Call Signal Intergroup tone: {2091Hz 32ms ON, 2556 64ms ON} 8 times, 2091Hz 32ms ON, 400ms OFF, {2091Hz 32ms ON, 2556Hz 64ms ON} times, 2091Hz 32ms ON, 4s OFF.
See also:
Constant Value: 46 (0x0000002e)
int TONE_CDMA_CALL_SIGNAL_ISDN_NORMAL
ISDN Call Signal Normal tone: {2091Hz 32ms ON, 2556 64ms ON} 20 times, 2091 32ms ON, 2556 48ms ON, 4s OFF
See also:
Constant Value: 45 (0x0000002d)
int TONE_CDMA_CALL_SIGNAL_ISDN_PAT3
ISDN Call sign PAT3 tone: silent tone
See also:
Constant Value: 48 (0x00000030)
int TONE_CDMA_CALL_SIGNAL_ISDN_PAT5
ISDN Pat5 tone: silent tone
See also:
Constant Value: 50 (0x00000032)
int TONE_CDMA_CALL_SIGNAL_ISDN_PAT6
ISDN Pat6 tone: silent tone
See also:
Constant Value: 51 (0x00000033)
int TONE_CDMA_CALL_SIGNAL_ISDN_PAT7
ISDN Pat7 tone: silent tone
See also:
Constant Value: 52 (0x00000034)
int TONE_CDMA_CALL_SIGNAL_ISDN_PING_RING
ISDN Ping Ring tone: {2091Hz 32ms ON, 2556Hz 64ms ON} 5 times 2091Hz 20ms ON
See also:
Constant Value: 49 (0x00000031)
int TONE_CDMA_CALL_SIGNAL_ISDN_SP_PRI
ISDN Call Signal SP PRI tone:{2091Hz 32ms ON, 2556 64ms ON} 4 times 2091Hz 16ms ON, 200ms OFF, {2091Hz 32ms ON, 2556Hz 64ms ON} 4 times, 2091Hz 16ms ON, 200ms OFF
See also:
Constant Value: 47 (0x0000002f)
int TONE_CDMA_CONFIRM
CDMA Confirm tone: 350Hz+440Hz 100ms ON, 100ms OFF repeated for 3 times
See also:
Constant Value: 41 (0x00000029)
int TONE_CDMA_DIAL_TONE_LITE
CDMA Dial tone : 425Hz continuous
See also:
Constant Value: 34 (0x00000022)
int TONE_CDMA_EMERGENCY_RINGBACK
CDMA EMERGENCY RINGBACK tone: {941Hz 125ms ON, 10ms OFF} 3times 4990ms OFF, REPEAT...
See also:
Constant Value: 92 (0x0000005c)
int TONE_CDMA_HIGH_L
TONE_CDMA_HIGH_L tone: {3700Hz 25ms, 4000Hz 25ms} 40 times 4000ms OFF, Repeat ....
See also:
Constant Value: 53 (0x00000035)
int TONE_CDMA_HIGH_PBX_L
CDMA HIGH PBX L: {3700Hz 25ms, 4000Hz 25ms}20 times, 2000ms OFF, REPEAT....
See also:
Constant Value: 71 (0x00000047)
int TONE_CDMA_HIGH_PBX_SLS
CDMA HIGH PBX SSL tone:{3700Hz 25ms, 4000Hz 25ms} 8 times 200ms OFF, {3700Hz 25ms, 4000Hz 25ms} 16 times, 200ms OFF, {3700Hz 25ms, 4000Hz 25ms} 8 times, 1000ms OFF, REPEAT....
See also:
Constant Value: 80 (0x00000050)
int TONE_CDMA_HIGH_PBX_SS
CDMA HIGH PBX SS tone: {3700Hz 25ms, 4000Hz 25ms} 8 times 200 ms OFF, {3700Hz 25ms 4000Hz 25ms}8 times, 2000ms OFF, REPEAT....
See also:
Constant Value: 74 (0x0000004a)
int TONE_CDMA_HIGH_PBX_SSL
CDMA HIGH PBX SSL tone:{3700Hz 25ms, 4000Hz 25ms} 8 times 200ms OFF, {3700Hz 25ms, 4000Hz 25ms} 8 times, 200ms OFF, {3700Hz 25ms, 4000Hz 25ms} 16 times, 1000ms OFF, REPEAT....
See also:
Constant Value: 77 (0x0000004d)
int TONE_CDMA_HIGH_PBX_S_X4
CDMA HIGH PBX X S4 tone: {3700Hz 25ms 4000Hz 25ms} 8 times, 200ms OFF, {3700Hz 25ms 4000Hz 25ms} 8 times, 200ms OFF, {3700Hz 25ms 4000Hz 25ms} 8 times, 200ms OFF, {3700Hz 25ms 4000Hz 25ms} 8 times, 800ms OFF, REPEAT...
See also:
Constant Value: 83 (0x00000053)
int TONE_CDMA_HIGH_SLS
CDMA HIGH SLS tone: {3700Hz 25ms, 4000Hz 25ms} 10 times, 500ms OFF, {3700Hz 25ms, 4000Hz 25ms} 20 times, 500ms OFF, {3700Hz 25ms, 4000Hz 25ms} 10 times, 3000ms OFF, REPEAT
See also:
Constant Value: 65 (0x00000041)
int TONE_CDMA_HIGH_SS
CDMA HIGH SS tone: {3700Hz 25ms, 4000Hz 25ms} repeat 16 times, 400ms OFF, repeat ....
See also:
Constant Value: 56 (0x00000038)
int TONE_CDMA_HIGH_SSL
CDMA HIGH SSL tone: {3700Hz 25ms, 4000Hz 25ms} 8 times, 200ms OFF, {3700Hz 25ms, 4000Hz 25ms} repeat 8 times, 200ms OFF, {3700Hz 25ms, 4000Hz 25ms} repeat 16 times, 4000ms OFF, repeat ...
See also:
Constant Value: 59 (0x0000003b)
int TONE_CDMA_HIGH_SS_2
CDMA HIGH SS2 tone: {3700Hz 25ms, 4000Hz 25ms} 20 times, 1000ms OFF, {3700Hz 25ms, 4000Hz 25ms} 20 times, 3000ms OFF, repeat ....
See also:
Constant Value: 62 (0x0000003e)
int TONE_CDMA_HIGH_S_X4
CDMA HIGH S X4 tone: {3700Hz 25ms, 4000Hz 25ms} 10 times, 500ms OFF, {3700Hz 25ms, 4000Hz 25ms} 10 times, 500ms OFF, {3700Hz 25ms, 4000Hz 25ms} 10 times, 500ms OFF, {3700Hz 25ms, 4000Hz 25ms} 10 times, 2500ms OFF, REPEAT....
See also:
Constant Value: 68 (0x00000044)
int TONE_CDMA_INTERCEPT
CDMA Intercept tone: 440Hz 250ms ON, 620Hz 250ms ON ...
See also:
Constant Value: 36 (0x00000024)
int TONE_CDMA_KEYPAD_VOLUME_KEY_LITE
CDMA KEYPAD Volume key lite tone: 941Hz+1477Hz 120ms ON
See also:
Constant Value: 89 (0x00000059)
int TONE_CDMA_LOW_L
TONE_CDMA_LOW_L tone: {1300Hz 25ms, 1450Hz 25ms} 40 times, 4000ms OFF, Repeat ....
See also:
Constant Value: 55 (0x00000037)
int TONE_CDMA_LOW_PBX_L
CDMA LOW PBX L: {1300Hz 25ms,1450Hz 25ms}20 times, 2000ms OFF, REPEAT....
See also:
Constant Value: 73 (0x00000049)
int TONE_CDMA_LOW_PBX_SLS
CDMA HIGH PBX SLS tone:{1300Hz 25ms, 1450Hz 25ms} 8 times 200ms OFF, {1300Hz 25ms, 1450Hz 25ms} 16 times, 200ms OFF, {1300Hz 25ms, 1450Hz 25ms} 8 times, 1000ms OFF, REPEAT....
See also:
Constant Value: 82 (0x00000052)
int TONE_CDMA_LOW_PBX_SS
CDMA LOW PBX SS tone: {1300Hz 25ms, 1450Hz 25ms} 8 times 200 ms OFF, {1300Hz 25ms 1450Hz 25ms}8 times, 2000ms OFF, REPEAT....
See also:
Constant Value: 76 (0x0000004c)
int TONE_CDMA_LOW_PBX_SSL
CDMA LOW PBX SSL tone:{1300Hz 25ms, 1450Hz 25ms} 8 times 200ms OFF, {1300Hz 25ms, 1450Hz 25ms} 8 times, 200ms OFF, {1300Hz 25ms, 1450Hz 25ms} 16 times, 1000ms OFF, REPEAT....
See also:
Constant Value: 79 (0x0000004f)
int TONE_CDMA_LOW_PBX_S_X4
CDMA LOW PBX X S4 tone: {1300Hz 25ms 1450Hz 25ms} 8 times, 200ms OFF, {1300Hz 25ms 1450Hz 25ms} 8 times, 200ms OFF, {1300Hz 25ms 1450Hz 25ms} 8 times, 200ms OFF, {1300Hz 25ms 1450Hz 25ms} 8 times, 800ms OFF, REPEAT...
See also:
Constant Value: 85 (0x00000055)
int TONE_CDMA_LOW_SLS
CDMA LOW SLS tone: {1300Hz 25ms, 1450Hz 25ms} 10 times, 500ms OFF, {1300Hz 25ms, 1450Hz 25ms} 20 times, 500ms OFF, {1300Hz 25ms, 1450Hz 25ms} 10 times, 3000ms OFF, REPEAT
See also:
Constant Value: 67 (0x00000043)
int TONE_CDMA_LOW_SS
CDMA LOW SS tone: {1300z 25ms, 1450Hz 25ms} repeat 16 times, 400ms OFF, repeat ....
See also:
Constant Value: 58 (0x0000003a)
int TONE_CDMA_LOW_SSL
CDMA LOW SSL tone: {1300Hz 25ms, 1450Hz 25ms} 8 times, 200ms OFF, {1300Hz 25ms, 1450Hz 25ms} repeat 8 times, 200ms OFF, {1300Hz 25ms, 1450Hz 25ms} repeat 16 times, 4000ms OFF, repeat ...
See also:
Constant Value: 61 (0x0000003d)
int TONE_CDMA_LOW_SS_2
CDMA LOW SS2 tone: {1300Hz 25ms, 1450Hz 25ms} 20 times, 1000ms OFF, {1300Hz 25ms, 1450Hz 25ms} 20 times, 3000ms OFF, repeat ....
See also:
Constant Value: 64 (0x00000040)
int TONE_CDMA_LOW_S_X4
CDMA LOW S X4 tone: {2600Hz 25ms, 2900Hz 25ms} 10 times, 500ms OFF, {2600Hz 25ms, 2900Hz 25ms} 10 times, 500ms OFF, {2600Hz 25ms, 2900Hz 25ms} 10 times, 500ms OFF, {2600Hz 25ms, 2900Hz 25ms} 10 times, 2500ms OFF, REPEAT....
See also:
Constant Value: 70 (0x00000046)
int TONE_CDMA_MED_L
TONE_CDMA_MED_L tone: {2600Hz 25ms, 2900Hz 25ms} 40 times 4000ms OFF, Repeat ....
See also:
Constant Value: 54 (0x00000036)
int TONE_CDMA_MED_PBX_L
CDMA MED PBX L: {2600Hz 25ms, 2900Hz 25ms}20 times, 2000ms OFF, REPEAT....
See also:
Constant Value: 72 (0x00000048)
int TONE_CDMA_MED_PBX_SLS
CDMA HIGH PBX SLS tone:{2600Hz 25ms, 2900Hz 25ms} 8 times 200ms OFF, {2600Hz 25ms, 2900Hz 25ms} 16 times, 200ms OFF, {2600Hz 25ms, 2900Hz 25ms} 8 times, 1000ms OFF, REPEAT....
See also:
Constant Value: 81 (0x00000051)
int TONE_CDMA_MED_PBX_SS
CDMA MED PBX SS tone: {2600Hz 25ms, 2900Hz 25ms} 8 times 200 ms OFF, {2600Hz 25ms 2900Hz 25ms}8 times, 2000ms OFF, REPEAT....
See also:
Constant Value: 75 (0x0000004b)
int TONE_CDMA_MED_PBX_SSL
CDMA MED PBX SSL tone:{2600Hz 25ms, 2900Hz 25ms} 8 times 200ms OFF, {2600Hz 25ms, 2900Hz 25ms} 8 times, 200ms OFF, {2600Hz 25ms, 2900Hz 25ms} 16 times, 1000ms OFF, REPEAT....
See also:
Constant Value: 78 (0x0000004e)
int TONE_CDMA_MED_PBX_S_X4
CDMA MED PBX X S4 tone: {2600Hz 25ms 2900Hz 25ms} 8 times, 200ms OFF, {2600Hz 25ms 2900Hz 25ms} 8 times, 200ms OFF, {2600Hz 25ms 2900Hz 25ms} 8 times, 200ms OFF, {2600Hz 25ms 2900Hz 25ms} 8 times, 800ms OFF, REPEAT...
See also:
Constant Value: 84 (0x00000054)
int TONE_CDMA_MED_SLS
CDMA MED SLS tone: {2600Hz 25ms, 2900Hz 25ms} 10 times, 500ms OFF, {2600Hz 25ms, 2900Hz 25ms} 20 times, 500ms OFF, {2600Hz 25ms, 2900Hz 25ms} 10 times, 3000ms OFF, REPEAT
See also:
Constant Value: 66 (0x00000042)
int TONE_CDMA_MED_SS
CDMA MED SS tone: {2600Hz 25ms, 2900Hz 25ms} repeat 16 times, 400ms OFF, repeat ....
See also:
Constant Value: 57 (0x00000039)
int TONE_CDMA_MED_SSL
CDMA MED SSL tone: {2600Hz 25ms, 2900Hz 25ms} 8 times, 200ms OFF, {2600Hz 25ms, 2900Hz 25ms} repeat 8 times, 200ms OFF, {2600Hz 25ms, 2900Hz 25ms} repeat 16 times, 4000ms OFF, repeat ...
See also:
Constant Value: 60 (0x0000003c)
int TONE_CDMA_MED_SS_2
CDMA MED SS2 tone: {2600Hz 25ms, 2900Hz 25ms} 20 times, 1000ms OFF, {2600Hz 25ms, 2900Hz 25ms} 20 times, 3000ms OFF, repeat ....
See also:
Constant Value: 63 (0x0000003f)
int TONE_CDMA_MED_S_X4
CDMA MED S X4 tone: {2600Hz 25ms, 2900Hz 25ms} 10 times, 500ms OFF, {2600Hz 25ms, 2900Hz 25ms} 10 times, 500ms OFF, {2600Hz 25ms, 2900Hz 25ms} 10 times, 500ms OFF, {2600Hz 25ms, 2900Hz 25ms} 10 times, 2500ms OFF, REPEAT....
See also:
Constant Value: 69 (0x00000045)
int TONE_CDMA_NETWORK_BUSY
CDMA Network Busy tone: 480Hz+620Hz 500ms ON, 500ms OFF continuous
See also:
Constant Value: 40 (0x00000028)
int TONE_CDMA_NETWORK_BUSY_ONE_SHOT
CDMA_NETWORK_BUSY_ONE_SHOT tone: 425Hz 500ms ON, 500ms OFF.
See also:
Constant Value: 96 (0x00000060)
int TONE_CDMA_NETWORK_CALLWAITING
CDMA Network Callwaiting tone: 440Hz 300ms ON
See also:
Constant Value: 43 (0x0000002b)
int TONE_CDMA_NETWORK_USA_RINGBACK
CDMA USA Ringback: 440Hz+480Hz 2s ON, 4000 OFF ...
See also:
Constant Value: 35 (0x00000023)
int TONE_CDMA_ONE_MIN_BEEP
CDMA One Min Beep tone: 1150Hz+770Hz 400ms ON
See also:
Constant Value: 88 (0x00000058)
int TONE_CDMA_PIP
CDMA PIP tone: 480Hz 100ms ON, 100ms OFF repeated for 4 times
See also:
Constant Value: 44 (0x0000002c)
int TONE_CDMA_PRESSHOLDKEY_LITE
CDMA PRESSHOLDKEY LITE tone: 587Hz 375ms ON, 1175Hz 125ms ON
See also:
Constant Value: 90 (0x0000005a)
int TONE_CDMA_REORDER
CDMA Reorder tone: 480Hz+620Hz 250ms ON, 250ms OFF...
See also:
Constant Value: 38 (0x00000026)
int TONE_CDMA_SIGNAL_OFF
CDMA_SIGNAL_OFF - silent tone
See also:
Constant Value: 98 (0x00000062)
int TONE_CDMA_SOFT_ERROR_LITE
CDMA SOFT ERROR LITE tone: 1047Hz 125ms ON, 370Hz 125ms
See also:
Constant Value: 94 (0x0000005e)
int TONE_DTMF_0
DTMF tone for key 0: 1336Hz, 941Hz, continuous
See also:
Constant Value: 0 (0x00000000)
int TONE_DTMF_1
DTMF tone for key 1: 1209Hz, 697Hz, continuous
See also:
Constant Value: 1 (0x00000001)
int TONE_DTMF_2
DTMF tone for key 2: 1336Hz, 697Hz, continuous
See also:
Constant Value: 2 (0x00000002)
int TONE_DTMF_3
DTMF tone for key 3: 1477Hz, 697Hz, continuous
See also:
Constant Value: 3 (0x00000003)
int TONE_DTMF_4
DTMF tone for key 4: 1209Hz, 770Hz, continuous
See also:
Constant Value: 4 (0x00000004)
int TONE_DTMF_5
DTMF tone for key 5: 1336Hz, 770Hz, continuous
See also:
Constant Value: 5 (0x00000005)
int TONE_DTMF_6
DTMF tone for key 6: 1477Hz, 770Hz, continuous
See also:
Constant Value: 6 (0x00000006)
int TONE_DTMF_7
DTMF tone for key 7: 1209Hz, 852Hz, continuous
See also:
Constant Value: 7 (0x00000007)
int TONE_DTMF_8
DTMF tone for key 8: 1336Hz, 852Hz, continuous
See also:
Constant Value: 8 (0x00000008)
int TONE_DTMF_9
DTMF tone for key 9: 1477Hz, 852Hz, continuous
See also:
Constant Value: 9 (0x00000009)
int TONE_DTMF_A
DTMF tone for key A: 1633Hz, 697Hz, continuous
See also:
Constant Value: 12 (0x0000000c)
int TONE_DTMF_B
DTMF tone for key B: 1633Hz, 770Hz, continuous
See also:
Constant Value: 13 (0x0000000d)
int TONE_DTMF_C
DTMF tone for key C: 1633Hz, 852Hz, continuous
See also:
Constant Value: 14 (0x0000000e)
int TONE_DTMF_D
DTMF tone for key D: 1633Hz, 941Hz, continuous
See also:
Constant Value: 15 (0x0000000f)
int TONE_DTMF_P
DTMF tone for key #: 1477Hz, 941Hz, continuous
See also:
Constant Value: 11 (0x0000000b)
int TONE_DTMF_S
DTMF tone for key *: 1209Hz, 941Hz, continuous
See also:
Constant Value: 10 (0x0000000a)
int TONE_PROP_ACK
Proprietary tone, positive acknowlegement: 1200Hz, 100ms ON, 100ms OFF 2 bursts
See also:
Constant Value: 25 (0x00000019)
int TONE_PROP_BEEP
Proprietary tone, general beep: 400Hz+1200Hz, 35ms ON
See also:
Constant Value: 24 (0x00000018)
int TONE_PROP_BEEP2
Proprietary tone, general double beep: twice 400Hz+1200Hz, 35ms ON, 200ms OFF, 35ms ON
See also:
Constant Value: 28 (0x0000001c)
int TONE_PROP_NACK
Proprietary tone, negative acknowlegement: 300Hz+400Hz+500Hz, 400ms ON
See also:
Constant Value: 26 (0x0000001a)
int TONE_PROP_PROMPT
Proprietary tone, prompt tone: 400Hz+1200Hz, 200ms ON
See also:
Constant Value: 27 (0x0000001b)
int TONE_SUP_BUSY
Call supervisory tone, Busy: CEPT: 425Hz, 500ms ON, 500ms OFF... ANSI (IS-95): 480Hz+620Hz, 500ms ON, 500ms OFF... JAPAN: 400Hz, 500ms ON, 500ms OFF...
See also:
Constant Value: 17 (0x00000011)
int TONE_SUP_CALL_WAITING
Call supervisory tone, Call Waiting: CEPT, JAPAN: 425Hz, 200ms ON, 600ms OFF, 200ms ON, 3s OFF... ANSI (IS-95): 440 Hz, 300 ms ON, 9.7 s OFF, (100 ms ON, 100 ms OFF, 100 ms ON, 9.7s OFF ...)
See also:
Constant Value: 22 (0x00000016)
int TONE_SUP_CONFIRM
Call supervisory tone (IS-95), confirm tone: a 350 Hz tone added to a 440 Hz tone repeated 3 times in a 100 ms on, 100 ms off cycle
See also:
Constant Value: 32 (0x00000020)
int TONE_SUP_CONGESTION
Call supervisory tone, Congestion: CEPT, JAPAN: 425Hz, 200ms ON, 200ms OFF... ANSI (IS-95): 480Hz+620Hz, 250ms ON, 250ms OFF...
See also:
Constant Value: 18 (0x00000012)
int TONE_SUP_CONGESTION_ABBREV
Call supervisory tone (IS-95), abbreviated congestion: congestion tone limited to 4 seconds
See also:
Constant Value: 31 (0x0000001f)
int TONE_SUP_DIAL
Call supervisory tone, Dial tone: CEPT: 425Hz, continuous ANSI (IS-95): 350Hz+440Hz, continuous JAPAN: 400Hz, continuous
See also:
Constant Value: 16 (0x00000010)
int TONE_SUP_ERROR
Call supervisory tone, Error/Special info: 950Hz+1400Hz+1800Hz, 330ms ON, 1s OFF...
See also:
Constant Value: 21 (0x00000015)
int TONE_SUP_INTERCEPT
Call supervisory tone (IS-95), intercept tone: alternating 440 Hz and 620 Hz tones, each on for 250 ms
See also:
Constant Value: 29 (0x0000001d)
int TONE_SUP_INTERCEPT_ABBREV
Call supervisory tone (IS-95), abbreviated intercept: intercept tone limited to 4 seconds
See also:
Constant Value: 30 (0x0000001e)
int TONE_SUP_PIP
Call supervisory tone (IS-95), pip tone: four bursts of 480 Hz tone (0.1 s on, 0.1 s off).
See also:
Constant Value: 33 (0x00000021)
int TONE_SUP_RADIO_ACK
Call supervisory tone, Radio path acknowlegment : CEPT, ANSI: 425Hz, 200ms ON JAPAN: 400Hz, 1s ON, 2s OFF...
See also:
Constant Value: 19 (0x00000013)
int TONE_SUP_RADIO_NOTAVAIL
Call supervisory tone, Radio path not available: 425Hz, 200ms ON, 200 OFF 3 bursts
See also:
Constant Value: 20 (0x00000014)
int TONE_SUP_RINGTONE
Call supervisory tone, Ring Tone: CEPT, JAPAN: 425Hz, 1s ON, 4s OFF... ANSI (IS-95): 440Hz + 480Hz, 2s ON, 4s OFF...
See also:
Constant Value: 23 (0x00000017)
ToneGenerator (int streamType, int volume)
ToneGenerator class contructor specifying output stream type and volume.
Parameters | |
---|---|
streamType |
int :
The streame type used for tone playback (e.g. STREAM_MUSIC). |
volume |
int :
The volume of the tone, given in percentage of maximum volume (from 0-100).
|
int getAudioSessionId ()
Returns the audio session ID.
Returns | |
---|---|
int |
the ID of the audio session this ToneGenerator belongs to or 0 if an error occured. |
void release ()
Releases resources associated with this ToneGenerator object. It is good practice to call this method when you're done using the ToneGenerator.
boolean startTone (int toneType, int durationMs)
This method starts the playback of a tone of the specified type for the specified duration.
Parameters | |
---|---|
toneType |
int :
The type of tone generated @see startTone(int) . |
durationMs |
int :
The tone duration in milliseconds. If the tone is limited in time by definition,
the actual duration will be the minimum of durationMs and the defined tone duration. Setting durationMs to -1,
is equivalent to calling startTone(int) .
|
Returns | |
---|---|
boolean |
boolean startTone (int toneType)
This method starts the playback of a tone of the specified type. only one tone can play at a time: if a tone is playing while this method is called, this tone is stopped and replaced by the one requested.
Returns | |
---|---|
boolean |
See also:
void stopTone ()
This method stops the tone currently playing playback.
See also:
void finalize ()
Called by the garbage collector on an object when garbage collection
determines that there are no more references to the object.
A subclass overrides the finalize
method to dispose of
system resources or to perform other cleanup.
The general contract of finalize
is that it is invoked
if and when the JavaTM virtual
machine has determined that there is no longer any
means by which this object can be accessed by any thread that has
not yet died, except as a result of an action taken by the
finalization of some other object or class which is ready to be
finalized. The finalize
method may take any action, including
making this object available again to other threads; the usual purpose
of finalize
, however, is to perform cleanup actions before
the object is irrevocably discarded. For example, the finalize method
for an object that represents an input/output connection might perform
explicit I/O transactions to break the connection before the object is
permanently discarded.
The finalize
method of class Object
performs no
special action; it simply returns normally. Subclasses of
Object
may override this definition.
The Java programming language does not guarantee which thread will
invoke the finalize
method for any given object. It is
guaranteed, however, that the thread that invokes finalize will not
be holding any user-visible synchronization locks when finalize is
invoked. If an uncaught exception is thrown by the finalize method,
the exception is ignored and finalization of that object terminates.
After the finalize
method has been invoked for an object, no
further action is taken until the Java virtual machine has again
determined that there is no longer any means by which this object can
be accessed by any thread that has not yet died, including possible
actions by other objects or classes which are ready to be finalized,
at which point the object may be discarded.
The finalize
method is never invoked more than once by a Java
virtual machine for any given object.
Any exception thrown by the finalize
method causes
the finalization of this object to be halted, but is otherwise
ignored.