Zebra Translate
iOS Quick Start

Platforms

• iOS (16.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 Zebra-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/zebra.git

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

pod 'Zebra-iOS'

Then, run the following from the project directory:

pod install

Usage

Create an instance of Zebra Translate:

import Zebra

let accessKey = "${ACCESS_KEY}" // AccessKey obtained from Picovoice Console (https://console.picovoice.ai/)
let modelPath = "${MODEL_PATH}" // Replace with a translation model file

do {
    let zebra = Zebra(accessKey: accessKey, modelPath: modelPath)
} catch { }

Read more about how to select a model in the Translation Models section.

Translate text:

do {
   let translation = zebra.translate("${TEXT_TO_TRANSLATE}");
} catch { }

Release resources explicitly when done with Zebra Translate:

zebra.delete()

Translation Models

Supported Zebra translation models are located in our GitHub repository. The selected model decides the source and target translation languages.

The format of the model follows:

zebra_params_${SOURCE}_${TARGET}.pv

Where ${SOURCE} is the language code of the source language and ${TARGET} is the language code of the target language for the translation.

Demo

For the Zebra Translate iOS SDK, we offer a demo application that demonstrates how to use the Translate engine.

Setup

Clone the Zebra Translate repository from GitHub using HTTPS:

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

Usage

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

2. Open ZebraDemo.xcodeproj in Xcode.

3. Go to Product > Scheme and select the scheme for the language pair you would like to demo (e.g. enfrDemo -> English to French translation demo).

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

Resources