华为与大洋媒资系统接口规范(V2)

《华为与大洋媒资系统接口规范(V2)》由会员分享，可在线阅读，更多相关《华为与大洋媒资系统接口规范(V2)（28页珍藏版）》请在装配图网上搜索。

1、华为与大洋媒资系统接口说明书（V2）拟制:华为，中科大洋日期：2008-10-14审核:日期：审核:日期：批准:日期：2008年11月修订记录日期修订版本CR号修改章节修改描述作者2008-10-141.0初稿初稿完成朱小荣2008-10-241.1讨论稿与大洋崔玉祥讨论后, 作如下修改:1. VOD删除的ADI描述中, 如果在段中出现VERB=”DELETE”标记，也认为是删除操作。2. 修改BMS向媒资系统的通知接口3. 修改搜索字段中的分隔符，有“;”修改为“,”4. 删除BMS下载海报失败，向媒资返回失败的描述，主要原因是影片也属于资产，但注入失败时没有相同的处理，所以海报下载失败不通

2、知，由人工保证。朱小荣2008-10-31增加约束：1. 由于目前BMS和大洋约定节目只能全部删除,所以Verb=”DELETE”只有出现在package中才认为是删除; 出现在其它的Asset段中认为操作错误.2. 修改大洋中的状态描述”下载成功”改为”注入成功”.3. 删除WebPublish中的notifyTo字段，约定大洋媒资公司的Provider_ID必须为“”，BMS根据此标记配置通知地址，作此变更的原因主要是考虑升级处理，否则现网局点中无法得到Provider_ID，将无法进行升级。4. BMS必须保证媒资提供数据的完整性，因此BMS中不能修改节目的片花、海报、以及注入格式等信息

3、。朱小荣2008-11-71. 调整Asset_ID的长度为40位, 且其取值范围修改为“字母、数字和_”。不要求是ADI规范中的前4个字母，后16位数字2. BMS删除动作Verb=”DELETE”的处理忽略大小写要求。朱小荣2008-11-25接受以前所作的修改修改了Creation_Date和ProduceDate的取值格式说明将Provider字段在Title段中依然保留，但是修改了该字段的名称及含义，名称修改为“VODProvider”，第二语种字段为“VODProvider_FG”，表示影片的提供商，对于普通影片和子集而言，该字段可以任意填写，而对于广告而言，字段表示谁是广告主。在

4、Title段中增加“License_Window_Start”和“License_Window_End”两个字段在Title段中增加“Propagation_Priority”字段，表示VOD的推荐星级，目前不处理全文修改isRecommend的字段命名，首字母用大写表示。修改NewFlag和IsRecommend两个字段的取值范围，原来使用1和0来表示是和否，修改为用Y和N来表示。1. 增加对Content Value的取值约束，限制为字母、数字、半角“-”和半角“.”。朱小荣2009-02-25修改Title段中“Propagation_Priority”字段的描述信息温健2011-4-2

5、7合入吉林ADI需求修改，增加父集和内容与栏目自动绑定胡子付2011-4-27Provider_IDAsset_ID增加对“_”的限制增加返回码0x05ff0006胡子付2011-05-31将DirectorName、DirectorName_FG、Actors_Display、Actors_Display_FG 最大长度修改为128胡子付.华为与大洋媒资系统接口说明书（V2）关键词：BMS、VOD、EPG摘 要：本文详细描述了华为BMS系统与大洋媒资系统接口，包括对接方式和接口说明。缩略语清单：缩略语 英文全名中文解释VODVideo On Demand视频点播BMSBusiness Man

6、agement System业务管理系统EPGElectronic Program Guide电子节目指南目录修订记录21简介62接口说明62.1接口约束6增加VOD节目10修改节目信息1111删除VOD节目12122.2数据类型说明1313ADI描述文件说明1313AMS描述参数说明13132.3接口参数说明192019创建节目元数据的取值约束2020删除VOD节目元数据的取值约束2222修改节目信息元数据的取值约束22223附录23233.1系统升级兼容性考虑2323现有局点的状况232423升级处理24243.2BMS系统返回值说明24243.3接口的WSDL定义2525媒资通知BMS的

7、SOAP接口25251.接口原型25252.SOAP定义2626BMS通知媒资系统的SOAP接口26261.接口原型26261）BMS通知媒资下载完成26262）BMS删除VOD后，通知媒资修改节目状态27272.SOAP定义2727ADI描述文件样例2727华为BMS与大洋媒资系统消息接口1 简介华为BMS与大洋媒资系统的接口遵循ADI 1.1规范，资产数据（元数据XML、正片、片花、海报等）采用FTP方式传输，系统间消息采用WebService方式进行通信。2 接口说明2.1 接口约束 本文中如果不作特殊说明，则时间采用24小时制。 所有的字符必须是UTF-8格式，对于中文，一个汉字以3个

8、字节计算，对接时请注意；其他语种也需要字节问题。 本文中如果不作特殊说明，默认规则为：返回消息中，如果操作成功则返回为0，其它整数表示错误原因，具体可以参考3.1BMS系统返回值说明。 为保证消息处理正确，媒资应该将资产文件、描述文件都上载到FTP服务器上之后，再向BMS系统发送消息。 为描述方便，媒资中节目的状态定义如下：n 未发布：媒资中新生成的节目默认都是这个状态，该状态用于提示操作员这是一个全新的节目。n 发布成功：VOD系统已经提交下载请求并且成功将节目元数据写入到VOD系统，当节目处于该状态后，媒资修改节目元数据时都必须同步通知VOD系统。n 注入成功：VOD系统已经成功注入了节目

9、的元数据和节目资产，当节目处于该状态时，媒资修改节目元数据必须同步通知VOD系统n 已下架：VOD系统自行删除了注入成功的节目，该状态与“未发布”类似，主要作用是通知工作人员该节目已经在VOD系统注入过了。注：以上四种状态可以通过媒资软件实时修改。 BMS系统对ADI描述文档中的字段作严格校验，如果BMS遇到字段校验不通过则立即向媒资系统返回失败，并提供详细的失败原因；媒资操作员在媒资系统中查询时，展示相关失败原因并作适当处理。n ADI描述文件中，如果是创建节目，则某些标记为“M”的字段必须提供，具体可以参见后文的描述（2.3.1创建节目元数据的取值约束）；如果是修改节目元数据，则媒资应将需

10、要修改的字段及其取值传入（未传入的字段BMS将认为不需要修改；传入了字段名但取值为空时，BMS认为是清空取值），对于标记为R的字段BMS将忽略其取值。 从媒资系统过来的ADI描述文件只包括一个节目的描述信息，BMS根据Provider_ID和package的Asset_ID来检索一个节目，并以此作为外键（下文统一以外键来指代该联合索引）；其余ADI的Asset的外键用Prover_ID与各自的Asset_ID联合表示并存储在BMS系统中，因此媒资必须保证Provider_ID与各个Asset_ID组成的键值全局唯一。 BMS系统分析ADI文档：如果根据外键不能在BMS系统中索引到节目，且pac

11、kage的Asset没有被标记Verb=”DELETE”（大小写不敏感，后文不再描述），则认为本次是新增节目。n 媒资系统通知VOD系统创建节目时，描述文件中必须至少包含一个“movie”型的Asset，否则BMS认为创建非法。 BMS系统分析ADI文档：根据外键在BMS中能够索引到节目，并且ADI描述文件中package的Asset标记了动作Verb=”DELETE”，则认为本次操作是删除节目。媒资系统通知VOD系统创建节目时，描述文件中除连续剧父集无需要“Movie”型的Asset外，其它类型必须至少包含一个“movie”型的Asset，否则BMS认为创建非法。创建节目元数据是一个事务，更

12、新子父集绑定关系和更新栏目发布关系这两个处理不在同一个事务中，即使后两步处理失败了，也不影响创建元数据。修改节目元数据是一个事务，更新子父集绑定关系和更新栏目发布关系这两个处理不在同一个事务中，即使后两步处理失败了，也不影响修改元数据。只能对VOD和父集更新栏目发布关系，只能对子集更新子父集关系创建VOD或连续剧子集时，设置展示域和分发域为所有运营域，不需要配置项配置，从大洋过来的VOD会默认给他配置展示域和分发域为所有运营域 创建VOD或连续剧子集时，BMS通过“维护VOD默认服务”页面设置所需要添加的服务，如果存在服务，那么展示域对应的服务即为设置的默认服务，如果服务不存在，展示域信息表中

13、不存在数据。n BMS与大洋媒资约定不能进行节目中单个资产的修改，如果在除package类型外的Asset中出现了Verb动作且取值不为空字符串则BMS认为不支持该操作，向媒资返回失败。n 如果BMS根据外键不能在内部查找到对应节目，即媒资要求BMS删除一个不存在的节目，BMS也认为操作成功，但BMS不会作任何实际操作。 BMS系统根据外键能够查找相应节目，并且ADI描述文件中package没有被标记动作VERB=”DELETE”，则认为本次是修改节目信息的操作。n 对于修改操作，无论描述文件中是否描述了Asset资产，BMS都只更新元数据，忽略资产的变更，即媒资系统不能通过修改节目信息的接口

14、实现资产变更（包括：海报、片花和正片）的功能。n 媒资系统提供的节目元数据（Title的Asset段的数据）可以在BMS中进行任意修改（特定字段除外，由BMS自行决定）；但是如果媒资系统此后再次修改元数据（即通过修改节目的操作），则会覆盖BMS中已经修改的数据。需要双方统一口径并引导局方。n 媒资提供的节目在BMS中必须保持节目数据的完整性，即BMS不能修改VOD的海报、以及片花。n BMS不能删除媒资提供的各种格式的VOD资产，但是允许BMS操作员指定是否需要为movie或preview的资产进行加扰。 媒资系统向BMS系统发送节目信息修改的前提是：该节目状态为“发布成功”或“注入成功”，即

15、节目已经发布到BMS系统并且在BMS系统中未删除时才同步通知VOD系统。n 当BMS删除节目并向媒资系统发送删除通知，但是由于网络原因，媒资系统并没有收到（而操作员也没有立即发现该异常情况），如果媒资中修改节目信息并向BMS发送修改请求，那么BMS会认为是创建节目的请求，由此产生的问题媒资与BMS均不能正确处理，考虑到这种情况出现的几率很低，引导局方的媒资操作员及时修改媒资系统中节目的状态，由BMS操作员处理该节目的删除消息。 BMS中删除节目数据时，会向媒资发送相关消息，媒资是否同步删除由媒资决定，如果不同步删除则媒资将节目的状态改为“已下架”；BMS不关心媒资的处理。n 如果BMS已经接收

16、过媒资删除消息（即删除操作已经由媒资发起），则BMS中删除该节目时，不应向媒资发送删除消息；但是BMS删除一个媒资中并不存在的节目的话，媒资系统也应该回复成功消息。 媒资系统中删除节目时，如果该节目状态为“发布成功”或“注入成功”（即BMS中有该节目）才同步通知BMS系统删除操作，其他状态媒资只做内部处理。 FTP服务器上的中间数据由媒资负责维护。媒资系统将内容资产存放到FTP服务器上后，华为BMS系统作为客户端登录该服务器获取资产；媒资系统负责删除FTP服务器上的内容。因此，BMS操作员将注入成功的资产取消注入后，如果再次重新注入则系统不能保证成功。双方约定媒资只有在收到“注入成功”的消息后

17、才能动删除FTP上的文件。n BMS向媒资发送注入成功的条件：节目下所有资产均处于注入成功状态，包括“片花”的所有格式、正片的所有格式。海报下载成功与否不影响“注入成功”消息的发送。如：某节目有正片两种格式，先注入其中一个格式，成功后再取消注入；然后注入另外一种格式，此时不认为该节目注入成功。只有在所有字资产均注入成功之后，才向媒资系统发送“注入成功”消息。 对一部影片多种媒体格式的处理说明，根据媒资管理系统上的能力分为：n （1）如果媒资系统中可以管理一部影片的多种媒体格式之间的关联关系，u 媒资系统在新建影片信息时，通过描述多个“movie”型的ASSET来表示多格式，媒资系统应该保证每个

18、“movie”的Asset都有全局唯一的“Asset_ID”，并且详细给出各个格式的编码格式描述（描述字符串在下文给出）以及封装格式。u 媒资系统应该保证同一个节目中，各个“movie”型的Asset之间，“CodeFormat”和“HDContent”的组合唯一。同一个节目中的片花也有相同要求。即：一个节目中如果有两个为MPEG-2的“movie”型资产的话，那么HDContent一定分别是“Y”和“N”，表示高清的MPEG-2和标清的MPEG-2资产；而如果一个节目中同时有两个HDContent取值为“Y”的“movie”型资产，那么这两个资产的CodeFormat的取值一定不能相同。n

19、（2）如果媒资系统中不管理一部影片的多种媒体格式之间的关联关系，对同一部影片的不同媒体格式都是独立管理的，那么BMS中也将把不同媒体格式作为独立影片来管理，但是媒资系统也需要对每种格式的ASSET描述其编码格式以及封装格式。n 如果采用（1）的处理，则用户在EPG上使用浏览点播影片列表时，对于两种媒体格式影片都能点播的情况下，只展示一条影片信息；而如果采用（2）的处理，则用户在EPG上使用浏览点播影片列表时，对于两种媒体格式影片都能点播的情况下，会展示两条影片信息。 媒资系统在向BMS发送消息失败的情况下（仅限于网络不通以及等待回复消息超时两种情况），媒资系统会在5秒后重试一次（为媒资必须保证

20、重发的消息与初始消息一样。防止出现这样的情况：BMS已经收到消息但是回复超时，媒资重发的消息被BMS理解为新创建节目），如果重试还失败则不再发送，终止发布流程。 BMS向媒资系统的回复消息（即调用返回消息），不需要提供重发机制。但是BMS主动向媒资系统发送的通知消息需要有重试机制（也可由操作员手工触发），通知消息目前有两个：BMS注入节目全部成功，向媒资系统通知注入成功的消息；BMS删除节目，向媒资系统发送删除消息的通知。2.1.1 增加VOD节目流程说明：1. BMS接收到媒资系统发出的消息后（该消息的形式在后文描述），首先从FTP服务器中获取ADI描述文件，并进行解析。2. BMS分析AD

21、I描述文件，判断当前是创建操作。2.1 BMS分析ADI描述文件结构，如果文档结构或语法错误，则直接返回失败，退出创建过程；如果ADI描述文件中不含“movie”型的Asset，则认为该节目无资产，不能创建，向媒资系统返回失败，并提供错误原因，退出创建过程；否则继续创建过程。2.2 BMS分析ADI描述文件中给出的节目元数据字段的取值并校验，如果关键字段缺少或者有字段取值非法，则向媒资系统返回失败，并提供详细的错误原因供媒资操作员人工干预的参考，BMS退出创建过程；否则继续创建过程进入下一步。3. BMS将媒资给出的节目元数据转换为内部数据结构入库，并通知媒资将节目状态更改为“发布成功”。4.

22、在BMS操作员进行相关查询时，展示该节目的信息，操作员可以对节目进行定价和发布到栏目下，并注入资产，由VOD服务器到FTP服务器上获取资产。5. 操作员在BMS上进行操作，对媒资系统给出的资产进行注入操作。节目下所有资产（同时保证片花也注入成功）全部注入成功后，BMS向媒资系统发送资产注入成功的消息，媒资系统接收到该消息后，将媒资中该节目的状态更改为“注入成功”。6. BMS向媒资发送“注入成功”消息时，不校验海报是否已经下载成功。2.1.2 修改节目信息流程说明：1. BMS接收到媒资系统发出的消息后，首先从FTP服务器中获取ADI描述文件，并进行解析。2. BMS分析ADI描述文件，并根据

23、外键在BMS中索引到节目已经存在。2.1 BMS分析ADI描述文件结构，如果ADI描述文件结构或语法出现错误，则向媒资系统返回失败及原因，退出修改过程；否则继续修改过程进入下一步。2.2 BMS分析ADI描述文件中给出的节目元数据字段的取值并校验，如果必选字段缺少或者有字段取值非法，则向媒资系统返回失败详细的错误原因，退出修改过程；否则继续修改过程进入下一步。3. BMS将媒资给出的节目元数据直接入库。BMS中修改操作可以在任何情况下进行。但是标记为”R”的字段在修改时BMS自动忽略（具体参见2.3.3修改节目信息元数据的取值约束中的描述），不允许修改。4. BMS同步修改完成后消息返回，回复

24、大洋媒资系统节目元数据信息已经发布成功。注：BMS根据ADI描述中的Provider_ID和package的ID来索引待修改的节目。描述修改数据的ADI描述中提供了title的Asset_ID，BMS不要求此ID与创建时ADI描述中给出的title的ID一致。放松此限制主要也是为了兼容以前的版本。但是建议媒资也保存创建节目时存储的title的Asset_ID，以便将来新增功能时使用。在使用新的媒资接口时，BMS将这些信息都要予以保存。2.1.3 删除VOD节目流程说明：1. BMS接收到媒资系统发出的消息后，从FTP服务器中获取ADI描述文件，并进行解析。2. BMS分析ADI描述文件，如果p

25、ackage被标记了Verb=”DELETE”，则认为当前是删除节目属性的操作。2.1 BMS分析ADI描述文件结构，如果ADI描述文件结构或语法出现错误，则返回失败，退出删除过程。2.2当BMS判断出当前是删除节目的操作时，不再校验ADI描述文件中的字段取值是否合法。2.3如果删除外键在BMS中不存在的节目，BMS也认为成功。3. BMS判断出是删除操作后，立即向媒资系统返回成功，但是BMS并不立即删除节目数据。4. BMS中删除节目由操作员进行，当该节目（元数据和资产文件）被删除后（节目与片花之间的关系由BMS内部保证），BMS通知媒资该节目被删除，由媒资系统负责更新状态。4.1 如果媒资

26、系统已经通知BMS节目删除，则BMS不向媒资系统发送删除通知消息。2.2 数据类型说明2.2.1 ADI描述文件说明当媒资提供的ADI描述文件传入的是父集时，必须包含package、title这两个Asset，poster和preview可选，忽略movie所代表的Asset；当ADI描述其它格式（影片、子集、广告）时，必须包含package、title和movie三个Asset，poster和preview可选。上述各Asset中，package、title和poster最多出现一次；preview和movie可出现多次，表示使用多格式。各个Asset中Content 的Value的取值范围

27、为字母、数字、半角“-”和半角“.”。这样限制主要是防止在跨系统FTP获取文件时，由于编码问题导致获取文件失败。2.2.2 AMS描述参数说明AMS的属性沿用ADI中的字段，BMS不作扩展。参数名称类型长度描述信息Asset_NameString=50资产名称，BMS不处理该属性ProviderString=384供应商的名称，BMS获取后作为节目的提供商属性。BMS不处理该属性。该字段在ADI中多次出现，媒资必须保证一致，如果媒资取值出现不一致，那么BMS取媒资所给描述中的任何一个都认为合法。大洋媒资系统的取值默认为“DayangMAM”。ProductString=20BMS不处理该属性.

28、Version_MajorInt主版本号，BMS不处理该属性.Version_MinorInt细版本号，BMS不处理该属性.DescriptionString对于package的描述。BMS不处理该字段。Creation_DateString=10资产的创建时间，格式为yyyy-mm-dddd-MM-yyyy，BMS不处理该属性。Provider_IDString=20节目供应商的ID。要求ID使用字母、数字以及半角“.”组成。该字段在ADI中多次出现，媒资必须保证一致。BMS取媒资所给描述中的任何一个都认为合法。大洋媒资系统对此ID的取值默认为“”。Asset_IDString=40资产的I

29、D，BMS采用该Provider_ID和该Asset_ID联合作为节目的外键。ADI规范中要求的取值为前4位字母，后16位数字，在本接口中只要求ID使用“字母、数字以及_”组成即可，并且长度放宽到40位，以方便升级。但是在新开局中推荐按照ADI规范设置，但BMS不作强制校验。Asset_ClassString=20BMS只处理的取值范围是如下（取值采用小写字母的形式）：packagemoviepreviewpostertitleTitle Asset的属性字段介绍参数名称类型长度字段描述TitleString、+、#、&、%、_、换行符（rn或n）、|、TABTitle_FGString、+、

30、#、&、%、_、换行符（rn或n）、|、TABSummary_MediumString=1024节目简介。如下符号不能出现在取值中：、|、换行符（rn或n）、TABSummary_Medium_FGString=1024华为扩展字段：节目简介的第二语种的描述。如下字符不能出现在取值中：、|、换行符（rn或n）、TABTitleSearchCodeString=128华为扩展字段：片名搜索代码（只允许输入数字、英文字母），多个片名搜索码时用“,”分隔。用于EPG中用户根据影片名称来检索影片。SupplyLangString、+、#、&、%、_、换行符（rn或n）、TABProduceDateSt

31、ring=10华为扩展字段：影视公司的出品日期（yyyy-mm-dddd-MM-yyyy）DirectorNameString、+、#、&、%、_、换行符（rn或n）、TABDirectorName_FGString、+、#、&、%、_、换行符（rn或n）、TABDirectorSearchCodeString=128华为扩展字段：导演搜索代码（只允许输入数字、英文字母），多个导演时用“,”分隔。Actors_DisplayString、+、#、&、%、_、换行符（rn或n）、TABActors_Display_FGString、+、#、&、%、_、换行符（rn或n）、TABActorSear

32、chCodeString=128华为扩展字段：主演搜索代码（只允许输入数字、英文字母），多个主演时用“,”分隔Propagation_Priorityint推荐指数。ADI规范中定义其取值范围是1-10，1最高，10最低；但是BMS定义取值范围是1-6，1-表示5颗星的推荐，2表示4颗星的推荐；以此类推，而6表示没有星级推荐，该字段如果不填充则默认为6。BMS目前不处理该字段。VODProviderString、+、#、&、%、_、换行符（rn或n）、TABVODProvider_FGString、+、#、&、%、_、换行符（rn或n）、TAB大洋媒资默认取值为“DayangMAM”Super

33、VodIDString华为扩展字段。当影片类型为影片、父集、广告时，本字段无效，BMS忽略其取值。当影片类型为连续剧子集时，传入父集的package的Asset_ID。保留字段。固定取值为“0”IsSitcomint华为扩展字段，表示了点播内容的类型：0：影片；1：连续剧父集2：连续剧子集；4：广告。SitcomNumInt华为扩展字段：连续剧集数，对于连续剧子集，存储集号，取值范围1100000；其它类型节目时，BMS忽略其取值。isRecommendIsRecommendStringInt=1华为扩展字段：是否强档推荐（N0-不是, 1Y-是）Subject_IDsString=4094华

34、为扩展字段：该内容所在栏目的编号，可以发布在多个栏目下，栏目编号之间使用分号隔开。Suggested_PriceString参考价格，范围-21474836.4721474836.47,价格单位：元此处的价格是笼统的一个参考价格，不区分媒体格式定价时有效。NationalString、+、#、&、%、_、换行符（rn或n）、TABNational_FGString、+、#、&、%、_、换行符（rn或n）、TABNewFlagStringInt=1华为扩展字段：节目是否有NEW标签：N0否；Y1是。Licensing_Window_StartString=19节目生效的开始时间，字符串格式有如下

35、三种形式：yyyy-mm-ddyyyy-mm-ddThh:mm:ssyyyy-mm-ddThh:mm该字段目前保留，目前BMS不处理，也不校验其取值。Licensing_Window_EndString=19节目生效的结束时间，字符串格式有如下三种形式：yyyy-mm-ddyyyy-mm-ddThh:mm:ssyyyy-mm-ddThh:mm该字段目前保留，目前BMS不处理，也不校验其取值有效性。Preview Asset的描述参数名称类型长度描述信息Run_TimeString=8片花的时长，格式为“hh:mm:ss”，BMS内部进行时间转换后供存储。HDContentString=2是否高

36、清节目：Y-高清节目；N-普通节目Bit_RateInt码率（单位为kbps），取值范围11000000。FileFormatString=48华为扩展字段：点播文件的封装格式。当前取值固定为MPEG_2_TRANSPORT，但是不排除将来可扩展出3GPP、ISMA等格式。CodeFormatString=16华为扩展字段：媒体文件编码格式，目前取值为：MPEG-2H.264EncryptionString=1该字段表示媒资是否要求BMS对资产进行加密处理，要求媒资对片花部分填充为不加密：N：不加密；Y：加密。Movie Asset的描述参数名称类型长度描述信息Asset_NameString

37、=384资产的名称，华为BMS不处理该字段。Run_TimeString8资产的时长，格式为“hh:mm:ss”HDContentString=2是否高清节目：Y-高清节目；N-普通节目Bit_RateInt码率（单位为kbps），取值范围11000000。FileFormatString=48华为扩展字段：点播文件的封装格式，当前取值固定为MPEG_2_TRANSPORTCodeFormatString=16华为扩展字段：媒体文件编码格式：取值为：MPEG-2H.264EncryptionString=1该字段表示媒资是否要求BMS对资产进行加密处理，目前媒资默认要求不加密：N：不加密；Y：

38、加密。Poster Asset的描述华为BMS系统对于海报的处理参照ADI1.1规范使用，不进行扩展。2.3 接口参数说明接口函数的参数通过ADI描述文件交换的。接口参数的约束限定如下：M为必须输入；O为可选输入，根据系统中当时的上下文情况进行校验；R为无需输入，即使传入也忽略其处理；-的意义是：无论有没有该字段标签，BMS都不处理，不取该字段值。BMS接受媒资系统的ADI描述文件，媒资系统需要处理BMS的处理返回消息，对于BMS处理失败的情况予以记录，并能够提示给操作员进行处理。2.3.1 创建节目元数据的取值约束当BMS在系统内根据媒资ADI描述文件中数据进行外键检索，如果没有则认为是创建

39、操作，对于各字段的处理原则如下：参数名称影片IsSitcom=0父集IsSitcom=1子集IsSitcom=2广告IsSitcom=4节目元数据TitleMMMMTitle_FGOOOOSummary_MediumOOOOSummary_Medium_FGOOOOTitleSearchCodeMMOOSupplyLangMMMMProduceDateOOOODirectorNameMMMODirectorName_FGOOOODirectorSearchCodeMMOOActors_DisplayOOOOActors_Display_FGOOOOActorSearchCodeOOOOProp

40、agation_PriorityOOOOVODProviderOOOMVODProvider_FGOOOOSuperVodID-O-IsSitcomMMMMSitcomNum-MM-Subject_IDsOO-IsRecommendMMMOSuggested_PriceMMMMNationalMMMMNational_FGOOOONewFlagMMMMLicensing_Window_StartOOOOLicensing_Window_EndOOOO片花Run_TimeMMM-HDContentMMM-Bit_RateMMM-FileFormatMMM-CodeFormatMMM-Encryp

41、tionMMM-MOVIERun_TimeM-MMHDContentM-MMBit_RateM-MMFileFormatM-MMCodeFormatM-MMEncryptionM-MM海报不扩展2.3.2 删除VOD节目元数据的取值约束功能描述BMS校验出当前是删除操作后，不再校验其它字段取值，记录该消息后直接向媒资系统返回成功，然后BMS内部根据外键检索节目元数据进行相关处理。2.3.3 修改节目信息元数据的取值约束功能描述：当BMS判断当前是修改操作，并且外键检索能够在BMS中查找到相关的节目数据，则认为本次是修改操作。BMS根据如下原则来接纳数据。与媒资系统进行约定，媒资系统更新数据时，

42、将需要修改的属性传入，如果不传入则认为不修改该字段。媒资传入的属性如果是下面标记为“R”的字段BMS系统忽略处理，其余字段进行覆盖。参数名称Vod0父集1子集2广告4节目元数据TitleOOOOTitle_FGOOOOSummary_MediumOOOOSummary_Medium_FGOOOOTitleSearchCodeOOOOSupplyLangOOOOProduceDateOOOODirectorNameOOOODirectorName_FGOOOODirectorSearchCodeOOOOActors_DisplayOOOOActors_Display_FGOOOOActorSea

43、rchCodeOOOOPropagation_PriorityOOOOVODProviderOOOOVODProvider_FGOOOOSuperVodID-O-IsSitcomRRRRSitcomNum-OO-Subject_IDsOO-IsRecommendOOOOSuggested_PriceOOOONationalOOOONational_FGOOOONewFlagOOOOLicensing_Window_StartRRRRLicensing_Window_EndRRRR片花属性不允许修改，即使出现，BMS也忽略其处理Movie属性不允许修改，即使出现，BMS也忽略其处理海报属性不允许

44、修改，即使出现，BMS也忽略其处理3 附录3.1 系统升级兼容性考虑BMS与大洋媒资在现网中已经对接了很多局点，因此必须考虑现网数据的升级。3.1.1 现有局点的状况媒资向BMS传入节目的元数据数据以及资产信息，节目的片花是由另外一个接口创建，两者之间通过clipVodID关联。片花作为节目的一个属性提供。按照ADI的规范来处理系统中的已有数据的话，则发现缺少节目的package、title、preview以及poster的关系以及描述。因此，媒资删除节目、以及BMS中节目状态改变和删除通知无法处理。3.1.2 升级处理绍兴目前尚未对接，因此无法升级时ID不能对应，需要与局方提前声明。检查现有

45、的VOD的ID（即BMS中的外部编号，为描述方便统一节目ID来描述），发现是“29B6B90E_5F5F_4365_AD4F_EFEF9FA8C8FE”的形式，是媒资内部使用的ID。因此，决定在升级以后，将该ID作为package的ID，而相关的Provider_ID就直接以固定的取值来替代（即前面约定的取值）。因为在目前的媒资和BMS中的不关心单个资产（movie、poster、title和preview），所以上述资产的ID由BMS在升级时虚拟出相关的ID进行保存，其长度设置为20位。3.2 BMS系统返回值说明错误码目前并不能考虑完全，因此开发过程中可能会讨论更新。请大洋重点关注错误原因

46、。返回码返回信息0操作成功0x05ff0001BMS内部错误0x05ff0002错误的ADI XML文档URL路径0x05ff0003ADI XML文档解析出错0x05ff0004FTP连接异常或者获取文件失败0x05ff0005Asset_ID冲突冲突的ID为0x05ff0101元素ADI/Metadata不存在0x05ff0102元素ADI/Metadata/AMS不存在0x05ff0103存在多个元素ADI/Metadata0x05ff0104存在多个元素ADI/Metadata/AMS0x05ff0201元素ADI/Asset/Metadata不存在0x05ff0202元素ADI/As

47、set/Metadata/AMS不存在0x05ff0203存在多个元素ADI/Asset0x05ff0204存在多个元素ADI/Asset/Metadata0x05ff0205存在多个元素ADI/Asset/Metadata/AMS0x05ff0301元素ADI/Asset/Asset/Metadata不存在0x05ff0302元素ADI/Asset/Asset/Metadata/AMS不存在0x05ff0303存在多个元素ADI/Asset/Asset/Metadata0x05ff0304存在多个元素ADI/Asset/Asset/Metadata/AMS0x05ff0305元素ADI/As

48、set/Asset/Content不存在0x05ff0306存在多个元素ADI/Asset/Asset/Content0x05ff0401不存在类型为movie的资产0x05ff0402存在多个相同编码格式(CodeFormat值和HDContent值的组合)的资产0x05ff0403存在多个海报资产0x05ff0404元素ADI/Metadata/AMS属性VERB值错误0x01800000参数错误（该错误统一标记了参数校验以及取值错误，具体参数名会在错误原因中给出）0x01802000BMS系统没有对接媒资系统0x05ff0006删除中，不能操作3.3 接口的WSDL定义3.3.1 媒资通

49、知BMS的SOAP接口1. 接口原型OperateResult com.huawei.dtvmw.mediaasset.soap.WebPublish.publish(String ftpPath, String adiFile, String detailParams)参数描述：参数名参数描述ftpPath保存资产文件/ADI描述文件的存放位置; 该字段必须能够标记出临时 FTP Server的路径, 登录用户名和密码,形式如: BMS在处理资产路径时，将直接使用该地址拼接上资产的ContentValue得到资产（片花、海报、影片）路径。adiFileADI描述文件的名称. 如: hero0

50、2341234.xmldetailParams该字段目前保留, 不使用。返回值描述：public class OperateResult private int returnCode;private String message;/ get/set方法略.参数名参数描述returnCode返回码。可以参见错误码描述message错误原因描述。当returnCode取值为0，表示操作成功时，本字段可以为空当returnCode取值不为0，则表示操作失败，本字段必须给出错误描述。2. SOAP定义3.3.2 BMS通知媒资系统的SOAP接口1. 接口原型1） BMS通知媒资下载完成public V

51、ODNoticeService.ParaOut downloadFinishNotice(String packageId);参数描述：参数名参数描述packageID媒资通知BMS时，ADI中的package段的Asset_ID。返回值描述：public class ParaOut private String description;private boolean success;参数名参数描述success通知消息的结果：true-成功；false-失败。description如果操作结果不为true，则媒资需要填充原因后返回。2） BMS删除VOD后，通知媒资修改节目状态public VODNoticeService.ParaOut programDeleteNotice(String packageId);参数描述：参数名参数描述packageID媒资通知BMS时，ADI中的package段的Asset_ID。返回值描述：同上。2. SOAP定义3.3.3 ADI描述文件样例增加修改删除