wiki:QuickStart

Version 25 (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 this can be done through applications->techfak->RCINFO package selector, select jdk-1.7.

Install Apache Ant

Later on in this document, you will find information on using the Asap modules in Eclipse. It is easier, though, to start testing the whole setup using the command prompt and Apache Ant.

  • 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
hmibuild
asapresource
HmiResource

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 (select AsapRealizerDemo)
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.

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.