AVC client - doc exploitation

AudioVideoCours - Client,
Documentation Exploitation
http://audiovideocours.u-strasbg.fr
Le présent document est régulièrement mis à jour en ligne à l'adresse:
http://docs.google.com/Doc?id=dgqhgsgm_357gz7ng6cq
(ou accessible depuis le site audiovideocours)
Sommaire:
Introduction .................................................................................. 2
Installation amphis ........................................................................ 2
installation (windows XP, Vista,7) ..................................................... 2
installation (version Linux)............................................................... 2
Ce que fait l'installeur (exe) ? .......................................................... 3
Stratégie de sécurité/ compte utilisateur pour "amphi" ........................ 3
Installation complémentaire si "direct" ou vidéo souhaités.................... 3
Vumètre et état du micro ................................................................ 3
Configuration amphis..................................................................... 3
Amphi automatisés, usage audio ...................................................... 4
Autoriser le direct ........................................................................... 4
Enregistrement vidéo ...................................................................... 4
Enregistrement vidéo et sélection de la source dans le fichier de
configuration ................................................................................. 4
Enregistrement vidéo et sélection de la source et paramétrages via le
profile Flash Media Live Encoder (FMLE) ............................................ 5
Fichier de log ................................................................................. 5
Maintenance .................................................................................. 5
Indicateurs audio et visuels ............................................................. 6
Maintenance à distance dans un navigateur web (NEW) ....................... 6
Exemple : récupération d'un enregistrement à distance et du fichier de
log (NEW) ..................................................................................... 7
Fil RSS commun de notification d'incident du parc des clients (NEW,
version 1.19) ................................................................................. 7
A chaque incident (pour l'instant lors de l’impossibilité de publier): un
entrée est rajoutée à ce fil RSS contenant un titre cliquable (amenant à
la page web client distante), le date exacte de l'incident, le nom d'hôte
ainsi que l’adresse IP. Lors d'une coupure réseau lors de la publication le
client vas essayer de notifier le fil RSS toutes les minutes pendant 48
heures. ......................................................................................... 8
Cette fonctionnalité est automatiquement activé en mode amphi
uniquement. .................................................................................. 8
Univr-2A (deprecated) .................................................................... 8
Commande via Univ-R (deprecated).................................................. 8
Monitoring via socket (deprecated) ................................................... 8
Trouble Shooting ............................................................................ 8
Exemple d'un fichier de configuration type amphi audio et direct........... 9
Introduction
Pour se familiariser avec le client AudioVideoCours et connaître son fonctionnement voir
la documentation utilisateur.
En résumé AudioVideoCours est une solution de captation automatisée de médias
enrichis:
• le plus simple possible pour l'utilisateur (très peu de choix pour l'utilisateur,
choix dans le fichier de configuration pour le "technicien")
• découplage vis a vis des formats (pas de conteneur mais un fichier timecode
texte + le media audio ou vidéo + les captures d'écran)
• "scalable", pas besoin de technicien pour l'usage
• robuste: pas de pertes en cas de coupure de courant (enregistrement au fur et à
mesure)
• une seule version (fichier de conf. à modifier)
Installation amphis
Cette partie décris l'installation et la configuration d'AudioVideoCours à destination des
amphis (l'installation de la version "standalone" par les enseignants sur leur PC est
décrite dans la documentation utilisateur ).
installation (windows XP, Vista,7)
Le client est disponible en version Windows pour l'instant (un version Linux/Mac est
prévue dans le futur).
Pour installer le client sur le poste amphi:
• via site audiovideocours , lien "téléchargement" qui amène sur la page
DownloadAudioVideoCours.
• prendre la dernière version, vérifier changeLog si besoin (en anglais).
• version configurée standalone et audio par défaut (orientée PC de l'enseignant),
près à l'usage.
installation (version Linux)
Voir ici (pour développeurs ou techniciens) :
https://docs.google.com/
Doc?id=dgqhgsgm_358mftgz79f&pli=1#Introduction_version_Linux_7283995156176388
Ce que fait l'installeur (exe) ?
• crée un dossier "audiocours" contenant notamment l'exécutable principal
"mediacours.exe"
• crée un dossier "audiovideocours" pour les data dans le C:\Documents and
settings\user\
• contient les enregistrements sous forme de dossiers horodatés
• un fichier de log mensuel.
• la localisation et le nom de ce dossier data peuvent éventuellement être
changés en décommentant et en donnant un chemin à la variable pathData
dans le fichier de configuration
• crée un dossier "audiovideocours" contenant le fichier de configuration commun
mediacours.conf dans "C:\documents and settings\all users" pour windows XP et
"C:\ProgramData" pour Windows Vista/7.
• installe un raccourcis indiquant "AC" sur le bureau et une entrée dans le menu
démarré
Stratégie de sécurité/ compte utilisateur pour "amphi"
• pour que le logiciel se lance automatiquement au démarrage faire un raccourci
vers médiacours.exe dans C:\Documents and Settings\Amphi\Menu
Démarrer\Programmes\Démarrage
• enlever le raccourci sur le bureau et l'entrée dans le menu démarré
Installation complémentaire si "direct" ou vidéo souhaités
Le direct comme la vidéo passe par Flash Media Live Encoder 3.1 qu'il faudra installer
(téléchargement gratuit sur le site d'adobe après authentification).
Vumètre et état du micro
• Placer l'exécutable vumeter.exe dans le dossier audiocours (téléchargement)
• le client vérifie la présence d'un fichier vumeter.exe dans le dossier et le lance
lors de l'affichage de la fenêtre d'enregistrement (touche F8)
• vous pouvez choisir un autre vumètre "indépendant" si vous le renommez
"vumetre.exe"
Configuration amphis
La configuration se fait via le fichier de configuration mediacours.conf qui se trouve dans
le dossier dans "C:\documents and settings\all users\audiovideocours" pour windows XP
et "C:\ProgramData\audiovideocours" pour Windows Vista/7.
Lire les commentaires du fichier de configuration pour connaitre l'action de tel ou tel
paramètre.
Dans les versions amphis l'enregistrement est envoyé par FTP même si le bouton
"annuler" du forumulaire de publication à été cliqué (mais il n'est pas publié). Cela
permet de récupérer un enregistrement le cas échéant sans pertuber un cours dans un
amphi (qui sont rarement libre par définition) et de connaître l'activité des clients
amphis.
Amphi automatisés, usage audio
changer:
• standalone=True par standalone=False (F et T majuscule)
Cela permet d'avoir audiocours toujours en attente et d'empécher l'utilisateur de fermer
l'application lui même.
Dans ce mode la seule façon de tuer l'application est par le gestionnaire des tâche de
windows: chercher mediacours.exe dans les processus et cliquer sur "terminer le
processus" (en compte amphi l'utilisateur n'y a normalement pas accès).
Une icone donnant l'état du logiciel se trouve dans le systray (la partie droite de la barre
des tâche) : elle est blanche lorqu'audiocours est en attente et rouge lorsqu'il y a
enregistrement. Attention, pour être sûr que l'application tourne toujours passer la
souris sur cette icone pour que windows rafraichisse le systray.
Autoriser le direct
Pour autoriser le direct dans le fichier de configuration mettre la variable live à True:
• live= True
Cela fait apparaître l'option "en direct" à cocher dans la fenêtre d'enregistrement (Flash
Media Live Encoder doit être présent sur le PC, voir partie installation).
Enregistrement vidéo
Flash Media Live Encoder 3.1 doit être installé sur le PC (il est peut-être déjà installé
pour le direct en mode "amphis"). Ce logiciel est gratuit mais il faut le télécharger sur le
site d'Adobe (nécessite la création d'un compte gratuit) : http://www.adobe.com/
products/flashmediaserver/flashmediaencoder/
(si vous utilisez une autre version de l'encodeur il faudra indiquer le dossier contenant
l'exécutable dans le chemin, variable path de windows)
Enregistrement vidéo et sélection de la source dans le fichier de configuration
Flash Media Live Encoder 3.1 doit être installé sur le PC (il est peut-être déjà installé
pour le direct en mode "amphis").
Dans le fichier de configuration, renseignez:
• usage=video (au lieu de usage=audio)
Eventuellent pour laisser le choix à l'utilisateur entre un usage audio ou video,
renseignez:
• audioVideoChoice=True (au lieu de audioVideoChoice=False)
L'entrée vidéo et audio peuvent être changées dans le fichier de conf: videoinput=0 et
audioinput=0 par défaut.
Par défaut la vidéo est optimisée pour le web.
Enregistrement vidéo et sélection de la source et paramétrages via le profile
Flash Media Live Encoder (FMLE)
Il est possible d'imposer ses propres paramètres vidéo à Flash Media Live Encoder en
copiant le fichier profile de FMLE ("starup.xml") directement dans le dossier audiocours
"C:\Program Files\Audiocours" :
- lancez Flash Media Live Encoder manuellement, sélectionnez la source souhaitée,
réglez éventuellement les paramètres de qualité souhaités (frame rate, output size).
- menu "file", "save profile" ("starup.xml" directement dans le dossier audiocours
"C:\Program Files\Audiocours")
- quittez Flash Media Live Encoder
- relancez le client AudioVideoCours
Si ce fichier "startup.xml" existe c'est lui qui imposera ses parmètres pour l'encodeur et
non plus la source indiquée dans le fichier de configuration.
Fichier de log
Un fichier de log est créer automatiquement dans le dossier audiovideocours de
l'application (dans C:\Documents and settings\user\).
Il s'agit d'un fichier de log horodaté par année-mois indiquant toutes les actions
entreprises par l'utilsateur et d'éventuels problèmes rencontré par le client. En cas de
problème il est important de consulter ce fichier pour établir un diagnostique.
Maintenance
Le client ne demande pas de maintenance particulière si ce n'est de vérifier qu'il reste
suffisemment d'espace disque sur le PC et d'affacer éventuellement d'anciens
enregistrements.
Si il est bien installé (voir installation) il se relance à chaque démarrage et indique sa
présence par une icone "AC" (en audio) dans le systray.
Pour éviter l'oubli de l'arrêt d'un enregistrement une durée maximum d'enregistrement
est définit dans le fichier de configuration.
maxRecordingLength= 18000
Par défaut la durée max. est de 5 heures (à renseigner en secondes, 1h=3600s ...
5h=18000s)
Indicateurs audio et visuels
Des indicateurs aident aux renseignement de l'état de l'application (qui par définition
s'éfface complètement pour ne pas dénaturé l'enregistrement).
Indicateurs visuels:
• icone AC (audio) ou VC (video) dans le systray (droite de la barre des tâches)
◦ Couleur blanche: logiciel en attente
◦ Couleur rouge: enregistrement en cours
◦ passer la souris sur cette icone pour avoir un "tooltip" sur l'état du
logiciel
Indicateurs Audio:
• un bip l'enregistrement débute
• deux bips l'enregistrement finit
• trois bips le client n'a pas trouvé la fenêtre console Flash Media Live Encoder à
réduire (problème éventuel pour le live ou la video).
Pour l'état du micro voir la partie vumètre dans la partie installation plus haut.
Maintenance à distance dans un navigateur web (NEW)
En mode amphi un petit serveur web intégré au client est accessible à distance. Il est
possible de l'activer également en mode standalone mais il faut alors le préciser dans le
fichier de configuration.
# Allow the client to act as a serveur for maintenance purposes
remoteControl=False
remotePort=80
En se connectant à un client: http://addresse_du_client, on obtient des informations du
type :
((( AudioVideoCours Client - Web Interface )))
Recording now: False
> client version : 1.17
> app_startup_date : 2010-10-29 09:20:40
> last_session_recording_start : 2010-11-05 11:17:06
> last_session_recording_stop : 2010-11-05 12:13:16
> last_session_publish_order : 2010-11-05 12:13:19
> last_session_publish_problem : None
> session data folder : C:\Documents and Settings\amphi\audiovideocours
On voit donc les informations suivantes :
- état : enregistrement en cours ou non
- version du client
- date de dernier démarrage du client
- date de dernier début d'enregistrement (depuis le dernier démarrage du
client)
- date de fin du dernier enregistrement (depuis le dernier démarrage du client)
- date de dernière demande de publication (depuis le dernier démarrage du
client)
- problème rencontré lors d'une publication ?
- chemin complet du dossier contenant les données
De plus un champ de commande permet d'effectuer des opération de maintenance :
Current availale commands:
help -> returns a list of available commands.
list -> returns a list of folders and files in your current data folder.
recover:NameOfFolder -> FTP folder to FTP server.
Exemple : récupération d'un enregistrement à distance et du fichier de log
(NEW)
Renseigner l’adresse du client dans un navigateur web (voir partie précédente):
http://addresse_du_client
Faire une commande "list" dans le champ de commande:
Listing of files and folders in D:\
Files:
[...]
16 - log-audiovideocours-2010-09.txt - 6.59 Ko
17 - log-audiovideocours-2010-10.txt - 5.06 Ko
18 - log-audiovideocours-2010-11.txt - 0.37 Ko
Folders:
0 - 2010-05-12-15h-50m-08s-192_168_13_12 - 0.27 Mo
1 - 2010-06-24-19h-11m-12s-130_79_188_113 - 0.48 Mo
2 - 2010-06-24-19h-23m-15s-127_0_0_1 - 0.42 Mo
- copier-coller le nom du dossier à récupérer
- retourner à la page précédente dans le navigateur
- dans le champ de commande: "recover:2010-05-12-15h-50m-08s-192_168_13_12" zippera
le dossier et l'enverra sur le dossier FTP du serveur.
- dans le champ de commande: "recover:log-audiovideocours-2010-11.txt" enverra ce fichier
de log sur le dossier FTP du serveur.
Fil RSS commun de notification d'incident du parc des clients (NEW, version
1.19)
Un fil RSS commun de notification est crée et mis à jour par les clients à cette adresse :
https://your_audiovideocours_server.fr/live/clients-warnings.xml
A chaque incident (pour l'instant lors de l’impossibilité de publier): un entrée est
rajoutée à ce fil RSS contenant un titre cliquable (amenant à la page web client
distante), le date exacte de l'incident, le nom d'hôte ainsi que l’adresse IP. Lors d'une
coupure réseau lors de la publication le client vas essayer de notifier le fil RSS toutes les
minutes pendant 48 heures.
Cette fonctionnalité est automatiquement activé en mode amphi uniquement.
Univr-2A (deprecated)
Le client peut commander un videoprojecteur à partir d'un clavier série dans le cadre des
salles Univr-2A.
Les salles Univr-2A sont des salles de cours automatisés à bas coûts et non des amphis
déjà automatisés (cas des salles de l'Atrium par exemple à l'UDS).
Il s'agit alors de renseigner le bon port série pour le clavier et le vidéoprojecteur.
Commande via Univ-R (deprecated)
Le client peut recevoir des ordres ou envoyer des informations via le port 3737.
Le socket doit être autorisé dans le fichier de configuration pour cela:
socketEnabled=True
Lorsque le client reçoit du serveur "(id:numero)" sur son socket cela fait apparaître
l'invite d'enregistrement.
A la fin de l'enregistrement les données sont envoyées directement au serveur avec l'id
(après un dialog box de confirmation).
Monitoring via socket (deprecated)
L'état du clent peut être intérrogé à distance sur le port 3737 par défaut si celui-ci a été
activé dans le fichier de configuration.
• socketEnabled=True
• portNumber = 3737
Il accepte notamment en entrée les commandes suivantes:
"VERSION"
Retourne VERSION: numero de version
(id:numero)
Retourne: Received ID numero
Trouble Shooting
En cas de problème consulter le fichier de log pour savoir ce qu'a fait exactement
l'utilisateur et les éventuels problèmes rencontrés par le client.
Pas de son : voir problème fréquent des piles pour les micro sans fils.
Exemple d'un fichier de configuration type amphi audio et direct
Voici un copier/coller d'un fichier de configuration typique pour un amphi en audio, direct
et possibilité de commande externe (de loin le cas le plus fréquent):
################################################################
##
## === This is the configuration file for AudioVideoCours Client ===
##
## (You must save the file as "mediacours.conf" and restart the application for the
changes to take effect)
##
## The common configuration file is located in "C:\Programdata\audiovideocours" in
Windows Vista/Seven
## and "C:\Document and settings\all users\audiovideocours" for Windows XP. You can
override this configuration
## by having a specific "mediacours.conf" user configuration file in your
%userprofile%.
##
## For more technical informations and help:
## https://sourcesup.cru.fr/projects/audiovideocours/
## francois.schnell [AT unistra.fr] (Client developer) - Tel: 0033 (0)3 90 24 00 16
##
################################################################
# Don't change this section name
[mediacours]
# Language (English or French available)
Language=French
# If needed give another folder where you want your recordings to be saved
#pathData=C:\Documents and Settings\franz\Bureau\enregistrements
# Usage : 'audiocours' (usage=audio) or 'videocours' (usage=video)
# Put standalone=False if the software must always work in a amphitheatre (background
task)
# to use the audio live option you must have VLC installed (videolan)
# set audioVideoChoice to True if you want to allow the user to choose (you must then
preset video parameters)
usage=audio
standalone=True
live=False
audioVideoChoice=True
# Allow the client to act as a serveur for maintenance purposes
remoteControl=False
remotePort=80
# Choose your encoder if usage=video : Flash Media Live Encoder 3.1 (default) or Real
Media Producer or Windows Media Encoder
# (flash= FlashMediaEncoder,real=videoEncoder, wmv=WindowsMediaEncoder)
# For inforamtion we use and test with Flash Media Live Encoder 3.1
videoEncoder=flash
# For video usage give videoInput (integer) and audioinput (integer)
# video can be a webcam/camcorder/aquisition card/frame grabber/... seen by Windows
OS
videoinput=0
audioinput=0
# If using Flash Media Encoder: server IP for live streaming
flashServerIP=91.121.162.139
# samplingFrequency (8000, 16000, 32000, 44100, 48000 Hz (default)) and bitrate
(128000 default). Not all configurations work.
samplingFrequency=48000
bitrate=64000
# Set the keyStop to start/stop recording
stopKey= F8
# Set the delay before a new screenshot can be taken in seconds (useful on an slow
computer or to avoid double cliks)
eventDelay=0.5
# Maximum Recording Length (in seconds). The recording stops above this duration and
the soft come back in the initial state
# (1h=3600s ... 5h=18000s)
maxRecordingLength= 18000
# Audiocue: gives an audio cue when recording begins and stops (in addition to the
systray icons)
audiocue=True
# If you use a special keyboard on the serial port give "True" here and indicate the port
number to use (com1=0,com2=1,etc)
serialKeyboard=False
keyboardPort=0
amxKeyboard=False
# If a videoprojector is connected to a serial port of the PC put True here and indicate
the port number to use (com1=0,com2=1,etc)
videoprojectorInstalled=False
videoprojectorPort=1
#videoProjON='PWR ON\x0D'
#videoProjOFF='PWR OFF\x0D'
# optional socket command which is looking for (id:xxxx) on PortNumber
socketEnabled=False
portNumber = 3737
# Indicates there's no publishing form on the client and everything is done on the
website (if =False)
publishingForm=False
# Publishing form : "Formation" default field (if needed)
#formFormation=Titre Formation
# Additional parameters for servers other than audiovideocours.u-strasbg.fr
(uncomment to use)
#ftpUrl=ftp url
#ftpLogin=ftp login
#ftpPass=ftp pass
#urlserver= url of the publish form
#urlLiveState= URL of the live status form