Pular para o conteúdo principal

Instalação

Para utilizar o reconhecimento de voz da Iara, sua aplicação precisa utilizar o iara-speech.js e o serviço local da Iara (ALS) precisa estar rodando no computador de cada um dos seus usuários.

1. Instalação do iara-speech.js​

Existem duas formas de utilizar o iara-speech.js: através do nosso CDN e com instalação local (self-hosting).

1.1 Através do CDN (recomendado)​

A forma mais rápida e fácil de utilizar o iara-speech.js é através do nosso CDN. Inclua a seguinte tag <script> na sua aplicação web:

<script src="https://cdn.iarahealth.com/sdk/javascript/1.9.0/iara-speech.min.js"></script>

O código HTML da sua aplicação ficará parecido com o exemplo abaixo:

<html>
<head>
  <!-- Iara Speech SDK -->
  <script src="https://cdn.iarahealth.com/sdk/javascript/1.9.0/iara-speech.min.js"></script>
</head>
<body>
  <!-- outras tags da sua aplicação -->
</body>

Os exemplos acima utilizam a versão 1.9.0 do SDK javascript, mas você pode especificar qualquer versão através da URL. Basta informar o número da versão conforme o exemplo abaixo:

<script src="https://cdn.iarahealth.com/sdk/javascript/{VERSAO}/iara-speech.min.js"></script>

onde {VERSAO} é a versão que você deseja utilizar, ex.: 1.9.0, 1.5.0, etc.

1.2 Servindo localmente​

Se você deseja servir o iara-speech.js junto com os demais arquivos da sua aplicação web, baixe o arquivo iara-speech.js e o coloque na pasta da sua aplicação com as demais bibliotecas javascript já em uso, ex.: js/.

Depois inclua a seguinte tag <script> na sua aplicação web:

<script src="/caminho/para/o/arquivo/iara-speech.js"></script>

O código HTML da sua aplicação ficará parecido com o exemplo abaixo:

<html>
<head>
  <!-- Iara Speech SDK -->
  <script src="/caminho/para/o/arquivo/iara-speech.js"></script>
</head>
<body>
  <!-- outras tags da sua aplicação -->
</body>

2. Instalação do serviço local da Iara (ALS)​

O serviço local da Iara (ALS) faz diversos processamentos locais para garantir velocidade à sua aplicação, além de segurança e privacidade para os dados dos usuários.

Como o ALS é uma aplicação nativa, ele precisa ser instalado por cada usuário da sua aplicação que utilizará o reconhecimento de voz da Iara.

IMPORTANTE! Se o serviço local da Iara (ALS) não estiver rodando no computador do usuário da sua aplicação, não será possível utilizar o reconhecimento de voz da Iara.

O ALS está disponível para as plataformas Windows e Mac. Você pode obter o instalador do ALS para qualquer uma das plataformas suportadas através da URL https://cdn.iarahealth.com/als/:

O iara-speech.js, durante sua inicialização, verificará se o ALS está rodando no computador do usuário. Se ele não estiver, o evento IaraEvent.INIT_FAIL será emitido.

Você pode tratar eventos lançados pelo iara-speech.js referentes ao ALS estar rodando localmente e, então, informar ao seu usuário que o ALS precisa ser baixado e instalado.

Veja a página eventos para saber mais.