GY/T 247-2011 影院管理系统基本功能和接口规范

GY

中华人民共和国广播电影电视行业标准

GY/T247—2011

影院管理系统基本功能和接口规范

Specificationsofbasicfunctionsandinterfacesoftheatermanagementsystem

2011-08-03发布2011-08-03实施

国家广播电影电视总局发布

GY/T247—2011

目次

前言................................................................................IV

1范围..............................................................................1

2规范性引用文件....................................................................1

3术语和和定义........................................................................1

4缩略语............................................................................1

5系统概述..........................................................................2

5.1系统架构........................................................................2

5.2票务管理系统接口................................................................3

5.3数字电影播放服务器的接口........................................................3

6基本功能要求......................................................................3

6.1数字电影播放服务器控制..........................................................3

6.2用户账户管理....................................................................3

6.3内容管理功能....................................................................3

6.3.1接收..........................................................................3

6.3.2分发..........................................................................3

6.3.3查询..........................................................................3

6.3.4删除..........................................................................3

6.4密钥管理功能....................................................................3

6.4.1接收..........................................................................3

6.4.2分发..........................................................................4

6.4.3查询..........................................................................4

6.4.4删除..........................................................................4

6.5放映计划管理功能................................................................4

6.5.1SPL的创建.....................................................................4

6.5.2放映计划和和影片信息的导入......................................................4

6.5.3放映计划和和影片信息的编辑......................................................4

6.6安全日志管理....................................................................4

6.7自动化控制功能..................................................................4

6.8数据上报功能....................................................................4

6.8.1总体要求......................................................................4

6.8.2主动上报......................................................................4

6.8.3数据查询响响应..................................................................5

6.9安全要求........................................................................5

7数字电影播放服务器管理接口........................................................5

7.1概述............................................................................5

I

GY/T247—2011

7.2内容管理类.......................................................................5

7.2.1获取内容信息（getcpl）接口.....................................................5

7.2.2获取内容列表信息（getcpllist）接口.............................................6

7.2.3删除内容（deletecontent）接口..................................................7

7.2.4验证内容（validatecpl）接口....................................................7

7.3授权管理类.......................................................................8

7.3.1获取密钥（getkdm）接口.........................................................8

7.3.2获取密钥列表（getkdmlist）接口.................................................8

7.3.3删除密钥（deletekdm）接口......................................................9

7.4播放控制类......................................................................10

7.4.1获取播放状态（getplaybackstatus）接口.........................................10

7.4.2播放播放列表（playspl）接口...................................................11

7.4.3暂停播放列表（pausespl）接口..................................................11

7.4.4停止播放列表（stopspl）接口...................................................12

7.4.5播放播放列表中下一个内容（next）接口..........................................12

7.4.6播放播放列表中上一个内容（previous）接口......................................13

7.4.7跳转到播放内容指定位置（gotoposition）接口....................................13

7.4.8选择播放列表（selectspl）接口.................................................14

7.5放映管理类......................................................................14

7.5.1创建播放列表（createspl）接口.................................................14

7.5.2获取播放列表（getspllist）接口................................................15

7.5.3获取播放列表详细信息（getpartialspl）接口.....................................16

7.5.4验证播放列表（validatespl）接口...............................................16

7.5.5删除播放列表（deletespl）接口.................................................17

7.5.6创建放映计划（createschedule）接口............................................17

7.5.7获取放映计划列表（getschedulelist）接口.......................................18

7.5.8获取放映计划详细信息（getschedule）接口.......................................19

7.5.9取消放映计划（cancelschedule）接口............................................20

7.5.10打开放映计划功能（enablescheduler）接口......................................20

7.5.11关闭放映计划功能（disablescheduler）接口.....................................21

7.5.12获取放映计划功能状态（getschedulerstatus）接口...............................21

7.6系统管理类......................................................................22

7.6.1获取服务器安全日志（getauditlog）接口.........................................22

7.6.2获取TMS安全日志（gettmsauditlog）接口........................................23

7.6.3获取服务器时间（getserverdatetime）接口.......................................24

7.6.4设置服务器时间（setserverdatetime）接口.......................................24

7.6.5获取服务器信息（getserverinfo）接口...........................................25

7.6.6获取服务器存储信息（getstorageinfo）接口......................................26

7.6.7获取服务器公钥指纹（getpublickeythumbprint）接口..............................26

7.7传输管理类......................................................................27

7.7.1导入播放内容（ingestpackage）接口.............................................27

7.7.2导入密钥（ingestkdm）接口.....................................................28

7.7.3获取导入播放内容传输状态（getingeststatus）接口...............................29

II

GY/T247—2011

7.7.4取消导入播放内容（cancelingest）接口.........................................30

附录A（规范性附录）票务管理系统SOAP通信协议......................................31

附录B（资料性附录）CRIFSTSDK对2K数字电影播放服务器的软件版本要求..............34

附录C（规范性附录）DCP专用接收设备通信协议.......................................35

附录D（规范性附录）KDM获取列表数据格式...........................................42

附录E（规范性附录）SPL数据信息格式...............................................48

附录F（规范性附录）票务管理系统影片放映计划数据交换文件格式.......................53

附录G（规范性附录）票务管理系统影片信息数据交换文件格式...........................59

附录H（规范性附录）影院自动化控制设备通信协议.....................................62

附录I（规范性附录）TMS数据主动上报通信协议.......................................64

附录J（规范性附录）TMS数据查询响响应通信协议.......................................66

附录K（资料性附录）关于在其他操作系统及开发语言下使用CRIFSTSDK的开发建议.......70

III

GY/T247—2011

前言

本标准按照GB/T1.1-2009《标准化工作导则第1部分：标准的结构和和编写》给出的规则编制。

本标准由全国广播电影电视标准化技术委员员会(SAC/TC239)归口。

本标准起草单位：中国电影科学技术研究所、国家广电总局电影数字节目管理中心。

本标准主要起草人：张鑫、崔强、张红、刘翼光。

IV

GY/T247—2011

影院管理系统基本功能和接口规范

1范围

本标准规定了影院管理系统的基本功能要求，定义了数字电影播放服务器管理、票务管理系统通信、

内容与授权文件接收、影院自动化控制等接口的通信协议和和数据格式。

本标准适用于影院管理系统的设计和和开发。

2规范性引用文件

下列文件对于本标准的应用是必不可少的。凡是注日期的引用文件，仅所注日期的版本适用于本标

准。凡是不注日期的引用文件，其最新版本（包括所有的修改单）适用于本标准。

ISO26430-4-2009数字影院运营-日志记录格式规范（D-CinemaOperations－LogRecordsFormat

Specification）

ISO26430-5-2009数字影院运营-安全日志约束（D-CinemaOperations－SecurityLog

Constraints）

W3C（2004.2.4）可扩展标记语言（XML）1.0（第三版）（WorldWideWebConsortium(W3C)(2004,

February4).ExtensibleMarkupLanguage(XML)1.0(ThirdEdition)）

W3C（2004.10.28）XML架构第一部分：结构（第二版）（WorldWideWebConsortium(W3C)(2004,

October28).XMLSchemaPart1:Structures(SecondEdition)）

W3C（2004.10.28）XML架构第二部分：数据类型（第二版）（WorldWideWebConsortium(W3C)

(2004,October28).XMLSchemaPart2:Datatypes(SecondEdition)）

3术语和定义

下列术语和和定义适用于本标准。

3.1

影院管理系统theatermanagementsystem

能够集中管理影院数字放映设备、数字放映内容（影片及广告告与预告告片）、数字放映授权（密钥

文件）和和数字放映日志，以及放映计划和和影院自动化设备的管理系统。

3.2

数字电影播放服务器digitalcinemaplaybackserver

能够对数字节目中的图像、声音等进行实时处理，并还原成视音频信号的系统设备。

3.3

CRIFSTSDKCRIFSTsoftwaredevelopmentkit

基于Linux系统JAVA开发语言的影院管理系统开发包。

4缩略语

1

GY/T247—2011

下列缩略语适用于本标准。

AES高级加密标准（AdvancedEncryptionStandard）

CPL合成播放列表（CompositionPlayList）

DCP数字电影数据包（DigitalCinemaPackage）

KDM密钥传送消息（KeyDeliveryMessage）

SOAP简单对象访问协议（SimpleObjectAccessProtocol)

SPL放映播放列表（ShowPlayList）

TMS影院管理系统（TheaterManagementSystem）

UUID通用唯一标识符（UniversalUniqueIDentifier）

5系统概述

5.1系统架构

TMS主要由放映设备控制、用户账户管理、内容管理、密钥管理、放映计划管理、安全日志管理、

自动化控制功能和和数据上报功能等组成。系统可以通过影院内部网络，与数字电影播放服务器、DCP专

用接收设备、票务管理系统、自动化控制系统、数据上报/查询系统等进行通信，TMS架构见图1。

影院管理系统（TMS）

放用内密放安自数

映户容钥映全动据

设帐管管计日化上

备户理理划志控报

控管管管制功

制理理理功能

能

接口协议

CRIFSTSDK开发包/数字票务管理自动化控内容/授权数据上报与

电影播放服务器接口系统接口制接口接收接口查询接口

设备与系统

数字电影播放DCP专用接收设备票务管理自动化控制数据上报/查询

服务器系统设备系统

图1TMS架构

2

GY/T247—2011

5.2票务管理系统接口

TMS可以通过调用电影院计算机票务管理系统的WebService接口获取票务管理系统的放映计划、影

片信息等数据。票务管理系统SOAP通信协议参见附录A。

5.3数字电影播放服务器的接口

TMS可以通过调用CRIFSTSDK实现数字电影播放服务器的管理，其调用接口协议定义见本标准7数

字电影播放服务器管理接口。CRIFSTSDK对2K数字电影播放服务器的软件版本要求参见附录B。

6基本功能要求

6.1数字电影播放服务器控制

TMS应能够实时获取数字电影播放服务器的工作状态，并能够对数字电影播放服务器进行以下功能

的控制：

——放映开始；

——放映停止；

——放映暂停；

——放映恢复。

6.2用户账户管理

TMS应能够支持多级用户账户，并且能够增加、删除、修改用户的权限和和信息，能够对不同的用户

赋予不同的权限。

6.3内容管理功能

6.3.1接收

TMS应能够通过影院内部网络、移动硬盘等接收DCP。在接收到DCP以后，应对DCP进行解析，验证DCP

及其中文件的完整性和和正确性。

TMS可以通过影院内部网络从DCP专用接收设备获取DCP，通信协议见附录C。

6.3.2分发

TMS应能够通过影院内部网络把DCP从存储设备发送到指定的数字电影播放服务器。

6.3.3查询

TMS应具有查询其所存储的DCP的功能。

6.3.4删除

TMS应具有删除其所存储的DCP的功能。

6.4密钥管理功能

6.4.1接收

TMS应能够通过网络、移动硬盘等接收KDM，并对KDM进行分析和和存储。KDM获取列表数据格式见附录

D。

3

GY/T247—2011

6.4.2分发

TMS应能够将KDM发送到相应的数字电影播放服务器。

6.4.3查询

TMS应具有查询其所存储的KDM的功能。

6.4.4删除

TMS应具有删除其所存储的KDM的功能。

6.5放映计划管理功能

6.5.1SPL的创建

TMS应具有创建SPL的功能，SPL数据信息格式见附录E。

6.5.2放映计划和影片信息的导入

TMS应能够从电影院计算机票务管理系统导入已编排的放映计划。票务管理系统影片放映计划数据

交换文件格式见附录F，票务管理系统影片信息数据交换文件格式见附录G。

6.5.3放映计划和影片信息的编辑

TMS应具有放映计划和和影片信息的编辑功能。

6.6安全日志管理

TMS应具有数字电影播放服务器安全日志的查询和和导出功能。TMS使用的安全日志，其内容与格式应

符合ISO26430-4-2009和和ISO26430-5-2009要求。当TMS向外部管理系统提供安全日志数据时，应通过

调用7.6.2接口实现。

6.7自动化控制功能

TMS可以通过网络与影院自动化控制设备通信，实现对场灯、幕帘等的自动化控制，影院自动化控

制设备通信协议见附录H。

6.8数据上报功能

6.8.1总体要求

TMS应具有按需要配置一个或多个数据上报通信访问地址的功能。TMS向外部管理系统提供放映信息

数据（包括安全日志数据、设备运行数据等）时，可以采用主动上报和和被动查询两种方式。TMS向外部

管理系统传输放映信息数据过程中，如发生网络、设备等故障，TMS应具有容错机制，保证数据正确传

输。

当TMS向外部管理系统提供安全日志数据时，应通过调用7.6.2接口实现,安全日志的XML数据内容

与格式应符合ISO26430-4-2009和和ISO26430-5-2009要求,安全日志所携带的数字签名计算值应由

CRIFSTSDK生成。

6.8.2主动上报

4

GY/T247—2011

TMS应能够以指定的时间，周周期性地主动向外部管理系统上报数据。TMS数据主动上报通信协议见附

录I。上报的数据格式为XML数据格式，根据上报数据的种类不同，XML数据内容和和结构有所不同。

6.8.3数据查询响应

TMS应能够响响应外部管理系统随机发出的数据查询指令。TMS数据查询响响应通信协议见附录J。根据

查询数据的种类和和条件不同，数据查询指令有所不同。

6.9安全要求

TMS提供的安全日志，其数字签名的计算应由CRIFSTSDK内部实现。

7数字电影播放服务器管理接口

7.1概述

TMS可以调用CRIFSTSDK的数字电影播放服务器管理接口实现对数字电影播放服务器的管理。

CRIFSTSDK中数字电影播放服务器管理接口包括以下六个控制类，见表1。控制类及其中包含的接口使

用了Java语言定义。

表1数字电影播放服务器管理接口控制类

类名称描述

ContentManagement内容管理类

LicenseManagement授权管理类

PlaybackControl播放控制类

ShowManagement放映管理类

SystemManagement系统管理类

TransferManagement传输管理类

接口的调用采用请求-回答的方式，接口的返回值采用了XML数据格式。其采用XML结构如下：

<?xmlversion="1.0"encoding="utf-8"?>

<responsestatus="OK"version="2"/>

返回值中仅包含一个response元素，元素内容用于说明接口返回内容。

status：属性status说明接口返回状态（OK或ERROR），接口调用成功返回OK，错误返回ERROR。

version：属性version说明接口版本号。

7.2内容管理类

7.2.1获取内容信息（getcpl）接口

接口函数

获取内容信息接口函数见表2。

表2获取内容信息（getcpl）接口函数

publicjava.lang.Stringgetcpl(java.lang.StringUUID)

方法声明

throws

5

GY/T247—2011

java.lang.Exception

获取指定UUID的CPLXML字符串，只能在数字电影播放服务器空闲时调用才能保证获取成

功能说明

功。

成功返回值

成功返回值描述如下：

<?xmlversion="1.0"encoding="utf-8"?>

<responsestatus="OK"version="2">

<response_text><!--CPLXMLstring--></response_text>

</response>

返回值中仅包含一个response_text元素，元素内容为CPL的XML字符串。

失败返回值

失败返回值描述如下：

<?xmlversion="1.0"encoding="utf-8"?>

<responsestatus="ERROR"version="2">

<error>Cannotgetcpl.</error>

</response>

7.2.2获取内容列表信息（getcpllist）接口

接口函数

获取内容列表信息接口函数见表3。

表3获取内容列表信息（getcpllist）接口函数

Publicjava.lang.String

方法声明

getcpllist()throwsjava.lang.Exception

功能说明获取设备中所有CPL的列表。列表中列出CPL的UUID。

成功返回值

成功返回值描述如下：

<?xmlversion="1.0"encoding="utf-8"?>

<responsestatus="OK"version="2">

<cpl_uuid>urn:uuid:87d8773e-8bbf-11de-adb4-5232d2a4a49a</cpl_uuid>

<cpl_uuid>urn:uuid:b3d8650b-2e64-4827-ae07-d6dffc5ffd9a</cpl_uuid>

</response>

返回值中包含零个或一个cpl_uuid元素，元素内容为CPL的UUID。

失败返回值

失败返回值描述如下：

<?xmlversion="1.0"encoding="utf-8"?>

<responsestatus="ERROR"version="2">

6

GY/T247—2011

<error>Cannotgetcpllist.</error>

</response>

7.2.3删除内容（deletecontent）接口

接口函数

删除内容接口函数见表4。

表4删除内容（deletecontent）接口函数

publicjava.lang.Stringdeletecontent(java.lang.StringUUID)

方法声明

throwsjava.lang.Exception

功能说明删除指定UUID的CPL节目内容。

参数说明UUID-CPL的UUID

成功返回值

成功返回值描述如下：

<?xmlversion="1.0"encoding="utf-8"?>

<responsestatus="OK"version="2">

</response>

失败返回值

失败返回值描述如下：

<?xmlversion="1.0"encoding="utf-8"?>

<responsestatus="ERROR"version="2">

<error>Cannotdeletecontent.</error>

</response>

7.2.4验证内容（validatecpl）接口

接口函数

验证内容接口函数见表5。

表5验证内容（validatecpl）接口函数

publicjava.lang.Stringvalidatecpl(java.lang.StringUUID)

方法声明

throwsjava.lang.Exception

验证指定UUID的CPL节目是否满足播放条件。验证内容文件资产是否完整，如果内容被加

功能说明

密，则需验证密钥是否满足使用条件。

参数说明UUID-CPL的UUID

成功返回值

成功返回值描述如下：

<?xmlversion="1.0"encoding="utf-8"?>

<responsestatus="OK"version="2">

7

GY/T247—2011

</response>

失败返回值

失败返回值描述如下：

<?xmlversion="1.0"encoding="utf-8"?>

<responsestatus="ERROR"version="2">

<error>MissingAssets.</error>

</response>

7.3授权管理类

7.3.1获取密钥（getkdm）接口

接口函数

获取密钥接口函数见表6。

表6获取密钥（getkdm）接口函数

publicjava.lang.Stringgetkdm(java.lang.StringUUID)

方法声明

throwsjava.lang.Exception

功能说明得到指定KDM字符串。

参数说明UUID-KDM文件的UUID

成功返回值

成功返回值描述如下：

<?xmlversion="1.0"encoding="utf-8"?>

<responsestatus="OK"version="2">

<response_text><!--KDMXMLstring--></response_text>

</response>

返回值中仅包含一个response_text元素，元素内容为KDM的XML字符串。

失败返回值

失败返回值描述如下：

<?xmlversion="1.0"encoding="utf-8"?>

<responsestatus="ERROR"version="2">

<error>Cannotgetkdm.</error>

</response>

7.3.2获取密钥列表（getkdmlist）接口

接口函数

获取密钥列表接口函数见表7。

8

GY/T247—2011

表7获取密钥列表（getkdmlist）接口函数

publicjava.lang.Stringgetkdmlist()

方法声明

throwsjava.lang.Exception

功能说明获取设备中所有KDM的列表。

成功返回值

成功返回值描述如下：

<?xmlversion="1.0"encoding="utf-8"?>

<responsestatus="OK"version="2">

<asset_uuid>urn:uuid:87d8773e-8bbf-11de-adb4-5232d2a4a49a</asset_uuid>

<asset_uuid>urn:uuid:b3d8650b-2e64-4827-ae07-d6dffc5ffd9a</asset_uuid>

</response>

返回值中包含零个或一个asset_uuid元素，元素内容为KDM的UUID。

失败返回值

失败返回值描述如下：

<?xmlversion="1.0"encoding="utf-8"?>

<responsestatus="ERROR"version="2">

<error>Cannotgetkdmlist.</error>

</response>

7.3.3删除密钥（deletekdm）接口

接口函数

删除密钥接口函数见表8