cardmatchvoice.java

It is the Speech recognition software. It is platform independent. To execute the source code,

/**
 * Copyright 2001 Sun Microsystems, Inc.
 * 
 * See the file "license.terms" for information on usage and
 * redistribution of this file, and for a DISCLAIMER OF ALL 
 * WARRANTIES.
 */

package demo.jsapi.cardmatch;

import java.io.File;
import java.util.Locale;

import javax.speech.Central;
import javax.speech.EngineStateError;
import javax.speech.synthesis.Synthesizer;
import javax.speech.synthesis.SynthesizerModeDesc;
import javax.speech.synthesis.Voice;


/**
 * Manages TTS output
 */
public class CardMatchVoice {

    private Synthesizer synthesizer;
    
    public CardMatchVoice() throws Exception {
	try {
            String domain = getProperty("domain", "general");

	    // Create a new SynthesizerModeDesc that will match the FreeTTS
	    // Synthesizer.
	    SynthesizerModeDesc desc = new SynthesizerModeDesc
		(null,
		 domain,
		 Locale.US,
		 Boolean.FALSE,         // running?
		 null);                 // voice

	    synthesizer = Central.createSynthesizer(desc);

	    if (synthesizer == null) {
		String message = "Can't find synthesizer.\n" +
		    "Make sure that there is a \"speech.properties\" file " +
		    "at either of these locations: \n";
		message += "user.home    : " + 
		    System.getProperty("user.home") + "\n";
		message += "java.home/lib: " + System.getProperty("java.home")
		    + File.separator + "lib\n";
		
		System.err.println(message);
                throw new Exception("JSAPI Synthesizer cannot be constructed");
	    }

            // create the voice
            String voiceName = System.getProperty("voiceName", "kevin16");
	    Voice voice = new Voice
                (voiceName, Voice.GENDER_DONT_CARE, Voice.AGE_DONT_CARE, null);

	    // get it ready to speak
	    synthesizer.allocate();
	    synthesizer.resume();
            synthesizer.getSynthesizerProperties().setVoice(voice);

        } catch (Exception e) {
            e.printStackTrace();
            throw new Exception("Unable to initialize CardMatchVoice");
        }
    }

    /**
     * Gets a property by name and returns its value. If the property
     * cannot be found, the default is returned
     *
     * @param name the name of the property
     *
     * @param defaultValue the default value to use if the property
     * cannot be found.
     *
     * @return the string value for the property, or the defaultValue if 
     *  the property cannot be found
     */
    public static String getProperty(String name, String defaultValue) {
        String value;
        try {
            value = System.getProperty(name, defaultValue);
        } catch (SecurityException se) {
            value = defaultValue;
        }
        return value;
    }

    /**
     * Speaks the given string of text.
     *
     * @param text the text to speak
     */
    public void speak(String text) {
        if (synthesizer != null) {
            try {
                synthesizer.speakPlainText(text, null);
            } catch (EngineStateError ese) {
                ese.printStackTrace();
            }
        } else {
            System.out.println("CardMatchVoice unavailable");
        }
    }

    /**
     * Shuts down this CardMatchVoice.
     */
    public void close() {
        if (synthesizer != null) {
            try {
                synthesizer.deallocate();
            } catch (Exception e) {
                e.printStackTrace();
            }
        }
    }
}