YD_T 2743-2014移动终端设备应用程序开放接口技术要求.pdf

ICS 33.060L 11YD中华人民共和国通信行业标准YD/T2743-2014移动终端设备应用程序开放接口技术要求Technicalrequirements ofapplicationopeninterfaceonmobiledevice2014-10-14发布2014-10-14实施中华人民共和国工业和信息化部发布 YD/T2743-2014目次范围·规范性引用文件..缩略语·移动微件管理架构·4.1设备接口模块4.2加速器（accelerometer）模块4.3方向（orientation）模块.4.4照相（camera）模块.4.5设备状态（devicestatus）模块4.6文件系统（filesystem）模块4.7消总（messaging）模块.4.8地址位置（gcolocation）模块4.9个人信息管理（pim）模块*4.10联系人（contact）模块124.11月历（calendar）模块4.12任务（sk）模快4.13设备交互（deviceinteration）模块 YD/T2743-2014次结构的虚拟文件系统的访间，但不能访间设备文件系绕其他部分。每个虚拟根具有一个名称，虚报文件系统下的每个文件或目录以rootname/path方式表示其地址。其中rootname为虚报拟根名称，path为文件或目录相对于根的相对路径。该模块必须支持下述几类虚拟根：images:图像文件系统位置：videos:规频文件系统位置：music:音乐文件系统位置：documents:文档文件系绕位置：downloads:下载项日系统位置：wgt-package:widget package文件系统位置(readonly location);wgt-private:widget私有存储文件系统位置；wgt-private-tmp:widget临时私有存储文件系统位置：Temovable:可操除存储区域文件系统位置。为访问.上述各个特定位置的文件系统，需要调用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用于以设定模式打开文件。TeadAsText读取DOMString类型的文件内容。copyTo从·“个给定位置将文件或目录Copy至另一个位置，moveTo从一个给定位置将文件或目录move至另一个位置，createDirectory创建个目录。createFile创建一个空的新文件。resolve解析已有的文件或目录相对路径获取File句柄。deleteDirectory删除目录。deleteFile删除文件。8 YD/TileFilter接口用于限制（过滤）listFiles方法返回的项。FileStream接口表示打开文件的句柄，用于对文件进行读写操作，FileStream接口包括下述儿个方法：close用于关闭FileStream。Tead从FileStream中读指定数量日的字符。TeadBytes从FileStream中读指定数量日的字节。TeadBase64从FileStrecam中读指定数量目的字节，并以base64进行编码。write将指定字符（DOMString）写入FileStream.writeBytes将指定字节写入FileStream.writeBase64将base64的字符（DomString）转