Designing AV Automation for the Mediasite Rich Media Recorder

Embed Size (px)

Citation preview

  • 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