import { ConnectionEventArgs, Recognizer } from "./Exports"; /** * Connection is a proxy class for managing connection to the speech service of the specified Recognizer. * By default, a Recognizer autonomously manages connection to service when needed. * The Connection class provides additional methods for users to explicitly open or close a connection and * to subscribe to connection status changes. * The use of Connection is optional, and mainly for scenarios where fine tuning of application * behavior based on connection status is needed. Users can optionally call Open() to manually set up a connection * in advance before starting recognition on the Recognizer associated with this Connection. * If the Recognizer needs to connect or disconnect to service, it will * setup or shutdown the connection independently. In this case the Connection will be notified by change of connection * status via Connected/Disconnected events. * Added in version 1.2.0. */ export declare class Connection { private privServiceRecognizer; private privEventListener; /** * Gets the Connection instance from the specified recognizer. * @param recognizer The recognizer associated with the connection. * @return The Connection instance of the recognizer. */ static fromRecognizer(recognizer: Recognizer): Connection; /** * Starts to set up connection to the service. * Users can optionally call openConnection() to manually set up a connection in advance before starting recognition on the * Recognizer associated with this Connection. After starting recognition, calling Open() will have no effect * * Note: On return, the connection might not be ready yet. Please subscribe to the Connected event to * be notfied when the connection is established. */ openConnection(): void; /** * Closes the connection the service. * Users can optionally call closeConnection() to manually shutdown the connection of the associated Recognizer. * * If closeConnection() is called during recognition, recognition will fail and cancel wtih an error. */ closeConnection(): void; /** * The Connected event to indicate that the recognizer is connected to service. */ connected: (args: ConnectionEventArgs) => void; /** * The Diconnected event to indicate that the recognizer is disconnected from service. */ disconnected: (args: ConnectionEventArgs) => void; /** * Dispose of associated resources. */ close(): void; }