How to use the Tellme VoiceXML Browser in Eclipse VTP
With the VTP daily build
from 9 January 2006, the VTP tools now include an application launcher that
will allow the user to run his application on Tellme Studio. Please feel free
to try this new feature and offer comment. We want this to be as useful as
possible.
Prerequisites:
1. You must have a
version of the Eclipse Voice Tools Project that incorporates the Tellme Browser
plugins. These plugins are in the VTP daily build.
Please refer to the VTP
website at http://eclipse.org/vtp
for information and files to create an installation.
2. The Tellme Browser makes a phone
call to Tellme Studio using the Skype VoIP phone, so your machine must have the
Skype client installed, and you must be a registered Skype user. You will
NOT have to purchase SkypeOut minutes to use the Tellme Browser.
§
download
Skype from http://www.skype.com/products/skype/windows/
§
run
SkypeSetup.exe to install the client
§
if
you are not a registered Skype user, follow the instructions in the Skype
client to sign up.
§
configure
Skype to start up and automatically log you in when Windows starts.
§
operation
has been confirmed with versions 1.3, 1.4, and 2.0 Beta of the Skype client for
Windows.
The
Tellme Browser
The Tellme Browser is accessed from the Run menu of VTP. When the Run… command is chosen from the Run menu, a launch configuration dialog
page is opened.
In the left-hand pane of that dialog there
is a list of the various launch configuration types supported by your Eclipse
installation. Select VoiceXML Application and
click on the New button below the
pane. A launch configuration page for the Tellme VoiceXML Browser will open.
On that launch configuration page one
specifies the user ID and PIN for Tellme Studio. One also specifies the URL of
the application to be run. The Tellme Browser expects the VoiceXML application
to be hosted on some web server. It can be any server to which you have access,
though the development of this plugin was done using a copy of the Tomcat
server co-located on the same machine as Eclipse VTP, and that works very
conveniently.
When the Run
button at the bottom of the launch configuration dialog is pressed, the Tellme
Browser then:
§
uses
programmed HTTP calls to set Tellme Studio with your application URL
§
places
a call to Tellme Studio using the Skype client. The call is made to
+18005558965
the
Skype client will open its own window. Do not use it for DTMF, please.
§
automatically
sends your Studio ID and PIN
§
the
Tellme Studio will assign an ID number for the call
§
waits
for the call to complete successfully
§
streams
the debug log entries from Studio into an Eclipse VTP Browser input view
§
the
input view pane contains a table for showing the debug log, and it also offers
a dialpad and a “stop” button
If
the Browser is unable to communicate with Studio for any reason, an error
dialog will open giving a status message, and the launch will end.
If the call fails for any reason, an error
dialog will open showing the failure reason.
If it is necessary to end the call before
the voice application is complete, it is best to use the Stop button that appears on the toolbar of
the Browser Input View.
Sometimes the debug log streaming ends and
the connection to Studio waits to time out. The call is not complete until an
“End of Call” dialog box pops up that says “Call nnnn has
completed.” Please do not start another launch until a dialog appears,
either the “End of Call” dialog or one that indicates some error.
Issues
you may encounter:
§
The
call via Skype is done via SkypeOut and routing of SkypeOut calls can be slow.
It can take 30 seconds or more to route the call.
§
The
connection from Skype to +18005558965 can be flaky. The reason is understood,
and we look forward to a future resolution. Sometimes the call will cause a “fast”
busy signal, even though the line is truly not busy. When this happens, press
the big red button in the Skype window. Try again. This is the one
situation where you will need to press a button in the Skype window.
§
When
Studio returns the debug log, there is a variable and sometimes significant
delay before the data begins streaming into the table in the Input View. Be
patient.
§
timing
is important. The Browser sends the ID and PIN to Studio shortly after the call
is answered. Occasionally Studio response is delayed a bit and the ID and PIN
are not heard. If this happens, you can enter your ID and PIN as usual by voice
when Studio requests it. The call will proceed and the debug log will be
streamed normally.