IBM ViaVoice - UK English Command & Control Runtime Readme

Release 7.0 February 29, 2000

Copyright International Business Machines Corporation 2000. All Rights Reser e!. "ote to #.$. %o ern&ent #sers ''' (ocu&entation relate! to restricte! rights ''' #se, !uplication, or !isclosure is sub)ect to restrictions set *orth in %$ A(+ $che!ule Contract ,ith IBM Corp.

C-"./".$ 1. Installation "otes 2. Mini&u& $yste& Re0uire&ents 3. (e eloper $upport In*or&ation 4. I$1 Runti&e 2icensing %ui!elines 5. Installing 1ia1oice Runti&es 6. #sing 1ia1oice Runti&es 7. #ninstalling 1ia1oice Runti&es 8. %eneral 2i&itations 9. .ra!e&ar3s an! "otes
.his Rea!&e contains the latest in*or&ation on the 1ia1oice Co&&an! an! Control Runti&e. +lease *a&iliarise yoursel* ,ith this Rea!&e. "ote4 Be*ore using this in*or&ation an! the pro!uct it supports, rea! the general in*or&ation un!er .ra!e&ar3s an! "otes. It is a! isable to ha e so&e o* the ite&s &entione! in this !ocu&ent be &a!e a ailable to the en!'user o* your pro!uct. .his coul! be a si&ple rea!&e.t5t or through other &eans. In*or&ation containe! in 6Installation "otes7 an! 6%eneral 2i&itations7 are goo! can!i!ates *or your en!' users. /n!'user rele ant in*or&ation *ro& other sections &ay also be use!.

8. I"$.A22A.I-" "-./$
9 :ou can install this 7.0 runti&e, or any pro!uct containing the 7.0 runti&e, o er IBM 1ia1oice +ro!ucts. ;o,e er, i* you install the #.$. ersion o* IBM 1ia1oice Millenniu& o er any 7.0 runti&e, both pro!ucts <#.$. IBM 1ia1oice Millenniu& an! the 1ia1oice Runti&e 7.0= &ay be !isable!. <-ther languages o* IBM 1ia1oice Millenniu& are not a**ecte!.= .o re'enable both the runti&e an! #.$. IBM 1ia1oice Millenniu&, run the 1ia1oice Runti&e patch, calle! 6repairrt.e5e,7 locate! in the >rtcontrol>support !irectory o* the 1ia1oice Runti&e installation C(. 9 I* you install 1ia1oice Runti&e 7.0 o er a pre ious 1ia1oice pro!uct, the installation progra& &igrates your personal speech !ata *ro& the pre ious pro!uct to 1ia1oice Runti&e 7.0. $peech !ata such as a!!e! ,or!s, !ictation an! na igation &acros, an! your personal ocabulary <language &o!el= are &igrate! to 1ia1oice Runti&e 7.0. ;o,e er, you &ust co&plete a ne, enrol&ent *or 1ia1oice Runti&e 7.0?your 1ia1oice enrol&ents are not &igrate!. :ou ,ill be as3e! to run the Analyse My 1oice @iAar! an! create a ne, 1oice Mo!el.

Be*ore you install 1ia1oice Runti&e 7.0 on a co&puter that has a !iscrete speech pro!uct installe! such as 1oice.ype B.0.5 or $i&ply $pea3ing, be sure that you uninstall the !iscrete speech pro!uct *irst. :our !iscrete 1oice.ype enrol&ents an! personal speech !ata cannot be use! by 1ia1oice Runti&e 7.0 an! ,ill not be &igrate!. :ou ,ill be as3e! to run the Analyse My 1oice @iAar! to create a ne, #ser an! 1oice Mo!el. :our !iscrete #ser !ata is sa e! in case you !eci!e to install a !iscrete speech pro!uct again. Installing 1ia1oice Runti&e 7.0 on a syste& ,ith (ragon "aturally$pea3ing ,ill ren!er certain parts o* the (ragon pro!uct inoperable. .his is !ue to inco&patibilities bet,een (ragon "aturally$pea3ing an! Microso*tCs (C-M9D./E/. (C-M9D./E/ is re0uire! by 1ia1oice Runti&e 7.0. Installing 1ia1oice Runti&e 7.0 o er 1ia1oice 9D &ight ren!er $pea3+a! inoperable. .his proble& is !ue to inco&patibilities bet,een $pea3+a! an! a later MFCF2.(22. A re*resh ersion o* 1ia1oice 9D &ust be installe! to repair $pea3+a!. .o obtain the re*resh C( o* 1ia1oice 9D, users shoul! call the telephone support nu&ber liste! in their 1ia1oice #serCs Manual. Installing 1ia1oice Runti&e 7.0 o er 1ia1oice %ol! ,ill !isable the use o* the .rain *eature *ro& the 6@hat Can I $ay7 ,in!o,. In or!er to train the ,or!s, use the 1ocabulary Manager *ro& the $tartG+rogra&sGIBM 1ia1oice H #I /nglishG.ools &enu. I* users install the 1ia1oice Runti&e 7.0 o er an IBM 1ia1oice pro!uct release! prior to 1ia1oice Millenniu&, the ne, 1ia1oice -ptions online help &ight not &atch or &ight inclu!e in*or&ation *or &ore options than are actually a ailable on the original 1ia1oice pro!uct. #sers shoul! !isregar! in*or&ation about options that are not a ailable on their pro!uct. I* users install the 1ia1oice Runti&e 7.0 o er an IBM 1ia1oice pro!uct release! prior to 1ia1oice Millenniu&, any ne, users create! on the original pro!uct &ight lose the ability to use the Begin $pell an! Begin "u&bers oice co&&an!s. #sers ,ho install 2otus $&art$uite 9.J o er the 1ia1oice Co&&an! an! Control Runti&e 7.0 &ay be unable to !ictate to $&art$uite. .o re'enable !ictation in $&art$uite !o the *ollo,ing4 *ro& the 2otus $&art$uite 9.J C( go to the *ol!er e5tra>1ia1oice>#I> si>1ia1rt an! launch setup.e5e to install the (ictation Runti&e. A*ter (ictation Runti&e has installe!, reboot an! reinstall the 1ia1oice Runti&e 7.0.

2. MI"IM#M $:$./M R/K#IR/M/".$

Windows 95 9!4 9 9 9 9 9 9 Intel +entiu& 8LLM;A ,ith MME an! 2JLI 22 cache <or e0ui alent=, <inclu!ing AM(' IL 200M;A or AM('IL ,ith B("o,M , each ,ith 2JLI 22 cache= FDMB o* RAM in total 2L0MB o* a ailable har! !is3 space (isplay &o!e set to 2JL colours or higher is reco&&en!e! A @in!o,s 9JN9D co&patible 8L'bit soun! car! o* goo! recor!ing capability <,ith a &icrophone input )ac3= Kua!'spee! C('R-M !ri e or *aster

Windows "# Wor$station %&' with (er)ice *ac$ %4 9 9 9 9 9 9 9 Intel +entiu& 8LLM;A ,ith MME an! 2JLI 22 cache <or e0ui alent=, <inclu!ing AM(' IL 200M;A or AM('IL ,ith B("o,M , each ,ith 2JLI 22 cache= LFMB o* RAM in total 2L0MB a ailable har! !is3 space A!&inistrator authority re0uire! to install an! use this progra& (isplay &o!e set to 2JL colours or higher is reco&&en!e! A @in!o,s ". co&patible 8L'bit soun! car! o* goo! recor!ing capability <,ith &icrophone input )ac3= Kua!'spee! C('R-M !ri e or *aster

B. (/1/2-+/R $#++-R. I"F-RMA.I-"

.he 1ia1oice (e eloper Foru& at http4NN!o&ino.,atson.ib&.co&NspeechN oicetype!e .ns* pro i!es a &echanis& *or e5changing in*or&ation an! i!eas ,ith other 1ia1oice !e elopers. .his *oru& is inten!e! *or co&&unication bet,een !e elopers an! an IBM response to 0uestions is not guarantee!. (e elopers purchasing the $(I ,ill be pro i!e! a !irect lin3 to 1ia1oice !e elop&ent engineers *or support ia e'&ail ,ith a guarantee! response ti&e o* one business !ay. For &ore in*or&ation about the 1ia1oice $(I *or @in!o,s isit the 1ia1oice (e eloperOs Corner at4 http4NN,,,.ib&.co&Nso*t,areNspeechN!e For in*or&ation about licensing the 1ia1oice Runti&e, sen! an e'&ail to4 ))lic+us&i,m&com

F. I$1 R#".IM/ 2IC/"$I"% %#I(/2I"/$

Follo,ing proper gui!elines ensures that the 1ia1oice Runti&e is properly counte!, &aintaine! *or other applications, an! re&o e! *ro& the syste& ,hen not use! any&ore. :ou, as an I$1, &ust co&ply ,ith the *ollo,ing gui!elines in your so*t,are to co&ply ,ith the licensing associate! ,ith this 1ia1oice Runti&e4 9 9 :our application &ust copy the Runti&e in its entirety to your pro!uct C(. :our applicationCs installation must install this 1ia1oice Runti&e ,hen your application is installe!. $i&ilarly, your application &ust uninstall this 1ia1oice Runti&e ,hen your application is uninstalle!. More in*or&ation about this is locate! belo, in the $ection J4 I"$.A22I"% 1IA1-IC/ R#".IM/$ an! $ection 74 #"I"$.A22I"% 1IA1-IC/ R#".IM/$. :our application &ust create a return area prior to the 1ia1oice Runti&e installation so the 1ia1oice Runti&e can return in*or&ation. :our application installation progra& &ust re&o e this return area upon co&pleting e5ecution. More in*or&ation about this is locate! belo, in the $ection J4 I"$.A22I"% 1IA1-IC/ R#".IM/$. :our application &ust in o3e the 1ia1oice Runti&e installation ,ith at least the &ini&u& nu&ber o* co&&an! line argu&ents as outline! belo,.

9 9

:our application &ust register itsel* as a client o* the 1ia1oice Runti&e. More in*or&ation about this is locate! belo, in the $ection J4 I"$.A22I"% 1IA1-IC/ R#".IM/$. :our applicationCs installation &ust inspect the return co!es *ro& the 1ia1oice Runti&e installation. .hese return co!es &ust be han!le! appropriately. More in*or&ation about this is locate! belo, in the $ection J4 I"$.A22I"% 1IA1-IC/ R#".IM/$. :our application &ust not a!! or re&o e *iles *ro& the 1ia1oice !irectories. More in*or&ation is locate! belo, in $ection L4 #$I"% R#".IM/$. :our application &ust resol e path in*or&ation *or 1ia1oice binaries through 11R.IR/%.(22. More in*or&ation about this is locate! belo, in $ection L4 #$I"% R#".IM/$. :our application &ust launch 1ia1oice e5ecutables through the 11R.IC2I/".$.(22. More in*or&ation about this is locate! belo, in $ection L4 #$I"% R#".IM/$. :our application &ust create a return area prior to uninstalling the 1ia1oice Runti&e so the 1ia1oice Runti&e can return in*or&ation. :our application uninstallation progra& &ust re&o e this return in*or&ation area upon co&pleting e5ecution. More in*or&ation about this is locate! belo, in $ection 74 #"I"$.A22I"% 1IA1-IC/ R#".IM/$. :our applicationCs uninstall &ust uninstall this 1ia1oice Runti&e through a helper (22, 1170#PEE.(22 <,here EE is a language co!e ' #$, #I, FR, %R, /$, etc.=. More in*or&ation about this is locate! belo, in $ection 74 #"I"$.A22I"% 1IA1-IC/ R#".IM/$. :our applicationCs uninstall &ust unregister itsel* as a client o* the 1ia1oice Runti&e. More in*or&ation about this is locate! belo, in $ection 74 #"I"$.A22I"% 1IA1-IC/ R#".IM/$. :our applicationCs uninstall &ust inspect the return co!es *ro& the 1ia1oice Runti&e uninstall. .hese return co!es &ust be han!le! appropriately. More in*or&ation about this is locate! belo, in $ection 74 #"I"$.A22I"% 1IA1-IC/ R#".IM/$.

9 9

9 9

9 9

.his runti&e inclu!es *eatures to pre ent acci!ental re&o al o* the 1ia1oice Runti&e ,hile a 1ia1oice Runti&e'!epen!ent application is still installe! on the syste&. It re0uires a little &ore i&ple&entation e**ort *or installation an! uninstallation o* this runti&e, but the en! result is a better user e5perience ,ith your application. .o si&pli*y your i&ple&entation, sa&ple co!e has been pro i!e!. Ieep in &in! that this is sa&ple co!e an! it &ay ha e errors although IBM tries ery har! to pro i!e 6bug'*ree7 co!e. /5a&ples outlining proper proce!ures are pro i!e! un!er the >$AM+2/$ !irectory on your installation &e!ia. (e eloper support *iles are pro i!e! un!er the >(/1/2-+ !irectory on your installation &e!ia. .he latest ersions o* these *iles are also a ailable *or !o,nloa! *ro& the 1ia1oice Runti&e !o,nloa! page.

J. I"$.A22I"% 1IA1-IC/ R#".IM/$

:our application install &ust install this ersion o* the 1ia1oice Runti&e. $a&ple co!e e5ecuting the 1ia1oice Runti&e Installation can be *oun! un!er >$AM+2/$ on your installation &e!ia. .he 1ia1oice Runti&e allo,s you to custo&ise the !irectory into ,hich it installs. .he installation !irectory, ho,e er, &ust be li&ite! to L0 characters !ue to bac3,ar!'co&patibility issues un!er @in!o,s 9J. Also, in or!er *or the runti&es to co'e5ist ,ith other IBM speech pro!ucts, the custo& !irectory ,ill be ignore! i* 1ia1oice is alrea!y installe! on the &achine.

$pecial consi!erations are necessary ,hen installing the 1ia1oice Runti&e. More !etails on each step are pro i!e! in the bullete! section a*ter the steps. .o install on a &achine ,here no pre ious or current ersions o* your pro!uct e5ist, *ollo, these steps4 8. Register your application as a client o* the 1ia1oice Runti&e by setting registry 3eys. 2. Create the 3ey Q>;I/:P2-CA2PMAC;I"/>$o*t,are>IBM>1ia1oice InstallationC *or return co!es. B. 2aunch the $/.#+./E/ ,ith the proper co&&an! line para&eters *or the 1ia1oice Runti&e. .o install on a &achine ,here any ersion o* your application is installe! <either upgra!ing or o er'installing=, *ollo, these steps4 8. #ninstall the 1ia1oice Runti&e. More in*or&ation is locate! in section 7. #"I"$.A22I"% 1IA1-IC/ R#".IM/$. 2. Register your application as a client o* the 1ia1oice Runti&e by setting registry 3eys. B. Create the 3ey Q>;I/:P2-CA2PMAC;I"/>$o*t,are>IBM>1ia1oice InstallationC *or return co!es. F. 2aunch the $/.#+./E/ ,ith the proper co&&an! line para&eters *or the 1ia1oice Runti&e. .o register your application as a client o* the 1ia1oice Runti&e, set the *ollo,ing alues un!er a ne, 3ey calle! ;I/:P2-CA2PMAC;I"/>$o*t,are>IBMPR/%I$./R ,ith the *ollo,ing alues4 Value -escri.tion szVisibleName The name of your application (may be displayed) Any unique identifier you wish to add szUnique :ou &ust then !elete this 3ey a*ter the 1ia1oice Runti&e installation returns to your application. $a&ple co!e to create this 3ey, *ill in the alues, an! !elete it can be *oun! un!er the !irectory >$AM+2/$ on your installation &e!ia. 9 .o launch the 1ia1oice Runti&e installation, you &ust in o3e $/.#+./E/ *or the 1ia1oice Runti&e on the &e!ia you are !istributing. $/.#+./E/ ta3es se eral co&&an! line para&eters. .hese are !escribe! belo,. (im.li/ied B"01 R+arseG 44S Rinstallation'&e!ia'!irG$/.#+./E/ TRinstallpathGRF-R@AR($2A$;G RspaceG RoptionsGUV Rinstallation'&e!ia'!irG44SR!ri eGRcolonGR1ali!'+athGRBACI$2A$;GV RinstallpathG 44S R!estination'!irectoryG R!estination'!irectoryG 44S R1ali!'+ath o* less than L8 charactersGV Ruserna&eG 44S RK#-./G R*irst na&eG TTRspaceGU Rsurna&eGURK#-./G V R*irst na&eG 44S 8..F044RA2+;A'"#M/RICG WW RspaceG WW 6<6 WW 6=7 WW 6P7 WW 6.7 WW 6'6V Rsurna&eG 44S 8..F044RA2+;A'"#M/RICG WW RspaceG WW 6<6 WW 6=7 WW 6P7 WW 6.7 WW 6'6V RoptionsG 44S RoptionG RspaceG RoptionG RoptionG 44S 6'$M$7 WW 6Nn07 WW 6Nnn7 WW 6Nnu7 RK#-./G Ruserna&eG RK#-./G WW Nn$RMi3eD WW Nn$RMi3e88 WW Nn$RMi3e22 WW Nnr WW Nnl WW Nns RspaceG 44S A$CII 0520 <!eci&al B2= 9

RK#-./G 44SS A$CII 0522 <!eci&al BF= R1ali!'+ath o* less than L8 charactersG 44S 8..L044R1ali!'+ath'CharG R1ali!'+athG44S 8..PMAEP+A.;44R1ali!'+ath'CharG R1ali!'+ath'CharG44SRR/$.RIC./( A$CIIG 2.tion -escri.tion '$M$ Ignore "et,or3 .i&eouts <&ight be necessary ,ith slo,er net,or3s or C('R-M !ri es=. (isable $oun! Chec3.

Nns E3am.le1 $/.#+./E/ C4>+rogra& Files>MyInst1ia1oiceN Nnr Nn0 Nns Nnu 6Xohn $&ith7 H$M$ "otes1 9 I* 1ia1oice is alrea!y installe!, the custo& !irectory ,ill be ignore!. 9 .he &ini&u& argu&ents to success*ully install un!er another application are the !estination !irectory, the user na&e <Nnu 6userna&e7= an! the IBMPRegister registry 3ey <an! its sub3eys=. 9 A*ter installing the 1ia1oice Runti&e, your applicationCs installation &ust inspect the return co!es *ro& the 1ia1oice Runti&e installation an! han!le the& appropriately. .he return co!es *or the 1ia1oice Runti&es install an! uninstall are !escribe! belo,.

RE#UR" C2-E V45UE( 0R2M VI4V2ICE RU"#IME I"(#455 4"- U"I"(#455 /rrors encountere! !uring both the installation an! uninstallation are returne! to your so*t,are ia registry 3eys. .he return in*or&ation can be *oun! un!er 6;I/:P2-CA2PMAC;I"/>$o*t,are>IBM>1ia1oice Installation7. #n!er this 3ey, the *ollo,ing alues can be *oun!4 Y/rrorCo!eY ' .his is a string alue an! is 607 *or success, other,ise an error ,as encountere!. .his nu&ber is a !eci&al representation o* a B2'bit he5a!eci&al bit sensiti e return co!e. A return co!e &ay consist o* &ore than one bit being set. In or!er to !eter&ine the nature o* the error, the string alue &ust be con erte! into an integer an! the resulting nu&ber &ust be A"(/( ,ith &ne&onic *ro& the 11I"$RC.; *ile. For e5a&ple, suppose an application ,ants to install the 1ia1oice Runti&e to support a speech inter*ace on an ". &achine. I* the user launching the installation !oes not ha e a!&inistrati e pri ileges, the 1ia1oice Runti&e installation ,oul! return a alue other than 607 through the 6/rrorCo!e7 registry entry. .he application installation progra& regains e5ecution control a*ter the Runti&e installation aborte!. .he application loa!s the Registry alue *ro& ;I/:P2-CA2PMAC;I"/>$o*t,are>IBM>1ia1oice Installation an! notices it is not 607, but it is 6L77. .o report errors properly to the user the application

con erts the string into an integer, I, ,hich e0uals L7. .he application chec3s to see i* <I Z R.PC-"FI%PA++PAC.I1/= is true. It is not <but i* it is, this &eans a speech application ,as running so the installation is aborte!=. "e5t the application chec3s to see i* <I Z R.PC-"FI%PBA(P-$= is true. It is not <but i* it is, it &eans a &ini&u& re0uire&ent *or the operating syste& is not &et an! the installation is aborte!=. "e5t, the application chec3s to see i* <I Z R.PC-"FI%P"-.PA(MI"= is true. It is .R#/, so the application reports the reason o* the *ailure to the user. ERR2R C2-E( Value Mnemonic 0x00000000 T!"#N$%&!'U""('' 0x0000000* T!"#N$%&!( # T!"#N$%&!U'( !,U%T -escri.tion #peration was successfully completed) &eneral error encountered) User cancelled the operation)

0x+0000000 9 Y/rror$tringY ' A !escription o* the error. Currently only install pro i!es language'speci*ic !escriptions. .he uninstall o* 1ia1oice runti&es pro i!es /nglish'only !escriptions, so it cannot be passe! along to the user.

A*ter installation, re&o e the 3ey Q;I/:P2-CA2PMAC;I"/>$o*t,are>IBM>1ia1oice InstallationC an! the IBMPRegister registry 3ey. I* the return co!e in!icates that loc3e! syste& *iles pre ente! installation o* *iles, a reboot ,ill be re0uire!. :our pro!uctCs installation &ust present the user the option o* rebooting a*ter your application has co&plete! installing i* the return co!e in!icates a reboot is necessary. I* the return co!e *ro& 1ia1oice Runti&e 7.0 installation in!icates a reboot is re0uire!, !o not atte&pt to use any o* the 1ia1oice *iles until a*ter reboot. A*ter inspecting the return co!es, the return co!e area &ust be re&o e! *ro& the registry. Re&o e the 3ey Q>;I/:P2-CA2PMAC;I"/>$o*t,are>IBM>1ia1oice Installation.C $a&ple co!e to inspect the return alue an! re&o e this 3ey can be *oun! un!er >$AM+2/$ on your installation &e!ia.

L. #$I"% 1IA1-IC/ R#".IM/$

(e eloper support *iles are pro i!e! un!er the !irectory >(/1/2-+ on your installation &e!ia. All re0uire! hea!er *iles use! *or !e elop&ent are locate! there. A co&plete list o* *iles inclu!e! are liste! belo,4

-EVE52*ER 0I5E( 6UK7 0ile -escri.tion File resol ing calls to 11R.IClients to *unctions in library.

11R.IC2I/".$.2IB

11I"$RC.;

A hea!er !e*ining the error co!es *or installNuninstall o* the Runti&e.

(4M*5E 0I5E( 0ile -escri.tion A co!e snippet ,ritten in Install$hiel! J.J to install Runti&es. A hea!er !e*ining the error co!es *or installNuninstall o* the Runti&e.

/EI"$.A22.R#2 11I"$RC.;

:our application &ust not a!! or re&o e *iles *ro& the 1ia1oice !irectories. 1ia1oice &ight re&o e *iles in these !irectories. Further&ore, your application shoul! &a3e no assu&ptions about the location o* 1ia1oice *iles on the har! !is3. 2aunching 1ia1oice e5ecutables shoul! be !one through the 11R.IC2I/".$.(22, ,hich ,ill be place! into the syste& !irectory o* the operating syste&. %etting Registry in*or&ation about 1ia1oice shoul! be !one through the 11R.IR/%.(22, ,hich is also place! into the syste& !irectory o* the operating syste&. .he inter*ace to these !yna&ic lin3e! libraries is outline! in the $ection 7. #"I"$.A22I"% 1IA1-IC/ R#".IM/$. For the Co&&an! an! Control Runti&e, the certain *iles *or (ictation Macro /!itor an! 1ocabulary /5pan!er ha e been inclu!e! *or co&patibility reasons. (o "-. atte&pt to use the& in your Co&&an! an! Control pro!uct. .he *iles are inco&plete an! ,ill result in page *aults. I* you ,ant to use a #$B &icrophone or a #$B a!aptor *or a &icrophone, you &ust install the #$B au!io !ri er an! select the #$B au!io !e ice as your pre*erre! recor!ing !e ice. <:our co&puter &ust ha e an #$B port, an! your @in!o,s ersion &ust be @in!o, 9D or higher.= .o set up the #$B Au!io (e ice4

1. +lug the #$B connector into the #$B port on your co&puter. 2. Follo, the on'screen instructions to install the #$B !ri er on your syste&. 3. $elect the #$B Au!io (ri er as your recor!ing !e ice using one o* the *ollo,ing
&etho!s4

Clic3 $tart G $ettings G Control +anel. (ouble'clic3 Multimedia. -pen the

Au!io tab on the Multi&e!ia +roperties ,in!o,. #n!er Recor!ing, open the +re*erre! (e ice &enu, an! select U(B 4udio -e)ice. Clic3 2K or 4..l8.

 Alternati ely, you can select the #$B Au!io (e ice !uring the Au!io $etup
@iAar! a*ter installing the 1ia1oice Runti&e. In the $electing a $oun! Car! ,in!o, <secon! ,in!o, o* the ,iAar!=, open the Input &enu, an! select U(B 4udio -e)ice, an! then co&plete the rest o* the ,iAar!.

7. #"I"$.A22I"% 1IA1-IC/ R#".IM/$

:our progra&Cs uninstall &ust call the uninstall *or the 1ia1oice Runti&e. $a&ple co!e *or uninstalling the 1ia1oice Runti&e can be *oun! un!er the !irectory >$AM+2/$ on your installation &e!ia. .he sa&ple co!e is also !escribe! belo,. "ote1 .he 1ia1oice Runti&e uninstall allo,s users to co&pletely re&o e 1ia1oice *ro& their syste& i* they choose to !o so. By !e*ault, all user !ata re&ains on the &achine unless the proper co&&an! line s,itches are a!!e! to call to the Runti&e uninstall progra&.

I"#ER04CE( #2 VVR#KRE9: VVR#KC5IE"#(: 4"- VV;'U<UK&-55 -nly the *unctions state! belo, are supporte!. Any others are IBM'proprietary an! are sub)ect to change at any ti&e. 9 11R.IReg.(22 is !esigne! to help you get path in*or&ation about the 1ia1oice Runti&e. #se the 9et0ull*ath *unction to get the path to the 1ia1oice binaries. %etFull+ath< 11+ath +ath, 2+.$.R lpsAFull+ath =

"ote1 .his (22 contains other *unctions that are not to be use! by I$1s an! are not guarantee! to be present *ro& one ersion to the ne5t. For e5a&ple, i* you ,ish to !eter&ine the path to the helper uninstall (22, 1170#P#I.(22, you ,oul! nee! to in0uire the path o* the 1ia1oice Runti&e binaries. 9 11R.IClients.(22 is !esigne! to help you interact ,ith 1ia1oice Runti&e clients. :ou &ay launch, 0uery the rea!y state o*, an! !eter&ine i* a 1ia1oice Runti&e client is running. .he &ain *unctions your applications ,ill be calling are4 11Rt3ClientsPIsClientA ailable<11R.IC2I/".PI( nClientI(= 11Rt3ClientsP2aunch<11R.IC2I/".P2A#"C;PI"F- [pcliIn*o, 11R.IC2I/".P+R-C/$$PI"F- [pcpi+rocIn*o, int nReser e!=V 11Rt3ClientsPIsClientRunning<11R.IC2I/".PI( nClientI(= 9 1170#P#I.(22 is !esigne! to help you sa*ely uninstall the 1ia1oice Runti&e. .he &ain *unctions you ,ill be calling are4 IsRe&o able <2+C$.R sA+ro!uct.ype= #ninstallKuietly <2+C$.R sA+ro!uct.ype, 2+C$.R sA-ptions= CreateA!!Re&o e/ntry <2+C$.R sA+ro!uct.ype=

#nregisterClient <2+C$.R sA+ro!uct"a&e, 2+C$.R sAMa)or, 2+C$.R sAMinor, 2+C$.R sA#ni0ue= -* particular interest is the sA-ptions argu&ent to #ninstallKuietly. Currently three options are supporte!4 6re&ain,7 6re&o e,7 an! 6!elusr.7 6Re&ain7, instructs the 1ia1oice Runti&e to stay on the &achine e en i* its re*erence count reaches 0. 6Re&o e7 instructs the 1ia1oice Runti&e to !elete itsel* e en i* the re*erence count has not reache! 0. 6(elusr7 instructs the runti&e to re&o e all user !ata *ro& the &achine. In or!er to pass these options to the uninstall *or the 1ia1oice Runti&e, si&ply space'!eli&it the& to the secon! argu&ent o* #ninstallKuietly. For e5a&ple, i* you ,ere uninstalling an application that uses the 1ia1oice Runti&e, you ,oul! use the *ollo,ing pseu!o'co!e in your uninstall4
$unction emo-e untimes

'et b.roceed -ariable to T U(/ 'et %0!. #0U"T! T0%"T to +) 'et %0!. #0U"T! T"#NT #1 to 2) %f Uninstallin3 T!0%"TAT%#N then set untimeType to %0!. #0U"T! T0%"T) %f Uninstallin3 T!"#44AN0 then set untimeType to %0!. #0U"T! T"#NT #1) 1oad the VV50u!u6)011 usin3 the VV t6 e3)011 and the 7in89 "all 1oad1ibrary) %f 1oadin3 was not successful then 'et b.roceed to $A1'() (ndif)

%f b.roceed is T U( then: "all the 7in89 A.% call &et.rocAddress to find the function Unre3ister"lient) "all the 7in89 A.% call &et.rocAddress to find the function %s emo-able) "all the 7in89 A.% call &et.rocAddress to find the function Uninstall,uietly) "all the 7in89 A.% call &et.rocAddress to find the function "reateAdd emo-e(ntry) %f &et.rocAddress was not successful for all four functions then: 'et b.roceed to $A1'() (ndif) (ndif) %f b.roceed is T U( then: "all Unre3ister"lient to unre3ister your application as a user of the runtime) "all $unction %s emo-able returnin3 % esult) %f % esult ;< 0 then: ,uery user if they wish to delete user data) %f user said yes: "all $unction Uninstall,uietly with untimeType and =remo-e delusr>) (lse: "all $unction Uninstall,uietly with untimeType and =remo-e>) (lse: "all $unction Uninstall,uietly with untimeType and =remain>) "all $unction "reateAdd emo-e(ntry with untimeType) (ndif!then!else) (ndif) %f b.roceed is T U( then:

"all function "hec60ict TUninst'tatus (see sample code)) (ndif) (nd $unction

For &ore e5plicit <co!e'oriente!= in*or&ation, please see the sa&ples locate! in the !irectory >$AM+2/$ on your installation &e!ia. #ninstalling the 1ia1oice Runti&e re0uires using a helper (22. For the #I /nglish ersion o* 1ia1oice, this !yna&ic'lin3e! library is calle! 1170#P#I.(22. $ince you can &a3e no assu&ptions about the location o* the 1ia1oice binary *iles, it is necessary to locate this !yna&ic' lin3e! library using the *unction call %etFull+ath<= in 11R.IReg.!ll, locate! in the syste& !irectory o* your operating syste&. For &ore in*or&ation about using this library, re*er to section L. #$I"% 1IA1-IC/ R#".IM/$ an! I"./RFAC/$ .- 11R.IR/%, 11R.IC2I/".$, A"( 1170#P#I.(22 abo e. .he helper (22 *acilitates the *ollo,ing steps in the uninstall proce!ure4 9 9 9 9 9 9 #nregister your application as a 1ia1oice Runti&e client. /nsure that other speech applications ,ill not be cripple! by the uninstallation. #ninstall the 1ia1oice Runti&e 0uietly. Create an A!!NRe&o e progra& entry *or the 1ia1oice Runti&e <,hen nee!e!=. Clear the registry *ro& resi!ual entries. Allo, the user to co&pletely re&o e all !ata *ro& the &achine.

In a!!ition to using these helper *unctions, your uninstall shoul! inspect the return co!es set !uring the uninstall o* the 1ia1oice Runti&e. Finally, your installation shoul! use a helper *unction to clean up the return area use! *or return co!es. #sers ,ho ,ant to uninstall the IBM 1ia1oice Runti&e can !o so by using the 4dd Remo)e *rograms option un!er (tart G (ettings G Control *anel. ;o,e er, in so&e cases, such as ,hen a user *irst uninstalls IBM 1ia1oice Millenniu&, the 1ia1oice Runti&e &ight not appear in the A!!NRe&o e +rogra&s &enu, but the *iles still appear in the 1ia1oice !irectory. I* this occurs, to uninstall the #.$. IBM 1ia1oice Runti&e *iles, the user shoul! in o3e the rmcontU(&,at *ile *ro& the Bin !irectory. #sers shoul! also run the language'speci*ic batch *ile *or each installe! language o* the 1ia1oice Runti&e, such as r&cont#I.bat <#.I. /nglish=, r&cont/$.bat <$panish=, r&contFR.bat <French=, r&contBR.bat <BraAillian +ortuguese=, r&cont%R.bat <%er&an=, an! r&contX+.bat <Xapanese=.

D. %/"/RA2 2IMI.A.I-"$
9 @hen using @in!o,s 9D only, i* you e5perience syste& crashes *or *iles that begin ,ith the letters Y-2/,Y go to the ,eb site 6,,,.&icroso*t.co&Nco&7 an! clic3 Y(istribute! C-M <(C-M=Y. -n this page, clic3 Y(o,nloa!s Z C('R-M$Y, an! then clic3 Y(C-M9D *or @in!o,s 9DY to !o,nloa! an! run the *ile Y(C-M9D./E/Y. .his *ile contains i&portant up!ates *or @in!o,s 9D, ,hich can correct these proble&s. @hen bac3ing up or restoring a user using @in!o,s 9JN9D, the speech bubble graphic &ay stop &o ing *or a couple secon!s an! then begin to &o e again. ;o,e er, the syste& is still per*or&ing the bac3upNrestore *unction, an! it ,ill be co&plete! properly. $o&eti&es ,hen you install -ly&pus 1ia1oice .ranscription o er 1ia1oice Runti&e 7.0, the -ly&pus 1ia1oice .ranscription installation progra& &ight cause a page *ault. I* this occurs,

close the page *ault !ialogue bo5 an! procee! ,ith -ly&pus 1ia1oice .ranscription installation. .he installation ,ill co&plete success*ully. 9 @hen installing @orl! Boo3 99 ,ith 1ia1oice o er 1ia1oice Runti&e 7.0, you ,ill see the 4dd IBM ViaVoice 9old Runtime &essage. :ou &ust select E3it *ro& this &essage, an! the installation ,ill co&plete success*ully.

Au!io 2i&itations 9 .urn o** the &icrophone be*ore starting progra&s that use the soun! car!. $o&e progra&s cannot correctly !etect that the soun! car! is in use an! !isplay the appropriate &essage to close any other progra&s currently using the soun! car!. I* you run progra&s that use the soun! car!, such as 6%reetings @or3shop7 or other &ulti&e!ia progra&s or ga&es, ,e reco&&en! that you turn o** the 1oiceCentre &icrophone ,hen you are using these progra&s. I* you ha e a $oun!Blaster 8L, $oun!Blaster 2i eM or $oun!Blaster 82D +CI soun! car!, turn on 49C <4uto 9ain Control=. :ou obtain better recor!ing 0uality i* the 49C chec3 bo5 is set as *ollo,s4 8= Right'clic3 the 1olu&e <spea3er= icon in the syste& tray locate! at the right o* the .as3bar, an! then clic3 Volume Controls. 2= Clic3 2.tions an! then clic3 *ro.erties. $elect Recording, &a3e sure the Micro.hone )olume control chec3 bo5 is selecte!, an! clic3 2K to !isplay the Recor!ing Control ,in!o,. B= Clic3 2.tions an! &a3e sure the 4d)anced Controls chec3 bo5 is selecte!. .hen clic3 4d)anced in the Microphone colu&n o* the Recor!ing Control panel an! select the 49C or 4uto 9ain Control chec3 bo5, an! close the A! ance! Controls *or Microphone panel. 9 I* you ha e a $oun!Blaster A@/ LF soun! car! or certain Crystal soun! car!s, turn o** 49C <4uto 9ain Control= or Micro.hone Boost. :ou &ust clear the 49C or Micro.hone Boost chec3 bo5 be*ore running Au!io $etup. I* you run Au!io $etup ,ith the 49C or Micro.hone Boost chec3 bo5 selecte!, run it again a*ter you *irst clear the chec3 bo5 as *ollo,s4 8= Right'clic3 the 1olu&e <spea3er= icon in the syste& tray locate! at the right o* the .as3bar, an! then clic3 Volume Controls. 2= Clic3 2.tions an! then clic3 *ro.erties. $elect Recording, &a3e sure the Micro.hone )olume control chec3 bo5 is selecte!, an! clic3 2K to !isplay the Recor!ing Control panel. B= Clic3 2.tions an! &a3e sure the 4d)anced Controls chec3 bo5 is selecte!. .hen clic3 4d)anced in the Microphone colu&n o* the Recor!ing Control panel an! clear the 49C 4uto 9ain Control or Micro.hone Boost chec3 bo5, an! close the A! ance! Controls *or Microphone ,in!o,. 9 A co&patibility issue has been reporte! ,ith the !e ice !ri er *or the $oun!Blaster 2i eM soun! car! *or @in!o,s ".. (ue to this proble&, 1ia1oice is not supporte! *or use ,ith this soun! car! on @in!o,s ".. +lease re*er to the 1ia1oice ,eb site, http4NN,,,.so*t,are.ib&.co&NspeechNsupportNsupportPteste!.ht&l, *or the latest in*or&ation regar!ing har!,are co&patibility.

I* you encounter a proble& or error !uring the processing o* your 1oice Mo!el, you shoul! restart your co&puter. @hen you run User Wi=ard, clic3 Restart on the &essage that is !isplaye! to continue processing an! success*ully co&plete the analysis o* your oice. A proble& has been reporte! ,ith the line'in !ri er *or the .urtle Beach soun! car!s *or @in!o,s 9D only. (ue to this proble&, you cannot use a line'in !e ice *or this soun! car! ,ith 1ia1oice. I* you *in! that your au!io 0uality is poor a*ter you try to rea! the te5t se eral ti&es on the YA!)usting the Microphone 2e elY page in the Au!io $etup @iAar!, you &ay ha e an ol!er ersion o* the au!io !e ice !ri er *or your soun! car!. .o sol e this proble&, you &ust !o,nloa! an! install the latest au!io !e ice !ri er *or your soun! car! *ro& your +C &anu*acturerOs ,eb site be*ore you call technical support. I* you *in! that !uring the Au!io $etup @iAar! you cannot hear the playbac3 because the soun! is &ute!, you &ay ha e an ol!er ersion o* the au!io !e ice !ri er *or your soun! car!. .o sol e this proble&, you &ust !o,nloa! an! install the latest au!io !e ice !ri er *or your soun! car! *ro& your +C &anu*acturerOs ,eb site be*ore you call technical support. I* you are using the /$$ $olo +CI soun! car!, you &ay *in! that !uring the Au!io $etup @iAar! you cannot hear the playbac3 because the soun! is &ute!. .o sol e this proble&, you &ust !o,nloa! an! install the latest au!io !e ice !ri er *or this soun! car!. %o to the IBM ,eb site4 www&.cco&i,m&com >techin/o&htm an! then type YIBM +C (ri ersY in the search *iel! an! clic3 go. -n the $earch Results page, clic3 the lin3 *or IBM +C (ri ers. Clic3 the *a&ily na&e *ro& the list an! then on the &achine *a&ily support page, scroll !o,n the page an! clic3 the lin3 Y(e ice (ri er File MatricesY. $croll !o,n the page an! clic3 your &achine type. Clic3 the *ile na&e that correspon!s to your !ri er type an! operating syste& an! *ollo, the instructions to !o,nloa! an! install the up!ate! au!io !e ice !ri er. .he Mute chec3 bo5 *or ,a e *iles in 1olu&e Controls gets chec3e! *or the /$$8DD7/ +lug an! +lay soun! car! each ti&e Au!io $etup is run, so so&e playbac3s cannot be hear!. I* this happens, go to the 1olu&e Controls an! unchec3 the Mute chec3 bo5 *or ,a e *iles.

9. .RA(/MARI$ A"( "-./$

IBM, 1ia1oice, an! 1oice.ype are tra!e&ar3s or registere! tra!e&ar3s o* International Business Machines Corporation in the #nite! $tates, other countries, or both. A!obe Acrobat is a tra!e&ar3 or registere! tra!e&ar3 o* A!obe $yste&s Incorporate!. Microso*t, @in!o,s, @in!o,s "., an! the @in!o,s logo are tra!e&ar3s or registere! tra!e&ar3s o* Microso*t Corporation in the #nite! $tates an!Nor other countries. Intel, +entiu&, an! MME are tra!e&ar3s or registere! tra!e&ar3s o* Intel Corporation in the #nite! $tates, other countries or both. All other na&es are tra!e&ar3s, registere! tra!e&ar3s, or ser ice &ar3s o* their respecti e co&panies. .he *ollo,ing paragraph !oes not apply to the #nite! Iing!o& or any country ,here such pro isions are inconsistent ,ith local la,4 I"./R"A.I-"A2 B#$I"/$$ MAC;I"/$ C-R+-RA.I-" +R-1I(/$ .;I$ +#B2ICA.I-" YA$ I$Y @I.;-#. @ARRA".: -F A":

II"(, /I.;/R /E+R/$$ -R IM+2I/(, I"C2#(I"%, B#. "-. 2IMI./( .-, .;/ IM+2I/( @ARRA".I/$ -F M/RC;A".ABI2I.: -R FI."/$$ F-R A +AR.IC#2AR +#R+-$/. $o&e states !o not allo, !isclai&er o* e5press or i&plie! ,arranties in certain transactionsV there*ore, this state&ent &ay not apply to you. It is possible that this publication &ay contain re*erence to, or in*or&ation about, IBM pro!ucts <&achines an! progra&s=, progra&&ing, or ser ices that are not announce! in your country. $uch re*erences or in*or&ation &ust not be construe! to &ean that IBM inten!s to announce such IBM pro!ucts, progra&&ing, or ser ices in your country. Re0uests *or technical in*or&ation about IBM pro!ucts shoul! be &a!e to your IBM reseller or IBM &ar3eting representati e. .his publication coul! inclu!e technical inaccuracies or typographical errors. Changes are perio!ically &a!e to the in*or&ation hereinV these changes ,ill be incorporate! in ne, e!itions o* the publication. IBM &ay &a3e i&pro e&ents an!Nor changes in the pro!uct<s= an!Nor the progra&<s= !escribe! in this publication at any ti&e.

Any re*erences in this in*or&ation to non'IBM @eb sites are pro i!e! *or con enience only an! !o not in any &anner ser e as an en!orse&ent o* those @eb sites. .he &aterials at those @eb sites are not part o* the &aterials *or this IBM pro!uct an! use o* those @eb sites is at your o,n ris3.