Cobra VAD — iOS Quick Start

Platforms

• iOS (13.0+)

Requirements

• Xcode
• Swift Package Manager or CocoaPods

Picovoice Account & AccessKey

Signup or Login to Picovoice Console to get your AccessKey. Make sure to keep your AccessKey secret.

Quick Start

Setup

1. Install Xcode.

2. Import the Cobra-iOS package into your project.

To import the package using SPM, open up your project's Package Dependencies in XCode and add:

https://github.com/Picovoice/cobra.git

To import it into your iOS project using CocoaPods, add the following line to your Podfile:

pod 'Cobra-iOS'

Then, run the following from the project directory:

pod install

3. Add the following to the app's Info.plist file to enable recording with an iOS device's microphone

<key>NSMicrophoneUsageDescription</key>
<string>[Permission explanation]</string>

Usage

Create an instance of the Cobra Voice Activity Detection engine:

import Cobra

do {
    cobra = try Cobra(accessKey: "${ACCESS_KEY}")
} catch { }

Pass in frames of audio to the .process function:

func getNextAudioFrame() -> [Int16] {
    return audioFrame;
}

while true {
    do {
        let voiceProbability = try cobra.process(getNextAudioFrame())
        // take action based on the probability of voice
    } catch { }
}

Release resources explicitly when done with Cobra Voice Activity Detection:

cobra.delete()

Demo

For the Cobra Voice Activity Detection iOS SDK, we offer demo applications that demonstrate how to use the VAD engine on real-time audio streams (i.e. microphone input).

Setup

Clone the Repository

git clone --recurse-submodules https://github.com/Picovoice/cobra.git

Usage

1. Replace "${YOUR_ACCESS_KEY_HERE}" in the file ViewModel.swift with a valid AccessKey.

2. Open the CobraDemo XCode project and run the demo.

For more information on our Cobra Voice Activity Detection demos for iOS, head over to our GitHub repository.

Resources