# AIkit命令词识别 iOS SDK 文档

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

@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:@"e75f07b62" callback:cb] // ability callback：注册为能力级别回调

AIKITParameters *engineParams = [[AIKITParameters alloc] init]; [engineParams addString:decNetType value:$paramValue]; [engineParams addDouble:punishCoefficient value:[$paramValue doubleValue]];
//[engineParams addString:savePath value:$paramValue];
[engineParams addInt:wfst_addType value:[$paramValue intValue]];
int ret = [AiHelper initEngine:self.ability param:engineParams];

0=成功，其他=错误

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

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

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

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

AIKITParameters *abilityParams = [[AIKITParameters alloc] init];
[abilityParams addInt:languageType value:"$paramValue"];
[abilityParams addBool:vadOn value:"$paramValue"];
//[abilityParams addBool:vadLinkOn value:"false"];
[abilityParams addInt:vadEndGap value:"$paramValue"];
//[abilityParams addInt:beamThreshold value:20];
//[abilityParams addInt:hisGramThreshold value:3000];
//[abilityParams addInt:vadSpeechEnd value:80];
//[abilityParams addInt:vadResponsetime value:1000];
//[abilityParams addBool:postprocOn value:"false"];
AiHandle *handle = [AiHelper start:e75f07b62 param:abilityParams  ctxContent:$usrContext];
if (!handle.isSuccess) {
    return;
}

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

ret = [AiHelper read:handle];  // result is output in callback function：$(onResult)
if (ret != 0) {
  NSLog("read error code=%d",ret);
  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:e75f07b62 key:FSA index:$index]
[AiHelper unloadData:e75f07b62 key:FSABIN index:$index]