# AIkit通用XTTS合成 iOS SDK 文档

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

@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:@"e2e44feff" callback:cb] // ability callback：注册为能力级别回调，全局级别和能力级别仅调用一个即可。

AIKITParameters *abilityParams = [[AIKITParameters alloc] init];
[abilityParams addString:vcn value:"$paramValue"];
[abilityParams addInt:language value:"$paramValue"];
//[abilityParams addInt:pitch value:50];
//[abilityParams addInt:volume value:50];
//[abilityParams addInt:speed value:50];
//[abilityParams addInt:reg value:0];
//[abilityParams addInt:rdn value:0];
[abilityParams addString:textEncoding value:"$paramValue"];
AiHandle *handle = [AiHelper start:@"e2e44feff" param:abilityParams ctxContent:$usrContext];
if (!handle.isSuccess) {
    return;
}

AIKITInputData *dataBuilder = AIKITInputData.instance();
//输入文本数据
  AIText *text = AIText
       .get("text")         //必填项：设置输入文本key
       .data($text)         //必填项：设置输入字符串文本
       .status(DataStatusOnce)     //非必填：设置输入数据状态，可参考文档7.2节说明及Demo
       .valid();            //必填项：输入数据合法性检查
  dataBuilder.payload(text);
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];

//输入文本数据
AIText *text = AIText
    .get("$key")   //必填项：设置输入文本key
    .encoding($encoding) //非必填：设置音频编码格式
    .compress($compress) //非必填：设置文本压缩格式
    .format($format)     //非必填：设置文本内容格式
    .data($text)         //必填项：设置输入文本内容
    .status($status)     //非必填：设置输入数据状态
    .valid();            //必填项：输入数据合法性检查

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