Falcon Speaker Diarization
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 Falcon-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/falcon.git

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

pod 'Falcon-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 Falcon Speaker Diarization:

import Falcon

let accessKey = "${ACCESS_KEY}"

do {
    let falcon = Falcon(accessKey: accessKey)
} catch { }

Perform diarization on an audio file either by passing the absolute path or an url to the file:

do {
    let audioPath = Bundle(for: type(of: self)).path(
      forResource: "${AUDIO_FILE_NAME}",
      ofType: "${AUDIO_FILE_EXTENSION}")
    let segments = falcon.processFile(audioPath);
   // take action based on the speaker segments
} catch { }

Perform diarization on raw audio data (sample rate of 16 kHz, 16-bit linearly encoded and 1 channel):

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

do {
   let segments = falcon.process(getNextAudioFrame());
   // take action based on the speaker segments
} catch { }

Release resources explicitly when done with Falcon Speaker Diarization:

falcon.delete()

Segments

Falcon Speaker Diarization returns an array of segments. Each segment has the following properties:

• Start Time: Indicates when the segment started. Value is in seconds.
• End Time: Indicates when the segment ended. Value is in seconds.
• Speaker Tag: A non-negative integer identifying unique speakers.

Demo

For the Falcon Speaker Diarization iOS SDK, we offer demo applications that demonstrate how to use the Speaker Diarization engine on audio recordings.

Setup

Clone the Falcon Speaker Diarization repository from GitHub using HTTPS:

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

Usage

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

2. Open the FalconDemo.xcodeproj in XCode and run the demo.

For more information on our Falcon Speaker Diarization demo for iOS, head over to our GitHub repository.

Resources