How the licensing works
Each applet will play only a limited amount of time without a
license. In order to license it for unrestricted play you must
purchase a key from a Clipstream™ partner or sales representative.
To do so: call 1-800-8-DESTINY and ask to speak to a Clipstream™
representative about Clipstream™ Audio. You will receive
a codekey string that looks like this:
- Note: save this CodeKey in a safe location. There is an
administrative charge for looking up or replacing lost CodeKeys.
Licensing for individual applets or by common text file (KeyURL
method)
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.
If you are hosting many dozens of applets and have a license that
will expire within two years, you should use
the
KeyURL method.
Licensing by entering a single parameter line in
each applet code
- 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).
- View the source and locate
the applet code.
- 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">
- 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.
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.
- Open up a page which has the Clipstream™ Audio embedded.
- View the source and locate
the applet code.
- 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">
- 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.
