@voice-ping/cognitive-services-speech
Version:
VoicePing Cognitive Services Speech SDK for JavaScript forked from Microsoft
147 lines (145 loc) • 6.68 kB
JavaScript
//
// Copyright (c) Microsoft. All rights reserved.
// Licensed under the MIT license. See LICENSE.md file in the project root for full license information.
//
import { ServiceRecognizerBase, SynthesisAdapterBase, } from "../common.speech/Exports";
import { ConnectionMessageImpl } from "./ConnectionMessage";
import { Contracts } from "./Contracts";
import { ConnectionEventArgs, ConnectionMessageEventArgs, ServiceEventArgs, } 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.1.
*/
export class Connection {
/**
* 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) {
const recoBase = recognizer.internalData;
const ret = new Connection();
ret.privInternalData = recoBase;
ret.setupEvents();
return ret;
}
/**
* Gets the Connection instance from the specified synthesizer.
* @param synthesizer The synthesizer associated with the connection.
* @return The Connection instance of the synthesizer.
*/
static fromSynthesizer(synthesizer) {
const synthBase = synthesizer.internalData;
const ret = new Connection();
ret.privInternalData = synthBase;
ret.setupEvents();
return ret;
}
/**
* 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 notified when the connection is established.
*/
openConnection() {
this.privInternalData.connect();
}
/**
* 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 with an error.
*/
closeConnection() {
if (this.privInternalData instanceof SynthesisAdapterBase) {
throw new Error("Disconnecting a synthesizer's connection is currently not supported");
}
else {
this.privInternalData.disconnect();
}
}
/**
* Appends a parameter in a message to service.
* Added in version 1.12.1.
* @param path The path of the network message.
* @param propertyName Name of the property
* @param propertyValue Value of the property. This is a json string.
*/
setMessageProperty(path, propertyName, propertyValue) {
Contracts.throwIfNullOrWhitespace(propertyName, "propertyName");
if (this.privInternalData instanceof ServiceRecognizerBase) {
if (path.toLowerCase() !== "speech.context") {
throw new Error("Only speech.context message property sets are currently supported for recognizer");
}
else {
this.privInternalData.speechContext.setSection(propertyName, propertyValue);
}
}
else if (this.privInternalData instanceof SynthesisAdapterBase) {
if (path.toLowerCase() !== "synthesis.context") {
throw new Error("Only synthesis.context message property sets are currently supported for synthesizer");
}
else {
this.privInternalData.synthesisContext.setSection(propertyName, propertyValue);
}
}
}
/**
* Sends a message to the speech service.
* Added in version 1.13.0.
* @param path The WebSocket path of the message
* @param payload The payload of the message. This is a json string or a ArrayBuffer.
* @param success A callback to indicate success.
* @param error A callback to indicate an error.
*/
sendMessageAsync(path, payload, success, error) {
this.privInternalData.sendNetworkMessage(path, payload, success, error);
}
/**
* Dispose of associated resources.
*/
close() {
/* tslint:disable:no-empty */
}
setupEvents() {
this.privEventListener = this.privInternalData.connectionEvents.attach((connectionEvent) => {
if (connectionEvent.name === "ConnectionEstablishedEvent") {
if (!!this.connected) {
this.connected(new ConnectionEventArgs(connectionEvent.connectionId));
}
}
else if (connectionEvent.name === "ConnectionClosedEvent") {
if (!!this.disconnected) {
this.disconnected(new ConnectionEventArgs(connectionEvent.connectionId));
}
}
else if (connectionEvent.name === "ConnectionMessageSentEvent") {
if (!!this.messageSent) {
this.messageSent(new ConnectionMessageEventArgs(new ConnectionMessageImpl(connectionEvent.message)));
}
}
else if (connectionEvent.name === "ConnectionMessageReceivedEvent") {
if (!!this.messageReceived) {
this.messageReceived(new ConnectionMessageEventArgs(new ConnectionMessageImpl(connectionEvent.message)));
}
}
});
this.privServiceEventListener = this.privInternalData.serviceEvents.attach((e) => {
if (!!this.receivedServiceMessage) {
this.receivedServiceMessage(new ServiceEventArgs(e.jsonString, e.name));
}
});
}
}
//# sourceMappingURL=Connection.js.map