Alibaba Cloud Model Studio:Qwen-Audio-ASR-Message SDK de iOS para reconocimiento de voz en tiempo real

url

String

Sí

Dirección del servicio:

• wss://dashscope.aliyuncs.com/api-ws/v1/inference

• China (Pekín): wss://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api-ws/v1/inference

• Singapur: wss://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api-ws/v1/inference

Reemplace {WorkspaceId} con su ID de espacio de trabajo real.

apikey

String

Sí

Clave de API.

service_mode

String

Sí

Modo de ejecución. Fijado en "1" para reconocimiento de voz en tiempo real.

device_id

String

Sí

Una cadena única que identifica al usuario final. Puede configurarla como un ID de usuario dentro de la aplicación o un identificador de dispositivo generado en el cliente. Este ID se utiliza principalmente para el rastreo de registros y la solución de problemas.

audio_update_manually

String

No

Indica si se habilita el envío activo de datos de audio. Valor predeterminado: "false".

Si se establece en "true" y la versión del SDK admite capacidades de procesamiento de audio en el dispositivo, como AEC o VAD, dichas capacidades se habilitan de forma predeterminada.

workspace

String

No

La ruta donde se almacenan los archivos de recursos en el dispositivo. Este parámetro es obligatorio cuando audio_update_manually se establece en "true" y está habilitada una capacidad de procesamiento de audio en el dispositivo, como AEC o VAD.

debug_path

String

No

Ruta de almacenamiento para el archivo de registro.

Este parámetro solo surte efecto cuando save_log se establece en YES en la API nui_initialize. En ese caso, debe establecer la ruta del archivo de registro; de lo contrario, se producirá un error.

Se conservan como máximo dos archivos de registro localmente.

save_wav

String

No

Indica si se debe guardar un archivo de audio para depuración. El archivo de audio se guarda en debug_path.

Valor predeterminado: "false".

Valores válidos:

• "true": guarda el archivo.

• "false": no guarda el archivo.

Este parámetro solo surte efecto cuando save_log se establece en true en la API nui_initialize. Además, también debe establecerse debug_path.

max_log_file_size

int

No

Tamaño máximo del archivo de registro, en bytes.

Este parámetro solo surte efecto cuando save_log se establece en YES en la API nui_initialize.

Predeterminado: 104857600 (100 * 1024 * 1024 bytes, es decir, 100 MiB).

log_track_level

int

No

Nivel de filtro para el contenido de registro enviado a través de la devolución de llamada de registro (onNuiLogTrackCallback).

Predeterminado: 2.

Valores válidos:

• 0: LOG_LEVEL_VERBOSE

• 1: LOG_LEVEL_DEBUG

• 2: LOG_LEVEL_INFO

• 3: LOG_LEVEL_WARNING

• 4: LOG_LEVEL_ERROR

• 5: LOG_LEVEL_NONE (deshabilita esta función)

Nota: log_track_level y level (establecido a través de la API nui_initialize) determinan conjuntamente qué registros se envían finalmente a la devolución de llamada. Un registro se envía a la devolución de llamada solo cuando su valor de nivel es mayor o igual tanto a log_track_level como a level. Por ejemplo, si log_track_level se establece en 2 (INFO) y level se establece en 3 (WARNING), entonces solo los registros de nivel WARNING o superior (valor >= 3) se envían a la devolución de llamada.

service_type

int

Sí

Tipo de servicio de voz. Fijado en 4 para reconocimiento de voz en tiempo real.

nls_config

object

Sí

El objeto de configuración de reconocimiento principal. Contiene parámetros clave como la selección del modelo y los controles de calidad del reconocimiento.

nls_config.model

string

Sí

El nombre del modelo. Establézcalo en qwen-audio-3.1-asr-flash-message.

nls_config.sr_format

string

Sí

El formato de audio.

Valores válidos:

• pcm
• opus

nls_config.sample_rate

int

Sí

La frecuencia de muestreo, en Hz.

Solo se admite 16000 Hz.

nls_config.language_hints

array[string]

No

El idioma del audio a reconocer. No hay valor predeterminado; si no se establece, el modelo detecta el idioma automáticamente.

Puede configurar hasta 4 valores. Si configura más, solo los primeros 4 surten efecto.

Este parámetro solo se aplica a los resultados finales (sentence_end=true) y no es compatible con los resultados intermedios (sentence_end=false).

nls_config.keep_dialect

boolean

No

Especifica si se conservan las expresiones dialectales. Valor predeterminado: false. Establezca el valor en false para transcribir el habla dialectal como texto en mandarín estándar, o en true para conservar las expresiones dialectales.

nls_config.vad_model

string

No

El modelo VAD. Valor predeterminado: far_field_meeting_16k.

• near_meeting_16k: escenarios de campo cercano.
• far_field_meeting_16k: escenarios de campo lejano.

nls_config.max_sentence_silence

int

No

El umbral de silencio VAD para la segmentación, en ms. Cuando el silencio después de un segmento de voz supera este umbral, el sistema determina que la oración ha terminado.

Valor predeterminado: 800.

Valores válidos: [200, 6000].

nls_config.heartbeat

boolean

No

Si se deben habilitar los paquetes de latido.

Valor predeterminado: false.

• true: Mantiene activa la conexión con el servidor incluso cuando se envía audio silencioso de forma continua.
• false (predeterminado): Incluso cuando se envía audio silencioso de forma continua, la conexión expira y se cierra después de un período de tiempo.

El audio silencioso se refiere al contenido en un archivo de audio o flujo de datos que no contiene señal de sonido. Puede generar audio silencioso de varias maneras, como utilizando software de edición de audio como Audacity o Adobe Audition, o utilizando una herramienta de línea de comandos como FFmpeg.

nls_config.disfluency_removal_enabled

boolean

No

Indica si se deben filtrar las muletillas y pulir la salida. El valor predeterminado es false. Establézcalo en true para habilitar esta función.

nls_config.intermediate_result_enabled

boolean

No

Indica si se deben devolver resultados de transmisión intermedios. El valor predeterminado es false. Establézcalo en true para devolver resultados de transmisión intermedios.

nls_config.vocabulary_id

string

No

El ID de una lista de palabras clave precompilada.

Genere este ID con antelación llamando a la API de creación de lista de palabras clave. Pase el ID durante el reconocimiento para usar las palabras clave de la lista.

Adecuado para escenarios donde el vocabulario es conocido y relativamente estable, y donde necesita reutilizar la misma lista de palabras en distintas solicitudes.

Para obtener detalles sobre el uso, consulte Palabras clave precompiladas.

nls_config.instant_vocabulary

object

No

Palabras clave instantáneas.

Se pasan como pares clave-valor, donde la clave es el texto de la palabra clave (string) y el valor es el peso de la palabra clave (integer). No es necesario crear una lista de palabras clave con antelación. El peso oscila entre [1, 5] o se establece en 50: un valor en [1, 5] hace que el modelo tenga más probabilidades de generar la palabra a medida que aumenta el valor; un valor de 50 designa una súper palabra clave, lo que mejora enormemente la recuperación, pero el número de súper palabras clave no puede exceder 50.

Adecuado para la optimización temporal de palabras clave a nivel de sesión.

Cuando se configuran conjuntamente palabras clave instantáneas y precompiladas, el sistema fusiona ambos conjuntos. Si el conjunto fusionado contiene más de 2000 palabras clave, el sistema selecciona aleatoriamente 2000 para su uso. Para obtener información sobre el uso, los modelos compatibles y los límites, consulte Palabras clave instantáneas.

nls_config.speech_noise_threshold

float

No

El umbral para distinguir el habla del ruido, utilizado para ajustar la sensibilidad de la Detección de Actividad de Voz (VAD).

Valores válidos: [-1.0, 1.0].

Descripciones de valores:

• Cuanto más cerca esté el valor de -1: El umbral de ruido disminuye, por lo que es más probable que el ruido se reconozca como habla, lo que puede causar que se transcriba más ruido.
• Cuanto más cerca esté el valor de +1: El umbral de ruido aumenta, por lo que es más probable que el habla se juzgue erróneamente como ruido, lo que puede causar que se filtre parte del habla.

Este es un parámetro de configuración avanzada. Ajustarlo puede afectar significativamente los resultados del reconocimiento. Recomendaciones:

• Pruebe y verifique exhaustivamente los resultados antes de ajustar.
• Ajuste en incrementos pequeños según el entorno de audio real (se recomienda un paso de 0.1).

nls_config.enable_connection_fast_check

BOOL

No

Si se deben habilitar comprobaciones rápidas de red para que las desconexiones se notifiquen lo antes posible. Valor predeterminado: NO.

parameters

char*

Una cadena JSON que contiene parámetros de autenticación, conexión y depuración. Consulte Parámetros de conexión y control.

level

NuiSdkLogLevel

Nivel de impresión para los registros propios del SDK.

save_log

BOOL

Indica si se deben guardar los registros localmente. Si se establece en YES, especifique una ruta con debug_path en Parámetros de conexión y control y, opcionalmente, configure el tamaño del archivo con max_log_file_size.

params

char*

Parámetros de calidad de reconocimiento.

vad_mode

NuiVadMode

Modo VAD. Fijado en MODE_P2T.

dialog_params

char*

Si el parámetro apikey en Parámetros de conexión y control es una clave de API temporal, puede actualizarla aquí cuando caduque. También puede proporcionar contexto aquí para mejorar la precisión del reconocimiento mediante la mejora de contexto.

El contenido está en formato JSON:

{
  "apikey": "st-****",
  "input_context": [
    {
      "role": "user",
      "content": [
        {
          "text": "xxxxx",
          "type": "input_text"
        }
      ]
    }
  ]
}

force

BOOL

Si se debe finalizar forzosamente y descartar el resultado final.

• YES: Finaliza la tarea inmediatamente sin esperar a que el servidor devuelva el resultado final del reconocimiento.

• NO: Finaliza la tarea, pero espera a que se devuelva el resultado completo.

action_params

char*

Una cadena JSON utilizada para actualizar el contexto de reconocimiento u otro comportamiento de tiempo de ejecución.

action_params.type

String

Fijado en "action".

action_params.command

String

Comando de tiempo de ejecución. Valores válidos:

• context: Actualiza la mejora de contexto inmediatamente para mejorar la precisión del reconocimiento.

• play_start: Cuando se utiliza AEC en el dispositivo, notifica al reproductor AEC interno que la reproducción de audio ha comenzado.

• play_over: Cuando se utiliza AEC en el dispositivo, notifica al reproductor AEC interno que la reproducción de audio ha terminado.

action_params.context

String

Cuando command es "context", proporciona la mejora de contexto para actualizar inmediatamente. Ejemplo:

{
  "context": [
    {
      "role": "user",
      "content": [
        {
          "text": "xxx",
          "type": "input_text"
        }
      ]
    }
  ]
}

data

const char *

Los datos de audio a enviar.

length

int

La longitud de los datos de audio, en bytes.

first_pack

BOOL

No necesita utilizar este parámetro.

data

const char *

Los datos de audio a enviar.

length

int

La longitud de los datos de audio, en bytes.

first_pack

BOOL

No necesita utilizar este parámetro.

nuiEvent

NuiCallbackEvent

Evento de callback.

dialog

long

ID de sesión. No necesita utilizar este parámetro.

wuw

char*

Activación por voz. No necesita utilizar este parámetro.

asr_result

char*

Resultado del reconocimiento de voz.

finish

BOOL

Indica si la ronda de reconocimiento actual ha finalizado.

code

int

Código de error. Válido cuando ocurre el evento EVENT_ASR_ERROR. Consulte la Referencia de códigos de error.

STATE_OPEN

La interacción ha comenzado. Puede abrir el dispositivo de grabación e iniciar la grabación.

STATE_PAUSE

La interacción se ha detenido. Puede detener la grabación.

STATE_CLOSE

La instancia del SDK ha sido liberada. Puede cerrar el dispositivo de grabación por completo.

audioData

char *

Los datos de audio a suministrar.

len

int

El tamaño de los datos de audio suministrados, en bytes.

nuiEvent

NuiCallbackEvent

El evento de callback.

info

char *

No necesita utilizar este parámetro.

info_len

int

No necesita utilizar este parámetro.

buffer

char *

Datos auxiliares, como datos de audio después del procesamiento AEC.

len

int

La longitud de los datos auxiliares, en bytes.

EVENT_TRANSCRIBER_STARTED

La tarea se inició correctamente.

EVENT_VAD_START

Se activa justo después de que comienza la tarea. No significa que se haya detectado el inicio del habla.

EVENT_VAD_END

Se detectó el final del habla.

EVENT_ASR_PARTIAL_RESULT

Un resultado intermedio de reconocimiento de voz.

EVENT_ASR_ERROR

Ocurrió un error durante el reconocimiento de voz.

EVENT_MIC_ERROR

Activado porque no se recibieron datos de audio durante 2 segundos consecutivos.

EVENT_SENTENCE_END

Se detectó el final de una oración. Se devuelve un resultado de reconocimiento completo para la oración.

EVENT_TRANSCRIBER_COMPLETE

Reconocimiento de voz finalizado.

EVENT_AEC_DATA

Datos de audio después del procesamiento de cancelación de eco acústico (AEC).