Falcon Speaker Diarization
Android Quick Start

Platforms

• Android (5.0+, API 21+)

Requirements

• Picovoice Account and AccessKey
• Android Studio
• Android device with USB debugging enabled or Android simulator

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 Android Studio.

2. Include mavenCentral() repository in the top-level build.gradle. Then add the following to the app's build.gradle:

dependencies {
    // ...
    implementation 'ai.picovoice:falcon-android:${LATEST_VERSION}' // replace with latest version
}

3. Add the following to the app's AndroidManifest.xml file to enable recording with an Android device's microphone:

<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.RECORD_AUDIO" />

Usage

Create an instance of Falcon Speaker Diarization:

import ai.picovoice.falcon.*;

final String accessKey = "${ACCESS_KEY}"; // AccessKey obtained from Picovoice Console (https://console.picovoice.ai/)

try {
    Falcon falcon = new Falcon.Builder()
      .setAccessKey(accessKey)
      .build(appContext);
} catch (FalconException ex) { }

Perform diarization on an audio file by providing the absolute path to the file on the device:

File audioFile = new File("${AUDIO_FILE_PATH}");
FalconSegment[] segments = falcon.processFile(audioFile.getAbsolutePath());

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

short[] getAudioData() {
    // ...
}
FalconSegment[] segments = falcon.process(getAudioData());

When done, release resources explicitly:

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 Android 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. Open the Android demo using Android Studio.
2. Copy your AccessKey from Picovoice Console into the ACCESS_KEY variable in MainActivity.java.
3. Run the application using a connected Android device or using an Android simulator.

Resources