Self-hosting and Updating CrazyTalk Web Player (New for 7.31)

After the necessary interactive assets and player are correctly placed as describe in the Managing Interactive Assets section for self-hosting methods, you willl be able to embed them into custom web pages.

There are two main types of self-hosting, Basic and Complete. The file management methods are different in each method. When the CrazyTalk web player is updated by Reallusion, you will also need to update the related files in accordance with the method you chose.

Self-hosting Concept - Basic

Self-hosting - Complete

The complete self-hosting method is when you download and put the related files such as the CrazyTalk Web Player (CTWebPlayer.unity3d), the CTWebPlayer.js and some other necessary files on your custom domain with the web player as shown below:

The Assets, CrazyTalk Web Player (CTWebPlayer.unity3d) and Custom Web Pages can be on the same or different domains as shown in the first section of the Managing Interactive Assets page.
The web player (to access interactive assets) is embedded into your custom web pages; it needs to have access to the CTWebPlayer.js file.
CTWebPlayer.js is on the same domain where your web player is.

To introduce CTWebPlayer.js into your web page, you must manually modify a line of code within the <head></head> block of your web page, in which the address or path leads to the CTWebPlayer.js:

Absolute Address Name (as the web pages are on different domains):
<script type="text/javascript" src="http://www.../.../CTWebPlayer.js"></script>;
Relative Address Name (as the web pages are on same domain):
<script type="text/javascript" src="/.../...CTWebPlayer.js"></script>
or
<script type="text/javascript" src="../...CTWebPlayer.js"></script>

Note:

Advantages:

Your web pages do not need to connect to the Reallusion server to make them work.
You are able to fully control the download bandwidth, as well as the assets and service accessibility.

Disadvantages:

You need to manual update all web player related resource files, such as the web player itself, the JavaScript (*.js) files and so on. Please refer to the next section for more information about the files.

Updating Web Player Related Files

Downloading and Updating for the Basic Self-hosting Method

If you use the Basic Self-hosting Method, then the steps you need to perform each time you are informed by e-mail for updating are shown below:

Download the latest SelfHost_Resource.zip file.

Unzip the file.

Note:

The files within the zipped file are:

CTWebPlayer.unity3d: This is the web player. You need to use JavaScript code to embed it into your custom web pages.
CTWebPlayer.js: This is the JavaScript file the web player needs for accessing certain necessary functions.
CTWebPlayer.min.js: This is a compressed JavaScript file of the CTWebPlayer.js. The size is smaller for downloading. Either file can be used to embed the web player on your custom web pages.
ctweblogo.png: This is the logo image that can be seen when the player is constructed after your web pages are opened. You are able to customize the logo to whatever you like.

Please also download the API documents for more information about the JavaScript functions you maybe need to use.

Replace the current web player on your self-hosting domain with the one extracted from the zipped file.
Modify the line of code in your custom web pages that has been embedded with the web player:
- Original:
  <script type="text/javascript" src="http://ctinteractive.reallusion.com/ctinteractive/1.0/CTWebPlayer.js"></script>
- Change to:
  <script type="text/javascript" src="http://ctinteractive.reallusion.com/ctinteractive/NEW_VERSION_NUMBER/CTWebPlayer.js"></script>

Downloading and Updating for Complete Self-hosting Method (Changing Logo)

If you use the advanced self-hosting method, each time you are informed about an update by e-mail, you need to follow the steps below (please note that these steps MUST be preformed the first time you create your custom web pages with a self-hosting interactive assets as well):

Downloading and Updating Web Player

Download the latest SelfHost_Resource.zip file.

Unzip the file.

Note:

The files within the zipped file are:

CTWebPlayer.unity3d: This is the web player. You need to use JavaScript code to embed it into your custom web pages.
CTWebPlayer.js: This is the JavaScript file the web player needs for accessing certain necessary functions.
CTWebPlayer.min.js: This is a compressed JavaScript file of CTWebPlayer.js. The size is smaller for downloading. Either file can be used for working with the web player with your custom web pages.
ctweblogo.png: This is the logo image that can be seen when the player is constructed after your web pages are opened. You are able to customize the logo to whatever you like.

Please also download the API documents for more information about the JavaScript functions you may need to use.

Replace the current web player and related files on your self-hosting domain with the ones extracted from the zipped file (please note that you may use either one of the .js files from the zipped file).

Accessing Self-hosting resource files

After the assets, web player and related files have been correctly placed, you may follow the steps below to introduce them into your custom web pages.

Get the absolute or relative address or path name of the web player (CTWebPlayer.unity3d), the JavaScript (CTWebPlayer.js or CTWebPlayer.min.js) and the logo image (ctweblogo.png).
- Absolute Address Name (as the web pages are on different domains):
  http://www.../.../CTWebPlayer.js
- Relative Address Name (as the web pages are on same domain):
  /.../...CTWebPlayer.js
  or
  ../...CTWebPlayer.js

Use the address or path name to access the files from your custom page by adjusting the code of your custom web pages.

Accessing the JavaScript (CTWebPlayer.js or CTWebPlayer.min.js)

Accessing the Web Player (CTWebPlayer.unity3d)

Accessing or Setting Custom Logo Image

Offline Self-hosting with Local jQuery, UnityObject2

When introducing any CrazyTalk Interactive Assets in to your custom web pages, there are fundamental JavaScript code lines must be added into the <head> block of the pages.

These lines access the important JavaScript files for jQuery and UnityObject2, which can only be accessed online, no matter if you have applied Basic or Complete self-hosting methods.

Once you are disconnected from the internet, these two files can not be accessed any longer, which means that the CrazyTalk Web Player will no longer work. You need to follow the steps below for OFFLINE self-hosting.

Self-hosting and Updating CrazyTalk Web Player (New for 7.31)

Downloading and Updating for the Basic Self-hosting Method

Downloading and Updating for Complete Self-hosting Method (Changing Logo)

Downloading and Updating Web Player

Accessing Self-hosting resource files

Accessing the JavaScript (CTWebPlayer.js or CTWebPlayer.min.js)

Accessing the Web Player (CTWebPlayer.unity3d)

Accessing or Setting Custom Logo Image

Downloading and Updating JavaScript for jQuery and UnityObject2

Accessing the Local jQuery and UnityObject2