Codian MCU 4200 Series Uživatelský manuál stáhnout pdf (Strana 3)

Codian MCU 4200 Series Remote Management API

Introduction

The Codian MCU 4200 series products are controllable via messages sent using the XML-RPC

protocol.

Please note that the Management API option key must be loaded before an MCU 4200

series device will respond to API commands.

XML-RPC is a simple protocol for remote procedure calling using HTTP as the transport and XML as the

encoding. It is designed to be as simple as possible, whilst allowing complex data structures to be

transmitted, processed and returned. XML-RPC has no platform or software dependence. XML-RPC

was chosen over SOAP due to its simplicity.

The interface is stateless. Currently there is no mechanism for the Codian MCU to call back the

controlling application and therefore the controlling application must poll the MCU for status as required.

A future enhancement may provide a mechanism for signaling MCU status changes to the controlling

application.

1.1 HTTP

The Codian MCU expects to receive HTTP communication over TCP/IP connections to port 80. The

HTTP messages should be “POST”s to the URL “/RPC2”.

The MCU implements HTTP/1.1 as defined by RFC 2616 [2].

1.2 XML-RPC

For the background and details of XML-RPC, please refer to the specification [1].

In this implementation, all parameters and return values are part of a <struct> and are all explicitly

named. For example, the “device.query” method returns the current time value as a structure member

named ‘currentTime’ rather than as a single value of type <dateTime.iso8601>.

1.3 Authentication

In order to manage the MCU, the controlling application must authenticate itself as a user with

administrator privileges. Accordingly, each message contains a user name and password.

1.4 Message Flow

An application can create and manage conferences by sending command messages to the MCU. For

each command sent, the MCU will respond with a message indicating success or failure. The response

message may also contain data requested.

Command messages are sent in XML format. For example, the following message will schedule a

conference to begin at 10:45 on 18 February 2005 and last for one hour:

POST /RPC2 HTTP/1.1

User-Agent: Frontier/5.1.2 (WinNT)

Host: 10.2.1.100

Content-Type: text/xml

Content-length: 713

<?xml version="1.0"?>

<methodName>conference.create</methodName>

<param>

<value>

1 2 3 4 5 6 7 8 ... 32 33

Žádné komentáře

Codian MCU 4200 Series Uživatelský manuál Strana 3