1.登陆界面/，并注册
2.点击右上角的图标，弹出下拉框，选择创建应用
3.按要求填写并提交，并记录该appid
4.然后点击立即开通
5.选择所要添加的业务，并点击确定
6.在跳转后的界面选择SDK下载
7.选择所需要的服务、平台和应用，并点击下载
8.下载完成，解压压缩包如下所示，sample为官方提供的例子
9.将assets文件夹中的内容拷贝到项目assets文件夹中，将Msc.jar和Sunflower.jar拷贝到文件夹libs中，在和res同级的目录下创建jniLibs文件夹（），并将下载下来的libs目录下的所有libmsc.so文件拷贝到该文件夹下（很重要，目录结构一定不要创建错，否则会报错误“创建对象失败，请确认 libmsc.so 放置正确，且有调用 createUtility 进行初始化”）
10.在AndroidMainfest.xml中添加如下权限
<uses-permission android:name="android.permission.RECORD_AUDIO" />
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission android:name="android.permission.CHANGE_NETWORK_STATE" />
<uses-permission android:name="android.permission.READ_PHONE_STATE" />
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<uses-permission android:name="android.permission.READ_CONTACTS" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.WRITE_SETTINGS" />
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
11.将上图中的appid记录下来，并保存到string文件中
12.新建一个类继承Application,并在AndroidMainfest.xml中进行配置，并在该类中初始化SppeechUtilitity对象
13.初始化所需对象数据
14.点击开始按钮时，设置所需要的参数，弹出话筒框，并设置监听到的信息的监听
15.点击取消和停止按钮的时候，如果话筒弹框显示则隐藏，如果设置的不显示，调用方法checkSoIsInstallSucceed()检测连接的实例对象是否创建成功
16.在界面销毁的时候，释放连接
17.运行界面
注：1.jnilibs文件夹必须和资源文件夹res在同一层目录，否则.so文件找不到，会一直报“创建对象失败，请确认 libmsc.so 放置正确，且有调用 createUtility 进行初始化”错误
2.实例化对象RecognizerDialog时，上下文必须传递当前的Activity，否则程序会崩溃
3.appid必须有效
4.主Activity、activitymain.xml和string.xml代码
import android.app.Activity;import android.content.Context;import android.content.SharedPreferences;import android.os.Bundle;import android.os.Environment;import android.util.Log;import android.view.View;import android.widget.Button;import android.widget.EditText;import android.widget.Toast;import com.iflytek.cloud.ErrorCode;import com.iflytek.cloud.InitListener;import com.iflytek.cloud.RecognizerListener;import com.iflytek.cloud.RecognizerResult;import com.iflytek.cloud.SpeechConstant;import com.iflytek.cloud.SpeechError;import com.iflytek.cloud.SpeechRecognizer;import com.iflytek.cloud.SpeechUtility;import com.iflytek.cloud.ui.RecognizerDialog;import com.iflytek.cloud.ui.RecognizerDialogListener;import com.iflytek.sunflower.FlowerCollector;import org.json.JSONException;import org.json.JSONObject;import java.util.HashMap;import java.util.LinkedHashMap;public class MainActivity extends Activity {private Context context;public static final String PREFER_NAME = "com.voice.recognition";// 语音听写对象private SpeechRecognizer mIat;// 语音听写UIprivate RecognizerDialog mIatDialog;// 用HashMap存储听写结果private HashMap<String, String> mIatResults = new LinkedHashMap<String, String>();private Toast mToast;private Button btStart,btStop,btCancel;private EditText etContent;private SharedPreferences mSharedPreferences;private int ret = 0; // 函数调用返回值// 引擎类型private String mEngineType = SpeechConstant.TYPE_CLOUD;/*** 初始化监听器。*/private InitListener mInitListener = new InitListener() {@Overridepublic void onInit(int code) {LogUtil.L("SpeechRecognizer init() code = " + code);if (code != ErrorCode.SUCCESS) {showTip("初始化失败，错误码：" + code);}}};@Overrideprotected void onCreate(Bundle savedInstanceState) {super.onCreate(savedInstanceState);setContentView(R.layout.activity_main);initData();findViewById();setOnclickListener();}private void setOnclickListener(){btStart.setOnClickListener(new View.OnClickListener() {@Overridepublic void onClick(View v) {checkSoIsInstallSucceed();etContent.setText(null);// 清空显示内容mIatResults.clear();// 设置参数setParam();boolean isShowDialog = mSharedPreferences.getBoolean(getString(R.string.pref_key_iat_show), true);if (isShowDialog) {// 显示听写对话框mIatDialog.setListener(mRecognizerDialogListener);mIatDialog.show();showTip(getString(R.string.text_begin));} else {// 不显示听写对话框ret = mIat.startListening(mRecognizerListener);if (ret != ErrorCode.SUCCESS) {showTip("听写失败,错误码：" + ret);} else {showTip(getString(R.string.text_begin));}}}});btStop.setOnClickListener(new View.OnClickListener() {@Overridepublic void onClick(View v) {checkSoIsInstallSucceed();}});btCancel.setOnClickListener(new View.OnClickListener() {@Overridepublic void onClick(View v) {checkSoIsInstallSucceed();}});}private void findViewById(){btStart = (Button) findViewById(R.id.btn_start);btStop = (Button) findViewById(R.id.btn_stop);btCancel = (Button) findViewById(R.id.btn_cancel);etContent = (EditText) findViewById(R.id.et_content);}private void initData(){context = MainActivity.this;// 初始化识别无UI识别对象// 使用SpeechRecognizer对象，可根据回调消息自定义界面；mIat = SpeechRecognizer.createRecognizer(context, mInitListener);// 初始化听写Dialog，如果只使用有UI听写功能，无需创建SpeechRecognizer// 使用UI听写功能，请根据sdk文件目录下的notice.txt,放置布局文件和图片资源mIatDialog = new RecognizerDialog(context, mInitListener);mToast = Toast.makeText(this, "", Toast.LENGTH_SHORT);mSharedPreferences = getSharedPreferences(MainActivity.PREFER_NAME,Activity.MODE_PRIVATE);}private void checkSoIsInstallSucceed(){if( null == mIat ){// 创建单例失败，与 21001 错误为同样原因，参考 /forum.php?mod=viewthread&tid=9688this.showTip( "创建对象失败，请确认 libmsc.so 放置正确，且有调用 createUtility 进行初始化" );return;}}private void showTip(final String str) {mToast.setText(str);mToast.show();}/*** 参数设置** @param* @return*/public void setParam() {// 清空参数mIat.setParameter(SpeechConstant.PARAMS, null);// 设置听写引擎mIat.setParameter(SpeechConstant.ENGINE_TYPE, mEngineType);// 设置返回结果格式mIat.setParameter(SpeechConstant.RESULT_TYPE, "json");String lag = mSharedPreferences.getString("iat_language_preference","mandarin");if (lag.equals("en_us")) {// 设置语言mIat.setParameter(SpeechConstant.LANGUAGE, "en_us");} else {// 设置语言mIat.setParameter(SpeechConstant.LANGUAGE, "zh_cn");// 设置语言区域mIat.setParameter(SpeechConstant.ACCENT, lag);}// 设置语音前端点:静音超时时间，即用户多长时间不说话则当做超时处理mIat.setParameter(SpeechConstant.VAD_BOS, mSharedPreferences.getString("iat_vadbos_preference", "4000"));// 设置语音后端点:后端点静音检测时间，即用户停止说话多长时间内即认为不再输入， 自动停止录音mIat.setParameter(SpeechConstant.VAD_EOS, mSharedPreferences.getString("iat_vadeos_preference", "1000"));// 设置标点符号,设置为"0"返回结果无标点,设置为"1"返回结果有标点mIat.setParameter(SpeechConstant.ASR_PTT, mSharedPreferences.getString("iat_punc_preference", "1"));// 设置音频保存路径，保存音频格式支持pcm、wav，设置路径为sd卡请注意WRITE_EXTERNAL_STORAGE权限// 注：AUDIO_FORMAT参数语记需要更新版本才能生效mIat.setParameter(SpeechConstant.AUDIO_FORMAT,"wav");mIat.setParameter(SpeechConstant.ASR_AUDIO_PATH, Environment.getExternalStorageDirectory()+"/msc/iat.wav");}/*** 听写UI监听器*/private RecognizerDialogListener mRecognizerDialogListener = new RecognizerDialogListener() {public void onResult(RecognizerResult results, boolean isLast) {printResult(results);}/*** 识别回调错误.*/public void onError(SpeechError error) {showTip(error.getPlainDescription(true));}};/*** 听写监听器。*/private RecognizerListener mRecognizerListener = new RecognizerListener() {@Overridepublic void onBeginOfSpeech() {// 此回调表示：sdk内部录音机已经准备好了，用户可以开始语音输入showTip("开始说话");}@Overridepublic void onError(SpeechError error) {// Tips：// 错误码：10118(您没有说话)，可能是录音机权限被禁，需要提示用户打开应用的录音权限。// 如果使用本地功能（语记）需要提示用户开启语记的录音权限。showTip(error.getPlainDescription(true));}@Overridepublic void onEndOfSpeech() {// 此回调表示：检测到了语音的尾端点，已经进入识别过程，不再接受语音输入showTip("结束说话");}@Overridepublic void onResult(RecognizerResult results, boolean isLast) {LogUtil.L(results.getResultString());printResult(results);if (isLast) {// TODO 最后的结果}}@Overridepublic void onVolumeChanged(int volume, byte[] data) {showTip("当前正在说话，音量大小：" + volume);LogUtil.L("返回音频数据："+data.length);}@Overridepublic void onEvent(int eventType, int arg1, int arg2, Bundle obj) {// 以下代码用于获取与云端的会话id，当业务出错时将会话id提供给技术支持人员，可用于查询会话日志，定位出错原因// 若使用本地能力，会话id为null//if (SpeechEvent.EVENT_SESSION_ID == eventType) {//String sid = obj.getString(SpeechEvent.KEY_EVENT_SESSION_ID);//Log.d(TAG, "session id =" + sid);//}}};private void printResult(RecognizerResult results) {String text = JsonParser.parseIatResult(results.getResultString());String sn = null;// 读取json结果中的sn字段try {JSONObject resultJson = new JSONObject(results.getResultString());sn = resultJson.optString("sn");} catch (JSONException e) {e.printStackTrace();}mIatResults.put(sn, text);StringBuffer resultBuffer = new StringBuffer();for (String key : mIatResults.keySet()) {resultBuffer.append(mIatResults.get(key));}etContent.setText(resultBuffer.toString());etContent.setSelection(etContent.length());}@Overrideprotected void onDestroy() {super.onDestroy();if( null != mIat ){// 退出时释放连接mIat.cancel();mIat.destroy();}}}
activitymain.xml
<?xml version="1.0" encoding="utf-8"?><LinearLayout xmlns:android="/apk/res/android"android:id="@+id/activity_main"android:layout_width="match_parent"android:layout_height="match_parent"android:orientation="vertical"><EditTextandroid:id="@+id/et_content"android:layout_width="match_parent"android:layout_height="0dp"android:layout_weight="1"android:textSize="20sp"/><LinearLayoutandroid:layout_width="match_parent"android:layout_height="wrap_content"android:orientation="horizontal"><Buttonandroid:layout_width="wrap_content"android:layout_height="wrap_content"android:id="@+id/btn_start"android:textSize="20sp"android:text="start"/><Buttonandroid:layout_width="wrap_content"android:layout_height="wrap_content"android:id="@+id/btn_stop"android:textSize="20sp"android:text="stop"/><Buttonandroid:layout_width="wrap_content"android:layout_height="wrap_content"android:id="@+id/btn_cancel"android:textSize="20sp"android:text="cancel"/></LinearLayout></LinearLayout>
strings.xml
<resources><string name="app_name">VoiceRecognition</string><string name="app_id">58d9e1f5</string><string name="pref_key_iat_show">iat_show</string><string name="text_begin">请开始说话…</string></resources>
参考文档：/document/product/556/7677
/static/qc_doc/ed75039f47cdb9eea96169fbd287e910/7638.pdf
/doccenter/awd
/sdk/dispatcher
