GY/T 303.3-2018 智能电视操作系统 第3部分：应用程序编程接口

GY

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

GY/T303.3—2018

智能电视操作系统

第3部分：应用程序编程接口

SmartTVoperatingsystem—

Part3:Applicationprogramminginterface

2018-07-06发布2018-07-06实施

国家广播电视总局发布

GY/T303.3—2018

目次

前言IV

引言V

1范围1

2规范性引用文件1

3缩略语1

4接口概述2

4.1接口概述2

4.2TVOSJAVA应用程序编程接口2

4.3TVOSWEB应用程序编程接口15

5调用机制23

附录A（规范性附录）JAVA-单向广播网络接入单元25

A.1概述25

A.2调谐解调模块25

附录B（规范性附录）JAVA-广播协议处理单元38

B.1概述38

B.2MPEG对象定义模块38

B.3DVB对象定义模块43

B.4SECTIOIN过滤模块45

B.5URL封装模块65

B.6DVB定位符模块66

B.7广播协议处理模块70

附录C（规范性附录）JAVA-双向宽带网络接入单元102

C.1概述102

C.2以太网管理模块102

C.3WiFi管理模块108

附录D（规范性附录）JAVA-人机交互单元115

D.1概述115

D.2人机交互模块115

附录E（规范性附录）JAVA-AV设置单元136

E.1概述136

E.2AV设置模块136

附录F（规范性附录）JAVA-媒体处理单元151

F.1概述151

F.2媒体处理模块151

I

GY/T303.3—2018

附录G（规范性附录）JAVA-系统管理单元169

G.1概述169

G.2系统管理模块169

G.3OTA升级模块184

G.4存储管理模块186

附录H（规范性附录）JAVA-应用引擎单元191

H.1概述191

H.2频道搜索模块191

H.3电子节目指南模块196

H.4信息搜索模块207

附录I（规范性附录）JAVA-多屏互动单元237

I.1概述237

I.2多屏互动模块237

附录J（规范性附录）JAVA-DRM管理单元246

J.1概述246

J.2DRM管理模块246

附录K（规范性附录）JAVA-DCAS管理单元249

K.1概述249

K.2CAS解扰模块249

K.3CAS控制模块260

K.4CAS消息模块266

K.5CAS监听器模块270

附录L（规范性附录）JavaScript-单向广播网络接入单元273

L.1概述273

L.2调谐解调模块273

附录M（规范性附录）JavaScript-广播协议处理单元288

M.1概述288

M.2DVB协议处理模块288

附录N（规范性附录）JavaScript-双向宽带网络接入单元307

N.1概述307

N.2宽带网络设置模块307

附录O（规范性附录）JavaScript-人机交互单元317

O.1概述317

O.2用户输入模块317

O.3前面板输出模块318

附录P（规范性附录）JavaScript-AV设置单元320

P.1概述320

P.2音视频参数设置模块320

II

GY/T303.3—2018

附录Q（规范性附录）JavaScript-媒体处理单元331

Q.1概述331

Q.2媒体播放模块331

附录R（规范性附录）JavaScript-应用管理单元343

R.1概述343

R.2应用管理模块344

附录S（规范性附录）JavaScript-系统管理单元349

S.1概述349

S.2数据管理模块349

S.3外部存储设备管理模块357

S.4文件管理模块359

S.5多媒体文件模块366

S.6OTA软件升级模块368

S.7系统工具模块369

S.8软硬件信息查询模块372

附录T（规范性附录）JavaScript-消息管理单元375

T.1概述375

T.2消息管理模块375

附录U（规范性附录）JavaScript-应用引擎单元377

U.1概述377

U.2频道管理模块377

U.3电子节目指南模块382

U.4预定提醒模块392

U.5信息搜索模块396

附录V（规范性附录）JavaScript-广播信息服务管理单元410

V.1概述410

V.2广播信息服务管理模块410

附录W（规范性附录）JavaScript-多屏互动单元417

W.1概述417

W.2多屏互动模块417

附录X（规范性附录）JavaScript-DRM管理单元423

X.1概述423

X.2DRM管理模块423

附录Y（规范性附录）JavaScript-DCAS管理单元426

Y.1概述426

Y.2EPGDCAS模块426

Y.3DCAS_APP模块428

III

GY/T303.3—2018

前言

GY/T303《智能电视操作系统》已经或计划发布以下部分：

——第1部分：功能与架构；

——第2部分：安全；

——第3部分：应用程序编程接口；

——第4部分：硬件抽象接口；

——第5部分：功能组件接口；

——第6部分：可信执行环境接口；

——第7部分：符合性测试。

本部分为GY/T303的第3部分。

本部分按照GB/T1.1—2009给出的规则起草。

本部分由全国广播电影电视标准化技术委员会（SAC/TC239）归口。

本部分起草单位：国家新闻出版广电总局广播科学研究院、国家广播电视网工程技术研究中心、

华为技术有限公司、深圳市海思半导体有限公司、四川长虹网络科技有限责任公司、北京永新视博数字

电视技术有限公司、深圳市茁壮网络股份有限公司、东方有线网络有限公司、创维数字技术股份有限公

司、北京数码视讯科技股份有限公司、四川九州电子科技股份有限公司、中兴通讯股份有限公司、上海

联彤网络通讯技术有限公司、北京赛科世纪科技股份有限公司、北京数字太和科技有限责任公司、上海

兆芯集成电路有限公司、中国有线电视网络有限公司。

本部分主要起草人：盛志凡、白伟、同磊、昝元宝、赵良福、蒋艳山、付瑞、杨明磊、万乾荣、程

伯钦、严海峰、张晶、陈亚东、李洪浩、袁宏伟、刘金晓、解伟、郭沛宇、马万铮、郭永伟、管丹东、

何剑、赵学庆、王明敏、董进刚、宋勇立、丁送星、张定京、王颖、郭晓霞、王磊、曾品超、郭成、陶

春、黄玲玲、梁志坚、杨波涛、李晓榕、方中华、孙明勇、汤新坤、贾庭兰、刘鹏、白鹤、谌颖、杨旭、

李爽、刘江。

IV

GY/T303.3—2018

引言

本部分的发布机构提请注意，声明符合本部分时，可能使用涉及本部分有关内容的相关授权的和正

在申请的专利如下：

序号标准章条号专利名称

15一种智能电视操作系统

25一种智能电视系统

4.1.6、4.2.6、附录F、

3一种在智能电视操作系统中支持全媒体播放的方法及智能电视终端

附录Q

4.1.11、4.2.14、附录K、

4一种用于智能操作系统的条件接收方法和系统

附录Y

4.1.10、4.2.13、附录J、

5一种用于智能操作系统的数字版权管理（DRM）方法和系统

附录X

4.1.10、4.2.13、附录J、

6一种支持数字版权管理（DRM）的媒体网关/终端实现方法及其设备

附录X

本部分的发布机构对于该专利的真实性、有效性和范围无任何立场。

该专利持有人已向本部分的发布机构保证，他愿意同任何申请人在合理且无歧视的条款和条件下，

就专利授权许可进行谈判。该专利持有人的声明已在本部分的发布机构备案，相关信息可以通过以下联

系方式获得：

专利权利人联系地址联系人邮政编码电话电子邮箱

北京市西城

国家新闻出版广电总局广

区复兴门外孟祥昆100866010-86098010mengxiangkun@

播科学研究院

大街2号

请注意除上述专利外，本部分的某些内容仍可能涉及专利。本部分的发布机构不承担识别这些专

利的责任。

V

GY/T303.3—2018

智能电视操作系统

第3部分：应用程序编程接口

1范围

GY/T303的本部分规定了智能电视操作系统应用程序编程接口的相关技术要求和详细接口定义。

本部分适用于智能电视操作系统的应用开发和测试，包括JAVA应用和WEB应用两部分。

2规范性引用文件

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

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

GY/T255—2012可下载条件接收系统规范

GY/T303.1—2016智能电视操作系统第1部分：功能与架构

GY/T303.2—2016智能电视操作系统第2部分：安全

GB/T4880.2—2000语种名称代码第2部分：3字母代码

GB/T17975.1—2010信息技术运动图像及其伴音信息的通用编码第1部分：系统

GB/T20090.2—2006信息技术先进音视频编码第2部分：视频

GB/T28160—2011数字电视广播电子节目指南规范

GB/T28161—2011数字电视广播业务信息规范

ISO/IEC13522-1-2000信息技术多媒体和超媒体信息的编码（Informationtechnology.Codingof

multimediaandhypermediainformation）

ISO/IEC13818-1-2018信息技术移动图片和相关音频信息的普通编码第1部分：系统（Generic

CodingofMovingPicturesandAssociatedAudioPart1:Systems）

ISO/IEC13818-6-1998信息技术移动图片和相关音频信息的普通编码第6部分：DSM-CC的扩展

（GenericCodingofMovingPicturesandAssociatedAudioPart6:ExtensionforDigitalStorage

MediaCommandandControl）

IETFRFC791互联网协议（Internetprotocol）

IETFRFC2373IPv6寻址系统结构（IPVersion6AddressingArchitecture）

ECMA-262ECMAScript语言规范（ECMAScriptLanguageSpecification）

3缩略语

下列缩略语适用于本部分。

App应用程序（Application）

AV音视频（AudioVideo）

CA认证机构（CertificationAuthority）

CAS条件接收系统（ConditionalAccessSystem）

CSS样式级联表（CascadingStyleSheets）

1

GY/T303.3—2018

DCAS可下载条件接收系统（DownloadableConditionalAccessSystem）

DTV数字电视（DigitalTelevision）

DRM数字版权管理（DigitalRightsManagement）

DVB数字视频广播（DigitalVideoBroadcasting）

ECM授权控制信息（EntitlementControlMessage）

EMM授权管理信息（EntitlementManagementMessage）

EPG电子节目指南（ElectronicProgramGuide）

ES基本码流（ElementaryStream）

HTML超文本标记语言（HyperTextMarkupLanguage）

HTTP超文本传输协议（HyperTextTransferProtocol）

IPTVIP电视（IPTelevision）

JS脚本语言（JavaScript）

MPEG动态图像专家组（MovingPictureExpertsGroup）

OSD屏幕叠加显示（On-ScreenDisplay）

OTA空中升级（OverTheAir）

PID包识别码（PacketIdentifier）

TApp可信应用（TrustedApplication）

TEE可信执行环境（TrustedExecutionEnvironment）

TS传送流（TransportStream）

4接口概述

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单向广播网络接入单元

单向广播网络接入单元概述

单向广播网络接入单元用于实现单向广播网络接入功能，包括调谐的频率、调制方式、符号率等参数

控制及信号强度和质量等信息的获取。该单元定义了调谐解调模块。Java接口详细定义见附录A。

2

GY/T303.3—2018

调谐解调模块

调谐解调模块定义了调谐和解调用到的接口、类和异常，包括调谐参数定义、Tuner对象定义、调谐

解调管理类等，通过这些定义实现了调谐解调功能。

调谐解调模块概要见表1。

表1调谐解调模块概要

对象名类型说明备注

DeliverySystemType接口DVB技术体系下的传送系统类型常量定义。见A.2.1

TuningParameters接口调谐解调参数接口。见A.2.2

网络接口事件监听器接口，提供了网络接口相关事件

TuningListener接口见A.2.3

处置的回调方法。

DvbcTuningParameters类适用于DVB-C传送系统的调谐解调参数类。见A.2.4

AbsssTuningParameters类适用于ABS-SS传送系统的调谐解调参数类。见A.2.5

DtmbTuningParameters类适用于DTMB传送系统的调谐解调参数类。见A.2.6

TunerEvent类调谐解调器事件类。见A.2.7

TunerTuningEvent类网络接口开始调谐事件，继承TunerEvent类。见A.2.8

TunerTuningOverEvent类结束调谐事件，继承TunerEvent类。见A.2.9

Tuner类调谐解调控制接口。见A.2.10

调制解调管理器类，用于跟踪连接到接收设备的广播

TunerManager类见A.2.11

网络接口，是调谐解调单元的入口类。

TunerException异常网络接口异常。见A.2.12

IncorrectLocatorException异常定位符格式不正确异常，继承TunerException类。见A.2.13

流未发现异常，继承TunerException类。由于传送流

StreamNotFoundException异常不在StreamTable中而导致对该传送流的引用无法被见A.2.14

解析时，则抛出此异常。

获取当前调谐解调参数失败或者

TuningParameterNotFoundException异常见A.2.15

DeliverySystemType错误的时候，抛出异常。

4.2.3广播协议处理单元

广播协议处理单元概述

广播协议处理单元用于实现广播协议的处理，包括了MPEG对象定义模块、DVB对象定义模块、SECTION

段过滤模块、URL封装模块、DVB定位符模块和广播协议处理模块。Java接口详细定义见附录B。

MPEG对象定义模块

MPEG对象定义模块定义了MPEG-2体系下最基本的对象以及系统可能出现的异常。

本模块定义的最基本的MPEG-2对象有：

——传送流类（TransportStream）；

——基本流类（ElementaryStream）；

——广播业务类（Service）。

定义的MPEG-2异常有：

3

GY/T303.3—2018

——广播内容未授权异常（NotAuthorizedException）；

——资源异常（ResourceException）；

——调谐解调异常（TuningException）。

MPEG对象定义模块概要见表2。

表2MPEG对象定义模块概要

对象名类型说明备注

广播内容未授权报告接口，定义了失败原因常量，提供了查找失

NotAuthorizedInterface接口见B.2.1

败原因的方法。

MPEG-2传送流类，代表一个MPEG-2传送流（TS），提供了获取传

TransportStream类见B.2.2

送流信息的方法。

MPEG-2基本流类，代表一个在传送流（TS）中承载的基本流（ES），

ElementaryStream类见B.2.3

提供了获取基本流信息的方法。

MPEG-2业务类，代表一个在传送流中承载的MPEG-2业务，提供了

Service类见B.2.4

获取业务信息的方法。

广播内容未授权异常，实现NotAuthorizedInterface接口，当访

NotAuthorizedException异常见B.2.5

问无授权的加扰数据时抛出。

TuningException异常调谐解调异常，当调谐解调失败时抛出。见B.2.6

ResourceException异常资源异常，当因资源缺乏而无法进行操作时抛出。见B.2.7

DVB对象定义模块

DVB对象定义模块定义了DVB体系下的MPEG-2基本对象：

——DVB传送流类（DvbTransportStream）；

——DVB基本流类（DvbElementaryStream）；

——DVB广播业务类（DvbService）。

DVB对象定义模块概要见表3。

表3DVB对象定义模块概要

对象名类型说明备注

DVB基本流类，代表一个在传送流（TS）中承载的符合DVB语义约

DvbElementaryStream类见B.3.1

束的MPEG-2基本流（ES），提供了获取DVB基本流信息的方法。

DVB业务类，代表一个在传送流中承载的符合DVB语义约束的

DvbService类见B.3.2

MPEG-2业务，提供了获取DVB业务信息的方法。

DVB传送流类，代表一个符合DVB语义约束的MPEG-2传送流，提

DvbTransportStream类见B.3.3

供了获取DVB传送流信息的方法。

SECTION段过滤模块

SECTION段过滤模块提供了与MPEG-2段(section)过滤相关的类和方法。

SECTION段过滤模块概要见表4。

4

GY/T303.3—2018

表4SECTION段过滤模块概要

对象名类型说明备注

段过滤事件监听器接口，提供了段过滤事件处置回调方法，

SectionFilterListener接口见B.4.1

由应用层实现。

Section类MPEG-2段类，描述了从传输流中过滤到的一个段。见B.4.2

段过滤器组类，代表一个MPEG-2过滤器组，可以作为一个基

SectionFilterGroup类见B.4.3

本操作单元被激活和释放。

段过滤器类，该类为一组具有不同生命周期和缓存长度特点

SectionFilter类见B.4.4

的段过滤器类的基类，提供了过滤器基本操作方法。

SimpleSectionFilter类简单段过滤器类，继承SectionFilter类。见B.4.5

TableSectionFilter类表段过滤器类，继承SectionFilter类。见B.4.6

RingSectionFilter类循环段过滤器类，继承SectionFilter类。见B.4.7

SectionFilterEvent事件段过滤事件类，一组段过滤事件类的基类。见B.4.8

段数据可用事件，继承SectionFilterEvent类，报告过滤到

SectionAvailableEvent事件见B.4.9

了一个完整的段。

VersionChangeDetectedEvent事件段过滤版本变更事件，继承SectionFilterEvent类。见B.4.10

段过滤结束事件，继承SectionFilterEvent类，报告段过滤

EndOfFilteringEvent事件见B.4.11

结束。

IncompleteFilteringEvent事件段过滤不完整事件，继承EndOfFilteringEvent类。见B.4.12

TimeOutEvent事件段过滤超时事件，继承EndOfFilteringEvent类。见B.4.13

FilterResourcesAvailableEvent事件过滤器资源可用事件，继承ResourceStatusEvent类。见B.4.14

段过滤器组与传送流强制断开事件，继承

ForcedDisconnectedEvent事件见B.4.15

ResourceStatusEvent类。

SectionFilterException异常段过滤异常的基类。见B.4.16

ConnectionLostException异常连接丢失异常，继承SectionFilterException类。见B.4.17

FilteringInterruptedException异常过滤中断异常，继承SectionFilterException类。见B.4.18

FilterResourceException异常过滤器资源异常，继承SectionFilterException类。见B.4.19

IllegalFilterDefinitionException异常非法过滤条件异常，继承SectionFilterException类。见B.4.20

InvalidSourceException异常段数据源无效异常，继承SectionFilterException类。见B.4.21

NoDataAvailableException异常段对象无可用数据异常，继承SectionFilterException类。见B.4.22

URL封装模块

URL封装模块提供了URL封装的引用方法。

URL封装模块概要见表5。

表5URL封装模块概要

对象名类型说明备注

Locator类资源定位符类，将URL封装成定位符对象。见B.5.1

InvalidLocatorException异常定位符无效异常。见B.5.2

5

GY/T303.3—2018

DVB定位符模块

DVB定位符模块提供了访问DVB广播业务及其内容的引用