CY T 182-2019 《专业内容数字阅读技术 多窗口数据通讯》发布稿.pdf

1、ICS 35.240.30 L70 CY 中 华 人 民 共 和 国 新 闻 出 版 行 业 标 准 CY/T 1822019 专业内容数字阅读技术 多窗口数据通讯 Professional content digital reading technology - Multiwindow data communication 2019 - 05 - 29发布 2019- 07 - 01实施 国家新闻出版署 发布 CY/T 182 2019 目 次 前言 II 1 范围 . 1 2 规范性引用文件 1 3 术语和定义 1 4 多窗口数据通讯目的 2 5 多窗口数据通讯原则 2 5.1 实用性 2

2、 5.2 安全性 2 5.3 可扩展性 2 6 多窗口数据通讯角色与流程 2 6.1 通讯角色 2 6.2 通讯流程 3 7 多窗口数据通讯操作方法 3 7.1 窗口创建 3 7.2 获取通讯窗口 4 7.3 窗口操作 4 7.4 内容操作 5 7.5 信息显示操作 5 8 多窗口通讯操作应用 6 8.1 窗口创建 6 8.2 获取通讯窗口 6 8.3 窗口操作 6 8.4 内容操作 9 8.5 信息显示操作 . 13 9 扩展原 则 . 13 参考文献 . 14 CY/T 1822019 II 前 言 专业内容数字阅读系列行业标准目前包括： CY/T 179 2019 专业内容数字阅读技术

3、标准体系表 CY/T 180 2019 专业内容数字阅读技术 阅读功能与标签 CY/T 181 2019 专业内容数字阅读技术 产品封装 CY/T 182 2019 专业内容数字阅读技术 多窗口数据通讯 本标准按照 GB/T 1.1 2009给出的规则起草。 本标准由全国新闻出版标准化技术委员会（ SAC/TC 527）提出并归口。 本标准起草单位：中新金桥数字科技（北京）有限公司、中国新闻出版研究院、电子工业出版社 有限公司 、中国建筑工业出版社、人民卫生出版社 有限公司 、中国林业出版 社 有限公司 、国防工业出版社、中国农业科学技术出版社 有限公司 、英大传媒投资集团有限公司、长江出版社

4、 （武汉）有限公司 、冶金工业出版社 有限公司 。 本标准主要起草人：赵海涛、蒋隽、薛建川、 王瑜、王德胜、袁玺、田佳烨、魏枫、汪智、石雄、温晋、 郝刚、 余敬春、邵世磊、刘鲲翔、孙金、邹石川、谢冠伦、杨洁、李福建、李雅婧、刘汉操、李春、谢冰。 CY/T 182 2019 专业内容数字阅读技术 多窗口数据通讯 1 范围 本标准提出了新闻出版行业专业内容数字阅读产品 中 多窗口数据通讯的目的、原则、角色与流程、操作方法、应用和扩展原则。 本 标准 适用于 新闻 出版行业 专业内容数字阅读设备、系统的研制和使用过程中，对多窗口数据通讯进行规范化的使用，也适用于其他相关标准或协议中对多窗口通讯的使用

5、。 2 规范性引用文件 下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件，仅注日期的版本适用于本文件。凡是不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。 GB/T 18793 2002 信息技术 可扩展置标语言 (XML)1.0 3 术语和定义 下列术语和定义适用于本文件。 3.1 专业内容 professional content 根据学科分类和社会职业分工需 要分门别类进行阅读、专门研究或教学的内容资源。 3.2 数字阅读产品 digital reading product 支持数字阅读、人机交互等功能并用于阅读、学习或研究的数字内容集合。 3.3 窗口标识符

6、windows identifier 一个 32位整数，用于标记窗口在运行时的唯一编码。 3.4 程序标识 software label 在运行环境中用于唯一指定某个应用程序的名称。 3.5 设备标识 computer label 在运行环境中用于唯一指定某个可运行应用程序的设备名称。 CY/T 1822019 2 3.6 网络字节顺序 network byte order 采用 Big-endian排序方式规定好的一种数据表示格式。该排序方式与具体的 CPU类型、操作系统等无关，从而可以保证数据通讯在不同设备之间传输时可以被正确解释。 4 多窗口数据通讯目的 专业内容数字阅读多窗口数据通讯，

7、主要是通过窗口数据交换完成多窗口之间的数据传输或消息的传递。为使产品可以在不同系统、不同软件和硬件上都能实现窗口数据通讯，需要完善、可靠的多窗口通讯规范。 5 多窗口数据通讯原则 5.1 实用性 通讯规范设计面向实用，注重实效、高效的原则，充分合理利用现有设备和信息资源，帮助开发者便捷 使用。 5.2 安全性 提供校验和异常处理，既考虑数据的充分共享，也考虑数据的保护和隔离，从分发、使用、验证等多方面对内容数据进行保护，确保数据的安全性、可靠性、完整性和一致性。 5.3 可扩展性 通讯规范设计充分考虑兼容性，既考虑到业务未来发展的需要，又能够支持硬件、系统软件、应用程序等多个层面的可扩展性。

8、6 多窗口数据通讯角色与流程 6.1 通讯角色 专业内容数字阅读多窗口数据通讯的角色分为发送窗口和接收窗口，角色之间可互换。窗口应具备基本信息供应用程序在进行多窗口通讯时使用。具体信息包括窗口唯一标识号、所属程序、所属设备等。信 息描述见表 1。 表 1 窗口信息描述 序号 名称 说明 可选性 可重复性 1 窗口标识号 专业内容数字阅读窗口的唯一标识符 必选 不可重复 2 所属程序 所属的专业内容数字阅读程序 可选 不可重复 3 所属设备 所属专业内容数字阅读设备（计算机、移动终端） 可选 不可重复 4 窗口状态 窗口当前状态 :显示、隐藏 可选 不可重复 CY/T 182 2019 5 窗口

9、布局 窗口显示的布局方式：最大化、最小化、横向、纵向 可选 不可重复 6 备注说明 - 可选 不可重复 6.2 通讯流程 窗口间的通讯流程由发送窗口发起，发送窗口获得可进行通 讯的窗口列表，选定接收窗口后对接收窗口进行窗口操作、数据内容操作、显示信息操作。详细流程见图 1。 发 送 窗 口建 立 窗 口 通 讯数 据 内 容 通 讯 显 示 信 息 通 讯本 设 备 跨 设 备接 收 窗 口相 同 程 序不 同 程 序获 得 通 讯 窗 口 列 表图 1 多窗口数据通讯流程图 7 多窗口数据通讯操作方法 7.1 窗口创建 用于在专业内容数字阅读软件中 创建通讯窗口，详细说明见表 2。 表 2

10、窗口创建函数 Windows_create 函数 Windows_create（ Software,Computer） 参数 参数名称 说明 必填 默认值 类型 Software 程序标识 否 String Computer 设备标识 否 String CY/T 1822019 4 返回值 status Success(成功 ) Failed(失败 ) message(Status 为 Failed) 返回错误原因 WindowsID 窗口 标识 ID 7.2 获取通讯窗口 用于获取在专业内容数字阅读软件中 可以进行数据通讯的窗口列表，在返回的窗口列表中包括窗口标识、程序标识、设备标识、窗口状

11、态和窗口布局信息，详细说明见表 3。 表 3 获取通讯窗口函数 GetWindows 函数 GetWindows( ) 参数 无 返回值 status Success(成功 ) Failed(失败 ) message(Status 为 Failed) 返回错误原因 rows 通讯窗口列表 rows 内 数据 WindowsID 窗口 标识 ID Software 程序标识 Computer 设备标识 State 窗口状态 Style 窗口布局 7.3 窗口操作 用于在专业内容数字阅读软件中通过发送窗口 向接收窗口发送相关窗口操作信息 ，包括进行窗口打开、窗口关闭、窗口显示、窗口隐藏、窗口布局，

12、详细说明见表 4。 表 4 窗口操作函数 Window_operation 函数 Window_operation（ WindowsID,Operation,Style,Size） 参数 参数名称 说明 必填 默认值 类型 WindowsID 窗口唯一 标识 ID 是 Int Operation 窗口操作类型 否 Open String CY/T 182 2019 Style 窗口布局样式 否 Max String Size 窗口显示大小比例最大值为 100 否 100 Int 返回值 status Success(成功 ), Failed(失败 ) message(Status 为 Fail

13、ed) 返回 错误原因 7.4 内容操作 用于在专业内容数字阅读软件中通过发送窗口 向接收窗口发送相关内容操作信息 ，包括进行内容读取、翻页、定位、背景、字体、字号进行通讯设置，详细说明见表 5。 表 5 内容操作函数 Content_operation 函数 Content_operation（ WindowsID,Operation, parameter1, parameter2） 参数 参数名称 说明 必填 默认值 类型 WindowsID 窗口唯一 标识 ID 是 Int Operation 内容 操作类型 是 String Parameter1 操作类型参数 是 String Par

14、ameter2 操作类型参数 否 String 返回值 status Success(成功 ) Failed(失败 ) message(Status 为 Failed) 返回错误原因 7.5 信息显示操作 用于在专业内容数字阅读软件中通过发送窗口 向接收窗口发送信息显示操作信息 ，包括通知信息和异常信息，详细说明见表 6。 表 6 信息显示操作函数 Content_operation 函数 Message_operation（ WindowsID,Operation,message） 参数 参数名称 说明 必填 默认值 类型 WindowsID 窗口唯一 标识 ID 是 Int Operati

15、on 内容 操作类型 是 String Message 信息内容 是 String CY/T 1822019 6 8 多窗口通讯操作应用 8.1 窗口创建 调用 Windows_create（）函数， 返回通讯状态、错误提示和窗口标识 ID。通讯状态为成功时，获得创建窗口标识 ID。详细信息见表 7。 表 7 窗口创建函数 调用函数 Windows_create（ Software， Computer） 参数 参数 值 备注 Software 程序标识 Computer 设备标识 返回 status Success Success(成功 ),Failed(失败 ) message Status

16、 为 Failed， 返回错误原因 WindowsId 窗口 标识 ID 8.2 获取通讯窗口 通过调用 GetWindows( )函数，返回通讯状态、错误提示和通讯窗口列表。通讯状态为成功时，获得通讯窗口列表信息。详细信息见表 8。 表 8 获取通讯窗口函数 调用函数 GetWindows( ) 参数 参数 值 备注 无 返回 status Success Success(成功 ),Failed(失败 ) message Status 为 Failed， 返回错误原因 WindowsId 窗口 标识 ID Rows 通讯窗口列表 software computer state style 8

17、.3 窗口操作 8.3.1 窗口显示 调用 Window_operation ( )函数，当返回的通讯状态值为成功时，完成窗口显示通讯。详细信息见表 9。 表 9 窗口显示函数 调用函数 Window_operation（ WindowsID,Operation,Style,Size） 参数 参数 值 备注 CY/T 182 2019 WindowsID 窗口 标识 ID Operation show Operation 参数 ， 详细取值说明见表 10 Style max Style 参数 ，详细取值说明见表 11 Size 100 返回 status Success Success(成功

18、),Failed(失败 ) message Status 为 Failed， 返回错误原因 Window_operation ( )函数中 Operation参数的取值范 围见表 10。 表 10 Window_operation函数中 Operation参数取值说明 标签 说明 close 窗口关闭 show 窗口显示 hide 窗口隐藏 layout 窗口布局 Window_operation ( )函数中 Style参数的取值范围见表 11。 表 11 Window_operation函数中 Style 参数 取值说明 标签 说明 max 最大化 min 最小化 roll 横向 vert

19、ically 纵向 8.3.2 窗口关闭 调用 Window_operation ( )函数，当返回的通 讯状态值为成功时，完成窗口关闭通讯。详细信息见表 12。 表 12 窗口关闭函数 调用函数 : Window_operation（ WindowsID,Operation,Style,Size） 参数 参数 值 备注 WindowsID 窗口 标识 ID Operation Close Operation 参数 ， 详细取值说明见表 10 Style Style 参数 ，详细取值说明见表 11 Size CY/T 1822019 8 返回 status Success Success(成功

20、 ),Failed(失败 ) message Status 为 Failed， 返回错误原因 8.3.3 窗口隐藏 调用 Window_operation ( )函数，当返回的通讯状态值为成功时，完成窗口隐藏通讯。详细信息见表 13。 表 13 窗口隐藏函数 调用函数 Window_operation（ WindowsID,Operation,Style,Size） 参数 参数 值 备注 WindowsID 窗口 标识 ID Operation hide Operation 参数 ， 详细取值说明见表 10 Style Style 参数 ，详细取值说明见表 11 Size 返回 status

21、Success Success(成功 ),Failed(失败 ) message Status 为 Failed， 返回错误原因 8.3.4 窗口布局 调用 Window_operation ( )函数，当返回的通讯状态值为成功时，完成窗口布局通讯。详细信息见表 14。 表 14 窗口布局函数 调用函数 Window_operation（ WindowsID,Operation,Style,Size） 参数 参数 值 备注 WindowsID 窗口 标识 ID Operation layout Operation 参数 ， 详细取值说明见表 10 Style vertically Style

22、参数 ，详细取值说明见表 11 Size 返回 status Success Success(成功 ),Failed(失败 ) message Status 为 Failed， 返回错误原因 CY/T 182 2019 8.4 内容操作 8.4.1 内容读取 调用 Content_operation ( )函数，当返回的通讯状态值为成功时，完成内容读取通讯。详细信息见表 15。 表 15 内容读取函数 调用函数 Content_operation（ WindowsID,Operation, parameter1, parameter2） 参数 参数 值 备注 WindowsID 窗口 标识 I

23、D Operation read Operation 参数 ， 详细取值说明见表 16 Parameter1 file 当 Operation=“read”时 parameter1 参数 ，详细取值说明见表 17 Parameter2 文件路径 当 parameter1=“file“, parameter2=文件路径； 当 parameter1=“Content“, parameter2=文本数据 ； 返回 status Success :Success(成功 ),Failed(失败 ) message Status 为 Failed， 返回错误原因 Content_operation ( )

24、函数中 Operation参数的取值范围见表 16。 表 16 Content_operation 函数中 Operation 参数 取值说明 标签 说明 read 内容读取 page 翻页 location 定位 background 背景 font 字体 size 字号 Content_operation ( )函数中当 Operation=“read“时， parameter1参数的取值范围见表 17。 表 17 Operation=“ read” parameter1参数 取值说明 标签 说明 file 读取文件 content 读取窗口传递数据 CY/T 1822019 10 8.4

25、.2 翻页 调用 Content_operation ( )函数，当返回的通讯状态值为成功时，完成翻页通讯。详细信息见表 18。 表 18 翻页操作函数 调用函数 Content_operation（ WindowsID,Operation, parameter1, parameter2） 参数 参数 值 备注 WindowsID 窗口 标识 ID Operation page Operation 参数 ， 详细取值说明见表 16 Parameter1 next 当 Operation=“page”时 parameter1 参数 ，详细取值说明见表 19 Parameter2 返回 statu

26、s Success Success(成功 ),Failed(失败 ) message Status 为 Failed， 返回错误原因 Content_operation ( )函数中当 Operation=“page“时， parameter1参数的取值范围见表 19。 表 19 Operation=“ page” parameter1参数 取值说明 标签 说明 home 首页 end 尾页 last 上翻 next 下翻 8.4.3 定位 调用 Content_operation ( )函数，当返回的通讯状态值为成功时，完成定位通讯。详细信息见表 20。 表 20 定位操作函数 调用函数 C

27、ontent_operation（ WindowsID,Operation, parameter1, parameter2） 参数 参数 值 备注 WindowsID 窗口 标识 ID Operation location Operation 参数 ， 详细取值说明见表 16 Parameter1 Label 当 Operation=“location”时 parameter1 参数 ，详细取值说明见表 21 CY/T 182 2019 Parameter2 标签名称 返回 status Success Success(成功 ),Failed(失败 ) message Status 为 Fai

28、led， 返回错误原因 Content_operation ( )函 数中当 Operation=“location“时， parameter1参数的取值范围见表 21。 表 21 Operation=“location” parameter1参数 取值说明 标签 说明 fixed 固定位置 relative 相对位置 label 标签位置 8.4.4 背景 调用 Content_operation ( )函数，当返回的通讯状态值为成功时，完成背景通讯。详细信息见表 22。 表 22 背景操作函数 调用函数 Content_operation（ WindowsID,Operation, par

29、ameter1, parameter2） 参数 参数 值 备注 WindowsID 窗口 标识 ID Operation Background Operation 参数 ， 详细取值说明见表 16 Parameter1 Color 当 Operation=“ Background”时 parameter1 参数 ，详细取值说明见表 23 Parameter2 #ffffcc 返回 status Success Success(成功 ),Failed(失败 ) message Status 为 Failed， 返回错误原因 Content_operation ( )函数中当 Operation=

30、“Background“时， parameter1参数的取值范围见表 23。 表 23 Operation=“Background” parameter1参数 取值说明 标签 说明 default 默认背景 CY/T 1822019 12 image 背景图片 color 背景颜色 8.4.5 字体 调用 Content_operation ( )函数，当返回的通讯状态值为成功时，完成字体通讯。详细信息见表 24。 表 24 字体操作函数 调用函数 Content_operation（ WindowsID,Operation, parameter1, parameter2） 参数 参数 值 备

31、注 WindowsID 窗口 标识 ID Operation Font Operation 参数 ， 详细取值说明见表 16 Parameter1 宋体 Parameter2 返回 status Success Success(成功 ),Failed(失败 ) message Status 为 Failed， 返回错误原因 8.4.6 字号 调用 Content_operation ( )函数，当返回的通 讯状态值为成功时，完成字号通讯。详细信息见表 25。 表 25 字号操作函数 调用函数 Content_operation（ WindowsID,Operation, parameter1,

32、 parameter2） 参数 参数 值 备注 WindowsID 窗口 标识 ID Operation Size Operation 参数 ， 详细取值说明见表 16 Parameter1 12px Parameter2 返回 status Success Success(成功 ),Failed(失败 ) message Status 为 Failed， 返回错误原因 CY/T 182 2019 8.5 信息显示操作 8.5.1 通知信息 调用 Message_operation ( )函数，完成窗口通知信息通讯。详细信息见表 26。 表 26 通知信息函数调用 调用函数 Message_o

33、peration（ WindowsID,Operation,message） 参数 参数 值 备注 WindowsID 窗口 标识 ID Operation information Operation 参数 ， 详细取值说明见表 27 Message 通知信息内容 Message_operation ( )函数中 Operation参数的取值范围见表 27。 表 27 Message_operation 函数中 Operation 参数 取值说明 标签 说明 information 通知信息 error 异常信息 8.5.2 异常信息 调用 Message_operation ( )函数，完成

34、窗口异常信息通讯。详细信息见表 28。 表 28 异常信息函数 调用函数 Message_operation（ WindowsID,Operation,message） 参数 参数 值 备注 WindowsID 窗口 标识 ID Operation Error Operation 参数 ， 详细取值说明见表 27 Message 错误信息 9 扩展原则 当部分窗口数据通讯无法按照上述的通讯规范，进行多窗口数据通讯时，可通过扩展窗口信息和内容操作的方式加入规范中。扩展加入的内容应遵循如下的原则： a) 窗口信息的扩展内容，需要遵循窗口信息描述的 XML文件规范； b) 扩展内容操作需要提供介绍或说明性文件； c) 扩展内容宜与其他内容建立内部关联。 CY/T 1822019 14 参 考 文 献 1 GB/T 25100 信息与文献 都柏林核心元数据元素集 2 CY/T 50 2008 出版术语 3 CY/T 96 2013 电子书内容术语 _