HDFVR Installation & Documentation

1. Installation intructions
- 1.1 installing the hdfvr app on the media server
- 1.2 installing HDFVR on your web site
2. Where are the resulting flv files?
3. How can I play back the .flv files?
4. Where can I find the snapshots?
5. How to switch to asp
6. How to connect HDFVR's on different web sites to the same media server
7. How to change where the media server saves the .flv files
8. How to change/reset the license key
9. How to translate HDFVR

1. Installing HDFVR on your web site

Download from your client/trial area the HDFVR archive (hdfvr.zip) and extract it somewhere on your web site.

1.1 Installation Part 1, installing the hdfvr app on the media server:

On Red5 0.8	On FMIS	On Wowza
1) Copy the Red5_0.8/hdfvr folder (from the hdfvr.zip archive) to your Red5/webapps folder. 2) Restart Red5.	Copy the FMIS/hdfvr folder (from the hdfvr.zip archive) to your FMIS/applications folder. If you're using FMIS hosting create a new application/folder named hdfvr and in it upload the contents of the FMIS/hdfvr folder (from the hdfvr.zip archive).	Copy the applications, conf and lib folders (you will find them in the Wowza folder from the hdfvr.zip archive) inside the Wowza installation folder. 2) Restart Wowza.

On Red5 0.8

On FMIS

On Wowza

1) Copy the Red5_0.8/hdfvr folder (from the hdfvr.zip archive) to your Red5/webapps folder.

2) Restart Red5.

Copy the FMIS/hdfvr folder (from the hdfvr.zip archive) to your FMIS/applications folder.

If you're using FMIS hosting create a new application/folder named hdfvr and in it upload the contents of the FMIS/hdfvr folder (from the hdfvr.zip archive).

Copy the applications, conf and lib folders (you will find them in the Wowza folder from the hdfvr.zip archive) inside the Wowza installation folder.

2) Restart Wowza.

1.2 Installation Part 2, installing HDFVR on your web site:

1.2.1 Standalone installation:

Copy the contents of Files to upload to your web site from the received archive in a folder on your web site

Edit avc_settings.php (or avc_settings.asp) with a text editor and set the value of $config['connectionstring'] to the correct connection string for your new media server app, here is how it should look:

$config['connectionstring']='rtmp://mymediaserver.com/hdfvr/_definst_';

$config['connectionstring']='rtmp://my.media.server.ip/hdfvr/_definst_';

$config['connectionstring']='rtmp://localhost/hdfvr/_definst_';

Go to http://www.yoursite.com/your_new_video_recorder/videorecorder.html , you will be asked for your license key which you can obtain from the customer area on AVChat.net! (Use videorecorder-hd.html to record a HD video!)

1.2.2 Integration Kits installation:

Video Profiler for Social Engine 4: See the installation instructions included in the Module Archive

2. Where can I find the resulting .flv files?

on Red5 in Red5/webapps/hdfvr/streams/_definst_
on FMIS in FMIS/applications/hdfvr/streams/_definst_
on Wowza in Wowza/content

By default all the recordings will be saved on the media server even tough the user has not pressed [SAVE]! To keep only the recordings for which the user has pressed the [Save] button edit avc_settings.xxx and change the deleteUnsavedFlv var to true.

3. How can I play back the resulting FLV files?

right from the media server trough streaming using a flv player
move them to a web server to:
- make them available for download
- play them trough progressive download using a flv player.

Both JW FLV Media Player and Flowplayer support both streaming and progressive download!

4. Where can I find the snapshots?

After recording your first movie look for a new folder called snapshots on your web server in the folder where you installed HDFVR. The .jpg filename corresponds to the .flv filename on the media server.

By default a snapshot of the recording is taken at second 5 and it is saved/uploaded to the web server when you press the [Save] button (or when the video finishes streaming/uploading to the media server if hideSaveButton=1 in avc_settings.xxx)!

You can modify the second at which the snapshot is taken by editing avc_settings.xxx and changing the value of the snapshotSec variable!

You can stop HDFVR from taking snapshots by editing avc_settings.xxx and changing the value of the snapshotEnable variable!

5. Switching between php and asp

By default HDFVR attempts to use the php files (avc_settings.php, save_video_to_db.php). To force HDFVR to use the .asp ones you need to:

Edit videorecorder-api.html with a text editor.

Replace videorecorder.swf with videorecorder.swf?sscode=asp in both places inside the HTML file.

Internet Explorer uses an Active X control to show Flash Player content. Firefox, Safari, Opera and the rest of the browsers use a plugin. This is the reason why you need to make the change in 2 places. One for IE, the other one for the other browsers

6. How to connect HDFVR's on different web sites to the same media server

Let's say you've bought 2 copies of HDFVR one for a.com one for b.com. You will have 2 different license keys!

To connect both to the same hdfvr app on the same media server just change the last part of the $config['connectionstring'] var value in avc_settings.xxx like this:

for a.com leave the default:
rtmp://mymediaserver.com/hdfvr/_definst_

for b.com change the last part to something else, for example:
rtmp://mymediaserver.com/hdfvr/siteb

Red5, FMIS:

the .flv files for a.com will be in streams/_definst_

the .flv files for b.com will be in streams/siteb

Wowza:

the .flv files for both sites will be in Wowza/content

7. How to change where the media server saves the .flv files

Wowza:

edit conf\hdfvr\Application.xml

change the value of the <StorageDir> tag:
<StorageDir>${com.wowza.wms.AppHome}/content</StorageDir> (this is the default)

save and restart Wowza

For example you could change the path to a folder inside your public Apache web server folder like this :

<StorageDir>/usr/sites/site.com/public_html/recorded_videos/</StorageDir>

FMIS:

copy Application.xml
from
Flash Media Server\conf\_defaultRoot_\_defaultVHost_\
to
Flash Media Server\applications\hdfvr\

edit hdfvr\Application.xml and change the value of the <StorageDir> tag:
<StorageDir></StorageDir> (by default it's empty)

save and

restart FMIS or

reload the hdfvr app using the FMS Management Console .

For example you could change the path to a folder inside your public Apache web server folder like this :

<StorageDir>/usr/sites/site.com/public_html/recorded_videos/</StorageDir>

Red5:

There's no easy way right now!

8. How to change/reset the license key

You will have to reset the license key (delete the old one) if you want to:

upgrade from the SD to the HD version (a new key is issued)

change the domain name which you want to us the HDFVR (a new key is issued)

any license key error

Here's how to do it:

On FMIS:

delete this file
Flash Media Server\applications\hdfvr\sharedobjects\_definst_\licensekey.fso

restart FMIS or reload the hdfvr app using the FMS Management Console .

when trying to record you will be asked for the license key again

On Red5:

delete this file:
Red5\webapps\hdfvr\persistence\SharedObject\_definst_\licensekey.red5

restart Red5

when trying to record you will be asked for the license key again

On Wowza:

delete this file:
Wowza Media Server 2\applications\hdfvr\sharedobjects\_definst_\licensekey.rso

restart Wowza

when trying to record you will be asked for the license key again

9. How to translate HDFVR

HDFVR holds all the texts used in the UI in an external text xml file: translations/en.xml

To change a word/phrase or translate the entire HDFVR user interface just edit that file with a text editor, search for the text you want to translate it and change it!

Now save the new .xml file and upload it to your hdfvr installation folder on your web server!

If the old translation shows up clear your browser cache!

You might also be interested in how the video recorder works and the JS and Php/ASP API's .