wiki:QuickStart

Version 33 (modified by welberge, 7 years ago) (diff)

--

Installing AsapRealizer

Currently AsapRealizer is only available for employees and students of the Sociable Agents group in Bielefeld, CITEC employees and members of the Human Media Interaction group in Twente.

Install Java

AsapRealizer requires Java 1.7 or greater. On techfak 64 bit linux computers java 1.7 can be installed through applications->techfak->RCINFO package selector, select jdk-1.7.

Install Apache Ant

AsapRealizer's build system makes use of  apache ant. Techfak users working on 64 bit linux machines already have ant installed; they only need to set up the ANT_OPTS variable (e.g. in their .bashrc)

export ANT_OPTS="-Xmx256M -XX:MaxPermSize=256M"

For others:

  • Obtain the latest version of Apache Ant (version >= 1.8.2)
  • put the ant bin directory on your PATH
  • add the following line to the top of the file used to start ant (found in directory ant/bin) (e.g., on windows: ant.bat):
set ANT_OPTS=-Xmx256M -XX:MaxPermSize=256M

Directory structure

Create a top level directory and clone the following git repositories in this directory:

AsapDemo.git
hmibuild.git
asapresource.git
HmiResource.git

TODO: HmiResource and asapresource should be optional (but currently aren't). Fix this (#17).

See GitRepositories for the location of the repositories.

Quick start: try out the AsapRealizerDemo

AsapDemo contains, among other things, an example projects for quick start of an AsapRealizer application.

To try this out, do the following in AsapDemo/AsapRealizerDemo:

ant resolve
ant main      # and then select AsapRealizerDemo by pressing enter
ant

You should now get 2 Java windows, one with the graphical environment in which the Armandia avatar is shown, and one in which some default BML examples can be selected and custom BML can be tried out. AsapRealizer supports BML 1.0, see BML for the recent list of supported BML 1.0 features and the BML extensions provided by AsapRealizer.

Using different AsapRealizer configurations

AsapRealizer provides an XML specification system (see also VirtualHumanSpec?) that can be used to flexibly configure most of its properties (e.g. middleware connection, TTS properties, user interfaces to be shown, graphical embodiments, engines (for e.g. facial animation, speech, animation, audio, etc) to be used). Several examples are provided in the resource dir. By default the demo uses the asaparmandia.xml specification.

You can select a different configuration using:

ant run -Drun.argline="specname.xml"

where "specname.xml" is your specification, which must be located on the classpath (e.g. in the resource dir).

How to continue from here?

You can now try out and get familiar with BML control of your avatar. You can create a copy of this project to create your own AsapRealizer application. When this first example project is working, you might want to read into how to configure AsapRealizer using the VirtualHumanSpec? XML configuration files, you might start to read up on the setup and use of the BuildSystem, or you might want to figure out how to use these projects in Eclipse (see UsingAsapRealizerInEclipse).

A note on resources-- If you want to play around with your own resources, changing some of the default settings and gesture repertoire of the avatar, read the documentation on UsingResources.

User Contributions

Discussion

QuickStart
 unsolved

If you have additional suggestions, hints, tips, or comments, please add them here by replying to this topic.