更新记录

1.1.7（2025-09-03）

修改使用配置

1.1.6（2025-09-02）

完善CALLBACK_EVENT_ASR_AUDIO回调使用文档

1.1.5（2025-09-02）

增加CALLBACK_EVENT_ASR_AUDIO回调事件

平台兼容性

云端兼容性

uni-app(4.72)

uni-app x(4.72)

fy-speech-recog

开发文档

UTS 语法 UTS API插件 UTS 组件插件 Hello UTS

注意: uniapp x不支持 【试用插件】，试用插件建议用uniapp项目。uniapp x项目仅支持源码版，原因试用、普通授权版会对源码加密导致插件追踪不到对应方法， 并且uts似乎不支持装饰器，后续兼容后会更新

插件对外暴露FyPermission和FySpeechRecog两个类

1.FyPermission使用说明

FyPermission授权的事件说明

RequestPermissionOptions 说明

uniapp例子

import { FyPermission } from '@/uni_modules/fy-speech-recog';
const permis = new FyPermission();
permis.requestPermission({
    success: function (res) {
        console.log(res);
    },
    fail: function(res){
        console.log(res);
    }
})

uniapp x例子

import { FyPermission } from '@/uni_modules/fy-speech-recog';
const permis = new FyPermission();
permis.requestPermission({
    success: function (res: string) {
        console.log(res);
    },
    fail: function(res: string){
        console.log(res);
    }
})

2.FySpeechRecog使用说明

构造函数OBJECT 参数说明

FySpeechRecog的事件说明

WakeUpOptions参数说明

WakeUpCallbackOptions参数说明

RecogOptions参数说明

RecogCallbackOptions参数说明

uniapp综合案例

<template>
    <view class="content">
        <view class="">
            <button @click="handleStartWU">语音唤醒开始</button>
            <button @click="handleStopWU">语音唤醒结束</button>
            <view style="width: 750rpx;height: 2px;background-color: #000000;margin-top: 30px;"></view>
            <button @click="handleStart">语音识别开始</button>
            <button @click="handleStop">语音识别结束</button>
        </view>
    </view>
</template>

<script>
import { FySpeechRecog, FyPermission } from '@/uni_modules/fy-speech-recog';
let recogHandle = null;
export default {
    data() {
        return {
            title: 'Hello'
        }
    },
    onReady() {
        const permis = new FyPermission();
        permis.requestPermission({
            success: function () {
                recogHandle = new FySpeechRecog({
                    APP_ID: "百度开放平台拿到的APP_ID",
                    APP_KEY: "百度开放平台拿到的APP_KEY",
                    SECRET: "百度开放平台拿到的SECRET",
                });
            }
        })
    },
    methods: {
        // 开启语音唤醒
        handleStartWU() {
            recogHandle && recogHandle.startWakeUp({
                    WP_WORDS_FILE: plus.io.convertLocalFileSystemURL("/static/WakeUp.bin")
                }, {
                success: function(res) {
                    console.log(res)
                }
            });
        },
        // 停止语音唤醒
        handleStopWU() {
            recogHandle && recogHandle.stopWakeUp();
        },
        // 开启语音识别
        handleStart() {
            recogHandle && recogHandle.startRecognizer({ AUDIO_MILLS: 0, ACCEPT_AUDIO_DATA: true }, {
                listener: function(res) {
                    try {
                        const recogRes = JSON.parse(res);
                        console.log(recogRes);
                        if (recogRes.resultWold && [6, 11061, 7].includes(recogRes.status)) { // 临时识别、最终识别、长语音识别
                            console.log(recogRes.resultWold);
                        }
                    } catch(err) {
                        console.log(err);
                    }
                },
                audioCallback: (audioData, offset, length) => {
                    console.log('收到音频数据，长度:', length);
                    // 处理音频数据，audioData是PCM格式，16bits 16000采样率
                    // 可以保存到文件或进行其他处理
                }
            })
        },
        // 停止语音识别
        handleStop() {
            recogHandle && recogHandle.stopRecognizer();
        }
    }
}
</script>

uniapp x综合案例

<template>
    <view class="content">
        <button @click="handleStartWU">语音唤醒开始</button>
        <button @click="handleStopWU">语音唤醒结束</button>
        <view style="width: 750rpx;height: 2px;background-color: #000000;margin-top: 30px;"></view>
        <button @click="handleStart">语音识别开始</button>
        <button @click="handleStop">语音识别结束</button>
    </view>
</template>

<script>
    import { FySpeechRecog, FyPermission } from '@/uni_modules/fy-speech-recog';
    let recogHandle : FySpeechRecog | null = null;
    export default {
        data() {
            return {
                title: 'Hello'
            }
        },
        onReady() {
            const permis = new FyPermission();
            permis.requestPermission({
                success: function () {
                    recogHandle = new FySpeechRecog({
                        APP_ID: "百度开放平台拿到的APP_ID",
                        APP_KEY: "百度开放平台拿到的APP_KEY",
                        SECRET: "百度开放平台拿到的SECRET",
                    });
                }
            })
        },
        methods: {
            // 开启语音唤醒
            handleStartWU() {
                recogHandle!.startWakeUp({
                    WP_WORDS_FILE: 'assets:///WakeUp.bin', // uniapp x项目固定格式，uniapp x项目将下载WakeUp.bin文件后可以放在uni_modules/fy-speech-recog/utssdk/app-android/assets文件夹中
                }, {
                    success: function (res: string) {
                        console.log(res)
                    }
                });
            },
            // 停止语音唤醒
            handleStopWU() {
                recogHandle!.stopWakeUp();
            },
            // 开启语音识别
            handleStart() {
                recogHandle!.startRecognizer({ AUDIO_MILLS: 0, ACCEPT_AUDIO_DATA: true }, {
                    listener: function (res : string) {
                        try {
                            const recogRes = JSON.parse(res) as UTSJSONObject;
                            console.log(recogRes);
                            const status = recogRes.status as number;
                            const allowStatus = [6, 11061, 7];
                            const resultWold = recogRes.resultWold as string;
                            if (resultWold.length > 0 && allowStatus.includes(status)) { // 临时识别、最终识别、长语音识别
                                console.log(recogRes.resultWold);
                            }
                        } catch (err) {
                            console.log(err);
                        }
                    },
                    audioCallback: (audioData: ByteArray, offset: Int, length: Int) => {
                        console.log('收到音频数据，长度:', length);
                        // 处理音频数据，audioData是PCM格式，16bits 16000采样率
                        // 可以保存到文件或进行其他处理
                    }
                })
            },
            // 停止语音识别
            handleStop() {
                recogHandle!.stopRecognizer();
            }
        }
    }
</script>

重点注意事项

1. 导入插件后记得一定一定要重新打包自定义基座，并配置在百度AI开放平台填写的android包名；
2. 语音唤醒可以使用个人百度AI开放平台账号，但是语音识别个人账号免费额度是不行的，可以使用企业账号或者自行开通个人账号API权限。
3. 语音唤醒、语音识别和手机系统提供的智能助手功能不一样，需要开启录音等权限，需要先使用permis.requestPermission开启权限后才能使用语音唤醒和语音识别，流程一定不能出错。
4. WakeUpOptions、RecogOptions文档提供的参数不一定很全很正确，可以自行前往百度官方文档查看。必填项都是正确和常用的。
5. 语音唤醒参数 WP_WORDS_FILE 放入WakeUp.bin文件后一定要重新制作自定义基座，可参考uniapp、uniapp x项目案例WakeUp.bin该如何放置。
6. 如报11002错误请检查制作的自定义基座的appid是否和百度应用创建的Android包名是否一致！！！
7. 如报11004 通常是没正确找到WakeUp.bin文件，请按照文档找到uniapp、uniapp x项目案例WakeUp.bin该如何放置。
8. 如有其它错误代码，请自行前往百度官方文档对照

语音智能助手

1. 需要配合fy-tts语音播报、fy-segment-words文本分词可做简单的语音助手。
2. 如需语音控制app打开关闭可配合fy-getinstall即可打开其他应用程序，如微信、qq等；
3. 如需智能回答还可接入uni-ai。注：收费功能

路线图

1. 目前没有规划ios sdk集成，但是后续会找时间继续集成进来。