ICS35.240.99 L66 中华人民共和国国家标准 GB/T32418—2015 信息技术 手持设备游戏软件接口要求 Informationtechnology—Interfacesrequirementofgamesoftware forhandhelddevices 2015-12-31发布 2016-07-01实施 中华人民共和国国家质量监督检验检疫总局 中国国家标准化管理委员会发布目 次 前言 Ⅰ ………………………………………………………………………………………………………… 1 范围 1 ……………………………………………………………………………………………………… 2 规范性引用文件 1 ………………………………………………………………………………………… 3 术语、定义和缩略语 1 ……………………………………………………………………………………… 4 概述 1 ……………………………………………………………………………………………………… 5 操作系统API 2 …………………………………………………………………………………………… 6 基础运行API 3 …………………………………………………………………………………………… 7 游戏运行API 6 …………………………………………………………………………………………… 附录A(资料性附录) 接口描述 8 …………………………………………………………………………GB/T32418—2015 前 言 本标准按照GB/T1.1—2009给出的规则起草。 请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别这些专利的责任。 本标准由全国信息技术标准化技术委员会(SAC/TC28)提出并归口。 本标准起草单位:浙江大学、中国电子技术标准化研究院、浙江大学城市学院。 本标准主要起草人:陈天洲、吴剑钟、俞立呈、潘练武、张雨松、赵毅、吴明晖、颜晖、王硕苹、彭彬、 蔡建平、郭鸣、霍梅梅、孙霖、沈虹、谢斌、叶敏娇、章铁飞、马建良、傅唯威、樊星、赵菁华。 ⅠGB/T32418—2015 信息技术 手持设备游戏软件接口要求 1 范围 本标准规定了手持设备游戏软件接口。 本标准适用于手持设备游戏软件接口的开发与设计。 2 规范性引用文件 下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件,仅注日期的版本适用于本文 件。凡是不注日期的引用文件,其最新版本(包括所有的修改单)适用于本文件。 GB/T16264.8—2005 信息技术 开放系统互连 目录 第8部分:公钥和属性证书框架 GB/T21023 中文语音识别系统通用技术规范 GB/T25654—2010 手持电子产品嵌入式软件API ISO/IEC/IEEE9945:2009 信息技术 可移植操作系统接口(POSIX)操作系统接口 Informationtechnology—Portableoperatingsysteminterface(POSIX)Operatingsysteminterface (POSIX) 3 术语、定义和缩略语 3.1 术语和定义 下列术语和定义适用于本文件。 3.1.1 手持设备游戏 handhelddevicegame 应用于手持终端设备的游戏软件。 3.2 缩略语 下列缩略语适用于本文件。 API 应用编程接口(ApplictionProgramingInterface) HTTP超文本传输协议(HypertextTransferProtocol) SSL安全套接层(SecuritySocketLayer) TTS文语转换(TextToSpeech) 4 概述 手持设备游戏软件可以分为操作系统API、基础运行API和游戏运行API三类,如图1所示。 注:这三类API都直接由游戏开发者调用,在本标准范围内不存在层次。 1GB/T32418—2015 图1 手持设备游戏软件接口结构 操作系统API描述了手持设备操作系统接口,提供了系统底层向上层软件的API接口,包括外设 管理、安全认证、异构计算、系统电源管理、网络连接状态控制。 基础运行API使得在上层软件开发过程中,可以无需调用操作系统类的API,而在基础运行API 上进行软件设计。基础运行API规定了用于手持设备游戏软件中基础运行平台部分所应提供的应用 编程接口,包括用户界面、多媒体和网络通信。 游戏运行API规定了游戏软件专用的编程接口,包括装饰件、游戏引擎管理、游戏内交易、排行榜、 社交和广告等方面的API。 接口描述参见附录A。 5 操作系统API 5.1 系统电源管理API 包括: a) 调用BatMag_SetBright设置屏幕亮度; b) 调用BatMag_Suspend和BatMag_Wakeup分别实现系统休眠和唤醒; c) 调用BatMag_AcquireLock,阻止系统进入休眠,并可以指定永久保持系统处于唤醒状态或设 定保持唤醒时间,超过设定时间后系统自动进入休眠状态; d) 调用BatMag_ReleaseLock允许系统自动进入休眠状态。 5.2 网络连接状态控制API 包括: a) 调用NetStat_GetAllNetworkInfo获取所有网络的状态信息,状态信息包括网络的类型和连 2GB/T32418—2015 接速度; b) 调用NetStat_GetActiveNetworkInfo获取当前活动网络的状态信息; c) 调用NetStat_SwitchToNetwork切换至某一类型网络。 5.3 外设管理API 5.3.1 系统能力和配置 包括: a) 调用Sys_GetAllDeviceID获取设备与设备ID的对应列表; b) 调用Sys_GetDeviceInfo获取对应设备的具体参数,获取的参数为字符串键值对集合,表明设 备的能力或配置情况。 5.3.2 设备电源管理 包括: a) 调用Dev_PowerOn开启指定设备的电源,并由系统对设备进行必要的初始化,使设备进入可 用的默认运行级别; b) 调用Dev_PowerOff关闭设备电源; c) 调用Dev_SetRunlevel设置设备的运行级别,不同级别表示该设备不同能耗和性能等级,由不 同设备定义。 5.4 异构计算API 包括: a) 调用HC_create_env创建运行所需的设备上下文环境; b) 调用HC_execute使用指定的可执行文件进行计算,此时计算将在后台异步地进行; c) 调用HC_wait可等待直到异步计算结束并获得相应的计算结果; d) 调用HC_destroy_env清理相关资源。 5.5 安全认证 操作系统API安全认证应符合GB/T25654—2010中6.3的要求和GB/T16264.8—2005第8章 的要求。 6 基础运行API 6.1 用户界面 6.1.1 画布和屏幕基础组件 画布和屏幕基础组件要求应符合GB/T25654—2010中6.1的要求。 6.1.2 用户界面异步线程管理 包括: a) 调用UI_AsyncTask_CreateTask创建一个异步线程; b) 调用UI_AsyncTask_StartTask让异步线程开始执行; c) 调用UI_AsyncTask_GetStatus获取线程是否执行完毕; d) 调用UI_AsyncTask_IsCancelled检查异步线程是否被取消; 3GB/T32418—2015 e) 调用UI_AsyncTask_DestroyTask结束线程执行,清理相关资源。 6.1.3 用户通知 包括: a) 调用UI_Notification_Create创建相应类型的用户通知,通知展示完毕后会被自动销毁; b) 调用UI_Notification_SetLights或UI_Notification_SetVibrato分别设置LED点亮的方式或 震动的模式; c) 调用UI_Notification_SetSound或UI_Notification_SetMessage分别设置是否播放提示音或 显示消息文字; d) 调用UI_Notification_Show向用户显示相应的通知信息。 6.1.4 周期性和定时任务 包括: a) 调用UI_Alarm_CreateTask指定要执行的任务、执行的延迟时间或周期后系统会在指定的时 刻自动调用相应的任务; b) 调用UI_Alarm_DestroyTask取消任务的执行并清理相关资源。 6.1.5 触摸屏输入 6.1.5.1 触点要求 触摸屏支持至少两点的多点触摸操作,在支持的范围内能够正确识别各个触点的位置,不出现位置 干扰。 6.1.5.2 输入事件 包括: a) 调用UI_Event_CreateListener创建一个对应的事件监听器; b) 调用UI_Event_GetAttribute获得时间的属性,如事件类型等。 6.1.5.3 屏幕手势 包括: a) 调用UI_Gesture_CreateStroke可从矢量数据创建一个笔画; b) 调用UI_Gesture_CreateGesture可从给定的笔画创建一个手势; c) 调用UI_Gesture_Input可在给定屏幕区域内注册需要识别的手势,当用户给出相应手势时系 统会出发相应的输入事件; d) 调用UI_Gesture_GetBounding可获得包围手势的边框坐标; e) 调用UI_Gesture_DestroyStroke或UI_Gesture_DestroyGesture结束不再使用的笔画或手 势,清理相关资源。 6.1.6