Readme do IBM ViaVoice Command & Control Runti me

Release 7.0 29 de fevereiro de 2000

Copyright International Business Machines Corporation 2000. Todos os direitos reservados. Nota para Usurios do Governo dos E.U.A --- Documentao relacionada a direitos restritos --- Uso, duplicao ou divulgao esto sujeitos s restries estabelecidas no documento GS ADP Schedule Contract com a IBM Corp.

CONTEDO
1. 2. 3. 4. 5. 6. 7. 8. 9. Avisos sobre Instalao Requisitos Mnimos do Sistema Informaes de Suporte ao Desenvolvedor Instrues de Licena do Runtime ISV Instalao do ViaVoice Runtimes Utilizao do ViaVoice Runtimes Remoo do ViaVoice Runtimes Limitaes Gerais Marcas e Avisos

Este Readme contm as ltimas informaes sobre o ViaVoice Command and Control Runtime. Familiarize-se com este Readme. Aviso: Antes de utilizar estas informaes e o produto por ela suportado, leia as informaes gerais na seo Marcas e Avisos. Recomenda-se que alguns dos itens mencionados neste documentos estejam disponveis para o usurio final de seu produto. Isto pode ser atravs de um simples arquivo readme.txt ou por outros meios. As informaes contidas nas sees Avisos sobre Instalao e Limitaes Gerais so interessantes para usurios finais. Informaes relevantes para usurios finais encontradas em outras sees tambm podem ser utilizadas.

1. AVISOS SOBRE INSTALAO

Voc pode instalar este runtime 7.0, ou qualquer produto contendo o runtime 7.0, sobre Produtos IBM ViaVoice. Entretanto, se voc instalar a verso em ingls do IBM ViaVoice Millennium sobre qualquer runtime 7.0, ambos os produtos (IBM ViaVoice Millennium em ingls e o ViaVoice Runtime 7.0) podem ser desativados. (Outros idiomas do IBM ViaVoice Millennium no so afetados.) Para reativar o runtime e o IBM ViaVoice Millennium em ingls, execute a correo do ViaVoice Runtime, denominada repairrt.exe, localizada no diretrio \rtcontrol\support do CD de instalao do ViaVoice Runtime. Se voc instalar o ViaVoice Runtime 7.0 sobre um produto ViaVoice anterior, o programa de instalao migrar seus dados pessoais de fala do produto anterior para o ViaVoice Runtime 7.0. Dados de fala como palavras includas, macros de ditados e de navegao, e seu vocabulrio pessoal (modelo de linguagem) so migrados para o ViaVoice Runtime 7.0. Entretanto, necessrio realizar uma nova inscrio para o ViaVoice Runtime 7.0 suas inscries do ViaVoice no so migradas. Ser solicitado que voc execute o Assistente Analise Minha Voz e crie um novo Padro de Voz.

A instalao do ViaVoice Runtime 7.0 em um sistema com o produto Dragon NaturallySpeaking deixar algumas parte do produto Dragon inoperantes. Isto devido incompatibilidade entre o arquivo DCOM98.EXE da Microsoft e o Dragon NaturallySpeaking. O arquivo DCOM98.EXE necessrio para o ViaVoice Runtime 7.0. Se os usurios instalarem o ViaVoice Runtime 7.0 sobre um release do produto ViaVoice anterior ao ViaVoice Millennium, todos os novos usurios criados no produto original podem perder a habilidade para utilizar os comandos de voz Comear a Soletrar ou Iniciar Nmeros. Ao instalar o ViaVoice Millennium sobre o ViaVoice Runtime 7.0 o usurio pode obter a mensagem "Fix last function in migrate.rul for Pt_BR". Ignore esta mensagem; a instalao do programa continuar com sucesso.

2. REQUISITOS MNIMOS DO SISTEMA

Windows 95/98 : Intel Pentium 166MHz com MMX

e 256K de cache L2 (ou equivalente), (incluindo AMD

K6 200MHz ou AMD-K6 com 3DNow! , cada um com 256K de cache L2) 48MB de RAM no total 240MB de espao em disco rgido disponvel Modo de vdeo definido para 256 cores ou superior recomendado Uma placa de som de 16 bits compatvel com Windows 95/98 com bom recurso de gravao (com um conector de entrada de microfone) Unidade de CD-ROM com velocidade 4x ou superior

Windows NT

Workstation 4.0 com Service Pack 4:

Intel Pentium

166MHz com MMX

e 256K de cache L2 (ou equivalente), (incluindo AMD

K6 200MHz ou AMD-K6 com 3DNow! , cada um com 256K de cache L2) 64MB de RAM no total 260MB de espao em disco rgido disponvel Autoridade de administrador necessria para instalar e utilizar este programa Modo de vdeo definido para 256 cores ou superior recomendado Uma placa de som de 16 bits compatvel com Windows NT com bom recurso de gravao (com um conector de entrada de microfone) Unidade de CD-ROM com velocidade 4x ou superior

3. INFORMAES DE SUPORTE AO DESENVOLVEDOR

O Frum ViaVoice Developer no endereo http://domino.watson.ibm.com/speech/voicetypedev.nsf fornece um meio para troca de informaes e idias com outros desenvolvedores do ViaVoice. Este frum destinado para comunicao entre desenvolvedores e no so garantidas respostas da IBM para as perguntas. Desenvolvedores que adquirirem o SDK tero um link direto para os engenheiros de desenvolvimento do ViaVoice para suporte atravs de e-mail com tempo de resposta garantido de um dia til. Veja mais informaes sobre o ViaVoice SDK para Windows no site ViaVoice Developer's Corner, no endereo: http://www.ibm.com/software/speech/dev Para obter informaes sobre o licenciamento do ViaVoice Runtime, envie um email para: vvlic@us.ibm.com

4. INSTRUES DE LICENA DO RUNTIME ISV

Seguir as diretrizes apropriadas assegura que o ViaVoice Runtime seja contado corretamente, mantido para outros aplicativos e removido do sistema quando no for mais utilizado. Voc, como um ISV, deve estar de acordo com as diretrizes a seguir para seu software para estar de acordo com a licena associada a este ViaVoice Runtime: Seu aplicativo deve copiar integralmente o Runtime para seu CD do produto. A instalao de seu aplicativo deve instalar este ViaVoice Runtime quando seu aplicativo for instalado. Da mesma forma, seu aplicativo deve remover este ViaVoice Runtime quando seu aplicativo for removido. Veja mais informaes sobre isto na Seo 5: INSTALAO DE VIAVOICE RUNTIMES e Seo 7: REMOO DE VIAVOICE RUNTIMES. Seu aplicativo deve criar uma rea de retorno antes da instalao do ViaVoice Runtime para que o ViaVoice Runtime possa retornar informaes. Seu programa de instalao do aplicativo deve remover esta rea de retorno quando a execuo for concluda. Veja mais informaes sobre isto na Seo 5: INSTALAO DE VIAVOICE RUNTIMES. Seu aplicativo deve invocar a instalao do ViaVoice Runtime com pelo menos o nmero mnimo de argumentos de linha de comando, conforme mostrado a seguir. Seu aplicativo deve se registrar como um cliente do ViaVoice Runtime. Veja mais informaes sobre isto na Seo 5: INSTALAO DE VIAVOICE RUNTIMES. A instalao de seu aplicativo deve inspecionar os cdigos de retorno da instalao do ViaVoice Runtime. Estes cdigos de retorno devem ser tratados adequadamente. Veja mais informaes sobre isto na Seo 5: INSTALAO DE VIAVOICE RUNTIMES. Seu aplicativo no deve incluir ou remover arquivos dos diretrios do ViaVoice. Veja mais informaes na Seo 6: UTILIZAO DE RUNTIMES.

Seu aplicativo deve resolver informaes de caminho para binrios do ViaVoice atravs do arquivo VVRTKREG.DLL. Veja mais informaes sobre isto na Seo 6: UTILIZAO DE RUNTIMES. Seu aplicativo deve carregar os executveis do ViaVoice atravs do arquivo VVRTKCLIENTS.DLL. Veja mais informaes sobre isto na Seo 6: UTILIZAO DE RUNTIMES. Seu aplicativo deve criar uma rea de retorno antes de remover o ViaVoice Runtime para que o ViaVoice Runtime possa retornar informaes. Seu programa de remoo de aplicativo deve remover estas informaes de retorno quando a execuo for concluda. Veja mais informaes sobre isto na Seo 7: REMOO DE VIAVOICE RUNTIMES. A remoo de seu aplicativo deve remover este ViaVoice Runtime atravs de uma DLL de ajuda, VV70U_XX.DLL (em que XX um cdigo de idioma - BR, US, UK, FR, GR, ES, etc.). Veja mais informaes sobre isto na Seo 7: REMOO DE VIAVOICE RUNTIMES. A remoo de seu aplicativo deve desfazer seu registro de cliente do ViaVoice Runtime. Veja mais informaes sobre isto na Seo 7: REMOO DE VIAVOICE RUNTIMES. A remoo de seu aplicativo deve inspecionar os cdigos de retorno da remoo do ViaVoice Runtime. Estes cdigos de retorno devem ser tratados adequadamente. Veja mais informaes sobre isto na Seo 7: REMOO DE VIAVOICE RUNTIMES.

Este runtime inclui recursos para evitar remoo acidental do ViaVoice Runtime enquanto o aplicativo dependente do ViaVoice Runtime ainda estiver instalado no sistema. Isto requer um pouco mais de esforo de implementao para a instalao e remoo deste runtime, mas o resultado final maior facilidade para o usurio com seu aplicativo. Para simplificar sua implementao, fornecida uma amostra de cdigo. Tenha em mente que este cdigo uma amostra e pode apresentar erros, embora a IBM tente fornecer um cdigo livre de problemas. Exemplos descrevendo procedimentos adequados so fornecidos no diretrio \SAMPLES de sua mdia de instalao. Arquivos de suporte ao desenvolvedor so fornecidos no diretrio \DEVELOP de sua mdia de instalao. As verses mais recentes destes arquivos tambm esto disponveis para download a partir da pgina de download do ViaVoice Runtime.

5. INSTALAO DE VIAVOICE RUNTIMES

A instalao de seu aplicativo deve instalar esta verso do ViaVoice Runtime. Exemplos de cdigo executando a instalao do ViaVoice Runtime podem ser encontrados em \SAMPLES em sua mdia de instalao. O ViaVoice Runtime permite que voc personalize o diretrio em que instalado. O diretrio de instalao, entretanto, deve ser limitado a 60 caracteres devido a questes de compatibilidade com verses anteriores no sistema Windows 95. Alm disso, para que os runtimes possam coexistir com outros produtos de fala IBM, o diretrio padro ser ignorado se o ViaVoice j estiver instalado na mquina. So necessrias consideraes especiais durante a instalao do ViaVoice Runtime. So fornecidos mais detalhes sobre cada etapa nos itens apresentados aps as etapas.

Para instalar em uma mquina onde no existe verso anterior ou atual do produto, siga estas etapas: 1. Registre seu aplicativo como um cliente do ViaVoice Runtime definindo as chaves de registro. 2. Crie a chave \HKEY_LOCAL_MACHINE\Software\IBM\ViaVoice Installation para cdigos de retorno. 3. Carregue o arquivo SETUP.EXE com os parmetros de linha de comando apropriados para o ViaVoice Runtime. Para instalar em uma mquina em que qualquer verso de seu aplicativo foi instalada (atualizando ou reinstalando), siga estas etapas: 1. Remova o ViaVoice Runtime. Veja mais informaes na Seo 7. REMOO DE VIAVOICE RUNTIMES. 2. Registre seu aplicativo como um cliente do ViaVoice Runtime definindo chaves de registro. 3. Crie a chave \HKEY_LOCAL_MACHINE\Software\IBM\ViaVoice Installation para cdigos de retorno. 4. Inicie o arquivo SETUP.EXE com os parmetros de linha de comando apropriados para o ViaVoice Runtime. Para registrar seu aplicativo como um cliente do ViaVoice Runtime, defina os seguintes valores sob uma nova chave denominada HKEY_LOCAL_MACHINE\Software\IBM_REGISTER com os seguintes valores: Valor Descrio szVisibleName O nome de seu aplicativo (pode ser exibido) szMajor Nmero de verso principal de seu aplicativo szMinor Nmero de verso secundrio de seu aplicativo szUnique Qualquer identificador exclusivo que quiser incluir Voc deve ento excluir esta chave depois que a instalao do ViaVoice Runtime retornar para seu aplicativo. Um exemplo de cdigo para criar esta chave, preencher os valores e exclui-la pode ser encontrado no diretrio \SAMPLES de sua mdia de instalao. Para iniciar a instalao do ViaVoice Runtime, voc deve invocar o arquivo SETUP.EXE para o ViaVoice Runtime na mdia que est sendo distribuda. O SETUP.EXE utiliza vrios parmetros de linha de comandos. Estes parmetros so descritos a seguir. BNF simplificado: <Parse> ::= <installation-media-dir>SETUP.EXE [<installpath><FORWARDSLASH> <space> <options>]; <installation-media-dir>::=<drive><colon><Valid-Path><BACKSLASH>; <installpath> ::= <destination-directory> <destination-directory> ::= <Valid-Path of less than 61 characters>; <username> ::= <QUOTE> <first name> [[<space>] <surname>]<QUOTE> ; <first name> ::= 1..40::<ALPHA-NUMERIC> || <space> || ( || ) || _ || . || -; <surname> ::= 1..40::<ALPHA-NUMERIC> || <space> || ( || ) || _ || . || -; <options> ::= <option> <space> <option> <option> ::= -SMS || /nq || /nn || /nu <QUOTE> <username> <QUOTE> || /nSRMike8 || /nSRMike11 || /nSRMike22 || /nr || /nl || /ns <space> ::= ASCII 0x20 (decimal 32)

<QUOTE> ::== ASCII 0x22 (decimal 34) <Valid-Path of less than 61 characters> ::= 1..60::<Valid-Path-Char> <Valid-Path>::= 1.._MAX_PATH::<Valid-Path-Char> <Valid-Path-Char>::=<RESTRICTED ASCII> Opo -SMS /nq /nu firstname surname /nSRMike8 /nSRMike11 /nSRMike22 /nr /ns Descrio Ignorar Tempos Limite de Rede (pode ser necessrio com redes ou unidades de CD-ROM mais lentas). Executa no modo silencioso mostrando apenas um termmetro. Novo usurio a ser criado. Define as taxas de amostragem padro em 8 KHz. Define as taxas de amostragem padro em 11 KHz. Define as taxas de amostragem padro em 22 KHz. Se nenhuma opo for selecionada, esta o padro. Desativar a tela de Reinicializao. Desativar a Verificao de Som

Exemplo: SETUP.EXE C:\Arquivos de programas\MeuViaVoice/ /nr /nq /ns /nu Jos Silva SMS Notas: Se o ViaVoice j estiver instalado, o diretrio padro ser ignorado. Os argumentos mnimos para instalar com sucesso sobre outro aplicativo so o diretrio de destino, o nome de usurio (/nu nome de usurio ) e a chave de registro IBM_Register (e suas subchaves). Depois de instalar o ViaVoice Runtime, a instalao de seu aplicativo deve inspecionar os cdigos de retorno da instalao do ViaVoice Runtime e trat-los adequadamente. Os cdigos de retorno para a instalao e remoo do ViaVoice Runtimes so descritos abaixo. VALORES DE CDIGO DE RETORNO DA INSTALAO E REMOO DO VIAVOICE RUNTIME Erros encontrados durante a instalao e remoo so retornados para seu software atravs de chaves de registro. As informaes de registro podem ser encontradas em HKEY_LOCAL_MACHINE\Software\IBM\ViaVoice Installation. Sob esta chave, os seguintes valores podem ser encontrados: ErrorCode - Este um valor de cadeia e 0 para sucesso; caso contrrio, foi encontrado um erro. Este nmero uma representao decimal de um cdigo de retorno sensvel a bits hexadecimal de 32 bits. Um cdigo de retorno pode ser formado por mais de um bit sendo definido. Para determinar a natureza do erro, o valor de cadeia deve ser convertido para um inteiro e deve ser realizada a operao lgica AND do nmero resultante com o mnemnico do arquivo VVINSRC.H. Por exemplo, suponha que um aplicativo queira instalar o ViaVoice Runtime para suportar uma interface de fala em uma mquina NT. Se

o usurio que lanar a instalao no possuir privilgios administrativos, a instalao do ViaVoice Runtime pode retornar um valor diferente de 0 atravs da entrada de registro ErrorCode. O programa de instalao do aplicativo recupera o controle da execuo depois que a instalao do Runtime for abortada. O aplicativo carrega o valor do Registro de HKEY_LOCAL_MACHINE\Software\IBM\ViaVoice Installation e percebe que no 0, mas sim 67. Para reportar erros adequadamente para o usurio, o aplicativo converte a cadeia para um inteiro, I, que igual a 67. O aplicativo verifica se (I & RT_CONFIG_APP_ACTIVE) verdadeiro. No verdadeiro (mas se for, significa que um aplicativo de fala estava sendo executado, portanto a instalao foi cancelada). Depois o aplicativo verifica se (I & RT_CONFIG_BAD_OS) verdadeiro. No verdadeiro (mas se for, significa que no foi atingido o requisito mnimo do sistema operacional e a instalao cancelada). Depois, o aplicativo verifica se (I & RT_CONFIG_NOT_ADMIN) verdadeiro. VERDADEIRO, portanto o aplicativo relata o motivo da falha para o usurio.

CDIGOS DE ERRO Valor Mnemnico 0x0000000 RT_CONFIG_SUCCESS 0 0x00000001 RT_CONFIG_ERROR 0x00000002 RT_CONFIG_INSTALL 0x00000004 0x00000010 0x00000020 0x00000040 0x00000080 E 0x00000100 0x00000200 RT_CONFIG_NO_SOUND RT_CONFIG_DIFF_LANG RT_CONFIG_UNINSTALL RT_CONFIG_APP_ACTIV RT_CONFIG_OS_BAD RT_CONFIG_NOT_ADMIN RT_CONFIG_DISK_SPAC

0x00000400 0x00000800 0x00001000 0x00002000

RT_CONFIG_REBOOT_RE RT_CONFIG_BADCMDLNE RT_PRODUCTS_EXIST RT_DPRODUCTS_EXIST

0x40000000

RT_CONFIG_USER_QUIT

Descrio A operao foi concluda com sucesso. Erro geral encontrado. A instalao definiu o erro. A remoo definiu o erro. Aplicativo(s) de fala estava(m) em execuo. Falha na verificao do sistema operacional. Usurio sem autoridade administrativa. Espao em disco insuficiente. Verificao de som malsucedida. A verso antiga de um idioma diferente deve ser removida antes desta verso ser instalada. necessrio reinicializar antes de utilizar este runtime. Argumentos de linha de comandos incorretos. Aplicativos instalados dependem do runtime. Existem Produtos Discretos que utilizam runtimes nesta mquina (no ser feita instalao sobre estes produtos at que eles sejam removidos). Operao cancelada pelo usurio.

ErrorString - Uma descrio do erro. Atualmente apenas a instalao fornece descries especficas para idiomas. A remoo de ViaVoice Runtimes fornece descries apenas em ingls, portanto no podem ser passadas para o usurio.

Depois da instalao, remova a chave HKEY_LOCAL_MACHINE\Software\IBM\ViaVoice Installation e a chave de registro IBM_Register. Se o cdigo de retorno indicar que um arquivo de sistemas bloqueado impediu a instalao de arquivos, ser necessrio reinicializar. A instalao de seu produto deve apresentar para o usurio a opo para reinicializar depois que seu aplicativo concluir a instalao se o cdigo de retorno indicar que isto necessrio. Se o cdigo de retorno da instalao do ViaVoice Runtime 7.0 indicar que necessrio reinicializar, no tente utilizar qualquer arquivo do ViaVoice antes de reinicializar. Depois de inspecionar os cdigos de retorno, a rea de cdigo de retorno deve ser removida do registro. Remova a chave \HKEY_LOCAL_MACHINE\Software\IBM\ViaVoice Installation. Um exemplo de cdigo para inspecionar o valor de retorno e remover esta chave pode ser encontrado em \SAMPLES em sua mdia de instalao.

6. UTILIZAO DE VIAVOICE RUNTIMES

Arquivos de suporte ao desenvolvedor so fornecidos no diretrio \DEVELOP da mdia de instalao. Todos os arquivos de cabealho necessrios para desenvolvimento esto localizados l. Uma lista completa dos arquivos includos apresentada a seguir: ARQUIVOS DO DESENVOLVEDOR Arquivo Descrio VVRTKCLIENTS.LIB Arquivo que resolve chamadas para VVRTKClients para funes na biblioteca. VVRTKCLIENTS.DLL Cdigo que encapsula o lanamento de programas ViaVoice. VVRTKCLIENTS.H Arquivo que define interface para VVRTKClients. VVRTKREG.LIB Arquivo que resolve chamadas para VVRTKReg para funes na biblioteca. VVRTKREG.DLL Cdigo que encapsula informaes de registro do ViaVoice. VVRTKREG.H Arquivo que define interface para VVRTKReg. VV70U_BR.LIB Arquivo que resolve chamadas para VV70U_BR para funes na biblioteca. VV70U_BR.DLL Cdigo que encapsula a remoo do ViaVoice Runtime. VV70U_BR.H Cdigo que define a interface para VV70U_BR. VVINSRC.H Um cabealho que define os cdigos de erro para instalao/remoo do Runtime. ARQUIVOS DE AMOSTRA Arquivo Descrio EXINSTALL.RUL Um fragmento de cdigo gravado no InstallShield 5.5 para instalar Runtimes. EXUNINST.CPP Um fragmento de cdigo escrito em C++ para remover Runtimes. VVINSRC.H Um cabealho que define os cdigos de erro para instalao/remoo do Runtime.

Seu aplicativo no deve incluir ou remover arquivos dos diretrios do ViaVoice. O ViaVoice deve remover arquivos nestes diretrios. Alm disso, seu aplicativo no deve prever a localizao dos arquivos do ViaVoice no disco rgido. O carregamento de executveis do ViaVoice deve ser feito atravs do arquivo VVRTKCLIENTS.DLL, que ser colocado no diretrio de sistema do sistema operacional. A obteno de informaes de registro sobre o ViaVoice deve ser feita atravs do arquivo VVRTKREG.DLL, que tambm est localizado no diretrio de sistema do sistema operacional A interface para estas bibliotecas com ligao dinmica demonstrada na Seo 7. REMOO DE VIAVOICE RUNTIMES. Para o Command and Control Runtime, determinados arquivos para o Editor de Macro de Ditado e Extensor de Vocabulrio foram includos por motivos de compatibilidade. NO tente utiliz-los com seu produto Command and Control. Os arquivos so incompletos e causaro falhas de pgina. Se quiser utilizar um microfone USB ou um adaptador USB para um microfone, necessrio instalar o driver de udio USB e selecionar o dispositivo de udio USB como seu dispositivo de gravao preferido. (Seu computador deve possuir uma porta USB e sua verso do Windows deve ser Windows 98 ou superior.) Para configurar o Dispositivo de udio USB: 1. Conecte o conector USB na porta USB de seu computador. 2. Siga as instrues na tela para instalar o driver USB em seu sistema. 3. Selecione o Driver de udio USB como seu dispositivo de gravao utilizando um dos seguintes mtodos: Clique em Iniciar > Configuraes > Painel de controle. D um clique duplo em Multimdia . Abra a guia udio na janela Propriedades de Multimdia. Em Gravao, abra o menu Dispositivo preferido e selecione Dispositivo de udio USB. Clique em OK ou em Aplicar . Como alternativa, voc pode selecionar Dispositivo de udio USB durante o assistente para Configurao de udio depois da instalao do ViaVoice Runtime. Na janela de seleo da placa de som (segunda janela do assistente), abra o menu Entrada e selecione Dispositivo de udio USB, depois conclua o assistente.

7. REMOO DE VIAVOICE RUNTIMES

A remoo de seu programa deve chamar a remoo do ViaVoice Runtime. Um exemplo de cdigo para remoo do ViaVoice Runtime pode ser encontrado no diretrio \SAMPLES de sua mdia de instalao. O exemplo de cdigo tambm descrito a seguir. Nota: A remoo do ViaVoice Runtime permite que os usurios removam completamente o produto ViaVoice de seu sistema, se quiserem isto. Por padro, todos os dados de usurios permanecem na mquina a menos que as opes de linhas de comando apropriadas forem adicionadas para chamar o programa de remoo do Runtime. INTERFACES PARA VVRTKREG, VVRTKCLIENTS E VV70U_BR.DLL Apenas as funes indicadas a seguir so suportadas. Quaisquer outras so propriedades da IBM e esto sujeitas a alterao a qualquer momento. VVRTKReg.DLL projetado para ajud-lo a obter informaes de caminho sobre o ViaVoice

Runtime. Utilize a funo GetFullPath para obter o caminho para os binrios do ViaVoice. GetFullPath( VVPath vvPath, LPTSTR lpszFullPath ) Nota: Esta DLL contm outras funes que no so utilizadas pelos ISVs e no garantido que elas estejam presentes de uma verso para outra. Por exemplo, se quiser determinar o caminho para a DLL de remoo de ajuda, VV70U_BR.DLL, necessrio solicitar o caminho dos binrios do ViaVoice Runtime. VVRTKClients.DLL foi projetada para ajud-lo a interagir com os clientes do ViaVoice Runtime. Voc pode lanar, consultar o estado de prontido e determinar se um cliente ViaVoice Runtime est sendo executado. As funes principais que seus aplicativos iro chamar so: VVRtkClients_IsClientAvailable(VVRTKCLIENT_ID nClientID) VVRtkClients_Launch(VVRTKCLIENT_LAUNCH_INFO *pcliInfo, VVRTKCLIENT_PROCESS_INFO *pcpiProcInfo, int nReserved); VVRtkClients_IsClientRunning(VVRTKCLIENT_ID nClientID) VV70U_BR.DLL foi projetada para ajud-lo a remover com segurana o ViaVoice Runtime. As funes principais que voc ir chamar so: IsRemovable (LPCSTR szProductType) UninstallQuietly (LPCSTR szProductType, LPCSTR szOptions) CreateAddRemoveEntry (LPCSTR szProductType) UnregisterClient (LPCSTR szProductName, LPCSTR szMajor, LPCSTR szMinor, LPCSTR szUnique) De interesse particular o argumento szOptions para UninstallQuietly. Atualmente trs opes so suportadas: remain, remove e delusr. Remain instrui o ViaVoice Runtime para permanecer na mquina mesmo quando sua contagem de referncia atingir 0. Remove instrui o ViaVoice Runtime para se excluir mesmo que a contagem de referncia no tenha atingido 0. Delusr instrui o runtime para remover todos os dados de usurio da mquina. Para passar estas opes para a remoo do ViaVoice Runtime, apenas delimiteas com espaos para o segundo argumento de UninstallQuietly. Por exemplo, se estiver removendo um aplicativo que utiliza o ViaVoice Runtime, voc utilizar o seguinte pseudocdigo em sua remoo:
Function RemoveRuntimes Set bProceed variable to TRUE; Set ID_PRODUCT_RTDICT to 4. Set ID_PRODUCT_RTCONTROL to 5. If Uninstalling RT_DICTATION then set RuntimeType to ID_PRODUCT_RTDICT. If Uninstalling RT_COMMAND then set RuntimeType to ID_PRODUCT_RTCONTROL. Load the VV70u_br.DLL using the VVRtkReg.DLL and the Win32 Call LoadLibrary. If Loading was not successful then Set bProceed to FALSE. Endif.

If bProceed is TRUE then: Call the Win32 API call GetProcAddress to find the function UnregisterClient. Call the Win32 API call GetProcAddress to find the function IsRemovable. Call the Win32 API call GetProcAddress to find the function UninstallQuietly. Call the Win32 API call GetProcAddress to find the function CreateAddRemoveEntry. If GetProcAddress was not successful for all four functions then: Set bProceed to FALSE. Endif. Endif. If bProceed is TRUE then: Call UnregisterClient to unregister your application as a user of the runtime. Call Function IsRemovable returning IRResult. If IRResult <> 0 then: Query user if they wish to delete user data. If user said yes: Call Function UninstallQuietly with RuntimeType and remove delusr. Else: Call Function UninstallQuietly with RuntimeType and remove. Else: Call Function UninstallQuietly with RuntimeType and remain. Call Function CreateAddRemoveEntry with RuntimeType. Endif_then_else. Endif. If bProceed is TRUE then: Call function CheckDictRTUninstStatus (see sample code). Endif. End Function

Para obter informaes mais claras (orientadas para cdigo), veja os exemplos localizados no diretrio \SAMPLES em sua mdia de instalao. A remoo do ViaVoice Runtime requer a utilizao de uma DLL de ajuda. Para a verso ViaVoice, esta biblioteca de vnculos dinmicos denominada VV70U_BR.DLL. Como voc no pode prever a localizao dos arquivos binrios do ViaVoice, necessrio localizar esta biblioteca de vnculos dinmicos utilizando a chamada de funo GetFullPath() na VVRTKReg.dll, localizada no diretrio do sistema de seu sistema operacional. Veja mais informaes sobre a utilizao desta biblioteca na Seo 6. UTILIZAO DE VIAVOICE RUNTIMES e INTERFACES PARA VVRTKREG, VVRTKCLIENTS E VV70U_BR.DLL acima. A DLL de ajuda simplifica as etapas a seguir no procedimento de remoo: Desfazer o registro de seu aplicativo como cliente ViaVoice Runtime. Assegurar que outros aplicativos de fala no sejam danificados pela remoo. Remover silenciosamente o ViaVoice Runtime. Criar uma entrada em Adicionar ou remover programas para o ViaVoice Runtime (quando necessrio). Limpar entradas restantes no registro. Permitir que o usurio remova completamente todos os dados da mquina.

Alm de utilizar estas funes de ajuda, sua remoo deve inspecionar os cdigos de retorno

definidos durante a remoo do ViaVoice Runtime. Finalmente, sua instalao deve utilizar uma funo de ajuda para limpar a rea de retorno utilizada para cdigos de retorno. Os usurios que quiserem remover o IBM ViaVoice Runtime podem fazer isto utilizando a opo Adicionar ou remover programas em Iniciar > Configuraes > Painel de controle . Entretanto, em alguns casos, como quando um usurio remove o IBM ViaVoice Millennium pela primeira vez, o ViaVoice Runtime pode no ser exibido no menu Adicionar ou remover programas, mas os arquivos ainda podem ser exibidos no diretrio do ViaVoice. Se isto ocorrer, para remover os arquivos do IBM ViaVoice Runtime em ingls, o usurio deve invocar o arquivo rmcontUS.bat a partir do diretrio Bin. Os usurios tambm devem executar o arquivo batch especfico para seu idioma para cada idioma instalado do ViaVoice Runtime, como rmcontUK.bat (ingls do Reino Unido), rmcontES.bat (espanhol), rmcontFR.bat (francs), rmcontBR.bat (portugus do Brasil), rmcontGR.bat (alemo) e rmcontJP.bat (japons).

8. LIMITAES GERAIS
Quando utilizar apenas o Windows 98, se ocorrer falha do sistema para arquivos que comecem com as letras OLE, v para o site da web www.microsoft.com/come clique em Distributed COM (DCOM). Nesta pgina, clique em Downloads & CD-ROMS e clique em DCOM98 for Windows 98 para fazer download e executar o arquivo DCOM98.EXE. Esta arquivo contm atualizaes importantes para o Windows 98, que podem corrigir estes problemas. Quando for fazer backup ou restaurar um usurio que utiliza Windows 95/98, o grfico de fala em formato de bolha pode parar por alguns segundos e depois comear a mover novamente. Entretanto, o sistema ainda estar realizando a funo de backup/restaurao e ela ser concluda corretamente. Durante a instalao do World Book 99 com ViaVoice sobre o ViaVoice Runtime 7.0, ser exibida a mensagem Add IBM ViaVoice Gold Runtime . Voc deve selecionar Sair nesta mensagem e a instalao ser concluda com sucesso.

Limitaes de udio Desligue o microfone antes de iniciar programas que utilizam a placa de som. Alguns programas no podem detectar corretamente que a placa de som est em uso e exibir as mensagens apropriadas para fechar todos os outros programas que utilizam a placa de som atualmente. Se voc utilizar programas que utilizam a placa de som, como Greetings Workshop ou outros programas de multimdia ou jogos, recomendamos que voc desligue o microfone do VoiceCenter quando estiver utilizando estes programas. Se voc tiver uma placa de som SoundBlaster 16, SoundBlaster Live! ou SoundBlaster 128 PCI, ligue a opo AGC (Auto Gain Control ). Voc obtm melhor qualidade de gravao se a caixa de opes AGC for definida da seguinte forma: 1) Clique com o boto direito no cone Volume (alto-falante) na bandeja de sistema localizada direita da Barra de ferramentas e clique em Controle de volume . 2) Clique em Opes e clique em Propriedades . Selecione Gravao , assegure que a

caixa de opes Controle de volume do microfone esteja marcada e clique em OK para exibir a janela Controle de gravao. 3) Clique em Opes e assegure que a opo Controles avanados esteja marcada. Depois clique em Avanado na coluna Microfone do painel de controle de gravao e selecione a caixa de opes AGC ou Auto Gain Control e feche o painel Controles avanados para microfone. Se voc tiver uma placa de som SoundBlaster AWE 64 ou determinadas placas de som Crystal, desligue a opo AGC (Auto Gain Control ) ou Microphone Boost . Voc deve limpar a caixa de opes AGC ou Microphone Boost antes de executar a Configurao de udio. Se voc executou a Configurao de udio com a caixa de opes AGC ou Microphone Boost selecionada, execute-a novamente depois de limpar a caixa de opes, da seguinte forma: 1) Clique com o boto direito no cone Volume (alto-falante) na bandeja de sistema localizada direita da Barra de ferramentas e clique em Controle de volume . 2) Clique em Opes e clique em Propriedades . Selecione Gravao , assegure que a caixa de opes Controle de volume do microfone esteja marcada e clique em OK para exibir a janela Controle de gravao. 3) Clique em Opes e assegure que a opo Controles avanados esteja selecionada. Depois clique em Avanado na coluna Microfone do painel Controle de gravao e limpe a caixa de opes AGC/Auto Gain Control ou Microphone Boost e feche a janela Controles avanados para microfone. Foi relatada uma questo de compatibilidade com o driver de dispositivo para a placa de som SoundBlaster Live! no Windows NT. Devido a este problema, o ViaVoice no suportado para utilizao com esta placa de som no Windows NT. Veja as informaes mais recentes sobre compatibilidade de hardware no site do ViaVoice na Web, no endereo http://www.software.ibm.com/speech/support/support_tested.html. Se voc encontrar problemas ou erros durante o processamento de seu Modelo de Voz, deve reinicializar seu computador. Quando voc executar o Assistente do Usurio , clique em Reinicializar na mensagem exibida para continuar o processamento e concluir com sucesso a anlise de sua voz. Foi relatado um problema com o driver de entrada de linha para as placas de som Turtle Beach, apenas para Windows 98. Devido a este problema, voc no pode utilizar um dispositivo de entrada de linha para esta placa de som com o ViaVoice. Se voc achar que a qualidade de udio est baixa depois de tentar ler o texto vrias vezes na pgina Ajuste de nvel do microfone do Assistente de Configurao de udio, voc pode ter uma verso antiga do driver de dispositivo de udio para sua placa de som. Para resolver este problema, voc deve fazer download e instalar o driver de dispositivo mais recente para sua placa de som a partir do site da Web do fabricante de seu PC antes de ligar para o suporte tcnico. Se voc achar que durante o Assistente de Configurao de udio no foi possvel ouvir a reproduo porque o som est silenciado, voc pode ter uma verso antiga do driver de dispositivo de udio para sua placa de som. Para resolver este problema, voc deve fazer download e instalar o driver de dispositivo mais recente para sua placa de som a partir do site da Web do fabricante de seu PC antes de ligar para o suporte tcnico.

Se voc possuir a placa de som ESS Solo PCI, pode achar que durante o Assistente de Configurao de udio no foi possvel ouvir a reproduo porque o som est silenciado. Para resolver este problema, voc deve fazer download e instalar o driver de dispositivo mais recente para esta placa de som. Acesse o site da IBM na Web, no endereo: www.pcco.ibm.com/qtechinfo.htm e digite IBM PC Drivers no campo de pesquisa e clique em go. Na pgina de resultados da pesquisa, clique no link para IBM PC Drivers. Clique no nome de famlia na lista e na pgina de suporte da famlia de mquinas, desloque a pgina para baixo e clique no link Device Driver File Matrices. Desloque a pgina para baixo e clique em seu tipo de mquina. Clique no nome de arquivo que corresponde a seu tipo de driver e ao sistema operacional e siga as instrues para fazer download e instalar o driver de dispositivo de udio atualizado. A caixa de opes Silenciar para arquivos wave nos Controles de volume ser marcada para a placa de som ESS1887E Plug and Play cada vez que a Configurao de udio for executada, portanto algumas reprodues podem no ser ouvidas. Se isto ocorrer, v para os Controles de volume e desmarque a caixa de opes Silenciar para os arquivos wave.

9. MARCAS E AVISOS
IBM e ViaVoice so marcas ou marcas registradas da International Business Machines Corporation nos Estados Unidos e/ou em outros pases. Adobe Acrobat marca ou marca registrada da Adobe Systems Incorporated. Microsoft, Windows, Windows NT e o logotipo do Windows so marcas ou marcas registradas da Microsoft Corporation nos Estados Unidos e/ou em outros pases. Intel, Pentium e MMX so marcas ou marcas registradas da Intel Corporation nos Estados Unidos e/ou em outros pases. Todos os outros nomes so marcas, marcas registradas ou marcas de servio de suas respectivas empresas. O pargrafo a seguir no se aplica a nenhum pas em que tais disposies no estejam de acordo com a legislao local: A INTERNATIONAL BUSINESS MACHINES CORPORATION FORNECE ESTA PUBLICAO NO ESTADO SEM GARANTIA DE ESPCIE ALGUMA, EXPLCITA OU IMPLCITA, INCLUINDO, MAS NO LIMITANDO S GARANTIAS IMPLCITAS DE COMERCIALIZAO OU ADEQUAO A UM FIM ESPECFICO. Alguns pases no permitem a excluso de garantias explcitas ou implcitas em certas transaes; portanto, esta disposio pode no se aplicar a voc. possvel que esta publicao contenha referncias a, ou informaes sobre, produtos (mquinas e programas), programao ou servios IBM que no foram anunciados em seu pas. Tais referncias ou informaes no significam que a IBM pretenda anunciar tais produtos, programao ou servios IBM em seu pas. Solicitaes de informaes tcnicas sobre produtos IBM devem ser endereadas a um revendedor autorizado IBM ou a um representante de marketing IBM. Esta publicao pode conter imprecises tcnicas ou erros tipogrficos. So feitas alteraes peridicas nas informaes aqui contidas; tais alteraes sero incorporadas em futuras edies

desta publicao. A IBM pode fazer aperfeioamentos e/ou alteraes nos produtos e/ou programas descritos nesta publicao, a qualquer momento. Referncias nesta publicao a sites no-IBM na Web so fornecidas apenas para convenincia e no representam de forma alguma um endosso a esses sites. Os materiais contidos nesses sites da Web no fazem parte dos materiais deste produto IBM e a utilizao desses sites da Web de inteira responsabilidade do cliente.