augnitosdk

Augnito Speech SDK

You’ve found the Augnito Speech SDK! This is currently still in BETA but 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 [e-mail].

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: AugnitoAPIServer.INDIA,
  accountCode: 'XXXXXXXXXXXXXXXXXXXXXX',
  accessKey: 'XXXXXXXXXXXXXXXXXXXXXX',
  userTag: 'user123',
  sourceApp: 'MyAppName',
  lmId: '38'
};

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!

// Toggles the Speech API connection
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) => {
  //If you want to use Augnito in this tab.
  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);

//Generate a QR Code with the following value
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)

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

// If you already have an augnito client..
const macrosClient = augnito.apisFactory.getMacrosAPI();

// OR
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);
  });