React Native 下的科大讯飞语音库,可以进行语音识别与语音合成
React Native 下的科大讯飞语音库,可以进行语音识别与语音合成
JavaScript 混合移动开发
共172Star
详细介绍
react-native-speech-iflytek 是一个 React Native 下的科大讯飞语音库,可以进行语音识别与语音合成。
Support
- React Native >= 0.47.0 from 0.2.0
- React Native >= 0.42.0 from 0.1.2
- Android
- iOS from 1.0.0
Install
yarn add react-native-speech-iflytek
react-native link
安装、链接后还须进行下面两步(以 Example
工程为例):
-
在 讯飞开放平台 下载组合服务 SDK (选择
语音听写
与在线语音合成
),分别下载 Android 与 iOS 平台 SDK。 -
替换 SDK 文件:
- 使用下载 Android SDK 的
Android_voice_xxxx_xxxxxxxx/libs
文件夹替换Example/node_modules/react-native-speech-iflytek/android/libs
文件夹; - 使用下载 iOS SDK 的
iOS_voice_xxxx_xxxxxxxx/libs
文件夹替换Example/node_modules/react-native-speech-iflytek/ios/libs
文件夹。
- 使用下载 Android SDK 的
-
iOS 平台还需手动添加部分依赖库:
- 在 XCode 中打开
Example/ios/YourProject.xcodeproj
; - 将讯飞框架文件
Example/node_modules/react-native-speech-iflytek/ios/libs/iflyMSC.framework
拖入 Project navigator 的Frameworks
下,注意选择Copy items if needed
; - 添加讯飞依赖的系统库(见:科大讯飞MSC开发指南-iOS-集成流程):
- CoreLocation.framework
- CoreTelephony.framework
- AVFoundation.framework
- AddressBook.framework
- Contacts.framework
- AudioToolbox.framework
- SystemConfiguration.framework
- QuartzCore.framework
- UIKit.framework
- Foundation.framework
- CoreGraphics.framework
- 在 XCode 中打开
4.android平台权限
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.RECORD_AUDIO" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
<!--读取网络信息状态 -->
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>
<!--获取当前wifi状态 -->
<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.WRITE_SETTINGS" />
Usage
(详见 Example)引入包:
import { Recognizer, Synthesizer, SpeechConstant } from "react-native-speech-iflytek";
语音识别:
Recognizer.init("57c7c5b0");
this.recognizerEventEmitter = new NativeEventEmitter(Recognizer);
this.recognizerEventEmitter.addListener('onRecognizerResult', this.onRecognizerResult);
Recognizer.start();
处理识别结果:
onRecognizerResult(e) {
if (!e.isLast) {
return;
}
this.setState({ text: e.result });
}
API
Recognizer
Methods
Recognizer.init(String AppId)
初始化语音识别Recognizer.start()
开始语音识别Recognizer.cancel()
取消语音识别Recognizer.isListening()
检测当前是否正在语音识别。返回Promise
,结果为bool
类型,表示当前是否正在语音识别Recognizer.stop()
如果正在语音识别,则结束语音识别Recognizer.setParameter(String parameter, String value)
语音识别设置,详见讯飞语音文档Recognizer.getParameter(String param)
获取语音识别设置,详见讯飞语音文档。返回Promise
,结果为String
类型,表示语音识别设置值
Events
-
onRecognizerResult(JSON result)
语音识别结果,在语音识别时会不断触发该事件,result
为JSON
类型,其值:text
:当次识别结果result
:当前识别结果,最常使用isLast
:是否是最后一次识别,调用Recognizer.stop()
后,isLast
值为true
,否则一直为false
duration
:当前识别时间长度
-
onRecognizerVolumeChanged(JSON result)
语音识别的音量大小,当识别的语音改变音量时会触发该事件,result
为JSON
类型,其值:volume
: 当前音量大小
-
onRecognizerError(JSON error)
语音识别出现错误,错误信息与讯飞文档保持一致,其值:errorCode
: 获取错误码,关于错误码请见官方文档 MSC错误码 :errorType
: (仅 iOS)获取错误码类型errorDesc
: (仅 iOS)获取错误描述errorDescription
: (仅 Android)获取错误描述,不包含错误码的描述信息plainDescription
: (仅 Android)获取错误描述,包含错误码的描述信息
Synthesizer
Methods
Synthesizer.init(String AppId)
初始化语音合成Synthesizer.start(String content)
开始语音合成Synthesizer.stop()
如果正在语音合成,则结束语音合成Synthesizer.isSpeaking()
检测当前是否正在语音合成。返回Promise
,结果为bool
类型,表示当前是否正在语音合成Synthesizer.pause()
如果正在语音合成,则暂停语音合成(对应 resume)Synthesizer.resume()
如果正在语音合成,则开始语音合成(对应 pause)Synthesizer.setParameter(String parameter, String value)
语音合成设置,详见讯飞语音文档Synthesizer.getParameter(String param)
获取语音合成设置,详见讯飞语音文档。返回Promise
,结果为String
类型,表示语音合成设置值
Events
onSynthesizerBufferCompletedEvent()
语音合成缓冲完成时触发该事件onSynthesizerSpeakCompletedEvent()
语音合成播放完成时触发该事件
SpeechConstant
本模块包含讯飞接口的所有常量,如设置发言人、发言速度等,详见讯飞文档,使用示例:
Synthesizer.setParameter(SpeechConstant.VOICE_NAME, "xiaoyu");
Maybe
- (Native Android) Android Studio 2.3.3 接入讯飞语音接口: http://www.jianshu.com/p/caf50402d31c
FAQ
- iOS 提示
iflytek.framework not found
? (见 issue 15)
- 解决方法一(建议):Xcode 没有找到讯飞库,在项目的
Building Settings
->Search Paths
->Framework Search Paths
中手动添加iflytek.framework
的目录$(SRCROOT)/../node_modules/react-native-speech-iflytek/ios/libs
。 - 解决方法二:将
iflytek.framework
拖入时注意选择Copy items if needed
。如忘记选择,最好的方式是在工程中删除讯飞框架,将讯飞框架移至其他文件夹,并重新拖入工程,选择Copy items if needed
。(Xcode 的缓存会记住上次选择,若第一次没有Copy items if needed
,在同一位置下重新拖入不会再次出现选择框。)
react-native [command]
命令失效?
同时使用 yarn 和 npm 时可能会出现这个问题,建议再敲一次yarn
命令解决依赖。
Contribute
期待提出有关建议,欢迎做出贡献,感谢 star。
Github: https://github.com/zphhhhh/react-native-speech-iflytek