mediatermconndtmfev.java

Java Telephony API .java程序

/*
 * Copyright (c) 1996 Sun Microsystems, Inc. All Rights Reserved.
 *
 * Permission to use, copy, modify, and distribute this software
 * and its documentation for NON-COMMERCIAL purposes and without
 * fee is hereby granted provided that this copyright notice
 * appears in all copies. Please refer to the file "copyright.html"
 * for further important copyright and licensing information.
 *
 * SUN MAKES NO REPRESENTATIONS OR WARRANTIES ABOUT THE SUITABILITY OF
 * THE SOFTWARE, EITHER EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED
 * TO THE IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A
 * PARTICULAR PURPOSE, OR NON-INFRINGEMENT. SUN SHALL NOT BE LIABLE FOR
 * ANY DAMAGES SUFFERED BY LICENSEE AS A RESULT OF USING, MODIFYING OR
 * DISTRIBUTING THIS SOFTWARE OR ITS DERIVATIVES.
 */

package java.telephony.media.events;

/**
 * The MediaTermConnDtmfEv interface indicates that a DTMF-tone has been
 * detection on the telephone line. This event interface extends the
 * java.telephony.events.TermConnEv interface, through which the application may
 * obtain the TerminalConnection object associated with this event.
 * <p>
 * Applications may obtain the detected DTMF-digit via the getDtmfDigit()
 * method on this interface.
 */

public interface MediaTermConnDtmfEv extends MediaTermConnEv {

  /**
   * Event id
   */
  public static final int ID = 401;

  /**
   * Returns the DTMF-digit which has been recognized. This digit may either
   * be the numbers zero through nine (0-9), the asterisk (*), or the pound
   * (#).
   * <p>
   * @return The DTMF-digit which has been detected.
   */
  public char getDtmfDigit();
}