Falcon Speaker Diarization
iOS Quick Start

Platforms

• iOS (13.0+)

Requirements

• Xcode
• 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. Install CocoaPods

3. Import the Falcon Speaker Diarization iOS binding by adding the following line to Podfile:

pod 'Falcon-iOS'

4. Run the following from the project directory:

pod install

5. 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. Install dependencies:

cd falcon/demo/ios/FalconDemo
pod install

2. Open the FalconDemo.xcworkspace.

3. Replace let accessKey = "${YOUR_ACCESS_KEY_HERE}" in the file ViewController.swift with a valid AccessKey.

4. Run the demo with a simulator or connected iOS device.

Resources