中华人民共和国广播电视行业标准GY/T303.3—2018
智能电视操作系统
第3部分:应用程序编程接口
SmartTVoperatingsystem
Part3:Applicationprogramminginterface2018-07-06发布
国家广播电视总局
2018-07-06实施
规范性引用文件
缩略语
接口概述
接口概述
调用机制
JAVA应用程序编程接口
WEB应用程序编程接口
附录A(规范性附录)
调谐解调模块
附录B(规范性附录)
JAVA-单向广播网络接入单元
JAVA-广播协议处理单元,
MPEG对象定义模块
DVB对象定义模块
SECTIOIN过滤模块
URL封装模块
DVB定位符模块
广播协议处理模块
附录C(规范性附录)
以太网管理模块
此内容来自标准下载网WiFi管理模块
附录D(规范性附录)
人机交互模块
附录E(规范性附录)
AV设置模块,
附录F(规范性附录)
媒体处理模块
JAVA-双向宽带网络接入单元
JAVA-人机交互单元
JAVA-AV设置单元
JAVA-媒体处理单元
GY/T303.3—2018
GY/T303.3—2018
附录G(规范性附录)
系统管理模块
OTA升级模块
存储管理模块
附录H
(规范性附录)
概述,
频道搜索模块
JAVA-系统管理单元.
JAVA-应用引擎单元
电子节目指南模块
信息搜索模块
附录I
(规范性附录)
多屏互动模块
(规范性附录)
附录J
DRM管理模块
附录K
(规范性附录)
概述:
CAS解扰模块
CAS控制模块
CAS消息模块
CAS监听器模块
附录L
(规范性附录)
调谐解调模块
(规范性附录)
附录M
JAVA-多屏互动单元
JAVA-DRM管理单元,
JAVA-DCAS管理单元,
JavaScript-单向广播网络接入单元.JavaScript-广播协议处理单元.DVB协议处理模块
附录N
(规范性附录)
JavaScript-双向宽带网络接入单元宽带网络设置模块
附录0(规范性附录)
用户输入模块
前面板输出模块
附录P(规范性附录)
JavaScript-人机交互单元
JavaScript-AV设置单元
音视频参数设置模块
:191
:288
附录Q(规范性附录)
Q.2媒体播放模块
附录R(规范性附录)
应用管理模块
附录S(规范性附录)
数据管理模块
JavaScript-媒体处理单元
JavaScript-应用管理单元
JavaScript-系统管理单元.
外部存储设备管理模块
文件管理模块。
多媒体文件模块
OTA软件升级模块.
系统工具模块
软硬件信息查询模块
附录T(规范性附录)
消息管理模块
附录U(规范性附录)
频道管理模块
JavaScript-消息管理单元,
JavaScript-应用引擎单元,
电子节目指南模块
预定提醒模块
信息搜索模块
附录V(规范性附录)
JavaScript-广播信息服务管理单元,广播信息服务管理模块
附录W(规范性附录)
多屏互动模块
附录X(规范性附录)
DRM管理模块
附录Y
(规范性附录)
DCAS模块
DCAS_APP模块
JavaScript-多屏互动单元
JavaScript-DRM管理单元
JavaScript-DCAS管理单元
GY/T303.3-2018
GY/T303.3—2018
GY/T303《智能电视操作系统》已经或计划发布以下部分:一第1部分:功能与架构:
一第2部分:安全:
一第3部分:应用程序编程接口:一一第4部分:硬件抽象接口;
一第5部分:功能组件接口:
一一第6部分:可信执行环境接口:第7部分:符合性测试。
本部分为GY/T303的第3部分
本部分按照GB/T1.1一2009给出的规则起草。本部分由全国厂播电影电视标准化技术委员会(SAC/TC239)归口。本部分起草单位:国家新闻出版广电总局广播科学研究院、国家广播电视网工程技术研究中心、华为技术有限公司、深圳市海思半导体有限公司、四川长虹网络科技有限责任公司、北京永新视博数字电视技术有限公司、深圳市苗壮网络股份有限公司、东方有线网络有限公司、创维数字技术股份有限公司、北京数码视讯科技股份有限公司、四川九州电子科技股份有限公司、中兴通讯股份有限公司、上海联彤网络通讯技术有限公司、北京赛科世纪科技股份有限公司、北京数字太和科技有限责任公司、上海兆芯集成电路有限公司、中国有线电视网络有限公司。本部分主要起草人:盛志凡、白伟、同磊、智元宝、赵良福、蒋艳山、付瑞、杨明磊、万乾荣、程伯钦、严海峰、张晶、陈亚东、李洪浩、袁宏伟、刘金晓、解伟、郭沛宇、马万铮、郭永伟、管丹东、何剑、赵学庆、王明敏、董进刚、宋勇立、丁送星、张定京、王颖、郭晓霞、王磊、曾品超、郭成、陶春、黄玲玲、梁志坚、杨波涛、李晓榕、方中华、孙明勇、汤新坤、贾庭兰、刘鹏、白鹤、谌颖、杨旭、李爽、刘江。
GY/T303.3—2018
本部分的发布机构提请注意,声明符合本部分时,可能使用涉及本部分有关内容的相关授权的和正在申请的专利如下:
标准章条号
4.1.6、4.2.6、附录F、
附录Q
4.1.11、4.2.14、附录K、
附录Y
4.1.10、4.2.13、附录J、
附录x
4.1.10、4.2.13、附录J、
附录x
一种智能电视操作系统
一种智能电视系统
专利名称
一种在智能电视操作系统中支持全媒体播放的方法及智能电视终端一种用于智能操作系统的条件接收方法和系统一种用于智能操作系统的数字版权管理(DRM)方法和系统一种支持数字版权管理(DRM)的媒体网关/终端实现方法及其设备本部分的发布机构对于该专利的真实性、有效性和范围无任何立场该专利持有人已向本部分的发布机构保证,他愿意同任何申请人在合理且无歧视的条款和条件下,就专利授权许可进行谈判。该专利持有人的声明已在本部分的发布机构备案,相关信息可以通过以下联系方式获得:
专利权利人
国家新闻出版广电总局广
播科学研究院
联系地址
北京市西城
区复兴门外
大街2号
联系人
孟祥昆
邮政编码
100866
010-86098010
电子邮箱
[email protected]请注意除上述专利外,本部分的某些内容仍可能涉及专利。本部分的发布机构不承担识别这些专利的责任。
1范围
智能电视操作系统
第3部分:应用程序编程接口
GY/T303.3—2018
GY/T303的本部分规定了智能电视操作系统应用程序编程接口的相关技术要求和详细接口定义。本部分适用于智能电视操作系统的应用开发和测试,包括JAVA应用和WEB应用两部分。规范性引用文件
下列文件对于本部分的应用是必不可少的。凡是注日期的引用文件,仅所注日期的版本适用于本部分。凡是不注日期的引用文件,其最新版本(包括所有的修改单)适用于本部分。GY/T2552012
可下载条件接收系统规范
GY/T303.1—2016
智能电视操作系统第1部分:功能与架构GY/T303.2-2016智能电视操作系统第2部分:安全GB/T4880.2—2000语种名称代码第2部分:3字母代码GB/T17975.1一2010信息技术运动图像及其伴音信息的通用编码第1部分:系统GB/T20090.22006
GB/T28160—2011
GB/T28161—2011
信息技术先进音视频编码第2部分:视频数字电视广播电子节目指南规范数字电视广播业务信息规范
IS0/IEC13522-1-2000信息技术多媒体和超媒体信息的编码(Informationtechnology.Codingofmultimediaand hypermedia information)IS0/IEC13818-1-2018信息技术移动图片和相关音频信息的普通编码第1部分:系统(GenericCodingofMovingPictures andAssociatedAudioPartl:Systems)IS0/IEC13818-6-1998信息技术移动图片和相关音频信息的普通编码第6部分:DSM-CC的扩展(Generic Coding of Moving Pictures and Associated Audio Part6: Extension for Digital StorageMediaCommandandControl)
IETFRFC791互联网协议(Internetprotoco1)IETFRFC2373IPv6寻址系统结构(IPVersion6AddressingArchitecture)ECMA-262ECMAScript语言规范(ECMAScriptLanguage Specification)3缩略语
下列缩略语适用于本部分。
App应用程序(Application)
AV音视频(AudioVideo)
CA认证机构(CertificationAuthority)CAS条件接收系统(ConditionalAccessSystem)CSS样式级联表(CascadingStyleSheets)1
GY/T303.3—2018
S可下载条件接收系统(DownloadableConditionalAccessSystem)DCAS
数字电视(Digital Television)数字版权管理(DigitalRightsManagement)DRM
数字视频广播(DigitalVideoBroadcasting)ECM
授权控制信息(EntitlementControlMessage)EMM
授权管理信息(EntitlementManagementMessage)EPG电子节目指南(ElectronicProgramGuide)基本码流(ElementaryStream)ES
超文本标记语言(HyperTextMarkupLanguage)HTML
超文本传输协议(HyperTextTransferProtocol)IPTV
IP电视(IPTelevision)
脚本语言(JavaScript)
动态图像专家组(MovingPictureExpertsGroup)MPEG
屏幕叠加显示(On-ScreenDisplay)OSD
空中升级(OverTheAir)
包识别码(PacketIdentifier)可信应用(TrustedApplication)TApp
可信执行环境(TrustedExecutionEnvironment)TEE
传送流(TransportStream)
接口概述
4.1接口概述
TVOS应用框架层所能支撑的应用分为JAVA应用和WEB应用两大类:一JAVA应用是指采用Java语言开发的应用的统称;一WEB应用是指采用HTML、JavaScript、CSS等Web技术开发的应用的统称。TVOS应用框架层实现JAVA应用和WEB应用与功能组件模块的封装适配。本文档定义的应用程序编程接口为应用层的JAVA应用和WEB应用提供了统一的应用程序编程接口,为TVOS应用开发者开发JAVA应用和WEB应用提供参考。
本部分定义的接口符合GY/T303.1—2016和GY/T303.2—2016的相关要求。4.2TVOSJAVA应用程序编程接口
4.2.1TVOSJAVA应用程序编程接口概述TVOSJAVA应用程序编程接口以Java对象的方式提供调用接口,支撑应用实现电子节目指南、频道列表、电视节目播放等数字电视相关业务功能。JAVA应用程序编程接口共由11个功能单元组成,包括单向广播网络接入单元、广播协议处理单元、双向宽带网络接入单元、人机交互单元、AV设置单元、媒体处理单元、系统管理单元、应用引擎单元、多屏互动单元、DRM管理单元和DCAS管理单元。4.2.2单向广播网络接入单元
4.2.2.1单向广播网络接入单元概述单向广播网络接入单元用于实现单向广播网络接入功能,包括调谐的频率、调制方式、符号率等参数控制及信号强度和质量等信息的获取。该单元定义了调谐解调模块。Java接口详细定义见附录A。2
调谐解调模块
GY/T303.3—2018
调谐解调模块定义了调谐和解调用到的接口、类和异常,包括调谐参数定义、Tuner对象定义、调谐解调管理类等,通过这些定义实现了调谐解调功能。调谐解调模块概要见表1。
对象名
DeliverySystemType
TuningParameters
TuningListener
DvbcTuningParameters
AbsssTuningParameters
DtmbTuningParameters
TunerEvent
TunerTuningEvent
TunerTuningOverEvent
TunerManager
TunerException
IncorrectLocatorException
StreamNotFoundException
TuningParameterNotFoundException4.2.3广播协议处理单元
4.2.3.1广播协议处理单元概述
调谐解调模块概要
DVB技术体系下的传送系统类型常量定义,调谐解调参数接口。
网络接口事件监听器接口,提供了网络接口相关事件处置的回调方法。
适用于DVB-C传送系统的调谐解调参数类。适用于ABS-SS传送系统的调谐解调参数类。适用于DTMB传送系统的调谐解调参数类调谐解调器事件类。
网络接口开始调谐事件,继承TunerEvent类。结束调谐事件,继承TunerEvent类。调谐解调控制接口。
调制解调管理器类,用于跟踪连接到接收设备的广播网络接口,是调谐解调单元的入口类。网络接口异常。
定位符格式不正确异常,继承TunerException类流未发现异常,继承TunerException类。由于传送流不在StreamTable中而导致对该传送流的引用无法被解析时,则抛出此异常。
获取当前调谐解调参数失败或者DeliverySystemType错误的时候,抛出异常
见入.2.10
见A.2.11
见A.2.12
见A.2.13
见A.2.14
见A.2.15
广播协议处理单元用于实现广播协议的处理,包括了MPEG对象定义模块、DVB对象定义模块、SECTION段过滤模块、URL封装模块、DVB定位符模块和广播协议处理模块。Java接口详细定义见附录B。MPEG对象定义模块
MPEG对象定义模块定义了MPEG-2体系下最基本的对象以及系统可能出现的异常。本模块定义的最基本的MPEG-2对象有:传送流类(TransportStream);基本流类(ElementaryStream)一广播业务类(Service):
定义的MPEG-2异常有:
GY/T303.3—2018
一广播内容未授权异常(NotAuthorizedException):资源异常(ResourceException);调谐解调异常(TuningException)MPEG对象定义模块概要见表2。
MPEG对象定义模块概要
对象名
NotAuthorizedInterface
TransportStream
ElementaryStream
Service
NotAuthorizedException
TuningException
ResourceException
4.2.3.3DVB对象定义模块
广播内容未授权报告接口,定义了失败原因常量,提供了查找失败原因的方法。
MPEG-2传送流类,代表一个MPEG-2传送流(TS),提供了获取传送流信息的方法。
MPEG-2基本流类,代表一个在传送流(TS)中承载的基本流(ES),提供了获取基本流信息的方法。MPEG-2业务类,代表一个在传送流中承载的MPEG-2业务,提供了获取业务信息的方法
广播内容未授权异常,实现NotAuthorizedInterface接口,当访问无授权的加扰数据时抛出。
调谐解调异常,当调谐解调失败时抛出。资源异常,当因资源缺乏而无法进行操作时抛出。DVB对象定义模块定义了DVB体系下的MPEG-2基本对象:-DVB传送流类(DvbTransportStream):DVB基本流类(DvbElementaryStream):-DVB广播业务类(DvbService):DVB对象定义模块概要见表3。
表3DVB对象定义模块概要
对象名
DvbElementaryStream
DvbService
DvbTransportStream
SECTION段过滤模块
DVB基本流类,代表一个在传送流(TS)中承载的符合DVB语义约束的MPEG-2基本流(ES),提供了获取DVB基本流信息的方法。DVB业务类,代表个在传送流中承载的符合DVB语义约束的MPEG-2业务,提供了获取DVB业务信息的方法。DVB传送流类,代表一个符合DVB语义约束的MPEG-2传送流,提供了获取DVB传送流信息的方法。SECTION段过滤模块提供了与MPEG-2段(section)过滤相关的类和方法。SECTION段过滤模块概要见表4。4
对象名
SectionFilterListener
Section
SectionFilterGroup
SectionFilter
SimpleSectionFilter
TableSectionFilter
RingSectionFilter
SectionFilterEvent
SectionAvailableEvent
VersionChangeDetectedEvent
EndofFilteringEvent
IncompleteFilteringEvent
TimeOutEvent
FilterResourcesAvailableEventForcedDisconnectedEvent
SectionFilterException
ConnectionLostException
FilteringlnterruptedExceptionFilterResourceException
IllegalFilterDefinitionExceptionInvalidSourceException
NoDataAvailableException
URL封装模块
SECTION段过滤模块概要
GY/T303.3—2018
段过滤事件监听器接口,提供了段过滤事件处置回调方法由应用层实现。
MPEG-2段类,描述了从传输流中过滤到的一个段
段过滤器组类,代表一个MPEG-2过滤器组,可以作为一个基本操作单元被激活和释放。
段过滤器类,该类为一组具有不同生命周期和缓存长度特点的段过滤器类的基类,提供了过滤器基本操作方法简单段过滤器类,继承SectionFilter类,表段过滤器类,继承SectionFilter类循环段过滤器类,继承SectionFilter类,段过滤事件类,一组段过滤事件类的基类。段数据可用事件,继承SectionFilterEvent类,报告过滤到了一个完整的段。
段过滤版本变更事件,
继承SectionFilterEvent类,
段过滤结束事件,继承SectionFilterEvent类,报告段过滤结束。
段过滤不完整事件,继承EndOfFilteringEvent类段过滤超时事件,继承EndofFilteringEvent类过滤器资源可用事件,继承ResourceStatusEvent类段过滤器组与传送流强制断开事件,继承ResourceStatusEvent类。
段过滤异常的基类
连接丢失异常,继承SectionFilterException类过滤中断异常,继承SectionFilterException类过滤器资源异常,继承SectionFilterException类非法过滤条件异常,继承SectionFilterException类。段数据源无效异常,继承SectionFilterException类段对象无可用数据异常,继承SectionFilterException类URL封装模块提供了URL封装的引用方法。URL封装模块概要见表5。
对象名
Locator
InvalidLocatorException
URL封装模块概要
资源定位符类,将URL封装成定位符对象。定位符无效异常。
见B.4.10
见B.4.11
见B.4.12
见B.4.13
见B.4.14
见B.4.15
见B.4.16
见B.4.17
见B.4.18
见B.4.19
见B.4.20
见B.4.21
见B.4.22
GY/T303.3—2018
DVB定位符模块
DVB定位符模块提供了访问DVB广播业务及其内容的引用方法。DVB定位符模块概要见表6。
表6DVB定位符模块概要
对象名
DvbLocator
DvbNetworkBoundLocator
广播协议处理模块
DVB定位符类,将DVB格式的URL封装成定位符对象与网络绑定的DVB定位符类,此类对象唯一标识一个给定的实体和传送系统。
广播协议处理模块定义了与DVB广播协议处理相关的类和方法。广播协议处理模块概要见表7。
表7广播协议处理模块概要
对象名
SICommonInformation
SINetwork
SIBouquet
SIService
SITransportStream
SIElementaryStream
SIEvent
SITime
SIDescriptor
SIRequest
SIRetrieveListener
SIUpdateListener
PSI/SI公共信息接口,提供了获取PSI/SI公共特性的方法。网络信息接口,提供了获取网络(network)信息的方法,每个SINetwork对象由networkid唯一标识。业务群信息接口,提供了获取业务群(bouquet)信息的方法,每个SIBouquet对象由networkid、bouquetid唯一标识。业务信息接口,提供了获取业务(service)信息的方法,每个SIService对象由network_id、original_network_idtransport_stream_id和service_id共同唯一标识。传送流信息接口,提供了获取传送流(transport_stream)信息的方法,每个SITransportStream对象由network_idoriginal_network_id和transport_stream_id共同唯一标识。基本流信息接口,提供了获取基本流elementary_stream)信息的方法,每个SIElementaryStream对象是由networkid、original_network_id,transport_stream_id、service_id和component_tag(或elementary_PID)共同唯一标识。节目事件信息接口,提供了获取事件(event)信息的方法,每个SIEvent对象由networkid、original_network_id、transport_stream_id、service_id和event_id共同唯一标识。时间信息接口,提供了获取时间信息的方法,时间信息从TDT或ToT获得,每个SITime对象由networkid唯一标识描述符信息接口,提供了与描述符访问相关的方法。PSI/SI信息请求接口,描述了应用产生的一次PSI/SI信息检索请求,应用可以通过该对象取消该次请求SI信息获取事件监听器,由应用程序实现。PSI/SI表更新事件监听器,由应用程序实现。备注
见B.7.10
见B.7.11
见B.7.12
小提示:此标准内容仅展示完整标准里的部分截取内容,若需要完整标准请到上方自行免费下载完整标准文档。