Made in Vancouver, Canada by Picovoice
Cobra is a highly accurate and lightweight voice activity detection (VAD) engine.
- Chrome / Edge
- Firefox
- Safari
IndexedDB is required to use Cobra
in a worker thread. Browsers without IndexedDB support
(i.e. Firefox Incognito Mode) should use Cobra
in the main thread.
Using yarn
:
yarn add @picovoice/cobra-web
or using npm
:
npm install --save @picovoice/cobra-web
Cobra requires a valid Picovoice AccessKey
at initialization. AccessKey
acts as your credentials when using Cobra SDKs.
You can get your AccessKey
for free. Make sure to keep your AccessKey
secret.
Signup or Login to Picovoice Console to get your AccessKey
.
Create a voiceProbabilityCallback
function to get voice probability results
from the engine:
function voiceProbabilityCallback(voiceProbability: number) {
}
Add a processErrorCallback
function to the options
object if you would like
to catch errors that occur while processing audio:
function processErrorCallback(error: string) {
}
options.processErrorCallback = processErrorCallback;
Use Cobra
to initialize the engine on the main thread:
const cobra = await Cobra.create(
${ACCESS_KEY},
voiceProbabilityCallback,
options
);
Use CobraWorker
to initialize the engine on a worker thread:
const cobra = await CobraWorker.create(
${ACCESS_KEY},
voiceProbabilityCallback,
options
);
The process
function will send the input frames to the engine.
The engine results are received via the voiceProbabilityCallback
that's passed in during initialization.
function getAudioData(): Int16Array {
... // function to get audio data
return new Int16Array();
}
for (;;) {
cobra.process(getAudioData());
// break on some condition
}
Clean up used resources by Cobra
or CobraWorker
:
await cobra.release();
Terminate CobraWorker
instance:
await cobra.terminate();
For example usage refer to our Web demo application.