cordova-plugin-IFlyspeech

科大訊飛的語音聽說讀寫的cordova外掛

最近在做一個hybrid webapp的時候需要用到語音識別的功能，網上找到科大訊飛的語音cordova外掛，因為還沒開始使用這個外掛，先總結一下在配置科大訊飛當前cordova版本過程中，碰到的問題。

網上外掛配置的教程很多，也綜合下自己的總結：

1. 外掛安裝命令：

cordova plugin add https://github.com/Edc-zhang/cordova-plugin-IFlyspeech

(注意：建議不要使用上面的命令安裝外掛，因為需要手動去改外掛裡面的appid和sdk包， 所以先手動下載zip包到本地，需要修改一些配置檔案，新增科大訊飛的appid)

2. 登入科大訊飛開放平臺：
要使用科大訊飛的cordova外掛，需要：

1、在科大訊飛開放平臺官網：http://www.xfyun.cn/ 註冊帳號登入，進入控制檯，建立新應用（注意ios、android是需要分別建立應用的，也就是分別有一個對應的appid，我這裡只是建立了一個android的應用，要在iOS中使用需要再建立一個iOS的應用）

2、新增所需要的新服務，我這裡是語音聽寫服務。

未經過稽核情況下， 每個appid每天有500次識別的限額，建議提交app給訊飛稽核，稽核通過後每天有20000次的限額，稽核基本都會通過。

3、完成以上操作後，下載ios、android不同版本的sdk到本地。

一、解壓之前在github上面下載的zip包，分別找到

ios目錄：cordova-plugin-IFlyspeech-master/src/ios
android目錄：cordova-plugin-IFlyspeech-master/src/android/libs
然後將訊飛上面下載的sdk ios路徑：lib/iflyMSC.framework
android路徑：libs分別替換到github外掛解壓的資料夾裡面

二、替換外掛資料夾裡面的appid

1、Android：修改
cordova-plugin-IFlyspeech-master/plugin.xml文 件內容，
搜尋【android:name=”IFLYTEK_APPKEY”】，
將對應的android:value=”改為申請的android版本的appid”

2、Android：修改
cordova-plugin-IFlyspeech-master/src/android/res/values/strings.xml檔案內容
搜尋【app_id】將對應的值改為申請的android版本的appid

3、ios：修改
cordova-plugin-IFlyspeech-master/src/ios/CDVSpeech.m檔案內容
搜尋【#define SPEECH_APP_ID】，將對應的值改為申請的ios版本的appid

完成後再執行cordova新增外掛命令即可： cordova plugin add
外掛（cordova-plugin-IFlyspeech-master）本地路徑

(注意：這裡新增本地外掛時可能會出錯，下面列舉下我新增本地外掛時碰到的問題及解決方法：)

新增本地外掛時可能出現的錯誤：
1. 新增cordova plugin add (外掛路徑的時候)，出現：

Error: Invalid package.json (XXX外掛的路徑) needs a valid package.json.

這裡的意思是說，外掛目錄裡面缺少一個package.json檔案。
看了網上建立自定義外掛的方法，可以建立package.json 檔案

一、安裝plumam

npm isntall -g plugman 

二、安裝完之後，就可以建立plugin

plugman create --name  --plugin_id  --plugin_version  [--path ] [--variable NAME=VALUE]

引數說明:

pluginName: 外掛名稱，eg：toast

pluginID: 外掛id, eg: org.my.toast

version: 版本號, eg: 0.0.1

variable NAME=VALUE: 擴充套件引數，如說明或者作者

eg:

建立外掛

plugman create –name helloPlugin –plugin_id helloPlugin
–plugin_version 0.0.1

此命令會在當前目錄建立一個helloPlugin外掛

進入外掛目錄

cd helloPlugin

plugin.xml

增加Android平臺plugman platform add  --platform_name android

plugin.xml

增加iOS平臺plugman platform add --platform_name ios

在有plugin.xml的目錄裡面，命令建立package.json檔案
plugman createpackage.json
(然而這裡建立的packa.json檔案並沒有解決報錯問題)

三、當你的外掛開發完成之後，新增到專案中

只需向平常新增外掛的時候一樣在控制檯跳轉到你的專案目錄中，再執行如下命令：（add 後面為外掛所在目錄）

cordova plugin add （外掛所在的目錄）

四、其他命令

刪除外掛：

cordova plugin remove XXXXX(你的plugin_id)。

______________________________________________________________________________________

最後還是在Google找到了解決方案，出現 Error: Invalid package.json (XXX外掛的路徑) needs a valid package.json.的原因是當前cordova的版本過高，是cordova7.0版本，但是該外掛需要的cordova版本是cordova6.0版本，所有需要給cordova版本降級。

npm install -g cordova@6

降級後重新新增android/iOS platform ,以及指定對應的安卓版本[email protected]

cordova platform rm android
cordova platform add [email protected]6.1.2

重新新增本地的外掛
在專案目錄下：

cordova plugin add (本地外掛的目錄)

成功新增和安裝上外掛

現在可以開始呼叫外掛進行語音識別：

//引數1: 成功回撥方法
//引數2:失敗回撥方法（ios沒有失敗回撥方法）
//引數3: 是否顯示對話方塊,預設true
//引數4:是否生成標點符號 ,預設true
xunfeiListenSpeaking.startListen(function(data){
//data即是返回的文字
},null,true,true);