import * as React from 'react';
import React__default from 'react';

/**
 * 讯飞客户端基础配置接口
 */
interface BaseXfyunClientOptions {
    /** 后端服务基础地址 */
    serverBase?: string;
    /** 获取认证码的方法 */
    getAuthCode?: () => string;
    /** 错误回调 */
    onError?: (message: string, sid?: string) => void;
    /** 统一日志回调（可用于上报） */
    onLog?: (level: 'info' | 'warn' | 'error', payload: Record<string, any>) => void;
}
/**
 * 讯飞客户端基础类
 *
 * 提供所有讯飞客户端的通用功能：
 * - 统一的错误处理
 * - 统一的签名获取
 * - 统一的状态管理
 *
 * @template T 具体的客户端选项类型
 */
declare abstract class BaseXfyunClient<T extends BaseXfyunClientOptions = BaseXfyunClientOptions> {
    protected readonly serverBase: string;
    protected readonly options: T;
    error: string | null;
    protected lastContext: Record<string, any> | null;
    protected sessionId: string;
    constructor(options?: T);
    /**
     * 获取签名信息
     *
     * @param type 签名类型 (iat|tts|rtasr|dts/create|dts/query)
     * @returns 签名响应数据
     * @throws Error 获取签名失败时抛出异常
     */
    protected getSignature(type: string): Promise<any>;
    /**
     * 统一错误处理
     *
     * @param message 错误消息
     * @param sid 会话ID（可选）
     */
    protected handleError(message: string, sid?: string, context?: Record<string, any>): void;
    /**
     * 处理讯飞API错误码
     *
     * @param code 错误码
     * @param message 原始错误消息
     * @param sid 会话ID（可选）
     * @returns 处理后的错误消息
     */
    protected processXfyunError(code?: number, message?: string, sid?: string, extra?: Record<string, any>): string;
    /**
     * 重置客户端状态
     */
    reset(): void;
    /**
     * 关闭客户端连接
     *
     * 子类可以重写此方法来实现具体的关闭逻辑
     */
    close(): void;
}

/**
 * 基础Hook状态类型
 */
type BaseHookStatus = "idle" | "connecting" | "open" | "closing" | "closed" | "error";
/**
 * 基础Hook选项
 */
interface BaseHookOptions extends BaseXfyunClientOptions {
    /** 是否自动清理资源 */
    autoCleanup?: boolean;
}
/**
 * 基础讯飞Hook
 *
 * 提供所有讯飞Hook的通用功能：
 * - 统一的状态管理
 * - 统一的错误处理
 * - 统一的资源清理
 *
 * @template T 具体的客户端类型
 * @template O 具体的选项类型
 */
declare function useBaseXfyun<T extends BaseXfyunClient<O>, O extends BaseHookOptions = BaseHookOptions>(createClient: (options?: O) => T, options?: O): {
    status: BaseHookStatus;
    error: string | null;
    reset: () => void;
    close: () => void;
    ensureClient: () => T;
    clientRef: React.RefObject<T | null>;
};

/**
 * 音频帧数据类型
 */
type AudioFramePayload = ArrayBuffer | Uint8Array | Int16Array;
/**
 * 音频配置常量
 */
declare const AUDIO_CONFIG: {
    /** 默认采样率 */
    readonly DEFAULT_SAMPLE_RATE: 16000;
    /** 默认声道数 */
    readonly DEFAULT_CHANNELS: 1;
    /** 默认位深度 */
    readonly DEFAULT_BIT_DEPTH: 16;
    /** 推荐帧大小（40ms） */
    readonly RECOMMENDED_FRAME_SIZE: 1280;
    /** 缓冲区大小 */
    readonly BUFFER_SIZE: 512;
    /** 重采样阈值 */
    readonly RESAMPLE_THRESHOLD: 0.1;
};
/**
 * 音频处理性能优化配置
 */
declare const AUDIO_PERFORMANCE: {
    /** 是否启用Web Workers */
    readonly ENABLE_WORKER: boolean;
    /** 批处理大小 */
    readonly BATCH_SIZE: 10;
    /** 缓存大小 */
    readonly CACHE_SIZE: 100;
    /** 是否启用音频压缩 */
    readonly ENABLE_COMPRESSION: true;
};
/**
 * 校验音频规格是否符合 16kHz/单声道/16bit
 */
declare function validateAudioSpec(params: {
    sampleRate: number;
    channels?: number;
    bitDepth?: number;
}): boolean;
/**
 * 将任意采样率/声道的 Float32 PCM 重采样到 16k 单声道，并返回 Int16 PCM
 * - 优先通过 OfflineAudioContext 高质量重采样
 * - 回退到简易线性插值重采样
 */
declare function resampleTo16kMono(float32Input: Float32Array, inputSampleRate: number, channels?: number): Promise<Int16Array>;
/**
 * 音频处理缓存
 */
declare class AudioCache {
    private cache;
    private maxSize;
    set(key: string, value: Float32Array): void;
    get(key: string): Float32Array | undefined;
    clear(): void;
}
/**
 * 音频批处理器
 */
declare class AudioBatchProcessor {
    private batch;
    private batchSize;
    private callback;
    constructor(callback: (data: Float32Array[]) => void);
    add(data: Float32Array): void;
    flush(): void;
}
/**
 * 获取音频缓存实例
 */
declare function getAudioCache(): AudioCache;
/**
 * 创建音频批处理器
 */
declare function createAudioBatchProcessor(callback: (data: Float32Array[]) => void): AudioBatchProcessor;
/**
 * 将音频帧转换为Base64编码
 *
 * @param buffer 音频帧数据
 * @returns Base64编码的字符串
 */
declare function toBase64(buffer: AudioFramePayload): string;
/**
 * 将Int16数组转换为Float32数组
 *
 * @param int16 Int16数组
 * @returns Float32数组
 */
declare function int16ToFloat32(int16: Int16Array): Float32Array;
/**
 * 将字节数组转换为Int16数组
 *
 * @param bytes 字节数组
 * @returns Int16数组
 */
declare function bytesToInt16(bytes: Uint8Array): Int16Array;
/**
 * 将Float32数组转换为Int16数组
 *
 * @param float32 Float32数组
 * @returns Int16数组
 */
declare function float32ToInt16(float32: ArrayLike<number>): Int16Array;
/**
 * 计算音频RMS（均方根）值（优化版本）
 *
 * @param samples 音频样本数组
 * @returns RMS值
 */
declare function calculateRMS(samples: ArrayLike<number>): number;
/**
 * 计算音频电平（0-100）
 *
 * @param samples 音频样本数组
 * @returns 电平值（0-100）
 */
declare function calculateLevel(samples: ArrayLike<number>): number;
/**
 * 获取共享的AudioContext实例
 *
 * @param sampleRate 采样率，默认16000
 * @returns AudioContext实例
 */
declare function getSharedAudioContext(sampleRate?: number): AudioContext;
/**
 * 释放共享的AudioContext实例
 */
declare function releaseSharedAudioContext(): void;
/**
 * 获取AudioContext引用计数
 */
declare function getAudioContextRefCount(): number;
/**
 * 暂停共享的AudioContext
 */
declare function suspendSharedAudioContext(): Promise<void>;
/**
 * 恢复共享的AudioContext
 */
declare function resumeSharedAudioContext(): Promise<void>;
/**
 * 创建AudioWorkletNode处理器
 *
 * @param audioCtx AudioContext实例
 * @param onAudioData 音频数据回调函数
 * @returns Promise<AudioWorkletNode>
 */
declare function createAudioWorkletProcessor(audioCtx: AudioContext, onAudioData: (data: Float32Array) => void, workletBaseUrl?: string): Promise<AudioWorkletNode>;
/**
 * 创建ScriptProcessorNode处理器（兼容性回退）
 *
 * @param audioCtx AudioContext实例
 * @param onAudioData 音频数据回调函数
 * @returns ScriptProcessorNode
 */
declare function createScriptProcessor(audioCtx: AudioContext, onAudioData: (data: Float32Array) => void): ScriptProcessorNode;

/**
 * 错误严重程度枚举
 */
declare enum ErrorSeverity {
    LOW = "low",
    MEDIUM = "medium",
    HIGH = "high",
    CRITICAL = "critical"
}
/**
 * 错误类型枚举
 */
declare enum ErrorType {
    NETWORK = "network",
    AUTHENTICATION = "authentication",
    PARAMETER = "parameter",
    AUDIO = "audio",
    WEBSOCKET = "websocket",
    UNKNOWN = "unknown"
}
/**
 * 增强的错误信息接口
 */
interface XfyunError {
    code: number;
    message: string;
    severity: ErrorSeverity;
    type: ErrorType;
    retryable: boolean;
    timestamp: number;
    context?: Record<string, any> | undefined;
}
/**
 * 映射讯飞错误码为友好的错误消息
 *
 * @param code 错误码
 * @param message 原始错误消息
 * @returns 友好的错误消息
 */
declare function mapXfyunError(code?: number, message?: string): string;
/**
 * 检查是否为可重试的错误
 *
 * @param code 错误码
 * @returns 是否可重试
 */
declare function isRetryableError(code?: number): boolean;
/**
 * 获取错误严重程度
 *
 * @param code 错误码
 * @returns 错误严重程度
 */
declare function getErrorSeverity(code?: number): ErrorSeverity;
/**
 * 获取错误类型
 *
 * @param code 错误码
 * @returns 错误类型
 */
declare function getErrorType(code?: number): ErrorType;
/**
 * 创建增强的错误对象
 *
 * @param code 错误码
 * @param message 原始错误消息
 * @param context 错误上下文
 * @returns 增强的错误对象
 */
declare function createXfyunError(code: number, message?: string, context?: Record<string, any>): XfyunError;
/**
 * 错误恢复策略
 */
interface ErrorRecoveryStrategy {
    maxRetries: number;
    retryDelay: number;
    backoffMultiplier: number;
    maxRetryDelay: number;
}
/**
 * 默认错误恢复策略
 */
declare const DEFAULT_RECOVERY_STRATEGY: ErrorRecoveryStrategy;
/**
 * 计算重试延迟
 *
 * @param attempt 当前尝试次数
 * @param strategy 恢复策略
 * @returns 延迟时间（毫秒）
 */
declare function calculateRetryDelay(attempt: number, strategy?: ErrorRecoveryStrategy): number;
/**
 * 生成可读的错误日志上下文
 */
declare function formatErrorContext(ctx?: Record<string, any>): string;

/**
 * IAT业务参数配置
 */
interface IatBusiness {
    /** 语种，默认为 zh_cn */
    language?: string;
    /** 业务领域，固定为 iat */
    domain?: string;
    /** 方言/口音（中文场景），默认 mandarin */
    accent?: string;
    /** 静音断句阈值（毫秒），默认 2000 */
    vad_eos?: number;
    /** 动态修正开关，默认 "wpgs" */
    dwa?: string;
    /** 是否返回标点（1/0），默认 1 */
    ptt?: 0 | 1;
    /** 返回字级别信息 */
    vinfo?: 0 | 1;
    /** 返回结果格式（plain/json 等） */
    rst?: string;
    /** 返回结果语言 */
    rlang?: string;
    /** 产品类型 */
    pd?: string;
    /** 产品引擎 */
    pd_engine?: string;
    /** 候选结果数量 */
    nbest?: number;
    /** 候选词数量 */
    wbest?: number;
}
/**
 * IAT客户端选项
 */
interface IatClientOptions extends BaseXfyunClientOptions {
    /** IAT业务参数配置 */
    business?: IatBusiness;
    /** 识别增量文本回调 */
    onResult?: (text: string, isFinal: boolean) => void;
    /** 原始消息回调（调试用） */
    onMessage?: (msg: any) => void;
    /** 连接打开回调（包含 sid） */
    onOpen?: (sid?: string) => void;
    /** 连接关闭回调 */
    onClose?: (code?: number, reason?: string) => void;
    /** 心跳间隔（毫秒），0表示禁用 */
    heartbeatMs?: number;
    /** 输入采样率（用于自动重采样判断） */
    inputSampleRate?: number;
    /** 输入声道数（默认1） */
    inputChannels?: number;
    /** 是否自动重采样到16k单声道（默认false） */
    autoResample?: boolean;
    /** 最大重试次数（默认3） */
    maxRetries?: number;
    /** 重连退避策略（可选，不传使用默认） */
    retryStrategy?: ErrorRecoveryStrategy;
    /** 是否启用语言/方言与URL匹配校验（默认true） */
    enableLangCheck?: boolean;
}
/**
 * 科大讯飞语音听写(IAT)客户端
 *
 * 支持实时语音转文字功能，特点：
 * - WebSocket实时连接
 * - 支持动态修正
 * - 支持增量识别结果
 * - 自动断句处理
 *
 * 使用示例：
 * ```typescript
 * const client = new IatClient({
 *   serverBase: 'http://localhost:8083',
 *   business: { language: 'zh_cn', vad_eos: 2000 },
 *   onResult: (text, isFinal) => console.log(text, isFinal)
 * });
 * await client.open();
 * client.sendFrame(audioData, false);
 * ```
 */
declare class IatClient extends BaseXfyunClient<IatClientOptions> {
    private ws;
    status: "idle" | "connecting" | "open" | "closing" | "closed";
    private resultTemp;
    private resultMap;
    private maxResultWindow;
    private lastSnSeen;
    private appId;
    private sid;
    private heartbeatTimer;
    private visibilityHandler?;
    private pausedByPageHidden;
    private retryCount;
    constructor(options?: IatClientOptions);
    /**
     * 建立IAT WebSocket连接并发送首帧
     *
     * 首帧内容：
     * - common.app_id: 来自后端签名返回
     * - business: 语言/断句/标点/动态修正等配置
     * - data: { status:0, format:'audio/L16;rate=16000', encoding:'raw' }
     *
     * @throws Error 连接失败时抛出异常
     */
    open(): Promise<void>;
    /**
     * 处理识别结果
     *
     * @param result 识别结果数据
     */
    private processRecognitionResult;
    /**
     * 调试/测试专用：注入一条识别结果并走内部重建逻辑
     * 不建立网络连接即可验证动态修正与乱序容错
     */
    debugProcessRecognitionResult(result: any): void;
    /**
     * 发送音频帧
     *
     * @param frame 音频帧数据
     * @param isLast 是否为最后一帧
     */
    sendFrame(frame: AudioFramePayload, isLast: boolean): void;
    /**
     * 重置客户端状态
     */
    reset(): void;
    /**
     * 关闭WebSocket连接
     */
    close(): void;
}

/**
 * IAT Hook选项
 */
interface IatOptions extends BaseXfyunClientOptions {
    /** IAT业务参数配置 */
    business?: IatBusiness;
    /** 识别增量文本回调 */
    onResult?: (text: string, isFinal: boolean) => void;
    /** 原始消息回调（调试用） */
    onMessage?: (msg: any) => void;
    /** 连接打开回调（包含 sid） */
    onOpen?: (sid?: string) => void;
    /** 连接关闭回调 */
    onClose?: (code?: number, reason?: string) => void;
    /** 心跳间隔（毫秒），0表示禁用 */
    heartbeatMs?: number;
    /** 最大重试次数（默认3） */
    maxRetries?: number;
    /** 重连退避策略（可选，不传使用默认） */
    retryStrategy?: ErrorRecoveryStrategy;
}
/**
 * 科大讯飞语音听写(IAT) Hook
 *
 * 支持实时语音转文字功能，特点：
 * - WebSocket实时连接
 * - 支持动态修正
 * - 支持增量识别结果
 * - 自动断句处理
 *
 * 使用示例：
 * ```typescript
 * const { status, error, open, sendFrame, close, reset } = useIat({
 *   serverBase: 'http://localhost:8083',
 *   business: { language: 'zh_cn', vad_eos: 2000 },
 *   onResult: (text, isFinal) => console.log(text, isFinal)
 * });
 *
 * await open();
 * sendFrame(audioData, false);
 * ```
 */
declare function useIat(options?: IatOptions): {
    status: BaseHookStatus;
    error: string | null;
    open: () => Promise<void>;
    sendFrame: (frame: AudioFramePayload, isLast: boolean) => void;
    close: () => void;
    reset: () => void;
};

/**
 * TTS业务参数配置
 */
interface TtsBusiness {
    /** 音频编码，默认 "raw" */
    aue?: string;
    /** 发音人，默认 "x4_yezi" */
    vcn?: string;
    /** 语速（0-100），默认 50 */
    speed?: number;
    /** 音量（0-100），默认 50 */
    volume?: number;
    /** 音调（0-100），默认 50 */
    pitch?: number;
    /** 数字发音风格（按官方枚举/数值） */
    rdn?: number | string;
    /** 文本编码（默认 utf8，可覆盖） */
    tte?: string;
    /** 音频封装格式（默认 audio/L16;rate=16000，可覆盖） */
    auf?: string;
    /** 音库领域（如通用/教育等） */
    ent?: string;
}
/**
 * TTS客户端选项
 */
interface TtsClientOptions extends BaseXfyunClientOptions {
    /** TTS业务参数配置 */
    business?: TtsBusiness;
    /** 音量电平回调（0-100） */
    onLevel?: (level: number) => void;
    /** MP3音频块回调 */
    onMp3Chunk?: (bytes: Uint8Array) => void;
    /** 合成完成回调 */
    onComplete?: () => void;
    /** 是否由SDK内置自动播放（PCM走WebAudio，MP3走MSE），默认 true */
    autoplay?: boolean;
    /** MP3 播放策略："mse" | "none"，默认 "mse"（仅当 autoplay=true 且 aue=mp3 生效） */
    mp3Playback?: "mse" | "none";
    /** 自动播放被策略阻止时，是否绑定一次性手势触发以恢复播放（默认 true） */
    autoplayGesture?: boolean;
}
/**
 * 科大讯飞语音合成(TTS)客户端
 *
 * 支持文字转语音功能，特点：
 * - WebSocket实时连接
 * - 支持多种音频格式（PCM/MP3）
 * - 实时音频播放
 * - 音量电平监控
 *
 * 使用示例：
 * ```typescript
 * const client = new TtsClient({
 *   serverBase: 'http://localhost:8083',
 *   business: { aue: 'raw', vcn: 'x4_yezi', speed: 50 },
 *   onLevel: (level) => console.log('音量:', level)
 * });
 * await client.speak('你好世界');
 * ```
 */
declare class TtsClient extends BaseXfyunClient<TtsClientOptions> {
    private ws;
    status: "idle" | "connecting" | "open" | "playing" | "closed" | "error";
    private audioCtx;
    private pcmQueue;
    private pcmProcessing;
    private pcmPaused;
    private pcmCurrentSource;
    private pcmScheduleAheadSec;
    private pcmCursorTime;
    private pcmPlaybackComplete;
    private mse;
    private mseAudioEl;
    private mseSourceBuffer;
    private mseQueue;
    private mseAppending;
    constructor(options?: TtsClientOptions);
    /**
     * 发起TTS合成并实时播放
     *
     * @param text 待合成的文本
     * @throws Error 合成失败时抛出异常
     */
    speak(text: string): Promise<void>;
    /**
     * 处理音频数据
     *
     * @param audio Base64编码的音频数据
     */
    private processAudioData;
    /**
     * 停止TTS合成并关闭客户端
     */
    close(): void;
    /**
     * 强制重新创建客户端（用于参数更新）
     */
    forceRecreate(): void;
    /**
     * 重置客户端状态
     */
    reset(): void;
    /** 音频数据回调，由上层设置 */
    onAudio?: (pcmBytes: Uint8Array) => void;
    private enqueuePcm;
    private playPcmQueue;
    /**
     * 调度播放完成检查（延迟检查确保音频播放完成）
     */
    private schedulePlaybackCompleteCheck;
    /**
     * 检查播放是否完成并触发onComplete回调
     */
    private checkPlaybackComplete;
    private ensureMse;
    private enqueueMp3;
    private flushMseQueue;
    private teardownPlayback;
    /**
     * 主动请求触发一次自动播放（适用于外部在用户手势中调用）
     */
    requestAutoplay(): void;
    /** 暂停PCM播放（仅影响内置PCM播放） */
    pause(): void;
    /** 恢复PCM播放 */
    resume(): void;
    /** 停止播放并清空队列 */
    stop(): void;
}

/**
 * TTS Hook选项
 */
interface TtsOptions extends BaseXfyunClientOptions {
    /** TTS业务参数配置 */
    business?: TtsBusiness;
    /** 音量电平回调（0-100） */
    onLevel?: (level: number) => void;
    /** MP3音频块回调 */
    onMp3Chunk?: (bytes: Uint8Array) => void;
    /** 合成完成回调 */
    onComplete?: () => void;
}
/**
 * 科大讯飞语音合成(TTS) Hook
 *
 * 支持文字转语音功能，特点：
 * - WebSocket实时连接
 * - 支持多种音频格式（PCM/MP3）
 * - 实时音频播放
 * - 音量电平监控
 *
 * 使用示例：
 * ```typescript
 * const { status, error, speak, stop } = useTts({
 *   serverBase: 'http://localhost:8083',
 *   business: { aue: 'raw', vcn: 'x4_yezi', speed: 50 },
 *   onLevel: (level) => console.log('音量:', level)
 * });
 *
 * await speak('你好世界');
 * ```
 */
declare function useTts(options?: TtsOptions): {
    status: BaseHookStatus;
    error: string | null;
    speak: (text: string) => Promise<void>;
    stop: () => void;
    forceRecreate: () => void;
};

/**
 * RTASR业务参数配置
 */
interface RtasrBusiness {
    /** 语种，默认为 zh_cn */
    language?: string;
    /** 业务领域，固定为 rtasr */
    domain?: string;
    /** 方言/口音（中文场景），默认 mandarin */
    accent?: string;
    /** 静音断句阈值（毫秒），默认 2000 */
    vad_eos?: number;
    /** 动态修正开关，默认 "wpgs" */
    dwa?: string;
    /** 是否返回标点（1/0），默认 1 */
    ptt?: 0 | 1;
    /** 产品类型，默认 "edu" */
    pd?: string;
    /** 产品引擎 */
    pd_engine?: string;
    /** 结果语言 */
    rlang?: string;
    /** 候选结果数量 */
    nbest?: number;
    /** 候选词数量 */
    wbest?: number;
}
/**
 * RTASR客户端选项
 */
interface RtasrClientOptions extends BaseXfyunClientOptions {
    /** RTASR业务参数配置 */
    business?: RtasrBusiness;
    /** 识别增量文本回调 */
    onResult?: (text: string, isFinal: boolean) => void;
    /** 原始消息回调（调试用） */
    onMessage?: (msg: any) => void;
    /** 连接打开回调（包含 sid） */
    onOpen?: (sid?: string) => void;
    /** 连接关闭回调 */
    onClose?: (code?: number, reason?: string) => void;
    /** 心跳间隔（毫秒），0表示禁用 */
    heartbeatMs?: number;
    /** 最大重试次数（默认3） */
    maxRetries?: number;
    /** 重连退避策略（可选，不传使用默认） */
    retryStrategy?: ErrorRecoveryStrategy;
    /** 输入采样率（用于自动重采样判断） */
    inputSampleRate?: number;
    /** 输入声道数（默认1） */
    inputChannels?: number;
    /** 是否自动重采样到16k单声道（默认false） */
    autoResample?: boolean;
}
/**
 * 科大讯飞实时语音转写(RTASR)客户端
 *
 * 支持长时间语音转文字功能，特点：
 * - WebSocket实时连接
 * - 支持连续音频流识别
 * - 自动重连机制
 * - 支持动态修正
 *
 * 使用示例：
 * ```typescript
 * const client = new RtasrClient({
 *   serverBase: 'http://localhost:8083',
 *   business: { language: 'zh_cn', domain: 'rtasr' },
 *   onResult: (text, isFinal) => console.log(text, isFinal)
 * });
 * await client.open();
 * client.sendFrame(audioData, false);
 * ```
 */
declare class RtasrClient extends BaseXfyunClient<RtasrClientOptions> {
    private ws;
    status: "idle" | "connecting" | "open" | "closing" | "closed";
    private resultTemp;
    private resultArray;
    private appId;
    private sid;
    private started;
    private pendingFrames;
    private lastMessageTime;
    private lastAudioTime;
    private messageCheckTimer;
    private audioTimeoutTimer;
    private heartbeatTimer;
    private retryCount;
    private ended;
    private sentEnd;
    private visibilityHandler?;
    private pausedByPageHidden;
    constructor(options?: RtasrClientOptions);
    /**
     * 清理现有连接，确保完全关闭
     */
    private cleanupExistingConnection;
    /**
     * 建立RTASR WebSocket连接并发送首帧
     *
     * @throws Error 连接失败时抛出异常
     */
    open(): Promise<void>;
    /**
     * 处理识别结果
     *
     * @param msg 消息数据
     */
    private processRecognitionResult;
    /**
     * 发送音频帧
     *
     * @param frame 音频帧数据
     * @param isLast 是否为最后一帧
     */
    sendFrame(frame: ArrayBuffer, isLast: boolean): void;
    /**
     * 冲刷等待队列
     */
    private flushPendingFrames;
    /**
     * 重置客户端状态
     */
    reset(): void;
    /**
     * 关闭WebSocket连接
     */
    close(): void;
}

/**
 * RTASR Hook选项
 */
interface RtasrOptions extends BaseXfyunClientOptions {
    /** RTASR业务参数配置 */
    business?: RtasrBusiness;
    /** 识别增量文本回调 */
    onResult?: (text: string, isFinal: boolean) => void;
    /** 原始消息回调（调试用） */
    onMessage?: (msg: any) => void;
    /** 连接打开回调（包含 sid） */
    onOpen?: (sid?: string) => void;
    /** 连接关闭回调 */
    onClose?: (code?: number, reason?: string) => void;
    /** 心跳间隔（毫秒），0表示禁用 */
    heartbeatMs?: number;
    /** 最大重试次数（默认3） */
    maxRetries?: number;
    /** 重连退避策略（可选，不传使用默认） */
    retryStrategy?: ErrorRecoveryStrategy;
}
/**
 * 科大讯飞实时语音转写(RTASR) Hook
 *
 * 支持长时间语音转文字功能，特点：
 * - WebSocket实时连接
 * - 支持连续音频流识别
 * - 自动重连机制
 * - 支持动态修正
 *
 * 使用示例：
 * ```typescript
 * const { status, error, open, sendFrame, close, reset } = useRtasr({
 *   serverBase: 'http://localhost:8083',
 *   business: { language: 'zh_cn', domain: 'rtasr' },
 *   onResult: (text, isFinal) => console.log(text, isFinal)
 * });
 *
 * await open();
 * sendFrame(audioData, false);
 * ```
 */
declare function useRtasr(options?: RtasrOptions): {
    status: BaseHookStatus;
    error: string | null;
    open: () => Promise<void>;
    sendFrame: (frame: ArrayBuffer, isLast: boolean) => void;
    close: () => void;
    reset: () => void;
    client: RtasrClient | null;
};

/**
 * DTS发音人配置
 */
declare const DTS_VOICES: {
    readonly x4_yeting: {
        readonly name: "希涵";
        readonly gender: "女";
        readonly language: "中文/普通话";
        readonly style: "游戏影视解说";
    };
    readonly x4_guanyijie: {
        readonly name: "关山-专题";
        readonly gender: "男";
        readonly language: "中文/普通话";
        readonly style: "专题片纪录片";
    };
    readonly x4_pengfei: {
        readonly name: "小鹏";
        readonly gender: "男";
        readonly language: "中文/普通话";
        readonly style: "新闻播报";
    };
    readonly x4_qianxue: {
        readonly name: "千雪";
        readonly gender: "女";
        readonly language: "中文/普通话";
        readonly style: "阅读听书";
    };
    readonly x4_lingbosong: {
        readonly name: "聆伯松-老年男声";
        readonly gender: "男";
        readonly language: "中文/普通话";
        readonly style: "阅读听书";
    };
    readonly x4_xiuying: {
        readonly name: "秀英-老年女声";
        readonly gender: "女";
        readonly language: "中文/普通话";
        readonly style: "阅读听书";
    };
    readonly x4_mingge: {
        readonly name: "明哥";
        readonly gender: "男";
        readonly language: "中文/普通话";
        readonly style: "阅读听书";
    };
    readonly x4_doudou: {
        readonly name: "豆豆";
        readonly gender: "男";
        readonly language: "中文/男童";
        readonly style: "阅读听书";
    };
    readonly x4_lingxiaoshan_profnews: {
        readonly name: "聆小珊";
        readonly gender: "女";
        readonly language: "中文/普通话";
        readonly style: "新闻播报";
    };
    readonly x4_xiaoguo: {
        readonly name: "小果";
        readonly gender: "女";
        readonly language: "中文/普通话";
        readonly style: "新闻播报";
    };
    readonly x4_xiaozhong: {
        readonly name: "小忠";
        readonly gender: "男";
        readonly language: "中文/普通话";
        readonly style: "新闻播报";
    };
    readonly x4_yezi: {
        readonly name: "小露";
        readonly gender: "女";
        readonly language: "中文/普通话";
        readonly style: "通用场景";
    };
    readonly x4_chaoge: {
        readonly name: "超哥";
        readonly gender: "男";
        readonly language: "中文/普通话";
        readonly style: "新闻播报";
    };
    readonly x4_feidie: {
        readonly name: "飞碟哥";
        readonly gender: "男";
        readonly language: "中文/普通话";
        readonly style: "游戏影视解说";
    };
    readonly x4_lingfeihao_upbeatads: {
        readonly name: "聆飞皓-广告";
        readonly gender: "男";
        readonly language: "中文/普通话";
        readonly style: "直播广告";
    };
    readonly x4_wangqianqian: {
        readonly name: "嘉欣";
        readonly gender: "女";
        readonly language: "中文/普通话";
        readonly style: "直播广告";
    };
    readonly x4_lingxiaozhen_eclives: {
        readonly name: "聆小臻";
        readonly gender: "女";
        readonly language: "中文/普通话";
        readonly style: "直播广告";
    };
    readonly x4_EnUs_Catherine_profnews: {
        readonly name: "Catherine";
        readonly gender: "女";
        readonly language: "英语";
        readonly style: "专业新闻";
    };
    readonly x5_lingfeizhe: {
        readonly name: "灵飞哲";
        readonly gender: "男";
        readonly language: "中文/普通话";
        readonly style: "通用场景";
    };
    readonly x5_lingxiaoxue: {
        readonly name: "灵小雪";
        readonly gender: "女";
        readonly language: "中文/普通话";
        readonly style: "通用场景";
    };
    readonly x4_lingfeihong_document: {
        readonly name: "聆飞红-文档";
        readonly gender: "女";
        readonly language: "中文/普通话";
        readonly style: "文档阅读";
    };
    readonly x4_lingfeichen_assist: {
        readonly name: "聆飞晨-助手";
        readonly gender: "男";
        readonly language: "中文/普通话";
        readonly style: "智能助手";
    };
    readonly x4_lingxiaoqi_assist: {
        readonly name: "聆小七-助手";
        readonly gender: "女";
        readonly language: "中文/普通话";
        readonly style: "智能助手";
    };
    readonly x4_lingfeihong_document_n: {
        readonly name: "聆飞红-文档N";
        readonly gender: "女";
        readonly language: "中文/普通话";
        readonly style: "文档阅读";
    };
};
/**
 * DTS业务参数配置
 */
interface DtsBusiness {
    /** 音频编码，默认 "raw" */
    aue?: string;
    /** 发音人，默认 "x4_mingge" */
    vcn?: 'x4_yeting' | 'x4_guanyijie' | 'x4_pengfei' | 'x4_qianxue' | 'x4_lingbosong' | 'x4_xiuying' | 'x4_mingge' | 'x4_doudou' | 'x4_lingxiaoshan_profnews' | 'x4_xiaoguo' | 'x4_xiaozhong' | 'x4_yezi' | 'x4_chaoge' | 'x4_feidie' | 'x4_lingfeihao_upbeatads' | 'x4_wangqianqian' | 'x4_lingxiaozhen_eclives' | 'x4_EnUs_Catherine_profnews' | 'x5_lingfeizhe' | 'x5_lingxiaoxue' | 'x4_lingfeihong_document' | 'x4_lingfeichen_assist' | 'x4_lingxiaoqi_assist' | 'x4_lingfeihong_document_n';
    /** 语速（0-100），默认 50 */
    speed?: number;
    /** 音量（0-100），默认 50 */
    volume?: number;
    /** 音调（0-100），默认 50 */
    pitch?: number;
    /** 背景音（0-100），默认 0 */
    bgs?: number;
    /** 文本处理类型，默认 0 */
    ttp?: number;
}
/**
 * DTS客户端选项
 */
interface DtsClientOptions extends BaseXfyunClientOptions {
    /** 后端服务基础地址（必需） */
    serverBase: string;
    /** 获取认证码的方法（必需） */
    getAuthCode: () => string;
    /** DTS业务参数配置 */
    business?: DtsBusiness;
    /** 任务创建回调 */
    onTaskCreated?: (taskId: string) => void;
    /** 任务完成回调 */
    onTaskCompleted?: (result: any) => void;
    /** 任务轮询超时时间（毫秒，默认 10 分钟） */
    pollTimeoutMs?: number;
    /** 任务轮询最大次数（默认 300 次） */
    maxPollTimes?: number;
}
/**
 * 科大讯飞长文本语音合成(DTS)客户端
 *
 * 支持长文本语音合成功能，特点：
 * - HTTP API调用
 * - 支持10万字左右的长文本
 * - 异步任务处理
 * - 任务状态查询
 *
 * 使用示例：
 * ```typescript
 * const client = new DtsClient({
 *   serverBase: 'http://localhost:8083',
 *   business: { aue: 'raw', vcn: 'x4_mingge', speed: 50 },
 *   onTaskCreated: (taskId) => console.log('任务ID:', taskId)
 * });
 * const taskId = await client.createTask('很长的文本...');
 * const result = await client.waitForTask(taskId);
 * ```
 */
declare class DtsClient extends BaseXfyunClient<DtsClientOptions> {
    constructor(options?: DtsClientOptions);
    /**
     * 创建DTS任务
     *
     * @param text 待合成的文本
     * @param business 业务参数（可选，会覆盖默认配置）
     * @returns 任务ID
     * @throws Error 创建失败时抛出异常
     */
    createTask(text: string, business?: DtsBusiness): Promise<string>;
    /**
     * 查询DTS任务状态
     *
     * @param taskId 任务ID
     * @returns 任务状态数据
     * @throws Error 查询失败时抛出异常
     */
    queryTask(taskId: string): Promise<any>;
    /**
     * 轮询查询任务直到完成
     *
     * @param taskId 任务ID
     * @param intervalMs 轮询间隔（毫秒），默认2000
     * @returns 任务完成后的结果数据
     * @throws Error 任务失败或查询异常时抛出异常
     */
    waitForTask(taskId: string, intervalMs?: number): Promise<any>;
    /**
     * 下载任务结果产物
     * - 支持片段数组或单一直链
     */
    downloadResult(taskId: string, format?: string): Promise<Blob | null>;
    /**
     * 关闭DTS客户端
     *
     * DTS客户端使用HTTP API，无需特殊关闭逻辑
     */
    close(): void;
}

/**
 * DTS Hook选项
 */
interface DtsOptions extends DtsClientOptions {
}
/**
 * DTS Hook状态类型
 */
type DtsStatus = "idle" | "creating" | "querying" | "completed" | "error";
/**
 * 科大讯飞长文本语音合成(DTS) Hook
 *
 * 支持长文本语音合成功能，特点：
 * - HTTP API调用
 * - 支持10万字左右的长文本
 * - 异步任务处理
 * - 任务状态查询
 *
 * 使用示例：
 * ```typescript
 * const { status, error, taskId, result, createTask, waitForTask } = useDts({
 *   serverBase: 'http://localhost:8083',
 *   business: { aue: 'raw', vcn: 'x4_mingge', speed: 50 },
 *   onTaskCreated: (taskId) => console.log('任务ID:', taskId)
 * });
 *
 * const taskId = await createTask('很长的文本...');
 * const result = await waitForTask(taskId);
 * ```
 */
declare function useDts(options?: DtsOptions): {
    status: DtsStatus;
    error: string | null;
    taskId: string | null;
    result: any;
    createTask: (text: string, business?: DtsBusiness) => Promise<string>;
    queryTask: (taskId: string) => Promise<any>;
    waitForTask: (taskId: string, intervalMs?: number) => Promise<any>;
    reset: () => void;
};

/**
 * useIatRecorder 选项
 * - client: IatClient 实例（需外部创建与配置）
 * - vadThreshold: 本地音量阈值（0-100），用于粗略静音门限显示/控制
 * - frameMs: 发送给服务端的帧长（毫秒），默认 40ms（约 640 samples @16kHz）
 */
interface UseIatRecorderOptions {
    client: IatClient;
    vadThreshold?: number;
    frameMs?: number;
}
/**
 * 基于浏览器麦克风的 IAT 录音 Hook。
 * - 内部通过 WebAudio 的 ScriptProcessor 聚合帧，并以 16bit PCM 发送给 IatClient
 * - 提供 recording/level 状态与 start/stop 控制方法
 */
declare function useIatRecorder(options: UseIatRecorderOptions): {
    recording: boolean;
    level: number;
    start: () => Promise<void>;
    stop: () => void;
};

/**
 * useRtasrStream 选项
 * - client: RtasrClient 实例
 * - frameMs: 帧长（毫秒），默认 40ms
 */
interface UseRtasrStreamOptions {
    client: RtasrClient;
    frameMs?: number;
}
/**
 * 使用浏览器麦克风流向 RTASR 发送音频数据的 Hook。
 * - 内部以 ScriptProcessor 聚合帧并转换为 Int16 PCM，通过 WebSocket 发送
 * - 提供 streaming 状态与 start/stop 控制
 */
declare function useRtasrStream(options: UseRtasrStreamOptions): {
    streaming: boolean;
    start: () => Promise<void>;
    stop: () => void;
};

/**
 * useTtsPlayer 选项
 * - client: TtsClient 实例
 */
interface UseTtsPlayerOptions {
    client: TtsClient;
}
/**
 * TTS 播放控制 Hook。
 * - 封装 speak/pause/resume/stop 控制
 * - 暴露播放状态与音量电平 level（0-100）
 */
declare function useTtsPlayer({ client }: UseTtsPlayerOptions): {
    status: "error" | "closed" | "idle" | "connecting" | "open" | "playing";
    level: number;
    speak: (text: string) => Promise<void>;
    pause: () => void;
    resume: () => void;
    stop: () => void;
    requestAutoplay: () => void;
};

/**
 * React 支持
 * 提供React专用的语音识别和合成功能
 */

interface ReactXfyunProviderProps {
    children: React__default.ReactNode;
    serverBase: string;
    getAuthCode: () => string;
}

/**
 * React Provider 组件
 */
declare function XfyunProvider({ children, serverBase, getAuthCode }: ReactXfyunProviderProps): React__default.FunctionComponentElement<React__default.ProviderProps<{
    serverBase: string;
    getAuthCode: () => string;
} | null>>;
/**
 * 使用Xfyun Context的Hook
 */
declare function useXfyunContext(): {
    serverBase: string;
    getAuthCode: () => string;
};

export { AUDIO_CONFIG, AUDIO_PERFORMANCE, type AudioFramePayload, type BaseHookOptions, type BaseHookStatus, BaseXfyunClient, type BaseXfyunClientOptions, DEFAULT_RECOVERY_STRATEGY, DTS_VOICES, type DtsBusiness, DtsClient, type DtsClientOptions, type DtsOptions, type DtsStatus, type ErrorRecoveryStrategy, ErrorSeverity, ErrorType, type IatBusiness, IatClient, type IatClientOptions, type IatOptions, type ReactXfyunProviderProps, type RtasrBusiness, RtasrClient, type RtasrClientOptions, type RtasrOptions, type TtsBusiness, TtsClient, type TtsClientOptions, type TtsOptions, type UseIatRecorderOptions, type UseRtasrStreamOptions, type UseTtsPlayerOptions, type XfyunError, XfyunProvider, bytesToInt16, calculateLevel, calculateRMS, calculateRetryDelay, createAudioBatchProcessor, createAudioWorkletProcessor, createScriptProcessor, createXfyunError, float32ToInt16, formatErrorContext, getAudioCache, getAudioContextRefCount, getErrorSeverity, getErrorType, getSharedAudioContext, int16ToFloat32, isRetryableError, mapXfyunError, releaseSharedAudioContext, resampleTo16kMono, resumeSharedAudioContext, suspendSharedAudioContext, toBase64, useBaseXfyun, useDts, useIat, useIatRecorder, useRtasr, useRtasrStream, useTts, useTtsPlayer, useXfyunContext, validateAudioSpec };