io.spokestack.spokestack.google

Class GoogleSpeechRecognizer

java.lang.Object

io.spokestack.spokestack.google.GoogleSpeechRecognizer

All Implemented Interfaces:

SpeechProcessor, AutoCloseable

public final class GoogleSpeechRecognizer
extends Object
implements SpeechProcessor

google speech api recognizer

This pipeline component uses the Google Speech API to stream audio samples from spokestack for speech recognition. When the speech context is triggered, the recognizer begins streaming buffered frames to the API for recognition. Once the speech context becomes inactive, the recognizer completes the API request and raises a RECOGNIZE event along with the audio transcript and confidence.

This pipeline component supports the following configuration properties:

• sample-rate (integer): audio sampling rate, in Hz
• google-credentials (string): json-stringified google service account credentials, used to authenticate with the speech API
• locale (string): language code for speech recognition

Constructor Summary

Constructors

Constructor and Description
GoogleSpeechRecognizer(SpeechConfig speechConfig) initializes a new recognizer instance.
GoogleSpeechRecognizer(SpeechConfig speechConfig, com.google.cloud.speech.v1.SpeechClient speechClient) initializes a new recognizer instance with an existing google client, for testing/mocking purposes.

Method Summary

Modifier and Type	Method and Description
void	close() releases the resources associated with the recognizer.
void	process(SpeechContext context, ByteBuffer frame) processes a frame of audio.
void	reset() resets all state internal to the stage.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

GoogleSpeechRecognizer

public GoogleSpeechRecognizer(SpeechConfig speechConfig)
                       throws Exception

initializes a new recognizer instance.

Parameters:

speechConfig - spokestack pipeline configuration

Throws:

Exception - on error

GoogleSpeechRecognizer

public GoogleSpeechRecognizer(SpeechConfig speechConfig,
                              com.google.cloud.speech.v1.SpeechClient speechClient)
                       throws Exception

initializes a new recognizer instance with an existing google client, for testing/mocking purposes.

Parameters:

speechConfig - spokestack pipeline configuration

speechClient - google speech api client

Throws:

Exception - on error

Method Detail

reset

public void reset()

Description copied from interface: SpeechProcessor

resets all state internal to the stage.

Specified by:

reset in interface SpeechProcessor

close

public void close()

releases the resources associated with the recognizer.

Specified by:

close in interface AutoCloseable

process

public void process(SpeechContext context,
                    ByteBuffer frame)
             throws Exception

processes a frame of audio.

Specified by:

process in interface SpeechProcessor

Parameters:

context - the current speech context

frame - the audio frame to detect

Throws:

Exception - on error