package cn.iocoder.byzs.module.ai.service.tts;

import cn.iocoder.byzs.framework.common.pojo.PageResult;
import cn.iocoder.byzs.module.ai.controller.admin.tts.vo.AiTtsPageReqVO;
import cn.iocoder.byzs.module.ai.controller.admin.tts.vo.AiTtsSaveReqVO;
import cn.iocoder.byzs.module.ai.dal.dataobject.tts.AiTtsDO;
import jakarta.validation.Valid;

import java.util.List;

/**
 * AI TTS文转音 Service 接口
 *
 * @author lyb
 */
public interface AiTtsService {

    /**
     * 创建AI TTS文转音
     *
     * @param createReqVO 创建信息
     * @return 编号
     */
    Long createTts(@Valid AiTtsSaveReqVO createReqVO);

    /**
     * 更新AI TTS文转音
     *
     * @param updateReqVO 更新信息
     */
    void updateTts(@Valid AiTtsSaveReqVO updateReqVO);

    /**
     * 删除AI TTS文转音
     *
     * @param id 编号
     */
    void deleteTts(Long id);

    /**
    * 批量删除AI TTS文转音
    *
    * @param ids 编号
    */
    void deleteTtsListByIds(List<Long> ids);

    /**
     * 获得AI TTS文转音
     *
     * @param id 编号
     * @return AI TTS文转音
     */
    AiTtsDO getTts(Long id);

    /**
     * 获得AI TTS文转音分页
     *
     * @param pageReqVO 分页查询
     * @return AI TTS文转音分页
     */
    PageResult<AiTtsDO> getTtsPage(AiTtsPageReqVO pageReqVO);

    /**
     * 获得AI TTS文转音精简列表，用于前端的选择框
     *
     * @param status 状态
     * @return AI TTS文转音精简列表
     */
    List<AiTtsDO> getTtsSimpleListByStatus(Integer status);

    /**
     * 文本转语音（带语音指令）
     *
     * @param roleId 角色编号
     * @param content 需要转语音的内容
     * @param command 命令(语音指令)
     * @return 语音文件URL
     */
    String convertTextToSpeech(Long roleId, String content, String command);

}