Integra Sambert con el SDK de Flutter. Consulta la secuencia de llamadas en Dart, los parámetros de la solicitud y los eventos.
Sambert usa streaming unidireccional. La aplicación envía todo el texto y recibe el audio sintetizado en bloques.
Abra Selección y descarga del SDK móvil de voz, seleccione la pestaña Flutter y descargue y extraiga el paquete.
Copie el directorio extraído del SDK a
Ejecute
Llama a estos métodos en la instancia que devuelve
Este ejemplo usa un modelo incluido en el paquete. Consulta
Pasa el JSON del ejemplo como cadena al método de Dart.
Define cada parámetro de la tarea con
En Sambert,
En los métodos que devuelven
Lee los eventos desde
Requisitos previos
- Configure un entorno de desarrollo de Flutter para la plataforma de destino. La aplicación de ejemplo requiere Dart 3.4 o posterior, con una versión inferior a 4.0.
- Obtenga una clave de API. Seleccione un punto de conexión en la misma región que la clave de API. Si usa un dominio específico del espacio de trabajo, obtenga también el ID del espacio de trabajo.
Instalar el SDK
Abra Selección y descarga del SDK móvil de voz, seleccione la pestaña Flutter y descargue y extraiga el paquete.
Copie el directorio extraído del SDK a packages/aliyun_neonui en el proyecto de Flutter y agregue la dependencia local en pubspec.yaml.
flutter pub get y luego importe el SDK en el archivo Dart.
Inicio rápido
Ejecutar la aplicación de ejemplo
-
Conecte el dispositivo de destino. Ejecute estos comandos desde el directorio extraído del SDK.
- En la pantalla de inicio de la aplicación de ejemplo, abra 百炼(DashScope). Seleccione un punto de conexión e introduzca su API Key. Si usa un dominio específico del espacio de trabajo, introduzca también el WorkspaceId.
- Abre Sambert 单向流式语音合成 y ejecuta el ejemplo.
example/lib/pages/dashscope/dash_sambert_tts_page.dart dentro del paquete del SDK.
Modelos incluidos en el ejemplo
sambert-zhinan-v1
Orden de las llamadas
Llama a estos métodos en la instancia que devuelve NativeNui().
-
Suscríbete a
ttsEventStreamyttsAudioStreamantes de llamar a los métodos. -
Usa el JSON de conexión de abajo como
initJson. Pasa los parámetros de la tarea attsSetParamcomo pares de clave y valor.Tras inicializar el SDK, configura los parámetros de la tarea de uno en uno. Envía el texto completo conttsStarty lee el audio en el flujo. -
El evento
TTS_EVENT_ENDindica que el SDK ha terminado de enviar el audio. Cuando termines, llama attsRelease.
Parámetros de solicitud
Este ejemplo usa un modelo incluido en el paquete. Consulta example/lib/dashscope_params.dart para otras opciones de configuración.
Sustituye YOUR_WS_HOST por el host WebSocket de tu región, YOUR_DEVICE_ID por un identificador de dispositivo y YOUR_API_KEY por una clave de API de esa región.
Parámetros de conexión
Pasa el JSON del ejemplo como cadena al método de Dart.
Parámetros de la tarea
Define cada parámetro de la tarea con ttsSetParam(key, value). Pasa los valores numéricos como cadenas, tal como se muestra en el ejemplo.
model selecciona el ID del modelo asociado a la voz. El ejemplo usa una voz de 48 kHz del paquete. Reproduce el audio a la misma frecuencia.
Referencia de la API
Métodos
En los métodos que devuelven Future<int>, el código 0 indica éxito.
| Firma del método | Finalidad |
|---|---|
Future<int> ttsInitialize({required String params, int logLevel = 0, bool saveLog = false}) | Inicializa el SDK con los parámetros de conexión como cadena JSON. |
Future<int> ttsSetParam(String key, String value) | Define un parámetro de la tarea como cadena. |
Future<int> ttsStart({required String priority, required String taskId, required String text}) | Envía el texto completo. El ejemplo usa priority: '1' y taskId: ''. |
Future<int> ttsPause() | Pausa la síntesis. |
Future<int> ttsResume() | Reanuda la síntesis. |
Future<int> ttsCancel(String taskId) | Cancela la síntesis mediante el ID de tarea. |
Future<String?> ttsGetParam(String key) | Lee un parámetro. Usa error_msg para consultar los detalles del error. |
Future<int> ttsRelease() | Libera los recursos del SDK. |
Eventos y flujos de audio
Lee los eventos desde ttsEventStream. Si un evento se entrega como mapa de Dart, lee su nombre desde event y consulta resultCode para ver los errores.
El flujo ttsAudioStream proporciona bloques de audio para que la aplicación los reproduzca.
| Evento | Finalidad |
|---|---|
TTS_EVENT_START | Inicio de la síntesis o del audio de respuesta |
TTS_EVENT_END | Finalización de la tarea o de la salida de audio actual |
TTS_EVENT_CANCEL | Cancelación de la tarea |
TTS_EVENT_ERROR | Error de la tarea |