Integre Qwen-Audio-TTS / CosyVoice ao SDK do Flutter. Consulte a sequência de chamadas Dart, os parâmetros da solicitação e os eventos.
Qwen-Audio-TTS e CosyVoice compartilham as mesmas APIs de síntese bidirecional. O aplicativo pode enviar trechos de texto enquanto recebe o áudio sintetizado.
Abra Seleção e download do SDK móvel de voz, selecione a guia Flutter e baixe e extraia o pacote.
Copie o diretório extraído do SDK para
Execute
Chame estes métodos na instância retornada por
O exemplo usa um modelo incluído no pacote. Para outras configurações, consulte
Passe o JSON de conexão como
Passe o JSON do exemplo como string ao método Dart.
Escolha uma
Nos métodos que retornam
Leia os eventos em
Pré-requisitos
- Configure o ambiente de desenvolvimento Flutter para a plataforma de destino. O aplicativo de exemplo requer Dart 3.4 ou posterior, abaixo de 4.0.
- Obtenha uma chave de API. Selecione um endpoint de serviço na mesma região da chave de API. Se usar um domínio específico do espaço de trabalho, obtenha também o ID do espaço de trabalho.
Instalar o SDK
Abra Seleção e download do SDK móvel de voz, selecione a guia Flutter e baixe e extraia o pacote.
Copie o diretório extraído do SDK para packages/aliyun_neonui no projeto Flutter e adicione a dependência local ao pubspec.yaml.
flutter pub get e importe o SDK no arquivo Dart.
Início rápido
Execute o aplicativo de exemplo
-
Conecte o dispositivo de destino. Execute estes comandos no diretório do SDK extraído.
- Na tela inicial do aplicativo de exemplo, abra 百炼(DashScope). Selecione um endpoint de serviço e informe a API Key. Se usar um domínio específico do espaço de trabalho, informe também o WorkspaceId.
- Abra Qwen-Audio-TTS/CosyVoice 双向流式语音合成 e execute o exemplo.
example/lib/pages/dashscope/dash_cosy_voice_stream_tts_page.dart no pacote do SDK.
Modelos incluídos no exemplo
qwen-audio-3.1-tts-flashqwen-audio-3.1-tts-plusqwen-audio-3.0-tts-flashqwen-audio-3.0-tts-pluscosyvoice-v3-flashcosyvoice-v3-plus
Sequência de chamadas
Chame estes métodos na instância retornada por NativeNui().
-
Assine
streamTtsEventStreamestreamTtsAudioStreamantes de chamar os métodos. -
Use o JSON de conexão e o JSON da tarefa abaixo como
ticketJsoneparamsJson.Depois de iniciar a síntese, envie o texto em trechos e reproduza o áudio recebido pelo fluxo. -
Encerre a entrada de texto com
streamTtsStop. Após o evento de conclusão da síntese, chamestreamTtsRelease.
Parâmetros de solicitação
O exemplo usa um modelo incluído no pacote. Para outras configurações, consulte example/lib/dashscope_params.dart. Para mais detalhes sobre os parâmetros, consulte Android SDK, iOS SDK, HarmonyOS SDK.
Substitua YOUR_WS_HOST pelo host WebSocket da região, YOUR_DEVICE_ID pelo ID do dispositivo e YOUR_API_KEY por uma chave de API da mesma região.
Parâmetros de conexão
Passe o JSON de conexão como ticket.
Parâmetros da tarefa
Passe o JSON do exemplo como string ao método Dart.
voice compatível com o model. format e sample_rate definem o formato e a taxa de amostragem da saída. O exemplo ativa enable_audio_decoder para MP3 ou Opus.
Referência da API
Métodos
Nos métodos que retornam Future<int>, o código 0 indica êxito.
| Assinatura do método | Finalidade |
|---|---|
Future<int> streamTtsStart({required String ticket, required String params, String sessionId = "", int logLevel = 0, bool saveLog = false}) | Cria uma sessão de síntese em streaming. Passe ticket e params como strings JSON separadas. |
Future<int> streamTtsSend(String text) | Envia o próximo trecho de texto. |
Future<int> streamTtsStop({bool flagAsync = true}) | Encerra a entrada de texto. O valor padrão de flagAsync é true, para encerramento assíncrono. |
Future<int> streamTtsAsyncPlay({required String ticket, required String params, required String text, String sessionId = "", int logLevel = 0, bool saveLog = false}) | Envia o texto completo em uma chamada e recebe o resultado de forma assíncrona. |
Future<int> streamTtsCancel() | Cancela a sessão ou tarefa de síntese atual. |
Future<int> streamTtsRelease() | Libera os recursos do SDK. |
Eventos e fluxos de áudio
Leia os eventos em streamTtsEventStream. Quando um evento chega como um mapa Dart, leia o nome em event e consulte resultCode para identificar erros na tarefa.
O fluxo streamTtsAudioStream fornece blocos de áudio para reprodução pelo aplicativo.
| Evento | Finalidade |
|---|---|
STREAM_INPUT_TTS_EVENT_SYNTHESIS_STARTED | Início da síntese ou do áudio da resposta |
STREAM_INPUT_TTS_EVENT_SENTENCE_SYNTHESIS | Evento de síntese no nível da frase |
STREAM_INPUT_TTS_EVENT_SYNTHESIS_COMPLETE | Conclusão da tarefa ou da saída de áudio atual |
STREAM_INPUT_TTS_EVENT_TASK_FAILED | Falha na tarefa |