ai.picovoice.picovoice

Class Picovoice

java.lang.Object

ai.picovoice.picovoice.Picovoice

public class Picovoice
extends java.lang.Object

Android binding for Picovoice end-to-end platform. Picovoice enables building voice experiences similar to Alexa but runs entirely on-device (offline).

Picovoice detects utterances of a customizable wake word (phrase) within an incoming stream of audio in real-time. After detection of wake word, it begins to infer the user's intent from the follow-on spoken command. Upon detection of wake word and completion of voice command, it invokes user-provided callbacks to signal these events.

Picovoice processes incoming audio in consecutive frames. The number of samples per frame is $getFrameLength(). The incoming audio needs to have a sample rate equal to $getSampleRate() and be 16-bit linearly-encoded. Picovoice operates on single-channel audio. It uses Porcupine wake word engine for wake word detection and Rhino Speech-to-Intent engine for intent inference.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	Picovoice.Builder Builder for creating an instance of Picovoice with a mixture of default arguments

Method Summary

Modifier and Type	Method and Description
void	delete() Releases resources acquired.
java.lang.String	getContextInformation() Getter for the Rhino context
int	getFrameLength() Getter for number of audio samples per frame.
java.lang.String	getPorcupineVersion() Getter for the version of Porcupine
java.lang.String	getRhinoVersion() Getter for the version of Rhino
int	getSampleRate() Getter for audio sample rate accepted by Picovoice.
java.lang.String	getVersion() Getter for version.
void	process(short[] pcm) Processes a frame of the incoming audio stream.

Methods inherited from class java.lang.Object

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

Method Detail

delete

public void delete()

Releases resources acquired.

process

public void process(short[] pcm)
             throws PicovoiceException

Processes a frame of the incoming audio stream. Upon detection of wake word and completion of follow-on command inference invokes user-defined callbacks.

Parameters:

pcm - A frame of audio samples. The number of samples per frame can be attained by calling $getFrameLength(). The incoming audio needs to have a sample rate equal to $getSampleRate() and be 16-bit linearly-encoded. Picovoice operates on single-channel audio.

Throws:

PicovoiceException - if there is an error while processing the audio frame.

getVersion

public java.lang.String getVersion()

Getter for version.

Returns:

Version.

getFrameLength

public int getFrameLength()

Getter for number of audio samples per frame.

Returns:

Number of audio samples per frame.

getSampleRate

public int getSampleRate()

Getter for audio sample rate accepted by Picovoice.

Returns:

Audio sample rate accepted by Picovoice.

getContextInformation

public java.lang.String getContextInformation()

Getter for the Rhino context

Returns:

Rhino context

getPorcupineVersion

public java.lang.String getPorcupineVersion()

Getter for the version of Porcupine

Returns:

Porcupine version

getRhinoVersion

public java.lang.String getRhinoVersion()

Getter for the version of Rhino

Returns:

Rhino version