Overview
:
PlayList
MxM provides a media management play list engine and its
user interface.
It provides the editing of the cues (Insert, read, delete...)
and the management of a list of cues (Play, stop,pause...).
The playlists are saved in a separate files, independently
from the Manager project file.
A playlist can be shared by different devices.
The playlist can be edited while it is playing.
This mxm is in charge to manage the characteristics of the
media sources . The media source status (iddle, cueing,
playing) is taken into account, considering its other programmable
properties : back to back option and delay, and cueing pre-roll
.
The parameters managed by the playlist can be set at the
creation of the device. Eight default parameters are provided,
but other parameters can be added, and each parameters can
be hidden or displayed in the playlist grid.
The eight default parameters are :
Day : the day when the cue must be played
Time : the time when the cue must be played
Media : the name of the media to play
Source : the name of the source able to play the media
TC in : the inner time when the media clip must start
TC out : the inner time when the media clip must stop
Duration : the duration of the media clip
Status : the current status of the cue (iddle, cueing, playing,
played)
Any other parameters can be added, like matrix switchers,
show-control events, programmed actions...
The eight default parameters are those which are taken into
consideration by the engine of the playlist.
The other parameters added are informations that can be
read when events occur.
Basic programming of the mxmPlayList :
When the playlist is playing, two types of event occurs
:
- events indicating that a cue must be prepared for cueing
- events indicating that a cue must be played
At this time, and after reading the parameters programmed
in the cue with the commands provided, the action must be
passed to the other mxm in charge of the media management
(For example, a video server mxm...)
Prepare event :
The event flag CueToPrepare is set to 1 when there
is a cue to prepare.
The command "Read cue to prepare" must then be called for
reading the specified cue.
After the preparation is done, the command "Set cue prepared"
must be called.
During this period, the status of the cue is displayed as
"cueing".
Play event :
The event flag CueToPlay is set to 1 when there is
a cue to play.
The command "Read cue to play" must then be called for reading
the specified cue..
When the command "Read cue to play is called", the cue is
considered to be playing, and the status of the cue is displayed
as "playing".
Then, after the playing is finished, the command "Set cue
played" must be called.
At this time, the status of the cue is displayed as "played".
> Home
Installation
(MXM) :
This
MxM doesn't require any specific installation.
> Home
Creation
(Device) :
The device is created through this setup dialog box :

Columns, Arrows, New, Delete
The parameters can be hidden or displayed in the columns
of the playlist grid. This is done in the setup dialog box
by moving the parameter name between the visible columns
list and the invisible columns list.
New parameters can be added with the 'New' button.
Parameters added can be deleted with the 'Delete' button
(the default parameters cannot be deleted).
Cue deletion delay
This value contains the count of days before a past cue
is deleted. The deleted cues are saved into backup text
files. If the value is zero, the delete mechanism is disabled.
Edition delay
This value contains the count of seconds for the security
of the edition while playing. Only the cues with time above
the current time plus this value can be edited and modified.
Backup path
This is the directory where the backup text files are saved
Saving path
This is the full path plus generic base name for saving playlists.
Files created will use the extension ".playlist" plus a number.
For example, if this name is C:\TEMP\play, each playlist
file will be numbered as they are created : play.playlist0, play.playlist1,
play.playlist2, etc...
In this path another file is created : it has the "Mediasources4"
extension and contains the characteristics of the media
sources of the device.
CuePlayed mode
If this mode is external, the command "Set Cue Played" must
be called to indicate to the playlist when a cue has finished
playing. If this mode is internal, the playlist bases upon
the TC IN and the TC OUT of the cue to know when a cue has
finished playing.
CueToPrepare mode
Put this mode on internel if no specific preparation (like,
for example, the loading of a clip) is required before playing.
If on external, a task must be called to perform this preparation
and the cammand "Set Cue Prepared" must be called when it
is done.
> Home
Graphical
User Interface:
Display
This MxM provides a graphical view (name "Display")
which can be displayed inside a User Screen Contenair object with the "Device Control"
Manager command.
> Home
Commands
(List Of) :
New Playlist :
Description
: Create a new empty playlist and add it to the list of
playlists.
Parameters :
Playlist Name [Type String] : Name of the playlist.
Playlist ID [Type : Integer] : ID of the playlist.
Output Name [Type String] : Name of the destination.
Output ID [Type : Integer] : ID of the destination.
Usage : The name of the playlist is the one displayed
in the list of playlists. The ID of the playlist is important
because it is used in the next "Set visible playlist"
command for externaly loading a new playlist into the
grid. The name and the ID of the destination are displayed
at the top of the grid. (can be blank).
Set
Visible Playlist :
Description
: Display the specified playlist.
Parameters :
Playlist ID [Type : Integer] : ID of the playlist.
Delete Playlist :
Description
: Delete the current playlist.
Parameters : no parameters.
Insert Cue :
Description
: Insert a cue at the time specified.
Parameters :
Fixed
default parameters :
Cue Day [Type : Date] : the day when the cue
must be played (SEE USAGE NOTE).
Cue Time [Type : Time] : the absolute time when the cue
must be played. For a relative insertion of the cue, you must enter a negative value (SEE USAGE NOTE).
Cue Name [Type String] : Name of the cue.
Source Name [Type String] : Name of the source.
Source ID [Type : Integer] : ID of the source
(SEE USAGE NOTE).
Timecode In [Type : Time] : the inner time when
the cue must start.
Timecode Out [Type : Time] : the inner time when
the cue must stop.
Insertion [Type :Enum] : type of insertion.
Available
values :
After : the cue is inserted after the selected cue.
Before : the cue is inserted before the selected cue.
Lock
mode [Type :Enum] : locked mode.
Available
values :
On : the cue cannot be moved by any modifications
of the other cues.
Off : the cue can be moved by a modification of the
other cues.
Additional
parameters :
The count of additional parameters is the count of columns
added in the setup of device. The type of the additional
parameters is String.
Usage
: As an empty date does not exist in Manager, the year
must be set to 1900 if the cue is an every day cue. If
the "Day" column is hidden, this parameter is not used.
For absolute insertion of the cue, just enter the "Cue Time".
In that case, the "Insertion" param is not taken into account.
Note that an automatic calculation of the time is provided. For relative insertion,
the time entered in "Cue Time" must be negative. The time of the cue inserted
with be calculated depending on the time and duration of the previous/next selected
cue.
The Source ID is important because it is taken
in account by the engine of the playlist. If a source
is playing, the playlist will wait for this source to
stop before sending the "CueToPrepare" event (unless 'abort
mode' specified). During this operation the sources are
formally identified by the IDs. The name of the source,
instead, is just an information. About the lock mode :
in the playlist grid, a red key in front of the cue indicates
that the cue is locked. The user can change this lock
state by clicking on the key.
Read
Selected Cue :
Description
: Read the current cue.
Parameters :
Fixed
default parameters :
Return Cue Day [Type : Date] : return the day when the
cue must be played.
Return Cue Time [Type : Time] : return the time when
the cue must be played.
Return Media Name [Type String] : return the name of the
media.
Return Source Name [Type String] : return the name of
the source.
Return Source ID [Type : Integer] : return the ID of
the source.
Return Timecode In [Type : Time] : return the inner
time when the cue must start.
Return Timecode Out [Type : Time] : return the inner
time when the cue must stop.
Return Status [Type :Integer] : return the current status
of the cue.
Available
values :
0 :"Idle"
1 : "Cueing"
2 : "Ready"
3 : "Playing"
4 : "Played"
Return Locked Status
[Type :Integer] : return the locked mode
Available
values :
0 :Off
1 :On
Return Duration [Type : Time] : return the duration of the cue.
Additional
parameters :
The count of return additional parameters is the count
of columns added in the setup of device. The type of
the return additional parameters is String.
Delete Selected Cue :
Description
: Delete the current selected cue.
Parameters : no parameters.
Play :
Description
: Start playing or resume the current playlist.
Parameters : no parameters.
Stop :
Description
: Stop playing the current playlist.
Parameters : no parameters.
Pause :
Description
: Pause the current playlist.
Parameters : no parameters.
Read Cue to Prepare :
Description
: Read the current cue to prepare.
Parameters :
Fixed
default parameters :
Return Cue Day [Type : Date] : return the day when the
cue must be played.
Return Cue Time [Type : Time] : return the time when
the cue must be played.
Return Cue Name [Type String] : return the name of the
cue.
Return Source Name [Type String] : return the name of
the source.
Return Source ID [Type : Integer] : return the ID of
the source.
Return Timecode In [Type : Time] : return the inner
time when the cue must start.
Return Timecode Out [Type : Time] : return the inner
time when the cue must stop.
Return Status [Type :Integer] : return the current status
of the cue.
Available
values :
0 :"Idle"
1 : "Cueing"
2 : "Ready"
3 : "Playing"
4 : "Played"
Return Locked Status
[Type :Integer] : return the locked mode.
Available
values :
0 :Off
1 :On
Additional
parameters :
The count of return additional parameters is the count
of columns added in the setup of device. The type of
the return additional parameters is String.
Usage
: IMPORTANT : This command must be called when the "CueToPrepare"
event occurs. After the media has been prepared, the command
"Set cue prepared" must be called, otherwise the next
prepare event will be blocked.
Read Cue to Play :
Description
: Read the current cue to play.
Parameters :
Fixed
default parameters :
Return Cue Day [Type : Date] : return the day when the
cue must be played.
Return Cue Time [Type : Time] : return the time when
the cue must be played.
Return Cue Name [Type String] : return the name of the
cue.
Return Source Name [Type String] : return the name of
the source.
Return Source ID [Type : Integer] : return the ID of
the source.
Return Timecode In [Type : Time] : return the inner
time when the cue must start.
Return Timecode Out [Type : Time] : return the inner
time when the cue must stop.
Return Status [Type :Integer] : return the current status
of the cue.
Available
values :
0 :"Idle"
1 : "Cueing"
2 : "Ready"
3 : "Playing"
4 : "Played"
Return Locked Status
[Type :Integer] : return the locked mode
Available
values :
0 :Off
1 :On
Additional
parameters :
The count of return additional parameters is the count
of columns added in the setup of device. The type of
the return additional parameters is String.
Usage
: IMPORTANT : This command must be called when the "CueToPlay"
event occurs.
After the media has finished playing, the command "Set
cue played" must be called, otherwise the media source
specified will not be considered as free to replay.
Set Cue Prepared :
Description
: Rearm the preparing process.
Parameters : no parameters.
Usage : This command must be called after the "CueToPrepare"
event and when the media has finished preparing, otherwise
the next prepare event will be blocked.
Set Cue Played :
Description
: Say that a cue has finished playing and frees the media
source played.
Parameters : no parameters.
Usage : This command must be called after the "CueToPlay"
event and when the media has finished playing, otherwise
the media source specified will not be considered as free
to replay.
Export
Playlist :
Description
: Exports the current playlist into a file.
Parameters :
File Name [Type String] : Name of the file.
Import Playlist :
Description
: Import a playlist from a file saved by the "Export Playlist"
command.
Parameters :
File Name [Type String] : Name of the file.
Return New ID [Type Integer] : Return the ID of the playlist imported.
Overwrite Existing [Type Enum] : Behaviour rule in case of conflict between
imported playlist ID and already existing playslit IDs.
Available
values :
0 :Off
1 :On
Usage
This function adds the imported playlist to the device. The parameter "Overwrite Existing"
allows to specify the behaviour of the import in case of ID conflict :
- if choose to overwrite existing, the existing playlist will be overwritten by the imported one
- if choose to not overwrite existing, the imported playlist will be given the first free ID in the device
The param "Return New ID" returns the ID given to the imported playlist.
As notice above, this ID can be different of the imported playlist ID
in case of conflict with no "Overwrite Existing" behaviour.
Set Font Size :
Description
: Change the size of the font of the playlist grid.
Parameters :
Size [Type : Integer] : new font size.
Back
to back :
Description
: Change the "Back to Back" mode of the specified source.
Parameters :
Source ID [Type : Integer] : ID of the source.
Back to back [Type : Enum] : mode.
Available
values :
On : the source is back to back compliant.
Off : the source is not back to back compliant.
Delay Time
(1/100) [Type : Integer] : delay in hundredths of
seconds.
Delay Type [Type Enum] : Behaviour of the delay.
Available
values :
After cue start :Delay start after cue.
Before next cue start :Delay start before next cue.
Usage : When a source has the 'back to back' property,
it can prepare a new media while it is playing another
media. The delay is the time that the media needs for
preparing. Example : if a cue must play at 01:10, and
the source is playing but is back to back compliant, and
the back to back delay for the source is 00:10, a "EventToPrepare"
event will occur at 01:00 concerning this cue.
Set timecode :
Description
: Change the type of timecode.
Parameters :
External [Type : Enum] : type
Available
values :
On : the timecode is external
Off : the timecode is internal (default value)
Timecode
[Type : Time] : the time variable on which the playlist
will be slaved
Offset [Type : Time] : the time offset to substract
to the Timecode reference
Date [Type : Date] : the date variable on which the playlist will be slaved
Usage : If the time is internal; the two time parameters
are not taken in account.
Set clip abort :
Description
: Change the event mode of the playlist.
Parameters :
Abort [Type : Enum] : type
Available
values :
On : set the playlist in abort mode.
Off : set the playlist in normal mode.
Usage
: Normal mode : if it is time to play or prepare a
cue but the media source is busy playing, the playlist
waits for the source to stop before setting the event.
Abort mode : if it is time to play or prepare a cue, the
playlist sets the event, even if the media source is busy
playing.
Copy cues :
Description
: Copy the selected cues into an internal buffer.
Parameters : no parameters.
Paste
at :
Description
: Paste the cues previously copied at the specified time.
Parameters :
Time [Type : Time] :The paste time of the first
cue in the buffer.
Offset cues :
Description
: Apply a time offset to the selected cues.
Parameters :
Time offset [Type : Time] : the paste time of the
first cue in the buffer.
Set loop :
Description
: Set the loop mode on/off.
Parameters :
Looping [Type : Enum] : type
Available
values :
On : set the playlist in loop mode
Off : set the playlist in normal mode
Usage
: The loop mode can only work with internal timecode.
Get source status :
Description
: Retrieve the characteristics of a source.
Parameters :
Source ID [Type : Integer] : ID of the source to
read from.
Return back to bak [Type : Integer] : set to 1
in return if the source is in back to back mode .
Return delay [Type : Integer] : set to back to
back delay in return.
Return pre-roll [Type : Integer] : set to pre-roll
delay in return (see command "set pre-roll").
Goto date :
Description
: Search for the cue at this date and time and select
it.
Parameters
Datet [Type : Date] : date of the cue.
Time [Type : Time] : time of the cue.
Read cue by index :
Description
: Read the cue at the specified index.
Parameters :
Fixed default parameters :
Cue index [Type : Integer] : specified index.
Return Cue Day [Type : Date] : return the day when the
cue must be played.
Return Cue Time [Type : Time] : return the time when the
cue must be played.
Return Media Name [Type String] : return the name of the
media.
Return Source Name [Type String] : return the name of
the source.
Return Source ID [Type : Integer] : return the ID of the
source.
Return Timecode In [Type : Time] : return the inner time
when the cue must start.
Return Timecode Out [Type : Time] : return the inner time
when the cue must stop.
Return Status [Type :Integer] : return the current status
of the cue.
Available
values :
0 :"Idle"
1 : "Cueing"
2 : "Ready"
3 : "Playing"
4 : "Played"
Return Locked Status
[Type :Integer] : return the locked mode.
Available
values :
0 :Off
1 :On
Return Duration [Type :Integer] : return the duration of the cue.
Additional
parameters :
The count of return additional parameters is the count
of columns added in the setup of device. The type of the
return additional parameters is String.
Usage : Can be used for scanning playlists for
specific cues.
Set pre-roll :
Description
: Set the pre-roll time of a source.
Parameters :
Source ID [Type : Integer] : ID of the source
Pre-roll (1/100) [Type : Integer] : pre-roll delay
Usage : When the pre-roll time of a source is not
null, each CueToPlay event concerning this source occurs
in advance of this amount of time.
Insert
Playlist :
Description
: Insert at the specified time in the current palylist
a whole playlist from a file saved by the "Export Playlist"
command.
Parameters :
File Name [Type String] : Name of the file.
Time [Type : Time] :The insert time.
Index of :
Description
: Return the index of the cue containing the specified
text
Parameters :
Text to search [Type String] : Search text
Search mode [Type : Enum (find first, find next)]
: Search mode
Return index [Type : Integer] : Return value
Force
cue status :
Description
: Set the display of status of the specified cue to a
specified value.
Parameters :
Cue index [Type : Integer] : Index of the cue
New state [Type : Enum] : Iddle, Cueing, Ready,
Playing, Played, Error.
Take
:
Description
: Jump to the first cue selected, change the time of this
cue to the time specified, deleting all the cues between
the current cue time and the cue selected.
Parameters :
Time [Type : Time] :The take time.
Convert to XML :
Description
: Converts the current playlist to a XML string
Parameters :
Return String [Type : String] :The string to be
filled in return.
FTP Server Name [Type : String] :Name of the FTP server.
FTP User Name [Type : String] :Name of the FTP user.
FTP Password [Type : String] :Password for connection to the FTP server.
FTP Local Path [Type : String] :Local path on the FTP.
Usage :
This string can be used for sending the playlist as a
sequence to the Medialon Display Player.
> Home
Variables
(List Of) :
CueIndex
:
Type
: Integer.
Description : Index of the current cue.
CueToPrepare :
Type
: Integer.
Description : Flag : cue to prepare.
Usage : This flag is set to 1 when there is a cue
to prepare. The command "Read cue to prepare" must be
called. Then, after the preparation is done, the command
"Set cue prepared" must be called. During this period,
the status of the cue is displayed as "cueing".
CueToPlay :
Type
: Integer.
Description : Flag : cue to play.
Usage : This flag is set to 1 when there is a cue
to play. The command "Read cue to play" must be called.When
the command "Read cue to play" is called, the cue is considered
to be playing, and the status of the cue is displayed
as "playing". Then, after the playing is finished, the
command "Set cue played" must be called. At this time,
the status of the cue is displayed as "played".
FileError
Type
: Integer.
Description : Flag : file error.
Usage : This flag is set to 1 when an error occurs
during a read or write operation of a file.
Timecode :
Type
: Time.
Description : Value of the current timecode (internal
or external).
Status :
Type
: Enum.
Description : Status of the current playlist.
Available values :
"Stopped" : the playlist is not playing.
"Playing" : the playlist is playing.
"Paused" ; the playlist is paused.
CuesCount :
Type
: Integer.
Description : Count of cues of the current playlist.
PlaylistsCount :
Type
: Integer.
Description : Count of playlists managed by this
device.
PlaylistsList :
Type
: List of strings.
Description : List of the playlist names of this
device.
LoopStatus :
Type
: Enum.
Description : Loop status mode.
Available values :
"On" : loop mode is on.
"Off" : loop mode is off.
AbortStatus :
Type
: Enum.
Description : Abort status mode.
Available values :
"On" : abort mode is on.
"Off" : abort mode is off.
Clock :
Type
: Enum.
Description : Timecode mode.
Available values :
"Internal" : internal timecode is used.
"External" : external timecode is used.
VisibleListName :
Type
: String.
Description : Name of the current playlist.
VisibleListID :
Type
: String.
Description : ID of the current playlist.
Message :
Type
: String
Description : PlayList message.
Available values :
"OK"
"Current playlist is playing"
"Unknown playlist ID"
"No current playlist"
"Impossible in play mode"
"Wrong filename".
PlayListIDList :
Type
: List of strings.
Description : List of the playlists IDs.
IndexListOfSelectedCues :
Type
: String.
Description : Index list of the current selected cues in the current playlist.
> Home
Support (Difference with previous versions) :
> Top
|