Version 45 (modified by welberge, 6 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.

Prepare your system for AsapRealizer as described in RecommendedSystemSetup.

Directory structure

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


See GitRepositories for the location of the repositories and clone instructions. If SoaScript is installed, the easiest way to clone the repositories is by using:

soa clone AsapDemo
soa clone hmibuild

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/java:

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

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 VirtualHumanLoader) 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).

Sending BML through code


AsapVirtualHuman vh = ee.loadVirtualHuman("humanoid", "", spec, "AsapRealizer demo");
RealizerPort realizerPort = vh.getRealizerPort();
realizerPort.performBML("<bml ... </bml>"); 

to send BML to AsapRealizer using Java.



you can add a listener for BML feedback.

You can also send BML using one of the supported middleware platforms, or hook up your own middleware for this (see MiddleWareConnection).

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 VirtualHumanLoader 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



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