89 lines
2.3 KiB
C
89 lines
2.3 KiB
C
|
//
|
|||
|
|
// ConversationOrchestrator.h
|
|||
|
|
// keyBoard
|
|||
|
|
//
|
|||
|
|
// Created by Mac on 2026/1/15.
|
|||
|
|
//
|
|||
|
|
|
|||
|
|
#import <Foundation/Foundation.h>
|
|||
|
|
|
|||
|
|
NS_ASSUME_NONNULL_BEGIN
|
|||
|
|
|
|||
|
|
/// 对话状态
|
|||
|
|
typedef NS_ENUM(NSInteger, ConversationState) {
|
|||
|
|
ConversationStateIdle = 0, // 空闲
|
|||
|
|
ConversationStateListening, // 正在录音
|
|||
|
|
ConversationStateRecognizing, // 正在识别（等待 ASR 结果）
|
|||
|
|
ConversationStateThinking, // 正在思考（等待 LLM 回复）
|
|||
|
|
ConversationStateSpeaking // 正在播报 TTS
|
|||
|
|
};
|
|||
|
|
|
|||
|
|
/// 对话编排器
|
|||
|
|
/// 核心状态机，串联所有模块，处理打断逻辑
|
|||
|
|
@interface ConversationOrchestrator : NSObject
|
|||
|
|
|
|||
|
|
/// 当前状态
|
|||
|
|
@property(nonatomic, assign, readonly) ConversationState state;
|
|||
|
|
|
|||
|
|
/// 当前对话 ID
|
|||
|
|
@property(nonatomic, copy, readonly, nullable) NSString *conversationId;
|
|||
|
|
|
|||
|
|
#pragma mark - Callbacks
|
|||
|
|
|
|||
|
|
/// 用户最终识别文本回调
|
|||
|
|
@property(nonatomic, copy, nullable) void (^onUserFinalText)(NSString *text);
|
|||
|
|
|
|||
|
|
/// AI 可见文本回调（打字机效果）
|
|||
|
|
@property(nonatomic, copy, nullable) void (^onAssistantVisibleText)
|
|||
|
|
(NSString *text);
|
|||
|
|
|
|||
|
|
/// AI 完整回复文本回调
|
|||
|
|
@property(nonatomic, copy, nullable) void (^onAssistantFullText)(NSString *text)
|
|||
|
|
;
|
|||
|
|
|
|||
|
|
/// 实时识别文本回调（部分结果）
|
|||
|
|
@property(nonatomic, copy, nullable) void (^onPartialText)(NSString *text);
|
|||
|
|
|
|||
|
|
/// 音量更新回调（用于波形 UI）
|
|||
|
|
@property(nonatomic, copy, nullable) void (^onVolumeUpdate)(float rms);
|
|||
|
|
|
|||
|
|
/// 状态变化回调
|
|||
|
|
@property(nonatomic, copy, nullable) void (^onStateChange)
|
|||
|
|
(ConversationState state);
|
|||
|
|
|
|||
|
|
/// 错误回调
|
|||
|
|
@property(nonatomic, copy, nullable) void (^onError)(NSError *error);
|
|||
|
|
|
|||
|
|
/// AI 开始说话回调
|
|||
|
|
@property(nonatomic, copy, nullable) void (^onSpeakingStart)(void);
|
|||
|
|
|
|||
|
|
/// AI 说话结束回调
|
|||
|
|
@property(nonatomic, copy, nullable) void (^onSpeakingEnd)(void);
|
|||
|
|
|
|||
|
|
#pragma mark - Configuration
|
|||
|
|
|
|||
|
|
/// ASR 服务器 URL
|
|||
|
|
@property(nonatomic, copy) NSString *asrServerURL;
|
|||
|
|
|
|||
|
|
/// LLM 服务器 URL
|
|||
|
|
@property(nonatomic, copy) NSString *llmServerURL;
|
|||
|
|
|
|||
|
|
/// TTS 服务器 URL
|
|||
|
|
@property(nonatomic, copy) NSString *ttsServerURL;
|
|||
|
|
|
|||
|
|
#pragma mark - User Actions
|
|||
|
|
|
|||
|
|
/// 用户按下录音按钮
|
|||
|
|
/// 如果当前正在播放，会自动打断
|
|||
|
|
- (void)userDidPressRecord;
|
|||
|
|
|
|||
|
|
/// 用户松开录音按钮
|
|||
|
|
- (void)userDidReleaseRecord;
|
|||
|
|
|
|||
|
|
/// 手动停止（退出页面等）
|
|||
|
|
- (void)stop;
|
|||
|
|
|
|||
|
|
@end
|
|||
|
|
|
|||
|
|
NS_ASSUME_NONNULL_END
|