PDF version - Reallusion
Contents
1. 0 gt lt param name TextContent value A torrential record setting downpour that drenched Mumbai and triggered landslides is being blamed for more than 400 deaths in the region police in India s commercial capital say gt TTS Engine lt br gt Please install TTS Web Player to see the Talking Head lt br gt lt a href http www reallusion com plug in installct asp gt http www reallusion com plug in installct asp lt a gt lt OBJECT gt For Microsoft Internet Explorer the lt object gt tag embeds TTS Web Player which is indicated by CLSID B7A59580 B39D 4BF9 B968 1BFA25156691 in the CLASSID attribute CODEBASE represents the URL of Player and the Player version number so that the IE browser will automatically install TTS Web Player to the user s computer and update the control if needed The lt PARAM gt tag represents the property settings of the TTS Web Player These property values control the behavior of the Player as follows Width amp Height Sets the size of the Player within the web page BackColor Sets the background color of the Player ForeColor Sets the display font color of the Player FontName Sets the display font name of the Player such as Arial and so on FontSize Sets the display font size by pixel of the Player TTSEngine Assigns the TTS Engine you want to use Currently this property must be either Microsoft SAPI 4 1 or Microsoft SAPI 5 0 Speed Sets the speech spe2. id CrazyTalkPlayer width 256 height 256 gt lt param name ModelName value Luka ctm gt lt param name ScriptName value Luka cts gt lt OBJECT gt lt OBJECT CLASSID CLSID B7A59580 B39D 4BF9 B968 1BFA25156691 id RLTTSComponent width 256 height 24 gt lt param name TTSEngine value Microsoft SAPI 5 0 gt lt OBJECT gt lt SCRIPT language javascript gt RLTTSComponentAttachCtrl CrazyTalkPlayer lt SCRIPT gt Note that the above example does not set the parameters for each object the user must set these parameters for any actual application When you control a CrazyTalk Web Player with a TTS Web Player the CrazyTalk Web Player will ignore some of the parameters set by users For more information about using CrazyTalk Web Player see the CrazyTalk Web Player white paper Accessing Properties By assigning the open properties you can initialize a TTS Web Player or control its interaction with users To initialize the Player specify the values of the properties between the lt object gt tags The Player then starts with these values these values can be changed by using JavaScript or VBScript to control the interaction Player Initialization To initialize a TTS Player in Microsoft Internet Explorer specify the properties in the lt object gt segment Each assignment begins with a lt PARAM gt tag after which a property is assigned to the name and value variables For example to set the Pla
3. TTS Web Player into HTML code The TTS Text to Speech Web Player can be embedded in a web page by placing some code in the HTML for the page an example of which is shown below With an understanding of what each parameter controls you can manually edit them to achieve the desired presentation within the HTML page itself If you understand JavaScript or VB script you can write routines to alter the parameter values by assigning or retrieving different values to call different Events Note Teaching the use of JavaScript is beyond the scope of this user manual however further details regarding accessing properties methods and events are discussed in the following pages The TTS Web Player uses an ActiveX control for Internet Explorer The required code to add a TTS Web Player into a web page must be placed between the lt body gt and lt body gt tags of your HTML page lt OBJECT ID RLTTSPlayer classid CLSID B7A59580 B39D 4BF9 B968 1BFA25156691 codebase http plug in reallusion com CrazyTalk4 cab version 1 0 0 0 width 256 height 24 gt lt param name BackColor value 16711680 gt lt param name ForeColor value 65535 gt lt param name FontName value Arial gt lt param name FontSize value 100 gt lt param name TTSEngine value Microsoft SAPI 4 1 gt lt param name Speed value 50 gt lt param name Pitch value 50 gt lt param name Volume value 80 gt lt param name AutoLoop value
4. Change Events to occur Back to Method Summary SetVoiceByName This method specifies the voice for the TTS Engine by name Syntax lt Script Language avascript gt document TTSComponent SetVoiceByName String strName lt Script gt Parameters strName A text String that gives the name of the specified voice in the TTS Engine You can get a voice s name by using the GetVoiceString method Remarks Since the same voice from the same TTS Engine may have different IDs in different systems one should specify the voice by name in order to make sure that the TTS Engine will use the same voice in each system Back to Meth mmar Stop This method stops playback of the content Syntax lt Script Language avascript gt document TTSComponent Stop lt Script gt Parameters None Remarks This method performs the same action as clicking the Stop button on the control bar To halt a Play operation without changing the current position you must use the Pause method Calling this method will cause a Stop Event to occur Back to Meth mmar TTS Web Player Event Summary Occurs when the TTS Web Player begins to play Occurs when the TTS Web Player is paused y Occurs when the TTS Web Player is stopped Occurs when the current sentence is spoken oe Occurs when the end of the text is reached Play This Event occurs when the TTS Web Player begins to play Syntax lt Script FOR TTSComponent Event Pl
5. Property Summary BackColor This property specifies the background color of the TTS Web Player Syntax lt Script Language avascript gt document TTSComponent BackColor iColor set var iColor document TTSComponent BackColor get lt Script gt Possible Value This property is an Integer with a default value of 000000 It consists of an RGB color in OXBBGGRR format Example Value Description OXOOFFOO Green color OXFFOOOO Blue color OXOOOOFF Red color Remarks None Back to Property Summary FontName This property specifies the display font name Syntax lt Script Language avascript gt document TTSComponent FontName szFontFile lt Script gt Possible Value This property is a String and can be set to any system truetype font name If the specified font name is not existed TTS Web Player will use the system default font name Remarks None Back to Property Summary FontSize This property specifies the display font size Syntax lt Script Language avascript gt document TTSComponent FontSize pxSize set var pxSize document TTSComponent FontSize get lt Script gt Possible Value This property is an Integer and specifies the font size in pixels Remarks None Back to Property Summary FontStyle This property specifies the display font style Syntax lt Script Language avascript gt document TTSComponent FontStyle nStyle set var nStyle document TTSComponent Font
6. Reallusion TTS Web Player White Paper For CT4 Web Player Document Version v1 0 TTS Web Player Version 1 0 Contents Embedding TTS Web Player within HTML ooonccionnicnnnccnnnonnnnononcnncnnoncncncnnnnccannccnnno 3 Controling CrazyTalk 4 web player nnsunnsnnsnnnnemannnnnnnnnnnnnnnnnannannonannemmannannann nn 4 Player Initialization ceda a Eee a 5 COMMERCIAL OR ACTON ci ages cede een 5 Invoking Methods essen ee a 6 Capturing Script Events from TTS Web Player nnsnsneennennenannennnnnnnnnnnnnennnnenn 7 Capturing Script Events from the TTS Web Player ssnnnennnenennnnennenenn 7 TTS Web Player Property Summary unnsersnsnensnsnannannnnnnnnnnannonnnnnnnnannennonnnannnnn nn 8 A ee te in ee ee 9 lo AAA nase ee 10 A een tee 11 FORTSIZE ee ee u a u E et 12 FONS een db doo 13 AN 14 A A Sa ee erteilen 15 SDEOU ee se ae ee ann 16 Tex om e ctas een 17 A i Pr arr Se eres 18 MOICE EP ae E ET er an 19 NOUTMO Se ent 20 TTS Web Player Method Summary 2 2 er 21 A ae ee 22 O es ee sn 23 DetacnGtl at Beisein lest 24 GEO ICO Oo Ug Eee Bu e 25 O oleate Sindee oa lat 26 PS ee e tet det acre cadet y e ect te ata 27 PUL sheds dedo meses a lie o cael la 28 SON OIC NAME o en eta its 29 STONE ek NE eZ nS ee eee 30 TTS Web Player Event Summary aan 31 O O E St BE ee a ee En TE 32 Pausen ee de acacia o ee ON eeu hah E en 33 STOP ee as A u Fee 34 WordPositionChange cect Sed ean hese topic scada 35 Embedding the
7. Style get lt Script gt Possible Value This property is a Integer that includes one or a combination of the following values Value Description 0 Regular 1 Bold 2 Italic 4 Underline Remarks A value 3 1 2 for the FontStyle property indicates that the font style is Bold 1 and Italic 2 Back to Property Summary ForeColor This property specifies the text color of the TTS Web Player Syntax lt Script Language avascript gt document TTSComponent ForeColor iColor set var Color document TTSComponent ForeColor get lt Script gt Possible Value This property is an Integer with a default value of 000000 It consists of an RGB color in OXBBGGRR format Example Value Description OXOOFFOO Green color OXFFOOOO Blue color OXOOOOFF Red color Remarks None Back to Property Summary Pitch This property specifies a value that indicates the speaking pitch of the TTS Engine Syntax lt Script Language avascript gt document TTSComponent Pitch nPitch set var nPitch document TTSComponent Pitch get lt Script gt Possible Value This property is an Integer that takes a value between O and 100 Remarks None Back to Property Summary Speed This property specifies a value that indicates the speaking speed of the TTS Engine Syntax lt Script Language avascript gt document TTSComponent Speed nSpeed set var nSpeed document TTSComponent Speed get lt Script gt Po
8. ay Language J avaScript gt lt insert script commands gt lt Script gt Parameters None Remarks Calling the Play method causes this Event to occur Back to Event Summary Pause This Event occurs when the TTS Web Player is paused Syntax lt Script FOR TTSComponent Event Pause Language J avaScript gt lt insert script commands gt lt Script gt Parameters None Remarks Calling the Pause method causes this Event to occur Back to Event Summary Stop This Event occurs when the TTS Web Player is stopped Syntax lt Script FOR TTSComponent Event Stop Language J avaScript gt lt insert script commands gt lt Script gt Parameters None Remarks Calling the Stop method causes this Event to occur Back to Event Summary WordPositionChange This Event occurs when the current sentence is spoken Syntax lt Script FOR TTSComponent Event WordPosition Change strSentence Language J avaScript gt lt insert script commands gt lt Script gt Parameters strSentence A text String which is the sentence currently being spoken by the TTS Engine Remarks This Event occurs multiple times during the speaking period Back to Event Summary EOF This Event occurs when the end of the file is reached Syntax lt Script FOR TTSComponent Event EOF Language J avaScript gt lt insert script comman
9. ds gt lt Script gt Parameters None Remarks None Back to Event Summary
10. ed of the TTS Engine 0 100 Pitch Sets the speech pitch of the TTS Engine 0 100 Volume Sets the speech volume of the TTS Engine 0 100 AutoLoop A value of 1 sets the speech to auto restart when finished and O sets the speech to stop e TextContent Sets the text that will be spoken by the TTS Engine e VoicelD Sets the voice that you want to use in the TTS Engine You can copy and paste the above example into an existing web page The TTS Engine assigned by the TTSEngine property such as Microsoft SAPI4 and SAPI5 must be installed on your computer in order for the TTS Web Player to operate properly Each TTS Engine includes various voices and names and one can list these voices using Javascript Readers can choose among them by using Javascript or through the TTS Web Player user interface Controlling the CrazyTalk Web Player You can configure the CrazyTalk4 Web Player to show a viseme and expressions by placing a CrazyTalk4 Web Player ActiveX control in the same HTML document and linking it to the TTS Web Player ActiveX control For operating any other ActiveX control in Microsoft Internet Explorer you must write JavaScript or VBScript code in the HTML document to enable that function An example of JavaScript code that will operate a CrazyTalk4 Web Player ActiveX control linked with the TTS Web Player ActiveX control is shown below lt OBJECT CLASSI D CLSI D 13149882 F480 4F6B 8C6A 0764F75B99ED
11. guage avascript gt document TTSComponent DetachCtrl lt Script gt Parameters None Remarks None GetVoiceCount This method returns the voice count for the current TTS Engine Syntax lt Script Language avascript gt var nCount document TTSComponent GetVoiceCount lt Script gt Parameters None Remarks None GetVoiceString This method returns the name of the specified voice Syntax lt Script Language avascript gt var strName document TTSComponent GetVoiceString int nl ndex lt Script gt Parameters ni ndex An Integer value that specifies the voice from its index in the TTS Engine This value must be between O and the value obtained from calling GetVoiceCount Remarks None Back to Method Summary Pause This method suspends the current playback at the current position Syntax lt Script Language avascript gt document TTSComponent Pause lt Script gt Parameters None Remarks This method performs the same action as clicking the Pause button on the control bar Calling this method will cause a Pause Event to occur Back to Method Summary Play This method starts the speech playback Syntax lt Script Language avascript gt document TTSComponent Play lt Script gt Parameters None Remarks This method performs the same action as clicking the Play button on the control bar Calling this method will cause a Play Event and many WordPosition
12. n call the GetVoliceCount method to get a count of the available voices Back to Property Summary Volume This property specifies a value that indicates the speaking volume of the TTS Engine Syntax lt Script Language J avascript gt document TTSComponent Volume nVolume set var nVolume document TTSComponent Volume get lt Script gt Possible Value This property is an Integer that takes a value between O and 100 Remarks None Back to Property Summary TTS Web Player Method Summary SetvoiceByName oiceBy Name Sets the Voice by assigning a voice name GetVoiceString Gets the voice name for each voice tVoi AboutBox This method shows information about this ActiveX control Syntax lt Script Language avascript gt document TTSComponent AboutBox lt Script gt Parameters None Remarks None AttachCtrl This method attaches an ActiveX control to the TTS Web Player Syntax lt Script Language avascript gt document TTSComponent AttachCtri IDispatch IpObject lt Script gt Parameters IpObject An object that will be controlled by the TTS Web Player Currently only a CrazyTalk Web Player object can be assigned to this method Remarks The result of assigning an object other than the CrazyTalk Web Player to this method is unpredictable Back to Method Summary DetachCtrl This method detaches the attached object from the TTS Web Player Object Syntax lt Script Lan
13. shows how to handle the Events in the TTS Web Player Capturing Script Events from the TTS Web Player Syntax lt Script Language avaScript For TTSComponent Event Event Pn gt code goes here lt script gt Description TTSComponent The ID specified in the lt Object gt section e Event Pn The Event to capture and its parameters Pn Let s use the Pause Event as an example The TTS Web Player fires a Pause Event whenever it is paused The Pause Event carries no parameter The following sample code will capture the Pause Event and then prompt the user of this Event by using the Alert command of JavaScript Example lt Script Language avaScript For TTSComponent EVENT Pause gt alert Pause lt script gt For a full list of supported TTS Web Player Events consult Appendix D TTS Web Player Event Summa ry TTS Web Player Property Summary AutoLoop Set to true in order to enable the TTS Player auto loop AutoLoop This property specifies the TTS Player auto loop or when not to play to the end Syntax lt Script Language avascript gt document TTSComponent AutoLoop bLoop Set var bLoop document TTSComponent AutoLoop Get lt Script gt Possible Value This property has a Boolean format and takes one of the following values Value Description True The Player will auto loop False The Player will not auto loop Default Remarks None Back to
14. ssible Value This property is an Integer that takes a value between O and 100 Remarks None Back to Property Summary TextContent This property specifies a text string that will be spoken by the TTS Engine Syntax lt Script Language avascript gt document TTSComponent TextContent strText set var nstrText document TTSComponent TextContent get lt Script gt Possible Value This property is a String value Remarks None Back to Property Summary TTSEngine This property specifies which TTS Engine will be used Syntax lt Script Language avascript gt document TTSComponent TTSEngine strTTSEngine set var strTTSEngine document TTSComponent TTSEngine get lt Script gt Possible Value This property is a String value and the currently possible values are given below Value Description Microsoft SAPI 4 1 Use Microsoft SAPI 4 1 as the TTS Engine Microsoft SAPI 5 0 Use Microsoft SAPI 5 0 as the TTS Engine Remarks Ensure that the specified TTS Engine is properly installed on your system Back to Property Summary VoicelD This property specifies the voice to be used by the TTS Engine Syntax lt Script Language avascript gt document TTSComponent Voicel D nVoicel D set var nVoicelD document TTSComponent nVoicelD get lt Script gt Possible Value This property is an Integer value with a default value of 0 Remarks Since the number of voices in a TTS Engine varies users ca
15. yer to AutoPlay add the following line to your script between the lt object gt and lt object gt tags lt PARAM NAME AutoLoop VALUE 1 gt Controlling the Interaction JavaScript can be used to control the TTS Web Player properties For example if you have an object named TTSComponent in your web page and want to access its property AutoLoop the script would be as follows TTSComponent AutoLoop 1 To set the value of the AutoLoop property var AutoPlay TTSComponent AutoLoop To get the value of the AutoLoop property For the details of all of the TTS Web Player properties please refer to the TTS Property Summary Invoking Methods Follow the usual object model to invoke a method through the TTS Web Player for Internet Explorer The following example defines Play and Stop buttons that invoke the Play and Stop methods of TTS Web Player The following codes have the same effect as the above There are many situations where code could be written to invoke methods in this way For a full list of supported TTS Web Player methods consult TTS Web Player Method Summary Capturing Script Events from the TTS Web Player The TTS Web Player in a web page sends specific messages to the browser to indicate that certain Events have occurred e g Play or Stop These messages are called Events Using JavaScript you can capture these Events and manipulate them to invoke a response The following example
Download Pdf Manuals
Related Search