Esta seção descreve os processos de autenticação, configuração de mídia, estabelecimento da conexão e processamento de eventos de tarefa para acessar o Qwen-Audio-TTS pelo AOQ.
Ao acessar o Qwen-Audio-TTS pelo AOQ, o cliente envia texto e eventos de tarefa pela trilha Data e recebe fala sintetizada pela trilha Audio.
Defina a variável de ambiente
Ao usar Token Plan, o
Use
Aguarde
Serialize o JSON a seguir em UTF-8, grave-o em
Leia
O SDK recebe e reproduz a fala pela trilha Audio.
Depois de enviar todo o texto, envie
Quando não precisar mais da conexão, aguarde a reprodução do áudio recebido terminar. Em seguida, chame
Pré-requisitos
- Selecione um modelo compatível com AOQ. O suporte a protocolos de
qwen-audio-3.1-tts-plus,qwen-audio-3.1-tts-flash,qwen-audio-3.0-tts-pluseqwen-audio-3.0-tts-flashestá em Modelos e protocolos compatíveis. - Configure a chave de API no AppServer da aplicação, usando a região e o workspace correspondentes à chamada.
- Importe o SDK do AOQ da sua plataforma em Download do SDK. Os exemplos a seguir usam Android Java e transmissão Opus; importe também o plug-in Opus. A síntese de texto em fala não exige permissões para microfone ou câmera.
1. Obter as credenciais de conexão
Para obter um token antecipadamente ou consultar o fluxo completo de autenticação, veja os detalhes da autenticação de conexão.
DASHSCOPE_API_KEY no AppServer e substitua {endpoint} pelo domínio de acesso da região e do workspace selecionados. O Qwen-Audio-TTS usa o caminho de conexão Inference. O exemplo a seguir usa qwen-audio-3.0-tts-flash.
WorkspaceId no domínio de acesso é fixado em token-plan. clientIp no corpo da solicitação é opcional: informe o IP público real do cliente para que o gateway selecione um ponto de acesso Relay. Se for omitido, o gateway usará o IP de origem da solicitação.
A chave de API é armazenada somente no AppServer. O AppServer retorna ao cliente os parâmetros de conexão da tabela abaixo. sidExpiresInSecs na resposta indica a validade da sessão, em segundos.
| Campos da resposta do gateway | Campo de AoqConnectConfig |
|---|---|
aoqTokenForClient | token |
sid | sid |
clientRelayCertFingerprint | certFingerprint |
clientRelayEndpoints | relayEndpoints, converta endpoint, port e route_index de cada elemento |
extraInfo.workspaceIdHash | workspaceIdHash |
2. Inicializar o SDK e conectar
Use AoqCreateConfig para definir o diretório de trabalho do SDK e chame AoqClientEngine.createEngine para criar o mecanismo e registrar os callbacks. Trate o estado da conexão em onConnectionStatusChange, analise os eventos do modelo em onDataMsg e trate os erros do SDK em onError. O SDK para Android fornece as interfaces completas de inicialização do mecanismo e dos campos de conexão.
Depois de preencher connectConfig com as credenciais retornadas pelo AppServer, publique a trilha Data e assine as trilhas Audio e Data. O exemplo configura a decodificação Opus mono de 24 kHz e inicia o player. O formato de saída do modelo é definido pelo evento da tarefa; a configuração de decodificação do SDK se aplica à transmissão pela trilha de mídia.
onConnectionStatusChange retornar AoqConnectionStatusConnected antes de iniciar a tarefa. Em caso de falha na conexão, limpe o estado local da tarefa. Para restabelecer a conexão, obtenha novas credenciais.
3. Iniciar a tarefa de síntese e processar eventos
Serialize o JSON a seguir em UTF-8, grave-o em AoqDataMsg.data e envie-o pela trilha Data usando sendDataMsg. Gere um novo task_id para cada tarefa; todos os eventos desta rodada usam o mesmo valor. Use uma voz compatível com o modelo selecionado.
header.event em onDataMsg. Ao receber task-started, envie um ou mais eventos continue-task para fornecer o texto.
result-generated é um evento da tarefa na trilha Data, enquanto o áudio é transmitido pela trilha Audio. Ao receber task-failed, leia header.error_code e header.error_message e encerre a tarefa atual.
Os parâmetros de tarefa e os campos de eventos estão em Eventos do cliente e Eventos do servidor.
4. Encerrar a tarefa e liberar os recursos
Depois de enviar todo o texto, envie finish-task. Mantenha a conexão aberta e aguarde o servidor sintetizar o texto restante e retornar task-finished.
stopAudioPlayer, disconnect e AoqClientEngine.destroy, nessa ordem, para liberar os recursos.