更新记录

1.0.4(2023-12-20)

增加stop停止语音方法。目前云打包和本地打包都已经测试通过。大家放心使用。

1.0.3(2023-12-04)

更新package.json配置文件type类型错误。 目前云打包未测试通过,本地引入插件测试通过。请使用这下载包后放在本地nativeplugins\中,通过本地插件的方式引入使用。

1.0.2(2023-11-24)

更新依赖,打包zip中增加libs

查看更多

平台兼容性

Android Android CPU类型 iOS
适用版本区间:7.0 - 12.0 armeabi-v7a:支持,arm64-v8a:支持,x86:支持 ×

原生插件通用使用流程:

  1. 购买插件,选择该插件绑定的项目。
  2. 在HBuilderX里找到项目,在manifest的app原生插件配置中勾选模块,如需要填写参数则参考插件作者的文档添加。
  3. 根据插件作者的提供的文档开发代码,在代码中引用插件,调用插件功能。
  4. 打包自定义基座,选择插件,得到自定义基座,然后运行时选择自定义基座,进行log输出测试。
  5. 开发完毕后正式云打包

付费原生插件目前不支持离线打包。
Android 离线打包原生插件另见文档 https://nativesupport.dcloud.net.cn/NativePlugin/offline_package/android
iOS 离线打包原生插件另见文档 https://nativesupport.dcloud.net.cn/NativePlugin/offline_package/ios

注意事项:使用HBuilderX2.7.14以下版本,如果同一插件且同一appid下购买并绑定了多个包名,提交云打包界面提示包名绑定不一致时,需要在HBuilderX项目中manifest.json->“App原生插件配置”->”云端插件“列表中删除该插件重新选择


安卓TTS文字转语音播报

1、功能说明

安卓TTS文字转语音播报是一个Android原生接口,通过获取和设置Android底层的TTS引擎,实现文字转语音播报的功能。

2、依赖权限说明

<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.MODIFY_AUDIO_SETTINGS" />

3、使用说明

注意:先要调用init初始化接口后才能使用其他接口,如获取引擎列表等。第一次调用init接口时可以传空字符串(''),获取到引擎列表后可以再调用setTtsEngine更改为其他语音引擎。你可以自己用LocalStorage来存储当前已经设置的语音引擎,然后每次进应用后就可以用自己本地存储的值来当init初始化的参数,以达到设置引擎的目的。

在JS中应用原生组件:
// #ifdef APP-PLUS
const TTSSpeaker = uni.requireNativePlugin('AiDrive-TTSSpeaker');
// #endif

初始化语音引擎:
TTSSpeaker.init('');

TTSSpeaker.init('com.iflytek.speechsuite');

播报语音:
TTSSpeaker.speak(this.voiceMsgTxt, 1);

4、全量原生接口说明

/**
 * 是否可用
 * @return boolean
 */

boolean available()

/**
 * 初始化TTS引擎
 * @param packageName TTS引擎的packageName,如:com.iflytek.speechsuite。如果packageName为空字符串(“”),则使用系统默认语音引擎
 */

void init(String packageName)

/**
 * 设置语音引擎
 * @param packageName TTS引擎的packageName,如:com.iflytek.speechsuite
 * @param callback 前端JS回调函数
 */

void setTtsEngine(String packageName, UniJSCallback callback)

/**
 * 将文字转为语音播报
 * @param words 要转换的文字
 * @param model 播放模式:0-丢弃之前的播报任务,立即播报本次内容 1-播放完之前的语音任务后才播报本次内容
 * @param taskId 转换任务id,可以为空
 */

void speak(String words, Integer model, String taskId)

/**
 * 设置语速
 * @param speed 速度值,1.0为正常语速,小于1慢于正常(如0.5为正常语速的一半),大于1快于正常(如2.0为正常语速的二倍)
 * @param callback JS回调函数
 */

void setVoiceSpeed(Float speed, UniJSCallback callback)

/**
 * 设置音调
 * @param speed 速度值,1.0为正常音调
 * @param callback JS回调函数
 */

void setVoicePitch(Float speed, UniJSCallback callback)

/**
 * 获取引擎列表
 * @return {code:0, data:[{appName:'讯飞语音引擎', packageName: 'com.iflytek.speechsuite'}]}
 */

JSONObject getEngines()

/**
 * 获取系统默认的引擎
 * @return 系统默认语音引擎的packageName
 */

String getDefaultEngine()

/**
 * 停止语音播报(并清除所有队列内容)
 */

void stop()

隐私、权限声明

1. 本插件需要申请的系统权限列表:

<uses-permission android:name="android.permission.INTERNET" /> <uses-permission android:name="android.permission.MODIFY_AUDIO_SETTINGS" />

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明:

插件不采集任何数据

3. 本插件是否包含广告,如包含需详细说明广告表达方式、展示频率:

使用中有什么不明白的地方,就向插件作者提问吧~ 我要提问