AI面试朗读接口新增题目音频同步方法

src/AIService/AiInterviewTtsInterface.php

@@ -22,4 +22,26 @@ interface AiInterviewTtsInterface
      * @param int $questionId 面试题ID
      */
     public function getInterviewQuestionAudioUrl(int $questionId): ?string;
-}
+
+    /**
+     * 提交朗读任务（异步）：已生成直接返回成功，未生成投递队列后台合成并返回排队状态
+     * 音频按题目(question_id)生成并全局复用，同一题目并发只合成一次
+     * @param array $params 参数，['question_id'=>面试题ID]
+     */
+    public function submitInterviewTts(array $params): array;
+
+    /**
+     * 同步面试题音频（后台创建/编辑题目后调用）：按题干内容哈希判断是否已生成，
+     * 内容未变跳过，内容变化或首次生成则投递队列后台合成
+     * @param array $params 参数，['question_id'=>面试题ID, 'content'=>题干内容]
+     * 返回 ['question_id'=>int, 'status'=>success|queued]
+     */
+    public function syncInterviewQuestionTts(array $params): array;
+
+    /**
+     * 查询朗读任务状态（供前端轮询使用）
+     * @param int $questionId 面试题ID
+     * 返回 ['question_id'=>int, 'status'=>queued|processing|success|failed|unknown, 'url'=>?string]
+     */
+    public function getInterviewTtsStatus(int $questionId): array;
+}