Qwen-Audio-3.0-ASR-Flash-Filetrans/Fun-ASR gravando iOS SDK

Transcrição de arquivos iOS SDK para Qwen-Audio-3.0-ASR-Flash-Filetrans/Fun-ASR

Guia do usuário: Reconhecimento de fala em tempo não real. Para requisitos de entrada, como formatos de áudio suportados, limites de tamanho de arquivo e limites de duração, consulte Especificações de áudio.

Início rápido

1. Obtenha uma chave de API:Obtenha uma chave de API

2. Baixe o SDK e execute o código de exemplo:

   • Baixe o pacote SDK mais recente.
   • Descompacte o pacote ZIP e adicione nuisdk.framework incluído ao seu projeto.
   • Em Fases de construção → Vincular binário a bibliotecas, adicione nuisdk.xcframework.
   • Em Geral → Estruturas, Bibliotecas e Conteúdo Incorporado, defina nuisdk.xcframework para incorporar e assinar.
   • Abra o projeto de amostra no Xcode. O código de exemplo está localizado em DashFunAsrFileTranscriberViewController.m. Substitua a chave API para experimentar o recurso.

Etapas de chamada

Synchronous mode

1. Inicialize o SDK.
2. Configure os parâmetros relevantes para seu caso de uso.
3. Definir `async_request` para `false` e chame [nui\_file\_trans\_start](#nui-file-trans-start) para enviar uma solicitação de reconhecimento de fala em tempo não real e aguardar o resultado.
4. No [onFileTransEventCallback](#onfiletranseventcallback-monitor-events-and-speech-recognition-results) retorno de chamada, ouça o `EVENT_FILE_TRANS_RESULT` evento para obter o resultado final do reconhecimento.
5. Ligue para [nui\_release](#nui-release) para liberar os recursos do SDK.

Asynchronous mode

1. Inicialize o SDK.
2. Configure os parâmetros relevantes para seu caso de uso.
3. Definir `async_request` para `true` e chame [nui\_file\_trans\_start](#nui-file-trans-start) para enviar uma solicitação de reconhecimento de fala em tempo não real.
4. Chame [nui\_file\_trans\_query](#nui-file-trans-query) para consultar ativamente o progresso ou resultado do reconhecimento.
5. No [onFileTransEventCallback](#onfiletranseventcallback-monitor-events-and-speech-recognition-results) retorno de chamada, ouça o `EVENT_FILE_TRANS_QUERY_RESULT` evento para obter o resultado da consulta atual.
6. No [onFileTransEventCallback](#onfiletranseventcallback-monitor-events-and-speech-recognition-results) retorno de chamada, ouça o `EVENT_FILE_TRANS_RESULT` evento para obter o resultado final do reconhecimento.
7. Ligue para [nui\_release](#nui-release) para liberar os recursos do SDK.

Parâmetros de solicitação

Parâmetros de conexão e controle

Configure esses parâmetros passando uma string JSON no arquivo parameters argumento do nui_initialize interface.

• Parâmetros de exemplo: A seguir está um exemplo de string JSON. Nem todos os parâmetros estão listados. Adicione os que você precisa ao escrever seu código:

{
    "url": "wss://maas.qwencloudapi.com/api/v1/services/audio/asr/transcription",
    "apikey": "st-****",
    "device_id": "my_device_id",
    "service_mode": "1"
}

• Descrições dos parâmetros

Parâmetros de efeito de reconhecimento de fala

Configure todos os parâmetros de reconhecimento de fala através do nui_file_trans_start interface.

• Parâmetros de exemplo: A seguir está um exemplo de string JSON. Nem todos os parâmetros estão listados. Adicione os que você precisa ao escrever seu código:

{
    "apikey": "st-****",
    "file_urls": [
        "{YOUR_AUDIO_URL}"
    ],
    "async_request": false,
    "nls_config": {
        "model":"qwen-audio-3.0-asr-flash-filetrans",
        "diarization_enabled": false
    }
}

• Descrições dos parâmetros

Valor padrão: [0]. | | nls_config.diarization_enabled | boolean | Não | Se deve ativar a diarização do orador. Desativado por padrão. Aplica-se apenas ao áudio mono. O áudio multicanal não suporta diarização de alto-falante. Quando ativado, o resultado do reconhecimento inclui um speaker_id campo que distingue diferentes falantes. Quando a diarização do alto-falante estiver ativada, mantenha a duração do áudio em 2 horas. Caso contrário, o reconhecimento poderá falhar ou expirar.

Valor padrão: falso. Para um exemplo de speaker_id, consulte Descrição do resultado de reconhecimento. | | nls_config.speaker_count | integer | Não | Entra em vigor somente quando a diarização do alto-falante está habilitada (diarization_enabled está definido para true).

Um valor de referência para o número de alto-falantes. O intervalo válido é um número inteiro de 2 a 100 (inclusive). Por padrão, o número de alto-falantes é detectado automaticamente. Se você definir esse valor, ele apenas orientará o algoritmo para gerar a contagem especificada quando possível e não garantirá essa contagem exata. Nenhum valor padrão. | | nls_config.vocabulary_id | string | Não | O ID de uma lista de hot word pré-compilada. Gere esse ID antecipadamente chamando a API de criação de lista de palavras quentes. Passe o ID durante o reconhecimento para usar as palavras quentes da lista. Adequado para cenários onde o vocabulário é conhecido e relativamente estável, e onde é necessário reutilizar a mesma lista de palavras em solicitações. Para obter detalhes de uso, consulte Hotwords pré-compiladas. | | nls_config.input_context | array | Não | Uma lista de mensagens contendo contexto de conversação opcional para melhorar a precisão do reconhecimento. O contexto ajuda a melhorar o reconhecimento de termos específicos de domínio. Para uso, consulte Aprimoramento de contexto. Você pode incluir até 5 mensagens de cada tipo de contexto: input_text e text. Se este limite for excedido, apenas as 5 mensagens mais recentes de cada tipo serão retidas. O comprimento combinado do text campos no user e assistant as mensagens em cada turno não devem exceder 400 caracteres. Cada caractere conta como 1. O excesso de texto é truncado no final.

Ao incluir contexto, organize messages por turno de conversa. Em cada turno, o user mensagem (input_text tipo) deve preceder o correspondente assistant mensagem (text tipo). O user mensagem contendo input_audio deve ser a última mensagem do messages matriz.

Veja o exemplo abaixo desta tabela. | | nls_config.instant_vocabulary | object | Não | Hotwords instantâneas, passadas como pares de valores-chave. Cada chave é o texto da hotword (string), e cada valor é seu peso (integer). Nenhuma lista de hotwords pré-compilada é necessária. Use este parâmetro para hotwords temporárias em nível de sessão. Os pesos válidos são números inteiros de 1 a 5 ou 50. Um peso mais alto de 1 a 5 aumenta a probabilidade de o modelo gerar a hotword. Um peso de 50 define uma super hotword e melhora significativamente a recuperação. Você pode especificar até 50 super hotwords. Se você também configurar hotwords pré-compiladas, os dois conjuntos serão mesclados. Se o conjunto mesclado exceder 2.000 hotwords, 2.000 serão selecionadas aleatoriamente. Para uso, consulte Hotwords instantâneas. Somente qwen-audio-3.0-asr-flash-filetrans suporta hotwords instantâneas.

Veja o exemplo abaixo desta tabela. | | nls_config.language_hints | array[string] | Não | Os códigos de idioma a serem reconhecidos. Se você não conseguir determinar o idioma antecipadamente, deixe-o sem definição e o modelo detectará o idioma automaticamente. Para Qwen-Audio-3.0-ASR-Flash-Filetrans modelos, você pode configurar até 4 valores; quaisquer valores além dos 4 primeiros são ignorados. Para Fun-ASR modelos, você pode definir apenas 1 valor; se você definir vários, apenas o primeiro terá efeito.

Clique para ver os códigos de idioma aceitos

<ul><li>qwen-audio-3.0-asr-flash-filetrans, fun-asr:</li></ul> <ul><li>zh: chinês</li><li>pt: Inglês</li><li>sim: japonês</li><li>ko: Coreano</li><li>vi: vietnamita</li><li>º: Tailandês</li><li>id: indonésio</li><li>senhora: Malaio</li><li>tl: filipino</li><li>oi: hindi</li><li>ar: árabe</li><li>fr: francês</li><li>de: alemão</li><li>ex: Espanhol</li><li>pt: Português</li><li>ru: Russo</li><li>isso: italiano</li><li>nl: Holandês</li><li>sv: Sueco</li><li>da: dinamarquês</li><li>fi: Finlandês</li><li>não: norueguês</li><li>el: Grego</li><li>pl: Polonês</li><li>cs: Tcheco</li><li>hu: Húngaro</li><li>ro: romeno</li><li>bg: búlgaro</li><li>hr: Croata</li><li>sk: Eslovaco</li></ul> |

nls_config.input_context exemplo:

[
  {
    "role": "user",
    "content": [
      {
        "type": "input_text",
        "text": "你好啊，我是通义千问，有什么可以帮助你的？"
      }
    ]
  }
]

nls_config.instant_vocabulary exemplo:

{
  "张三": 5,
  "李四": 5
}

Interfaces principais

NeoNui

nui_initialize

Inicializa a instância do SDK de reconhecimento de fala. O SDK é um singleton. Não inicialize-o novamente antes de chamar nui_release.

• Assinatura do método

-(NuiResultCode) nui_initialize:(const char *)parameters
                       logLevel:(NuiSdkLogLevel)level
                        saveLog:(BOOL)save_log;

• Descrições dos parâmetros

• Valor de retorno

  Retorna um código de erro. Consulte Referência do código de erro.

####nui_set_params

Use esta interface para definir ou atualizar o nls_config parâmetro de forma independente. Se você fornecer todos os parâmetros de uma vez em nui_file_trans_start, você não precisa chamar esse método.

• Assinatura do método

-(NuiResultCode) nui_set_params:(const char *)params;

• Descrições dos parâmetros

params exemplo:

{
    "nls_config": {
        "model":"qwen-audio-3.0-asr-flash-filetrans",
        "diarization_enabled": false
    }
}

• Valor de retorno

  Retorna um código de erro. Consulte Referência do código de erro.

nui_file_trans_start

Inicia o reconhecimento.

• Assinatura do método

-(NuiResultCode) nui_file_trans_start:(const char *)params
                               taskId:(char *)task_id;

• Descrições dos parâmetros

params exemplo:

{
    "file_urls": [
        "{YOUR_AUDIO_URL}"
    ],
    "async_request": false,
    "nls_config": {
        "model":"qwen-audio-3.0-asr-flash-filetrans",
        "diarization_enabled": false
    }
}

• Valor de retorno

  Retorna um código de erro. Consulte Referência do código de erro.

nui_file_trans_query

Use esta interface para consultar ativamente o status atual e o resultado de uma tarefa assíncrona. Após uma chamada bem-sucedida, o resultado é retornado através do EVENT_FILE_TRANS_QUERY_RESULT evento no onFileTransEventCallback retorno de chamada.

Obtenha o task_id passado para este método a partir do EVENT_FILE_TRANS_UPLOADED evento.

• Assinatura do método

-(NuiResultCode) nui_file_trans_query:(const char *)task_id;

• Descrições dos parâmetros

• Valor de retorno

  Retorna um código de erro. Consulte Referência do código de erro.

nui_file_trans_cancel

Cancela a tarefa atual imediatamente.

• Assinatura do método

-(NuiResultCode) nui_file_trans_cancel:(const char *)task_id;

• Descrições dos parâmetros

• Valor de retorno

  Retorna um código de erro. Consulte Referência do código de erro.

nui_lançamento

Libera todos os recursos internos do SDK e encerra à força todas as tarefas em andamento. Depois de chamar esse método, a instância do SDK fica indisponível. Para usá-lo novamente, você deve chamar nui_initialize novamente para inicializá-lo.

• Assinatura do método

-(NuiResultCode) nui_release;

• Valor de retorno

  Retorna um código de erro. Consulte Referência do código de erro.

nui_get_version

Obtém as informações da versão atual do SDK.

• Assinatura do método

-(const char*) nui_get_version;

• Valor de retorno

  As informações da versão atual do SDK.

NeoNuiSdkDelegate: monitora retornos de chamada

onFileTransEventCallback: monitore eventos e resultados de reconhecimento de fala

• Assinatura do método

-(void) onFileTransEventCallback:(NuiCallbackEvent)nuiEvent
                       asrResult:(const char *)asr_result
                          taskId:(const char *)task_id
                        ifFinish:(BOOL)finish
                         retCode:(int)code;

• Descrições dos parâmetros

onFileTransLogTrackCallback: monitorar logs de rastreamento

Use esse retorno de chamada para receber logs internos detalhados do SDK para solução de problemas e depuração.

-(void)onFileTransLogTrackCallback:(NuiSdkLogLevel)level
                        logMessage:(const char *)log;

NuiCallbackEvent: tipos de eventos