Pinnacle Systems AirSpeed 5000 User Manual

AirSpeed 5000 API Guide

Copyright: (c) 2008-2012 Avid Technology, Inc. All rights reserved. This document contains confidential and proprietary information. Usage and dissemination of this
information is governed by the applicable non-disclosure agreements. AirSpeed 5000 API Guide P/N: 9329- 65226-00 Rev A Date: 4/26/12
AirSpeed 5000 API Guide Page i
Table of Contents
OVERVIEW .................................................................................................................................................. 1
CHANNEL CONTROL AND COMMAND BASICS ................................................................................ 2
Formatting ....................................................................................................................................................... 2
Response .......................................................................................................................................................... 2
CONFIGURATION COMMANDS ............................................................................................................. 3
Initialize ........................................................................................................................................................... 4
GetConfigInfo ................................................................................................................................................. 5
GetHardwareStatus .......................................................................................................................................... 7
Disconnect ....................................................................................................................................................... 8
TRANSPORT CONTROL COMMANDS .................................................................................................. 9
PlayCue ......................................................................................................................................................... 10
UnloadCuedClip ............................................................................................................................................ 11
LoadPlayList ................................................................................................................................................. 12
CuePlayListItem ............................................................................................................................................ 13
RecordCue ..................................................................................................................................................... 14
Shuttle ............................................................................................................................................................ 16
Play ................................................................................................................................................................ 17
Continue ........................................................................................................................................................ 18
Record ........................................................................................................................................................... 19
Pause .............................................................................................................................................................. 20
Eject ............................................................................................................................................................... 21
Stop................................................................................................................................................................ 22
SetInOut ........................................................................................................................................................ 23
Jog ................................................................................................................................................................. 24
GoTo .............................................................................................................................................................. 25
SetRecordDur ................................................................................................................................................ 26
GetStatus ....................................................................................................................................................... 27
GetSystemStatus ............................................................................................................................................ 29
GetInputStatus ............................................................................................................................................... 30
GetTC ............................................................................................................................................................ 31
DATABASE CONTROL COMMANDS ................................................................................................... 32
GetClipList .................................................................................................................................................... 33
GetPlayLists .................................................................................................................................................. 34
GetPlayListInfo ............................................................................................................................................. 35
SetPlayListAttributes ..................................................................................................................................... 36
CreatePlayList ............................................................................................................................................... 37
DeletePlayList ............................................................................................................................................... 39
RenamePlayList ............................................................................................................................................. 40
AddClipToPlayList........................................................................................................................................ 41
RemoveClipFromPlayList ............................................................................................................................. 42
Transfer (to Interplay) ................................................................................................................................... 43
Create Proxy .................................................................................................................................................. 44
GetProxyStatus .............................................................................................................................................. 45
GetTransferStatus .......................................................................................................................................... 46
GetTransferList ............................................................................................................................................. 47
DeleteClip ...................................................................................................................................................... 48
AirSpeed 5000 API Guide Page i
GetClipData ................................................................................................................................................... 49
SetClipData ................................................................................................................................................... 51
GetChangeList ............................................................................................................................................... 52
GetGenericTemplate...................................................................................................................................... 53
GetGenericTemplateIds ................................................................................................................................. 54
GetGenericDefaultTemplateId ...................................................................................................................... 55
AirSpeed 5000 API Guide Page ii

Overview

The AirSpeed 5000 API is a TCP/IP socket based protocol used to control and query the AirSpeed 5000 server. The commands are sent and received using XML (Extensible Markup Language) formatting.
The following items apply:
TCP/IP available ports (59451-59456) (m ax of 10 connections per port)
XML Info: <?xml version="1.0" encoding="utf-8"?>.
Only one XML command may be sent at a time.
The major XML commands are formatted as tags “elements”.
Many of the “element” commands have corresponding “attribute” data.
All XML references to “TC” are the for matted STRING Time Code (HH:MM:SS:F F) (; if Drop Frame). Most attribute
type of “TC” will also allow the same attribute name with ‘i’ preceding it as an INT representation of the Time Code “iTC”.
For example, “StartTime=TC” will also allow “iStartTime=iTC” represented as an INT. The “TC” STRING will be searched for first, and if found, the “iTC” should not be sent. It will be ignored.
There are three command categories (Configuration, Transport and Database).
STANDARD is the video standard name. Valid names are:
SD_NTSC_4x3_29_970 SD_PAL_4x3_25_000 HD_1920x1080i_29_970 HD_1920x1080i_25_000 HD_1280x720p_59_940 HD_1280x720p_50_000
Note: All references to VITC also pertain to ancillary time code (ATC) as well.
AirSpeed 5000 API Guide Page 1

Channel Control and Command Basics

Controlli ng an AirSpeed 5000 server via API begins with establishing a connection to the server. The available connection ports are 59451 – 59456 for channels 1-6 respectively. There can be up to 5 separate connections per port. Multiple connections on the same port will run synchronously, with only one command processed at a time.
If no data is received on the AirSpeed 5000 server for 60 seconds, then the connection will automatically be closed by the AirSpeed 5000 server.
Each connection port (59451-59456) will default to a corresponding channel number (1-6). Only ports with corresponding channels that have hardware connected will be activated.
Note: Some Transport commands such as Play Cue, and Record Cue take longer to process than Status commands.

Formatting

All commands are formatted using XML data packets with the following major tags. <?xml version="1.0" encoding=" utf-8"?> <AMS><Configuration></Configuration></AMS> Configuration commands <AMS><TransportControl></TransportControl></AMS> Transport Control commands <AMS><DatabaseControl></DatabaseControl></AMS> Database Commands
Note: The terminating XML tag “</AMS>” will not be followed by a NULL. Note: The client can only send one of the major tags at any one time.

Response

All XML commands will respond when the command is completed with the following: <AMS><Reply Status=”STATUS” Msg=”MESSAGE” ErrNum=”N” /></AMS> Message response
The STRING attribute “Status” is the Reply Status
OK – No error ERROR – Error Occured WARNING – Warning
The STRING attribute “Msg” contains the warning or error message. This attribute will not exist if the “Status” = “OK”.
The INT attribute “ErrNum” contains an error value, along with the description of the error in the “Status” attribute. The attribute “ErrNum” will not exist if the “Status” = “OK” 1 – Command Error 2 – System Error 3 – XML format error 4 – System BUSY
Note: Many commands will send additional tagged information along with the OK response
AirSpeed 5000 API Guide Page 2

Configuration Commands

The Airspeed 5000 API provides several convenience commands for requesting configuration information from the AirSpeed
5000. These commands are defined as the major tag <Configuration> and are typically sent during the initialization sequence, but may be sent at any time.
AirSpeed 5000 API Guide Page 3
Initialize
This command is used to verify the connection between the client and the server, and retrieve information about the channel.
<AMS><Configuration> <Initialize /> </Configuration></AMS>
Attribute Parameters
Not applicable.
Return Tag Elements and Attributes
<Version>VER</Version>
VER is the STRING value o f the current version of AirSpeed 5000
<ChnInfo ChnNum=”N” CanRecord=”false” />
The INT attribute “ChnNum” is the channel number being controlled. The BOOL attribute “CanRecord” is true if this is a record channel, else false.
Remarks
This command can be used to verify communication with the channel.
AirSpeed 5000 API Guide Page 4
GetConfigInfo
This command is used to ge t system configuration i nformation. <AMS><Configuration> <GetConfigInfo/> </Configuration></AMS>
Attribute Parameters
Not applicable.
Return Tag Elements and Attributes
<NumChannels>N</NumChannels>
N is the INT value of the nu mber of channels available.
<VidStandard>STANDARD</VidStandard>
STANDARD i s the system video standard.
<CompatibleVidStandards>STANDARD</CompatibleVidStandards>
STANDARDS are a list of compatible vid e o standards delimited by ‘;’.
<DropFrame>BOOL</DropFrame>
BOOL is true if drop frame, false if not drop frame.
<SystemType>TYPE</SystemType>
TYPE = 1 (GEN1, 2 (GEN2).
<SystemMode>MODE</SystemMode>
MODE = “Standalone”, “Team” or “Interplay”.
<ProxyRecordingEnabled>BOOL</ProxyRecordingEnabled>
BOOL is true if proxy recording is enabled, false if proxy recording is not enabled.
<TransferEngineEnabled>BOOL</TransferEngineEnabled>
BOOL is true if transfer engine is enabled for auto transfers, else false.
<ChnInfo <Channel Num=”N” Name=”NAME” VidStandard=”STANDARD” …/> </ChnInfo>
“ChnInfo” contains a list of “Channel” Tags. There is one Channel Tag returned for each Channel. The INT attribute “Num” is the actual channel number. The STRING attribute “VidStandard” is the channel video standard.
AirSpeed 5000 API Guide Page 5
The STRING attribute “Name” is the name of the channel. The STRING attribute “VitcPlay” is the VITC playback line number The BOOL attribute “ProxyRecordingEnabled” is “true” if proxy recording is enabled. The STRING attribute “VitcRecord” is the VITC record line number.
The STRING attribute “OutputFormatBehavior” is the output format behavior:
FIXED – No format conversions. UDX – Up / Do wn / Cross convert. SWITCH – Swit ch the actual output standard.(on the fly)
Remarks
Not applicable.
AirSpeed 5000 API Guide Page 6
GetHardwareStatus
This command is used to ge t system hardware status. <AMS><Configuration> <GetHardwareStatus Verbose=”false”/> </Configuration></AMS>
Attribute Parameters
Verbose
This is an optional BOOL attrib ute. If this is true then the return error message “Ms g” is to be verbose. The default is false.
Return Tag Elements and Attributes
<HardwareStatus>STRING</HardwareStatus>
STRING is “OK” if there are no errors, “ERROR” if there are errors.
<Msg>STRING</Msg>
STRING is a description of the hardware error, if Verbo se= true then the description is verbose. I f HardwareStatus=OK then this tag is not returned.
Remarks
Not applicable.
AirSpeed 5000 API Guide Page 7
Disconnect
This command is used to disconnect the client from the server. <AMS><Configuration> <Disconnect /> </Configuration></AMS>
Attribute Parameters
Not applicable.
Return Tag Elements and Attributes
Not applicable.
Remarks
If the command is successful, it will send the normal “OK” response and then the server will immediately disconnect from the client. The client will have to reestablish socket communication to control the channel.
AirSpeed 5000 API Guide Page 8

Transport Control Commands

These commands are used to control the transport for the selected channel.
AirSpeed 5000 API Guide Page 9
PlayCue
This command is used to cue a clip for playback. <AMS><TransportControl> <PlayCue ID=”ClipID” In=”TC” Out=”TC” AutoPlay=”false” ShowFirst=”true” EjectFirst=”true” TcRef=”REF” /> </TransportControl></AMS>
Attribute Parameters
ID
This is a required STRING attribute. This is the ID of the clip that is to be cued for playback.
In
This is an optional STRING attribute t o set the beginning TC location for the clip play. The default is to cue to the beginning of the clip.
Out
This is an optional STRING a ttribute to set the end TC location for the clip play. The default is to play to the end of the clip.
ShowFirst
This is an optional BOOL attrib ute indic a ting if the system is to show the first frame on t he output cha nnel for the cued clip. The default is false.
EjectFirst
This is an optional BOOL attrib ute indic a ting if the system is to eject the cued clip if has not currently active. The default is false.
AutoPlay
This is an optional BOOL attrib ute indic a ting if the cued clip is to automatically start playing when the currently playing clip completes. If no clip is curr e ntly playing, then this fl ag is ignored. The default is false.
TcRef
This is an optional STRING attribute indicating if the time code calculations are to be referenced on the Output channel’s video standard, or the clips video standard. The default is OUTPUT REF = OUTPUT – Use the c hannel’s output video standard (Default ) REF = CLIP – Use the active clip’s video standard.
PlayList
This is an optional BOOL attrib ute indic a ting that the ID is the name of a sequence to be loaded. If this is set to true then the attributes “In” and “Out” are ignor e d. The default is false.
Return Tags
Not applicable.
Remarks
This command puts the channel in Play mode, if it is currently in Record mode. The ShowFirst=”true” attribute will not take affect if the PlayCue comma nd is issued while a clip playing.
AirSpeed 5000 API Guide Page 10
UnloadCuedClip
This command is used to unload a clip that is cued for playback. <AMS><TransportControl> <UnloadCuedClip/> </TransportControl></AMS>
Attribute Parameters
Return Tags
Not applicable.
Remarks
This command will unload a clip that is c ued for play back.
AirSpeed 5000 API Guide Page 11
LoadPlayList
This command is used to load an already created play list for playback. <AMS><TransportControl> <LoadPlayList Name=”Name” StartItem=”0” ShowFirst=”true” EjectFirst=”true” TcRef=”REF” UpdateToDisk=”true” /> </TransportControl></AMS>
Attribute Parameters
Name
This is a required STRING attribute. This is the Name of the Play List to be readied for playback.
StartItem
This is an optional INT attribute indica ting the item number to start playing from in the Play List. The default is 0 (first item).
ShowFirst
This is an optional BOOL attrib ute indic a ting if the system is to show the first frame on the output channel for the cued clip. The default is false.
EjectFirst
This is an optional BOOL attribute indicating if the system is to eject the cued clip if has not currently active. The default is false.
TcRef
This is an optional STRING attribute indicating if the time code calculations are to be referenced on the Output channel’s video standard, or the clips video standard. The default is OUTPUT REF = OUTPUT – Use the c hannel’s output video standard (Default ) REF = CLIP – Use the active clip’s video standard.
UpdateToDisk
This is an optional BOOL attrib ute indic a ting that changes made to load ed play list will be updated to disk. The default is true.
Return Tags
Not applicable.
Remarks
This command puts the channel in Play mode, if it is currently in Record mode. The ShowFirst=”true” attribute will not take affect if the PlayCue comma nd is issued while a clip playing.
AirSpeed 5000 API Guide Page 12
CuePlayListItem
This command is used to cue a clip for play back in already loaded Play List. <AMS><TransportControl> <CuePlayListItem CueItem=”0” ShowFirst=”true” /> </TransportControl></AMS>
Attribute Parameters
CueItem
This is an optional INT attribute indica ting the item number to cue in the Play List. The default is 0 (first item).
ShowFirst
This is an optional BOOL attrib ute indic a ting if the system is to show the first frame on the output channel for the cued clip. The default is false.
Return Tags
Not applicable.
Remarks
The play list will automatically cue the next event as it plays the Play List Sequence. This command is only required to change the next cued item.
The ShowFirst=”true” attribute will not take affect if the PlayCue comma nd is issued while a clip playing.
AirSpeed 5000 API Guide Page 13
RecordCue
This command is used to cue a clip for recording. <AMS><TransportControl> <RecordCue ID=”ClipID” Name=”Clip Name” Len=”TC” OverWrite=”false” EjectFirst=”false” TimeCodeSrc=”SYSTEM” />
<RecordTemplate>template</RecordTemplate> <ProxyTemplate>template</ProxyTemplate> <DestinationTemplate>template</DestinationTemplate>
</TransportControl></AMS>
Attribute Parameters
ID
This is a STRING attribute. This is the ID of t he c lip that is to be cued for recording If this attribute does not exist, the AirSpeed 5000 will auto matically assign a new ID.
Len
This is an optional STRING a ttribute TC length to record the clip . T he default (0) is to record until a STOP command is issued.
OverWrite
This is an optional BOOL attrib ute indic a ting if the clip already exists it may be deleted first. The default is false.
EjectFirst
This is an optional BOOL attrib ute indic a ting that the channel should be ejected before the cue is initiated. The default i s false;
TimeCodeSrc
This is an optional STRING attribute defining the record timecode sourc e . T he default is SYSTEM; Options are:
SYSTEM: Use the AirSpeed 5000 System setting NONE: No Timecode Source, starts at 0 TOD: Timecode source is Time of Day
VITC: Timecode source is VITC
AirSpeed 5000 API Guide Page 14
Passed Tags
RecordTemplate
This is an optional STRING tag containing the record template XML data. This TAG will be formatted as a CDATA section:
<RecordTemplate><![CDATA[data]]></RecordTemplate>
ProxyTemplate
This is an optional STRING tag containing the proxy record template XML data. This TAG will be formatted as a CDATA section:
<ProxyTemplate><![CDATA[data]]></ProxyTemplate>
DestinationTemplate
This is an optional STRING tag containing the destination template XML data . This TAG will be formatted as a CDATA section:
<DestinationTemplate><![CDATA[data]]></DestinationTemplate>
Return Tags
<ID>ClipID</ID>
The STRING tag ID is name of the clip cued for recording
Remarks
This command puts the channel in Record mode if it i s currently in Play mode.
AirSpeed 5000 API Guide Page 15
Shuttle
This command is used to shuttle an active clip. <AMS><TransportControl> <Shuttle Speed=”1.0”/> </TransportControl></AMS>
Attribute Parameters
Speed
This is an optional FLOAT attribute indicating play speed. The allowable speed ranges are (-10.0 to 10.0) A nega tive value will play in reverse. The default is 1.0 indicating play forward at normal speed.
Return Tags
Not applicable
Remarks
Not applicable.
AirSpeed 5000 API Guide Page 16
Play
This command is used to play the cued item. If nothing is cued, this command will ret urn an error . <AMS><TransportControl> <Play Speed=”1.0” StartTime=”TC”/> </TransportControl></AMS>
Attribute Parameters
Speed
This is an optional FLOAT attribute indicating play speed. The allowable speed ranges are (-10.0 to 10.0) A nega tive value will play in reverse. The default is 1.0 indicating Play Forward at normal speed.
StartTime
This is an optional STRING attribute for the start time TC (time of day). The default is to start immediately.
Return Tags
Not applicable.
Remarks
Not applicable.
AirSpeed 5000 API Guide Page 17
Continue
This command is used to c ontinue playing an active paused clip. <AMS><TransportControl> <Continue/> </TransportControl></AMS>
Attribute Parameters
Not applicable.
Return Tags
Not applicable.
Remarks
Not applicable.
AirSpeed 5000 API Guide Page 18
Record
This command is used to record a clip cued for record. <AMS><TransportControl> <Record StartTime=”TC”/> </TransportControl></AMS>
Attribute Parameters
StartTime
This is an optional STRING attribute for the start time TC (time of day). The default is to start immediately.
Return Tags
Not applicable.
Remarks
Not applicable.
AirSpeed 5000 API Guide Page 19
Pause
This command will pause the Active I d that is playing. If there is a cued clip, but no active ID, this command causes the cued clip to become active, and its first frame appears paused on the output.
<AMS><TransportControl> <Pause/> </TransportControl></AMS>
Attribute Parameters
Not applicable.
Return Tags
Not applicable.
Remarks
Not applicable.
AirSpeed 5000 API Guide Page 20
Eject
This command ejects the Active Id that is either cued, playing or recording and puts the channel in Play mode <AMS><TransportControl> <Eject/> </TransportControl></AMS>
Attribute Parameters
Not applicable.
Return Tags
Not applicable.
Remarks
Not applicable.
AirSpeed 5000 API Guide Page 21
Stop
This command will stop the Ac tive I d that is either playing or recording. If it is playing, then the Active ID will be ejected. If it is recording, then the Acti v e I D wi l l be stopped and the AirSpeed 5000 will remain in Record mode. Issuing this command in Record mode when there is no active clip causes the channel to enter Play mode.
<AMS><TransportControl> <Stop/> </TransportControl></AMS>
Attribute Parameters
Not applicable.
Return Tags
Not applicable.
Remarks
Not applicable.
AirSpeed 5000 API Guide Page 22
SetInOut
This command will Set the In/Out for a clip that is currently cued for playback. <AMS><TransportControl> <SetInOut In=”TC” Out=” TC” TcRef=”REF” /> </TransportControl></AMS>
Attribute Parameters
In
This is an optional STRING attribute for the new TC in point. The default is to leave unchanged.
Out
This is an optional STRING attribute for the new TC out point. The default is to le a ve unchanged.
TcRef
This is an optional STRING attribute indicating if the time code calculations are to be referenced on the Output channel’s video standard, or the clips video standard. The default is OUTPUT REF = OUTPUT – Use the c hannel’s output video standard (Default ) REF = CLIP – Use the active clip’s video standard.
Return Tags
Not applicable.
Remarks
Not applicable.
AirSpeed 5000 API Guide Page 23
Jog
This command jogs the active clip. <AMS><TransportControl> <Jog FrameCnt=”N”/> </TransportControl></AMS>
Attribute Parameters
FrameCnt
This is an optional INT attribute for the number of frames to jog. A negative n umber will jog in reverse. The default is to jog one frame forward.
Return Tags
Not applicable.
Remarks
Not applicable.
AirSpeed 5000 API Guide Page 24
GoTo
This command positions the ActiveID to the passed location. <AMS><TransportControl> <GoTo Location=”N” TcRef=”REF” /> </TransportControl></AMS>
Attribute Parameters
Location
This is an STRING attribute for the lo c a tion to position the Active Clip to.
TcRef
This is an optional STRING attribute indicating if the time code calculations are to be referenced on the Output channel’s video standard, or the clips video standard. The default is OUTPUT REF = OUTPUT – Use the c hannel’s output video standard (Default ) REF = CLIP – Use the active clip’s video standard.
Return Tags
Not applicable.
Remarks
Not applicable.
AirSpeed 5000 API Guide Page 25
SetRecordDur
This command changes t he recording c l ip’s record duration. <AMS><TransportControl> <SetRecordDur Dur=”N” /> </TransportControl></AMS>
Attribute Parameters
Dur
This is an STRING attribute for the new duration of the recor ding clip.
Return Tags
Not applicable.
Remarks
There must be a clip recording or cued for r ecording on the channel for t hi s command to be valid.
AirSpeed 5000 API Guide Page 26
GetStatus
This command gets the status of a channel. <AMS><TransportControl> <GetStatus TimeCode=”TYPE” InputStatus=”false” TcRef=”REF”/> </TransportControl></AMS>
Attribute Parameters
TimeCode
This is an optional STRING a ttribute indicating the TC time is to be r e turned. The default is to return all time code types. TYPE = ABSOLUTE - Return the a bsolute time code. TYPE = ZEROBASE – Return the zero based time code as if the clip started at zero. TYPE = REMAINING – Return amount of time remaining on clip. TYPE = FRAMECOUNT – Return the zero base time code as if the clip started at the in point.
InputStatus
This is an optional BOOL attribute indicating if the Inp ut Status is requested as well. The default is (false) to not return the Input Sta tus.
TcRef
This is an optional STRING attribute indicating if the time code calculations are to be referenced on the Output channel’s video standard, or the clips video standard. The default is OUTPUT REF = OUTPUT – Use the c hannel’s output video standard (Default ) REF = CLIP – Use the active clip’s video standard.
Return Tags
<StatusInfo Ctrl=”IDLE” RecMode=”” Active=”ID” Name="Name" Cued=”ID” Pos=”TC” iPos=”N” Off="TC" iOff="N" Frame="TC" iFrame="N" Rem="TC" iRem="N" Dur="TC" iDur=N />
The STRING attribute “Ctrl” is the “Active clip” status. The valid “ctrl” responses are:
IDLE – No Active Clip
PAUSED – Active Clip paused
PLAYING – Active Clip P laying
SHUTTLING – Active Clip Shuttling
JOGGING – Active Clip Jogging
VARIPLAY – Active Clip Variable Playing
RECORDING – Active Clip recording
CUED – Active Clip is cued for playback (first frame is bei ng shown) or record.
DONE – Active Clip played to end
ERROR – Last cue operation failed (will stay in this state until ano ther c ue is issued)
The BOOL attribute “RecMode” is true if in Record mode, false if in Play mode.
AirSpeed 5000 API Guide Page 27
The STRING attribute “Active” is the ID of the Active Clip. This attribute will not exist if there are nocurrently active clips.
The STRING attribute "Na me" is the name of the Active Clip. The STRING attribute “Cued” is the ID of the Cued Clip. This attribute will not exist if no clip is currently cued The STRING attribute “Pos” is the selected TC position for the Active clip. This is the ABSOLUTE timecode if “TimeCode” was not set. The INT attribute “iPos” is the selected INT position for the Active clip. This is the ABSOLUTE timecode if “TimeCode” was not set. The STRING attribute “Off” is the zero based offset TC for the Acti ve clip, if Timecode was not set. The INT attribute “iOff” is the zero based INT offset TC for the Active clip if Timecode was not set. The STRING attribute "Frame” is the frame count TC for the Active clip if “Timecode” was not set. The INT attribute “iFrame” is the frame count INT offset TC for the Active clip if “Timecode” was not set. The STRING attribute “Rem” is the remaining TC for the Active clip if “Timecode” was not set. The INT attribute “iRem” is the current INT remaining TC for the Active clip if “Timecode” was not set. The STRING attribute “Dur” is the duration TC for the Active clip. The INT attribute “iDur” is the INT duration TC for the Active clip.
<VidStandard>STANDARD</VidStandard>
STANDARD is the channel’s current video standard.
<InputStatus Video=”” VITC=”” /> returned ONLY if InputStatus=true
The STRING attribute “Video” returns ”Present” or “Missing” The STRING attribute “VITC” r e turns ”Missing” or “HH:MM:SS:FF”:
<PlayList Name=”Name” ActivePos=”n” CuePos=”n” PlayoutControl=”Follow”
Pos=”TC” iPos=”N” Dur=”TC” iDur=”N”
/> returned ONLY if playing item is part of a playlist
The STRING attribute “Name” returns the name of the active playlist The INT attribute “ActivePos” returns the position of the active item in the playlist (-1 if none) The INT attribute “CuePo s” returns the position of the cued ite m in the playlist (-1 if none) The STRING attribute “Pla yo utControl” returns the start control of the cued clip (if clip is cued) The STRING attribute “Pos” is the zero based TC for the position in the Play List. The INT attribute “iPos” is the INT zero based for the position in the Play List. The STRING attribute “Dur” is the total duration TC for the Play List. The INT attribute “iDur” is the INT total duration for the Play List.
Remarks
If the “Cued” attribute exists, then a clip is cued for playback or record If the Ctrl attribute is CUED, then a clip is active and cued and its first frame is being shown on the output. If the “Active” attribute does not exist then the status is IDLE
AirSpeed 5000 API Guide Page 28
GetSystemStatus
This command gets the status of an AirSpeed 5000 server. <AMS><TransportControl> <GetSystemStatus DiskMode=”MODE” /> </TransportControl></AMS>
Attribute Parameters
DiskMode
This is an optional STRING attribute indicating return type for the disk information. The default is to return the disk information in SECONDS. MODE = FRAMES - Return the disk information in frames. MODE = SECONDS - Return the disk information in seconds. MODE = MINUTES - Return the disk information in minutes. MODE = HOURS - Return the disk infor mation in hour s . MODE = BYTES - Return the disk information in bytes. MODE = MEGABYTES - Return t he disk information in megabytes.
Return Tags
<SystemInfo Total=”” Remaining=”” TOD=”” Reference=”” ConfigSerialNumber=””/>
The INT attribute “Total” is the total disk space returned in MODE units: The INT at tribute “Remaining” is the remaining disk space returned in MODE units: The STRING attribute “TOD” is the current TOD ”Missing” or “HH:MM:SS:FF” The STRING attribute “Reference” is the current reference. Reference Returns:
“NO REFERENCE, “WRONG REFERENCE, “REFERENCE UNLOCKED”, “REFERENCE OK”
The INT attribute “ConfigSerialNumber” is the number of times the Settings Database has been modified since startup
Remarks
Not applicable.
AirSpeed 5000 API Guide Page 29
GetInputStatus
This command gets the input channel status <AMS><TransportControl> <GetInputStatus” /> </TransportControl></AMS>
Attribute Parameters
Not applicable
Return Tags
<InputStatus Video=”” VITC=”” />
The STRING attribute “Video” returns ”Present” or “Missing” The STRING attribute “VITC” returns ”Missing” or “HH:MM:SS:FF”:
Remarks
VITC values are only available while recording
AirSpeed 5000 API Guide Page 30
GetTC
This command gets the Time Code of a channel.
<AMS><TransportControl> <GetTC Mode=”TYPE” TcRef=”REF”/> /> </TransportControl></AMS>
Attribute Parameters
Mode
This is an optional STRING attribute indicating the mode of the time code to be returned. The default is ABSOLUTE. TYPE = ABSOLUTE - Return the a bsolute time code. TYPE = ZEROBASE – Return Zero based time code. TYPE = REMAINING – Return amount of time remaining on clip. TYPE = FRAMECOUNT – Return the zero base frame count of the current position.
TcRef
This is an optional STRING attribute indicating if the time code calculations are to be referenced on the Output channel’s video standard, or the clips video standard. The default is OUTPUT REF = OUTPUT – Use the c hannel’s output video standard (Default ) REF = CLIP – Use the active clip’s video standard.
Return Tags
<TCinfo Pos=”TC” iPos=”N” FrameRate=”N” DropFrame=’true”/>
The STRING attribute “Pos” is the current/remaining TC position for the Active clip. The INT attribute “iPos” is the curre nt INT position for the Active clip. The INT attribute “FrameRate” is the frame rate for the time code returned. The BOOL attribute “DropFrame” is true if time code is in drop frame mode.
Remarks
Not applicable.
AirSpeed 5000 API Guide Page 31

Database Control Commands

These commands are used to interface to the AirSpeed 5000 database.
AirSpeed 5000 API Guide Page 32
GetClipList
This command is used to get a list of the clips IDs and minimal information from the database. <AMS><DatabaseControl> <GetClipList ResetList=”true” NumClips=”50” MinList=”false” /> </DatabaseControl></AMS>
Attribute Parameters
ResetList
This is an optional BOOL attrib ute indic a ting whether the clip list is to be re set to the beginning. The default is true. Set this to false to retrieve subsequent items in the list.
NumClips
This is the optional INT attribute indica ting the number of clips to retrieve at one time. The allowable range is 1-50, and the default is 50.
MinList
This is the optional BOOL attrib ute indic a ting the GetClipList will only return the clip ID. This makes for faster clip name retrieval. The default is “false”.
Return Tag Elements and Attributes
<TotalClips />
This is only s ent back when the “ResetList” attribute is set to true. This value is the total number of clips curren tly in the database at the time of the ResetList command..
<NumClips />
The number of clips retrieved. When this number is less than the passed “NumClips” value, the end of the clip list has been reached.
<ClipInfo <Clip ID=”ClipID” In=”TC” iIn=”N” Out=”TC” iIn=”N” /> </ClipInfo>
“ClipInfo” contains a list of “Clip” Tags. There is one Clip Tag returned for each Clip retrieved. The STRING attribute “ID” is the actual clip ID. The STRING attribute “In” is the mark i n TC. The INT attribute “iIn” is the mark in frame count. The STRING attribute “Out” is the mark out TC. The INT attribute “iOut” is the mark out frame count.
AirSpeed 5000 API Guide Page 33
GetPlayLists
This command is used to get a list of the Play Lists IDs and minimal informatio n about each Play List. <AMS><DatabaseControl> <GetPlayLists ResetList=”true” NumPlayLists=”50” MinList=”false” /> </DatabaseControl></AMS>
Attribute Parameters
ResetList
This is an optional BOOL attrib ute indic a ting whether the list of play lists is to be r e set to the beginning. The default is true. Set this to false to retrieve subseq uent Play Lists.
NumPlayLists
This is the optional INT attribute indica ting the number of Play Lists to retrieve at one time. The allowable range is 1-50, and the default is 50.
MinList
This is the optional BOOL attrib ute indic a ting the GetPlayList will only retur n the Play List Name. This makes for faster clip name retrieval. The default is “false”.
Return Tag Elements and Attributes
<NumPlayLists />
The number of Play Lists retrieved. When this number is less than the passed “NumPlayLists” value, there are no more Play Lists.
<PlayList Name=”PlayListName” NumClips”N” > <Clip ID=”ClipID” Index=”N” In=”TC” iIn=”N” Out=”TC” iIn=”N” /> </PlayList>
“PlayList” contains the name of the Play List and a list of the “Clip” Tags. There is one “PlayList” Tag returned for each PlayList retrieved The STRING attribute “Name” is the name of the Play List The INT attribute “NumClips” is the number of clips in the Play List (Only retur ned if MinList is false). There is at least one “Clip” Tag returned for each PlayList retrieved (Only if MinList is false)
The STRING attribute “ID” is the Clip Name
The INT attribute “Index” is the index of the clip in the Play List (0 – (numClips-1)).
The STRING attribute “In” is the mark in TC.
The INT attribute “iIn” is the mark in frame count.
The STRING attribute “Out” is the mark out TC.
The INT attribute “iOut” is the mark out frame count.
AirSpeed 5000 API Guide Page 34
GetPlayListInfo
This command is used to get the Information about a Play List . <AMS><DatabaseControl> <GetPlayListInfo Name=”Name” Index=”N” /> </DatabaseControl></AMS>
Attribute Parameters
Name
This is a required STRING attribute indicating name of the P lay List.
Index
This is the optional INT attribute indica ting the index of the item of interest. If this is -1 then all items in the Play List are returned. The default is -1.
Return Tag Elements and Attributes
<PlayListInfo Name=”PlayListName” DiaplayName=”name” Loop=”false” NumClips”N” > <Clip ID=”ClipID” Index=”N” In=”TC” iIn=”N” Out=”TC” iIn=”N”
VideoStandard=”Standard” Status=”OK” />
</PlayListInfo>
“PlayListI nfo” contai ns the name of t he Play List, Number of clips returned, and a list of the “Clip” Tags. The STRING attribute “Name” is the name of the Play List The STRING attribute “DisplayName” is the display name of the Play List The BOOL attribute “Loop” is true if t he Play List is set for Looping The INT attribute “NumClips” is the number of clips returned A “Clip” Tag is returned for each clip retrieved
The STRING attribute “ID” is the Clip Name
The INT at tribute “Index” is the index of the clip in the Play List (0 – (numClips-1)).
The STRING attribute “In” is the mark in TC.
The INT attribute “iIn” is the mark in frame count.
The STRING attribute “Out” is the mark out TC.
The INT attribute “iOut” is the mark out frame count.
The STRING attribute “VideoStandard” is the Video Standard of the clip.
The STRING attribute “Status” is the Status of the Clip
AirSpeed 5000 API Guide Page 35
SetPlayListAttributes
This command is used to set the attrib utes of a Play List . <AMS><DatabaseControl> <SetPlayListAttributes Name=”Name” DisplayName=”DisplayName” Author=”Author” Loop=”false” /> </DatabaseControl></AMS>
Attribute Parameters
Name
This is a required STRING attribute indicating name of the Play List.
DisplayName
This is an optional STRING attribute indicating display name of the Play List (default is none).
Author
This is an optional STRING attribute indicating the Author the Play List (default is none).
Loop
This is an optional BOOL attrib ute indic a ting if the Play List is to be looping. The default is false.
Return Tag Elements and Attributes
AirSpeed 5000 API Guide Page 36
CreatePlayList
This command is used to create a new Play List. <AMS><DatabaseControl> <CreatePlayList Name=”Name” DisplayName=”name” Author=”Author” Loop=”false” NumClips=”N” OverWrite=”false”
TcRef=”REF” > <Clip ID=”ClipID” Index=”N” In=”TC” iIn=”N” Out=”TC” iIn=”N” PlayoutControl=”Follow” /> </CreatePlayList </DatabaseControl></AMS>
Attribute Parameters
Name
This is a required STRING attribute indicating name of the Play List.
DisplayName
This is an optional STRING attribute indicating display name of the Play List (default is none).
Author
This is an optional STRING attribute indicating the Author the Play List (default is none).
Loop
This is an optional BOOL attrib ute indic a ting if the Play List is to be looping. The default is false.
NumClips
This is an optional INT attribute indicating the number of c lips in the Play List. If this value is 0 the n an empty Play List is created. The Default is 0.
OverWrite
This is an optional BOOL attrib ute indic a ting if the Play List already exists it may be de le te d first. The default is false.
TcRef
This is an optional STRING attribute indicating if the time code calculations are to be referenced on the Output channel’s video standard, or the clips video standard. The default is OUTPUT REF = OUTPUT – Use the channel’s output video standard (Default) REF = CLIP – Use the active clip’s video standard.
Clip
There should be “NumClips” number of Clip Tags (one for each clip in the Play List).
The required STRING attribute “ID” is the Clip Name
The required INT attribute “Index” is the index of the clip in the Play List.
The optional STRING attribute “PlayoutControl” is the start control for the Clip
The options are: “Follow”, “Manua l” ( D e fault is Follow)
The optional STRING attribute “In” is the mark in TC. (Default is database value)
The optional INT attribute “iIn” is the mark in frame count. (Default is database value)
The optional STRING attribute “Out” is the mark out TC. (Default is database value)
The optional INT attribute “iOut” is the mark out frame count. (Default is database value)
AirSpeed 5000 API Guide Page 37
Return Tag Elements and Attributes
<PlayListInfo Name=”PlayListName” NumClips”N” > <Clip ID=”ClipID” Index=”N” In=”TC” iIn=”N” Out=”TC” iIn=”N” /> </PlayListInfo>
“PlayListInfo” contains the name of the Play List, Number of clips returned, and a list o f the “Clip” Tags. The STRING attribute “Name” is the name of the Play List The INT attribute “NumClips” is the nu mbe r of clips returned A “Clip” Tag is returned for each clip retrieved
The STRING attribute “ID” is the Clip Name
The INT attribute “Index” is the index of the clip i n the Play List (0 – (numClips-1)).
The STRING attribute “In” is the mark in TC.
The INT attribute “iIn” is the mark in frame count.
The STRING attribute “Out” is the mark out TC.
The INT attribute “iOut” is the mark out frame count.
AirSpeed 5000 API Guide Page 38
DeletePlayList
This command deletes a Play List. <AMS><DatabaseControl> <DeletePlayList Name=”Name” Force=”false” /> </DatabaseControl></AMS>
Attribute Parameters
Name
This is the required STRING attribute name of the Play List to be deleted.
Force
This is the optional BOOL attrib ute if set to true will elect the clip if it is active on the channel.
Return Tag Elements and Attributes
Not applicable.
AirSpeed 5000 API Guide Page 39
RenamePlayList
This command renames a Play List. <AMS><DatabaseControl> <RenamePlayList Name=”Name” NewName=”Name” NewDisplayName=”Name” /> </DatabaseControl></AMS>
Attribute Parameters
Name
This is the required STRING attribute name of the Play List to be renamed.
NewName
This is the required STRING attribute is the New Play List name.
NewDisplayName
This is the optional STRING attribute is the new display name (default is to u se c urrent display name)
Force
This is the optional BOOL attrib ute if set to true will elect the clip if it is active on the channel.
Return Tag Elements and Attributes
Not applicable.
AirSpeed 5000 API Guide Page 40
AddClipToPlayList
This command is used to add a clip(s) to a Play List. <AMS><DatabaseControl> <AddClipToPlayList Name=”Name” NumClips=”1” Replace=”false” TcRef=”REF” > <Clip ID=”ClipID” Index=”N” In=”TC” iIn=”N” Out=”TC” iIn=”N” PlayoutControl=”Follow” /> </AddClipToPlayList> </DatabaseControl></AMS>
Attribute Parameters
Name
This is a required STRING attribute indicating name of the Play List.
PlayoutControl
This is an optional STRING attr ibute “PlayoutControl” defining the start control for this Clip. The options are: “Follow”, “Manual” (Default i s Fo llow)
Replace
This is an optional BOOL attrib ute indic a ting if the added clip is to replace the existing clip at the “index” location. The Default is false.
NumClips
This is an optional INT attribute indica ting the number of clips to be added “index” location. The Default is 1.
TcRef
This is an optional STRING attribute indicating if the time code calculations are to be referenced on the Output channel’s video standard, or the clips video standard. The default is OUTPUT REF = OUTPUT – Use the channel’s output video standard (Default) REF = CLIP – Use the active clip’s video standard.
Clip
There should be “NumClips” number of Clip Tags (one for each clip to add).
The required STRING attribute “ID” is the Clip Name
The required INT attribute “Index” is the index location to add the Play List.
The optional STRING attribute “In” is the mark in TC. (Default is database value)
The optional INT attribute “iIn” is the mark in frame count. (Default is database value)
The optional STRING attribute “Out” is the mark out TC. (Default is database value)
The optional INT attribute “iOut” is the mark out frame count. (Default is database value)
Return Tag Elements and Attributes
AirSpeed 5000 API Guide Page 41
RemoveClipFromPlayList
This command is used to remove a c lip(s) from a Play List. <AMS><DatabaseControl> <RemoveClipFromPlayList Name=”Name” Index=”N” NumClips=”1” / > </DatabaseControl></AMS>
Attribute Parameters
Name
This is a required STRING attribute indicating name of the Play List.
Index
This is a required INT attribute indicating Index in the PlayList of the clip to remove.
NumClips
This is an optional INT attribute indica ting the number of clips to be removed starting at “Index” location. The Default is
1. If NumClips is greater than 1 then “NumClips” clips will b e r e moved from the PlayList starting at “Index”. Note if NumClips=-1 then all the clips following “I nde x” are removed
AirSpeed 5000 API Guide Page 42
Transfer (to Interplay)
This command transfers a clip to Interplay. <AMS><DatabaseControl> <Transfer ID=”ClipID” /> </DatabaseControl></AMS>
Attribute Parameters
ID
This is an STRING attribute ID of the clip to be transferred.
Return Tag Elements and Attributes
Not applicable.
AirSpeed 5000 API Guide Page 43
Create Proxy
This command creates a proxy for an existing clip. <AMS><DatabaseControl> <CreateProxy ID=”ClipID” /> </DatabaseControl></AMS>
Attribute Parameters
ID
This is an STRING attribute ID of the clip that you want to create a proxy from.
Return Tag Elements and Attributes
Not applicable.
AirSpeed 5000 API Guide Page 44
GetProxyStatus
This command gets the proxy status for a clip. <AMS><DatabaseControl> <GetProxyStatus ID=”ClipID” /> </DatabaseControl></AMS>
Attribute Parameters
ID
This is a STRING attribute ID o f the clip of interest.
Return Tags
<ProxyStatus>Status</ProxyStatus>
The STRING attribute STATUS is t he current proxy status of the clip.
<PercentComplete>Status</PercentComplete>
The STRING attribute is formatted as “N%” and is only returned if the status is “Transcoding”.
AirSpeed 5000 API Guide Page 45
GetTransferStatus
This command gets the transfer status for a c lip. <AMS><DatabaseControl> <GetTransferStatus ID=”ClipID” /> </DatabaseControl></AMS>
Attribute Parameters
ID
This is a STRING attribute ID o f the clip o f interest.
Return Tags
<TransferStatus>Status</TransferStatus>
The STRING attribute STATUS is t he current disk transfer status of the clip.
<TransferInfo … /> This only is returned if the Transfer Information Exists
The STRING attribute “Transactio nID ” is this transaction ID The STRING attribute “TransferType” is the transfer type (Ingest or Playback) The STRING attribute “State” State = (Running, Completed, Error, Paused, Pending, Cancelled) The INT attribute “PercentDone” is the percent complete for this transaction The STRING attribute “ErrorMessage” Error string if State=Error The STRING attribute “Updated ” is the HH:M M :SS since this transaction last upd a te d
AirSpeed 5000 API Guide Page 46
GetTransferList
This command gets information about recent transfers. <AMS><DatabaseControl> <GetTransferList/> </DatabaseControl></AMS>
Attribute Parameters
Not applicable.
Return Tags
<TransferList>
<Clip
VideoID=”ID”
TransactionID=”ID”
TransferType=”type”
State=”State”
PercentDone=”0”
ErrorMessage=”Message”
Updated=”HH:MM”SS”
/>
</TransferList>
The STRING attribute “VideoID” is the clip name for this tr a nsaction. The STRING attribute “Transactio nID ” is this transaction ID. The STRING attribute “TransferType” is the transfer type (Ingest or Playback). The STRING attribute “State” State = (Runn ing, Completed, Error, Paused, Pending, Cancelled). The INT attribute “PercentDone” is the percent complete for this transaction. The STRING attribute “ErrorMessage” Error string if State=Error. The STRING attribute “Updated” is the HH:MM:SS since this transaction last updated.
Note: The transfer list only ret a ins transfer information for those transfers updated within 10 hours of the GetTransferList request. Also, the transfer list only retains up to 1000 transfers.
AirSpeed 5000 API Guide Page 47
DeleteClip
This command deletes a clip. <AMS><DatabaseControl> <DeleteClip ID=”ClipID” /> </DatabaseControl></AMS>
Attribute Parameters
ID
This is an STRING attribute ID of the clip to be deleted.
Return Tag Elements and Attributes
Not applicable.
AirSpeed 5000 API Guide Page 48
GetClipData
This command retrieves clip data. This command also clears out the change list data. <AMS><DatabaseControl> <GetClipData ID=”ClipID” GetPaths=”false” GMT=”true” /> </DatabaseControl></AMS>
Attribute ParametersID
This is a STRING attribute ID of the clip of interest.
Return Tag Elements and Attributes
GMT
This is the optional BOOL attribute. Set to “true” for Greenwich Mean Time, Set to “false” for “Local Time”. The default is “true”.
GetPaths
This is the optional BOOL attrib ute. Se t to “true” to retrieve the UNC paths to t he media. The default is “ false”.
<ClipData ID=”ClipID” … />
The STRING attribute “ID” is the required clip Video Id (media Id). The STRING attribute “Name” is clip name. The STRING attribute “Category” is clip category. The STRING attribute “User” is clip user. The STRING attribute “Memo” is clip memo. The STRING attribute “Master” is the sub clip’s master clip ID (only ret urned for sub clips). The BOOL attribute “Protect” is true if clip is protected. The BOOL attribute “Aspect16X9” is true if clip is 1 6:9 aspect ratio. The INT attribute “LoopCount” is current looping count (-1 indicates lo oping is unavailable on this clip) The Options are: 0 indicates do not loop, 1 to 999 indicates to loop count, 1000 indicates loop forever The INT attribute “TcSrc” is the time code source type. The Options are: 0=ATC/VITC, 1=BaseTC, 2=LTC, 3=TOD The STRING attribute “LoopIn” is the Loop In TC where each loop will start after the completion of the initial loop. The STRING attribute “Codec” is the name of the recording codec. The FLOAT attribute “BitRate” is the bit rate that the clip was recorded at The STRING attribute “AudioStream<N>” is the type of audio for stream (N=1-8), no tag if stream doesn’t exist The STRING attribute “ProxyAudioStream<N>” is the proxy audio for stream (N=1-8), no tag if stream doesn’t exist The STRING attribute “In” is the mark in TC. The STRING attribute “Out” is the mark out TC. The STRING attribute “Base” is the base TC. The STRING attribute “VideoStandard” is the Video Standard of the clip. The STRING attribute “Len” is the clip length TC. The STRING attribute “”RecordLen” is the TC total recorded length of the clip. The STRING attribute “CreationDate” is the date the clip was crea te d (YY/MM/DD HH:MM:SS). The STRING attribute “ModificationDate” is the date the clip was last modified ( Y Y/MM/DD HH:MM:SS). The STRING attribute “MobID” is the MobID of the clip. The STRING attribute “SourceID” is the SourceID (IE tape ID). The INT attribute “HF” is the Head Frame TC location (-1 if no head frame exists)
AirSpeed 5000 API Guide Page 49
The STRING attribute “TransferStatus” is the current transfer status of the clip.
Return strings:
ID xxx Does not exist Transfer Done Transfer Error Transfer Paused Transferr ing Out Transferr i ng In Transfer Request Ready To Transfer Recording
The STRING attribute “IngestStatu s” identifies the clip ingest method (“Recording” or “Copying”), and status (“Done”). The STRING attribute “CopyStatus” identifies the clip copy status. T his will only exist if there is a cop y status. The STRING attribute “Origin” identifies the origin of the clip (“Local” i f rec orded locally or “Remote“ if the clip was not recorded locally). The STRING attribute “Prox yStatus” is the current proxy status of the clip.
Return strings:
No Proxy Completed Failed Transcoding Requesting
<TransferInfo … /> This is only returned if the Transfer Information Exists
The STRING attribute “Transactio nID ” is the transaction ID. The STRING attribute “TransferType” is the transfer type (Ingest or Playback). The STRING attribute “State” State = (Running, Completed, Error Paused, Pending, Cancelled) The INT attribute “PercentDone” is the percent complete for this transaction. The STRING attribute “ErrorMessage” Error string if State=Error. The STRING attribute “Updated ” is the HH:M M :SS since this transaction last upd a te d.
<Paths Clip=”path” … /> This is only returned if “GetPaths” is true
The STRING attribute “Clip” is the UNC path to the media file. The STRING attribute “RawHeadFrame” is the UNC path to the raw head frame JPG file. (only returned if file exists). The STRING attribute “Prox y<1,2,..N>” is the UNC path to the Proxy files. (Only Retur ned if file exists)
AirSpeed 5000 API Guide Page 50
SetClipData
This command retrieves clip data. <AMS><DatabaseControl> <SetClipData ID=”ClipID” … /> </DatabaseControl></AMS>
Attribute Parameters
ID
The STRING attribute “ID” is the required clip Video Id (media Id). The STRING attribute “Rename” is the new Video Id (media Id) name The STRING attribute “Name” is clip name. The STRING attribute “Category” is clip category. The STRING attribute “User” is clip user. The STRING attribute “Memo” is clip memo. The BOOL attribute “Protect” is true if clip is to be protected. The BOOL attribute “Aspect16X9” is true if clip is 16:9 aspect ratio. The STRING attribute “In” is the mark in TC. The STRING attribute “Out” is the mark out TC. The STRING attribute “Base” is the base TC. The STRING attribute “Len” is the clip length TC. The INT attribute “LoopCount” is current looping count The Options are: 0 indicates do not loop, 1 to 999 indicates to loop count, 1000 indicates loop forever The STRING attribute “LoopIn” is the Loo p In TC where each loop will start after the completion of the initial loop. The STRING attribute “MobID” is the MobID of the clip. The STRING attribute “SourceID” is the SourceID (IE tape ID).
Return Tag Elements and Attributes
Not applicable.
Remarks
This command only changes the clip data fields for the passe d attributes. All other clip data fields will re main the same.
AirSpeed 5000 API Guide Page 51
GetChangeList
This command is used to get a list of the database changes in the order that they occurred. Note that the command GetClipData will clear out the changed list.
<AMS><DatabaseControl> <GetChangeList NumChanges=”50” /> </DatabaseControl></AMS>
Attribute Parameters
NumChanges
This is the optional INT attribute indicating the number of database changes to retrieve at one time. The allowable range is 1-50. The default is 50.
Return Tag Elements and Attributes
<NumChanges />
The number of changes retrieved. When this number i s less than the passed “NumChanges” value, the end of the database change list has been reached.
<ChangeList <Change TYPE=”ChangeType” ID=”ID” NewID=”NewID”/> </ChangeList>
“ChangeList” co ntains a list of “database change” Tags. There is one Change Tag returned for each database change, they must me processed in order of return. The STRING attribute “TYP E” is the t ype of change notification.
ADD = Added clip
DELETE = Deleted clip
MODIFY = Modified clip.
RENAME = Rename clip.
PL_ADD = Added Play List
PL_DELETE = Deleted Play List
PL_MODIFY = Modified Play List.
PL_RENAME = Rename Play List.
The STRING attribute “ID” is the ID of the item cha nged. The STRING attribute “NewID” is new ID and is onl y returned if the TYPE=RENAME
Note: Renamed items could also have been modified and should be treated as such
AirSpeed 5000 API Guide Page 52
GetGenericTemplate
This command is used to get the generic template data used for recording of clips. <AMS><DatabaseControl> <GetGenericTemplate TemplateType=”type” RequestType=”type” ID=”id” /> </DatabaseControl></AMS>
Attribute Parameters
TemplateType
This is the type of template requested. Valid types are “Record”, “Destination”, and “User”.
RequestType
This is the request type. Valid request types are “VideoID”, “TemplateID”, “TemplateName”.
ID
This is the ID/Name of the requested template, depending on the request type.
Return Tag Elements and Attributes
<Template><![CDATA[data]]></Template>
The actual template data returned in a CDATA Section.
AirSpeed 5000 API Guide Page 53
GetGenericTemplateIds
This command is used to get a list of the entire template IDs by “type”. <AMS><DatabaseControl> <GetGenericTemplateIds TemplateType=”type” ByID=”true” ByName=”false” PresetsOnly="false" /> </DatabaseControl></AMS>
Attribute Parameters
TemplateType
This is the type of template requested. Valid types are “Record”, “Destination”, and “User”.
ByID
If this is “true” then the template IDs are returned (the default is true).
ByName
If this is “true” then the template Names are returned (the default is false).
PresetsOnly
If this is “true” then onl y built-in templates are returned (the default is false).
Return Tag Elements and Attributes
<TemplateData>
<Template ID=”data” Name=”data” /> <Template ID=”data” Name=”data” />
</TemplateData>
List of the template IDs/Names..
AirSpeed 5000 API Guide Page 54
GetGenericDefaultTemplateId
This command is used to ge t the default template ID and templa te name for a channel or Video Standard <AMS><DatabaseControl> <GetGenericTemplateId TemplateType=”type” Channel=”num” VideoStandard=”VideoStandard” /> </DatabaseControl></AMS>
Attribute Parameters
TemplateType
This is the type of template requested. Valid types are “Record”, “Destination”, and “User”.
Channel
This is the selected channel for the default ID.
VideoStandard
The STRING attrib ute “VideoStandard” is the Video Standard o f the de faul t template. Valid Video Standard names include the following:
SD_NTSC_4x3_29_970 SD_PAL_4x3_25_000
HD_1920x1080i_29_970 HD_1920x1080i_25_000
HD_1280x720p_59_940 HD_1280x720p_50_000
Return Tag Elements and Attributes
<Default ID=”data” Name=”data” />
The default template ID and Name for the passed channel
AirSpeed 5000 API Guide Page 55
Loading...