GB/T 30246.8-2013 家庭网络 第8部分:设备描述文件规范 XML格式
- 名 称:GB/T 30246.8-2013 家庭网络 第8部分:设备描述文件规范 XML格式 - 下载地址1
- 下载地址:[下载地址1]
- 提 取 码:
- 浏览次数:3
发表评论
加入收藏夹
错误报告
目录| 新闻评论(共有 0 条评论) |
资料介绍
ICS 33. 040.40 L 78
中 华 人 民 共 和 国 国 家 标 准
GB/T 30246. 8—2013
家庭网络
第 8部分 :设备描述文件规范 XML格式
Homenetwork—
Part8:Devicedescription filespecification—XML format
2013-12-31发布 2014-07-15实施
中华人民共和国国家质量监督检验检疫总局中 国 国 家 标 准 化 管 理 委 员 会
发
布
GB/T 30246. 8—2013
目 次
前言 Ⅰ
引言 Ⅱ
1 范围 1
2 规范性引用文件 1
3 术语 、定义和缩略语 1
3. 1 术语和定义 1
3. 2 缩略语 2
4 设备和服务的 XML表述形式 2
4. 1 概述 2
4. 2 设备注册表 3
4. 3 设备描述形式 4
4. 4 服务描述形式 8
4. 5 描述形式的厂商扩展方式 10
附录 A (规范性附录) 设备注册表模式定义 13
附录 B (规范性附录) 设备描述模式定义 14
B. 1 概述 14
B. 2 设备描述模式定义 14
附录 C (规范性附录) 服务描述模式定义 17
C. 1 概述 17
C. 2 服务描述模式定义 17
附录 D (资料性附录) 分类设备描述模板 20
D. 1 数字媒体服务器设备描述 20
D. 2 数字媒体播放器设备描述 21
D. 3 中心节点设备描述 23
D. 4 控制类设备的设备描述 25
附录 E (资料性附录) 服务描述应用实例 26
E. 1 概述 26
E. 2 内容目录服务描述 26
E. 3 连接管理(ConnectionManager)服务描述 35
E. 4 音视频传输(AVTransport)服务描述 40
E. 5 播放控制(RenderingControl)服务描述 54
E. 6 开关控制服务描述 72
E. 7 增量参数调节服务描述 73
E. 8 枚举参数调节服务描述 79
E. 9 时间参数设置服务描述 82
E. 10 设备注册表管理(RegistryManager)服务描述 87
GB/T 30246. 8—2013
前 言
GB/T 30246《家庭网络》分为如下 11个部分 :
— 第 1部分 :系统体系结构及参考模型 ;
— 第 2部分 :控制终端规范 ;
— 第 3部分 : 内部网关规范 ;
— 第 4部分 :终端设备规范 音视频及多媒体设备 ;
— 第 5部分 :终端设备规范 家用及类似用途电器 ;
— 第 6部分 :多媒体与数据网络通信协议 ;
— 第 7部分 :控制网络通信协议 ;
— 第 8部分 :设备描述文件规范 XML格式 ;
— 第 9部分 :设备描述文件规范 二进制格式 ;
— 第 10部分 :多媒体与数据网络接口一致性测试规范 ;
— 第 11部分 :控制网络接口一致性测试规范 。
本部分为 GB/T 30246的第 8部分 。
本部分按照 GB/T 1. 1—2009给出的规则起草 。
请注意本文件的某些内容可能涉及专利 。本文件的发布机构不承担识别这些专利的责任 。
本部分由中华人民共和国工业和信息化部提出 。
本部分由全国音频 、视频及多媒体系统与设备标准化技术委员会(SAC/TC242)归 口 。
本标准起草单位 : 中山大学 、海尔集团公司 、华南理工大学 、广东工业大学 、中国电子技术标准化研究院 、诺基亚(中国)投资有限公司 、中国家用电器研究院 、三星电子(中国)研发中心 、广州市聚晖电子科技有限公司 、西门子(中国)有限公司 。
本标准的主要起草人 : 陈 任 、蒋 昊 、王 星 杰 、冯 承 文 、顾 清 坤 、余 荣 、谢 胜 利 、张 红 、田 晨 燕 、王 劲 松 、邴旭卫 、赵鹏 、熊张亮 、矫伟 、宋宝云 、李志伟 、范一兵 。
Ⅰ
GB/T 30246. 8—2013
引 言
家庭网络是指将家庭范畴里的音视频设备 、家用电器 、信息设备 、水电气暖计量表 、照明系统 、安防报警求助系统等连接在一起组成的一种局域网 ,各种终端设备通过家庭网络实现网络化 , 能够互联互通 ,实现各种网络化的管理和服务 ,实现资源和服务的共享 ,组成家庭信息 、娱乐 、控制的互联系统 。
Ⅱ
GB/T 30246. 8—2013
家庭网络
第 8 部分 :设备描述文件规范 XML格式
1 范围
GB/T 30246的本部分提出了家庭网络设备和服务描述文件的 XML表述形式 ,规定了 XML形式的设备和服务描述文件的数据类型 、格式和文件结构 。
本部分适用于家庭或类似的室内场所的网络构建 。
2 规范性引用文件
下列文件对于本文件的应用是必不可少的 , 凡是注 日期的引用文件 ,仅注 日期的版本适用于本文件 。凡是不注日期的引用文件 ,其最新版本(包括所有的修改单)适用于本文件 。
ISO/IEC 29341-1:2008 信息技术 UPnP设 备 结 构 第 1 部 分 : UPnP设 备 体 系 结 构 版 本 1. 0 (Information technology—UPnP device architecture—Part1:UPnP device architecture version 1. 0)
ISO/IEC 29341-3:2008 信息技术 UPnP设备结构 第 3 部分 : 音视 频 控 制 协 议(Information technology—UPnP device architecture—Part3:Audio video controlprotocol)
IEC 62481-1:2007 数字生活网络联盟家庭网络设备互操作导则 第 1 部分 :结构和协议[Digital living network alliance(DLNA) home network interoperability guidelines—Part 1: Architecture and protocols]
3 术语、定义和缩略语
3. 1 术语和定义
下列术语和定义适用于本文件 。
3. 1. 1
设备描述文件 devicedescription file
用来描述家庭网络设备自身功能 、属性和命令的文件 。
3. 1.2
设备注册表 deviceregistry
存储在家庭网络的网关或者控制终端中 ,描述家庭网络内该网关或者控制终端管辖下的已注册设备信息的列表 。
注 : 设备注册后 ,要在家庭网络设备注册表中添加新入 网 设 备 的 信 息 ; 已 注 册 设 备 注 销 后 ,要 删 除 设 备 注 册 表 中 对应的项 。
3. 1.3
媒体设备 media device
能够提供音视频内容传输及管理 、存储或呈现相关服务 ,并能够被媒体控制点发现及控制的逻辑功能实体 。
3. 1.4
媒体控制点 media controlpoint
能够对媒体设备及其服务进行发现及控制的逻辑功能实体 。
1
GB/T 30246. 8—2013
3. 1.5
设备类型 device type
具备一定媒体管理 、媒体传输或控制功能 ,并可以独立进行测试认证的实体 。
3. 1.6
设备描述 devicedescription
对设备的属性 、能力 、识别标识等信息的描述 ,包括供应商信息 、所有内含设备的定义 、设备演示的URL 以及所有服务的枚举 ,家庭多媒体与数据网络中的设备描述采用可扩展置标语言(XML) 。
3. 1.7
服务描述 servicedescription
对操作及其参数 、状态变量及其数据类型 、范围和事件特征等信息的描述 ,包括指令或操作列表以及每个操作的 参 数 、状 态 变 量 列 表 等 。 家 庭 多 媒 体 与 数 据 网 络 中 的 服 务 描 述 采 用 可 扩 展 置 标 语 言(XML) 。
3. 1. 8
服务 service
具有执行操作 、更新状态及发布状态更新等功能的控制单元 。
3.2 缩略语
下列缩略语适用于本文件 。
AVT:音视频内容传输(Audio Video Transport)
DLNA:数字生活网络联盟(Digital Living Network Alliance)
DMS:数字媒体服务器(DigitalMedia Server)
DMR:数字媒体播放器(DigitalMedia Renderer)
FXPP:灵活的 XML处理框架(Flexible XML Processing Profile)
HTTP:超文本传输协议(HyperTextTransferProtocol)
RFC:征求意见(Requestfor Comments)
UPC:通用产品代码(UniversalProductCode)
UPnP:1. 通用即插即用(UniversalPlug and Play) ;2. UPnP论坛(UPnP Forum)
URI:统一资源标识符(Uniform Resource Identifier)
URL:统一资源定位器(Uniform Resource Locator)
URN:统一资源名称(Uniform Resource Name)
UUID:全球唯一标识符(Universally Unique Identifier)
XML:可扩展置标语言(eXtensible Markup Language)
4 设备和服务的 XML表述形式
4. 1 概述
使用 XML来表述设备描述文件的规范和要求 , 主要包括设备描述和服务描述两个部分 。设备描述是对设备本身及其功能的描述 ,包括特定厂商 、制造商信息 、模块名称和编号 、序列号 、制造商名称 、特定厂商网站 URL, 以及设备所能提供的服务和功能列表等 。 服务描述主要是对具体的每项服务的 描述 ,包括一系列命令 、动作 , 以及服务的响应和相关参数和变量的描述 。
控制点或控制终端发现了一个设备之后 ,从发现消息中获得根设备的设备描述信息 。如需与设备交互或获取设备的进一步信息,控制点应对得到的根设备描述文件的 URL发出 HTTP GET请求,以得到相应的设备和服务的描述文件 ,流程如图 1所示 。
2
GB/T 30246. 8—2013
图 1 设备和服务描述的获取流程图
图 1 中 ,根设备是指没有被嵌入到其他设备的逻辑设备 ,嵌入设备是指嵌入到其他逻辑设备中的设备 。根设备和嵌入设备都有自身的设备和服务描述 ,一个根设备可以包含一个或者多个嵌入设备 。设备描述文件由厂商采用 XML语法 ,设备描述模板和服务描述模板见 4. 3. 1 和 4. 4. 1。
4.2 设备注册表
4.2. 1 概述
在中心节点模式下 , 中心节点搜集媒体设备信息 ,生成在设备注册表并保存于中心节点 。
4.2.2 设备注册表描述模板
〈rootxmlns= "urn:schemas-UPnP-org:device-1-0"
〈? xmlversion= "1. 0"?〉
xmlns:chns= "urn:schemas-chns:registry-1-0"〉
〈specVersion〉
〈major〉1〈/major〉
〈minor〉0〈/minor〉 〈/specVersion〉
〈chns:X_registry〉 〈chns:X_device〉
〈chns:X_index〉设备列表的索引/chns:X_index〉
〈chns:X_name〉设备名称〈/chns:X_name〉
〈UDN〉uuid:UUID〈/UDN〉
〈chns:X_deviceType〉设备类型〈/chns:X_ deviceType〉
〈chns:X_status〉设备状态〈/chns:X_status〉
〈chns:X_networkId〉设备的网络地址(例如 IP地址)〈/chns:X_ networkId〉
〈chns:X_DDFURL〉设备描述文件的 URL〈/chns:X_DDFURL〉
〈/chns:X_device〉
设备注册表中其他设备的相应描述放在这里 。
〈/chns:X_registry〉
〈/root〉
对设备注册表模板中各元素的说明如下 :
xml:必选 ,所有 XML文件都要求 ,要区分大小写 ,指明使用 XML描述 ,并指定 XML 的版本 。
root:必选 ,应采用 urn:schemas-chns:registry-1-0作为 xmlns属性值 , 区分大小写 ,是整个设备描
述的根元素 ,包含 specVersion,包含以下子元素 :
3
GB/T 30246. 8—2013
a) major:必选 ,表示设备注册表主版本 ,应设为 1;
b) minor:必选 ,表示设备注册表副版本 ,应设为 0;
c) X_registry:必选 ,且仅有一个 ,表示设备注册表的根元素 ;
d) X_device:可选 ,可以有 0个或多个 ,表示在设备注册表中的一个设备 ,包含以下子元素 :
1) X_index:必选 ,标识该设备在设备注册表中的顺序 ;
2) X_name:必选 ,表示设备的名称 ;
3) UDN:必选 ,唯一设备名称 ;设备的全球唯一标识符 ,无论是根设备还是嵌入式设备 , 随着时间的推移 ,应对具体设备保持一致 ,应与设备发现消息中的 NT 标头值相匹配 ;应与所有发现消息中的 USN标头前缀相匹配 ;应以“uuid:”开头 ;
4) X_deviceType:必选 ,表示设备类型 ;
5) X_status:必选 ,表示设备当前的最新状态 ,字符串类型 ;
6) X_networkId:必选 ,表示设备的网络地址(例如 IP地址) ;
7) X_DDFURL:必选 ,设备的设备描述文件的 URL,具体由厂商决定 。单一 URL。
4.2.3 设备注册表模式定义
设备注册表模式定义见附录 A。针对数字媒体服务器 、数字媒体播放器 、中心节点设备 、控制类设备的设备描述模板参见附录 D。
4.3 设备描述形式
4.3. 1 设备描述模板
4.3. 1. 1 概述
使用 XML对设备进行描述时 ,设备的描述文件应遵循本部分所定义的设备描述模板 。应使用设备描述模板来描述特定厂商信息 、设备控制 URL、嵌入式设备以及设备所提供的服务列表等 。设备描述由厂商按照设备描述模板用 XML来编写 ,设备描述模板用来定义整体设备类型 ,而每个具体的设备描述则是由厂商将具体信息添加到模板中 。
设备描述模板的定义如下 ,其中元素 、元素的属性以及嵌套关系由设备描述模式(schema)定义 ,每个元素的具体 赋 值 则 由 厂 商 设 置 。设 备 类 型(urn: schemas-upnp-org: device: deviceType) 、服 务 类 型(urn:schemas-upnp-org:service:serviceType)和服 务 标 识(urn: upnp-org: serviceId: serviceID) 具 体 表述见 ISO/IEC 29341-1:2008。
4.3. 1.2 设备描述模板定义
1
0
所有相关 URL 的基本 URL
urn:schemas-upnp-org:device:deviceType:v
面向用户的设备名称
4
GB/T 30246. 8—2013
〈manufacturer〉制造商名称〈/manufacturer〉
〈manufacturerURL〉制造商网站的 URL〈/manufacturerURL〉
〈modelDescription〉面向用户的设备型号名称〈/modelDescription〉
〈modelName〉型号名称〈/modelName〉
〈modelNumber〉型号〈/modelNumber〉
〈modelURL〉型号网站的 URL〈/modelURL〉
〈serialNumber〉制造商的序列号〈/serialNumber〉
〈UDN〉uuid:UUID〈/UDN〉
〈UPC〉统一产品编码〈/UPC〉
〈iconList〉
〈icon〉
〈mimetype〉image/format〈/mimetype〉
〈width〉水平像素〈/width〉
〈height〉垂直像素〈/height〉
〈depth〉颜色深度〈/depth〉
〈url〉指向图标的 URL〈/url〉
〈/icon〉
声明其他图标的 XML放在这里 。
〈/iconList〉
〈serviceList〉
〈service〉
〈serviceType〉urn:schemas-upnp-org:service:serviceType:v〈/serviceType〉
〈serviceId〉urn:upnp-org:serviceId:serviceID〈/serviceId〉
〈SCPDURL〉服务描述的 URL〈/SCPDURL〉
〈controlURL〉控制的 URL〈/controlURL〉
〈eventSubURL〉事件订阅的 URL〈/eventSubURL〉
〈/service〉
ISO/IEC 29341-1:2008中定义的其他服务描述可以放在这里 。
厂商自定义的服务描述可以放在这 。
〈/serviceList〉
〈deviceList〉
ISO/IEC 29341-1:2008中定义的其他嵌入式设备描述可以放在这里 。
厂商自定义的设备描述可以放在这里 。
〈/deviceList〉
〈presentationURL〉展示的 URL〈/presentationURL〉
〈/device〉
〈/root〉
以下是对设备描述模板中出现的元素 、属性和值的详细说明 。其中所有元素和属性都要区分大小写 ,URL要区分大小写 , 同一级中的元素的顺序可以任意调整 。
xml:必选 。所有 XML文件都要求 ,要区分大小写 ,指明使用 XML描述 ,并指定 XML 的版本 。
root:必选 。应采用 urn:schemas-UPnP-org:device-1-0作为 xmlns属性值 , 区分大小写 ,是整个设
备描述的根元素 ,包含以下子元素 :
specVersion:必选 ,包含以下子元素 :
5
GB/T 30246. 8—2013
major:必选 。表示设备架构主版本 ,应设为 1。
minor:必选 。设备架构副版本 ,应设为 0。
URLBase:可选 。定义基础 URL, 描 述 中 其 他 地 方 出 现 的 所 有 相 关 URL都 以 这 个 URL作 为 基础 ,和基础 URL拼接之后成为完整的 URL,只能是单个的 URL,具体的赋值由厂商决定 。
Device:必选 。表示一个设备描述开始的根元素 ,包含以下子元素 :
deviceType:必选 。描述设备类型 。
对于 ISO/IEC 29341-1:2008定义的标准 设 备 , 应 以 urn: schemas-UPnP-org: device开 头 , 后 面 带有设备类型后缀 、冒号和整数设备版本(如上面列表所示) 。
对于厂商指定的非标准设备 ,应以 urn:开头 ,带有厂商域名 ,还有 : device: ,后面是设备类型后缀 、冒号和整数设备版本 , 即 urn:domain-name:device:deviceType:v。
设备类型后缀由 ISO/IEC 29341-1:2008定义或由厂商来规定 ,应不多于 64个字符 ,版本后缀不计算在内 ,并且用冒号隔开 ,为单一的 URI。
friendlyName:必选 。对于 终 端 用 户 的 简 短 描 述 , 应 该 完 成 本 地 化(参 见 ACCEPT-/CONTENT- LANGUAGE标头) ,具体由厂商决定 。字符串 。不得多于 64个字符 。
manufacturer:必选 。制造商名称 ,可以进行本地化(参见 ACCEPT-/CONTENT-LANGUAGE标头) 。具体由厂商决定 。字符串 ,不得多于 64个字符 。
manufacturerURL:可选 。指向制造商网站 , 可以进行本地化(参见 ACCEPT-/CONTENT-LAN- GUAGE标头) 。可能与基础 URL相关 ,具体由厂商决定 ,为单一 URL。
modelDescription:推 荐 使 用 。 关 于 型 号 的 详 细 描 述 。 应 该 完 成 本 地 化 ( 参 见 ACCEPT-/ CONTENT-LANGUAGE标头) 。具体由厂商决定 。字符串 。不得多于 128个字符 。
modelName:必选 。 型 号 名 称 。 可 以 进 行 本 地 化 (参 见 ACCEPT-/CONTENT-LANGUAGE标头) 。具体由厂商决定 。字符串 。不应多于 32个字符 。
modelNumber:推荐使用 。型号 。可以进行本地化(参见 ACCEPT-/CONTENT-LANGUAGE标头) 。具体由厂商决定 。字符串 。不应多于 32个字符 。
modelURL:可选 。 关 于 该 型 号 的 网 站 资 源 。 可 以 进 行 本 地 化 (参 见 ACCEPT-/ CONTENT- LANGUAGE标头) 。可能与基础 URL相关 。具体由厂商决定 。单一的 URL。
serialNumber:推荐使用 。序列号 。 可以进行本地化(参 见 : ACCEPT-/CONTENT-LANGUAGE标头) 。具体由厂商决定 。字符串 。应少于 64个字符 。
UDN:必选 。 唯一设备名称 。设备的全球唯一标识符 ,无论是根设备还是嵌入式设备 。 随着时间的推移 ,应对具体设备保持一致(即应在重启后继续保持不变) 。应与设备发现消息中的 NT标头值相匹配 。应与所有发现消息中的 USN标头前缀相匹配 。应以 uuid:开头 ,后面带有厂商指定的 UUID后缀 。单一 URI。
UPC:可选 。通用产品代码 。 12位全数字代码 ,用于确定销售包装 。 由厂商决定 。单一 UPC。
iconList:仅当设备有一个或多个图标时必选 。具体由厂商决定 。包含以下子元素 :
icon:推荐使用 。 网 关 或 控 制 终 端 UI 中 描 述 设 备 的 图 标 。 可 以 进 行 本 地 化 (参 见 ACCEPT-/ CONTENT-LANGUAGE标头) 。下列每个尺寸推荐一个图标(宽度 ×高度 ×深度) : 16× 16× 1、16× 16×8、32×32×1、32×32×8、48×48×1、48×48× 8。包含以下子元素 :
mimetype:必选 。 图标的 MIME类型(参见 RFC 2387) 。单一 MIME 图像类型 。
width:必选 。 图标的水平尺寸 ,用像素 、整数表示 。
height:必选 。 图标的垂直尺寸 ,用像素 、整数表示 。
depth:必选 。色彩位的数量 ,用像素 、整数表示 。
url:必选。指向图标图像,可以通过 HTTP取得。可能与基础 URL相关。具体由厂商决定。单一 URL。
6
GB/T 30246. 8—2013
serviceList:必选 。包含以下子元素 :
service:必选 。对于 ISO/IEC 29341-1:2008定义的每项服务要重复一次 。如果厂商通过添加额外的标准服务来区分设备 ,则对于额外服务也要重复一次 。包含以下子元素 :
a) serviceType:必选 。服务类型 。不得包含散列符( #) 。
1) 对于由 ISO/IEC 29341-1:2008定义的标准服务类型 ,应以 urn:schemas-UPnP-org:serv- ice:开头 , 随后是服务类型后缀和整数服务版本 ;
2) 对于由厂商指定的非标准服务类型 ,应以 urn:开头 , 随后是厂商域名 ,然后是 : service: ,接着 是 服 务 类 型 后 缀 、冒 号 和 整 数 服 务 版 本 , 即 urn: domain- name: service: serviceType:v;
3) 由 ISO/IEC 29341-1:2008定义或厂商具体指定的服务类型后缀不得多于 64个字符 , 版本后缀不计算在内 ,并且用冒号隔开 。单一 URI。
b) serviceId:必选 。服务标识符 。在这一设备描述中应保持唯一性 。
1) 对于由 ISO/IEC 29341-1:2008定义的标准服务 ,应以 urn:UPnP-org: serviceId: 开头 ,后面是服务 ID后缀 ;
2) 对于由厂商指定的非标准服务 ,应以 urn:开头 , 随后是厂商域名 ,然后是 :serviceId: ,接着是服务 ID后缀 , 即 urn:domain-name:serviceId:serviceID;
3) 服务 ID 后 缀 由 ISO/IEC 29341-1: 2008定 义 或 由 厂 商 指 定 , 不 得 超 过 64个 字 符 。 单
一 URI。
SCPDURL:必选 。服务描述的 URL。可能与基础 URL相关 。具体由厂商决定 。单一 URL。
controlURL:必选 。控制的 URL。可能与基础 URL相关 。具体由厂商决定 。单一 URL。
eventSubURL:必选 。事件订阅的 URL。 可能与基础 URL相关 。在设备 内 部 可 能 是 唯 一 的 ; 不会有两个服务拥有相同的事件 URL。如果服务没有事件变量 ,则它应该没有事件 ;如果服务没有事件 ,则该元 素 应 展 示 出 来 , 但 是 应 该 为 空 , 即 < eventSubURL> 。 具 体 由 厂 商 决 定 。 单一 URL。
deviceList:仅当根设备带有嵌入式设备时必选 。包含以下子元素 :
device:必选 。对于 ISO/IEC 29341-1:2008定义的每项嵌入式设备要重复一次 。如果厂商通过嵌入其他设备来区分设备 ,则对于每个嵌入式设备要重复一次 。根据上面的定义 ,包含面向根子元素设备的子元素 。
presentationURL:推荐使用 。设 备 展 示 的 URL。 可 能 与 基 础 URL相 关 。具 体 由 厂 商 决 定 。 单一 URL。
为了获得未来可扩展性 ,在处理上述 XML时要遵守灵活 XML处理框架(FXPP) ,设备和网关或控制终端应忽略 :
a) 任何未知元素及其子元素或内容 ;
b) 任何未知属性及其值 。
XML不支持直接嵌入的二进制数据 ,如设备描述中的图标 。二进制数据可以转换为文本(从而嵌入 XML 中)使用 bin. base64(用于二进制数据的一种 MIME型的基础 64编码)或 bin. hex(代表八位字节的十六进制数字)的 XML数据类型 。此外 ,通过在 XML 中嵌入一个 URL并传输数据以响应单独的 HTTP请求,数据可以进行间接传递并保持原样;设备描述中的图标将以后一种方式进行传送。
4.3.2 设备描述模式
设备描述模式定义见附录 B。
7
GB/T 30246. 8—2013
4.4 服务描述形式
4.4. 1 服务描述模板
4.4. 1. 1 概述
服务描述模板定义了服务的动作及其变量 ,还有状态变量及其数据类型 、范围等 。每个服务可能有零或多个动作 。每个动作可能有零个或多个状态变量 。这些变量的任何组合可能是输入或输出参数 。如果一个动作有一个或多个输出变量 ,那么这些变量中的一个可能被标记为返回值 ,每个变量都应该对应一个状态变量 。每个服务应有一个或多个状态变量 。
除了定义 ISO/IEC 29341-1:2008定义的标准服务外 ,厂商可以为标准设备添加新的动作和服务 。
服务描述模板中的元素 、元素的属性以及嵌套关系由设备架构定义的服务描述模式来定义 ,元素和属性的具体赋值由 ISO/IEC 29341-1:2008或者厂商定义 。
4.4. 1.2 服务描述模板定义
〈? xmlversion= "1. 0"?〉
〈scpd xmlns= "urn:schemas-UPnP-org:service-1-0"〉
〈specVersion〉
〈major〉1〈/major〉
〈minor〉0〈/minor〉
〈/specVersion〉
〈actionList〉
〈action〉
〈name〉操作名称〈/name〉
〈argumentList〉
〈argument〉
〈name〉正式的参数名称〈/name〉
〈direction〉in xor out〈/direction〉
〈retval/〉
〈relatedStateVariable〉状态变量名称〈/relatedStateVariable〉
〈/argument〉
ISO/IEC 29341-1:2008中定义的其他参数的声明可以放在这里
〈/argumentList〉
〈/action〉
ISO/IEC 29341-1:2008中定义的其他操作的声明可以放在这里 。
厂商添加的其他操作可以放在这里 。
〈/actionList〉
〈serviceStateTable〉
〈name〉变量名称〈/name〉
〈stateVariable sendEvents= "yes"〉
〈dataType〉变量数据类型〈/dataType〉
〈defaultValue〉默认值〈/defaultValue〉
〈allowedValueList〉
〈allowedValue〉枚举的值〈/allowedValue〉
8
GB/T 30246. 8—2013
ISO/IEC 29341-1:2008中定义的其他允许的取值放在这里 。
变量名称
变量数据类型
默认值
最小值
最大值
增量
ISO/IEC 29341-1:2008中定义的其他状态变量可以放在这里 。
厂商自定义的其他状态变量可以放在这里 。
以下是对上述列表中出现的元素 、属性和值的详细说明 。所有元素和属性均区分大小写 ; 除特别注明外 ,值不区分大小写 。 除特别注明外 ,元素的顺序无关紧要 。 除特别注明外 ,必选元素应出现一次(无重复) ,推荐或可选元素最多只能出现一次 。
xml:要求所有 XML文件采用 。 区分大小写 。
scpd:必选 。应采用 urn: schemas-UPnP-org: service-1-0作 为 xmlns属 性 值 。 区 分 大 小 写 。 包 含
所有描述服务的其他元素 , 即包含以下子元素 :
a) specVersion:必选 。包含以下子元素 :
1) major:必选 。设备架构主版本 。应为 1。
2) minor:必选 。设备架构副版本 。应为 0。
b) actionList:仅当服务带有动作时必选(每个服务可以有 0个或多个动作) 。
action:必选 。对于 ISO/IEC 29341-1:2008定义的每项动作要重复一次 。如果厂商通过添加额外的动作来区分服务 ,则对于每个额外的动作都要重复一次 。包含以下子元素 :
a) name:必选 。动作的名称 。不得包含连字符(-)和散列符( #) 。
1) 对于 ISO/IEC 29341-1:2008定义的标准动作 ,不得以 X_和 A_开头 ;
2) 对于厂商指定的添加到标准服务的非标准动作 ,应使用 X_开头 ;
3) 字符串 。不超过 32个字符 。
b) argumentList:仅当为动作定义参数时必选(每个动作都可以有不少于 0个参数) 。
c) argument:必选 。为每个参数重复一次 。包含以下子元素 。
1) name:必选 。正式参数的名称 。应该是动作所影响的模型的状态变量的名称 。不得包含连字符(-) 。字符串 。应该不超过 32个字符 。
2) direction:必选 。指明变量是输入还是输出参数 。应设为 “in”或 “out”其中的一个 。所有的输入参数都应列在输出参数之前 。
3) retval:可选 。指明最多一个输出参数作为返回值 。 如果包括 ,应作为第一个输出参数的子元素 。
4) relatedStateVariable:必选 。应是一个状态变量的名称 。
serviceStateTable:必选(每个服务至少有 1个状态变量) 。包含以下子元素 :
9
GB/T 30246. 8—2013
a) stateVariable:必选 。对于 ISO/IEC 29341-1:2008定义的每个状态变量都要重复一次 。如果厂商通过添加额外的状态变量来区分服务 ,则对于每个额外变量都要重复一次 。 sendEvents属性将定义当这一状态变量的值发生变化时是否生成事件消息 ;非事件状态变量采用 sendE-
b) name(vents)=:必“选(no)”。,状态变量(缺省为 s)e的名称(ndEve)n。ts得“y包(es)含”。连字符(-,在 UTF-8 中为 2D Hex) 。
1) 对于 ISO/IEC 29341-1:2008定义的标准变量 ,不得以 X_和 A_开头 ;
2) 对于厂商指定为标准服务添加的非标准变量 ,应使用 X_开头 ;
3) 字符串 。不超过 32个字符 。
c) dataType: 必 选 。 与 XML 模 式 , 部 分 2: 数 据 类 型 中 定 义 的 数 据 类 型 相 同 。 由 ISO/IEC 29341-1:2008定义的类型用于标准状态变量 ; 由厂商指定的类型用于扩展 。
d) defaultValue:推荐使用 。默认的初始值 。 由 ISO/IEC 29341-1:2008定义或由厂商自己定义 。应匹配数据类型以及满足 allowedValueList或 allowedValueRange限制 。
e) allowedValueList: 推 荐 使 用 。 列 举 合 法 的 字 符 串 赋 值 。 应 为 字 符 串 。 只 能 规 定 allowed- ValueRange和 allowedValueList其中之一 。包含以下子元素 :
1) allowedValue:必选 。字符串变量的合法值 。 由 ISO/IEC 29341-1:2008定义的类型用于标准状态变量 ; 由厂商指定的类型用于扩展 。应该不超过 32个字符 。
2) allowedValueRange:推荐使用 。为定义取值的合法范围 ,仅对数字类型的数据进行定义 。只能规定 allowedValueRange和 allowedValueList其中之一 。包含以下子元素 :
— minimum:必选 。取值的 下 限 。 由 ISO/IEC 29341-1: 2008定 义 或 厂 商 定 义 。 单 一数值 。
— maximum:必选 。取值的 上 限 。 由 ISO/IEC 29341-1: 2008定 义 或 厂 商 地 难 以 。 单一数值 。
— IEC(Step)2:9341(推荐)使-1用:20。08定义或委托给厂商定义(增量运算时间隔的大小),。也单(就)一是数(操)值(作)。v= v+ s 中 s 的值 。 由 ISO/
“和 ”字符( &)不允 许 出 现 在 XML 中 。 如 果 需 要 作 为 XML元 素(如 一 个 URL) 的 值 的 一 部 分 ,
“和 ”符号应转换为 &(HTML)或 %26(URL转义码) 。
与设备描述不同 ,服务描述及相关值应该不使用位置相关的值 ;其中包括服务描述 、动作变量值 、以及状态变量值 。与此相反 ,大多数动作变量和状态变量都应该使用与位置相独立的值表示方法 ;应用应该进行转换和/或格式化 ,将信息从标准形式变为适合场所的正确的语言和/或格式 。
4.4.2 服务描述模式
服务描述模式定义见附录 C。服务描述应用实例参见附录 E。
4.5 描述形式的厂商扩展方式
厂商可能通过包括额外的服务以及嵌入式设备来区分他们的设备并扩展标准设备 。 同样的 ,厂商也可 以 通 过 包 括 额 外 的 动 作 或 状 态 变 量 来 扩 展 标 准 服 务 。 厂 商 不 得 通 过 修 改 标 准 化 的allowedValueList来扩展标准服务 。表 1列出了针对每种类型的命名惯例 ,并给出详细说明 。
表 1 设备和服务描述的厂商扩展方式
扩展类型
标准
非标准
设备类型
urn:
schemas-UPnP-org:device:deviceType:v
Urn:
domain-name:device:deviceType:v
10
GB/T 30246. 8—2013
表 1 (续)
扩展类型
标准
非标准
服务类型
urn:
schemas-UPnP-org:service:serviceType:v
Urn:
domain-name:service:serviceType:v
服务 ID
urn:
UPnP-org:serviceId:serviceID
Urn:
domain-name:serviceId:serviceID
动作名称
不要以 X_或 A_开头
用 X_开头
状态变量名称
不要以 X_或 A_开头
用 X_开头
设备 或 服 务 描 述 中 的XML元素
遵循设备或服务描述模式进行定义
由 XML名称空 间 确 定 范 围 并 位 于 以 X_ 开头的一个元素内的任意 XML
设备 或 服 务 描 述 中 的XML属性
遵循设备或服务描述模式进行定义
由 XML名称空间确定范围并以 X开头的任意属性
根据表 1 中说 明 , 厂 商 可 以 向 设 备 或 服 务 描 述 添 加 非 标 准 XML。 每 个 添 加 项 应 在 厂 商 提 供 的XML名称空间的范围内 。任意 XML应包括以 X_ 开头的元素 ,该元素应是包含子元素的标准元素的子元素 。非标准属性也可以添加到标准元素中 ,但是这些属性应在 XML命名范围内而且以 X_ 开头 。具体的厂商扩展方式如下 :
xmlns:n= "domain-name:schema-name">
other XML
other XML
other XML
RootStandardElement:必选 。一个标准的根元素 。xmlns属性定义了命名空间 ,在这种情况下 ,一个标准名称空间和一个非标准名称空间(带有前缀 n) 。
a) 对于设备描述 ,应是 root;
b) 对于服务描述 ,应是 scpd。
AnyStandardElement:必选 。任何标准元素 ,无论是根元素还是其他元素 ,无论是文本内容还是元素本身 ,应已经成为标准的设备或服务描述的组成部分 。X_VendorAttribute为厂商自定义的属性 ,应以 X_开头(前缀 A_ 已经作为保留字) 。名称可以为一个任意的字符串值 。
arbitrary XML
EltOnlyStandardElement:必选 。元素只包含元素的内容 。应已经成为标准的设备或服务描述的组成部分 。
a) 对于设备描述 ,应是下列之一 :root、specVersion、device、iconList、icon、serviceList、service和/或 deviceList;
11
GB/T 30246. 8—2013
b) 对 于 服 务 描 述 , 应 是 下 列 之 一: scpd、actionList、action、argumentList、argument、serviceSta- teTable、stateVariable、allowedValueList和/或 allowedValueRange。
X_VendorElement:必选 。厂商自定义的元素 ,应用 X_开头(前缀 A_ 已经作为保留字) 。应有面向xmlns属性的值 。可以包括任意 XML。
根据灵活的 XML处理框 架(FXPP) 的 规 定 , 不 了 解 这 些 XML 添 加 项 的 网 关 或 控 制 终 端 应 将 其忽略 。
12
GB/T 30246. 8—2013
附 录 A
(规范性附录)
设备注册表模式定义
xmlns= "urn:schemas-microsoft-com:xml-data"
xmlns:upnp= "urn:schemas-UPnP-org:device-1-0"
xmlns:dt= "urn:schemas-microsoft-com:datatypes"
>
targetNamespace= ”urn:schemas-chns”
"
elementtype(elementtype)"(")X(X)_DD(stat)F(u)U(s)"RL(dt)":td(y)t(e)e(”)ru(n)ri(g”)>
elementtype(elementtype)""_in(n)a(d)m(ex)e(")"d(dt)t::ttyp(yp)e”st(nt)g(>)”/>
13
GB/T 30246. 8—2013
附 录 B
(规范性附录)
设备描述模式定义
B. 1 概述
设备描述模式(Device Description Schema)定义了设备描述模板所应遵守的格式 、结构 、属性和数据类型 。设备描述模式用 XML语法编写 , 由 ISO/IEC 29341-1:2008制定 ,源自 XML模式 。XML模式提供了一套 XML解释 , 以便表达语言概念 ,如必选 、可选元素 、元素嵌套以及取值的数据类型等(还有其他与此处无关的属性) 。
B.2 设备描述模式定义
xmlns= urn:schemas-microsoft-com:xml-data
S?chem(xm)la(v)na(er)""d(1)e.v(0)ice("?)1-0" "
xmlns:dt= "urn:schemas-microsoft-com:datatypes">
"
14
elementtype(elementtype)"(")manufacturerUR(manufacturer"/)>L" minOccurs= "0" maxOccurs= "1" />
ElementTypename(ElementTypename) "dev(UR)ice(LB)"(a)c(s)o(e)nt(d)e(t)n:t(t)"(e)ltO(u)n(r)l(i)y"ontent= textOnly />
elementtype(elementtype) "modelURL(modelNum)em(r)"inO(m)ic(n)cu(O)rs(cc)"(s)""m(0)"axOc(max)cu(O)rs(cc)"(s)""/(1)/>
GB/T 30246. 8—2013
" " " "
15
GB/T 30246. 8—2013
XML模式元素 、属性和所用值的说明如下 :
ElementType:用 XML语言定义一种元素类型 ,名称属性定义了元素的名称 。dt:type属性定义了元素值的数据类型 。
Element:定义上述数据类型中的一个元素 , 以表明嵌套关系 。
0。maxOccurs属性定义了元素应出现的最多次数 ;缺省为 maxOccurs = 1;元素显示一次或多次使用
minOccurs属性定义了元素应出现的最少次数 ;缺省为 minOccurs = 1;可选元素为 minOccurs =
maxOccurs = * 。
16
GB/T 30246. 8—2013
附 录 C
(规范性附录)
服务描述模式定义
C. 1 概述
服务描述模式(Service Description Schema)定义了服务描述模板所应遵守的格式 、结构 、属性和数据类型 。服 务 描 述 模 式 用 XML 语 法 编 写 , 由 ISO/IEC 29341-1: 2008 进 行 制 作 , 源 自 XML 模 式 。 XML模式提供了一套 XML解释 , 以便表达语言概念 ,如必选与可选元素 、元素嵌套以及取值的数据类型等(还有其他与此处无关的属性) 。服务描述模式和服务描述模板全部为机器可读型 ,所以 自动工具可以 自动进行检查以确保后两者拥有所有必选的元素 ,在正确的嵌套内 ,而且有正确数据类型的值 。
C.2 服务描述模式定义
xmlns= urn:schemas-microsoft-com:xml-data
S?chem(xm)la(v)na(er)m(s)io"s(")rvi(0")c?-1-0" "
xmlns:dt= "urn:schemas-microsoft-com:datatypes">
ElementTypename(ElementTypename)"(")actionL(minor")is(d)t(t)":tcon(ype)n(")t(i)"(")eltOn(conte)ly(n) "textOnly" />
17
GB/T 30246. 8—2013
" " " "
" " " "
" " "
"
" " " "
XML模式元素 、属性和所用值的说明如下 :
a) attribute:指出特定元素可能或应定义的相关属性 。 与任何 XML元素类似 ,属性元素可能有
b) At(它)tr(自)ib(己)ute(的)Typ(属性)e。:定(可)义(以)一定个(义)属(该)性(属)的类型(性是否)。应与任(出现)何;可XML(选属)元(性)素类似(表示为)r属(qu)性ire元(d)可(n)o能。有 它 自 己 的 属
性 。将使用属性类型元素内的名称属性来定义属性的名称 。
c) element:定义上述数据类型中的一个元素 , 以表明嵌套关系 。 minOccurs属性定义了元素应
18
GB/T 30246. 8—2013
发生的最少次数 ;缺省为 minOccurs = 1;可选元素有 minOccurs = 0。maxOccurs属性定义
了元素应发生的 最 多 次 数 ; 缺 省 为 maxOccurs = 1;元 素 显 示 一 次 或 多 次 使 用 maxOccurs
d) lem(*)e。ntType:定义一种元素类型 。名称属性定义元素名称 。 dt:type属性用定义元素值的数
e) group:将内容组织到一个组中以便规定顺序 。 minOccurs属性定义了组应发生的最少次数 。
包含字(据类型)符。串的元素应该用(内容属性指示可)c(以)ont(包)t(的)textO(容类型)nl;y只。包含其他元素应该用 content = eltOnly;只
maxOccurs属性定义了组应发生的最大次数 。order属性限制 了 元 素 的 顺 序 ; 当 最 多 只 能 出现一个元素时 ,order = one。
19
GB/T 30246. 8—2013
附 录 D
(资料性附录)
分类设备描述模板
D. 1 数字媒体服务器设备描述
〈〈r?oot(x)mxlm(v)lns(ers)"(n)rn(")1:.s(0)ch(")mas-upnp-org:device-1-0"〉
〈specVersion〉
〈major〉1〈/major〉
〈minor〉0〈/minor〉
〈/specVersion〉
〈URLBase〉所有相关 URL 的基 URL〈/URLBase〉
〈device〉
〈deviceType〉urn:schemas-upnp-org:device:MediaServer:1〈/deviceType〉
〈friendlyName〉对用户友好的简短设备名称〈/friendlyName〉
〈manufacturer〉制造商名称〈/manufacturer〉
〈manufacturerURL〉制造商网站的 URL〈/manufacturerURL〉
〈modelDescription〉对用户友好的设备型号名称〈/modelDescription〉
〈modelName〉型号名称〈/modelName〉
〈modelNumber〉型号〈/modelNumber〉
〈modelURL〉型号网站的 URL〈/modelURL〉
〈serialNumber〉制造商的序列号〈/serialNumber〉
〈UDN〉uuid:UUID〈/UDN〉
〈UPC〉统一产品编码〈/UPC〉
〈dDM(lna):S(X)-5(D)0(L)NADOC xmlns:dlna= "urn:schemas-dlna-org:device-1-0"〉
〈/dlna:X_DLNADOC〉
〈iconList〉
〈icon〉
〈mimetype〉image/format〈/mimetype〉
〈width〉水平像素〈/width〉
〈height〉垂直像素〈/height〉
〈depth〉颜色深度〈/depth〉
〈url〉指向图标的 URL〈/url〉
〈/icon〉
声明其他图标的 XML放在这里 。
〈/iconList〉
〈serviceList〉
〈service〉
〈serviceType〉urn:schemas-upnp-org:service:ContentDirectory:1〈/serviceType〉
20
GB/T 30246. 8—2013
〈serviceId〉urn:upnp-org:serviceId:ContentDirectory〈/serviceId〉
〈SCPDURL〉服务描述的 URL〈/SCPDURL〉
〈controlURL〉控制的 URL〈/controlURL〉
〈eventSubURL〉发送事件的 URL〈/eventSubURL〉
〈/service〉
〈service〉
〈serviceType〉urn:schemas-upnp-org:service:ConnectionManager:1〈/serviceType〉
〈serviceId〉urn:upnp-org:serviceId:ConnectionManager〈/serviceId〉
〈SCPDURL〉服务描述的 URL〈/SCPDURL〉
〈controlURL〉控制的 URL〈/controlURL〉
〈eventSubURL〉发送事件的 URL〈/eventSubURL〉
〈/service〉
〈service〉
〈serviceType〉urn:schemas-upnp-org:service:AVTransport:1〈/serviceType〉
〈serviceId〉urn:upnp-org:serviceId:AVTransport〈/serviceId〉
〈SCPDURL〉服务描述的 URL〈/SCPDURL〉
〈controlURL〉控制的 URL〈/controlURL〉
〈eventSubURL〉发送事件的 URL〈/eventSubURL〉
〈/service〉
厂商自定义的其他服务放在这里 。
〈/serviceList〉
〈deviceList〉
厂商添加的嵌入式设备描述放在这里 。
〈/deviceList〉
〈presentationURL〉展示的 URL〈/presentationURL〉
〈/device〉
〈/root〉
D.2 数字媒体播放器设备描述
〈rootxmlns= "urn:schemas-upnp-org:device-1-0"〉
〈? xmlversion= "1. 0"?〉
〈specVersion〉
〈major〉1〈/major〉
〈minor〉0〈/minor〉
〈/specVersion〉
〈URLBase〉所有相关 URL 的基 URL〈/URLBase〉
〈device〉
〈deviceType〉urn:schemas-upnp-org:device:MediaRenderer:1〈/deviceType〉
〈friendlyName〉对用户友好的简短设备名称〈/friendlyName〉
〈manufacturer〉制造商名称〈/manufacturer〉
〈manufacturerURL〉制造商网站的 URL〈/manufacturerURL〉
〈modelDescription〉对用户友好的设备型号名称〈/modelDescription〉
21
GB/T 30246. 8—2013
〈modelName〉型号名称〈/modelName〉
〈modelNumber〉型号〈/modelNumber〉
〈modelURL〉型号网站的 URL〈/modelURL〉
〈serialNumber〉制造商的序列号〈/serialNumber〉 〈UDN〉uuid:UUID〈/UDN〉
〈UPC〉统一产品编码〈/UPC〉
〈dDM(lna):R(X)-_150(DL)NADOC xmlns:dlna= "urn:schemas-dlna-org:device-1-0"〉
〈/dlna:X_DLNADOC〉
〈iconList〉
〈icon〉
〈mimetype〉image/format〈/mimetype〉
〈width〉水平像素〈/width〉
〈height〉垂直像素〈/height〉
〈depth〉颜色深度〈/depth〉
〈url〉指向图标的 URL〈/url〉 〈/icon〉
声明其他图标的 XML放在这里 。
〈/iconList〉 〈serviceList〉
〈service〉
〈serviceType〉urn:schemas-upnp-org:service:RenderingControl:1〈/serviceType〉 〈serviceId〉urn:upnp-org:serviceId:RenderingControl〈/serviceId〉
〈SCPDURL〉服务描述的 URL〈/SCPDURL〉
〈controlURL〉控制的 URL〈/controlURL〉
〈eventSubURL〉发送事件的 URL〈/eventSubURL〉 〈/service〉
〈service〉
〈serviceType〉urn:schemas-upnp-org:service:ConnectionManager:1〈/serviceType〉 〈serviceId〉urn:upnp-org:serviceId:ConnectionManager〈/serviceId〉
〈SCPDURL〉服务描述的 URL〈/SCPDURL〉
〈controlURL〉控制的 URL〈/controlURL〉
〈eventSubURL〉发送事件的 URL〈/eventSubURL〉 〈/service〉
〈service〉
〈serviceType〉urn:schemas-upnp-org:service:AVTransport:1〈/serviceType〉 〈serviceId〉urn:upnp-org:serviceId:AVTransport〈/serviceId〉
〈SCPDURL〉服务描述的 URL〈/SCPDURL〉
〈controlURL〉控制的 URL〈/controlURL〉
〈eventSubURL〉发送事件的 URL〈/eventSubURL〉 〈/service〉
厂商自定义的其他服务放在这里 。
〈/serviceList〉
22
GB/T 30246. 8—2013
〈deviceList〉
厂商添加的嵌入式设备描述放在这里 。
〈/deviceList〉
〈presentationURL〉展示的 URL〈/presentationURL〉
〈/device〉 〈/root〉
D.3 中心节点设备描述
〈rootxmlns= "urn:schemas-upnp-org:device-1-0"〉
〈? xmlversion= "1. 0"?〉
〈specVersion〉
〈major〉1〈/major〉
〈minor〉0〈/minor〉
〈/specVersion〉
〈URLBase〉所有相关 URL 的基 URL〈/URLBase〉
〈device〉
〈deviceType〉urn:schemas-upnp-org:device:MediaServer:1〈/deviceType〉 〈friendlyName〉对用户友好的简短设备名称〈/friendlyName〉
〈manufacturer〉制造商名称〈/manufacturer〉
〈manufacturerURL〉制造商网站的 URL〈/manufacturerURL〉
〈modelDescription〉对用户友好的设备型号名称〈/modelDescription〉 〈modelName〉型号名称〈/modelName〉
〈modelNumber〉型号〈/modelNumber〉
〈modelURL〉型号网站的 URL〈/modelURL〉
相关推荐
- GB/T 3211-2023 金属铬
- GB/T 29711-2023 清晰版 焊缝无损检测 超声检测 焊缝内部不连续的特征
- GB/T 41515-2022 涂布机术语
- GB/T 5023.4-2008 额定电压450∕750V及以下聚氯乙烯绝缘电缆 第4部分:固定布线用护套电缆
- GB 55037-2022 建筑防火通用规范
- GB 51270-2017 镁冶炼厂工艺设计标准 清晰版
- GB/T 28807.2-2017 轨道交通 机车车辆和列车检测系统的兼容性 第2部分:与轨道电路的兼容性
- GB/T 29716.1-2013 机械振动与冲击 信号处理 第1部分:引论
- GB/T 10479-2009 铝制铁道罐车
- GB 55006-2021 钢结构通用规范

