Cloud Speech Streaming gRPC Objective-C Sample
This app demonstrates how to make streaming gRPC connections to the Cloud Speech API to recognize speech in recorded audio.
- An iOS API key for the Cloud Speech API (See the docs to learn more)
- An OSX machine or emulator
- Xcode 7
- Cocoapods version 1.0 or later
- Clone this repo and
cdinto this directory.
pod installto download and build Cocoapods dependencies.
- Open the project by running
YOUR_API_KEYwith the API key obtained above.
- Build and run the app.
Running the app
As with all Google Cloud APIs, every call to the Speech API must be associated with a project within the Google Cloud Console that has the Speech API enabled. This is described in more detail in the getting started doc, but in brief:
Clone this repository on GitHub. If you have
gitinstalled, you can do this by executing the following command:
$ git clone https://github.com/GoogleCloudPlatform/ios-docs-samples.git
This will download the repository of samples into the directory
cdinto this directory in the repository you just cloned, and run the command
pod installto prepare all Cocoapods-related dependencies.
open Speech.xcworkspaceto open this project in Xcode. Since we are using Cocoapods, be sure to open the workspace and not Speech.xcodeproj.
In Xcode's Project Navigator, open the
SpeechRecognitionService.mfile within the
Find the line where the
API_KEYis set. Replace the string value with the iOS API key obtained from the Cloud console above. This key is the credential used to authenticate all requests to the Speech API. Calls to the API are thus associated with the project you created above, for access and billing purposes.
You are now ready to build and run the project. In Xcode you can do this by clicking the 'Play' button in the top left. This will launch the app on the simulator or on the device you've selected. Be sure that the 'Speech' target is selected in the popup near the top left of the Xcode window.
Start Streamingbutton. This uses a custom AudioController class to capture audio in an in-memory instance of NSMutableData. When this data reaches a certain size, it is sent to the SpeechRecognitionService class, which streams it to the speech recognition service. Packets are streamed as instances of the RecognizeRequest object, and the first RecognizeRequest object sent also includes configuration information in an instance of InitialRecognizeRequest. As it runs, the AudioController logs the number of samples and average sample magnitude for each packet that it captures.
Say a few words and wait for the display to update when your speech is recognized.
Stop Streamingbutton to stop capturing audio and close your gRPC connection.