Leopard Speech-to-Text
iOS Quick Start

Platforms

• iOS (11.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 Leopard iOS binding by adding the following line to Podfile:

pod 'Leopard-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>

Adding Leopard models

Add the Leopard model file in Xcode:

1. Create a model in Picovoice Console or use a default language model .
2. Add the model as a bundled resource by selecting Build Phases and adding it to Copy Bundle Resources step.

Usage

Create an instance of Leopard:

import Leopard

let accessKey = "${ACCESS_KEY}"
let modelPath = Bundle(for: type(of: self)).path(
        forResource: "${LEOPARD_MODEL_FILE}",
        ofType: "pv")!

do {
    let leopard = Leopard(accessKey: accessKey, modelPath: modelPath)
} catch { }

Alternatively, you can provide modelPath as an absolute path to the model file on device.

Transcribe 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 result = leopard.process_file(audioPath);
    print(result.transcript)
} catch let error as LeopardError {
    // handle error
} catch { }

Release resources explicitly when done with Leopard:

leopard.delete()

Demo

For the Leopard iOS SDK, we offer demo applications that demonstrate how to use the Speech-to-Text engine on audio recordings.

Setup

Clone the Leopard repository from GitHub using HTTPS:

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

Usage

1. Install dependencies:

cd leopard/demo/ios/LeopardDemo
pod install

2. Open the LeopardDemo.xcworkspace.

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

4. Go to Product > Scheme and select the scheme for the language you would like to demo (e.g. arDemo -> Arabic Demo, deDemo -> German Demo).

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

Resources