Package ai.picovoice.octopus

Class Octopus

java.lang.Object

ai.picovoice.octopus.Octopus

public class Octopus
extends java.lang.Object

Android binding for Octopus Speech-to-Index engine. It transforms audio into searchable metadata.

Nested Class Summary

Nested Classes

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

Method Summary

Modifier and Type	Method	Description
void	delete()	Releases resources acquired by Octopus.
int	getPcmDataSampleRate()	Getter for required audio sample rate for PCM data.
java.lang.String	getVersion()	Getter for Octopus version.
OctopusMetadata	indexAudioData(short[] pcm)	Indexes raw PCM data.
OctopusMetadata	indexAudioFile(java.lang.String path)	Reads and indexes a given audio file.
java.util.HashMap<java.lang.String,OctopusMatch[]>	search(OctopusMetadata metadata, java.util.HashSet<java.lang.String> phrases)	Searches metadata for a given set of phrases.
static void	setSdk(java.lang.String sdk)

Methods inherited from class java.lang.Object

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

Method Detail

setSdk

public static void setSdk(java.lang.String sdk)

delete

public void delete()

Releases resources acquired by Octopus.

indexAudioData

public OctopusMetadata indexAudioData(short[] pcm)
                               throws OctopusException

Indexes raw PCM data.

Parameters:

pcm - An array of audio samples. The audio needs to have a sample rate equal to getPcmDataSampleRate() and be single-channel, 16-bit linearly-encoded.

Returns:

OctopusMetadata object that is used to perform searches.

Throws:

OctopusException - if there is an error while processing the audio data.

indexAudioFile

public OctopusMetadata indexAudioFile(java.lang.String path)
                               throws OctopusException

Reads and indexes a given audio file.

Parameters:

path - Absolute path to an audio file.

Returns:

OctopusMetadata object that is used to perform searches.

Throws:

OctopusException - if there is an error while processing the audio data.

search

public java.util.HashMap<java.lang.String,OctopusMatch[]> search(OctopusMetadata metadata,
                                                                       java.util.HashSet<java.lang.String> phrases)
                                                                throws OctopusException

Searches metadata for a given set of phrases.

Parameters:

metadata - An OctopusMetadata object obtained via indexAudioData(short[]) or indexAudioFile(String).

phrases - A set of phrases to search for in the metadata.

Returns:

a map of phrases and match arrays. Matches are represented by immutable OctopusMatch objects.

Throws:

OctopusException - if there is an error while performing the search query.

getPcmDataSampleRate

public int getPcmDataSampleRate()

Getter for required audio sample rate for PCM data.

Returns:

Required audio sample rate for PCM data.

getVersion

public java.lang.String getVersion()

Getter for Octopus version.

Returns:

Octopus version.