Modo debug e configurações internas

O SDK da Iara foi desenvolvido para facilitar ao máximo a integração de nossas tecnologias com seu software e empresa. Para facilitar no processo de integração ou resolução de possíveis problemas, porém, o reconhecedor pode rodar em modo debug ou ter suas configurações internas ajustadas.

IMPORTATE: As alterações descritas nessa página podem afetar negativamente sua aplicação. A menos que você tenha ajuda da equipe Iara, não é uma boa ideia alterar configurações internas por conta própria.

Utilização do modo debug

O modo debug faz com que o SDK emita diversas mensagens no console de desenvolvimento do navegador. Essas mensagens podem ser utilizadas para a identificação de um problema, por exemplo.

O reconhecedor de voz pode rodar em modo debug através do parâmetro de inicialização debug: true, conforme o exemplo abaixo:

var recognition = new IaraSpeechRecognition();

recognition.init({
    userId: 'meu@email.com',
    apiToken: '197765800edb8affcb44a7ae7b4ff0a3',
    debug: true                                  // ativa o modo debug
});

Além disso, o modo debug do reconhecedor pode ser ligado e desligado a qualquer momento através da propriedade debug do reconhedor. Por exemplo:

var recognition = new IaraSpeechRecognition();

recognition.init({
    userId: 'meu@email.com',
    apiToken: '197765800edb8affcb44a7ae7b4ff0a3',
});

// (...) Várias linhas de código de sua aplicação

recognition.debug = true;

// (...) Várias linhas de código de sua aplicação

recognition.debug = false;

Informações do ambiente de execução

O reconhecedor de voz da Iara precisa de algumas condições para funcionar. Você pode utilizar a propriedade env do reconhecedor para verificar se tais condições estão disponíveis ou não. Por exemplo, você pode saber se o sistema operacional é Windows ou Mac, etc.

O exemplo abaixo mostra alguns métodos úteis da propriedade env:

var recognition = new IaraSpeechRecognition();

// Visão geral do ambiente onde o SDK está rodando
console.log(recognition.env.summary())

// Mostra informações de cada um dos grupos disponíveis
console.log(recognition.env.os.name);
console.log(recognition.env.os.version);
console.log(recognition.env.arch);
console.log(recognition.env.browser.name);
console.log(recognition.env.browser.version);
console.log(recognition.env.incompatible);
console.log(recognition.env.useBrowserRecorder);

Dica: para saber mais sobre o funcionamento da propriedade env, veja o exemplo de código env-test.

Configurações internas

Funcionalidades podem ficar inoperantes ou comportamentos inexperados acontecerem. PROCEDA COM CUIDADO E ORIENTAÇÃO!Grande parte do funcionamento interno do reconhecedor de voz da Iara pode ser customizado, por exemplo, para monitorar a adição/removação de dispositivos de entrada, limitar o consumo de memória, etc.

Para alterar configurações internas do reconhecedor, utilize as propriedades do objeto internal.settings do reconhecedor:

var recognition = new IaraSpeechRecognition();

recognition.init({
    userId: 'meu@email.com',
    apiToken: '197765800edb8affcb44a7ae7b4ff0a3',
});

// Alterera a configuração `prop` com o valor `false`.
recognition.internal.settings.prop = false;

Um exemplo de configuração interna é o tamanho do histórico de trascrições feitos, que é utilizado para emitir eventos. Por padrão, o reconhecedor mantém em memória os últimos 200 reconhecimentos. Para alterar essa quantidade para 10, por exemplo, pode-se fazer:

recognition.internal.settings.transcriptHistorySize = 10;

Para saber quais são configurações internas disponíveis para alteração, assumindo que você tem uma instância do reconhecedor de voz da Iara chamado recognition em sua aplicação (como no exemplo acima), abra o console de desenvolvimento do navegador (geralmente através da tecla F12) e digite:

console.log(recognition.internal.settings);