Mapbox Speech connects your iOS, macOS, tvOS, or watchOS application to the Mapbox Voice API. Take turn instructions from the Mapbox Directions API and read them aloud naturally in multiple languages. This library is specifically designed to work with mapbox-directions-swift as part of the Mapbox Navigation SDK for iOS.
This library is compatible with applications written in Swift. Version 2.0 was the last version of this library to support applications written in Objective-C or AppleScript.
Specify the following dependency in your Carthage Cartfile:
github "mapbox/mapbox-speech-swift" ~> 2.1
Or in your CocoaPods Podfile:
pod 'MapboxSpeech', '~> 2.1'Or in your Swift Package Manager Package.swift:
.package(url: "https://github.com/mapbox/mapbox-speech-swift.git", from: "2.1.1")Then import MapboxSpeech or @import MapboxSpeech;.
You’ll need a Mapbox access token in order to use the API. If you’re already using the Mapbox Maps SDK for iOS or macOS SDK, Mapbox Speech automatically recognizes your access token, as long as you’ve placed it in the MBXAccessToken key of your application’s Info.plist file.
The main speech synthesis class is SpeechSynthesizer. Create a speech synthesizer object using your access token:
import MapboxSpeech
let speechSynthesizer = SpeechSynthesizer(accessToken: "<#your access token#>")Alternatively, you can place your access token in the MBXAccessToken key of your application’s Info.plist file, then use the shared speech synthesizer object:
// main.swift
let speechSynthesizer = SpeechSynthesizer.sharedWith the directions object in hand, construct a SpeechOptions or MBSpeechOptions object and pass it into the SpeechSynthesizer.audioData(with:completionHandler:) method.
// main.swift
let options = SpeechOptions(text: "hello, my name is Bobby")
speechSynthesizer.audioData(with: options) { (data: Data?, error: NSError?) in
guard error == nil else {
print("Error calculating directions: \(error!)")
return
}
// Do something with the audio!
}