Cobra Voice Activity Detection
Android API

API Reference for the Android Cobra SDK (cobra-android)

package: ai.picovoice.cobra

Cobra

public class Cobra { }

Class for the Cobra VAD engine.

Cobra must be initialized using the constructor. Resources should be cleaned when you are done using the delete() function.

Cobra.Cobra()

public Cobra(String accessKey) throws CobraException

Constructor for the Cobra VAD engine.

Parameters

• accessKey String : AccessKey obtained from Picovoice Console.

Returns

• Cobra : Returns an instance of Cobra.

Throws

• CobraException: If an error occurs while creating an instance of Cobra VAD engine.

Cobra.getFrameLength()

public int getFrameLength();

Getter for required number of audio samples per frame.

Returns

• int : Required number of audio samples per frame.

Cobra.getSampleRate()

public int getSampleRate();

Getter for required audio sample rate

Returns

• int : Required audio sample rate.

Cobra.getVersion()

public String getVersion();

Getter for Cobra version.

Returns

• String : Cobra version.

Cobra.delete()

public void delete();

Releases resources acquired by Cobra.

Cobra.process()

public float process(short[] pcm) throws CobraException

Processes a frame of the incoming audio stream and emits the detection result. The required number of samples-per-frame can be obtained by calling .getFrameLength(). The incoming audio needs to have a sample rate equal to .getSampleRate() and be 16-bit linearly-encoded. Cobra operates on single-channel audio.

Parameters

• pcm short[] : A frame of audio samples.

Returns

• float : Probability of voice activity. It is a floating-point number within [0, 1].

Throws

• CobraException: If an error occurs while processing.

CobraException

public class CobraException extends Exception { }

Exception thrown if an error occurs within Cobra VAD engine.

Exceptions

public class CobraActivationException           extends CobraException { }
public class CobraActivationLimitException      extends CobraException { }
public class CobraActivationRefusedException    extends CobraException { }
public class CobraActivationThrottledException  extends CobraException { }
public class CobraIOException                   extends CobraException { }
public class CobraInvalidArgumentException      extends CobraException { }
public class CobraInvalidStateException         extends CobraException { }
public class CobraKeyException                  extends CobraException { }
public class CobraMemoryException               extends CobraException { }
public class CobraRuntimeException              extends CobraException { }
public class CobraStopIterationException        extends CobraException { }