@mingto/xunfei-lat 2.2.5

package/dist/process/index.d.ts

@@ -0,0 +1,5 @@
+import { default as LatRequest } from './lat-request';
+import { default as ProcessorAudio } from './processor-audio';
+import { default as RecordActuator } from './record-actuator';
+import { default as SplitAudio } from './split-audio';
+export { LatRequest, ProcessorAudio, RecordActuator, SplitAudio, };

package/dist/process/lat-request.d.ts

@@ -0,0 +1,23 @@
+import { ParallelTaskExecuteContext, ParallelHandler } from '../handler';
+import { BusinessParams, LatResponseResult, SectionDelayParams, SystemConfig } from '../types';
+declare class LatRequest extends ParallelHandler<Array<number>, string> {
+    private systemConfig;
+    private businessParams;
+    private sectionDelayParams;
+    private webSocketInstance;
+    private resultText;
+    private lastResultText;
+    private sectionDelayInstance;
+    initProperty(systemConfig: Required<SystemConfig>, businessParams: Required<BusinessParams>, sectionDelayParams: Required<SectionDelayParams>): void;
+    executePreCheck(): boolean;
+    protected onActive(): void;
+    execute(context: ParallelTaskExecuteContext<Array<number>, never>): void;
+    protected onFinish(): void;
+    private generateRequestUrl;
+    buildResponseText(data: LatResponseResult['data']): {
+        resultText: string;
+        lastResultText: string;
+    };
+    private generateRequestParams;
+}
+export default LatRequest;

package/dist/process/processor-audio.d.ts

@@ -0,0 +1,8 @@
+import { ParallelTaskExecuteContext, ParallelHandler } from '../handler';
+declare class ProcessorAudio extends ParallelHandler<Float32Array, Array<number>> {
+    private processorWorkerInstance;
+    protected onActive(): void;
+    execute(context: ParallelTaskExecuteContext<Float32Array, Array<number>>): void;
+    protected onFinish(): void;
+}
+export default ProcessorAudio;

package/dist/process/record-actuator.d.ts

@@ -0,0 +1,11 @@
+import { SerialTaskExecuteContext, SerialHandler } from '../handler';
+declare class RecordActuator extends SerialHandler<Float32Array[] | null, Float32Array> {
+    private audioContext;
+    private processor;
+    private source;
+    protected onActive(): void;
+    execute(context: SerialTaskExecuteContext<Float32Array[] | null, Float32Array>): void;
+    protected onCompleted(): void;
+    protected onFinish(): void;
+}
+export default RecordActuator;

package/dist/process/split-audio.d.ts

@@ -0,0 +1,10 @@
+import { SerialTaskExecuteContext, SerialHandler } from '../handler';
+declare class SplitAudio extends SerialHandler<Array<number>, Array<number>> {
+    static readonly SPLIT_SIZE = 1280;
+    static readonly INTERVAL_TIME = 25;
+    private lastRemainingAudioData;
+    private exportTimer;
+    execute(context: SerialTaskExecuteContext<Array<number>, Array<number>>): void;
+    protected onFinish(): void;
+}
+export default SplitAudio;

package/dist/types/index.d.ts

@@ -0,0 +1,339 @@
+/**
+ * 识别接口的业务参数
+ */
+interface BusinessParams {
+    /**
+     * 语种
+     * - 'zh_cn': 中文（支持简单的英文识别）
+     * - 'en_us': 英文
+     * - 其他小语种参数值需在控制台添加试用或购买后显示
+     */
+    language: 'zh_cn' | 'en_us';
+    /**
+     * 应用领域
+     * - 'iat': 日常用语
+     * - 'medical': 医疗
+     * - 'gov-seat-assistant': 政务坐席助手
+     * - 'seat-assistant': 金融坐席助手
+     * - 'gov-ansys': 政务语音分析
+     * - 'gov-nav': 政务语音导航
+     * - 'fin-nav': 金融语音导航
+     * - 'fin-ansys': 金融语音分析
+     */
+    domain: 'iat' | 'medical' | 'gov-seat-assistant' | 'seat-assistant' | 'gov-ansys' | 'gov-nav' | 'fin-nav' | 'fin-ansys';
+    /**
+     * 方言，当前仅在language为中文时，支持方言选择。
+     * - 'mandarin': 中文普通话、其他语种
+     * - 其他方言参数值需在控制台添加试用或购买后显示
+     */
+    accent: 'mandarin';
+    /**
+     * 用于设置后端点检测的静默时间，单位是毫秒。
+     * 默认2000（小语种除外，小语种不设置该参数默认为未开启VAD）。
+     */
+    vad_eos?: number;
+    /**
+     * 动态修正（仅中文普通话支持）
+     * - 'wpgs': 开启流式结果返回功能
+     */
+    dwa?: 'wpgs';
+    /**
+     * 领域个性化参数（仅中文支持）
+     * - 'game': 游戏
+     * - 'health': 健康
+     * - 'shopping': 购物
+     * - 'trip': 旅行
+     */
+    pd?: 'game' | 'health' | 'shopping' | 'trip';
+    /**
+     * 是否开启标点符号添加（仅中文支持）
+     * - 1: 开启（默认值）
+     * - 0: 关闭
+     */
+    ptt?: 0 | 1;
+    /**
+     * 字体（仅中文支持）
+     * - 'zh-cn': 简体中文（默认值）
+     * - 'zh-hk': 繁体香港
+     */
+    rlang?: 'zh-cn' | 'zh-hk';
+    /**
+     * 返回子句结果对应的起始和结束的端点帧偏移值。
+     * - 0: 关闭（默认值）
+     * - 1: 开启
+     */
+    vinfo?: 0 | 1;
+    /**
+     * 数字格式规则为阿拉伯数字格式（中文普通话和日语支持）
+     * - 0: 关闭
+     * - 1: 开启（默认值）
+     */
+    nunum?: 0 | 1;
+    /**
+     * speex音频帧长，仅在speex音频时使用
+     * - 1: 当speex编码为标准开源speex编码时必须指定
+     * - 2: 当speex编码为讯飞定制speex编码时不要设置
+     */
+    speex_size?: number;
+    /**
+     * 获取在发音相似时的句子多侯选结果。
+     * 取值范围[1,5]，设置多候选会影响性能，响应时间延迟200ms左右。
+     */
+    nbest?: number;
+    /**
+     * 获取在发音相似时的词语多侯选结果。
+     * 取值范围[1,5]，设置多候选会影响性能，响应时间延迟200ms左右。
+     */
+    wbest?: number;
+}
+/**
+ * 识别接口的公共参数
+ */
+interface LatRequesCommonParams {
+    /**
+     * 在平台申请的APPID信息
+     */
+    app_id: string;
+}
+/**
+ *  识别接口的音频数据的状态
+ */
+declare enum LatRequesDataParamsStatusEnum {
+    /**
+     * 音频数据开始，开始标识
+     */
+    START = 0,
+    /**
+     * 音频数据中，中间数据
+     */
+    CONTINUE = 1,
+    /**
+     * 音频数据结束，结束标识
+     */
+    END = 2
+}
+declare enum LatRequestStatusEnum {
+    /**
+     * 音频数据开始，开始标识
+     */
+    START = 0,
+    /**
+     * 音频数据中，中间数据
+     */
+    CONTINUE = 1,
+    /**
+     * 音频数据结束，结束标识
+     */
+    END = 2
+}
+/**
+ * 识别接口的数据流参数
+ */
+interface LatRequesDataParams {
+    /**
+     * 音频数据的位置
+     */
+    status: LatRequesDataParamsStatusEnum;
+    /**
+     * 音频的采样率支持16k和8k
+     * - '16k音频': 'audio/L16;rate=16000'
+     * - '8k音频': 'audio/L16;rate=8000'
+     */
+    format: 'audio/L16;rate=16000' | 'audio/L16;rate=8000';
+    /**
+     * 音频数据格式
+     * - 'raw': 原生音频（支持单声道的pcm）
+     * - 'speex': speex压缩后的音频（8k）
+     * - 'speex-wb': speex压缩后的音频（16k）
+     * - 'lame': mp3格式（仅中文普通话和英文支持，方言及小语种暂不支持）
+     */
+    encoding: 'raw' | 'speex' | 'speex-wb' | 'lame';
+    /**
+     * 音频内容，采用base64编码
+     */
+    audio: string;
+}
+/**
+ * 识别接口的参数
+ */
+interface LatRequesParams {
+    common: LatRequesCommonParams;
+    business: BusinessParams;
+    data: LatRequesDataParams;
+}
+/**
+ * 识别结果
+ */
+interface LatResponseResult {
+    /**
+     * API调用的状态码
+     */
+    code: number;
+    /**
+     * API调用的返回消息
+     */
+    message: string;
+    /**
+     * 会话ID
+     */
+    sid: string;
+    /**
+     * API调用的数据部分
+     */
+    data: {
+        /**
+         * 识别结果
+         */
+        result: {
+            /**
+             * 识别结果的开始时间（单位：帧，1帧=10ms）
+             */
+            bg: number;
+            /**
+             * 识别结果的结束时间（单位：帧，1帧=10ms）
+             */
+            ed: number;
+            /**
+             * 是否是最后一个结果
+             */
+            ls: boolean;
+            /**
+             * 结果序列号
+             */
+            sn: number;
+            /**
+             * 动态修正字段，'apd'表示追加，'rpl'表示替换
+             */
+            pgs?: 'apd' | 'rpl';
+            /**
+             * 替换范围，表示需要替换的识别结果的序号范围
+             */
+            rg?: number[];
+            /**
+             * 端点帧偏移值信息
+             */
+            vad?: {
+                /**
+                 * 端点帧偏移值结果数组
+                 */
+                ws: Array<{
+                    /**
+                     * 起始的端点帧偏移值（单位：帧，1帧=10ms）
+                     */
+                    bg: number;
+                    /**
+                     * 结束的端点帧偏移值（单位：帧，1帧=10ms）
+                     */
+                    ed: number;
+                    /**
+                     * 无需关心的值
+                     */
+                    eg: number;
+                }>;
+            };
+            /**
+             * 识别结果数组
+             */
+            ws: Array<{
+                /**
+                 * 识别结果的开始时间（单位：帧，1帧=10ms）
+                 */
+                bg: number;
+                /**
+                 * 识别结果的候选词数组
+                 */
+                cw: Array<{
+                    /**
+                     * 候选词的得分
+                     */
+                    sc: number;
+                    /**
+                     * 识别出的词
+                     */
+                    w: string;
+                }>;
+            }>;
+        };
+        /**
+         * 识别结果是否结束标识：
+         * 0：识别的第一块结果
+         * 1：识别中间结果
+         * 2：识别最后一块结果
+         */
+        status: 0 | 1 | 2;
+    };
+}
+/**
+ * 平台系统配置
+ */
+interface SystemConfig {
+    /**
+     * 在平台申请的密钥信息
+     */
+    readonly API_SECRET: string;
+    /**
+     * 在平台申请的APPID信息
+     */
+    readonly APPID: string;
+    /**
+     *  在平台申请的API_KEY信息
+     */
+    readonly API_KEY: string;
+}
+declare enum SystemStatus {
+    /**
+     * 空闲状态
+     */
+    OFFLINE = "offline",
+    /**
+     * 执行中
+     */
+    EXECUTE = "execute"
+}
+/**
+ * 节流参数
+ */
+interface SectionDelayParams {
+    /**
+     * 是否自动控制结束
+     */
+    readonly autoControl: boolean;
+    /**
+     * 第一次延迟时间
+     */
+    readonly initialDelay?: number;
+    /**
+     * 后续延迟时间
+     */
+    readonly subsequentDelay?: number;
+}
+/**
+ * 对外暴露的事件名称
+ */
+type PublicCustomEventName = 'appFinish' | 'appResultText' | 'appResponseText';
+/**
+ * 内部使用的事件名称
+ */
+type PrivateCustomEventName = '_recordActuatorFinish'
+/**
+ * 音频数据转换器
+ */
+ | '_processorAudioFinish'
+/**
+ *  音频数据切割器
+ */
+ | '_splitAudioFinish'
+/**
+ * 发送请求
+ */
+ | '_latRequestFinish'
+/**
+ * 响应文本
+ */
+ | '_appResponseText' | '_appResultText'
+/**
+ * 整个应用
+ */
+ | '_appFinish';
+export type { BusinessParams, LatRequesDataParams, LatRequesParams, LatResponseResult, PrivateCustomEventName, PublicCustomEventName, SectionDelayParams, SystemConfig, };
+export { LatRequesDataParamsStatusEnum, LatRequestStatusEnum, SystemStatus };

package/dist/utils/encode.d.ts

@@ -0,0 +1,2 @@
+declare function toBase64(buffer: Array<number>): string;
+export { toBase64 };

package/dist/utils/event-bus.d.ts

@@ -0,0 +1,10 @@
+interface EventCallback {
+    (...args: any[]): any;
+}
+declare class EventBus<E = any> {
+    private listeners;
+    on(eventName: E, callback: EventCallback): void;
+    emit<T = any>(eventName: E, data?: T): void;
+}
+declare function createEventBus<E>(): EventBus<E>;
+export { createEventBus };

package/dist/utils/index.d.ts

@@ -0,0 +1,3 @@
+export * from './encode';
+export * from './event-bus';
+export * from './section-delay';

package/dist/utils/section-delay.d.ts

@@ -0,0 +1,69 @@
+/**
+ * 防抖类，用于延迟执行回调函数
+ */
+interface DebounceConfig {
+    /**
+     * 初始延迟时间（毫秒）。
+     * 这是在第一次调用时使用的延迟时间
+     */
+    initialDelay: number;
+    /**
+     * 后续调用的延迟时间（毫秒）
+     * 这是在连续调用时使用的延迟时间
+     */
+    subsequentDelay: number;
+    /**
+     * 回调函数。
+     * 当延迟时间过后，此函数将被调用，并传入相应的数据
+     * @param data - 传递给回调的数据
+     */
+    callback: (data: string) => void;
+}
+declare class SectionDelay {
+    /**
+     * 存储定时器的 ID，用于取消定时器
+     * 如果没有设置定时器，则为 null
+     */
+    private timer;
+    /**
+     * 存储防抖功能的配置。
+     * 包含初始延迟、后续延迟和回调函数
+     */
+    private config;
+    /**
+     * 上一次处理的数据
+     */
+    private lastData;
+    /**
+     * 类构造器，接受防抖功能的配置。
+     * @param config - 包含初始延迟、后续延迟和回调函数的配置对象。
+     */
+    constructor(config: DebounceConfig);
+    /**
+     * 防抖方法，用于延迟执行回调函数
+     * @param {string} data - 传递给回调函数的数据
+     */
+    debounce(data: string): void;
+    /**
+     * 设置定时器
+     */
+    private scheduleNextTick;
+    /**
+     * 立即执行方法，取消挂起的定时器并立即执行回调
+     */
+    immediateDebounce(): void;
+    /**
+     * 执行方法，调用存储的回调函数
+     * 如果存在挂起的回调，则执行它
+     */
+    private execute;
+    /**
+     * 取消定时器方法，停止尚未执行的定时器
+     */
+    private cancelTimer;
+    /**
+     * 重置方法，重置所有挂起的状态
+     */
+    private reset;
+}
+export { SectionDelay, };

package/dist/worker/index.d.ts

@@ -0,0 +1 @@
+export * from './types';

package/dist/worker/processor.worker.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/worker/types/index.d.ts

@@ -0,0 +1,33 @@
+/**
+ * 发送消息给worker
+ */
+interface SendWorkerMessage<T = any> {
+    readonly type: 'send';
+    readonly data?: T;
+}
+/**
+ * 接收来自worker的消息
+ */
+interface ReplyWorkerMessage<T = any> {
+    readonly type: 'success';
+    readonly data: T;
+}
+/**
+ *  转码worker发送的数据
+ */
+interface ProcessorWorkerSendWorkerData {
+    uuid: string;
+    original: Float32Array;
+}
+/**
+ * 转码worker发送的消息
+ */
+type ProcessorWorkerSendWorkerMessage = SendWorkerMessage<ProcessorWorkerSendWorkerData>;
+/**
+ * 转码worker接收的消息
+ */
+type ProcessorWorkerReplyWorkerMessage = ReplyWorkerMessage<{
+    audioData: Array<number>;
+    uuid: string;
+}>;
+export type { ProcessorWorkerReplyWorkerMessage, ProcessorWorkerSendWorkerData, ProcessorWorkerSendWorkerMessage, ReplyWorkerMessage, SendWorkerMessage, };

package/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "@mingto/xunfei-lat",
+  "type": "module",
+  "version": "2.2.5",
+  "description": "讯飞LAT 语音转文本",
+  "author": "hcc",
+  "license": "ISC",
+  "keywords": [
+    "LAT",
+    "语音转文本"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "vite build"
+  },
+  "dependencies": {
+    "@types/crypto-js": "^4.2.2",
+    "crypto-js": "^4.1.1"
+  }
+}