Setting Up the HumanIK License Key

The Gameware license key is a single 40-character string that consists of a mix of upper-case letters and numbers. For example:

6QYQXOSIJKYDM13K9ETMJBJHK04E8NS1LNAEOG7C

Evaluating the license key

Every Gameware license key is time-limited. The key is validated differently depending on whether you are using an evaluation copy of HumanIK or a complete, fully licensed copy.

In short:

In evaluation packages, the license key is required in order to successfully create a HumanIK character, or to load a HumanIK character from a dumped file or from a memory stream. Both the format of the key and its expiry date are checked.
In fully licensed packages, the key is never checked. In API functions that require you to provide a key, you can use any string value or a null value.

For additional details, see Evaluation Versions vs. Complete Versions.

Note that the evaluation build verifies the time-limited license key on all platforms, including consoles. It is therefore crucial that you download the fully licensed package and update your game to use the libraries in the fully licensed package before you ship your game.

Obtaining the license key

As of HumanIK 2013, license keys are obtained through the Autodesk Gameware website.

To obtain your license key:

Open http://gameware.autodesk.com in a web browser.
If you are a new user, choose Register and follow the steps for creating a new Gameware Account; if you are a returning user, choose Login.
Choose HumanIK from the product list.
Enter your Username and Password and click Login.

NOTE:if you have reached this point without having registered, click Register to start the registration process.

Once logged in, choose Account Project Information.
On the Project Information screen you will see a list of current keys. If you do not have a Gameware key associated with your account, click the Request Gameware Key button. Your request is processed automatically.
Your key will be added to your account.
Use the newly generated key as indicated in Setting Up the License Key below.

Setting up the license key

The HumanIK license file is a C++ header file, autodeskmwkey.h, that defines a constant named AutodeskCustomerString for the Gameware key. For example, a typical license file is as follows:

#ifndef GTG_KEY_INCLUDE 
#define GTG_KEY_INCLUDE 

#define AutodeskCustomerString "6QYQXOSIJKYDM13K9ETMJBJHK04E8NS1LNAEOG7C" 

#endif

To set up your license key:

Place the autodeskmwkey.h file in the include directory within your HumanIK installation directory. The HumanIK sample projects expect the license file to be accessible at this location.
Add the autodeskmwkey.h file to the list of #include files in any source code file in which you call the HIKCharacterCreate() or HIKLoadCharacter() function to create an HIKCharacter.
For example:
```
#include "autodeskmwkey.h" 
```

In each call to HIKCharacterCreate() or HIKLoadCharacter(), provide the AutodeskCustomerString value, pre-defined in the autodeskmwkey.h file, as an argument.

For example:

HIKCharacter * MyChar = HIKCharacterCreate(&MyDef, &malloc,
                                    AutodeskCustomerString,
                                    );

For details on the HumanIK initialization process, see Initialization.

Hard-coding your credentials, or retrieving them from another source

As an alternative to the approach described above, you are free to hard-code your Gameware key in your calls to HIKCharacterCreate(), or retrieve the values of your credentials from another custom source.

However, this has the following implications:

All HumanIK samples retrieve the AutodeskCustomerString constant from autodeskmwkey.h for their calls to HIKCharacterCreate() or HIKLoadCharacter(). If you do not provide the Gameware license in the autodeskmwkey.h file, you will need to modify the samples to retrieve the key from your own custom source.

Updating the license key

If your license key expires during your evaluation, contact Autodesk Support for a new key. See Setting Up the HumanIK License Key above.

When you receive your new key, simply replace your old key with the new value.