$科大訊飛語音聽寫接口使用的封裝

　　在 科大訊飛開放平台——語音聽寫接口的使用 這篇文章里介紹了科大訊飛語音聽寫接口的簡單使用方法，但是在實際開發中發現僅僅那樣做在使用起來還是不方便，於是想到把語音聽寫接口的調用、Json數據解析、聽寫結果的處理等操作進行封裝，使用異步回調的方式進行調用，這樣在使用到語音聽寫的地方只需創建一個監聽接口並重寫語音識別返回結果的處理方法即可。梳理了一下步驟如下：

　　（一）前期准備工作（略，見科大訊飛開放平台——語音聽寫接口的使用一文）

　　注：將獲取到的AppId存到一個常量類里，后面便於管理：

public class GlobalConfig {
    // 科大訊飛語音SDK AppID
    public static final String IFLY_VOICE_SDK_APP_ID = "570657ad";
}

 

　　（二）創建用GSON解析Json數據的通用工具類GsonUtil，用於為解析語音聽寫服務器返回的Json格式數據做准備：

import java.util.ArrayList;
import java.util.List;

import com.google.gson.Gson;
import com.google.gson.JsonArray;
import com.google.gson.JsonElement;
import com.google.gson.JsonParser;

/*
 * 封裝的GSON解析工具類，提供泛型參數方法
 * 
 */
public class GsonUtil {
    // 將單條Json數據解析成相應的映射對象
    public static <T> T parseJsonWithGson(String jsonData, Class<T> type) {
        Gson gson = new Gson();
        T result = gson.fromJson(jsonData, type);
        return result;
    }

    // 將Json數組解析成相應的映射對象列表
    public static <T> List<T> parseJsonArrayWithGson(String jsonData,
            Class<T> type) {
        Gson gson = new Gson();
        List<T> result = new ArrayList<T>();

        // 下面這句因為泛型在編譯期類型會被擦除，從而導致如下錯誤：
        // java.lang.ClassCastException: com.google.gson.internal.LinkedTreeMap
        // cannot be cast to DictationResult
        // List<T> result = gson.fromJson(jsonData, new TypeToken<List<T>>() {
        // }.getType());

        // 正確寫法
        JsonArray array = new JsonParser().parse(jsonData).getAsJsonArray();
        for (final JsonElement elem : array) {
            result.add(new Gson().fromJson(elem, type));
        }

        return result;
    }
}

　　

　　（三）創建專門解析語音聽寫結果Json數據的工具類DictationJsonParseUtil，用於解析科大訊飛語音聽寫服務器返回的Json數據：

import java.util.List;

/**
 * 用於解析科大訊飛語音聽寫服務器返回的Json數據
 *
 * 語音識別結果Json數據格式：
 * {"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}]}]}
 */
public class DictationJsonParseUtil {

    // 解析服務器返回的語音聽寫結果Json格式數據的靜態方法，返回值為語音的字符串
    public static String parseJsonData(String jsonDataStr) {
        String speechStr = "";
        List<DictationResult> resultList = GsonUtil.parseJsonArrayWithGson(
                jsonDataStr, DictationResult.class);

        for (int i = 0; i < resultList.size() - 1; i++) { // 這里減1是因為最后有一組作為結尾的標點符號數據，要舍去
            speechStr += resultList.get(i).toString();
        }

        return speechStr;
    }
}

// 語音聽寫結果類
class DictationResult {
    private String sn;
    private String ls;
    private String bg;
    private String ed;

    private List<Words> ws;

    public static class Words {
        private String bg;
        private List<Cw> cw;

        public static class Cw {
            private String w;
            private String sc;

            public String getW() {
                return w;
            }

            public void setW(String w) {
                this.w = w;
            }

            public String getSc() {
                return sc;
            }

            public void setSc(String sc) {
                this.sc = sc;
            }

            @Override
            public String toString() {
                return w;
            }
        }

        public String getBg() {
            return bg;
        }

        public void setBg(String bg) {
            this.bg = bg;
        }

        public List<Cw> getCw() {
            return cw;
        }

        public void setCw(List<Cw> cw) {
            this.cw = cw;
        }

        @Override
        public String toString() {
            String result = "";
            for (Cw cwTmp : cw) {
                result += cwTmp.toString();
            }
            return result;
        }
    }

    public String getSn() {
        return sn;
    }

    public void setSn(String sn) {
        this.sn = sn;
    }

    public String getLs() {
        return ls;
    }

    public void setLs(String ls) {
        this.ls = ls;
    }

    public String getBg() {
        return bg;
    }

    public void setBg(String bg) {
        this.bg = bg;
    }

    public String getEd() {
        return ed;
    }

    public void setEd(String ed) {
        this.ed = ed;
    }

    public List<Words> getWs() {
        return ws;
    }

    public void setWs(List<Words> ws) {
        this.ws = ws;
    }

    @Override
    public String toString() {
        String result = "";
        for (Words wsTmp : ws) {
            result += wsTmp.toString();
        }
        return result;
    }
}

 

　　（四）創建語音聽寫結果監聽接口DictationListener，提供一個onDictationListener(String dictationResultStr)方法，調用方可以重寫該方法，對語音聽寫結果進行其他操作。

/**
 * 科大訊飛語音解析結果返回監聽接口
 *
 */
public interface DictationListener {
    public abstract void onDictationListener(String dictationResultStr);
}

 

　　（五）創建DictationUtil類，其showDictationDialog方法會彈出語音聽寫Dialog窗口，並對語音返回結果進行解析得到最終結果，最后用onDictationListener接口來將最終結果傳送給調用方。

import android.content.Context;

import com.easydo.constant.GlobalConfig;
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;

/**
 * 語音聽寫工具類，用於彈出語音聽寫Dialog進行聽寫
 *
 */

public class DictationUtil {
    private static final String DICTATION_APPID = GlobalConfig.IFLY_VOICE_SDK_APP_ID;

    private static SpeechRecognizer mIat;
    private static RecognizerDialog iatDialog;
    private static String dictationResultStr;
    private static String finalResult;

    public static void showDictationDialog(final Context context,
            final DictationListener listener) {
        // 初始化語音配置
        initConfig(context);

        // 開始聽寫
        iatDialog.setListener(new RecognizerDialogListener() {

            @Override
            public void onResult(RecognizerResult results, boolean isLast) {
                if (!isLast) {
                    dictationResultStr += results.getResultString() + ",";
                } else {
                    dictationResultStr += results.getResultString() + "]";

                    finalResult = DictationJsonParseUtil
                            .parseJsonData(dictationResultStr);

                    listener.onDictationListener(finalResult);
                }

            }

            @Override
            public void onError(SpeechError error) {
                error.getPlainDescription(true);
            }
        });

        // 開始聽寫
        iatDialog.show();
    }

    private static void initConfig(Context context) {
        dictationResultStr = "[";
        finalResult = "";

        // 語音配置對象初始化
        SpeechUtility.createUtility(context, SpeechConstant.APPID + "="
                + DICTATION_APPID);

        // 1.創建SpeechRecognizer對象，第2個參數：本地聽寫時傳InitListener
        mIat = SpeechRecognizer.createRecognizer(context, null);
        // 交互動畫
        iatDialog = new RecognizerDialog(context, null);

        // 2.設置聽寫參數，詳見《科大訊飛MSC API手冊(Android)》SpeechConstant類
        mIat.setParameter(SpeechConstant.DOMAIN, "iat"); // domain:域名
        mIat.setParameter(SpeechConstant.LANGUAGE, "zh_cn");
        mIat.setParameter(SpeechConstant.ACCENT, "mandarin"); // mandarin:普通話
    }
}

　　

　　（六）最后就是在需要語音聽寫的地方進行調用了，調用起來很簡單，只需調用DictationUtil類的靜態方法showDictationDialog，第一個參數傳入Context，第二個參數創建DictationListener匿名內部類，重寫其onDictationListener方法，在該方法中對語音聽寫最終結果進行處理即可（比如為EditText設置文本等）。

import com.easydo.util.DictationListener;
import com.easydo.util.DictationUtil;
import com.jiayongji.easydo.R;

import android.os.Bundle;
import android.view.View;
import android.view.View.OnClickListener;
import android.widget.EditText;
import android.widget.ImageButton;

public class CreateScheduleActivity extends BaseActivity implements
        OnClickListener {

    // 日程內容et
    private EditText createScheduleContentEt;
    // 日程內容語音聽寫ib
    private ImageButton createScheduleContentDictationIb;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_create_schedule);

        createScheduleContentEt = (EditText) findViewById(R.id.create_schedule_content_et);
        createScheduleContentDictationIb = (ImageButton) findViewById(R.id.create_schedule_content_dictation_ib);

        createScheduleContentDictationIb.setOnClickListener(this);
    }

    @Override
    public void onClick(View v) {
        switch (v.getId()) {
        case R.id.create_schedule_content_dictation_ib:
            DictationUtil.showDictationDialog(this, new DictationListener() {

                @Override
                public void onDictationListener(String dictationResultStr) {
                    createScheduleContentEt.setText(dictationResultStr);
                    createScheduleContentEt.requestFocus();
                    createScheduleContentEt.setSelection(dictationResultStr
                            .length());
                }
            });
            break;
        default:
            break;
        }
    }
}

 

（歡迎轉載！作者：jiayongji   分享請保留地址：http://www.cnblogs.com/jiayongji/p/5366171.html）