Article ID:	246
Last updated:	November 02, 2006

Would you like to...

Print this page

Post a comment

User Opinions

No users have voted.

---

How would you rate this answer?

Helpful

Not helpful

Thank you for rating this answer.

SUMMARY

This article explains how to use the Audium Java API to create an On Call Start action which will select a gateway adapter dynamically at runtime.

SYMPTOMS

Developer or administrator needs applications to have the ability to dynamically change which gateway adapter they use, without being redeployed from Audium Studio.

RESOLUTION

On Call Start actions have the unique ability to change the selected gateway adapter, because they execute before any VoiceXML is produced.  In the code of your custom On Call Start action, use the following method to change the selected gateway adapter:

public void setVoiceBrowser(String browser) throws AudiumException

where browser is the real name of the gateway adapter you wish to use.  It is generally more useful to read the adapter name from a database or configuration file rather than hard-coding it.  This way, administrators can update which gateway adapters deployed applications use and/or the gateway adapter choice can be based on some runtime conditions and logic.

This method is part of the CallStartAPI class.  For details, please refer to the Audium Java API Javadocs.  Note that the specified gateway adapter must be installed on Audium Call Services in order for this dynamic change to be successful.  Additionally, even if the gateway adapter is installed, your Audium Call Services license must include support for it.

You can download fully-commented skeleton code for an On Call Start action from this post in our Sample Java Code forum.