Вы находитесь на странице: 1из 8

Une des meilleures fonctionnalits de SAM Cast est sa capacit mettre jour

les mtadonnes de l'audio en direct et l'enregistrer dans un fichier de l'histoire,


tout en intgrant galement le flux de diffusion. En d'autres termes, votre lecteur
montrera ce qui se joue en temps rel. Ces donnes seront galement affiches
sur les rpertoires de radio comme AudioRealm.com et SHOUTcast.com.

Lorsque l'information provient de


Habituellement, les mtadonnes sont disponibles auprs de votre lecture ou
systme d'automatisation. Il peut lire les mtadonnes des fichiers sources des
mdias et de l'exporter en temps rel. Si vous diffusez une mission en direct, il
n'y a pas de fichiers source des mdias avec des mtadonnes utiliser. Dans un
tel cas, vous pouvez toujours mettre jour manuellement les mtadonnes avec
l'adaptateur d'vnements HTTP.

HTTP, TCP ou Serial


Lorsque vous utilisez un systme d'automatisation comme SAM Broadcaster, il va
exporter des mtadonnes sur une connexion rseau TCP, une connexion rseau
HTTP ou un cble srie lie.

HTTP adaptateur vnement


Lorsque vous lancez SAM Cast, cliquez sur "Paramtres". Allez dans "Adaptateurs
d'vnements" et slectionnez "adaptateur vnement HTTP." Rglez le port
8181 puis cliquez sur "OK". Moulage arrt SAM si elle est en marche et
commencer nouveau de sorte qu'il sera utiliser les nouveaux paramtres de la
carte de l'vnement.

Ouvrez votre navigateur prfr (Firefox, Chrome ou Internet Explorer) et de


copier et coller dans le champ URL:

http: // localhost: 8181 / artiste = myartist & title = mytitle & songty ...

Quelque chose comme "OK 02:09:21" devrait apparatre.

Maintenant, vrifiez le journal des vnements de Moulage SAM. Elle devrait


ressembler quelque chose comme ceci:

2011-01-26 13:35:26> Changement de la chanson: myartist - mytitle (04:00)

Dans cet exemple, nous avons fourni les domaines artiste, titre, songtype et la
dure. Vous devez toujours fournir ces champs recommand comme un strict
minimum. Notez que la dure est en millisecondes (1 seconde = 1000
millisecondes).

Dans l'exemple suivant, nous avons cr une page HTML qui le rend facile
mettre jour manuellement votre mtadonnes via HTTP. Ce fichier se trouve
dans votre dossier de scripts locaux.

Aller vers Windows Dmarrer> Tous les programmes> SAM Cast> Utilitaires et
cliquez sur "DONNES-dossier." Cela va ouvrir l'Explorateur Windows dans le
rpertoire de donnes de SAM Cast. Ensuite, parcourir le dossier "scripts".

Ouvrez le "http-update.html" fichier dans votre navigateur Internet. Remplissez


les champs et cliquez sur Soumettre.

Notez comment cette page automatiquement "URL code" les donnes. Par
exemple, tapez "Jane & Joe" dans le champ de l'artiste et cliquez sur
Soumettre. Voir l'URL dans le navigateur? Le protocole HTTP requiert des
paramtres dans l'URL pour tre correctement formats.

Vous pouvez dfinir les champs suivants:

artiste, le titre, la dure, songtype, album, buycd, site web, image, fichier,
trackno, albumyear, compositeur, ISRC, l'tiquette, le droit d'auteur

Serial (script) Adaptateur de l'vnement


La plupart des systmes d'automatisation utiliss par les stations de radio ont la
capacit de sortie ce qui est actuellement en cours de lecture via un cble srie
null-modem connect aux ports de l'ordinateur excutant le systme
d'automatisation COM, et de l'autre ordinateur excutant SAM Cast.

Pour configurer SAM Cast accepter des mtadonnes partir d'un cble srie,
allez dans Paramtres> Adaptateurs d'vnements et slectionnez "Serial
(script)."

Dans l'onglet "Adaptateur srie", ajuster les paramtres srie. Cela inclut le port
COM, la parit, Databits, Baudrate, flowControl et Stop bits. Assurez-vous que vos
paramtres de Cast SAM correspondent ceux de votre systme
d'automatisation exactement.

Au cours du dveloppement de script, nous recommandons fortement activant le


paramtre "Activer la sortie de dbogage RAW". Cela crira toutes les donnes
reues sur le cble srie pour le journal, y compris les valeurs HEX pour les
personnages. Ce qui est excellent pour reprer ces caractres invisibles comme
le saut de ligne, retour chariot et les tabulation, etc.

Maintenant, allez l'onglet "Script". Ceci est o vous crivez un mini-script qui
traite les donnes d'entre et remplit l'objet de mtadonnes. Une fois que les
donnes sont analyses sur, le script peut dclencher un vnement de
changement de la chanson qui sera applicable aux mtadonnes. Voir "Script
dveloppement" ci-dessous pour plus de dtails.

TCP (script) Adaptateur de l'vnement


Cet adaptateur d'vnements coute les connexions de donnes entrantes sur le
port spcifi. Un ou plusieurs clients TCP peuvent alors se connecter SAM
Moulage et envoyer des mtadonnes.

Au cours du dveloppement de script, nous recommandons fortement activant le


paramtre "Activer la sortie de dbogage RAW". Cela crira toutes les donnes
reues sur le cble srie pour le journal, y compris les valeurs HEX pour les
personnages. Ce qui est excellent pour reprer ces caractres invisibles comme
le saut de ligne, retour chariot et les tabulation, etc.

Maintenant, allez l'onglet "Script". Il est l'endroit o vous crivez un mini-script


qui traite les donnes d'entre et remplit l'objet de mtadonnes. Une fois que
les donnes sont analyses sur, le script peut dclencher un changement de la
chanson qui sera appliqu aux mtadonnes. Voir "Script dveloppement" cidessous pour plus de dtails.

TCP Client (script) Adaptateur de l'vnement


Cet adaptateur d'vnements se connecte un serveur TCP dans la plupart des
cas, le systme d'automatisation sur l'adresse de l'hte et le port spcifis. Il sera
ensuite attendre que le serveur pour envoyer des donnes via la connexion client
TCP. Si la connexion est perdue, le client TCP va essayer de se reconnecter au
serveur toutes les 15 secondes.

Au cours du dveloppement de script, nous recommandons fortement activant le


paramtre "Activer la sortie de dbogage RAW". Cela crira toutes les donnes
reues sur le cble srie pour le journal, y compris les valeurs HEX pour les
personnages. Ce qui est excellent pour reprer ces caractres invisibles comme
le saut de ligne, retour chariot et les tabulation, etc.

Maintenant, allez l'onglet "Script". Il est l'endroit o vous crivez un mini-script


qui traite les donnes d'entre et remplit l'objet de mtadonnes. Une fois que
les donnes sont analyses sur, le script peut dclencher un changement de la
chanson qui sera appliqu aux mtadonnes. Voir "Script dveloppement" cidessous pour plus de dtails.

Dveloppement Script
Les scripts peuvent tre crits dans JScript ou VBScript. Les exemples que nous
fournissons sont dans VBScript. Tous les scripts doivent contenir une fonction
"HandleLine", qui est en contact chaque fois SAM Cast reoit de nouvelles
donnes. Les donnes doivent tre traites, puis les valeurs doivent tre affects
la zone "SongInfo". Une fois cela fait, prendre contact "SongInfo.DoSongChange
()" pour dclencher la mise jour des mtadonnes.

La meilleure faon d'apprendre est de regarder par-dessus les exemples de


scripts suivants. Nous vous recommandons de les passer en revue dans cet
ordre:

vb.hello_world.txt
vb.static_update.txt
vb.simple_parser.txt
vb.library.txt
vb.audiovault_example.txt
vb.library.txt est particulirement utile. Il contient des extraits de code qui vous
aideront faire face la plupart des scnarios de traitement de chanes que vous
pouvez rencontrer.

Des scripts de dbogage


Capture des donnes de la source: Activez le paramtre "Activer la sortie de
dbogage RAW" et lancer le systme d'automatisation pendant un certain temps
de sorte que vous pouvez capturer un bon chantillon de lignes de donnes
d'entre. Ne vous inquitez pas des erreurs de script pour le moment. Nous
sommes seulement intresss capturer les donnes.
Basculer vers le TCP (script) adaptateur d'vnements et excuter l'application
TCP expditeur.
Maintenant, utilisez l'utilitaire TCP expditeur pour imiter les donnes que vous
avez captur dans SAM Cast en l'envoyant directement SAM Cast, nouveau
via l'utilitaire TCP expditeur. Cela vous permet de dboguer et de tester vos

scripts sans avoir attendre pour le systme sur-air automatisation d'envoyer


des vnements. Cela peut grandement acclrer le dveloppement de script.
Une fois que votre script est dvelopp et test, revenir l'adaptateur
d'vnement appropri et assurez-vous qu'il fonctionne avec le systme
d'automatisation comme prvu. Rptez les tapes 1 3 si elle ne fonctionne
pas.

One of SAM Casts greatest features is its ability to update the metadata of live
audio and log it to a history file, while also embedding it to the broadcast stream.
In other words, your player will show whats playing in real-time. This data will
also be displayed on radio directories like AudioRealm.com and SHOUTcast.com.

Where the information comes from


Usually, metadata is available from your playback or automation system. It can
read metadata from the media source files and export it in real-time. If you are
broadcasting a live show, there are no media source files with metadata to use. In
such a case, you can still manually update the metadata with the HTTP event
adaptor.

HTTP, TCP or Serial


When using an automation system like SAM Broadcaster, it will export metadata
over a TCP network connection, an HTTP network connection or a linked serial
cable.

HTTP Event Adaptor


When you launch SAM Cast, click on Settings. Go to Event Adaptors and
select HTTP Event adaptor. Set the port to 8181 then click OK. Stop SAM Cast
if its running and start it again so it will use the new event adaptor settings.

Open up your favorite browser (FireFox, Chrome or Internet Explorer) and copy
and paste this into the URL field:

http://localhost:8181/?artist=myartist&title=mytitle&songty...

Something like OK 2:09:21 AM should appear.

Now check the SAM Cast event log. It should look something like this:

2011-01-26 13:35:26> Song change: myartist mytitle (4:00)

In this example, we provided the artist, title, songtype and duration fields. You
should always provide these recommended fields as a bare minimum. Note that
the duration is in milliseconds (1 second = 1000 milliseconds).

In this next example, we created an HTML page that makes it easy to manually
update your metadata via HTTP. This file is located in your local scripts folder.

Go to Windows Start>All Program>SAM Cast>Utils and click on DATA-Folder.


This will open Windows Explorer in the SAM Cast data directory. Then browse the
scripts folder.

Open the http-update.html file in your Internet browser. Fill in the fields and
click submit.

Note how this page automatically URL encodes the data. For example, type in
Jane & Joe into the artist field and click submit. See the URL in the browser?
The HTTP protocol requires parameters in the URL to be properly formatted.

You can set the following fields:

artist, title, duration, songtype, album, buycd, website, picture, filename, trackno,
albumyear, composer, ISRC, label, copyright

Serial (Scripted) Event Adaptor


Most automation systems used by radio stations have the ability to output what
is currently playing via a null-modem serial cable connected to the COM ports of
the computer running the automation system, and to the other computer running
SAM Cast.

To configure SAM Cast to accept metadata from a serial cable, go to


Settings>Event Adaptors and select Serial (Scripted).

In the Serial Adaptor tab, adjust the serial settings. This includes the COM port,
Parity, Databits, Baudrate, Flowcontrol and Stop bits. Make sure your SAM Cast
settings match those of your automation system exactly.

During script development, we highly recommend enabling the Enable RAW


debug output setting. This will write all data received over the serial cable to the
log, including HEX values for the characters. This is great to spot those invisible
characters like Linefeed, Carriage return, Tab, etc.

Now go to the Script tab. This is where you write a mini-script that processes
the input data and fills in the metadata object. Once the data is parsed out, the
script can trigger a song change event that will apply to the metadata. See
Script Development below for more details.

TCP (Scripted) Event Adaptor


This event adaptor listens for incoming data connections on the specified port.
One or more TCP clients can then connect to SAM Cast and send metadata.

During script development, we highly recommend enabling the Enable RAW


debug output setting. This will write all data received over the serial cable to the
log, including HEX values for the characters. This is great to spot those invisible
characters like Linefeed, Carriage return, Tab, etc.

Now go to the Script tab. There is where you write a mini-script that processes
the input data and fills in the metadata object. Once the data is parsed out, the
script can trigger a song change that will be applied to the metadata. See Script
Development below for more details.

TCP Client (Scripted) Event Adaptor


This event adaptor connects to a TCP serverin most cases, the automation
systemon the specified host address and port. It will then wait for the server to
send data over the TCP client connection. If the connection is lost, the TCP client
will try to reconnect to the server every 15 seconds.

During script development, we highly recommend enabling the Enable RAW


debug output setting. This will write all data received over the serial cable to the
log, including HEX values for the characters. This is great to spot those invisible
characters like Linefeed, Carriage return, Tab, etc.

Now go to the Script tab. There is where you write a mini-script that processes
the input data and fills in the metadata object. Once the data is parsed out, the
script can trigger a song change that will be applied to the metadata. See Script
Development below for more details.

Script Development
Scripts can be written in Jscript or VBScript. The examples we provide are in
VBScript. All scripts should contain a HandleLine function, which is contacted
each time SAM Cast receives new data. The data needs to be processed, then
values need to be assigned to the SongInfo field. Once this is done, make
contact SongInfo.DoSongChange() to trigger the metadata update.

The best way to learn is to look over the following script samples. We recommend
you review them in this order:

vb.hello_world.txt
vb.static_update.txt
vb.simple_parser.txt
vb.library.txt
vb.audiovault_example.txt
vb.library.txt is especially useful. It contains code snippets that will help you deal
with most of the string processing scenarios you may encounter.

Debugging scripts
Capture data from source: Enable the Enable RAW debug output setting and
run the automation system for a while so you can capture a good sample of input
data lines. Dont worry about script errors for now. Were only interested in
capturing the data.
Switch to the TCP (Scripted) event adaptor and run the TCP Sender application.
Now use the TCP Sender utility to mimic the data you captured in SAM Cast by
sending it directly to SAM Cast, again via the TCP Sender utility. This allows you to
debug and test your scripts without having to wait for the on-air automation
system to send out events. This can greatly speed up script development.
Once your script is developed and tested, switch back to the appropriate event
adaptor and make sure it works with the automation system as intended. Repeat
steps 1 to 3 if it doesnt work.