Package com.microsoft.cognitiveservices.speech

Class SpeechConfig

    • Field Detail

      • speechConfigClass

        public static Class<?> speechConfigClass
        Accessor to load the native library. Holds the class active so the class GC does not reclaim it (and the local variables!)

    • Constructor Detail

      • SpeechConfig

        protected SpeechConfig​(long handleValue)
        Internal constructor for speech configuration object.
        Parameters:
        handleValue - The native handle.

    • Method Detail

      • fromSubscription

        public static SpeechConfig fromSubscription​(String subscriptionKey,
                                            String region)
        Creates an instance of a speech config with specified subscription key and service region.
        Parameters:
        subscriptionKey - The subscription key.
        region - The region name (see the region page).
        Returns:
        A speech config instance.

      • fromAuthorizationToken

        public static SpeechConfig fromAuthorizationToken​(String authorizationToken,
                                                  String region)
        Creates an instance of a speech config with specified authorization token and service region. Note: The caller needs to ensure that the authorization token is valid. Before the authorization token expires, the caller needs to refresh it by calling this setter with a new valid token. As configuration values are copied when creating a new recognizer, the new token value will not apply to recognizers that have already been created. For recognizers that have been created before, you need to set authorization token of the corresponding recognizer to refresh the token. Otherwise, the recognizers will encounter errors during recognition.
        Parameters:
        authorizationToken - The authorization token.
        region - The region name (see the region page).
        Returns:
        A speech config instance.

      • fromEndpoint

        public static SpeechConfig fromEndpoint​(URI endpoint,
                                        String subscriptionKey)
        Creates an instance of the speech config with specified endpoint and subscription key. This method is intended only for users who use a non-standard service endpoint or parameters. Note: The query parameters specified in the endpoint URI are not changed, even if they are set by any other APIs. Whether a specific query parameter is supported or not, depends on the endpoint and scenario. For example, if the recognition language is defined in URI as query parameter "language=de-DE", and also set by setSpeechRecognitionLanguage("en-US"), the language setting in URI takes precedence, and the effective language is "de-DE". The example only applies when the endpoint and scenario combination supports language as a query parameter. Only the parameters that are not specified in the endpoint URI can be set by other APIs. Note: To use an authorization token with fromEndpoint, please use fromEndpoint(java.net.URI), and then call setAuthorizationToken() on the created SpeechConfig instance.
        Parameters:
        endpoint - The service endpoint to connect to.
        subscriptionKey - The subscription key.
        Returns:
        A speech config instance.

      • fromEndpoint

        public static SpeechConfig fromEndpoint​(URI endpoint)
        Creates an instance of the speech config with specified endpoint. This method is intended only for users who use a non-standard service endpoint or parameters. Note: The query parameters specified in the endpoint URI are not changed, even if they are set by any other APIs. For example, if the recognition language is defined in URI as query parameter "language=de-DE", and also set by setSpeechRecognitionLanguage("en-US"), the language setting in URI takes precedence, and the effective language is "de-DE". Only the parameters that are not specified in the endpoint URI can be set by other APIs. Note: if the endpoint requires a subscription key for authentication, please use fromEndpoint(java.net.URI, String) to pass the subscription key as parameter. To use an authorization token with fromEndpoint, use this method to create a SpeechConfig instance, and then call setAuthorizationToken() on the created SpeechConfig instance. Note: Added in version 1.5.0.
        Parameters:
        endpoint - The service endpoint to connect to.
        Returns:
        A speech config instance.

      • fromHost

        public static SpeechConfig fromHost​(URI host,
                                    String subscriptionKey)
        Creates an instance of the speech config with specified host and subscription key. This method is intended only for users who use a non-default service host. Standard resource path will be assumed. For services with a non-standard resource path or no path at all, use fromEndpoint instead. Note: Query parameters are not allowed in the host URI and must be set by other APIs. Note: To use an authorization token with fromHost, use fromHost(java.net.URI), and then call setAuthorizationToken() on the created SpeechConfig instance. Note: Added in version 1.8.0.
        Parameters:
        host - The service host to connect to. Format is "protocol://host:port" where ":port" is optional.
        subscriptionKey - The subscription key.
        Returns:
        A speech config instance.

      • fromHost

        public static SpeechConfig fromHost​(URI host)
        Creates an instance of the speech config with specified host. This method is intended only for users who use a non-default service host. Standard resource path will be assumed. For services with a non-standard resource path or no path at all, use fromEndpoint instead. Note: Query parameters are not allowed in the host URI and must be set by other APIs. Note: If the host requires a subscription key for authentication, use fromHost(java.net.URI, String) to pass the subscription key as parameter. To use an authorization token with fromHost, use this method to create a SpeechConfig instance, and then call setAuthorizationToken() on the created SpeechConfig instance. Note: Added in version 1.8.0.
        Parameters:
        host - The service host to connect to. Format is "protocol://host:port" where ":port" is optional.
        Returns:
        A speech config instance.

      • setAuthorizationToken

        public void setAuthorizationToken​(String value)
        Sets the authorization token. Note: The caller needs to ensure that the authorization token is valid. Before the authorization token expires, the caller needs to refresh it by calling this setter with a new valid token. As configuration values are copied when creating a new recognizer, the new token value will not apply to recognizers that have already been created. For recognizers that have been created before, you need to set authorization token of the corresponding recognizer to refresh the token. Otherwise, the recognizers will encounter errors during recognition.
        Parameters:
        value - the authorization token.

      • getAuthorizationToken

        public String getAuthorizationToken()
        Gets the authorization token.
        Returns:
        The authorization token.

      • setSpeechRecognitionLanguage

        public void setSpeechRecognitionLanguage​(String value)
        Sets the speech recognition language
        Parameters:
        value - the language identifier in BCP-47 format.

      • getSpeechRecognitionLanguage

        public String getSpeechRecognitionLanguage()
        Gets the speech recognition language
        Returns:
        Returns the recognition language.

      • setEndpointId

        public void setEndpointId​(String value)
        Sets the endpoint ID of a customized speech model that is used for speech recognition, or a custom voice model for speech synthesis.
        Parameters:
        value - the endpoint ID.

      • getEndpointId

        public String getEndpointId()
        Gets the endpoint ID of a customized speech model that is used for speech recognition, or a custom voice model for speech synthesis.
        Returns:
        The endpoint ID.

      • setSpeechSynthesisLanguage

        public void setSpeechSynthesisLanguage​(String value)
        Sets the speech synthesis language. Added in version 1.7.0
        Parameters:
        value - the language identifier in BCP-47 format (e.g. en-US).

      • getSpeechSynthesisLanguage

        public String getSpeechSynthesisLanguage()
        Gets the speech synthesis language. Added in version 1.7.0
        Returns:
        Returns the synthesis language.

      • setSpeechSynthesisVoiceName

        public void setSpeechSynthesisVoiceName​(String value)
        Sets the speech synthesis voice name. Added in version 1.7.0
        Parameters:
        value - The speech synthesis voice name.

      • getSpeechSynthesisVoiceName

        public String getSpeechSynthesisVoiceName()
        Gets the speech synthesis voice name. Added in version 1.7.0
        Returns:
        Returns the synthesis voice name.

      • setSpeechSynthesisOutputFormat

        public void setSpeechSynthesisOutputFormat​(SpeechSynthesisOutputFormat value)
        Sets the speech synthesis output format. Added in version 1.7.0
        Parameters:
        value - The synthesis output format ID (e.g. Riff16Khz16BitMonoPcm).

      • getSpeechSynthesisOutputFormat

        public String getSpeechSynthesisOutputFormat()
        Gets the speech synthesis output format. Added in version 1.7.0
        Returns:
        Returns the synthesis output format.

      • setProxy

        public void setProxy​(String proxyHostName,
                     int proxyPort,
                     String proxyUserName,
                     String proxyPassword)
        Sets proxy configuration Added in version 1.1.0. Note: Proxy functionality is not available on macOS. This function will have no effect on this platform.
        Parameters:
        proxyHostName - the host name of the proxy server, without the protocol scheme (http://)
        proxyPort - the port number of the proxy server.
        proxyUserName - the user name of the proxy server. Use empty string if no user name is needed.
        proxyPassword - the password of the proxy server. Use empty string if no user password is needed.

      • setProperty

        public void setProperty​(String name,
                        String value)
        Sets a named property as value.
        Parameters:
        name - the name of the property.
        value - the value.

      • setProperty

        public void setProperty​(PropertyId id,
                        String value)
        Sets the property by propertyId. Added in version 1.3.0.
        Parameters:
        id - PropertyId of the property.
        value - The value.

      • getProperty

        public String getProperty​(String name)
        Gets a named property as value.
        Parameters:
        name - the name of the property.
        Returns:
        The value.

      • getProperty

        public String getProperty​(PropertyId id)
        Gets the property by propertyId. Added in version 1.3.0.
        Parameters:
        id - PropertyId of the property.
        Returns:
        The value.

      • setServiceProperty

        public void setServiceProperty​(String name,
                               String value,
                               ServicePropertyChannel channel)
        Sets a property value that will be passed to service using the specified channel. Added in version 1.5.0.
        Parameters:
        name - the property name.
        value - the property value.
        channel - the channel used to pass the specified property to service.

      • setProfanity

        public void setProfanity​(ProfanityOption profanity)
        Sets profanity option. Added in version 1.5.0.
        Parameters:
        profanity - the property option to set.

      • enableAudioLogging

        public void enableAudioLogging()
        Enable audio logging in service. Audio and content logs are stored either in Microsoft-owned storage, or in your own storage account linked to your Cognitive Services subscription (Bring Your Own Storage (BYOS) enabled Speech resource). Added in version 1.5.0.

      • requestWordLevelTimestamps

        public void requestWordLevelTimestamps()
        Includes word-level timestamps. Added in version 1.5.0.

      • enableDictation

        public void enableDictation()
        Enable dictation. Only supported in speech continuous recognition. Added in version 1.5.0.

      • close

        public void close()
        Dispose of associated resources.
        Specified by:
        close in interface AutoCloseable

      • getImpl

        public SafeHandle getImpl()
        Get the native handle to speech config object.
        Returns:
        The native handle.