Three methods for licensing applets

There are three different methods for activating individual Clipstream Audio applets.

1. Method 1: Entering the CodeKey in the Clipstream Audio Encoder
   
   Advantage: Every clip encoded by the Encoder application will be output with a valid key.
   Disadvantage: Not suitable when Encoding for more than one key. If a different key is provided, then it must be changed in the application.
   
   
2. Method 2: A CodeKey inserted as a parameter in each applet code
   
   Advantage: Quick cut and paste for those familiar with web coding.
   Disadvantage: Editing the applet code for dozens of clips would be labourious; If the licensing needs to be updated, then each code must be revisited.
   
   
3. Method 3: Licensing for Common Text File on the server
   
   Advantage: Only one text file needs to be updated. All applets point to that one text file.
   Disadvantage: An extra step not needed when presenting a handful of clips.
   

Method 1: Licensing by entering CodeKey into the Clipstream Audio Encoder

You can enter in the CodeKey into the Encoder itself so that each clip it generates will generate the key as part of the applet on the generated .html page.

In the Encoder:

1. Go to the Licensing menu and select Enter CodeKey
   
   
   
   -or-
   
   Press CTRL-E.
   
   The Enter CodeKey / Website URL page appears.
   
   
2. Paste your CodeKey into the field Enter CodeKey.
   
   
   
   
3. Click OK.

Now when you generate any clip using the Encoder, that CodeKey will be embedded into the applet player in the generated .HTML page.

If you acquire a new CodeKey or need to generate a licensed clip for a different website, make note of your old CodeKey and paste the new one into the space field, overwriting the old one.

Method 2: Licensing for individual applets

If you are deploying a small number of applets (clips) or have purchased an unlimited license that will never need updating, you can license each individual applet without difficulty.

Licensing by entering a single parameter line in each applet code

1. Open up a web page with a Clipstream™ applet already embedded in your prefered web development program or with a text editor (not Microsoft Word).
   
2. View the source and locate the applet code.
   
3. Insert the following parameter line anywhere among the other parameters:
   
   <PARAM NAME="Key" VALUE="[paste the codekey given to youhere]" >
   
   Note: do not include the square brackets.
   
   It will look like this example:
   
   <PARAM NAME="Key" VALUE="APQ36SH57889CFH9LZ2M">
   
   
4. Save and upload this page.
   
   When you view this page in your browser the clip should play all the way through.
   
   The disadvantage of this method is that you must do this for each applet and if there is any change in your licensing (expiring key, for example) you must then replace this line in each page in which Clipstream™ Audio is embedded.

Method 3: Licensing by common text file on your webserver (KeyURL)

Clipstream™ Audio can refer to codekeys in a text (.txt) file called the codekeys.txt. Simply put, this is just a text file that you have pasted your codekey into which you have uploaded to the same server as your videos. A line of code in each applet refers to this text file. If you change your licensing or add time-restricted campaigns (such as ad campaigns) all you do is add the new codekeys into the same .txt file.

1. Use Notepad or other text editor to create a .txt file. (Notepad can be found under the Accessories submenu in your Start menu)

2. Paste the CodeKey into the .txt file. (each new CodeKey should be on a new line)

Note: you can comment keys by typing a # symbol. Anything to the right of that symbol is ignored

3. Save the file as codekeys.txt (if you choose to save under a different name you must refer to it by this different name in your KeyURL parameter line).

4. Upload this file to your webserver and make a note of its location.

Note: you only need one codekeys.txt. All of your audio applets can refer to a single .txt file.

Create a KeyURL parameter in each applet

Each applet must now reference this codekeys.txt from a new parameter called the KeyURL parameter. You will only have to do this once for each applet even if you update your licensing.

1. Open up a page which has the Clipstream™ Audio embedded.
   
2. View the source andlocate the applet code.
   
3. Insert the following parameter line anywhere among the other parameters:
   
   <PARAM NAME="KeyURL" VALUE="[relative link to and filename of the codekeys.txt]" >
   
   Note: do not include the square brackets.
   
   It will look like this example:
   
   <PARAM NAME="KeyURL" VALUE="/clipstream/codekeys.txt">
   
4. Save and upload this page.
   
   When you view this page in your browser the clip should play all the way through.
   
   The advantage of this method is that you can make all of your license adjustments in the single codekeys.txt file rather than in every single applet.