Augnito Speech SDK
You can use Augnito SDK to make use of the Speech Recognition AI. To get access credentials or talk to us about your project, get in touch with us at partnerships@augnito.ai.
Installation
Install the library in your project
npm install augnitosdk
Basic Usage
1- Import the library
import { Augnito, AugnitoConfig, AugnitoAPIServer } from 'augnitosdk';
2- Create the configuration file and instantiate Augnito Client
const augnitoConfig: AugnitoConfig = {
server: <your server>,
accountCode: '<your accountcode>',
accessKey: '<your accesskey>',
userTag: '<your usertag>',
sourceApp: '<your sourceapp>',
lmId: '<your lmid>',
};
const augnito = new Augnito(augnitoConfig);
3- Toogle the client!
Now all you have to do is toggle the status when you want to connect/disconnect!
augnito.toggleListening();
That's all!
Note: If the client does not start, it may be that onMicrophoneOnError was called. This was implemented to prevent a user from opening a conection in multiple tabs. You can use requestMicOff to force close other connections.
augnito.onMicrophoneOnError = (isWebClient: boolean) => {
augnito.requestMicOff();
augnito.toggleListening();
};
Mobile Application
Whether you want to use the Augnito App as your microphone, or you want to develop your own app, we got you covered.
All you have to do is initialize the mobile configuration. The SDK will generate a value that you need to use to generate a QR code which should be scanned in the App.
import { AugnitoMobileConfig } from 'augnitosdk';
const mobileConfig: AugnitoMobileConfig = {
enableLogs: false
};
const augnitoMobile = augnito.initMobileClient(mobileConfig);
const code = augnito.getQRCode();
Augnito - Speech Related Callbacks
Name | type | Description |
---|
onPartialResult | (text: string) => void | Partial Result generated from the server |
onFinalResult | (finalText: Recipe) => boolean | A final result is called when text has been processed by the Speech Server. Returns true to stop the processing in the SDK |
onCommandResult | (command: Recipe) => boolean | A command generated from the server. Returns true to stop the processing in the SDK |
onStateChanged | (isConnected: boolean) => void | Callback to indicate the status of the connection has changed. |
onSessionEvent | (data: AugnitoSocketResponse) => void | Callback to intercept Session Events |
onIdleMic | () => void | Callback when the Mic is idle for 5 minutes |
onMicrophoneOnError | (isWebClient: boolean) => void | Callback triggered when trying to start the connection, but it fails because it is already opened. (It can be opened in another tab, or it was not closed properly) |
onError | (error: AugnitoSDKErrorMessage) => void | Callback triggered when the SDK encouters an error |
Augnito Mobile - Speech Related Callbacks
Name | type | Description |
---|
onConnectionRequest | () => void | Callback when a mobile client is requesting to connect |
onMobileScan | () => void | Callback when a mobile client has scanned the QR Code |
Augnito Methods
prop | type | notes |
---|
toggleListening | void | Toggles the Speech API connection: if already connected, it will stop the web socket; otherwise, it will start a new connection. |
isConnected | boolean | Returns the status of the web socket: true if connected; otherwise false. |
getQRCode | string | Returns the Generated Value for the QR Code (If and only if the DeviceId was provided). |
dispose | void | Dispose all resources. |
initMobileClient | AugnitoMobile | Creates a web socket for getting notifications from client mobile application: only to be used with Mobile App |
apisFactory | FactoryAPI | Returns an Abstract Factory to create different API Clients. |
requestMicOff | void | Sends a request to close all opened connections. |
MacrosAPI
MacrosAPI Methods
name | type | notes |
---|
getMacros | Promise: MacroResult | Returns a list of macros for the specified user. |
upsertMacro | Promis: MacroResult | Creates or Updates a Macro for the specified user. |
deleteMacro | Promise: MacroResult | Deletes a Macro for the specified user. |
1- Create Macros Client
const macrosClient = augnito.apisFactory.getMacrosAPI();
import { MacrosAPI } from 'augnitosdk';
const macrosClient = new MacrosAPI(
accountCode,
accessKey,
AugnitoAPIServer.INDIA
);
2- Use the Macros Client to list, create, update or delete user macros
macrosClient
.getMacros({
UserTag: userTag
})
.then((result) => {
console.log(result);
});