Skip to main content

Sambert Flutter SDK

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.

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.
No incluya claves de API de larga duración en el código de una aplicación móvil. En los modelos que admiten claves de API temporales, use el servidor de la aplicación para generar una clave de API temporal y enviarla al cliente.

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.
dependencies:
  aliyun_neonui:
    path: packages/aliyun_neonui
Ejecute flutter pub get y luego importe el SDK en el archivo Dart.
import 'package:aliyun_neonui/neonui.dart';

Inicio rápido

Ejecutar la aplicación de ejemplo

  1. Conecte el dispositivo de destino. Ejecute estos comandos desde el directorio extraído del SDK.
    cd example
    flutter pub get
    flutter run
    
  2. 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.
  3. Abre Sambert 单向流式语音合成 y ejecuta el ejemplo.
El código completo está en 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().
  1. Suscríbete a ttsEventStream y ttsAudioStream antes de llamar a los métodos.
  2. Usa el JSON de conexión de abajo como initJson. Pasa los parámetros de la tarea a ttsSetParam como pares de clave y valor.
    await nui.ttsInitialize(params: initJson);
    for (final entry in taskParams.entries) {
      await nui.ttsSetParam(entry.key, entry.value);
    }
    await nui.ttsStart(priority: '1', taskId: '', text: '你好,欢迎使用语音合成。');
    
    Tras inicializar el SDK, configura los parámetros de la tarea de uno en uno. Envía el texto completo con ttsStart y lee el audio en el flujo.
  3. El evento TTS_EVENT_END indica que el SDK ha terminado de enviar el audio. Cuando termines, llama a ttsRelease.

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.
{
  "url": "wss://YOUR_WS_HOST/api-ws/v1/inference",
  "device_id": "YOUR_DEVICE_ID",
  "mode_type": "2"
}

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.
{
  "apikey": "YOUR_API_KEY",
  "model": "sambert-zhinan-v1",
  "format": "pcm",
  "enable_audio_decoder": "0",
  "sample_rate": "48000",
  "volume": "50",
  "rate": "1.0",
  "pitch": "1.0"
}
En Sambert, 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étodoFinalidad
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.
EventoFinalidad
TTS_EVENT_STARTInicio de la síntesis o del audio de respuesta
TTS_EVENT_ENDFinalización de la tarea o de la salida de audio actual
TTS_EVENT_CANCELCancelación de la tarea
TTS_EVENT_ERRORError de la tarea