YD/T 2743-2014
标准分类号
关联标准
出版信息
相关单位信息
标准简介
YD/T 2743-2014.Technical requirements of applicationopen interface on mobile device.
1范围
YD/T 2743规定了移动终端设备.上应用程序开放接口的属性及能力要求。
YD/T 2743适用于移动终端设备开放接口。
2规范性引用文件
下列文件对于本文件的应用是必不可少的。凡是注8期的引用文件，仅所注日期的版本适用于本文件。凡是不注日期的引用文件，其最新版本(包括所有的修改单)适用于本文件。
IETF RFC 2426 vCard MIME目录概况(vCard MIME Directory Profile)
3缩略语
下列缩略语适用于本标准。
AES The Advanced Encryption Standard 高级加密标准
AJAX Asynchronous JavaScript and XML 异步Java脚本语言和XML
4移动微件管理架构
移动微件管理整体架构如图1所示，包括设备接口模块、加速器模块、方向模块、照相模块、设备状态模块、联系人模块、任务模块、文件系统模块、消息模块、地理位置模块、PIM模块、日历模块、设备交互模块。所有的模块均作为微件对象出现，它是所有对象的基类。微件运行时环境处于所有模块的下方，负贵解释和执行相关的接口调用。
其中Widget对象提供了访问其所有直接子对象开放接口的机制。
1范围
YD/T 2743规定了移动终端设备.上应用程序开放接口的属性及能力要求。
YD/T 2743适用于移动终端设备开放接口。
2规范性引用文件
下列文件对于本文件的应用是必不可少的。凡是注8期的引用文件，仅所注日期的版本适用于本文件。凡是不注日期的引用文件，其最新版本(包括所有的修改单)适用于本文件。
IETF RFC 2426 vCard MIME目录概况(vCard MIME Directory Profile)
3缩略语
下列缩略语适用于本标准。
AES The Advanced Encryption Standard 高级加密标准
AJAX Asynchronous JavaScript and XML 异步Java脚本语言和XML
4移动微件管理架构
移动微件管理整体架构如图1所示，包括设备接口模块、加速器模块、方向模块、照相模块、设备状态模块、联系人模块、任务模块、文件系统模块、消息模块、地理位置模块、PIM模块、日历模块、设备交互模块。所有的模块均作为微件对象出现，它是所有对象的基类。微件运行时环境处于所有模块的下方，负贵解释和执行相关的接口调用。
其中Widget对象提供了访问其所有直接子对象开放接口的机制。
标准图片预览
标准内容
ICS33.060
中华人民共和国通信行业标准
YD/T2743-2014
移动终端设备应用
程序开放接口技术要求
Technical requirementsof applicationopeninterfaceonmobiledevice
2014-10-14发布
2014-10-14实施
中华人民共和国工业和信息化部发布前
范围·
2规范性引用文件
缩略语
移动微件管理架构
设备接口模块
4.2加速器（accelerometer）模块·4.3方向（orientation）模块
照相（camera）模块..
设备状态（devicestatus）模块：4.6
文件系统（filesystem）模块：消息（messaging）模块
4.8地址位置（geolocation）模块4.9个人信息管理（pim）模块*
4.10联系人（contact）模块：
4.11日历（calendar）模块：
4.12任务（task）模块：
4.13设备交互（deviceinteration）模块目
YD/T2743-2014
YD/T2743-2014
本标准按照GB1.1-2009给出的规则起草。本标准由中国通信标准化协会提出并归口。本标准起草单位：中国联合网络通信集团有限公司、中国移动通信集团公司、中国电信集团公司、诺基亚通信有限公司、电子科技大学成都研究院、北京邮电大学、中兴通讯股份有限公司、工业和信息化部电信研究院。
本标准主要起草人：廖军、陈博、顾曼霞、程宝平、陆钢、吴伟、王劲松、纪、元、彭锦
莫阳、莫建林、张勇、陈铁。
1范围
移动终端设备应用程序开放接口技术要求本标准规定了移动终端设备上应用程序开放接口的属性及能力要求。本标准适用于移动终端设备开放接口。2规范性引用文件
YD/T2743-2014
下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件，仅所注日期的版本适用于本文件。凡是不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件IETFRFC2426
3缩略语
vCardMIME目录概况（vCardMIMEDirectoryProfile）下列缩略语适用于本标准。
ECMAScript
TheAdvancedEncryptionStandardAsynchronous JavaScript and XMLAdaptive Multi Rate
Cascading Style Sheets
DRM Content Format
Device Management
Document Object Model
Digital Rights Management
Digital Signature Algorithm
Document Type Definition
HyperTextMarkup Language
Internationalized ResourceIdentifiersJava Script,Java
Multimedia Messaging ServiceOMADownload
Open Mobile Terminal PlatformRonRivest,AdiShamir和LeonardAdlemanReally Simple Syndication
Software Development Kit
Secure Hash Algorithm
Service Level Agreement
Short Messaging Service
高级加密标准
异步Java脚本语言和XML
可变速率
层叠样式表
DRM内容格式
设备管理
文档对象模型
数字版权管理
数字签名算法
文档类型定义
欧洲计算机制造商协会脚本语言超文本标记语言
国际资源标识符
脚本语言
多媒体消息业务
OMA下载
开放移动终端平台
加密算法
真实内容聚合
软件开发包
安全哈希算法
服务级别协议
短消息业务
YD/T2743-2014
Social Network Site
System On Chip
Service Provider
User Interface
UnstructuredSupplementaryServicesDataTheWorldWideWebConsortium
Extensible Markup Language
移动微件管理架构
社交网站
片上系统
业务提供商
用户界面
非结构化补充业务
万维网联盟
可扩展标记语言
移动微件管理整体架构如图1所示，包括设备接口模块、加速器模块、方向模块、照相模块、设备状态模块、联系人模块、任务模块、文件系统模块、消息模块、地理位置模块、PIM模块、日历模块、设备交互模块。所有的模块均作为微件对象出现，它是所有对象的基类。微件运行时环境处于所有模块的下方，负责解释和执行相关的接口调用。其中Widget对象提供了访问其所有直接子对象开放接口的机制。Widget对象
Deviceapi模块
加速器
文件系统
4.1设备接口模块
地理位置
设备状态
微件运行时
图1整体框架
联系人
设备交互
DeviceAPI模块是用于访问设备API的基本对象，提供了适用于其他所有模块的基本定义，如一般的回调调用成功和失败，GenericError接口，PendingOpreation接口。此外，deviceapis模块也为deviceapis指定了调点，及提供了检索已支持的和已启用的功能机制。4.2加速器（accelerometer）模块4.2.1模块介绍
acclerometer模块提供了使用设备加速传感器的API，具备获取设备加速计的信息的功能。加速计是种加速感应器，其能测量当前设备在3个不同坐标轴方向上的加速度。此模块允许程序员获得当前的加速度及订阅有关当前加速度的值发生改变的通知。2
以下三个方向的坐标轴用于检测当前的加速度：一X方向：在当前屏幕所在的平面内，且其正方向朝向屏幕的右手边。一Y方向：在当前屏幕所在的平面内，且其正方向朝向屏幕的顶部。-Z方向：与当前屏幕相垂直，且其正方向指向屏幕外。以上三个方向依据标准/默认的屏幕朝向而确立。YD/T2743-2014
加速度的度量单位为m/s2（国际单位）。重力也是一种加速度，它可能会影响以上各个方向的加速度并且它也必须被包括在以上三个方向的加速度值中，此值由具体实施方案返回。例如，将当前设备水平放置且后盖朝下，此时Z方向的加速度为9.8m/s2。如果当前设备处于自由落体状态且其后盖朝下，那么其Z方向的加速度则为0m/s2。4.2.2模块接口
interfaceAccelerometer
const floatEARTHGRAVITY=-9.8;void getCurrentAcceleration(AccelerationCB successCallbackoptionalErrorCB?errorCallback);longwatchAcceleration(AccelerationCB successCallback,optional ErrorCB?
errorCallback
optionalWatchOptions?options);void clearWatch(long watchid);3;
callback AccelerationCB = void(Acceleration axes);EARTH_GRAVITY：地球标准重力：getCurrentAccelerationO方法：用于请求设备的加速状态；watchAccelerationO方法：支持开发者接受加速通知：clearWatchO方法：停止监视加速通知。4.3方向（orientation）模块wwW.bzxz.Net
4.3.1模块介绍
orientation模块提供了使用设备方向传感器的API，可获取当前设备的方向信息。方向传感器提供了当前设备绕3个坐标轴旋转的方向信息。这3个坐标轴同样适用于acclermeter模块。一X方向：在当前屏幕所在的平面内，且其正方向朝向屏幕的右手边。Y方向：在当前屏幕所在的平面内，且其正方向朝向屏幕的顶部。一Z方向：与当前屏幕相垂直，且其正方向指向屏幕外。同时涉及的3个不同的角度如下：-Alpha角：当前设备绕Z轴旋转，且在N极与Y轴之间而形成的角度。需要指出的是，计算角度时需从Z轴出发逆时针转至当前的位置，单位为度。有效值可取0~360。-Beta角：当前设备绕X轴旋转所形成的角度，需要指出的是，计算角度时需从X轴出发逆时针3
YD/T2743-2014
转至当前的位置，单位为度。有效值为一180~180。Gemma角：当前设备绕Y轴旋转所形成的角度，需要指出的是，计算角度时需从Y轴出发逆时针转至当前的位置，单位为度。有效值可取一90~90。使用orientation模块的API，程序员可以获取当前的3个方向的值及订阅当旋转角度发生变化时的通知。
4.3.2模块接口
[NolnterfaceObject]
interface OrientationSensor fPendingOperation getCurrentOrientation(OrientationCB successCallback,optional ErrorCB? errorCallback);long watchOrientation(
OrientationCB successCallback,optional ErrorCB? errorCallbackoptional WatchOptions options);void clearWatch(long watchld);callback OrientationCB = void(Rotation angles):getCurrentOrientationO方法：用于请求设备的方向；WatchOrientationO方法：监控设备的方向传感器；clearWatchO：停止对方向的监控。[NolnterfaceObject]
interface Rotation f
readonly attribute short alpha;readonly attribute short beta;readonly attribute short gamma;3;
Rotation接口用于表示设备的方向角度。4.4照相（camera）模块
4.4.1模块介绍
camera模块中的API为widget提供了通过设备摄像机捕获媒体的API，如拍摄静态图片，拍摄视频片段及显示取景器。
尽管可使用的相机的数量及类型视当前设备的不同而有差异，但值得确定的是，使用此模块的API至少可以与主相机交互。
YD/T2743-2014
使用getCameraO方法可获得当前可使用的所有相机，并以列表形式显示，其中主相机（一般置于设备的背部）为此列表中的第一项。在使用相机拍摄时，widget指示用户需指定当前文件的存放位置及文件名。需要提出的是，使用此模块的API的拍摄时其操作为异步操作。4.4.2模块接口
[NolnterfaceObject]
interface DeviceapisCamera
readonly attribute CameraManager camera;;
Deviceapis implements DeviceapisCamera;Camera属性是访问CameraAPI的访问点。interface CameraManagerf
voidgetCaimeras(CameraCBsuccessCallbackoptional Function? errorCallback):callback CamerasCB = void(Camera cameras);getCamerasO方法：取得所有可被微件访问的设备摄像头：interface Cameraf
readonly attribute DOMString id;Void capturelmage(Function successCallback,optional ErrorCB? errorCallback,optional CameraOptions options):void startVideoCapture(FunctionsuccessCallbackoptional ErrorCB? errorCallback,optional CameraOptions options);void stopVideoCaptureO;
voidcreatePreviewNode(FunctionsuccessCallback,optional ErrorCB? errorCallback):YD/T2743-2014
captureImageO方法：异步抓取静态图像并保存到设备：startVideoCaptureO方法：开始捕捉视频；stopVideoCaptureO方法：停止视频捕捉：createPreviewNodeO方法：显示预览窗口。dictionaryCameraOptionsf
DOMString? destinationFilename;Boolean?highRes;
ameraOptions字典：指定拍摄的参数。4.5设备状态（devicestatus）模块4.5.1模块介绍
该提供访问设备状态信息的接口。设备状态信息对按照类别分组的属性（Property）以树型结构进行组织。接口（Interface）提供相应的方法（Method），以实现对该设备被状态信息树的浏览，实现获取所选属性值，及实现某些特定属性值发生变化时的异步通知。
设备状态树型信息由下述几个要素构成：一Aspect：设备状态字典由不同的Aspects构成，每个Aspect收集与设备某个方面相关的特定信息（如：”WebRuntime”，“Display”、”MemoryUnit”）。Component：一个Aspect包括不同的Component，Component描述同一Aspect的不同实例（Instance）（如：”Memory”Aspect可以有“Physical”、”Virtual”、“Storage”三种不同的实例)。有下述两种特殊的实例标识：
一_default：其指示为Aspect的缺省Componentactive：其指示为Aspect的活跃Component-Properties：Aspect由Property构成，Property提供Component的特定属性信息，如每个“MemoryUnit，Component，支持”size”、“avaibleszie”、”removable'这些属性。识别一个Property的强制（mandatory）参数为描述该Property及其相关联的Aspect的名称。在具体实现中没有指定其他参数时，首先搜索活跃Compnent，如果没有活跃Component则搜索缺省Component。该模块定义了对DeviceStatus属性的访间方式，但没有指定可以访问的Aspect或Property。要浏览完整的Property列表，可参考相应的属性分类文档。4.5.2模块接口
DeviceapisDeviceStatusManager定义了需要在Deviceapis对象中实例化的接口，并由所生成的deviceapis.devicestatus对象实现对该模块相关功能的访问。DeviceStatusManager接口实现了查询设备状态的API入口，提供了获取设备状态信息及订阅设备状态信息变化通知的相关功能。其包括下述几个方法：getComponents，用于返回指定Aspect实例的所有component的名称。isSupported，用于检查设备是否支持所指定的Aspect或Property。6
getPropertyValue，用于放回指定property值。-watchPropertyChange，用于注册property信息变化通知。clearPropertyChange，用于取消对property信息变化通知的注册。YD/T2743-2014
一接口PropertyRef用于完整地指定property，由相应的property名称、component名称及aspect名称共同确定，以对应字典中的某个property。其中“property”及”aspect”参数为强制要求，“component\参数可选。
接口WatchOptions指定在watchPropertyChange操作中的一组选择参数，minNotificationIntervalmaxNotificationInterval、minChangePercent。分别定义了触发属性信息变化通知所要求的最小通知间隔、最大通知间隔、最小变化比例。接口DeviceAPIError定义了设备当前不能获取property时的错误码。GetPropertySuccessCallback定义了成功执行获取property操作时的回调函数接口，通过触发onsuccess方法以通知成功获取某个property。一接口PropertyChangeSuccessCallback定义了通知property值改变的回调函数，通过触发onpropertychange方法通知某个指定的property值发生了改变。以http://wacapps.net/api/devicestatus表示的特性或该特性下的子特性被成功请求后，接口DeviceStatusManager实例化，并产生deviceapis.devicestatus对象。当在widgetconfig.xml中以http://wacapps.net/api/devicestatus.deviceinfo描述需要访问的特性时，可以访问下述Aspect：
Battery:
Device：
--Display
-MemoryUnit：
-OperatingSystem
WebRuntime
当在widgetconfig.xml中以http://wacapps.net/api/devicestatus.networkinfo描述需要访问的特性时，可以访问下述Aspect：
CellularHardware;
CellularNetwork;
-WiFiHardware:
-WiFiNetwor.
当在widgetconfig.xml中以http://wacapps.net/api/devicestatus描述需要访问的特性时，可以该模块中所有特性。
4.6文件系统（filesystem）模块4.6.1模块介绍
该模块提供访间设备文件系统的接口。该模块接口API提供对设备文件系统的访问。文件系统抽象表示为不相连的虚拟根路径下同文件系统的集合，不同文件系统对应于设备文件系统中的特定位置。文件系统API提供了对以根路径表示的其下层7
YD/T2743-2014
次结构的虚拟文件系统的访问，但不能访问设备文件系统其他部分。每个虚拟根具有一个名称，虚拟文件系统下的每个文件或目录以/方式表示其地址。其中为虚拟根名称，为文件或目录相对于根的相对路径。该模块必须支持下述几类虚拟根：images：图像文件系统位置；
videos：视频文件系统位置；
-music：音乐文件系统位置；
documents：文档文件系统位置；downloads：下载项目系统位置：wgt-package:widgetpackage文件系统位置(readonlylocation）：一wgt-private：widget私有存储文件系统位置；wgt-private-tmp:widget临时私有存储文件系统位置：removable:可擦除存储区域文件系统位置。为访问上述各个特定位置的文件系统，需要调用filesystem.resolve获取File句柄（handle），File句柄表示一个文件或文件。通过FileStream句柄打开文件以便进行读写操作。该模块对目录可列出或解析其下包含的文件或子目录内容。某些一些文件名称和路径特性依赖于终端平台（如最大路径。文件名长度、大小写敏感性、额外支持的字符等），该模块中需要防止跨平台设计时可能遇到的特定平台依赖特性。4.6.2模块接口
DeviceapisFileSystemManager定义了需要在Deviceapis对象中实例化的接口，并由所生成的deviceapis.filesystem对象实现对该模块相关功能的访问。FileSystemManager接口提供文件系统的基本API功能，如确定根位置和缺省位置，将给定位置解析为File句柄，为文件系统事件注册文件系统监听器等。其包括获取File句柄的resolve方法。File接口是对所使用文件的抽象。File句柄可定位文件或目录。File对象读写其或其下位置文件的权限取决于resolve方法中设定的模式（mode）。创建一个新的File对象，其集成原File对象的访问权限。表示一个文件的File句柄可被打开以进行读写等I/O操作，表示一个目录的File句柄可用于列举相应位置下的所有文件及目录。File接口包括下述几个方法：-toURI用于返回文件的URI。
—listFiles用于返回目录下的所有文件列表-openStream用于以设定模式打开文件。readAsText读取DOMString类型的文件内容。copyTo从一个给定位置将文件或目录Copy至另一个位置。-moveTo从一个给定位置将文件或目录move至另一个位置。createDirectory创建一个目录。一createFile创建一个空的新文件。一resolve解析已有的文件或目录相对路径获取File句柄。—deleteDirectory删除目录。
-deleteFile删除文件。
方法：
-FileFilter接口用于限制（过滤）listFiles方法返回的项。YD/T2743-2014
-FileStream接口表示打开文件的句柄，用于对文件进行读写操作。FileStream接口包括下述几个close用于关闭FileStream。
一read从FileStream中读指定数量目的字符。readBytes从FileStream中读指定数量目的字节。readBase64从FileStream中读指定数量目的字节，并以base64进行编码。write将指定字符（DOMString）写入FileStream.WriteBytes将指定字节写入FileStreamWriteBase64将base64的字符（DomString）转换为字节并写入FileStream。FileSystemSuccessCallback接口定义了进行文件进行异步操作（包括resolve、copy、move、delete操作）成功完成时返回的回调函数onsuccess。ReadFileAsStringSuccessCallback接口定义了进行文件异步操作（以字符方式读取文件内容）成功完成时返回的回调函数onsuccess.FileOpenSuccessCallback接口定义了打开文件进行初始操作成功完成时返回的回调函数onsuccess
FileSystemListSuccessCallback接口定义了文件列表异步操作成功完成时返回的回调函数onsuccessa
-DeviceAPIError接口定义了该模块的错误码。以http://wacapps.net/api/filesystem表示的特性或该特性下的子特性被成功请求后，接口FileSystemManager实例化，并产生deviceapis.filesystem对象。当在widgetconfig.xml中以http://wacapps.net/api/filesystem.read描述需要访问的特性时，可以访问除下述以外的功能：
copyTo;
moveTo;
createDirectory
createFile：
deleteDirectory
-deleteFile;
-openStreamwithwritemode(\w\)。当在widgetconfig.xml中以http:/wacapps.net/api/filesystem.write描述需要访问的特性时，可以访问除下述以外的功能：
-readAsText
openStream with read mode (\r\)。当在widgetconfig.xml中以http:/wacapps.net/api/filesystem描述需要访问的特性时，可以该模块中所有功能。
4.7消息（messaging）模块
小提示：此标准内容仅展示完整标准里的部分截取内容，若需要完整标准请到上方自行免费下载完整标准文档。
中华人民共和国通信行业标准
YD/T2743-2014
移动终端设备应用
程序开放接口技术要求
Technical requirementsof applicationopeninterfaceonmobiledevice
2014-10-14发布
2014-10-14实施
中华人民共和国工业和信息化部发布前
范围·
2规范性引用文件
缩略语
移动微件管理架构
设备接口模块
4.2加速器（accelerometer）模块·4.3方向（orientation）模块
照相（camera）模块..
设备状态（devicestatus）模块：4.6
文件系统（filesystem）模块：消息（messaging）模块
4.8地址位置（geolocation）模块4.9个人信息管理（pim）模块*
4.10联系人（contact）模块：
4.11日历（calendar）模块：
4.12任务（task）模块：
4.13设备交互（deviceinteration）模块目
YD/T2743-2014
YD/T2743-2014
本标准按照GB1.1-2009给出的规则起草。本标准由中国通信标准化协会提出并归口。本标准起草单位：中国联合网络通信集团有限公司、中国移动通信集团公司、中国电信集团公司、诺基亚通信有限公司、电子科技大学成都研究院、北京邮电大学、中兴通讯股份有限公司、工业和信息化部电信研究院。
本标准主要起草人：廖军、陈博、顾曼霞、程宝平、陆钢、吴伟、王劲松、纪、元、彭锦
莫阳、莫建林、张勇、陈铁。
1范围
移动终端设备应用程序开放接口技术要求本标准规定了移动终端设备上应用程序开放接口的属性及能力要求。本标准适用于移动终端设备开放接口。2规范性引用文件
YD/T2743-2014
下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件，仅所注日期的版本适用于本文件。凡是不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件IETFRFC2426
3缩略语
vCardMIME目录概况（vCardMIMEDirectoryProfile）下列缩略语适用于本标准。
ECMAScript
TheAdvancedEncryptionStandardAsynchronous JavaScript and XMLAdaptive Multi Rate
Cascading Style Sheets
DRM Content Format
Device Management
Document Object Model
Digital Rights Management
Digital Signature Algorithm
Document Type Definition
HyperTextMarkup Language
Internationalized ResourceIdentifiersJava Script,Java
Multimedia Messaging ServiceOMADownload
Open Mobile Terminal PlatformRonRivest,AdiShamir和LeonardAdlemanReally Simple Syndication
Software Development Kit
Secure Hash Algorithm
Service Level Agreement
Short Messaging Service
高级加密标准
异步Java脚本语言和XML
可变速率
层叠样式表
DRM内容格式
设备管理
文档对象模型
数字版权管理
数字签名算法
文档类型定义
欧洲计算机制造商协会脚本语言超文本标记语言
国际资源标识符
脚本语言
多媒体消息业务
OMA下载
开放移动终端平台
加密算法
真实内容聚合
软件开发包
安全哈希算法
服务级别协议
短消息业务
YD/T2743-2014
Social Network Site
System On Chip
Service Provider
User Interface
UnstructuredSupplementaryServicesDataTheWorldWideWebConsortium
Extensible Markup Language
移动微件管理架构
社交网站
片上系统
业务提供商
用户界面
非结构化补充业务
万维网联盟
可扩展标记语言
移动微件管理整体架构如图1所示，包括设备接口模块、加速器模块、方向模块、照相模块、设备状态模块、联系人模块、任务模块、文件系统模块、消息模块、地理位置模块、PIM模块、日历模块、设备交互模块。所有的模块均作为微件对象出现，它是所有对象的基类。微件运行时环境处于所有模块的下方，负责解释和执行相关的接口调用。其中Widget对象提供了访问其所有直接子对象开放接口的机制。Widget对象
Deviceapi模块
加速器
文件系统
4.1设备接口模块
地理位置
设备状态
微件运行时
图1整体框架
联系人
设备交互
DeviceAPI模块是用于访问设备API的基本对象，提供了适用于其他所有模块的基本定义，如一般的回调调用成功和失败，GenericError接口，PendingOpreation接口。此外，deviceapis模块也为deviceapis指定了调点，及提供了检索已支持的和已启用的功能机制。4.2加速器（accelerometer）模块4.2.1模块介绍
acclerometer模块提供了使用设备加速传感器的API，具备获取设备加速计的信息的功能。加速计是种加速感应器，其能测量当前设备在3个不同坐标轴方向上的加速度。此模块允许程序员获得当前的加速度及订阅有关当前加速度的值发生改变的通知。2
以下三个方向的坐标轴用于检测当前的加速度：一X方向：在当前屏幕所在的平面内，且其正方向朝向屏幕的右手边。一Y方向：在当前屏幕所在的平面内，且其正方向朝向屏幕的顶部。-Z方向：与当前屏幕相垂直，且其正方向指向屏幕外。以上三个方向依据标准/默认的屏幕朝向而确立。YD/T2743-2014
加速度的度量单位为m/s2（国际单位）。重力也是一种加速度，它可能会影响以上各个方向的加速度并且它也必须被包括在以上三个方向的加速度值中，此值由具体实施方案返回。例如，将当前设备水平放置且后盖朝下，此时Z方向的加速度为9.8m/s2。如果当前设备处于自由落体状态且其后盖朝下，那么其Z方向的加速度则为0m/s2。4.2.2模块接口
interfaceAccelerometer
const floatEARTHGRAVITY=-9.8;void getCurrentAcceleration(AccelerationCB successCallbackoptionalErrorCB?errorCallback);longwatchAcceleration(AccelerationCB successCallback,optional ErrorCB?
errorCallback
optionalWatchOptions?options);void clearWatch(long watchid);3;
callback AccelerationCB = void(Acceleration axes);EARTH_GRAVITY：地球标准重力：getCurrentAccelerationO方法：用于请求设备的加速状态；watchAccelerationO方法：支持开发者接受加速通知：clearWatchO方法：停止监视加速通知。4.3方向（orientation）模块wwW.bzxz.Net
4.3.1模块介绍
orientation模块提供了使用设备方向传感器的API，可获取当前设备的方向信息。方向传感器提供了当前设备绕3个坐标轴旋转的方向信息。这3个坐标轴同样适用于acclermeter模块。一X方向：在当前屏幕所在的平面内，且其正方向朝向屏幕的右手边。Y方向：在当前屏幕所在的平面内，且其正方向朝向屏幕的顶部。一Z方向：与当前屏幕相垂直，且其正方向指向屏幕外。同时涉及的3个不同的角度如下：-Alpha角：当前设备绕Z轴旋转，且在N极与Y轴之间而形成的角度。需要指出的是，计算角度时需从Z轴出发逆时针转至当前的位置，单位为度。有效值可取0~360。-Beta角：当前设备绕X轴旋转所形成的角度，需要指出的是，计算角度时需从X轴出发逆时针3
YD/T2743-2014
转至当前的位置，单位为度。有效值为一180~180。Gemma角：当前设备绕Y轴旋转所形成的角度，需要指出的是，计算角度时需从Y轴出发逆时针转至当前的位置，单位为度。有效值可取一90~90。使用orientation模块的API，程序员可以获取当前的3个方向的值及订阅当旋转角度发生变化时的通知。
4.3.2模块接口
[NolnterfaceObject]
interface OrientationSensor fPendingOperation getCurrentOrientation(OrientationCB successCallback,optional ErrorCB? errorCallback);long watchOrientation(
OrientationCB successCallback,optional ErrorCB? errorCallbackoptional WatchOptions options);void clearWatch(long watchld);callback OrientationCB = void(Rotation angles):getCurrentOrientationO方法：用于请求设备的方向；WatchOrientationO方法：监控设备的方向传感器；clearWatchO：停止对方向的监控。[NolnterfaceObject]
interface Rotation f
readonly attribute short alpha;readonly attribute short beta;readonly attribute short gamma;3;
Rotation接口用于表示设备的方向角度。4.4照相（camera）模块
4.4.1模块介绍
camera模块中的API为widget提供了通过设备摄像机捕获媒体的API，如拍摄静态图片，拍摄视频片段及显示取景器。
尽管可使用的相机的数量及类型视当前设备的不同而有差异，但值得确定的是，使用此模块的API至少可以与主相机交互。
YD/T2743-2014
使用getCameraO方法可获得当前可使用的所有相机，并以列表形式显示，其中主相机（一般置于设备的背部）为此列表中的第一项。在使用相机拍摄时，widget指示用户需指定当前文件的存放位置及文件名。需要提出的是，使用此模块的API的拍摄时其操作为异步操作。4.4.2模块接口
[NolnterfaceObject]
interface DeviceapisCamera
readonly attribute CameraManager camera;;
Deviceapis implements DeviceapisCamera;Camera属性是访问CameraAPI的访问点。interface CameraManagerf
voidgetCaimeras(CameraCBsuccessCallbackoptional Function? errorCallback):callback CamerasCB = void(Camera cameras);getCamerasO方法：取得所有可被微件访问的设备摄像头：interface Cameraf
readonly attribute DOMString id;Void capturelmage(Function successCallback,optional ErrorCB? errorCallback,optional CameraOptions options):void startVideoCapture(FunctionsuccessCallbackoptional ErrorCB? errorCallback,optional CameraOptions options);void stopVideoCaptureO;
voidcreatePreviewNode(FunctionsuccessCallback,optional ErrorCB? errorCallback):YD/T2743-2014
captureImageO方法：异步抓取静态图像并保存到设备：startVideoCaptureO方法：开始捕捉视频；stopVideoCaptureO方法：停止视频捕捉：createPreviewNodeO方法：显示预览窗口。dictionaryCameraOptionsf
DOMString? destinationFilename;Boolean?highRes;
ameraOptions字典：指定拍摄的参数。4.5设备状态（devicestatus）模块4.5.1模块介绍
该提供访问设备状态信息的接口。设备状态信息对按照类别分组的属性（Property）以树型结构进行组织。接口（Interface）提供相应的方法（Method），以实现对该设备被状态信息树的浏览，实现获取所选属性值，及实现某些特定属性值发生变化时的异步通知。
设备状态树型信息由下述几个要素构成：一Aspect：设备状态字典由不同的Aspects构成，每个Aspect收集与设备某个方面相关的特定信息（如：”WebRuntime”，“Display”、”MemoryUnit”）。Component：一个Aspect包括不同的Component，Component描述同一Aspect的不同实例（Instance）（如：”Memory”Aspect可以有“Physical”、”Virtual”、“Storage”三种不同的实例)。有下述两种特殊的实例标识：
一_default：其指示为Aspect的缺省Componentactive：其指示为Aspect的活跃Component-Properties：Aspect由Property构成，Property提供Component的特定属性信息，如每个“MemoryUnit，Component，支持”size”、“avaibleszie”、”removable'这些属性。识别一个Property的强制（mandatory）参数为描述该Property及其相关联的Aspect的名称。在具体实现中没有指定其他参数时，首先搜索活跃Compnent，如果没有活跃Component则搜索缺省Component。该模块定义了对DeviceStatus属性的访间方式，但没有指定可以访问的Aspect或Property。要浏览完整的Property列表，可参考相应的属性分类文档。4.5.2模块接口
DeviceapisDeviceStatusManager定义了需要在Deviceapis对象中实例化的接口，并由所生成的deviceapis.devicestatus对象实现对该模块相关功能的访问。DeviceStatusManager接口实现了查询设备状态的API入口，提供了获取设备状态信息及订阅设备状态信息变化通知的相关功能。其包括下述几个方法：getComponents，用于返回指定Aspect实例的所有component的名称。isSupported，用于检查设备是否支持所指定的Aspect或Property。6
getPropertyValue，用于放回指定property值。-watchPropertyChange，用于注册property信息变化通知。clearPropertyChange，用于取消对property信息变化通知的注册。YD/T2743-2014
一接口PropertyRef用于完整地指定property，由相应的property名称、component名称及aspect名称共同确定，以对应字典中的某个property。其中“property”及”aspect”参数为强制要求，“component\参数可选。
接口WatchOptions指定在watchPropertyChange操作中的一组选择参数，minNotificationIntervalmaxNotificationInterval、minChangePercent。分别定义了触发属性信息变化通知所要求的最小通知间隔、最大通知间隔、最小变化比例。接口DeviceAPIError定义了设备当前不能获取property时的错误码。GetPropertySuccessCallback定义了成功执行获取property操作时的回调函数接口，通过触发onsuccess方法以通知成功获取某个property。一接口PropertyChangeSuccessCallback定义了通知property值改变的回调函数，通过触发onpropertychange方法通知某个指定的property值发生了改变。以http://wacapps.net/api/devicestatus表示的特性或该特性下的子特性被成功请求后，接口DeviceStatusManager实例化，并产生deviceapis.devicestatus对象。当在widgetconfig.xml中以http://wacapps.net/api/devicestatus.deviceinfo描述需要访问的特性时，可以访问下述Aspect：
Battery:
Device：
--Display
-MemoryUnit：
-OperatingSystem
WebRuntime
当在widgetconfig.xml中以http://wacapps.net/api/devicestatus.networkinfo描述需要访问的特性时，可以访问下述Aspect：
CellularHardware;
CellularNetwork;
-WiFiHardware:
-WiFiNetwor.
当在widgetconfig.xml中以http://wacapps.net/api/devicestatus描述需要访问的特性时，可以该模块中所有特性。
4.6文件系统（filesystem）模块4.6.1模块介绍
该模块提供访间设备文件系统的接口。该模块接口API提供对设备文件系统的访问。文件系统抽象表示为不相连的虚拟根路径下同文件系统的集合，不同文件系统对应于设备文件系统中的特定位置。文件系统API提供了对以根路径表示的其下层7
YD/T2743-2014
次结构的虚拟文件系统的访问，但不能访问设备文件系统其他部分。每个虚拟根具有一个名称，虚拟文件系统下的每个文件或目录以
videos：视频文件系统位置；
-music：音乐文件系统位置；
documents：文档文件系统位置；downloads：下载项目系统位置：wgt-package:widgetpackage文件系统位置(readonlylocation）：一wgt-private：widget私有存储文件系统位置；wgt-private-tmp:widget临时私有存储文件系统位置：removable:可擦除存储区域文件系统位置。为访问上述各个特定位置的文件系统，需要调用filesystem.resolve获取File句柄（handle），File句柄表示一个文件或文件。通过FileStream句柄打开文件以便进行读写操作。该模块对目录可列出或解析其下包含的文件或子目录内容。某些一些文件名称和路径特性依赖于终端平台（如最大路径。文件名长度、大小写敏感性、额外支持的字符等），该模块中需要防止跨平台设计时可能遇到的特定平台依赖特性。4.6.2模块接口
DeviceapisFileSystemManager定义了需要在Deviceapis对象中实例化的接口，并由所生成的deviceapis.filesystem对象实现对该模块相关功能的访问。FileSystemManager接口提供文件系统的基本API功能，如确定根位置和缺省位置，将给定位置解析为File句柄，为文件系统事件注册文件系统监听器等。其包括获取File句柄的resolve方法。File接口是对所使用文件的抽象。File句柄可定位文件或目录。File对象读写其或其下位置文件的权限取决于resolve方法中设定的模式（mode）。创建一个新的File对象，其集成原File对象的访问权限。表示一个文件的File句柄可被打开以进行读写等I/O操作，表示一个目录的File句柄可用于列举相应位置下的所有文件及目录。File接口包括下述几个方法：-toURI用于返回文件的URI。
—listFiles用于返回目录下的所有文件列表-openStream用于以设定模式打开文件。readAsText读取DOMString类型的文件内容。copyTo从一个给定位置将文件或目录Copy至另一个位置。-moveTo从一个给定位置将文件或目录move至另一个位置。createDirectory创建一个目录。一createFile创建一个空的新文件。一resolve解析已有的文件或目录相对路径获取File句柄。—deleteDirectory删除目录。
-deleteFile删除文件。
方法：
-FileFilter接口用于限制（过滤）listFiles方法返回的项。YD/T2743-2014
-FileStream接口表示打开文件的句柄，用于对文件进行读写操作。FileStream接口包括下述几个close用于关闭FileStream。
一read从FileStream中读指定数量目的字符。readBytes从FileStream中读指定数量目的字节。readBase64从FileStream中读指定数量目的字节，并以base64进行编码。write将指定字符（DOMString）写入FileStream.WriteBytes将指定字节写入FileStreamWriteBase64将base64的字符（DomString）转换为字节并写入FileStream。FileSystemSuccessCallback接口定义了进行文件进行异步操作（包括resolve、copy、move、delete操作）成功完成时返回的回调函数onsuccess。ReadFileAsStringSuccessCallback接口定义了进行文件异步操作（以字符方式读取文件内容）成功完成时返回的回调函数onsuccess.FileOpenSuccessCallback接口定义了打开文件进行初始操作成功完成时返回的回调函数onsuccess
FileSystemListSuccessCallback接口定义了文件列表异步操作成功完成时返回的回调函数onsuccessa
-DeviceAPIError接口定义了该模块的错误码。以http://wacapps.net/api/filesystem表示的特性或该特性下的子特性被成功请求后，接口FileSystemManager实例化，并产生deviceapis.filesystem对象。当在widgetconfig.xml中以http://wacapps.net/api/filesystem.read描述需要访问的特性时，可以访问除下述以外的功能：
copyTo;
moveTo;
createDirectory
createFile：
deleteDirectory
-deleteFile;
-openStreamwithwritemode(\w\)。当在widgetconfig.xml中以http:/wacapps.net/api/filesystem.write描述需要访问的特性时，可以访问除下述以外的功能：
-readAsText
openStream with read mode (\r\)。当在widgetconfig.xml中以http:/wacapps.net/api/filesystem描述需要访问的特性时，可以该模块中所有功能。
4.7消息（messaging）模块
小提示：此标准内容仅展示完整标准里的部分截取内容，若需要完整标准请到上方自行免费下载完整标准文档。