marytts.client.http

Class MaryHttpClient

java.lang.Object

marytts.client.MaryClient

marytts.client.http.MaryHttpClient

public class MaryHttpClient
extends MaryClient

An HTTP client implementing the MARY protocol. It can be used as a command line client or from within java code.

Author:

Marc Schröder, oytun.turk

See Also:

A GUI interface to this client, Description of the MARY protocol.

Nested Class Summary

Nested classes/interfaces inherited from class marytts.client.MaryClient

MaryClient.AudioPlayerListener, MaryClient.DataType, MaryClient.Voice, MaryClient.WarningReader

Field Summary

Fields inherited from class marytts.client.MaryClient

beQuiet, data, doProfile

Constructor Summary

Constructors

Constructor and Description
MaryHttpClient() The simplest way to create a mary client.
MaryHttpClient(Address serverAddress) The typical way to create a mary client.
MaryHttpClient(Address serverAddress, boolean profile, boolean quiet) An alternative way to create a mary client, which works with applets.
MaryHttpClient(boolean quiet)

Method Summary

Modifier and Type	Method and Description
protected void	_process(String input, String inputType, String outputType, String locale, String audioType, String defaultVoiceName, String defaultStyle, String defaultEffects, Object output, long timeout, boolean streamingAudio, String outputTypeParams, MaryClient.AudioPlayerListener playerListener)
protected void	fillAudioFileFormatAndOutTypes()
protected void	fillDataTypes()
protected void	fillEffectHelpText(String effectName)
protected void	fillLocales()
protected void	fillServerExampleText(String dataType, String locale)
protected void	fillServerVersion()
protected void	fillVoiceExampleTexts(String voicename)
protected void	fillVoices()
protected String	getDefaultAudioEffects() Request the available audio effects for a voice from the server
String	getDiscreteFeatures(String locale)
String	getFeatures(String locale)
String	getFeaturesForVoice(String voice)
boolean	isHMMEffect(String effectName)
String	requestDefaultEffectParameters(String effectName)
String	requestFullEffect(String effectName, String currentEffectParameters)

Methods inherited from class marytts.client.MaryClient

getAddress, getAllDataTypes, getAudioEffects, getAudioFileFormatType, getAudioFileFormatTypes, getAudioOutTypes, getGeneralDomainVoices, getGeneralDomainVoices, getHost, getInputDataTypes, getLimitedDomainVoices, getLimitedDomainVoices, getLocales, getMaryClient, getMaryClient, getMaryClient, getOutputDataTypes, getPort, getServerExampleText, getVoiceExampleTextsLimitedDomain, getVoices, getVoices, initialise, isServerVersionAtLeast, main, process, process, process, process, requestEffectHelpText, streamAudio, usage

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

MaryHttpClient

public MaryHttpClient()
               throws IOException

The simplest way to create a mary client. It will connect to the MARY server running at DFKI. Only use this for testing purposes!

Throws:

IOException - if communication with the server fails

MaryHttpClient

public MaryHttpClient(boolean quiet)
               throws IOException

Throws:

IOException

MaryHttpClient

public MaryHttpClient(Address serverAddress)
               throws IOException

The typical way to create a mary client. It will connect to the MARY client running at the given host and port. This constructor reads two system properties:

• mary.client.profile (=true/false) - determines whether profiling (timing) information is calculated;
• mary.client.quiet (=true/false) - tells the client not to print any of the normal information to stderr.

Parameters:

serverAddress - the address of the server

Throws:

IOException - if communication with the server fails

MaryHttpClient

public MaryHttpClient(Address serverAddress,
                      boolean profile,
                      boolean quiet)
               throws IOException

An alternative way to create a mary client, which works with applets. It will connect to the MARY client running at the given host and port. Note that in applets, the host must be the same as the one from which the applet was loaded; otherwise, a security exception is thrown.

Parameters:

serverAddress - the address of the server

profile - determines whether profiling (timing) information is calculated

quiet - tells the client not to print any of the normal information to stderr

Throws:

IOException - if communication with the server fails

Method Detail

fillAudioFileFormatAndOutTypes

protected void fillAudioFileFormatAndOutTypes()
                                       throws IOException

Specified by:

fillAudioFileFormatAndOutTypes in class MaryClient

Throws:

IOException

fillServerVersion

protected void fillServerVersion()
                          throws IOException

Specified by:

fillServerVersion in class MaryClient

Throws:

IOException

fillDataTypes

protected void fillDataTypes()
                      throws IOException

Specified by:

fillDataTypes in class MaryClient

Throws:

IOException

fillVoices

protected void fillVoices()
                   throws IOException

Specified by:

fillVoices in class MaryClient

Throws:

IOException

fillLocales

protected void fillLocales()
                    throws IOException

Specified by:

fillLocales in class MaryClient

Throws:

IOException

fillVoiceExampleTexts

protected void fillVoiceExampleTexts(String voicename)
                              throws IOException

Specified by:

fillVoiceExampleTexts in class MaryClient

Throws:

IOException

fillServerExampleText

protected void fillServerExampleText(String dataType,
                                     String locale)
                              throws IOException

Specified by:

fillServerExampleText in class MaryClient

Throws:

IOException

getDefaultAudioEffects

protected String getDefaultAudioEffects()
                                 throws IOException

Request the available audio effects for a voice from the server

Specified by:

getDefaultAudioEffects in class MaryClient

Returns:

A string of available audio effects and default parameters, i.e. "FIRFilter,Robot(amount=50)"

Throws:

IOException - IOException

requestDefaultEffectParameters

public String requestDefaultEffectParameters(String effectName)
                                      throws IOException

Specified by:

requestDefaultEffectParameters in class MaryClient

Throws:

IOException

requestFullEffect

public String requestFullEffect(String effectName,
                                String currentEffectParameters)
                         throws IOException

Specified by:

requestFullEffect in class MaryClient

Throws:

IOException

fillEffectHelpText

protected void fillEffectHelpText(String effectName)
                           throws IOException

Specified by:

fillEffectHelpText in class MaryClient

Throws:

IOException

isHMMEffect

public boolean isHMMEffect(String effectName)
                    throws IOException

Specified by:

isHMMEffect in class MaryClient

Throws:

IOException

getFeatures

public String getFeatures(String locale)
                   throws IOException

Specified by:

getFeatures in class MaryClient

Throws:

IOException

getDiscreteFeatures

public String getDiscreteFeatures(String locale)
                           throws IOException

Throws:

IOException

getFeaturesForVoice

public String getFeaturesForVoice(String voice)
                           throws IOException

Specified by:

getFeaturesForVoice in class MaryClient

Throws:

IOException

_process

protected void _process(String input,
                        String inputType,
                        String outputType,
                        String locale,
                        String audioType,
                        String defaultVoiceName,
                        String defaultStyle,
                        String defaultEffects,
                        Object output,
                        long timeout,
                        boolean streamingAudio,
                        String outputTypeParams,
                        MaryClient.AudioPlayerListener playerListener)
                 throws IOException

Specified by:

_process in class MaryClient

Throws:

IOException