# AIKit语音唤醒 iOS SDK 文档

// SDK初始化
- (int)initSDK {
  [AiHelper initSDK:^(AiHelperMaker *maker) {
    maker.appId(APPID)
      .apiKey(APIKEY)
      .apiSecret(APISECRET)
      .ability(@"e867a88f2");
  }];
}

@interface callback : NSObject<AIKitCoreDelegate>
// 构建实现AIKitCoreDelegate协议的callback类
@end

@implementation callback
// 实现数据回调函数
- (void)aikitOnResult:(NSString *)ability
             handleId:(NSInteger)handleId
           outputData:(NSArray<AIKITDataModel *> *)data
               usrCtx:(AIKITCtxContent *)context {
    for (AIKITDataModel *model in data) {
        //获取到结果key 和 reslut
        NSString *key = model.key;
        NSData *value = [[NSData alloc] initWithBytes:model.value length:model.len];
  }
}
// 实现事件回调函数
- (void)aikitOnEvent:(NSString *)ability
            handleId:(NSInteger)handleId
               event:(NSInteger)event
           eventData:(NSArray<AIKITDataModel *> *)data
              usrCtx:(AIKITCtxContent *)context {
    // do something to output event
    if (event == AIKIT_EVENT_START) {
    // 引擎计算开始
     } else if (event == AIKIT_EVENT_PROGRESS) {
    // 引擎计算中
     } else if (event == AIKIT_EVENT_END) {
    // 引擎计算结束
  }
}
// 实现错误信息回调函数
- (void)aikitOnError:(NSString*)ability
            handleId:(NSInteger)handleId
               error:(AIKITError*)error
              usrCtx:(AIKITCtxContent*)context {
    // do something to output error
if (error) {
    NSLog(@"引擎错误，错误类型：%d, 错误码：%d, 错误描述：%@",error.type, error.code, error.description);
  }
}
@end
//支持设置一个全局回调，在方法中通过abilityId区分能力，也支持为每一个能力单独设置回调
 callback* cb = [[callback alloc] init];
[AiHelper registerAppCallback:cb];                           // global callback ：注册为全局级别回调
 //[AiHelper registerAbilityCallback:@"e867a88f2" callback:cb] // ability callback：注册为能力级别回调

你好小迪;
小白小白;
小T小T;

AIKITCustomData *customData = [[AIKITCustomData alloc] init];
[customData addTextPath:custom1 key:@"key_word" index:0];

[AiHelper loadData:e867a88f2 data:customData];
int indexs[] = {0};
[AiHelper specifyDataSet:e867a88f2 key:@"key_word" indexs:indexs count:1];

AIKITCustomData *preData = [[AIKITCustomData alloc] init];
[preData addTextPath:$path key:@"key_word" index:indexs];

ret = [AiHelper preProcess:e867a88f2 data:preData];

AIKITParameters *abilityParams = [[AIKITParameters alloc] init];
//[abilityParams addString:wdec_param_nCmThreshold value:"$paramValue"];
//[abilityParams addBool:gramLoad value:"false"];
AiHandle *handle = [AiHelper start:e867a88f2 param:abilityParams  ctxContent:$usrContext];
if (!handle.isSuccess) {
    return;
}

AIKITInputData *dataBuilder = AIKITInputData.instance();
//输入音频数据
  AIAudio *wav = AIAudio
        .get("wav")          //必填项：输入输入音频key
        .data(part)                //必填项：part为 NSData* 类型输入数据
        .status(DataStatusBegin)    //非必填：设置输入数据状态，可参考文档7.2节说明及Demo
        .valid();                  //必填项：输入数据合法性检查
  dataBuilder.payload(wav);
int ret = [AiHelper write:dataBuilder handle:$handle];
if (ret != 0) {
    return;
}

int ret = [AiHelper end:handle];
if (ret != 0)
{
  return;
}

BOOL ret = [AiHelper unInit];

AIKITParameters *abilityParams = [[AIKITParameters alloc] init];
[abilityParams addString:"stringKey" value:"stringValue"];
[abilityParams addDouble:"doubleKey" value:1.001];
[abilityParams addInt:"intKey" value:100];
[abilityParams addBool:"boolKey" value:true];

//输入音频数据
AIAudio *aiAudio = AIAudio
        .get("$key")               //必填项：输入输入音频key
        .encoding($encoding)       //非必填：设置音频编码格式
        .sampleRate($sampleRate)   //非必填：设置音频采样率
        .channels($channels)       //非必填：设置音频声道数
        .bitDepth($bitDepth)       //非必填：设置音频位深
        .data(part)                //必填项：part为 byte[]类型输入数据
        .status(AiStatus.BEGIN)    //非必填：设置输入数据状态
        .valid();                  //必填项：输入数据合法性检查

[AiHelper setLogInfo:(AIKITLogLvl)logLevel mode:logMode path:docPath];

[AiHelper unloadData:e867a88f2 key:key_word index:$index]
可配置参数