@bdky/aaas-pilot-kit 1.0.4 → 1.0.5

package/dist/libs/aaas-pilot-kit/src/index.d.ts

@@ -3,3 +3,5 @@ export * from './types/config';
 export * from './lib/service/conversation';
 export * from './lib/aaas-pilot-kit';
 export * from './lib/controller';
+export { AudioDeviceDetector, AudioDeviceError, getErrorMessage, checkAudioDevice, type AudioDeviceCheckResult, type AudioDetectorOptions } from './lib/utils/AudioDeviceDetector';
+export { subscribeAgentResponse, type ISubscribeAgentResponseOptions } from './lib/utils/agentResponseHelper';

package/dist/libs/aaas-pilot-kit/src/lib/controller.d.ts

@@ -5,6 +5,7 @@ import { BaseDigitalHumanService } from './service/digital-human/BaseDigitalHuma
 import { ConversationService } from './service/conversation';
 import { ErrorManager } from './error';
 import type { IResolvedOptions, IAaaSPilotKitController, IAaaSPilotKitEmitter } from '../types/config';
+import { AgentResponse } from './service/agent/agentResponse';
 export interface IAsrMessageEventPayload {
     text: string;
     completed: boolean;
@@ -21,7 +22,11 @@ export interface IInterruptEventPayload {
     queryId?: string;
     sessionId?: string;
 }
-export declare class AaaSPilotKitController<AS extends BaseAgentService = BaseAgentService> implements IAaaSPilotKitController {
+type ExtractResponseType<P> = P extends BaseAgentService<infer R, any> ? R : never;
+export interface IReplyStartEventPayload<AS extends BaseAgentService = BaseAgentService> {
+    agentResponse: AgentResponse<ExtractResponseType<AS>> | null;
+}
+export declare class AaaSPilotKitController<AS extends BaseAgentService = BaseAgentService> implements IAaaSPilotKitController<AS> {
     private readonly opts;
     private readonly errorManager;
     readonly agentService: AS;
@@ -29,11 +34,13 @@ export declare class AaaSPilotKitController<AS extends BaseAgentService = BaseAg
     private readonly digitalHumanService;
     readonly conversationService: ConversationService;
     static ENTRY_EMITTER_NAME: string;
-    emitter: Emittery<IAaaSPilotKitEmitter>;
+    emitter: Emittery<IAaaSPilotKitEmitter<AS>>;
     interruptible: boolean;
     private isRenderingMultiModConversation;
     private isDigitalHumanServiceReady;
     private isAsrServiceReady;
+    /** 缓存上一次触发reply_start时的requestId */
+    private lastReplyStartRequestId;
     /** 缓存最新一条agent消息 */
     private aiWorkerMessageCache;
     /** 用于中断渲染中的多模态消息的signal */
@@ -70,6 +77,31 @@ export declare class AaaSPilotKitController<AS extends BaseAgentService = BaseAg
     input: (text: string) => IAaaSPilotKitController;
     dispose: () => IAaaSPilotKitController;
     setInterruptible: (interruptible: boolean) => IAaaSPilotKitController;
+    /**
+     * 🎙️ 检查音频设备可用性
+     *
+     * 执行 4 层渐进式检测：
+     *   - Level 1: API 支持检查 (MediaDevices API)
+     *   - Level 2: 设备枚举 (enumerateDevices)
+     *   - Level 3: 权限状态查询 (Permissions API)
+     *   - Level 4: 实际流获取 (getUserMedia + 轨道状态)
+     *
+     * @param options 检测配置选项
+     * @returns 检测结果
+     *
+     * @example
+     * ```typescript
+     * const result = await controller.checkAudioDevice();
+     * if (!result.available) {
+     *     alert(getErrorMessage(result.error));
+     * }
+     * ```
+     */
+    checkAudioDevice: (options?: {
+        timeout?: number;
+        autoCleanup?: boolean;
+        forceCheck?: boolean;
+    }) => Promise<import("./utils/AudioDeviceDetector").AudioDeviceCheckResult>;
     private readonly bindAsrServiceEvents;
     private readonly bindAgentServiceEvents;
     private readonly bindDigitalHumanServiceEvents;
@@ -93,6 +125,11 @@ export declare class AaaSPilotKitController<AS extends BaseAgentService = BaseAg
      * 处理asr消息
      */
     private readonly handleAsrMessage;
+    /**
+     * 处理设备检测完成事件
+     * 聚合 ASR 服务的设备检测结果，添加用户友好的错误提示，并对外发布
+     */
+    private readonly handleDeviceCheckCompleted;
     /**
      * 处理client conversation
      */
@@ -105,3 +142,4 @@ export declare class AaaSPilotKitController<AS extends BaseAgentService = BaseAg
     private readonly checkServiceReady;
     private readonly handleAIWorkerConversationChange;
 }
+export {};

package/dist/libs/aaas-pilot-kit/src/lib/error/codes.d.ts

@@ -29,6 +29,12 @@ export declare const ERROR_CODES: {
     readonly ASR_MUTE_FAILED: "3012";
     readonly ASR_MESSAGE_INTERVAL_TIMEOUT: "3013";
     readonly ASR_RUNTIME_ERROR: "3014";
+    readonly ASR_DEVICE_API_NOT_SUPPORTED: "3100";
+    readonly ASR_DEVICE_INSECURE_CONTEXT: "3101";
+    readonly ASR_DEVICE_ENUMERATION_FAILED: "3102";
+    readonly ASR_DEVICE_PERMISSION_DISMISSED: "3103";
+    readonly ASR_DEVICE_OCCUPIED: "3104";
+    readonly ASR_DEVICE_CHECK_TIMEOUT: "3105";
     readonly DH_MOUNT_FAILED: "4001";
     readonly DH_IFRAME_LOAD_ERROR: "4002";
     readonly DH_RENDER_ERROR: "4003";

package/dist/libs/aaas-pilot-kit/src/lib/error/services/AsrError.d.ts

@@ -24,3 +24,21 @@ export declare class AsrMessageIntervalTimeoutError extends AsrError {
 export declare class AsrRuntimeError extends AsrError {
     constructor(message?: string, metadata?: Partial<IErrorMetadata>);
 }
+export declare class AsrDeviceNotFoundError extends AsrError {
+    constructor(message?: string, metadata?: Partial<IErrorMetadata>);
+}
+export declare class AsrDeviceOccupiedError extends AsrError {
+    constructor(message?: string, metadata?: Partial<IErrorMetadata>);
+}
+export declare class AsrDeviceApiNotSupportedError extends AsrError {
+    constructor(message?: string, metadata?: Partial<IErrorMetadata>);
+}
+export declare class AsrDeviceInsecureContextError extends AsrError {
+    constructor(message?: string, metadata?: Partial<IErrorMetadata>);
+}
+export declare class AsrDevicePermissionDismissedError extends AsrError {
+    constructor(message?: string, metadata?: Partial<IErrorMetadata>);
+}
+export declare class AsrDeviceCheckTimeoutError extends AsrError {
+    constructor(message?: string, metadata?: Partial<IErrorMetadata>);
+}

package/dist/libs/aaas-pilot-kit/src/lib/service/agent/agentResponse.d.ts

@@ -0,0 +1,174 @@
+import Emittery from 'emittery';
+export interface IEventWithSessionIdPayload {
+    sessionId: string;
+    queryId?: string;
+}
+export declare namespace NAgentResponse {
+    interface IUpdateEventPayload<T> extends IEventWithSessionIdPayload {
+        response: AgentResponse<T>;
+    }
+    interface IEmitter<T> {
+        update: IUpdateEventPayload<T>;
+    }
+}
+export interface IResponseChunkRaw<T = any> {
+    data: T;
+    index: number;
+}
+export interface IAgentResponseRaw<T = any> {
+    id: string;
+    sessionId: string;
+    queryId: string;
+    startTime: number;
+    endTime: number;
+    duration: number;
+    isCompleted: boolean;
+    chunks: Array<IResponseChunkRaw<T>>;
+    fullText: string;
+}
+/**
+ * 响应 Chunk 基类
+ * 代表流式响应中的单个数据块
+ */
+export declare class ResponseChunk<T = any> {
+    /**
+     * chunk 的原始数据
+     */
+    readonly data: T;
+    /**
+     * chunk 的序号
+     */
+    readonly index: number;
+    constructor(data: T, index: number);
+    /**
+     * 获取 chunk 的文本内容
+     * 子类可以重写此方法来提取特定格式的文本
+     */
+    getText: () => string;
+    /**
+     * 将 chunk 转换为 JSON 对象
+     */
+    toJSON: () => IResponseChunkRaw<T>;
+}
+/**
+ * Agent 响应类
+ * 维护单次完整回复的所有 chunks
+ */
+export declare class AgentResponse<T = unknown> {
+    readonly emitter: Emittery<NAgentResponse.IEmitter<T>, NAgentResponse.IEmitter<T> & import("emittery").OmnipresentEventData, never>;
+    /**
+     * 响应的唯一标识
+     */
+    readonly id: string;
+    /**
+     * 关联的 session ID
+     */
+    readonly sessionId: string;
+    /**
+     * 关联的 query ID
+     */
+    readonly queryId: string;
+    /**
+     * 响应开始时间
+     */
+    readonly startTime: number;
+    /**
+     * 响应结束时间
+     */
+    private _endTime;
+    /**
+     * 响应是否完成
+     */
+    private _isCompleted;
+    /**
+     * 所有 chunks 的列表
+     */
+    private readonly chunks;
+    constructor(sessionId: string, queryId: string);
+    /**
+     * 获取结束时间
+     */
+    get endTime(): number;
+    /**
+     * 添加一个 chunk
+     */
+    appendChunk: (chunk: ResponseChunk<T>) => void;
+    /**
+     * 标记响应完成
+     */
+    complete: () => void;
+    /**
+     * 获取所有 chunks
+     */
+    getChunks: () => Array<ResponseChunk<T>>;
+    /**
+     * 获取完整的文本内容
+     */
+    getFullText: () => string;
+    /**
+     * 获取响应时长(毫秒)
+     */
+    getDuration: () => number;
+    /**
+     * 检查响应是否完成
+     */
+    isCompleted: () => boolean;
+    /**
+     * 转换为 JSON 对象
+     */
+    toJSON: () => IAgentResponseRaw<T>;
+    /**
+     * 转换为字符串
+     */
+    toString: () => string;
+}
+/**
+ * 响应列表管理器
+ * 用于管理多个 AgentResponse
+ */
+export declare class ResponseManager<T = unknown> {
+    /**
+     * 当前正在构建的响应
+     */
+    protected currentResponse: AgentResponse<T> | null;
+    /**
+     * 所有响应的列表
+     */
+    private responses;
+    /**
+     * 最大保存的响应数量
+     * 0 表示不限制
+     */
+    private readonly maxSize;
+    constructor(maxSize?: number);
+    onResponse: (rawResponse: T, sessionId: string, queryId: string) => void;
+    onComplete: () => void;
+    /**
+     * 获取所有响应
+     */
+    getResponses: () => Array<AgentResponse<T>>;
+    /**
+     * 根据 ID 获取响应
+     */
+    getResponseById: (id: string) => AgentResponse<T> | undefined;
+    /**
+     * 根据 queryId 获取响应
+     */
+    getResponseByQueryId: (queryId: string) => AgentResponse<T> | undefined;
+    /**
+     * 获取最后一个响应
+     */
+    getLastResponse: () => AgentResponse<T> | null;
+    /**
+     * 清空所有响应
+     */
+    clear: () => void;
+    /**
+     * 转换为 JSON 数组
+     */
+    toJSON: () => Array<IAgentResponseRaw<T>>;
+    /**
+     * 添加一个响应
+     */
+    private readonly addResponse;
+}

package/dist/libs/aaas-pilot-kit/src/lib/service/agent/aiobAgentService.d.ts

@@ -61,7 +61,7 @@ export declare namespace NAiobAgentService {
         llm = 1
     }
 }
-export declare class AiobAgentService extends BaseAgentService {
+export declare class AiobAgentService extends BaseAgentService<NAiobAgentService.IConversationSSEMessage> {
     static REQUEST_URI: string;
     query: (text: string) => Promise<void>;
     hangup: () => Promise<void>;

package/dist/libs/aaas-pilot-kit/src/lib/service/agent/baseAgentService.d.ts

@@ -2,6 +2,7 @@ import Emittery from 'emittery';
 import { CommonRequest } from '../../api/request';
 import type { IResolvedOptions } from '../../../types/config';
 import { ErrorManager } from '../../error';
+import { ResponseManager, AgentResponse } from './agentResponse';
 export declare namespace NBaseAgentService {
     interface IEventWithSessionIdPayload {
         sessionId: string;
@@ -13,6 +14,9 @@ export declare namespace NBaseAgentService {
     interface IInstructionReceivedEventPayload extends IEventWithSessionIdPayload {
         instruction: Record<string, Record<string, any>>;
     }
+    interface IResponseEventPayload<R = any> extends IEventWithSessionIdPayload {
+        response: AgentResponse<R>;
+    }
     type IHangupEventPayload = IEventWithSessionIdPayload;
     type ICompletedEventPayload = IEventWithSessionIdPayload;
     interface IEmitter {
@@ -21,11 +25,12 @@ export declare namespace NBaseAgentService {
         timeout: IEventWithSessionIdPayload;
         hangup: IHangupEventPayload;
         instruction_received: IInstructionReceivedEventPayload;
+        response: IResponseEventPayload;
         quota_expired: IEventWithSessionIdPayload;
         usage_quota_reached: IEventWithSessionIdPayload;
     }
 }
-export declare abstract class BaseAgentService<E extends NBaseAgentService.IEmitter = NBaseAgentService.IEmitter> {
+export declare abstract class BaseAgentService<R = any, E extends NBaseAgentService.IEmitter = NBaseAgentService.IEmitter> {
     readonly request: CommonRequest;
     readonly errorManager: ErrorManager;
     readonly opts: IResolvedOptions;
@@ -33,17 +38,29 @@ export declare abstract class BaseAgentService<E extends NBaseAgentService.IEmit
     protected conversationSessionId: string;
     protected abortController: AbortController | null;
     /**
-     * 每一轮query的id，用于区分不同的query
+     * 每一轮query的id,用于区分不同的query
      */
     protected _queryId: string;
     /**
      * 上一轮的query id
      */
     protected _lastQueryId: string;
+    /**
+     * 响应管理器,维护所有 Agent 回复
+     */
+    protected responseManager: ResponseManager<R>;
     constructor(request: CommonRequest, errorManager: ErrorManager, opts: IResolvedOptions);
     get sessionId(): string;
     get queryId(): string;
     get lastQueryId(): string;
+    /**
+     * 获取所有响应
+     */
+    getResponses(): ReadonlyArray<AgentResponse<R>>;
+    /**
+     * 获取响应管理器
+     */
+    getResponseManager(): ResponseManager<R>;
     setSessionId: (sessionId: string) => void;
     setQueryId: (queryId: string) => void;
     setLastQueryId: (queryId: string) => void;
@@ -57,6 +74,7 @@ export declare abstract class BaseAgentService<E extends NBaseAgentService.IEmit
     protected onHangup: (payload: E["hangup"]) => void;
     protected onTimeout: (payload: E["timeout"]) => void;
     protected onInstructionReceived: (payload: E["instruction_received"]) => void;
+    protected onResponse: (response: R) => void;
     protected onUsageQuotaReached: (payload: E["usage_quota_reached"]) => void;
     protected onQuotaExpired: (payload: E["quota_expired"]) => void;
     protected _dispose: () => void;

package/dist/libs/aaas-pilot-kit/src/lib/service/agent/cspAgentService.d.ts

@@ -83,7 +83,7 @@ export declare namespace NCspAgentService {
         thumbDetail?: string;
     }
 }
-export declare class CspAgentService extends BaseAgentService {
+export declare class CspAgentService extends BaseAgentService<NCspAgentService.IConversationSSEMessage> {
     static REQUEST_URI: string;
     query: (text: string) => Promise<void>;
     dispose: () => void;

package/dist/libs/aaas-pilot-kit/src/lib/service/digital-human/BaseDigitalHumanService.d.ts

@@ -58,5 +58,21 @@ export declare abstract class BaseDigitalHumanService {
     abstract sendSilenceMessage(): this;
     abstract dispose(): this;
     abstract GetRequestId(): string;
+    /**
+     * 取消静音
+     */
+    abstract cancelMute(): void | Promise<void>;
+    /**
+     * 静音数字人
+     */
+    abstract muteHuman(): void | Promise<void>;
+    /**
+     * 恢复播放
+     */
+    abstract play(): void | Promise<void>;
+    /**
+     * 暂停播放
+     */
+    abstract pause(): void | Promise<void>;
     protected abstract checkIsReady(): boolean;
 }

package/dist/libs/aaas-pilot-kit/src/lib/service/digital-human/CloudDigitalHumanService.d.ts

@@ -72,6 +72,18 @@ export declare class CloudDigitalHumanService extends BaseDigitalHumanService {
     bindEvents: () => this;
     unbindEvents: () => this;
     cancelMute: () => void;
+    /**
+     * 静音数字人
+     */
+    muteHuman: () => void;
+    /**
+     * 恢复播放
+     */
+    play: () => Promise<void>;
+    /**
+     * 暂停播放
+     */
+    pause: () => void;
     renderPlainText: (text: string) => this;
     renderStreamText: (text: string, hasEnded?: boolean) => this;
     interrupt: () => this;

package/dist/libs/aaas-pilot-kit/src/lib/service/digital-human/CloudNativeDigitalHumanService.d.ts

@@ -0,0 +1,134 @@
+/**
+ * @file 数字人服务 - npm 包方式实现（标准化实现，适用于移动端）
+ * @description 使用 @bddh/starling-realtime-client 直接集成数字人服务，规避移动端点击限制
+ */
+import { BaseDigitalHumanService } from './BaseDigitalHumanService';
+export declare class CloudNativeDigitalHumanService extends BaseDigitalHumanService {
+    /**
+     * SDK 实例
+     */
+    private humanInstance;
+    /**
+     * 当前请求 ID
+     * - textRender: 每次调用生成新的 requestId
+     * - textStreamRender: 同一轮流式渲染使用相同的 requestId
+     */
+    private requestId;
+    /**
+     * WebSocket 是否已连接
+     */
+    private isWSConnected;
+    /**
+     * RTC 视频流是否就绪
+     */
+    private isRtcReady;
+    /**
+     * 是否正在进行流式文本渲染
+     */
+    private isStreamTextRendering;
+    /**
+     * WebSocket 连接关闭次数计数器
+     * （用于检测重连失败）
+     */
+    private wsClosedCount;
+    /**
+     * 服务是否就绪
+     */
+    get ready(): boolean;
+    /**
+     * 挂载数字人到指定容器
+     * @param $container - 容器元素
+     */
+    mount: ($container?: HTMLElement) => Promise<void>;
+    /**
+     * 绑定事件监听
+     * @description SDK 内部自动处理，无需手动绑定
+     */
+    bindEvents: () => this;
+    /**
+     * 解绑事件监听
+     * @description SDK 内部自动处理，无需手动解绑
+     */
+    unbindEvents: () => this;
+    /**
+     * 整段文本驱动
+     * @param text - 播报文本（支持 SSML）
+     */
+    renderPlainText: (text: string) => this;
+    /**
+     * 流式文本驱动
+     * @param text - 播报文本片段
+     * @param hasEnded - 是否为最后一段
+     */
+    renderStreamText: (text: string, hasEnded?: boolean) => this;
+    /**
+     * 打断当前播报
+     */
+    interrupt: () => this;
+    /**
+     * 发送静默消息（不播报）
+     */
+    sendSilenceMessage: () => this;
+    /**
+     * 销毁数字人实例
+     */
+    dispose: () => this;
+    /**
+     * 获取当前 requestId
+     */
+    GetRequestId: () => string;
+    /**
+     * 检查服务是否就绪
+     */
+    checkIsReady: () => boolean;
+    /**
+     * 取消静音
+     */
+    cancelMute: () => Promise<void>;
+    /**
+     * 静音数字人
+     */
+    muteHuman: () => void;
+    /**
+     * 恢复播放
+     */
+    play: () => Promise<void>;
+    /**
+     * 暂停播放
+     */
+    pause: () => void;
+    /**
+     * 构造连接参数
+     */
+    private readonly buildConnectParams;
+    /**
+     * 构造渲染参数
+     */
+    private readonly buildRenderParams;
+    /**
+     * 刷新 requestId
+     */
+    private readonly refreshRequestId;
+    /**
+     * 播报完成的统一处理
+     */
+    private readonly onRenderFinished;
+    /**
+     * 数字人回调处理
+     * @description SDK 主回调函数，处理各种状态消息
+     */
+    private readonly onDigitalHumanCallback;
+    /**
+     * 处理状态消息
+     */
+    private readonly handleStatusMessage;
+    /**
+     * 处理文本渲染相关的回调消息
+     * @description 通用回调，适用于 textRender 和 textStreamRender
+     */
+    private readonly handleTextRenderCallback;
+    /**
+     * 错误处理
+     */
+    private readonly handleError;
+}

package/dist/libs/aaas-pilot-kit/src/lib/service/digital-human/PictureClientDigitalHumanService.d.ts

@@ -72,6 +72,24 @@ export declare class PictureClientDigitalHumanService extends BaseDigitalHumanSe
     dispose: () => this;
     GetRequestId: () => string;
     checkIsReady: () => boolean;
+    /**
+     * 取消静音
+     * @description PictureClient SDK 不支持静音控制,此方法为空实现
+     */
+    cancelMute: () => void;
+    /**
+     * 静音数字人
+     * @description PictureClient SDK 不支持静音控制,此方法为空实现
+     */
+    muteHuman: () => void;
+    /**
+     * 恢复播放
+     */
+    play: () => Promise<void>;
+    /**
+     * 暂停播放
+     */
+    pause: () => Promise<void>;
     private readonly loadPictureClient;
     private readonly refreshRequestId;
     private readonly setupWebSocketProxy;

package/dist/libs/aaas-pilot-kit/src/lib/service/rtc-asr/asr/baseAsrService.d.ts

@@ -2,6 +2,7 @@ import Emittery from 'emittery';
 import type { IResolvedOptions } from '../../../../types/config';
 import type { BaseSignalingService } from '../signal/base';
 import { ErrorManager } from '../../../error';
+import { type AudioDeviceCheckResult, type AudioDetectorOptions } from '../../../utils/AudioDeviceDetector';
 export declare namespace NBaseAsrService {
     enum EMessageType {
         Query = 0,
@@ -35,6 +36,7 @@ export declare namespace NBaseAsrService {
     }
     interface IMessageEventPayload extends IMessageProtocol, IEventWithSessionIdPayload {
     }
+    type IDeviceCheckCompletedPayload = AudioDeviceCheckResult;
     interface IEmitter {
         start: IStartEventPayload;
         stop: IStopEventPayload;
@@ -44,9 +46,10 @@ export declare namespace NBaseAsrService {
         user_leaving_room: IUserEventPayload;
         media_state_changed: IMediaStateEventPayload;
         silence: ISilenceEventPayload;
+        device_check_completed: IDeviceCheckCompletedPayload;
     }
 }
-export declare abstract class BaseAsrService<E = NBaseAsrService.IEmitter> {
+export declare abstract class BaseAsrService<E extends NBaseAsrService.IEmitter = NBaseAsrService.IEmitter> {
     readonly opts: IResolvedOptions;
     readonly signalingService: BaseSignalingService;
     readonly errorManager: ErrorManager;
@@ -55,6 +58,9 @@ export declare abstract class BaseAsrService<E = NBaseAsrService.IEmitter> {
     muted: boolean;
     readonly emitter: Emittery<E, E & import("emittery").OmnipresentEventData, import("emittery").DatalessEventNames<E>>;
     protected started: boolean;
+    private lastCheckResult;
+    private lastCheckTime;
+    private readonly CHECK_CACHE_TTL;
     constructor(opts: IResolvedOptions, signalingService: BaseSignalingService, errorManager: ErrorManager);
     get sessionId(): string | null;
     mute: (muted: boolean) => void;
@@ -69,10 +75,39 @@ export declare abstract class BaseAsrService<E = NBaseAsrService.IEmitter> {
     tryUnmuteAsr: () => boolean;
     disable: () => void;
     enable: () => void;
+    /**
+     * 检查音频设备可用性
+     *
+     * 🎙️ 执行 4 层渐进式检测：
+     *   - Level 1: API 支持检查 (MediaDevices API)
+     *   - Level 2: 设备枚举 (enumerateDevices)
+     *   - Level 3: 权限状态查询 (Permissions API, Safari 可能不支持)
+     *   - Level 4: 实际流获取 (getUserMedia + 轨道状态检查)
+     *
+     * 🚀 性能优化：5 秒内缓存结果，避免重复检测
+     *
+     * @param options 检测配置选项
+     * @returns 检测结果
+     *
+     * @example
+     * ```typescript
+     * const result = await asrService.checkAudioDevice();
+     * if (result.available) {
+     *     console.log('设备可用，通过层级:', result.passedLevel);
+     * } else {
+     *     console.error('设备不可用:', result.error, result.message);
+     * }
+     * ```
+     */
+    checkAudioDevice: (options?: AudioDetectorOptions & {
+        forceCheck?: boolean;
+    }) => Promise<AudioDeviceCheckResult>;
     protected readonly _stop: () => Promise<void>;
     protected readonly _dispose: () => void;
-    protected readonly _ensureMicPermission: () => Promise<void>;
-    private readonly _ensureMicPermissionPolyfill;
+    /**
+     * 将 AudioDeviceError 映射为对应的 AsrError
+     */
+    private readonly mapToAsrError;
     abstract preloadDeps(): Promise<void>;
     abstract start(): Promise<void>;
     abstract stop(): Promise<void>;

package/dist/libs/aaas-pilot-kit/src/lib/service/rtc-asr/asr/brtcAsrService.d.ts

@@ -1,3 +1,4 @@
+import 'baidurtc';
 import { BaseAsrService, NBaseAsrService } from './baseAsrService';
 import { NBRTCSignalingService } from '../signal/brtc';
 declare global {
@@ -22,11 +23,10 @@ export declare namespace NBRTCAsrService {
 }
 export declare class BRTCAsrService extends BaseAsrService {
     private static readonly MESSAGE_INTERVAL_THRESHOLD;
-    private brtcLoadPromise;
     private silenceTimer;
     private lastMessageTime;
     private messageIntervalTimer;
-    preloadDeps(src?: string): Promise<void>;
+    preloadDeps(): Promise<void>;
     start: () => Promise<void>;
     stop: () => Promise<void>;
     dispose: () => void;