designing av automation for the mediasite rich media recorder
TRANSCRIPT
-
8/6/2019 Designing AV Automation for the Mediasite Rich Media Recorder
1/26
Designing AV
automation for theMediasite Recorder
Technical planner: TP-02
-
8/6/2019 Designing AV Automation for the Mediasite Rich Media Recorder
2/26
2010 Sonic Foundry, Inc. All rights reserved. No part of this document may be copied and/or
redistributed without the consent of Sonic Foundry, Inc. Additional copies may be obtained by contactingSonic Foundry. Sonic Foundry, the Sonic Foundry logo, Mediasite, and the Mediasite logo are registeredtrademarks of Sonic Foundry, Inc. All other trademarks are the property of their respective owners.
Sonic Foundry, Inc.222 W. Washington AvenueMadison WI 53703877-783-7987 toll free from the US and Canada608-443-1600
Sonic Foundry. Since 1991.
For more information, please contact [email protected]
Revision: 5.3, January 2010
-
8/6/2019 Designing AV Automation for the Mediasite Rich Media Recorder
3/26
Technical Planner: TP-02 Designing AV Automation for the Mediasite Recorder
Table of contents
Introduction ................................................................................................................................................... 4Overview ....................................................................................................................................................... 4MCIP Recorder operations set .................................................................................................................... 4
Recorder controls ................................................................................................................................... 4Recorder feedback ................................................................................................................................. 5Recording new presentations .............................................................................................................. 5Recording and/or broadcasting (live) scheduled presentations .................................................... 5
Scenarios for Recorder AV system integration ......................................................................................... 6Scenario #1 Using the Crestron Sample Control Module with the sample user interface or analternative user interface ...................................................................................................................... 6
Highlights ........................................................................................................................................ 6Software layers and hardware ...................................................................................................... 7Crestron Sample Control Module with the sample user interface .......................................... 7Crestron Sample Control Module with an alternative Crestron user interface ..................... 7
Scenario #2 Using control module for any AV control system with a user interface .................. 8Highlights ........................................................................................................................................ 8
Software layers and hardware ...................................................................................................... 8
Crestron Control Module and sample user interface .............................................................................. 9Controls................................................................................................................................................... 9Options.................................................................................................................................................. 10Recorder feedback ............................................................................................................................... 12Additional features ............................................................................................................................. 12
Appendix 1: MCIP protocol specification ............................................................................................... 13General notes ....................................................................................................................................... 13Hardware configuration ..................................................................................................................... 13Serial port pinout ................................................................................................................................. 13Basic protocol ....................................................................................................................................... 13
Protocol format ............................................................................................................................. 13Protocol fields ............................................................................................................................... 14Control messages.......................................................................................................................... 14Feedback messages ...................................................................................................................... 15Protocol examples ........................................................................................................................ 19Verbose status mode .................................................................................................................... 22Verbose status mode notification examples: ............................................................................ 23
Appendix 2: Recording presentations using the touch panel .............................................................. 24
-
8/6/2019 Designing AV Automation for the Mediasite Rich Media Recorder
4/26
Technical Planner: TP-02 Designing AV Automation for the Mediasite Recorder
Introduction
This document explains how to integrate theMediasite Rich Media Recorder(RL Series) into anAudio/Visual (AV) controlled environment usingMediasite Control Interface Protocol (MCIP). Theintended audience for this document includes AV integrators and Sonic Foundry partners whoare integrating the Recorder into an AV controlled environment.
OverviewMCIP is a specification published by Sonic Foundry for developing modules that allow the RLSeries Recorder to be easily integrated into an AV controlled environment.
To use the Recorder in an AV controlled environment:
1. The Mediasite Communications Service on the Recorder must be started.2. A module for the Recorder must be developed and deployed. This module, which resides on
the AV controller, recognizes the Recorder and sets up communication with the Recorderover a serial interface.
3. A user interface to control the Recorder must be designed and deployed.4. Any additional control logic program that may be needed to link the user interface and the
module on the AV controller must be designed and deployed.5. The RL Series Recorder must be connected to an AV control system using a serial cable. The
RL Series Recorder communicates with the AV control system using serial communicationsover RS-232 protocol. Most AV control systems support a 9-pin female, D-sub connector anduse a null modem serial cable.
The level of development that needs to be done depends on which one of the following scenariosfor Recorder AV system integration is used. The scenarios are listed in increasing order ofdifficulty:
1. System integration using Sonic Foundrys Crestron certified control module for the MP2EMedia Processor with the sample user interface (for the TPS-5000 Touch Panel) or analternative user interface.
2. System integration using a control module for any AV control system (e.g. Crestron or AMX)with a user interface.
MCIP Recorder operations setMCIP allows the integration of the Recorder into any AV controlled system by providing a set ofoperations that enables the user to communicate to the Recorder over a RS-232 (serial)connection. MCIP supports the following Recorder operations:
Recorder controls
The following Recorder controls are available:
-
8/6/2019 Designing AV Automation for the Mediasite Rich Media Recorder
5/26
Technical Planner: TP-02 Designing AV Automation for the Mediasite Recorder
Enable/disable verbose status toggle: Enable or disable verbose status notifications. Whenenabled, the Recorder will send messages, asynchronously, to the control system as they
occur. When disabled, the control system must continuously poll the Recorder for its status.This feature is enabled by default.
Publish recorded presentation to CD: Publish the last presentation recorded with theRecorder to a CD.
Set audio record level: Set the audio record level. Select image preset: Select image preset settings from a list of profiles. Encode Video In: Send the Video input to Video Out Encode Image In: Send the Image input to Video Out Encode Image In with PiP: Send the Image input with video overlayed to Video Out Enable/disable Favor widescreen image capture toggle: Enable or disable favoring of
widescreen image capture.
Recorder feedback
The following feedback can be retrieved from the Recorder:
Slide count: The current image number for the presentation being recorded. Record time: The amount of time that has elapsed since user began recording presentation. Status: The current status of the Recorder Idle, Record, Busy, Publish. Message: The status of presentation being recorded Presentation Available, Presentation
Not Available.
Error (communication and control): Communication and control error messages from theRecorder.
Recorder model and version: The model and version of the Recorder. Current audio input level: The current audio input level into the recorder. Low audio warning indicator: A warning that audio input levels are too low. Audio record level: The audio level the recorder is set to record at. Recorder disk space: The amount of empty space left on the hard disk. Preset image settings: A list of preset image settings.
Recording new presentations
When preparing to record a new presentation, the following task can be done:
Select an encoding profile: Select an encoding profile from a list of encoding profiles on theRecorder.
Select a presentation template: Select a presentation template from a list of presentationtemplates on the Mediasite Server.
-
8/6/2019 Designing AV Automation for the Mediasite Rich Media Recorder
6/26
Technical Planner: TP-02 Designing AV Automation for the Mediasite Recorder
Todays Presentations Only: Open and select a scheduled presentation from a list ofpresentations scheduled for today only for recording and/or live broadcasting.
Presentation details: Display date and time in addition to id and title when opening ascheduled presentation.To record or publish a scheduled presentation, the Mediasite Server must be available. Formore information about the MCIP specification, please refer to Appendix 1: MCIP protocolspecification on page 13.
Scenarios for Recorder AV system integration
The two scenarios for Recorder AV system integration using MCIP are listed in increasing orderof difficulty:
1. Integration using Sonic Foundrys Crestron certified control module for the MP2E MediaProcessor with the sample user interface or an alternative user interface.
2. Integration using a control module for any AV control system with a user interface.Refer to the Crestron website (http://www.crestron.com) or the AMX website (http://www.amx.com) to see the many alternative control systems and user interfaces available.
Scenario #1Using the Crestron Sample Control Module with the sample user interface or analternative user interface
The Recorder can be integrated into an AV controlled system using Sonic Foundrys Crestroncertified control module. The module can then be used with the sample user interface describedlater in this document or an alternative user interface. This scenario allows the Recorder to beintegrated with the least amount of effort.
Highlights
The highlights of this scenario are:
The programs are developed by Sonic Foundry and used to verify an implementation of theMCIP on the controller and the touch panel. Sonic Foundry provides no warranty for theseprograms.
The control module for the Crestron MP2E is certified by Crestron. The control module canalso be used on other 2-Series control systems from Crestron. However, this has not beentested.**
The sample user interface provided for the TPS-5000 Touch Panel has been certified byCrestron. The sample user interface implements all of the functions specified in MCIP. Theuser interface can be easily customized to change the look and feel or to accommodate asubset of the MCIP functionality using alternative Crestron touch panels and remote controls.
-
8/6/2019 Designing AV Automation for the Mediasite Rich Media Recorder
7/26
Technical Planner: TP-02 Designing AV Automation for the Mediasite Recorder
Software layers and hardware
Software layers for the control system and the hardware for in Scenario #1 are shown in Figure 1.
Figure 1: Software layers and hardware for Scenario #1
Crestron Sample Control Module with the sample user interface
If Sonic Foundrys Crestron certified control module for the MP2E Media Processor and thesample user interface for the Crestron TPS-5000 Touch Panel are both used, the development
needed to implement MCIP is already done.In this instance, the Mediasite Communications Service on the Recorder just needs to be started.
To integrate the Recorder using Sonic Foundrys sample Crestron control module and userinterface, the following hardware is needed:
Crestron TPS-5000 12 Inch Tilt Touch Panel Crestron MP2E Media Processor Crestron TPS-VID-1/TPS-VID-2 Video Card for TPS/Tilt Panel Crestron TPS-IMC Interface Module Crestron TPS-XVGA RGB Computer Interface Card for TPS/Tilt PanelCrestron Sample Control Module with an alternative Crestron user interface
Crestron provides many different user interfaces and remote controls that can be used with the
User Interface
SIMPL+ MediasiteRecorder Control
module
Crestron TPS 5000
Crestron MP2E processor runningSIMPL Windows
Mediasite SerialCommunicationService using
MCIP
Mediasite RL Series Recorder
Software Layers Hardware
ControlLogic
-
8/6/2019 Designing AV Automation for the Mediasite Rich Media Recorder
8/26
Technical Planner: TP-02 Designing AV Automation for the Mediasite Recorder
2. Any additional control logic program that may be needed to link the user interface and themodule on the AV controller must be designed and deployed.
Additionally, the hardware requirements will have to be adjusted as necessary for the alternativeuser interface.
Scenario #2Using control module for any AV control system with a user interface
The Recorder can be integrated into an AV controlled system using a control module for any AVcontrol system including Crestron or AMX control systems.
Highlights
The highlights of this scenario are:
The AV vendor or system integrator writes a control module based on the MCIPspecification.
A user interface is developed for a touch panel that works with the control system. In this scenario, certification of the control module is managed by the following persons:
o The AV control system vendor who develops the control module.o The AV integrator who develops the control module and works with the AV control
system vendor.
The AV vendor or system integrator decides how the user interface can be customized andfor which touch panels and remote controls it can be customized and supported.
The control logic, if any, that connects the user interface with the control system is providedby the AV vendor or system integrator.
Software layers and hardwareThe software layers for the control system and the hardware needed in Scenario #2 are shownbelow in Figure 2.
-
8/6/2019 Designing AV Automation for the Mediasite Rich Media Recorder
9/26
Technical Planner: TP-02 Designing AV Automation for the Mediasite Recorder
Figure 2: Software layers and hardware for Scenario #2
In this scenario, to integrate the Recorder into an AV controlled system:
1. The Mediasite Communications Service on the Recorder must be started.2. The module residing on the AV controller must be developed and deployed for the Recorder.3. A user interface to control the Recorder must be designed and deployed.4. Any additional control logic program that may be needed to link the user interface and the
module on the AV controller must be designed and deployed.
Crestron Control Module and sample user interfaceThe Recorder can be integrated into an AV controlled system with little effort when SonicFoundrys Crestron certified control module and sample user interface are used. This sampleimplementation demonstrates every function available in MCIP. Sonic Foundrys sampleCrestron control module and user interface package includes the following items:
VT Pro-e touch-panel source project and compiled .vtz file SIMPL control program source project and compiled .spz file Visio digital logic diagram of SIMPL project SIMPL+ serial communications module program sources and compiled .spz file Documentation for the SIMPL+ module
User Interface
MediasiteRecorder Control
module
Touch Panel or Remote
AV Control System
Mediasite SerialCommunication
Serviceimplementing
MCIP
Mediasite RL Series Recorder
Software Layers Hardware
ControlLogic
,
ifany
-
8/6/2019 Designing AV Automation for the Mediasite Rich Media Recorder
10/26
Technical Planner: TP-02 Designing AV Automation for the Mediasite Recorder
Resume: User will press this button to resume recording a presentation. Stop: User will press this button to stop recording a presentation. Image Advance Now: User will press this button to advance to the next image shown in the
image input window.
Image Advance Auto: User will press this button to turn auto-image advance on or off.When this feature is turned on, the Recorder automatically updates the images when animage change is detected.
Video: User will press this button to display the video input as the video output. Image: User will press this button to display the image input as the video output. PiP
: User will press this button to display the image input as the video output with the videoinput as a small picture-in-picture (PiP).
Publish to CD: User will press this button to publish the presentation recorded last to a CD. Get status: User will press this button to get the status of the Recorder. Audio Record Level Up: User will press this button to increase the audio record level. Audio Record Level Down: User will press this button to decrease the audio record level. Options: User will press this button to view the additional Recorder options.
Figure 3: Crestron sample user interface controls
Options
The following options, shown in Figure 4, are displayed when the Options button is selected onthe touch panel:
-
8/6/2019 Designing AV Automation for the Mediasite Rich Media Recorder
11/26
Technical Planner: TP-02 Designing AV Automation for the Mediasite Recorder
Todays Presentations Only: User will press this button to limit the list of presentations tothe current date.
Favor Widescreen: User will press this button to favor widescreen image capture.
Figure 4: Crestron sample user interface options (displayed when Options button selected)
The following options, shown in Figure 5, are displayed when the More button is selected on thetouch panel:
Verbose Status: User will press this button to turn verbose mode on or off. When verbosemode is on, the Recorder reports status changes as they occur, approximately every 5
seconds. Communication Reply Timeout: User will press the arrows to increase or decrease the
control systems communication reply timeout value as needed. The default value is 7seconds.
Audio Level Check Time: User will press the arrows to increase or decrease the controlsystems audio level check time value as needed. The default value is 5 seconds.
Image Preset Setting: Users will press the arrows to scroll through the image preset settingsavailable and will select one to use for the presentation. The Refresh button can be used to
update the list of image presets.
-
8/6/2019 Designing AV Automation for the Mediasite Rich Media Recorder
12/26
Technical Planner: TP-02 Designing AV Automation for the Mediasite Recorder
Figure 5: Crestron sample user interface options (displayed when More button selected)
Recorder feedbackThe following Recorder feedback is provided:
General Recorder status: The current status of the Recorder Idle, Busy, Recording, PausedPublish.
Publishing status: The status of presentation being recorded Presentation Not Availablefor Publishing, Presentation Available for Publishing.
Presentation Timer: The amount of time that has elapsed since user began recordingpresentation.
Mediasite Recorder version information: The model and version of the Recorder. Current audio input level: The current audio input level into the recorder. Audio record level: The audio level the recorder is set to record at. Low audio input warning: A flashing red animation around the current audio input level
indicating that the audio level is too low.
Recorder disk space: The amount of empty space left on the hard disk. (This is located onthe More Options page.)
Additional features
Sonic Foundrys Crestron sample control module and user interface also supports the followingadditional features:
Switching between four video inputs for previewing and selecting an input to send to the
-
8/6/2019 Designing AV Automation for the Mediasite Rich Media Recorder
13/26
Technical Planner: TP-02 Designing AV Automation for the Mediasite Recorder
Appendix 1: MCIP protocol specification
MCIP controls standard Recorder functions and provides true feedback from the Recorder usingRS-232 serial communications.
General notes
The control system should wait for a reply after sending each command. If a reply is not receivedwithin the default reply time-out interval of five seconds, after sending a command, thecommunication has timed out. The control system should allow the reply time-out to bemodified, in case of communication failures.
If a command (e.g. RECORD) causes the Recorder to perform some task that may take some time,then it will reply with STATUS RECBUSY until the task is completed. The control system caneither poll for this, or if using Verbose Status Mode, the Recorder will notify the control systemwhen waiting is over (e.g. for the RECORD case, this would be when the Recorder transitionsfrom RECBUSY to RECORD).
Commands are generally replied to instantly, and the wait mode will usually only occur whenprocessing control commands.
Hardware configurationBaud Rate: 9600Parity: NoneData Bits: 8Stop Bits: 1
Serial port pinout
The Recorder uses a standard PC COM port with the following configuration:
9-pin male connector:Pin 2 ReceivePin 3 TransmitPin 5 Ground
Note: A null modem cable must be used when connecting the Recorder to the control system forMCIP to work.
Basic protocol Printable ASCII characters for simple, standard functions Debugging for programmers/installers is made much simpler Commands should be short and clearly delineated Small amounts of data to be transferred
-
8/6/2019 Designing AV Automation for the Mediasite Rich Media Recorder
14/26
Technical Planner: TP-02 Designing AV Automation for the Mediasite Recorder
Protocol fields
Header: *
Terminator: Field Delimiter: Message replies thatcontain white spaceNote: If the replycontains only oneparameter, it is not inquotes.
some reply parameter
Command:
Control messages
Start recording: RECORDReply would be: STATUS RECBUSY / ERROR TRUE
*Only if status is IDLE, otherwise replies with current STATUS or ERROR
Pause recording: PAUSEReply would be: STATUS PAUSED / ERROR TRUE
*Only if status is IDLE, otherwise replies with current STATUS or ERROR
Stop recording: STOPReply would be: STATUS RECBUSY / ERROR TRUE
*Only if status is RECORD, otherwise replies with current STATUS or ERROR
Publish to CD: PUBLISH CDReply would be: STATUS PUBLISH / ERROR TRUE
*Only if status is IDLE and can publish, otherwise replies with current STATUS or ERROR
Advance image: IMAGEADVANCEReply would be: IMAGEADVANCE TRUE / FALSE
Image auto scenedetection mode: IMAGEAUTO TRUE / FALSEReply would be: IMAGEAUTO TRUE / FALSE
Set mode to filterscheduled list to justpresentations fortoday: SCHEDULEDTODAY TRUE / FALSEReply would be: SCHEDULEDTODAY TRUE / FALSE
-
8/6/2019 Designing AV Automation for the Mediasite Rich Media Recorder
15/26
Technical Planner: TP-02 Designing AV Automation for the Mediasite Recorder
Reply would be: PRESETINDEX x*Where x is a zero-based index of an available image preset settings*Only if status is IDLE, otherwise replies with current index
Set the audio recordlevel: AUDIORECORDLEVEL xReply would be: AUDIORECORDLEVEL x
*Where x is the audio record level from 0 to 100
Open a scheduledpresentation by id: SCHEDULEDID id
Reply would be: SCHEDULEDID id*Where id is an id of an available scheduled presentation, e.g.E874F172-CA21-46ff-B2BC-D3FDEED908B2*Only if status is IDLE, otherwise replies with current id*Supports live broadcast and on-demand archival of presentationsduring record, in addition to auto publishing afterwards.
Verbose status mode: VERBOSE TRUE / FALSEReply would be: VERBOSE TRUE / FALSE
Favor Widescreenmode:
IMAGEFAVORWIDESCREEN TRUE / FALSE
Reply would be: IMAGEFAVORWIDESCREEN TRUE / FALSE
Encoder Video Input: ENCODERVIDEOINPUT 0 / 1 / 2Reply would be: ENCODERVIDEOINPUT 0 / 1 / 2
* 0 is when video is the input to the encoder, 1 is when the image isthe input to the encoder, 2 is when the image with video in PiP is theinput to the encoder
Create a scheduledpresentation on theserver using apresentation templateand open thepresentation on theRecorder:
PRESENTATIONTEMPLATEID id
Reply would be: PRESENTATIONTEMPLATEID id*Where id is an id of an available presentation template, e.g.CD87EFA6-A98B-4968-BDF2-E3BF4AF3EE6B*Only if status is IDLE
Feedback messages
-
8/6/2019 Designing AV Automation for the Mediasite Rich Media Recorder
16/26
Technical Planner: TP-02 Designing AV Automation for the Mediasite Recorder
Reply would be: STATUS IDLE / RECBUSY / RECORD /PAUSED / PUBLISHVerbose Status: Supports notification
Request ifpresentation isAvailable: PUBLISH ?Reply would be: PUBLISH TRUE / FALSEVerbose Status: Supports notification
Request if filterscheduled list to just
presentations fortoday is on: SCHEDULEDTODAY ?Reply would be: SCHEDULEDTODAY TRUE / FALSE
Request image count: IMAGECOUNT ?Reply would be: IMAGECOUNT x
*Where x is the current count of sent slidesVerbose Status: Supports notification
Request image autoscene detectionmode: IMAGEAUTO ?Reply would be: IMAGEAUTO TRUE / FALSEVerbose Status: Supports notification
Request currentencoding profile byindex: PROFILEINDEX ?Reply would be: PROFILEINDEX x
*Where x is a zero-based index of an available encoding profileVerbose Status: Supports notificationError Handling Does not return an error immediately. Need to poll for error.
Request streamingprofile count: PROFILECOUNT ?Reply would be: PROFILECOUNT x
*Where x is the current count of available encoding profiles
Request streamingprofile name byindex: PROFILENAME x ?Reply would be: PROFILENAME x title
*Where x is a zero based index of an available encoding profile and title is the title of the
-
8/6/2019 Designing AV Automation for the Mediasite Rich Media Recorder
17/26
Technical Planner: TP-02 Designing AV Automation for the Mediasite Recorder
Error Handling Does not return an error immediately. Need to poll for error.
Request image presetcount: PRESETCOUNT ?Reply would be: PRESETCOUNT x
*Where x is the current count of available image presets
Request imagepresets name byindex: PRESETINFO x ?Reply would be: PRESETINFO x title description scan-rate sensitivity
stabilization*Where x is a zero-based index of an available image presets and title, description, scan-rate,sensitivity, and stabilization are the title, description, scan rate, sensitivity, and stabilization ofthe associated image preset
Request currentlyopened scheduledpresentation by id: SCHEDULEDID ?Reply would be: SCHEDULEDID id
*Where id is an id of an available scheduled presentation, e.g. E874F172-CA21-46ff-B2BC-D3FDEED908B2
Verbose Status: Supports notificationError Handling Does not return an error immediately. Need to poll for error.
Request scheduledpresentation count: SCHEDULEDCOUNT ?Reply would be: SCHEDULEDCOUNT x / ERROR TRUE
*Where x is the current count of available scheduled presentations, otherwise if unable to retrievethe scheduled presentation list replies with ERROR
Request scheduledpresentation info byindex: SCHEDULEDINFO x ?Reply would be: SCHEDULEDINFO x id title
*Where x is a zero-based index of an available scheduled presentation, and id and title are the idand title of the associated scheduled presentation
Request detailedscheduledpresentation info byindex:
SCHEDULEDINFO2 x ?
-
8/6/2019 Designing AV Automation for the Mediasite Rich Media Recorder
18/26
Technical Planner: TP-02 Designing AV Automation for the Mediasite Recorder
*Where x is the current count of available presentation templates, otherwise if unable to retrievethe presentation template list replies with ERROR
Request currentlyselected presentationtemplate id: PRESENTATIONTEMPLATEID ?Reply would be: PRESENTATIONTEMPLATEID idVerbose Status: Supports notificationError Handling Does not return an error immediately. Need to poll for error.
*Where id is an id of an available presentation template, e.g. CD87EFA6-A98B-4968-BDF2-E3BF4AF3EE6B
Request presentationtemplate info (id) byindex: PRESENTATIONTEMPLATEINFO x ?Reply would be: PRESENTATIONTEMPLATEINFO x id name details
*Where x is a zero-based index of an available presentation template, and id is the id of theassociated presentation template
Request currentlyopened presentationtitle: PRESENTATIONTITLE ?Reply would be: PRESENTATIONTITLE Test TemplateVerbose Status: Supports notification
*Where Test Template is the title of the opened presentation on the Recorder
Request recordershard drive free spaceamount:
FREESPACE ?
Reply would be: FREESPACE x*Where x is the available free space on the recorders hard drive in GB
Request currentaudio input level: AUDIOLEVEL ?Reply would be: AUDIOLEVEL x
*Where x is the audio input level on the range 0 to 100
Request currentaudio input recordlevel:
AUDIORECORDLEVEL ?
Reply would be: AUDIORECORDLEVEL x*Where x is the audio input record level on the range 0 to 100
-
8/6/2019 Designing AV Automation for the Mediasite Rich Media Recorder
19/26
Technical Planner: TP-02 Designing AV Automation for the Mediasite Recorder
Reply would be: IMAGEFAVORWIDESCREEN TRUE / FALSEVerbose Status: Supports notification
Request encoderVideo Input:
ENCODERVIDEOINPUT ?
Reply would be: ENCODERVIDEOINPUT 0 / 1 / 2* 0 is when video is the input to the encoder, 1 is when the image isthe input to the encoder, 2 is when the image with video in PiP is theinput to the encoder
Verbose Status: Supports notification
Request AudioStatus: AUDIOSTATUS ?
Reply would be: AUDIOSTATUS 0 / 1 / 2* 0 is normal, 1 is low audio levels, 2 is low audio warning
Verbose Status: Supports notification
Request error: ERROR ?Reply would be: ERROR TRUE / FALSEVerbose Status: Supports notification
Request error text: ETEXT ?Reply would be: ETEXT error text message
Reply if invalidcommand received: EMESSAGE command
Protocol examples
Start recording: * RECORD Reply: * STATUS RECBUSY
Start recording but errors: * RECORD Reply * ERROR TRUE
Stop recording: * STOP Reply: * STATUS RECBUSY
Publish last recorded presentationwith query:
Request can publish: * PUBLISH ? Reply: * PUBLISH TRUE
Publish to CD: * PUBLISH CD Reply: * STATUS PUBLISH
-
8/6/2019 Designing AV Automation for the Mediasite Rich Media Recorder
20/26
Technical Planner: TP-02 Designing AV Automation for the Mediasite Recorder
Reply: * IMAGEADVANCE TRUE Request image count: * IMAGECOUNT ?
Reply: * IMAGECOUNT 10
Request version info: * VERSION ? Reply: * VERSION Mediasite 440 Series Recorder 3.3 Build
1156
Request record time: * TIME ? Reply: * TIME 00:43:15
Request status: * STATUS ? Reply: * STATUS IDLE
Request encoding profile count: * PROFILECOUNT ? Reply: * PROFILECOUNT 11
Request encoding profile nameby zero-based index: * PROFILENAME 0 ?
Reply: * PROFILENAME 0 Default Internet (56 Kbps +
128 Kbps)
Request current encoding profileby zero-based index: * PROFILEINDEX ?
Reply: * PROFILEINDEX 0
Choose an available encoding profileby zero-based index: * PROFILEINDEX 5
Reply: * PROFILEINDEX 5
Request image preset settings count: * PRESETCOUNT ? Reply: * PRESETCOUNT 5
Request image preset settings infoby zero-based index: * PRESETINFO 2 ?
Reply: * PRESETINFO 2 [Default] Fast Fast motion,and high sensitivity 4 95 TRUE
Request current image preset settingby zero-based index: * PRESETINDEX ?
Reply: * PRESETINDEX 0
Choose an available encoding profileby zero based index: * PROFILEINDEX 5
-
8/6/2019 Designing AV Automation for the Mediasite Rich Media Recorder
21/26
Technical Planner: TP-02 Designing AV Automation for the Mediasite Recorder
Request scheduled presentation infoby zero-based index:
* SCHEDULEDINFO 0 ?
Reply: * SCHEDULEDINFO 0 E874F172-CA21-46ff-B2BC-D3FDEED908B2 This is a test presentation title
Request detailed scheduledpresentation info by zero-based index:
* SCHEDULEDINFO2 0 ?
Reply: * SCHEDULEDINFO2 0 E874F172-CA21-46ff-B2BC-D3FDEED908B2 This is a test presentation
title Spiderman 10-10-07 9:30:00AM
Request currently opened scheduledpresentation by id:
* SCHEDULEDID ?
Reply: * SCHEDULEDID E874F172-CA21-46ff-B2BC-D3FDEED908B2
Open an available scheduledPresentation by id: * SCHEDULEDID CF1012F6-A921-4f54-899D-
AB264F28DA39 Reply: SCHEDULEDID CF1012F6-A921-4f54-899D-
AB264F28DA39
Request scheduled today filter setting: * SCHEDULEDTODAY ? Reply: * SCHEDULEDTODAY TRUE
Turn off scheduled today filter: * SCHEDULEDTODAY FALSE Reply: * SCHEDULEDTODAY FALSE
Request presentation template count: * PRESENTATIONTEMPLATECOUNT ? Reply: * PRESENTATIONTEMPLATECOUNT 20
Request currently selectedpresentation template by id:
* PRESENTATIONTEMPLATEID ?
Reply: * PRESENTATIONTEMPLATEID CD87EFA6-A98B-4968-BDF2-E3BF4AF3EE6B
Request presentation template infoby zero-based index:
* PRESENTATIONTEMPLATEINFO 0 ?
Reply: * PRESENTATIONTEMPLATEINFO 0 CD87EFA6-A98B-4968-BDF2-E3BF4AF3EE6B "Chemistry 101""Standard Video (320 x 240 150 Kbps Video, 32Kb A d )" CR
-
8/6/2019 Designing AV Automation for the Mediasite Rich Media Recorder
22/26
Technical Planner: TP-02 Designing AV Automation for the Mediasite Recorder
Create a scheduled presentation on the
server using a presentation template idand open the presentation on theRecorder:
* PRESENTATIONTEMPLATE CD87EFA6-A98B-4968-BDF2-E3BF4AF3EE6B
Reply: PRESENTATIONTEMPLATE CD87EFA6-A98B-4968-BDF2-E3BF4AF3EE6B
Request audio record level: * AUDIORECORDLEVEL ? Reply: * AUDIORECORDLEVEL 80
Set audio record level: * AUDIORECORDLEVEL 50 Reply: * AUDIORECORDLEVEL 50
Request verbose status: * VERBOSE ? Reply: * VERBOSE TRUE
Turn off verbose status: * VERBOSE FALSE Reply: * VERBOSE FALSE
Switch to image input: * ENCODERVIDEOINPUT 1 Reply: * ENCODERVIDEOINPUT 1
Switch to image input with PiP: * ENCODERVIDEOINPUT 2 Reply: * ENCODERVIDEOINPUT 2
Request error status: * ERROR ? Reply: * ERROR TRUE
Request error text: * ETEXT ? Reply: * ETEXT Invalid media in drive
Request recorder free space: * FREESPACE ? Reply: * FREESPACE 43
Reply if invalid
command received: * EMESSAGE RCORD
Verbose status mode
Provides for event-driven asynchronous communications from the Recorder to the controlsystem, please see the previous section where Supports Notification is shown.
Defaults to enabled it can be adjusted on the Recorder and via the VERBOSE command
-
8/6/2019 Designing AV Automation for the Mediasite Rich Media Recorder
23/26
Technical Planner: TP-02 Designing AV Automation for the Mediasite Recorder
Verbose status mode notification examples:
Recording a presentation via RECORD and STOP commands with notifications:
Start Record command: * RECORD Reply: * STATUS RECBUSY Notify Record * STATUS RECORD Notify Image count: * IMAGECOUNT 0 Notify Image count: * IMAGECOUNT 1 Notify Time: * TIME 00:00:05 Notify Image count: * IMAGECOUNT 2 Notify Time: * TIME 00:00:10 Notify Image count: * IMAGECOUNT 3 Stop Record command: * STOP Reply: * STATUS RECBUSY Notify Idle * STATUS IDLE Notify can Publish * PUBLISH TRUE
Publish last recorded presentation after receiving notification:
Notify can publish: * PUBLISH TRUE Publish to CD command: * PUBLISH CD Reply: * STATUS PUBLISH Notify Idle: * STATUS IDLE
Publish last recorded presentation after receiving notification, but errors with notification:
Notify can publish: * PUBLISH TRUE Publish to CD: * PUBLISH CD Reply: * STATUS PUBLISH Notify
Idle: * STATUS IDLE Notify Error: * ERROR TRUE Request error text: * ETEXT ? Reply: * ETEXT Invalid media in drive
User directly turned off image auto scene detection via Windows UI:
Notify detection mode: * IMAGEAUTO FALSE
User directly chose an encoding profile via Windows UI:Notify encoding profile index: * PROFILEINDEX 1
User directly opened a scheduled presentation via Windows UI:
Notify open scheduled presentation: * SCHEDULEDID E874F172-CA21-46ff-B2BC-
-
8/6/2019 Designing AV Automation for the Mediasite Rich Media Recorder
24/26
Technical Planner: TP-02 Designing AV Automation for the Mediasite Recorder
Appendix 2: Recording presentations using the touch panelOnce the Recorder has been integrated into an AV controlled system using MCIP, the user is able
to record and publish presentations using the user interface. If the Crestron sample user interfaceis used, they are able to record and publish the presentation using the Crestron TPS-5000 TouchPanel.
The steps for recording and publishing new and scheduled presentations using the Crestron TPS-5000 Touch Panel are shown below in Figure 6 and Figure 7, respectively.
-
8/6/2019 Designing AV Automation for the Mediasite Rich Media Recorder
25/26
Technical Planner: TP-02 Designing AV Automation for the Mediasite Recorder
25 of 26
Figure 6: Steps for recording a new presentation using a touch panel
-
8/6/2019 Designing AV Automation for the Mediasite Rich Media Recorder
26/26
Technical Planner: TP-02 Designing AV Automation for the Mediasite Recorder
26 of 26
Figure 7: Steps for recording a scheduled presentation using a touch panel