On Thu, 2019-06-06 at 08:10 -0300, Yitzhak B. Solórzano wrote:
> Please can you send me the basic structure of a Cart;
The easiest way to see the overall schema is to look at the XML
returned by the ListCarts Web API call. You can generate such by
opening a web browser on any Rivendell system and going to:
http://localhost/rd-bin/listcart.html
Here is a result for the 'Test Tone' audio cart that is included with
every installation of Rivendell:
<?xml version="1.0" encoding="UTF-8" ?>
<cartList>
<cart>
<number>999999</number>
<type>audio</type>
<groupName>TEST</groupName>
<title>Test Tone</title>
<artist>Rivendell Radio Automation</artist>
<album></album>
<year></year>
<label></label>
<client></client>
<agency></agency>
<publisher></publisher>
<composer></composer>
<conductor></conductor>
<userDefined></userDefined>
<usageCode>0</usageCode>
<forcedLength>00:00:10.0</forcedLength>
<averageLength>00:00:10.0</averageLength>
<lengthDeviation>00:00:00.0</lengthDeviation>
<averageSegueLength>00:00:10.0</averageSegueLength>
<averageHookLength>00:00:00.0</averageHookLength>
<cutQuantity>1</cutQuantity>
<lastCutPlayed>0</lastCutPlayed>
<enforceLength>false</enforceLength>
<asyncronous>false</asyncronous>
<owner></owner>
<metadataDatetime>2019-02-05T13:21:32-04:00</metadataDatetime>
<songId></songId>
<cutList>
<cut>
<cutName>999999_001</cutName>
<cartNumber>999999</cartNumber>
<cutNumber>1</cutNumber>
<evergreen>false</evergreen>
<description>1 kHz at Reference Level [-16 dBFS]</description>
<outcue>[tone]</outcue>
<isrc></isrc>
<isci></isci>
<length>10044</length>
<originDatetime>2014-11-29T22:09:03-04:00</originDatetime>
<startDatetime></startDatetime>
<endDatetime></endDatetime>
<sun>true</sun>
<mon>true</mon>
<tue>true</tue>
<wed>true</wed>
<thu>true</thu>
<fri>true</fri>
<sat>true</sat>
<startDaypart></startDaypart>
<endDaypart></endDaypart>
<originName>RDGen</originName>
<originLoginName></originLoginName>
<sourceHostname></sourceHostname>
<weight>1</weight>
<lastPlayDatetime>2019-02-04T13:33:59-04:00</lastPlayDatetime>
<playCounter>17</playCounter>
<codingFormat>0</codingFormat>
<sampleRate>48000</sampleRate>
<bitRate>0</bitRate>
<channels>2</channels>
<playGain>0</playGain>
<startPoint>0</startPoint>
<endPoint>10044</endPoint>
<fadeupPoint>-1</fadeupPoint>
<fadedownPoint>-1</fadedownPoint>
<segueStartPoint>-1</segueStartPoint>
<segueEndPoint>-1</segueEndPoint>
<segueGain>-3000</segueGain>
<hookStartPoint>-1</hookStartPoint>
<hookEndPoint>-1</hookEndPoint>
<talkStartPoint>-1</talkStartPoint>
<talkEndPoint>-1</talkEndPoint>
</cut>
</cutList>
</cart>
</cartList>
As you can see, there are basically two fundamental entities involved:
a <cart>, which contains elements pertaining to the cart itself, and a
<cut>, which corresponds to the member cuts. A cart can have between 0
and 1000 cuts.
Macro carts are slightly different:
<?xml version="1.0" encoding="UTF-8" ?>
<cartList>
<cart>
<number>50004</number>
<type>macro</type>
<groupName>MACROS</groupName>
<title>Remote Test</title>
<artist></artist>
<album></album>
<year></year>
<label></label>
<client></client>
<agency></agency>
<publisher></publisher>
<composer></composer>
<conductor></conductor>
<userDefined></userDefined>
<usageCode>0</usageCode>
<forcedLength>00:00:00.0</forcedLength>
<averageLength>00:00:00.0</averageLength>
<lengthDeviation>00:00:00.0</lengthDeviation>
<averageSegueLength>00:00:00.0</averageSegueLength>
<averageHookLength>00:00:00.0</averageHookLength>
<cutQuantity>0</cutQuantity>
<lastCutPlayed>0</lastCutPlayed>
<enforceLength>false</enforceLength>
<asyncronous>false</asyncronous>
<owner></owner>
<metadataDatetime>2019-03-14T16:50:12-04:00</metadataDatetime>
<songId></songId>
<macroList>
<macro0>CC 192.168.122.152 LC gray TEST STRING!</macro0>
<macro1>!</macro1>
</macroList>
</cart>
</cartList>
Most of the <cart> level attributes are the same, but instead of a list
of cuts, we get a <macroList> that contains the RML lines that
constitute the macro cart.
Cheers!
|---------------------------------------------------------------------|
| Frederick F. Gleason, Jr. | Chief Developer |
| | Paravel Systems |
|---------------------------------------------------------------------|
| A room without books is like a body without a soul. |
| |
| -- Cicero |
|---------------------------------------------------------------------|
_______________________________________________
Rivendell-dev mailing list
[email protected]
http://caspian.paravelsystems.com/mailman/listinfo/rivendell-dev
