# 语音听写 iOS SDK 文档

# 1、简介

自2019/8/16起，高阶功效-动态数据调整完全免费开馆！可到这里 动态修正效果 (opens new window) 在线体验
使用方法详见 动态修正

语音听写详细的接口介绍及说明请参考： MSC iOS API 文档 (opens new window)， 在集成过程中如有疑问，可登录，查找答案或与其他开发者交流。

小语种：

• 目前小语种已经适配日语、俄语、西班牙语、法语、韩语，其他小语种敬请期待！

# 2、SDK集成指南

# 第一步：获取appid

# 第二步：工程配置

# 添加库

注意：

1. 添加iflyMSC.framework时，请检查工程BuildSetting中的framwork path的设置，如果出现找不到framework的情况，可以将path清空，在Xcode中删除framework，然后重新添加。
2. iflyMSC.framework最低支持iOS 8.0。

# 设置Bitcode

# 用户隐私权限配置

<key>NSMicrophoneUsageDescription</key>
<string></string>
<key>NSLocationUsageDescription</key>
<string></string>
<key>NSLocationAlwaysUsageDescription</key>
<string></string>
<key>NSContactsUsageDescription</key>
<string></string>

# 第三步：初始化

//Appid是采用的真实身份产品信息，具有着仅有的性，刚开始化时应该要传给Appid。
NSString *initString = [[NSString alloc] initWithFormat:@"appid=%@", @"YourAppid"];
[IFlySpeechUtility createUtility:initString];

注意： 初始化是一个异步过程，可放在App启动时执行初始化，具体代码可以参照Demo的MSCAppDelegate.m。

# 第四步：启动服务

# 第五步：语音听写

//必须体现IFlyRecognizerViewDelegate甄别合同
@interface IATViewController : UIViewController<IFlySpeechRecognizerDelegate>
//没有菜单栏的识别图片男朋友
@property (nonatomic, strong) IFlySpeechRecognizer *iFlySpeechRecognizer;
@end

//创建活动声音面部识别物体
_iFlySpeechRecognizer = [IFlySpeechRecognizer sharedInstance];
//使用识别系统参数表
//设定为听写经济模式
[_iFlySpeechRecognizer setParameter: @"iat" forKey: [IFlySpeechConstant IFLY_DOMAIN]];
//asr_audio_path 是录音带资料名，设置value为nil某些为空撤销手机截图，默许手机截图导航在Library/cache下。
[_iFlySpeechRecognizer setParameter:@"iat.pcm" forKey:[IFlySpeechConstant ASR_AUDIO_PATH]];
//开机掌握贴心服务
[_iFlySpeechRecognizer start];

//IFlySpeechRecognizerDelegate服务协议建立
//判别结杲回代理加盟
- (void) onResults:(NSArray *) results isLast:(BOOL)isLast{}
//自动识别请求终止取到经销
- (void)onCompleted: (IFlySpeechError *) error{}
//已停通话录音回调函数
- (void) onEndOfSpeech{}
//已经录音功能回调函数
- (void) onBeginOfSpeech{}
//音量回调指数函数指数函数
- (void) onVolumeChanged: (int)volume{}
//应用程序撤销了调整
- (void) onCancel{}

# 第六步：音频流识别

//快速设置音频源为音频流（-1）
[self.iFlySpeechRecognizer setParameter:@"-1" forKey:@"audio_source"];

//起动判别业务
[self.iFlySpeechRecognizer startListening];

//载入音视频数据表格
NSData *data = [NSData dataWithContentsOfFile:_pcmFilePath];    //从系统文件中导出音屏
[self.iFlySpeechRecognizer writeAudio:data];//刻录双声道视频，让SDK辨认。推荐将双声道视频数据表格各段刻录。

//音视频输入结尾或失败时，须要启用结尾区分接口方式
[self.iFlySpeechRecognizer stopListening];//音频软件数据源读入已完成，来到处理心态

# 3、常用参数说明

注： 多候选效果是由引擎决定的，并非绝对的。即使设置了多候选，如果引擎并没有识别出候选的词或句，返回结果也还是单个。

# 4、语音听写结果说明

{
  "sn": 1,
  "ls": true,
  "bg": 0,
  "ed": 0,
  "ws": [
    {
      "bg": 0,
      "cw": [
        {
          "w": " 接下来 ",
          "sc": 0
        }
      ]
    },
    {
      "bg": 0,
      "cw": [
        {
          "w": " 的",
          "sc": 0
        }
      ]
    },
    {
      "bg": 0,
      "cw": [
        {
          "w": " 天气怎么样 ",
          "sc": 0
        }
      ]
    },
    {
      "bg": 0,
      "cw": [
        {
          "w": " 怎摸样 ",
          "sc": 0
        }
      ]
    },
    {
      "bg": 0,
      "cw": [
        {
          "w": " 。",
          "sc": 0
        }
      ]
    }
  ]
}

{
  "sn": 1,
  "ls": false,
  "bg": 0,
  "ed": 0,
  "ws": [
    {
      "bg": 0,
      "cw": [
        {
          "w": "让我听",
          "sc": 0
        }
      ]
    },
    {
      "bg": 0,
      "cw": [
        {
          "w": "拉德斯基做曲",
          "sc": 0
        },
        {
          "w": "拉得斯确定曲",
          "sc": 0
        }
      ]
    }
  ]
}

# 动态修正

• 未开启动态修正：实时返回识别结果，每次返回的结果都是对之前结果的追加；
• 开启动态修正：实时返回识别结果，每次返回的结果有可能是对之前结果的的追加，也有可能是要替换之前某次返回的结果（即修正）；
• 开启动态修正，相较于未开启，返回结果的颗粒度更小，视觉冲击效果更佳；
• 使用动态修正功能需到控制台-流式听写-高级功能处点击开通，并设置相应参数方可使用，参数设置方法：dwa=wpgs ；
• 动态修正功能仅 中文 支持；

未开启与开启返回的结果格式不同，若开通了动态修正功能并设置了dwa=wpgs（仅中文支持），会有如下字段返回：

# 5、视频教程

# 6、代理服务器设置方法

net_type=custom, proxy_ip=<host>, proxy_port=<port>
其中，<host>,<port>替换为实际的代理服务器地址和端口。

举列：

NSString *initString = [[NSString alloc] initWithFormat:@"appid=%@, net_type=custom, proxy_ip=192.168.1.2, proxy_port=8080", @"12345678"];  //注意：各参数间，以英文逗号分隔。
[IFlySpeechUtility createUtility:initString]; 

电源接口原案： (IFlySpeechUtility *)createUtility:(NSString *)params

注意： 若在设置代理参数后，使用语音服务过程中，报错10204/10205/10212等网络异常错误时，请查阅以下内容，做出相关操作：

• 讯飞语音聊天SDK的通信网络合同样本用的是标准单位HTTP1.1合同样本，其微商POS机代理合同样本用的是标准单位HTTP微商POS机代理合同样本。
• 加盟代理服务保障器应该苹果支持全双工多问多答策略，即 pipeline 模试。
• 代办的服务端没能对80串口做禁止，没能对下述二级域名做屏蔽广告： hdns.openspeech.cn scs.openspeech.cn open.xf-yun.com dev.voicecloud.cn
• 需有效确保选择工作器只负责管理转发分享数据分析文件包，不调整数据分析文件包的全面性和时序性。
• 代理权功能器在发布数值包时，无法在HTTP合同样本脑袋加 IE6 广告头。

# 7、常见问题

# iOS常见问题资料

答：请参照论谈发帖：

# iOS听写sdk如何下载？

答：文档中心---快速指引 (opens new window)有介绍步骤---根据步骤下载iOS在线听写sdk

# SDK形式是否支持多路并发？

答：sdk：买家端满足计划策划方案，不帮助Android、ios、windows、linux等电商手机平台，不不帮助消息队列; webapi：贴心服务端满足计划策划方案，不限止电商手机平台、不限止语气，不帮助消息队列。

# SDK是否支持本地语音能力？

答：iOS工作平台SDK都支撑本机人转化成、本机人命令行词判别、本机人音频换醒基本功能了，创立应该用后去应该用掌控台下载安装各工作sdk可以了。

# 如何设置语音大发pk10服务URL

答：针对于几个特定服务管理于，可以在createUtility插孔中含有：server_url = http://YourDomainName/msp.do （YourDomainName是说 语音系统大发pk10服务器管理于但是网站域名，请开发技术者自己进行重命名） 举列：

NSString *initString = [[NSString alloc] initWithFormat:@"appid=%@,server_url=%@", @"12345678",@"http://sdk.openspeech.cn/msp.do"];  //注意：各参数间，以英文逗号分隔。
[IFlySpeechUtility createUtility:initString]; 

模块办演： (IFlySpeechUtility *)createUtility:(NSString *)params

# 如何处理iOS SDK音频服务

答：请参看论淡发帖子：

# 集成自己项目后报错10407。

答：一样是在自行的产品集成化时，appid和库档案不输入造成的。

# 是否支持x86架构？

答：当今不不认x86系统架构。

# 在听写过程中如果10秒未说话录制会自动停止。

答：听写vad_eos为能够的数最多禁音时长，以上这点时长会看来音视频停止自动化段开。

# 是否支持小语种？

答：到目前为止小语种现在已经更换日语、俄语水平、比利时语、法文、韩国语，各种小语种届时期许！

# 为什么超过一分钟的音频文件，一分钟后的部分无法识别？

答：听写能够辨别的60s中间的音视频，超一个钟是不了辨别的的。