CY∕T 182-2019 专业内容数字阅读技术 多窗口数据通讯.pdf

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 1822019 目 次 前言 ........................................................................ II 1 范围 ....................................................................... 1 2 规范性引用文件 .............................................................. 1 3 术语和定义 .................................................................. 1 4 多窗口数据通讯目的 .......................................................... 2 5 多窗口数据通讯原则 .......................................................... 2 5.1 实用性.................................................................. 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 1792019 专业内容数字阅读技术 标准体系表 CY/T 1802019 专业内容数字阅读技术 阅读功能与标签 CY/T 1812019 专业内容数字阅读技术 产品封装 CY/T 1822019 专业内容数字阅读技术 多窗口数据通讯 本标准按照GB/T 1.12009给出的规则起草。 本标准由全国新闻出版标准化技术委员会（SAC/TC 527）提出并归口。 本标准起草单位中新金桥数字科技（北京）有限公司、中国新闻出版研究院、电子工 业出版社有限公司、中国建筑工业出版社、人民卫生出版社有限公司、中国林业出版社有限 公司、国防工业出版社、中国农业科学技术出版社有限公司、英大传媒投资集团有限公司、 长江出版社（武汉）有限公司、冶金工业出版社有限公司。 本标准主要起草人赵海涛、蒋隽、薛建川、王瑜、王德胜、袁玺、田佳烨、魏枫、汪 智、石雄、温晋、郝刚、余敬春、邵世磊、刘鲲翔、孙金、邹石川、谢冠伦、杨洁、李福建、 李雅婧、刘汉操、李春、谢冰。 CY/T 1822019 专业内容数字阅读技术 多窗口数据通讯 1 范围 本标准提出了新闻出版行业专业内容数字阅读产品中多窗口数据通讯的目的、原则、 角色与流程、操作方法、应用和扩展原则。 本标准适用于新闻出版行业专业内容数字阅读设备、系统的研制和使用过程中，对多 窗口数据通讯进行规范化的使用，也适用于其他相关标准或协议中对多窗口通讯的使用。 2 规范性引用文件 下列文件对于本文件的应用是必不可少的。 凡是注日期的引用文件， 仅注日期的版本适 用于本文件。凡是不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。 GB/T 187932002 信息技术 可扩展置标语言XML1.0 3 术语和定义 下列术语和定义适用于本文件。 3.1 专业内容 professional content 根据学科分类和社会职业分工需要分门别类进行阅读、专门研究或教学的内容资源。 3.2 数字阅读产品 digital reading product 支持数字阅读、人机交互等功能并用于阅读、学习或研究的数字内容集合。 3.3 窗口标识符 windows identifier 一个32位整数，用于标记窗口在运行时的唯一编码。 3.4 程序标识 software label 在运行环境中用于唯一指定某个应用程序的名称。 3.5 设备标识 computer label 在运行环境中用于唯一指定某个可运行应用程序的设备名称。 CY/T 1822019 2 3.6 网络字节顺序 network byte order 采用Big-endian排序方式规定好的一种数据表示格式。该排序方式与具体的CPU类型、 操作系统等无关，从而可以保证数据通讯在不同设备之间传输时可以被正确解释。 4 多窗口数据通讯目的 专业内容数字阅读多窗口数据通讯，主要是通过窗口数据交换完成多窗口之间的数据 传输或消息的传递。为使产品可以在不同系统、不同软件和硬件上都能实现窗口数据通 讯，需要完善、可靠的多窗口通讯规范。 5 多窗口数据通讯原则 5.1 实用性 通讯规范设计面向实用，注重实效、高效的原则，充分合理利用现有设备和信息资 源，帮助开发者便捷使用。 5.2 安全性 提供校验和异常处理，既考虑数据的充分共享，也考虑数据的保护和隔离，从分发、 使用、验证等多方面对内容数据进行保护，确保数据的安全性、可靠性、完整性和一致 性。 5.3 可扩展性 通讯规范设计充分考虑兼容性，既考虑到业务未来发展的需要，又能够支持硬件、系 统软件、应用程序等多个层面的可扩展性。 6 多窗口数据通讯角色与流程 6.1 通讯角色 专业内容数字阅读多窗口数据通讯的角色分为发送窗口和接收窗口，角色之间可互换。 窗口应具备基本信息供应用程序在进行多窗口通讯时使用。具体信息包括窗口唯一标识号、 所属程序、所属设备等。信息描述见表1。 表1 窗口信息描述 序号 名称 说明 可选性 可重复性 1 窗口标识号 专业内容数字阅读窗口的唯一标识符 必选 不可重复 2 所属程序 所属的专业内容数字阅读程序 可选 不可重复 3 所属设备 所属专业内容数字阅读设备（计算机、移动终端） 可选 不可重复 4 窗口状态 窗口当前状态显示、隐藏 可选 不可重复 CY/T 1822019 5 窗口布局 窗口显示的布局方式最大化、最小化、横向、纵向 可选 不可重复 6 备注说明 - 可选 不可重复 6.2 通讯流程 窗口间的通讯流程由发送窗口发起，发送窗口获得可进行通讯的窗口列表，选定接收 窗口后对接收窗口进行窗口操作、数据内容操作、显示信息操作。详细流程见图1。 发送窗口 建立窗口通讯数据内容通讯显示信息通讯 本设备跨设备 接收窗口 相同程序不同程序 获得通讯窗口列表 图1 多窗口数据通讯流程图 7 多窗口数据通讯操作方法 7.1 窗口创建 用于在专业内容数字阅读软件中创建通讯窗口，详细说明见表2。 表2 窗口创建函数 Windows_create 函数 Windows_create（Software,Computer） 参数 参数名称 说明 必填 默认值 类型 Software 程序标识 否 String Computer 设备标识 否 String CY/T 1822019 4 返回值 status Success成功 Failed失败 messageStatus 为 Failed 返回错误原因 WindowsID 窗口标识 ID 7.2 获取通讯窗口 用于获取在专业内容数字阅读软件中可以进行数据通讯的窗口列表，在返回的窗口列 表中包括窗口标识、程序标识、设备标识、窗口状态和窗口布局信息，详细说明见表3。 表3 获取通讯窗口函数 GetWindows 函数 GetWindows 参数 无 返回值 status Success成功 Failed失败 messageStatus 为 Failed 返回错误原因 rows 通讯窗口列表 rows 内数据 WindowsID 窗口标识 ID Software 程序标识 Computer 设备标识 State 窗口状态 Style 窗口布局 7.3 窗口操作 用于在专业内容数字阅读软件中通过发送窗口向接收窗口发送相关窗口操作信息，包 括进行窗口打开、窗口关闭、窗口显示、窗口隐藏、窗口布局，详细说明见表4。 表4 窗口操作函数 Window_operation 函数 Window_operation（WindowsID,Operation,Style,Size） 参数 参数名称 说明 必填 默认值 类型 WindowsID 窗口唯一标识 ID 是 Int Operation 窗口操作类型 否 Open String CY/T 1822019 Style 窗口布局样式 否 Max String Size 窗口显示大小比例最大 值为 100 否 100 Int 返回值 status Success成功, Failed失败 messageStatus 为 Failed 返回错误原因 7.4 内容操作 用于在专业内容数字阅读软件中通过发送窗口向接收窗口发送相关内容操作信息，包 括进行内容读取、翻页、定位、背景、字体、字号进行通讯设置，详细说明见表5。 表5 内容操作函数 Content_operation 函数 Content_operation（WindowsID,Operation, parameter1, parameter2） 参数 参数名称 说明 必填 默认值 类型 WindowsID 窗口唯一标识 ID 是 Int Operation 内容操作类型 是 String Parameter1 操作类型参数 是 String Parameter2 操作类型参数 否 String 返回值 status Success成功 Failed失败 messageStatus 为 Failed 返回错误原因 7.5 信息显示操作 用于在专业内容数字阅读软件中通过发送窗口向接收窗口发送信息显示操作信息，包 括通知信息和异常信息，详细说明见表6。 表6 信息显示操作函数 Content_operation 函数 Message_operation（WindowsID,Operation,message） 参数 参数名称 说明 必填 默认值 类型 WindowsID 窗口唯一标识 ID 是 Int Operation 内容操作类型 是 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 为 Failed，返回错误原因 WindowsId 窗口标识 ID 8.2 获取通讯窗口 通过调用GetWindows 函数，返回通讯状态、错误提示和通讯窗口列表。通讯状态为 成功时，获得通讯窗口列表信息。详细信息见表8。 表8 获取通讯窗口函数 调用函数 GetWindows 参数 参数 值 备注 无 返回 status Success Success成功,Failed失败 message Status 为 Failed，返回错误原因 WindowsId 窗口标识 ID Rows 通讯窗口列表 software computer state style 8.3 窗口操作 8.3.1 窗口显示 调用Window_operation 函数，当返回的通讯状态值为成功时，完成窗口显示通讯。 详细信息见表9。 表9 窗口显示函数 调用函数 Window_operation（WindowsID,Operation,Style,Size） 参数 参数 值 备注 CY/T 1822019 WindowsID 窗口标识 ID Operation show Operation 参数，详细取值说明见表 10 Style max Style 参数，详细取值说明见表 11 Size 100 返回 status Success Success成功,Failed失败 message Status 为 Failed，返回错误原因 Window_operation 函数中Operation参数的取值范围见表10。 表10 Window_operation 函数中 Operation 参数取值说明 标签 说明 close 窗口关闭 show 窗口显示 hide 窗口隐藏 layout 窗口布局 Window_operation 函数中Style参数的取值范围见表11。 表11 Window_operation 函数中 StyleStyle 参数参数 取值说明取值说明 标签 说明 max 最大化 min 最小化 roll 横向 vertically 纵向 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成功,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 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 参数，详细取值说明见表 11 Size 返回 status Success Success成功,Failed失败 message Status 为 Failed，返回错误原因 CY/T 1822019 8.4 内容操作 8.4.1 内容读取 调用Content_operation 函数，当返回的通讯状态值为成功时，完成内容读取通 讯。详细信息见表15。 表15 内容读取函数 调用函数 Content_operation（WindowsID,Operation, parameter1, parameter2） 参数 参数 值 备注 WindowsID 窗口标识 ID 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 函数中Operation参数的取值范围见表16。 表16 ContentContent_operation_operation 函数中函数中 O Operationperation 参数参数 取值说明取值说明 标签 说明 read 内容读取 page 翻页 location 定位 background 背景 font 字体 size 字号 Content_operation 函数中当Operation“read“时，parameter1参数的取值范围见 表17。 表17 O Operation“peration“readread”” parameterparameter1 1 参数参数 取值说明取值说明 标签 说明 file 读取文件 content 读取窗口传递数据 CY/T 1822019 10 8.4.2 翻页 调用Content_operation 函数，当返回的通讯状态值为成功时，完成翻页通讯。详 细信息见表18。 表18 翻页操作函数 调用函数 Content_operation（WindowsID,Operation, parameter1, parameter2） 参数 参数 值 备注 WindowsID 窗口标识 ID Operation page Operation 参数，详细取值说明见表 16 Parameter1 next 当 Operation“page”时 parameter1 参数， 详细取值说 明见表 19 Parameter2 返回 status Success Success成功,Failed失败 message Status 为 Failed，返回错误原因 Content_operation 函数中当Operation“page“时，parameter1参数的取值范围见 表19。 表19 O Operation“peration“pagepage”” parameterparameter1 1 参数参数 取值说明取值说明 标签 说明 home 首页 end 尾页 last 上翻 next 下翻 8.4.3 定位 调用Content_operation 函数，当返回的通讯状态值为成功时，完成定位通讯。详 细信息见表20。 表20 定位操作函数 调用函数 Content_operation（WindowsID,Operation, parameter1, parameter2） 参数 参数 值 备注 WindowsID 窗口标识 ID Operation location Operation 参数，详细取值说明见表 16 Parameter1 Label 当 Operation“location”时 parameter1 参数， 详细取 值说明见表 21 CY/T 1822019 Parameter2 标签名称 返回 status Success Success成功,Failed失败 message Status 为 Failed，返回错误原因 Content_operation 函数中当Operation“location“时，parameter1参数的取值范 围见表21。 表21 O Operation“location”peration“location” parameterparameter1 1 参数参数 取值说明取值说明 标签 说明 fixed 固定位置 relative 相对位置 label 标签位置 8.4.4 背景 调用Content_operation 函数，当返回的通讯状态值为成功时，完成背景通讯。详 细信息见表22。 表22 背景操作函数 调用函数 Content_operation（WindowsID,Operation, parameter1, 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“Background“时，parameter1参数的取值 范围见表23。 表23 O Operation“Background”peration“Background” parameterparameter1 1 参数参数 取值说明取值说明 标签 说明 default 默认背景 CY/T 1822019 12 image 背景图片 color 背景颜色 8.4.5 字体 调用Content_operation 函数，当返回的通讯状态值为成功时，完成字体通讯。详 细信息见表24。 表24 字体操作函数 调用函数 Content_operation（WindowsID,Operation, parameter1, parameter2） 参数 参数 值 备注 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, parameter2） 参数 参数 值 备注 WindowsID 窗口标识 ID Operation Size Operation 参数，详细取值说明见表 16 Parameter1 12px Parameter2 返回 status Success Success成功,Failed失败 message Status 为 Failed，返回错误原因 CY/T 1822019 8.5 信息显示操作 8.5.1 通知信息 调用Message_operation 函数，完成窗口通知信息通讯。详细信息见表26。 表26 通知信息函数调用 调用函数 Message_operation（WindowsID,Operation,message） 参数 参数 值 备注 WindowsID 窗口标识 ID Operation ination Operation 参数，详细取值说明见表 27 Message 通知信息内容 Message_operation 函数中Operation参数的取值范围见表27。 表27 Message_Message_operationoperation 函数中函数中 O Operationperation 参数参数 取值说明取值说明 标签 说明 ination 通知信息 error 异常信息 8.5.2 异常信息 调用Message_operation 函数，完成窗口异常信息通讯。详细信息见表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 502008 出版术语 [3] CY/T 962013 电子书内容术语 _________________________________