PageRenderTime 28ms CodeModel.GetById 20ms app.highlight 3ms RepoModel.GetById 1ms app.codeStats 0ms

#! | 69 lines | 46 code | 23 blank | 0 comment | 0 complexity | 4206b6b4fc45fa290be45c3cebf433d6 MD5 | raw file
 1#    -*- mode: org -*-
 3* Introduction
 5The Text-To-Speech (TTS) library is allows developers to add speech to their applications. Developers give the TTS object a text string, and the TTS will take care of converting that string to text and speaking it to the user.
 7The TTS library is designed such that different underlying speech engines can be used without affecting the higher level application logic. Currently, a port of the [[][eSpeak engine]] is available.
 9* Requirements
11Using the eSpeak engine requires the user to have an SD card with free space available that the phone can access. The voice data for eSpeak will be downloaded and unzipped onto the SD card when the TTS is first run.
13Note that if the SD card is mounted on the computer, it will not be accessible to the phone. You must unmount the SD card from the computer before the TTS will work properly.
15* Setting Up an Eclipse Project That Uses the TTS
171. [[][Setup an Android project as you would normally.]]
192. Go to Project > Properties > Java Build Path > Libraries and click on "Add External JARs..."  Then add in the [[][TTS_library_stub.jar]] file.
213. Start coding!
23* A Step-By-Step Tutorial To Get You Started
25This tutorial will take you step-by-step through writing a simple Hello World application. [[][It assumes that you have Eclipse setup to work with the Android SDK already.]] 
271. [[][Get the TTS_library_stub.jar file from the downloads area.]] If you want to develop against the upcoming release, get the release candidate version by grabbing the _rc.jar and installing the _rc.apk on your phone. If you want to develop against the version of the TTS that is currently on Market, get the _market.jar and install the TTS from the Android Market. You should always build your app using the _market version before you release it on the Market; otherwise, there is a high probability that your app will not work correctly as most users will be on the Market version of the TTS and not the release candidate. 
292. Start Eclipse. Go to "File" > "New Project" > "Project..." and choose "Android Project" under "Android". Fill out the information and click "Finish" to generate the skeleton for a project. The rest of this tutorial assumes that you named your application "HelloWorldTTS".
313. Select your project in the "Package Explorer", then go to "Project" > "Properties". Select "Java Build Path" and click on the "Libraries" tab. Click on "Add external JARs..." and select the TTS_library_stub.jar from step 1.
334. You should see two Java files in your project: and Open and do the following:
34  -In the imports section at the top of the file, add this line:
35     import;
36  -After the line "public class HelloWorldTTS extends Activity {", add this line:
37     private TTS myTts;
38  -Add the following as the last line of the onCreate method:
39      myTts = new TTS(this, ttsInitListener, true);
40  -After the onCreate method, add these lines:
41    private TTS.InitListener ttsInitListener = new TTS.InitListener() {
42        public void onInit(int version) {
43          myTts.speak("Hello world", 0, null);
44        }
45      };
475. [[][Now you should have a that looks something like this.]]
496. Build this app, install it on your Android device, and run it. You should hear the TTS say "hello world" if you have the TTS library installed on the phone and your SD card contains the needed voice data files. If you do not have the TTS library installed on the phone, you will be prompted to install it. If this is the first time you have used an app that uses the TTS, you will hear the TTS spell out "h e l l o w o r l d" very fast and see a screen that says your device is downloading the voice data files; if you rerun the app, you will hear the TTS say "hello world" as it should.
517. Congratulations! You just wrote your first TTS-enabled Android app! Please [[][see the documentation on the TTS]] and [[][look at other apps in the eyes-free project]] to learn more about how to use the TTS. 
54 -The TTS constructor takes 3 parameters: the application Context, the TTS.InitListener to call upon successful initialization of the TTS, and whether or not to show a message prompting the user to install the TTS from the Market if they have not done so already.
55 -The speak call takes 3 parameters: the String of text to be spoken, an int that indicates the queuing strategy (0 for no queuing, 1 for fifo queuing), and an array of Strings that are parameters for how to speak the text.
56 -The first time you run an app that uses the TTS, if you do not already have the necessary speech data files on your SD card, they will be downloaded automatically.
58* Tips and Tricks on Using the TTS in Your App
60For some tips and tricks on using the TTS in your app, please see the usage notes here.]]
63#+TITLE:     Developing Speech Enabled Android Applications
64#+AUTHOR:    Charles L. Chen
66#+DATE:      2008-12-10
67#+LANGUAGE:  en
68#+OPTIONS:   H:3 num:t toc:nil \n:nil @:t ::t |:t ^:t -:t f:t *:t TeX:t LaTeX:nil skip:nil d:nil tags:not-in-toc