The API.AI iOS SDK makes it easy to integrate speech recognition with API.AI natural language processing API on iOS devices. API.AI allows using voice commands and integration with dialog scenarios defined for a particular agent in API.AI.
- Create an API.AI account
- Install CocoaPods
-
Run
pod updatein the ApiAiDemo project folder. -
Open ApiAIDemo.xworkspace in Xcode.
-
In ViewController -viewDidLoad insert API key.
configuration.clientAccessToken = @"YOUR_CLIENT_ACCESS_TOKEN";Note: an agent in api.ai should exist. Keys could be obtained on the agent's settings page.
-
Define sample intents in the agent.
-
Run the app in Xcode. Inputs are possible with text and voice (experimental).
-
Run
pod installin your project folder. -
Update Podfile to include:
pod 'ApiAI' -
Run
pod update
In the AppDelegate.m, add
#import <AVFoundation/AVFoundation.h>
...
[[AVAudioSession sharedInstance] setCategory:AVAudioSessionCategoryPlayAndRecord error:nil];
[[AVAudioSession sharedInstance] setActive:YES error:nil];In the AppDelegate.h, add ApiAI.h import and property:
#import <ApiAI/ApiAI.h>
@property(nonatomic, strong) ApiAI *apiAI;In the AppDelegate.m, add
self.apiAI = [[ApiAI alloc] init];
// Define API.AI configuration here.
id <AIConfiguration> configuration = [[AIDefaultConfiguration alloc] init];
configuration.clientAccessToken = @"YOUR_CLIENT_ACCESS_TOKEN_HERE";
self.apiAI.configuration = configuration;...
// Request using text (assumes that speech recognition / ASR is done using a third-party library, e.g. AT&T)
AITextRequest *request = [apiai textRequest];
request.query = @[@"hello"];
[request setCompletionBlockSuccess:^(AIRequest *request, id response) {
// Handle success ...
} failure:^(AIRequest *request, NSError *error) {
// Handle error ...
}];
[_apiAI enqueue:request];
// Request using voice
AIVoiceRequest *request = [apiai voiceRequest];
[request setCompletionBlockSuccess:^(AIRequest *request, id response) {
// Handle success ...
} failure:^(AIRequest *request, NSError *error) {
// Handle error ...
}];
[_apiAI enqueue:request];