Este tema describe las interfaces clave y los parámetros de solicitud para llamar a los modelos de la serie Qwen-TTS-Realtime con DashScope Java SDK.
Requisitos previos
Requiere DashScope Java SDK 2.22.7 o posterior.
Introducción
- Modo de confirmación del servidor
- Modo de confirmación
appendText()Parámetros de solicitud
Configure los siguientes parámetros de solicitud con los métodos de encadenamiento o setters de un objeto QwenTtsRealtimeParam, y luego pase el objeto al constructor QwenTtsRealtime.
Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
model | String | Sí | Nombre del modelo (consulte Modelos compatibles). |
url | String | Sí | China (Pekín): Singapur: |
QwenTtsRealtimeConfig, y luego pase el objeto al método updateSession.
Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
voice | String | Sí | La voz para la síntesis de voz. Para obtener más información, consulte Lista de voces de Qwen-TTS. |
languageType | String | No | Especifica el idioma del audio sintetizado. El valor predeterminado es
|
mode | String | No | El modo de interacción. Valores válidos:
|
format | String | No | El formato de la salida de audio del modelo. Formatos admitidos:
|
sampleRate | int | No | La frecuencia de muestreo de la salida de audio del modelo, en Hz. Frecuencias de muestreo admitidas:
|
speechRate | float | No | La velocidad de habla del audio. Un valor de 1.0 es la velocidad normal. Un valor menor que 1.0 es más lento y un valor mayor que 1.0 es más rápido. Valor predeterminado: 1.0. Rango válido: [0.5, 2.0]. |
volume | int | No | El volumen del audio. Rango válido: [0, 100]. |
pitchRate | float | No | El tono del audio sintetizado. Valor predeterminado: 1.0. Rango válido: [0.5, 2.0]. |
bitRate | int | No | Especifica la tasa de bits del audio en kbps. Una tasa de bits más alta resulta en una mejor calidad de audio y un tamaño de archivo mayor. Este parámetro está disponible solo cuando el formato de audio ( Valor predeterminado: 128. Rango válido: [6, 510]. |
Interfaces clave
Clase QwenTtsRealtime
Para importar:
| Método | Firma | Eventos del servidor | Descripción |
|---|---|---|---|
| connect | session.createdSesión creadasession.updated Configuración de sesión actualizada | Abre una conexión WebSocket con el servidor. | |
| updateSession | session.updatedConfiguración de sesión actualizada | Actualiza la configuración de la sesión. Consulte Parámetros de solicitud.Después de conectarse, el servidor devuelve configuraciones de entrada y salida predeterminadas para la sesión. Llame a este método inmediatamente después de connect() para anular los valores predeterminados.El servidor valida los parámetros al recibir un evento session.update. Si algún parámetro no es válido, el servidor devuelve un error. De lo contrario, actualiza la configuración de la sesión en el lado del servidor. | |
| appendText | None | Agrega un segmento de texto al búfer de entrada del lado del servidor. El búfer almacena el texto hasta que usted lo envía.
| |
| clearAppendedText | input_text_buffer.clearedBorra el texto recibido por el servidor | Borra todo el texto en el búfer de entrada del lado del servidor. | |
| commit | input_text_buffer.committedConfirma el texto y activa la síntesis de vozresponse.output_item.added Aparece nuevo contenido de salida en la respuestaresponse.content_part.added Nuevo contenido de salida agregado al elemento de mensaje del asistenteresponse.audio.delta El modelo genera audio incrementalmenteresponse.audio.done Generación de audio completadaresponse.content_part.done La transmisión del contenido de audio para el mensaje del asistente ha finalizadoresponse.output_item.done La transmisión del elemento de salida completo para el mensaje del asistente ha terminadoresponse.done Respuesta completada | Confirma el texto agregado previamente al búfer del lado del servidor y sintetiza todo el texto inmediatamente. Devuelve un error si el búfer está vacío.
| |
| finish | session.finishedRespuesta completada | Detiene la tarea actual. | |
| close | None | Cierra la conexión. | |
| getSessionId | None | Devuelve el ID de sesión de la tarea actual. | |
| getResponseId | None | Devuelve el ID de respuesta de la respuesta más reciente. | |
| getFirstAudioDelay | None | Devuelve la latencia del primer paquete de audio en milisegundos. |
Interfaz de callback (QwenTtsRealtimeCallback)
| Método | Parámetros | Valor de retorno | Descripción |
|---|---|---|---|
| None | None | Se llama inmediatamente después de establecer la conexión WebSocket. | |
| message: evento de respuesta del lado del servidor. | None | Se llama cuando el servidor envía un evento, incluidas las respuestas a llamadas de API y el audio generado por el modelo. Consulte Eventos del lado del servidor. | |
| code: Código de estado de cierre de WebSocket.reason: Motivo de cierre. | None | Llamado después de que el servidor cierra la conexión. |