元素免费ftp服务器地址

GY中华人民共和国广播电影电视行业标准GY/T247—2011影院管理系统基本功能和接口规范Specificationsofbasicfunctionsandinterfacesoftheatermanagementsystem2011-08-03发布2011-08-03实施国家广播电影电视总局发布GY/T247—2011I目次前言IV1范围12规范性引用文件13术语和定义14缩略语15系统概述25.
1系统架构25.
2票务管理系统接口35.
3数字电影播放服务器的接口36基本功能要求36.
1数字电影播放服务器控制36.
2用户账户管理36.
3内容管理功能36.
3.
1接收36.
3.
2分发36.
3.
3查询36.
3.
4删除36.
4密钥管理功能36.
4.
1接收36.
4.
2分发46.
4.
3查询46.
4.
4删除46.
5放映计划管理功能46.
5.
1SPL的创建.
46.
5.
2放映计划和影片信息的导入46.
5.
3放映计划和影片信息的编辑46.
6安全日志管理46.
7自动化控制功能46.
8数据上报功能46.
8.
1总体要求46.
8.
2主动上报46.
8.
3数据查询响应56.
9安全要求57数字电影播放服务器管理接口57.
1概述5GY/T247—2011II7.
2内容管理类57.
2.
1获取内容信息(getcpl)接口57.
2.
2获取内容列表信息(getcpllist)接口67.
2.
3删除内容(deletecontent)接口77.
2.
4验证内容(validatecpl)接口77.
3授权管理类87.
3.
1获取密钥(getkdm)接口87.
3.
2获取密钥列表(getkdmlist)接口87.
3.
3删除密钥(deletekdm)接口97.
4播放控制类107.
4.
1获取播放状态(getplaybackstatus)接口107.
4.
2播放播放列表(playspl)接口117.
4.
3暂停播放列表(pausespl)接口117.
4.
4停止播放列表(stopspl)接口127.
4.
5播放播放列表中下一个内容(next)接口127.
4.
6播放播放列表中上一个内容(previous)接口137.
4.
7跳转到播放内容指定位置(gotoposition)接口137.
4.
8选择播放列表(selectspl)接口147.
5放映管理类147.
5.
1创建播放列表(createspl)接口147.
5.
2获取播放列表(getspllist)接口157.
5.
3获取播放列表详细信息(getpartialspl)接口167.
5.
4验证播放列表(validatespl)接口167.
5.
5删除播放列表(deletespl)接口177.
5.
6创建放映计划(createschedule)接口177.
5.
7获取放映计划列表(getschedulelist)接口187.
5.
8获取放映计划详细信息(getschedule)接口197.
5.
9取消放映计划(cancelschedule)接口207.
5.
10打开放映计划功能(enablescheduler)接口207.
5.
11关闭放映计划功能(disablescheduler)接口217.
5.
12获取放映计划功能状态(getschedulerstatus)接口217.
6系统管理类227.
6.
1获取服务器安全日志(getauditlog)接口227.
6.
2获取TMS安全日志(gettmsauditlog)接口237.
6.
3获取服务器时间(getserverdatetime)接口247.
6.
4设置服务器时间(setserverdatetime)接口247.
6.
5获取服务器信息(getserverinfo)接口257.
6.
6获取服务器存储信息(getstorageinfo)接口267.
6.
7获取服务器公钥指纹(getpublickeythumbprint)接口267.
7传输管理类277.
7.
1导入播放内容(ingestpackage)接口277.
7.
2导入密钥(ingestkdm)接口287.
7.
3获取导入播放内容传输状态(getingeststatus)接口29GY/T247—2011III7.
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的开发建议.
.
.
.
.
.
.
70GY/T247—2011IV前言本标准按照GB/T1.
1-2009《标准化工作导则第1部分:标准的结构和编写》给出的规则编制.
本标准由全国广播电影电视标准化技术委员会(SAC/TC239)归口.
本标准起草单位:中国电影科学技术研究所、国家广电总局电影数字节目管理中心.

本标准主要起草人:张鑫、崔强、张红、刘翼光.
GY/T247—20111影院管理系统基本功能和接口规范1范围本标准规定了影院管理系统的基本功能要求,定义了数字电影播放服务器管理、票务管理系统通信、内容与授权文件接收、影院自动化控制等接口的通信协议和数据格式.

本标准适用于影院管理系统的设计和开发.
2规范性引用文件下列文件对于本标准的应用是必不可少的.
凡是注日期的引用文件,仅所注日期的版本适用于本标准.
凡是不注日期的引用文件,其最新版本(包括所有的修改单)适用于本标准.

ISO26430-4-2009数字影院运营-日志记录格式规范(D-CinemaOperations-LogRecordsFormatSpecification)ISO26430-5-2009数字影院运营-安全日志约束(D-CinemaOperations-SecurityLogConstraints)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.
3CRIFSTSDKCRIFSTsoftwaredevelopmentkit基于Linux系统JAVA开发语言的影院管理系统开发包.
4缩略语GY/T247—20112下列缩略语适用于本标准.
AES高级加密标准(AdvancedEncryptionStandard)CPL合成播放列表(CompositionPlayList)DCP数字电影数据包(DigitalCinemaPackage)KDM密钥传送消息(KeyDeliveryMessage)SOAP简单对象访问协议(SimpleObjectAccessProtocol)SPL放映播放列表(ShowPlayList)TMS影院管理系统(TheaterManagementSystem)UUID通用唯一标识符(UniversalUniqueIDentifier)5系统概述5.
1系统架构TMS主要由放映设备控制、用户账户管理、内容管理、密钥管理、放映计划管理、安全日志管理、自动化控制功能和数据上报功能等组成.
系统可以通过影院内部网络,与数字电影播放服务器、DCP专用接收设备、票务管理系统、自动化控制系统、数据上报/查询系统等进行通信,TMS架构见图1.

图1TMS架构接口协议票务管理系统接口CRIFSTSDK开发包/数字电影播放服务器接口自动化控制接口内容/授权接收接口数据上报与查询接口影院管理系统(TMS)放映设备控制用户帐户管理内容管理密钥管理放映计划管理安全日志管理自动化控制功能数据上报功能设备与系统数字电影播放服务器DCP专用接收设备自动化控制设备票务管理系统数据上报/查询系统GY/T247—201135.
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.
GY/T247—201146.
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主动上报GY/T247—20115TMS应能够以指定的时间,周期性地主动向外部管理系统上报数据.
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结构如下:返回值中仅包含一个response元素,元素内容用于说明接口返回内容.
status:属性status说明接口返回状态(OK或ERROR),接口调用成功返回OK,错误返回ERROR.

version:属性version说明接口版本号.
7.
2内容管理类7.
2.
1获取内容信息(getcpl)接口7.
2.
1.
1接口函数获取内容信息接口函数见表2.
表2获取内容信息(getcpl)接口函数方法声明publicjava.
lang.
Stringgetcpl(java.
lang.
StringUUID)throwsGY/T247—20116java.
lang.
Exception功能说明获取指定UUID的CPLXML字符串,只能在数字电影播放服务器空闲时调用才能保证获取成功.
7.
2.
1.
2成功返回值成功返回值描述如下:返回值中仅包含一个response_text元素,元素内容为CPL的XML字符串.
7.
2.
1.
3失败返回值失败返回值描述如下:Cannotgetcpl.
7.
2.
2获取内容列表信息(getcpllist)接口7.
2.
2.
1接口函数获取内容列表信息接口函数见表3.
表3获取内容列表信息(getcpllist)接口函数方法声明Publicjava.
lang.
Stringgetcpllist()throwsjava.
lang.
Exception功能说明获取设备中所有CPL的列表.
列表中列出CPL的UUID.
7.
2.
2.
2成功返回值成功返回值描述如下:urn:uuid:87d8773e-8bbf-11de-adb4-5232d2a4a49aurn:uuid:b3d8650b-2e64-4827-ae07-d6dffc5ffd9a返回值中包含零个或一个cpl_uuid元素,元素内容为CPL的UUID.
7.
2.
2.
3失败返回值失败返回值描述如下:GY/T247—20117Cannotgetcpllist.
7.
2.
3删除内容(deletecontent)接口7.
2.
3.
1接口函数删除内容接口函数见表4.
表4删除内容(deletecontent)接口函数方法声明publicjava.
lang.
Stringdeletecontent(java.
lang.
StringUUID)throwsjava.
lang.
Exception功能说明删除指定UUID的CPL节目内容.
参数说明UUID-CPL的UUID7.
2.
3.
2成功返回值成功返回值描述如下:7.
2.
3.
3失败返回值失败返回值描述如下:Cannotdeletecontent.
7.
2.
4验证内容(validatecpl)接口7.
2.
4.
1接口函数验证内容接口函数见表5.
表5验证内容(validatecpl)接口函数方法声明publicjava.
lang.
Stringvalidatecpl(java.
lang.
StringUUID)throwsjava.
lang.
Exception功能说明验证指定UUID的CPL节目是否满足播放条件.
验证内容文件资产是否完整,如果内容被加密,则需验证密钥是否满足使用条件.
参数说明UUID-CPL的UUID7.
2.
4.
2成功返回值成功返回值描述如下:GY/T247—201187.
2.
4.
3失败返回值失败返回值描述如下:MissingAssets.
7.
3授权管理类7.
3.
1获取密钥(getkdm)接口7.
3.
1.
1接口函数获取密钥接口函数见表6.
表6获取密钥(getkdm)接口函数方法声明publicjava.
lang.
Stringgetkdm(java.
lang.
StringUUID)throwsjava.
lang.
Exception功能说明得到指定KDM字符串.
参数说明UUID-KDM文件的UUID7.
3.
1.
2成功返回值成功返回值描述如下:返回值中仅包含一个response_text元素,元素内容为KDM的XML字符串.
7.
3.
1.
3失败返回值失败返回值描述如下:Cannotgetkdm.
7.
3.
2获取密钥列表(getkdmlist)接口7.
3.
2.
1接口函数获取密钥列表接口函数见表7.
GY/T247—20119表7获取密钥列表(getkdmlist)接口函数方法声明publicjava.
lang.
Stringgetkdmlist()throwsjava.
lang.
Exception功能说明获取设备中所有KDM的列表.
7.
3.
2.
2成功返回值成功返回值描述如下:urn:uuid:87d8773e-8bbf-11de-adb4-5232d2a4a49aurn:uuid:b3d8650b-2e64-4827-ae07-d6dffc5ffd9a返回值中包含零个或一个asset_uuid元素,元素内容为KDM的UUID.
7.
3.
2.
3失败返回值失败返回值描述如下:Cannotgetkdmlist.
7.
3.
3删除密钥(deletekdm)接口7.
3.
3.
1接口函数删除密钥接口函数见表8.
表8删除密钥(deletekdm)接口函数方法声明publicjava.
lang.
Stringdeletekdm(java.
lang.
StringUUID)throwsjava.
lang.
Exception功能说明删除指定的KDM.
参数说明UUID-KDM文件的UUID7.
3.
3.
2成功返回值成功返回值描述如下:7.
3.
3.
3失败返回值失败返回值描述如下:GY/T247—201110Cannotdeletekdm.
7.
4播放控制类7.
4.
1获取播放状态(getplaybackstatus)接口7.
4.
1.
1接口函数获取播放状态接口函数见表9.
表9获取播放状态(getplaybackstatus)接口函数方法声明publicjava.
lang.
Stringgetplaybackstatus()throwsjava.
lang.
Exception功能说明信息主要包括正在播放的SPL的信息和CPL的信息.
7.
4.
1.
2成功返回值成功返回值描述如下:DOLBY_3_Durn:uuid:6f00304b-d9d8-4f16-800a-47db3ae603c43Dshowsurn:uuid:460ad63e-ad08-4f85-bae7-1cbbbda7e824test返回值中包含一个playbackmode元素,零个或一个status元素,用于说明数字电影播放服务器当前播放的状态.
playbackmode:说明当前播放模式(2D、3D或Dolby_3_D).
status:属性state说明当前播放状态(STOPPED、PLAYING、PAUSED、READY).
show_uuid:说明当前播放的SPL的UUID.
show_name:说明当前播放的SPL的名字.
show_position:说明当然播放SPL的信息.
属性total_duration说明总时长.
属性played_duration说明当前播放的时长.
7.
4.
1.
3失败返回值失败返回值描述如下:GY/T247—201111Cannotgetserverstatus.
7.
4.
2播放播放列表(playspl)接口7.
4.
2.
1接口函数播放播放列表见表10.
表10播放播放列表(playspl)接口函数方法声明publicjava.
lang.
Stringplayspl()throwsjava.
lang.
Exception功能说明播放SPL之前必须先调用selectspl.
7.
4.
2.
2成功返回值成功返回值描述如下:7.
4.
2.
3失败返回值失败返回值描述如下:Cannotplaythisspl.
7.
4.
3暂停播放列表(pausespl)接口7.
4.
3.
1接口函数暂停播放列表接口函数见表11.
表11暂停播放列表(pausespl)接口函数方法声明publicjava.
lang.
Stringpausespl()throwsjava.
lang.
Exception功能说明暂停播放后,可以调用playspl继续播放.
7.
4.
3.
2成功返回值成功返回值描述如下:GY/T247—2011127.
4.
3.
3失败返回值失败返回值描述如下:Cannotpauseplaythisspl.
7.
4.
4停止播放列表(stopspl)接口7.
4.
4.
1接口函数停止播放列表接口函数见表12.
表12停止播放列表(stopspl)接口函数方法声明publicjava.
lang.
Stringstopspl()throwsjava.
lang.
Exception功能说明停止播放后,在播放之前需调用selectspl选定影片.
7.
4.
4.
2成功返回值成功返回值描述如下:7.
4.
4.
3失败返回值失败返回值描述如下:Cannotstopplaying.
7.
4.
5播放播放列表中下一个内容(next)接口7.
4.
5.
1接口函数播放播放列表中下一个内容接口函数见表13.
表13播放播放列表中下一个内容(next)接口函数方法声明publicjava.
lang.
Stringnext()throwsjava.
lang.
Exception功能说明如果SPL中有多个CPL,则跳到下一个CPL播放.
7.
4.
5.
2成功返回值成功返回值描述如下:GY/T247—2011137.
4.
5.
3失败返回值失败返回值描述如下:Cannotgotonextcpl.
7.
4.
6播放播放列表中上一个内容(previous)接口7.
4.
6.
1接口函数播放播放列表中上一个内容接口函数见表14.
表14播放播放列表中上一个内容(revious)接口函数方法声明publicjava.
lang.
Stringprevious()throwsjava.
lang.
Exception功能说明如果SPL中有多个CPL,则跳到前一个CPL播放.
7.
4.
6.
2成功返回值成功返回值描述如下:7.
4.
6.
3失败返回值失败返回值描述如下:Cannotgotopreviouscpl.
7.
4.
7跳转到播放内容指定位置(gotoposition)接口7.
4.
7.
1接口函数跳转到播放内容指定位置接口见表15.
表15跳转到播放内容指定位置(gotoposition)接口函数方法声明publicjava.
lang.
Stringgotoposition(intoffset)GY/T247—201114throwsjava.
lang.
Exception功能说明参数单位为帧,此时播放状态应该是"暂停".
参数说明offset-当前CPL的帧偏移量7.
4.
7.
2成功返回值成功返回值描述如下:7.
4.
7.
3失败返回值失败返回值描述如下:Cannotgotoposition.
7.
4.
8选择播放列表(selectspl)接口7.
4.
8.
1接口函数选择播放列表接口函数见表16.
表16选择播放列表(selectspl)接口函数方法声明publicjava.
lang.
Stringselectspl(java.
lang.
StringUUID)throwsjava.
lang.
Exception功能说明数字电影播放服务器可以播放CPL、SPL,但在这里SPL是播放内容的唯一方式,因此播放某一CPL之前,需先创建一个SPL.
参数说明UUID-SPL的UUID7.
4.
8.
2成功返回值成功返回值描述如下:7.
4.
8.
3失败返回值失败返回值描述如下:Cannotselectthisspl.
7.
5放映管理类GY/T247—2011157.
5.
1创建播放列表(createspl)接口7.
5.
1.
1接口函数创建播放列表接口函数见表17.
表17创建播放列表(greatespl)接口函数方法声明publicjava.
lang.
Stringcreatespl(java.
lang.
Stringspl)throwsjava.
lang.
Exception功能说明创建一个放映播放列表(SPL).
当创建一个具有相同UUID的SPL时,原有SPL会被更新,但是如果被更新的SPL已经列入某一放映计划,则放映计划可能会失效.
参数说明spl-符合附录A格式要求的SPL字符串7.
5.
1.
2成功返回值成功返回值描述如下:7.
5.
1.
3失败返回值失败返回值描述如下:Cannotcreatespl.
7.
5.
2获取播放列表(getspllist)接口7.
5.
2.
1接口函数获取播放列表接口函数见表18.
表18获取播放列表(getspllist)接口函数方法声明publicjava.
lang.
Stringgetspllist()throwsjava.
lang.
Exception功能说明列表中列出SPL的UUID.
7.
5.
2.
2成功返回值成功返回值描述如下:urn:uuid:87d8773e-8bbf-11de-adb4-5232d2a4a49aurn:uuid:b3d8650b-2e64-4827-ae07-d6dffc5ffd9aGY/T247—201116返回值中包含零个或一个show_uuid元素,元素内容为SPL的UUID.
7.
5.
2.
3失败返回值失败返回值描述如下:Cannotgetspllist.
7.
5.
3获取播放列表详细信息(getpartialspl)接口7.
5.
3.
1接口函数获取播放列表详细信息接口函数见表19.
表19获取播放列表详细信息(getpartialspl)接口函数方法声明publicjava.
lang.
Stringgetpartialspl(java.
lang.
StringUUID)throwsjava.
lang.
Exception功能说明获取符合附录A格式要求的SPL字符串,各服务器SPL格式不同,这里进行了格式转换.
参数说明UUID-SPL的UUID7.
5.
3.
2成功返回值成功返回值描述如下:返回值中仅包含一个response_text元素,元素内容为SPL的XML字符串.
7.
5.
3.
3失败返回值失败返回值描述如下:Cannotgetspl.
7.
5.
4验证播放列表(validatespl)接口7.
5.
4.
1接口函数验证播放列表接口函数见表20.
表20验证播放列表(validatespl)接口函数方法声明publicjava.
lang.
Stringvalidatespl(java.
lang.
StringUUID)throwsjava.
lang.
ExceptionGY/T247—201117功能说明验证指定UUID的SPL是否满足播放条件.
验证SPL中包含内容的文件资产是否完整,如果有加密的内容,则还需验证相应密钥是否满足使用条件.
参数说明UUID-SPL的UUID7.
5.
4.
2成功返回值成功返回值描述如下:7.
5.
4.
3失败返回值失败返回值描述如下:MissingAssets.
7.
5.
5删除播放列表(deletespl)接口7.
5.
5.
1接口函数删除播放列表接口函数见表21.
表21删除播放列表(deletespl)接口函数方法声明publicjava.
lang.
Stringdeletespl(java.
lang.
StringUUID)throwsjava.
lang.
Exception功能说明删除指定UUID的SPL.
参数说明UUID-SPL的UUID7.
5.
5.
2成功返回值成功返回值描述如下:7.
5.
5.
3失败返回值失败返回值描述如下:Cannotdeletethisspl.
7.
5.
6创建放映计划(createschedule)接口GY/T247—2011187.
5.
6.
1接口函数创建放映计划接口函数见表22.
表22创建放映计划(createschedule)接口函数方法声明publicjava.
lang.
Stringcreateschedule(java.
lang.
Stringdate_time,java.
lang.
Stringspl_UUID)throwsjava.
lang.
Exception功能说明放映计划只能针对SPL创建,不能为CPL创建放映计划,因此为实现放映计划功能,需要先为节目创建SPL.
不支持放映计划的更新,若需要更新某一放映计划,必须先删除然后重新创建.
参数说明date_time-时间点spl_UUID-SPL的UUID7.
5.
6.
2成功返回值成功返回值描述如下:urn:uuid:7df25b96-e2d7-49bf-9b4c-12edce1582cd返回值中仅包含一个schedule_uuid元素,元素内容为schedule的UUID.
7.
5.
6.
3失败返回值失败返回值描述如下:Cannotcreatethisschedule.
7.
5.
7获取放映计划列表(getschedulelist)接口7.
5.
7.
1接口函数获取放映计划列表接口函数见表23.
表23获取放映计划列表(getschedulelist)接口函数方法声明publicjava.
lang.
Stringgetschedulelist()throwsjava.
lang.
Exception功能说明列表中列出放映计划的时间、SPL的UUID和放映计划的UUID.
7.
5.
7.
2成功返回值成功返回值描述如下:GY/T247—201119urn:uuid:7df25b96-e2d7-49bf-9b4c-12edce1582cdurn:uuid:13740b99-a739-4c7c-b3f9-6e8433c55b78urn:uuid:05e44a26-6a3c-4f71-9dcf-f71b4a30efce返回值中包含零个或一个schedule元素.
元素内容为schedule的UUID.
show_uuid:属性show_uuid为放映计划中SPL的UUID.
iso_date_time:属性iso_date_time为放映计划中SPL的放映时间.
7.
5.
7.
3失败返回值失败返回值描述如下:Cannotgetschedulelist.
7.
5.
8获取放映计划详细信息(getschedule)接口7.
5.
8.
1接口函数获取放映计划详细信息接口函数见表24.
表24获取放映计划详细信息(getschedule)接口函数方法声明publicjava.
lang.
Stringgetschedule(java.
lang.
StringUUID)throwsjava.
lang.
Exception功能说明信息包括放映计划的时间、SPL的UUID和放映计划的UUID.
7.
5.
8.
2成功返回值成功返回值描述如下:urn:uuid:7df25b96-e2d7-49bf-9b4c-12edce1582cd返回值中仅包含一个schedule元素.
元素内容为schedule的UUID.
show_uuid:属性show_uuid为放映计划中SPL的UUID.
iso_date_time:属性iso_date_time为放映计划中SPL的放映时间.
GY/T247—2011207.
5.
8.
3失败返回值失败返回值描述如下:Cannotgetscheduleinfo.
7.
5.
9取消放映计划(cancelschedule)接口7.
5.
9.
1接口函数取消放映计划(cancelschedule)接口函数见表25.
表25取消放映计划(cancelschedule)接口函数方法声明publicjava.
lang.
Stringcancelschedule(java.
lang.
StringUUID)throwsjava.
lang.
Exception功能说明取消设备上某一个放映计划.
参数说明UUID-放映计划的UUID7.
5.
9.
2成功返回值成功返回值描述如下:7.
5.
9.
3失败返回值失败返回值描述如下:Cannotcancelthisschedule.
7.
5.
10打开放映计划功能(enablescheduler)接口7.
5.
10.
1接口函数打开放映计划功能接口函数见表26.
表26打开放映计划功能(enablescheduler)接口函数方法声明publicjava.
lang.
Stringenablescheduler()throwsjava.
lang.
Exception功能说明开启某一设备的放映计划功能,如果该功能开启,则设备会自动按照放映计划播放节目.

7.
5.
10.
2成功返回值GY/T247—201121成功返回值描述如下:7.
5.
10.
3失败返回值失败返回值描述如下:Cannotenablescheduler.
7.
5.
11关闭放映计划功能(disablescheduler)接口7.
5.
11.
1接口函数关闭放映计划功能接口函数见表27.
表27关闭放映计划功能(disablescheduler)接口函数方法声明publicjava.
lang.
Stringdisablescheduler()throwsjava.
lang.
Exception功能说明关闭某一设备的放映计划功能,如果该功能关闭,则设备会忽略设备中存在的放映计划.

7.
5.
11.
2成功返回值成功返回值描述如下:7.
5.
11.
3失败返回值失败返回值描述如下:Cannotdisablescheduler.
7.
5.
12获取放映计划功能状态(getschedulerstatus)接口7.
5.
12.
1接口函数获取放映计划功能状态接口函数见表28.
表28获取放映计划功能状态(getschedulerstatus)接口函数方法声明publicjava.
lang.
Stringgetschedulerstatus()GY/T247—201122throwsjava.
lang.
Exception功能说明用于查看某一设备的放映计划功能是否被开启.
7.
5.
12.
2成功返回值成功返回值描述如下:返回值中仅包含一个status元素.
属性enabled的值为true或false.
7.
5.
12.
3失败返回值失败返回值描述如下:Cannotgetschedulerstatus.
7.
6系统管理类7.
6.
1获取服务器安全日志(getauditlog)接口7.
6.
1.
1接口函数获取系统日志接口函数见表29.
表29获取系统日志(getauditlog)接口函数方法声明publicjava.
lang.
Stringgetauditlog(java.
lang.
Stringhost,java.
lang.
Stringuser,java.
lang.
Stringpasswd,java.
lang.
Stringstart_date,java.
lang.
Stringstart_time,java.
lang.
Stringend_date,java.
lang.
Stringend_time,java.
lang.
StringCPL_UUID,java.
lang.
StringKDM_UUID)throwsjava.
lang.
Exception功能说明获取某一设备的审查日志报告,报告中包含指定日期和时间下的安全事件,日志报告应符合ISO26430-4-2009格式要求.
调用此接口后,设备会将其日志传送到ftp://host/user:passwd/server_identifier/目录下,CRIFSTSDK内部对设备上传的日志进行转换和处理,最终返回标准化的日志的绝对路径.
此接口不能在影片播放的时候调用,因此调用前请判断播放状态.
另,此接口执行时间可能会比较长,应尽量使用较短的查询时间间隔.
GY/T247—201123参数说明host-主机地址user-用户名passwd-用户密码start_date-开始日期start_time-开始时间end_date-结束日期end_time-结束时间CPL_UUID-CPL的UUIDKDM_UUID-KDM的UUID7.
6.
1.
2成功返回值成功返回值描述如下:/auditLog/CrifstAuthLogReportExample.
xml返回值中仅包含一个auditlog_path元素,元素内容为日志文件的路径.
7.
6.
1.
3失败返回值失败返回值描述如下:Cannotgetlogpath.
7.
6.
2获取TMS安全日志(gettmsauditlog)接口7.
6.
2.
1接口函数获取TMS安全日志接口函数见表30.
表30获取TMS安全日志(gettmsauditlog)接口函数方法声明publicstaticjava.
lang.
Stringgettmsauditlog(intauditorium_list[],java.
lang.
Stringstart_date,java.
lang.
Stringstart_time,java.
lang.
Stringend_date,java.
lang.
Stringend_time,)throwsjava.
lang.
Exception功能说明获取TMS安全日志模块内已保存的影厅设备安全日志的报告,报告中包含指定的一个或多个影厅,在指定日期和时间下的安全事件,日志报告应符合ISO26430-4-2009格式要求.
参数说明auditorium_list[]–影厅数组start_date-开始日期start_time-开始时间end_date-结束日期GY/T247—201124end_time-结束时间7.
6.
2.
2成功返回值成功返回值描述如下:/auditLog/CrifstAuthLogReportExample.
xml返回值中仅包含一个auditlog_path元素,元素内容为日志文件的路径.
7.
6.
2.
3失败返回值失败返回值描述如下:Cannotgetlogpath.
7.
6.
3获取服务器时间(getserverdatetime)接口7.
6.
3.
1接口函数获取服务器时间接口函数见表31.
表31获取服务器时间(getserverdatetime)接口函数方法声明publicjava.
lang.
Stringgetserverdatetime()throwsjava.
lang.
Exception功能说明不同设备的系统时间应设计有同步机制.
7.
6.
3.
2成功返回值成功返回值描述如下:2010-05-06T12:42:15+08:00返回值中仅包含一个iso_date_time元素,元素内容为服务器的时间.
7.
6.
3.
3失败返回值失败返回值描述如下:Cannotgetserverdatetime.
7.
6.
4设置服务器时间(setserverdatetime)接口GY/T247—2011257.
6.
4.
1接口函数设置服务器时间接口函数见表32.
表32设置服务器时间(setserverdatetime)接口函数方法声明publicjava.
lang.
Stringsetserverdatetime(java.
lang.
Stringiso_date_time)throwsjava.
lang.
Exception功能说明设置时间变化幅度应在±6分钟范围内.
参数说明iso_date_time-时间7.
6.
4.
2成功返回值成功返回值描述如下:7.
6.
4.
3失败返回值失败返回值描述如下:Cannotsetserverdatetime.
7.
6.
5获取服务器信息(getserverinfo)接口7.
6.
5.
1接口函数获取服务器信息接口函数见表33.
表33获取服务器信息(getserverinfo)接口函数方法声明publicjava.
lang.
Stringgetserverinfo()throwsjava.
lang.
Exception功能说明信息主要包括型号、序列号、软硬件/固件版本等.
7.
6.
5.
2成功返回值成功返回值描述如下:SA2100A04950返回值中包含model、serial、version等三个元素.
model元素内容为服务器设备型号;serial元素内容为服务器设备序号;version元素用来描述设备的软硬件信息.
GY/T247—201126os:属性os用来描述服务器的系统软件版本号.
software:属性software用来描述服务器操作软件版本号.
firmware:属性firmware用来描述服务器固件版本号.
7.
6.
5.
3失败返回值失败返回值描述如下:Cannotgetserverinfo.
7.
6.
6获取服务器存储信息(getstorageinfo)接口7.
6.
6.
1接口函数获取服务器存储信息接口函数见表34.
表34获取服务器存储信息(getstorageinfo)接口函数方法声明publicjava.
lang.
Stringgetstorageinfo()throwsjava.
lang.
Exception功能说明信息包括可用存储空间和总存储空间.
7.
6.
6.
2成功返回值成功返回值描述如下:返回值中仅包含一个storage元素.
total_space:属性total_space为服务器总空间的大小.
free_space:属性free_space为服务器剩余空间的大小.
7.
6.
6.
3失败返回值失败返回值描述如下:Cannotgetserverstorageinfo.
7.
6.
7获取服务器公钥指纹(getpublickeythumbprint)接口7.
6.
7.
1接口函数获取服务器公钥指纹接口函数见表35.
GY/T247—201127表35获取服务器公钥指纹(getpublickeythumbprint)接口函数方法声明publicjava.
lang.
Stringgetpublickeythumbprint()throwsjava.
lang.
Exception功能说明数字电影播放服务器的公钥指纹唯一标识该设备,设备软件升级更新时指纹不变,设备更换和替换时指纹会发生变化.
7.
6.
7.
2成功返回值成功返回值描述如下:Z/992AcGZdN/m9HImIqk+9i6EIg=返回值中仅包含一个publickeythumbprint元素.
元素内容为数字电影播放服务器公钥指纹.
当服务器拥有多个公钥指纹时,不同的公钥指纹以"|"字符作为分隔符.
7.
6.
7.
3失败返回值失败返回值描述如下:Cannotgetserverpublickeythumbprint.
7.
7传输管理类7.
7.
1导入播放内容(ingestpackage)接口7.
7.
1.
1接口函数导入播放内容接口函数见表36.
表36导入播放内容(ingestpackage)接口函数方法声明publicjava.
lang.
Stringingestpackage(java.
lang.
Stringhost,java.
lang.
Stringuser,java.
lang.
Stringpassword,java.
lang.
Stringcpl_UUID,java.
lang.
Stringcpl_path)throwsjava.
lang.
Exception功能说明给设备发送该获取指令,设备会创建一个内容获取任务,从存储设备FTP服务器上自动抓取某个DCP.
返回值的ingest_uuid标识内容获取任务.
使用地址:ftp://user:password@host/cpl_path,应能够访问到cpl文件,与该文件同一目录下,应存在DCP包中应包含的ASSETMAP、PKL、MXF等文件.
参数说明host-FTP服务器主机IP地址user-登录用户名GY/T247—201128password-密码cpl_UUID-DCP中包含的内容UUIDcpl_path-DCP中包含的内容CPL文件路径7.
7.
1.
2成功返回值成功返回值描述如下:urn:uuid:7df25b96-e2d7-49bf-9b4c-12edce1582cd返回值中仅包含一个ingest_uuid元素.
元素内容为导入事件的UUID.
7.
7.
1.
3失败返回值失败返回值描述如下:Sendingestcommandfailed.
7.
7.
2导入密钥(ingestkdm)接口7.
7.
2.
1接口函数导入密钥接口函数见表37.
表37导入密钥(ingestkdm)接口函数方法声明publicjava.
lang.
Stringingestkdm(java.
lang.
Stringhost,java.
lang.
Stringuser,java.
lang.
Stringpassword,java.
lang.
Stringpath,java.
lang.
StringUUID)throwsjava.
lang.
Exception功能说明给设备发送该获取指令,设备会从TMS存储设备FTP服务器上自动抓取某个KDM.

使用地址:ftp://user:password@host/path,能够访问到KDM文件.
参数说明host-FTP服务器主机IP地址user-登录用户名password-密码path-KDM文件路径UUID-KDM的UUID7.
7.
2.
2成功返回值成功返回值描述如下:GY/T247—2011297.
7.
2.
3失败返回值失败返回值描述如下:Sendingestcommandfailed.
7.
7.
3获取导入播放内容传输状态(getingeststatus)接口7.
7.
3.
1接口函数获取导入播放内容传输状态接口函数见表38.
表38获取导入播放内容传输状态(getingeststatus)接口函数方法声明publicjava.
lang.
Stringgetingeststatus(java.
lang.
StringUUID)throwsjava.
lang.
Exception功能说明查询某一设备DCP传输内容获取任务的执行情况,获取DCP数据传输进度.
参数说明UUID-内容获取任务的UUID7.
7.
3.
2成功返回值成功返回值描述如下:RUNNING97返回值中仅包含一个ingest_status元素.
status:说明导入播放内容的状态(RUNNING、STOPPED、CANCEL).
percent:说明导入播放内容的进度.
description:说明数字电影播放服务器返回信息,可以为空.
7.
7.
3.
3失败返回值失败返回值描述如下:Cannotingeststatus.
GY/T247—2011307.
7.
4取消导入播放内容(cancelingest)接口7.
7.
4.
1接口函数取消导入播放内容接口函数见表39.
表39取消导入播放内容(cancelingest)接口函数方法声明publicjava.
lang.
Stringcancelingest(java.
lang.
StringUUID)throwsjava.
lang.
Exception功能说明取消设备的某一内容获取任务.
参数说明UUID-内容获取任务的UUID7.
7.
4.
2成功返回值成功返回值描述如下:7.
7.
4.
3失败返回值失败返回值描述如下:Cancelingestjoberror.
GY/T247—201131AA附录A(规范性附录)票务管理系统SOAP通信协议A.
1概述本附录定义了TMS和票务管理系统之间进行通信的SOAP协议.
通过使用该协议TMS可以获取票务管理系统的影片信息和放映计划数据.
A.
2命名规范本附录中定义的数据交换文件格式为SOAP协议,基于XML的数据格式.
XML数据格式使用命名空间来定义XML中元素的作用空间.
对于本标准定义的SOAP协议中定义的数据交换格式,使用的命名空间为:http://project.
crifst.
org/tms/smi/2010/POSAPI.
A.
3通信协议定义A.
3.
1getFilmsA.
3.
1.
1getFilms命令的定义getFilms命令的定义见图A.
1.
图A.
1getFilms命令的定义A.
3.
1.
2getFilms命令的返回值定义getFilms命令的返回值定义如下:stringA.
3.
2getSchedulesA.
3.
2.
1getSchedules命令的定义getSchedules包含TheatreCode、BeginDate、EndDate3个参数.
getSchedules中的TheatreCode参数用来描述影院的编码,类型为string类型.
getSchedules中的BeginDate参数用来描述放映计划的开始时间,类型为string类型.

getSchedules中的EndDate参数用来描述放映计划的结束时间,类型为string类型.

getSchedules命令的定义见图A.
2.
图A.
2getSchedules命令的定义StringStringStringA.
3.
2.
2getSchedules命令的返回值定义getSchedules命令的返回值定义如下:GY/T247—201133stringGY/T247—201134BB附录B(资料性附录)CRIFSTSDK对2K数字电影播放服务器的软件版本要求B.
12K数字电影播放服务器软件最低版本要求CRIFSTSDK要求2K数字电影播放服务器的软件最低版本见表B.
1.
表B.
12K数字电影播放服务器软件最低版本要求品牌软件最低版本Dolby4.
2.
0GDC7.
7aDoremi2.
0.
10当服务器系统软件升级为新版本时,应保证控制接口协议向下兼容.
GY/T247—201135CC附录C(规范性附录)DCP专用接收设备通信协议C.
1概述本附录定义了TMS与DCP专用接收设备之间的通信方式和报文协议.
通过该通信协议,TMS可以从DCP专用接收设备获取DCP,并根据需要转发到数字电影播放服务器中.
C.
2连接方式和校验DCP专用接收设备提供两个服务:一个是标准的TCP/IPSocket连接服务,DCP专用接收设备启动后,会持续侦听TCP20080端口,TMS系统可随时接入,进行信息交互;另一个是标准的FTP服务,TMS系统使用从DCP专用接收设备获取的用户名和密码登陆,下载相应的影片.
数据校验采用CRC32算法.
C.
3命令定义一旦通过网络和DCP接收设备之间建立连接,所有的通信将遵守"请求-回复"的握手协议.
DCP接收接口命令报文格式见表C.
1.
表C.
1DCP接收接口命令报文格式字节名称值备注(1字节)Preamble0x55包头,起始标志(2字节)Cmd主命令字(4字节)PayloadLength命令长度,不包括CheckSum(N字节)载荷内容(部分命令中使用该字段)(4字节)CheckSum校验和,包括包头和载荷内容C.
4接口业务流程及报文数据格式C.
4.
1连接认证连接认证时序图见图C.
1.
GY/T247—201136图C.
1连接认证时序图C.
4.
1.
1连接请求报文连接请求报文格式见表C.
2.
表C.
2连接请求报文格式字节名称值备注(1字节)Preamble0x55包头,起始标志(2字节)Cmd0x11建立连接(4字节)PayloadLength命令长度,不包括CheckSum(4字节)CheckSum校验和,包括包头C.
4.
1.
2连接确认报文连接确认报文格式见表C.
3.
表C.
3连接确认报文格式字节名称值备注(1字节)Preamble0x55包头,起始标志(2字节)Cmd0x12建立连接(4字节)PayloadLength命令长度,不包括CheckSum(4字节)CheckSum校验和,包括包头和内容C.
4.
2信息获取信息获取时序图见图C.
2.
连接确认连接请求TMS接收设备发送连接请求,Flags设置为链路不加密接收到连接请求,链路不加密,反馈结果连接建立完毕,开始交互GY/T247—201137图C.
2信息获取时序图C.
4.
2.
1影片信息请求报文影片信息请求报文格式见表C.
4.
影片信息反馈影片对应FTP服务信息请求影片对应FTP服务信息反馈影片信息请求TMS接收设备发送下载信息获取请求将下载影片信息反馈TMS发送对应影片的FTP信息设备确认反馈进行FTP下载进行FTP下载结束后,将已下载信息通知设备FTP下载完毕设备确认反馈已下载影片信息信息反馈确认GY/T247—201138表C.
4影片信息请求报文格式字节名称值备注(1字节)Preamble0x55包头,起始标志(2字节)Cmd0x21请求影片信息(4字节)PayloadLength命令长度,不包括CheckSum(4字节)CheckSum校验和,包括包头C.
4.
2.
2影片信息反馈报文影片信息反馈报文格式见表C.
5.
表C.
5影片信息反馈报文格式字节名称值备注(1字节)Preamble0x55包头,起始标志(2字节)Cmd0x22/0x23请求确认/请求失败(4字节)PayloadLength命令长度,不包括CheckSum(N字节)Payload对应的影片信息数据(4字节)CheckSum校验和,包括包头和内容影片信息请求报文调用成功后,反馈报文中Payload字段信息描述如下:urn:uuid:87d8773e-8bbf-11de-adb4-5232d2a4a49a2010-11-02T16:39:22-00:00HuaLongDCPcreatorv1.
0……返回值中包含一个dcp_list元素和多个或一个dcp元素,用于说明DCP专用接收设备可以供TMS下载的DCP信息.
uuid:说明DCP的uuid.
issueDate:说明DCP的发行时间.
issuer:说明DCP的发行者.
creator:说明DCP的创建者.
C.
4.
2.
3对应影片FTP信息请求报文对应影片FTP信息请求报文格式见表C.
6.
GY/T247—201139表C.
6对应影片FTP信息请求报文格式字节名称值备注(1字节)Preamble0x55包头,起始标志(2字节)Cmd0x24请求uuid指定的信息(4字节)PayloadLength命令长度,不包括CheckSum(N字节)Payload影片DCP标识(4字节)CheckSum校验和,包括包头对应影片FTP信息请求报文中Payload字段信息描述如下:urn:uuid:87d8773e-8bbf-11de-adb4-5232d2a4a49a请求值中仅包含一个uuid元素,用于说明请求DCP的uuid.
C.
4.
2.
4对应影片FTP信息反馈报文对应影片FTP信息反馈报文格式见表C.
7.
表C.
7对应影片FTP信息反馈报文格式字节名称值备注(1字节)Preamble0x55包头,起始标志(2字节)Cmd0x25/0x26请求确认/请求失败(4字节)PayloadLength命令长度,不包括CheckSum(N字节)Payload(N字节)对应影片的FTP用户名密码信息,以及存储目录(4字节)CheckSum校验和,包括包头和内容对应影片FTP信息请求报文调用成功后,反馈报文中Payload字段信息描述如下:PKLftp://192.
168.
1.
10/films/test8888houwangchushi/houwangchushi.
pkl.
xml返回值中包含一个asset_type元素、一个source元素、一个username元素、一个password元素和一个path元素.
asset_type:说明DCP下载类型(PKL或者CPL).
source:说明DCP在ftp存放的路径.
username:说明登陆ftp的用户名.
password:说明登陆ftp的密码.
GY/T247—201140path:如果asset_type元素中内容为PKL则path元素说明DCP中PKL相对应ftp服务器的位置.
如果asset_type元素中内容为CPL则path元素说明DCP中CPL相对应ftp服务器的位置.
C.
4.
2.
5对应影片下载完毕信息反馈报文对应影片下载完毕信息反馈报文见表C.
8.
表C.
8对应影片下载完毕信息反馈报文格式字节名称值备注(1字节)Preamble0x55包头,起始标志(2字节)Cmd0x27影片下载完毕通知信息(4字节)PayloadLength命令长度,不包括CheckSum(N字节)Payload(N字节)影片DCP标识(4字节)CheckSum校验和,包括包头和内容TMS系统下载完毕后对下载的DCP进行校验;校验完成后调用对应影片下载完毕请求报文.
如果下载DCP校验无错,对应影片下载完毕请求信息中Payload字段信息描述如下:urn:uuid:87d8773e-8bbf-11de-adb4-5232d2a4a49a请求值中包含一个uuid元素.
元素内容为已接收DCP的UUID.
如果下载DCP校验出错,对应影片下载完毕请求信息中Payload字段信息描述如下:urn:uuid:87d8773e-8bbf-11de-adb4-5232d2a4a49aAssetismissing请求值中包含一个uuid元素和一个error元素.
uuid元素内容为已接收DCP的UUID,error元素为接收出错的信息描述.
C.
4.
2.
6对应影片下载完毕信息确认报文对应影片下载完毕信息确认报文格式见表C.
9.
表C.
9对应影片下载完毕信息确认报文格式字节名称值备注(1字节)Preamble0x55包头,起始标志(2字节)Cmd0x28请求确认(4字节)PayloadLength命令长度,不包括CheckSum(4字节)CheckSum校验和,包括包头C.
4.
3影片下载影片下载时序图见图C.
3.
GY/T247—201141图C.
3影片下载时序图TMS系统通过信息获取业务流程获得下载DCP的详细信息后,采用标准FTP协议从DCP专用接收设备下载相应的DCP.
FTP内容反馈FTP连接请求TMS接收设备用对应用户名和密码进行FTP连接将对应的FTP文件信息反馈下载对应内容GY/T247—201142DD附录D(规范性附录)KDM获取列表数据格式D.
1概述本附录定义了KDM获取列表数据格式.
TMS可以使用该数据格式通过网络下载KDM文件.

D.
2命名规范本附录中定义的数据交换文件格式为XML数据格式,应符合可扩展标记语言(XML)1.
0(第三版)、XML架构(XML架构第一部分:结构(第二版))和XML数据类型(XML架构第二部分:数据类型(第二版))规定的技术要求.
XML数据格式使用命名空间来定义XML中元素的作用空间.
对于本标准定义的影片信息XML数据交换格式,使用的命名空间为:http://project.
crifst.
org/tms/smi/2010/KDMList,前缀xs代表的命名空间为:http://www.
w3.
org/2001/XMLSchema,前缀ds代表的命名空间为:http://www.
w3.
org/2000/09/xmldsig#.
D.
3数据元素定义D.
3.
1KDMList元素KDMList元素是数据交换文件中包含的必要元素,KDMList元素为KDMListType类型.
KDMList包含KDM子元素.
KDMList元素的定义见图D.
1.
图D.
1KDMList元素的定义D.
3.
2KDMList/KDM元素KDM元素是KDMList的子元素,KDM元素为KDMType类型.
.
KDM元素的定义见图D.
2.
GY/T247—201143图D.
2KDM元素的定义D.
3.
3KDMListType类型KDMListType类型包含一个或多个KDM子元素.
KDMListType类型的定义见图D.
3.
图D.
3KDMListType类型的定义D.
3.
4KDMListType/@theatrecode属性GY/T247—201144KDMListType元素中的theatrecode属性用来描述影院的编码,类型为int类型,是必要元素.
定义如下:D.
3.
5KDMListType/KDMType类型KDMType类型是KDMListType的子元素.
KDMType包含ContentTitleText、CompositionPlaylistId、KDMId、ContentKeysNotValidBefore、ContentKeysNotValidAfter、Recipient子元素.
KDMListType类型的定义见图D.
4.
图D.
4KDMListType类型的定义GY/T247—201145D.
3.
6KDMListType/KDMType/ContentTitleText元素ContentTitleText元素是KDMType元素中的子元素,用来描述KDM的名字,类型为string类型.
定义如下:D.
3.
7KDMListType/KDMType/CompositionPlaylistId元素CompositionPlaylistId元素是KDMType元素中的子元素,用来描述KDM所针对的CPLId,类型为UUID类型.
定义如下:D.
3.
8KDMListType/KDMType/KDMId元素KDMId元素是KDMType元素中的子元素,用来描述KDM所针对的KDMId,类型为UUID类型.
定义如下:GY/T247—201146D.
3.
9KDMListType/KDMType/ContentKeysNotValidBefore元素ContentKeysNotValidBefore元素是KDMType元素中的子元素,用来描述KDM所针对的影片有效时间的开始时间,类型为datetime类型.
定义如下:D.
3.
10KDMListType/KDMType/ContentKeysNotValidAfter元素ContentKeysNotValidAfter元素是KDMType元素中的子元素,用来描述KDM所针对的影片有效时间的结束时间,类型为datetime类型.
定义如下:D.
3.
11KDMListType/KDMType/Recipient元素Recipient元素是KDMType元素中的子元素.
Recipient元素包含X509IssuerSerial、X509SubjectName子元素.
Recipient类型的定义见图D.
5.
图D.
5Recipient类型的定义D.
3.
12KDMListType/KDMType/Recipient/X509IssuerSerial元素X509IssuerSerial元素是Recipient元素中的子元素,用来描述KDM发行者的编号,类型为string类型.
定义如下:D.
3.
13KDMListType/KDMType/Recipient/X509SubjectName元素X509SubjectName元素是Recipient元素中的子元素.
X509SubjectName元素包含X509IssuerName、GY/T247—201147X509SerialNumber子元素.
Recipient类型的定义见图D.
6.
图D.
6Recipient类型的定义D.
3.
14UUID类型UUID类型是全局唯一标识符,UUID是指在一台机器上生成的数字,它保证对在同一时空中的所有机器都是唯一的.
定义如下:GY/T247—201148EE附录E(规范性附录)SPL数据信息格式E.
1概述本附录定义了SPL的数据信息格式.
TMS使用该SPL格式与数字电影播放服务器进行交互,完成数字电影播放服务器上SPL的创建、修改等操作.
E.
2命名规范本附录中定义的数据交换文件格式为XML数据格式,应符合可扩展标记语言(XML)1.
0(第三版)、XML架构(XML架构第一部分:结构(第二版))和XML数据类型(XML架构第二部分:数据类型(第二版))规定的技术要求.
XML数据格式使用命名空间来定义XML中元素的作用空间.
对于本标准定义的影片信息XML数据交换格式,使用的命名空间为:http://project.
crifst.
org/tms/smi/2010/SPL,前缀xs代表的命名空间为:http://www.
w3.
org/2001/XMLSchema.
E.
3数据元素定义E.
3.
1ShowPlaylist元素ShowPlayList元素是SPL中包含的必要元素,ShowPlayList元素包含Id,AnnotationText,CreateDate,Creator,Issuer,Show,ShowTitleText子元素.
ShowPlayList元素的定义见图E.
1.

图E.
1ShowPlayList元素的定义E.
3.
2ShowPlaylist/Id元素Id元素是ShowPlayList元素中的子元素,用来描述SPL的UUID,类型为UUID类型.
定义如下:GY/T247—201149E.
3.
3ShowPlaylist/AnnotationText元素AnnotationText元素是ShowPlayList元素中的子元素,用来描述注释内容.
字段类型为string类型.
元素定义如下:E.
3.
4ShowPlaylist/CreateDate元素CreateDate元素是ShowPlayList元素中的子元素,用来描述SPL的创建时间,类型为dateTime类型.
定义如下:E.
3.
5ShowPlaylist/Creator元素Creator元素是ShowPlayList元素中的子元素,用来描述创建SPL的创建者,类型为string类型.
定义如下:E.
3.
6ShowPlaylist/Issuer元素Issuer元素是ShowPlayList元素中的子元素,用来描述SPL的发行人,类型为string类型.
定义如下:E.
3.
7ShowPlaylist/ShowTitleText元素GY/T247—201150ShowTitleText元素是ShowPlayList元素中的子元素,用来描述SPL的名字,类型为string类型.
定义如下:E.
3.
8ShowPlaylist/Show元素E.
3.
8.
1定义Show元素是ShowPlayList元素中的子元素.
Show元素包含CompositionPlaylistId子元素.
Show元素的定义见图E.
2.
图E.
2Show元素的定义E.
3.
8.
2ShowPlaylist/Show/@Duration属性Show元素中的Duration属性用来描述CompositionPlaylistId子元素需要播放的时间,类型为int类型,是必要元素.
定义如下:GY/T247—201151E.
3.
9ShowPlaylist/Show/CompositionPlaylistId元素E.
3.
9.
1定义CompositionPlaylistId元素是Show元素中的子元素.
CompositionPlaylistId元素的定义见图E.
3.
图E.
3CompositionPlaylistId元素的定义CompositionPlaylistId元素包含以下两个子属性.
E.
3.
9.
2ShowPlaylist/Show/CompositionPlaylistId/@Title属性CompositionPlaylistId元素中的Title属性用来描述播放文件的名称,类型为string类型,是必要元素.
定义如下:E.
3.
9.
3ShowPlaylist/Show/CompositionPlaylistId/@Duration属性CompositionPlaylistId元素中的Duration属性用来描述播放文件的播放时间,类型为int类型,是必要元素.
定义如下:GY/T247—201152E.
3.
10UUID类型UUID类型是全局唯一标识符,UUID是指在一台机器上生成的数字,它保证对在同一时空中的所有机器都是唯一的.
定义如下:GY/T247—201153FF附录F(规范性附录)票务管理系统影片放映计划数据交换文件格式F.
1概述本附录定义了票务管理系统和TMS使用SOAP协议通信时,进行影片放映计划数据交换的文件格式.

F.
2命名规范本附录中定义的数据交换文件格式为XML数据格式,应符合可扩展标记语言(XML)1.
0(第三版)、XML架构(XML架构第一部分:结构(第二版))和XML数据类型(XML架构第二部分:数据类型(第二版))规定的技术要求.
XML数据格式使用命名空间来定义XML中元素的作用空间.
对于本标准定义的影片信息XML数据交换格式,使用的命名空间为:http://project.
crifst.
org/tms/smi/2010/Schedule,前缀xs代表的命名空间为:http://www.
w3.
org/2001/XMLSchema.
F.
3数据元素定义F.
3.
1schedule元素F.
3.
1.
1定义schedule元素是放映计划中包含的必要元素.
schedule元素包含了scheduleday子元素和theatrecode属性.
schedule元素定义见图F.
1.
图F.
1Schedule元素定义GY/T247—201154F.
3.
1.
2schedule/@theatrecode属性Schedule元素中的theatrecode属性用来描述本放映计划的影院编码,类型为string类型,是必要元素.
定义如下:F.
3.
2schedule/scheduleday元素F.
3.
2.
1定义scheduleday元素是Schedule元素的子元素.
scheduleday元素的定义见图F.
2.
图F.
2scheduleday元素的定义GY/T247—201155F.
3.
2.
2schedule/scheduleday/@date属性scheduleday元素中的date属性用来描述计划执行的时间,类型为date类型,是必要元素.
定义如下:F.
3.
3schedule/scheduleday/film元素F.
3.
3.
1定义film元素是Schedule元素的子元素.
film元素的定义见图F.
3.
GY/T247—201156图F.
3film元素的定义F.
3.
3.
2schedule/scheduleday/film/@code属性film元素中的code属性用来描述播放文件的编码,类型为string类型,是必要元素.
定义如下:F.
3.
3.
3schedule/scheduleday/film/@title属性film元素中的title属性用来描述播放文件的名称,类型为string类型,是必要元素.
定义如下:F.
3.
4schedule/scheduleday/film/performances元素performances元素是film元素的子元素.
performances元素的定义见图F.
4.
GY/T247—201157图F.
4performances元素的定义F.
3.
5schedule/scheduleday/film/performances/performance元素F.
3.
5.
1定义performance元素是film元素的子元素.
performance元素的定义见图F.
5.
图F.
5performance元素的定义F.
3.
5.
2schedule/scheduleday/film/performances/performance/@auditorium属性performance元素中的auditorium属性用来描述影厅的名称,类型为string类型,是必要元素.
定义如下:F.
3.
5.
3schedule/scheduleday/film/performances/performance/@showtime属性GY/T247—201158performance元素中的showtime属性用来描述播放文件开始的时间,类型为time类型,是必要元素.
定义如下:GY/T247—201159GG附录G(规范性附录)票务管理系统影片信息数据交换文件格式G.
1概述本附录定义了票务管理系统和TMS使用SOAP协议通信时,进行影片信息数据交换所采用的文件格式.
G.
2命名规范本附录中定义的数据交换文件格式为XML数据格式,应符合可扩展标记语言(XML)1.
0(第三版)、XML架构(XML架构第一部分:结构(第二版))和XML数据类型(XML架构第二部分:数据类型(第二版))规定的技术要求.
XML数据格式使用命名空间来定义XML中元素的作用空间.
对于本标准定义的影片信息XML数据交换格式,使用的命名空间为:http://project.
crifst.
org/tms/smi/2010/FilmInfo,前缀xs代表的命名空间为:http://www.
w3.
org/2001/XMLSchema.
G.
3数据元素定义G.
3.
1filmlist元素G.
3.
1.
1定义filmlist元素是数据交换文件中包含的必要元素,filmlist元素包含film子元素.
filmlist元素的定义见图G.
1.
图G.
1filmlist元素的定义G.
3.
2filmlist/film元素GY/T247—201160film元素是filmlist元素中的子元素,用来描述数据交换文件的详细内容,类型为filmtype类型.
film元素的定义见图G.
2.
图G.
2film元素的定义G.
3.
3filmtype类型G.
3.
3.
1定义filmtype类型有包含code,title,duration子元素.
filmtype类型的定义见图G.
3.
图G.
3filmtype类型的定义G.
3.
4filmtype/code元素code元素是filmtype类型中的子元素,用来描述播放影片的编码.
字段类型为integer类型.
元素定义如下:G.
3.
5filmtype/title元素title元素是filmtype类型中的子元素,用来描述播放影片的名称.
字段类型为string类型.
元素定义如下:G.
3.
6filmtype/duration元素GY/T247—201161duration元素是filmtype类型中的子元素,用来描述播放影片的播放时间.
字段类型为time类型.

元素定义如下:GY/T247—201162HH附录H(规范性附录)影院自动化控制设备通信协议H.
1概述本附录定义了用来控制影院自动化控制设备的通信协议.
通过该控制协议可以操作影院自动化控制设备完成影院影厅内开关场灯、开关银幕帘等操作.
H.
2连接方式本附录中所采取的通信方式为TCP/IP协议,TCP端口为4001.
影院自动化控制设备将一直监听TCP的4001端口,等待从网络接收命令.
H.
3命令定义一旦通过网络和影院自动化控制设备之间建立了连接,所有的通信将遵守"请求-回复"的握手协议.
影院自动化控制设备接收到一个命令以后,将对该命令进行回复;在没有对该命令回复之前,不再接收其他命令.
H.
4发送命令H.
4.
1发送命令数据结构发送命令采用的数据结构为:AA55+命令长度+0x00+命令值+0xFF.
H.
4.
2命令长度8比特的整数描述命令的长度.
命令的长度包含开始值0x00和结束值0xFF.
H.
4.
2.
1命令值命令值采用8比特值表示.
影院自动化控制设备命令值见表H.
1.
GY/T247—201163表H.
1影院自动化控制设备命令值序号命令值功能备注10x10开灯命令.
命令执行成功,返回成功;命令执行失败,返回失败.
20x11关灯命令.
命令执行成功,返回成功;命令执行失败,返回失败.
30x12灯状态查询命令.
灯关闭状态返回失败,灯打开状态返回成功.
40x20开遮幅宽银幕命令.
命令执行成功,返回成功;命令执行失败,返回失败.
50x21开变形宽银幕命令.
命令执行成功,返回成功;命令执行失败,返回失败.
60x22关银幕命令.
命令执行成功,返回成功;命令执行失败,返回失败.
70x23银幕状态查询命令.
银幕关闭状态返回失败,银幕打开状态返回成功.
80xf0版本号查询命令.
返回设备信息.
90xf1查询服务器状态命令.
设备存在,返回成功;否则返回失败.
100xf2系统自检命令.
设备正常,返回成功;否则返回失败.
H.
4.
3命令返回H.
4.
4命令返回数据结构命令返回采用的数据结构为:AA55+命令返回值长度+0x00+命令返回值+0xFF.
H.
4.
4.
1命令返回值长度8比特的低字节整数描述命令的长度.
命令返回值的长度包含开始值0x00和结束值0xFF.

H.
4.
4.
2命令返回值命令返回值采用8比特值或字符串表示.
影院自动化控制设备命令返回值详细描述见表.
影院自动化控制设备命令返回值见表H.
2.
表H.
2影院自动化控制命令返回值序号命令返回值功能备注10x00返回失败.
命令返回值长度是0x03.
20xff返回成功.
命令返回值长度是0x03.
3字符串返回控制器版本等信息命令返回值长度根据返回字符串长度确定.
GY/T247—201164II附录I(规范性附录)TMS数据主动上报通信协议I.
1概述本附录定义了TMS主动将数据上报到数据接收系统的通信协议.
TMS通过互联网把数据上报到指定的数据接收系统.
数据接收系统在接收数据后可以对数据进行汇总和整理.

I.
2连接方式TMS和数据接收系统采用HTTPS协议进行通信.
TMS使用HTTP协议中的POST方式发送数据到数据接收系统.
TMS通过互联网和数据接收系统建立连接后,进行的通信遵守"请求-回复"的握手协议.

I.
3通信流程TMS使用HTTPS协议和数据接收系统建立连接,在连接建立以后TMS将准备上报的数据采用HTTP协议中POST方式上报到数据接收系统,数据接收系统接收到TMS上报的数据后返回数据上报成功报文,否则返回数据上报失败报文.
流程如下:图I.
1TMS数据主动上报通信流程连接确认提交数据请求数据接收确认连接请求TMS数据接收系统发起建立HTTPS连接请求确认建立HTTPS连接将数据通过POST方式提交接收数据,并确认确认数据平台接收到数据GY/T247—201165I.
4数据上报报文TMS上报数据到数据接收系统中的报文采用XML格式.
XML结构如下:上报报文中仅包含一个data_text元素,元素内容为上报数据的XML字符串.
data元素属性theatercode为影院编码.
I.
5数据上报返回报文I.
5.
1数据上报成功返回报文成功返回值描述如下:I.
5.
2数据上报失败返回报文失败返回值描述如下:返回值报文中仅包含一个error元素,元素内容为上报数据失败原因字符串.

GY/T247—201166JJ附录J(规范性附录)TMS数据查询响应通信协议J.
1概述本附录定义了TMS根据数据查询系统的查询条件将查询到的数据上报到数据查询系统的通信协议.

TMS运行后一直等待数据查询系统的查询指令,当数据查询系统发出查询指令并被TMS接收以后,TMS根据查询条件获得数据,并把数据上报到数据查询系统.
J.
2连接方式TMS和数据查询系统之间采用HTTPS协议进行通信.
TMS使用HTTP协议中的POST方式发送数据到数据查询系统.
TMS通过互联网和数据查询系统建立连接后,进行的通信遵守"请求-回复"的握手协议.

J.
3通信流程TMS运行后与数据查询平台建立HTTPS连接,等待数据查询平台发出查询条件,并保持该连接直到TMS关闭.
从建立HTTPS连接开始,TMS每隔一定时间间隔周期性向数据查询平台进行一次获取查询条件请求.

如果接收到查询条件,则停止获取查询条件请求的监测,并根据查询条件获得数据后采用HTTP协议中POST方式上报到数据查询系统;数据查询系统在接收到TMS上报的数据以后返回数据上报成功报文;否则返回数据上报失败报文.
TMS发送完毕后将恢复周期性的监测.
流程如下GY/T247—201167图J.
1TMS数据查询响应通信流程J.
4获取查询条件报文TMS通过该报文获得数据查询平台查询数据的限制条件.
XML结构如下:查询报文中仅包含一个getqueryinfo元素,属性theatercode为影院编码.
J.
5安全日志查询条件返回报文J.
5.
1成功返回值连接确认提交请求返回请求连接请求TMS数据查询系统发起建立HTTPS连接请求确认建立HTTPS连接获取数据查询系统中的查询数据请求返回查询数据请求如果获得查询条件则根据查询条件获得数据,并通过POST方式提交提交数据请求数据接收确认接收数据,并确认确认数据平台接收到数据GY/T247—201168成功返回值描述如下:返回值报文中response元素中query_type属性用来描述查询内容类型(NULL、SECURITY_LOG).

如果query_type属性为NULL,返回值中不包含queryinfo元素和auditorium_list元素.

如果query_type属性不为NULL,返回值中包含一个queryinfo元素和一个auditorium_list元素.