GB/T 32418-2015 信息技术 手持设备游戏软件接口要求

　　ICS 35.240.99 L 66

　　中 华 人 民 共 和 国 国 家 标 准

　　GB/T 32418—2015

　　信息技术 手持设备游戏软件接口要求

　　Information technology—Interfacesrequirementofgamesoftware

　　forhandhelddevices

　　2015-12-31发布 2016-07-01实施

　　中华人民共和国国家质量监督检验检疫总局中 国 国 家 标 准 化 管 理 委 员 会

　　发

　　布

　　GB/T 32418—2015

　　GB/T 32418—2015

　　前 言

　　本标准按照 GB/T 1. 1—2009给出的规则起草 。

　　请注意本文件的某些内容可能涉及专利 。本文件的发布机构不承担识别这些专利的责任 。

　　本标准由全国信息技术标准化技术委员会(SAC/TC28)提出并归 口 。

　　本标准起草单位 : 浙江大学 、中国电子技术标准化研究院 、浙江大学城市学院 。

　　本标准主要起草人 : 陈天 洲 、吴 剑 钟 、俞 立 呈 、潘 练 武 、张 雨 松 、赵 毅 、吴 明 晖 、颜 晖 、王 硕 苹 、彭 彬 、蔡建平 、郭鸣 、霍梅梅 、孙霖 、沈虹 、谢斌 、叶敏娇 、章铁飞 、马建良 、傅唯威 、樊星 、赵菁华 。

　　信息技术 手持设备游戏软件接口要求

　　1 范围

　　本标准规定了手持设备游戏软件接 口 。

　　本标准适用于手持设备游戏软件接口的开发与设计 。

　　2 规范性引用文件

　　下列文件对于本文件的应用是必不可少的 。凡是注 日期的引用文件 ,仅注 日期的版本适用于本文件 。凡是不注日期的引用文件 ,其最新版本(包括所有的修改单)适用于本文件 。

　　GB/T 16264. 8—2005 信息技术 开放系统互连 目录 第 8部分 :公钥和属性证书框架

　　GB/T 21023 中文语音识别系统通用技术规范

　　GB/T 25654—2010 手持电子产品嵌入式软件 API

　　ISO/IEC/IEEE 9945: 2009 信 息 技 术 可 移 植 操 作 系 统 接 口 (POSIX) 操 作 系 统 接 口

　　Information technology—Portable operating system interface(POSIX) Operating system interface (POSIX)

　　3 术语、定义和缩略语

　　3. 1 术语和定义

　　下列术语和定义适用于本文件 。

　　3. 1. 1

　　手持设备游戏 handheld devicegame

　　应用于手持终端设备的游戏软件 。

　　3.2 缩略语

　　下列缩略语适用于本文件 。

　　API 应用编程接口(Appliction Programing Interface)

　　HTTP 超文本传输协议(HypertextTransferProtocol)

　　SSL 安全套接层(Security SocketLayer)

　　TTS 文语转换(TextTo Speech)

　　4 概述

　　手持设备游戏软件可以分为操作系统 API、基础运行 API和游戏运行 API三类 ,如图 1所示 。

　　注 : 这三类 API都直接由游戏开发者调用 ,在本标准范围内不存在层次 。

　　GB/T 32418—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获取所有网络的状态信息 ,状态信息包括网络的类型和连

　　接速度 ;

　　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/T 25654—2010 中 6. 3 的要求和 GB/T 16264. 8—2005第 8 章的要求 。

　　6 基础运行 API

　　6. 1 用户界面

　　6. 1. 1 画布和屏幕基础组件

　　画布和屏幕基础组件要求应符合 GB/T 25654—2010中 6. 1 的要求 。

　　6. 1.2 用户界面异步线程管理

　　包括 :

　　a) 调用 UI_AsyncTask_CreateTask创建一个异步线程 ;

　　b) 调用 UI_AsyncTask_StartTask让异步线程开始执行 ;

　　c) 调用 UI_AsyncTask_GetStatus获取线程是否执行完毕 ;

　　d) 调用 UI_AsyncTask_IsCancelled检查异步线程是否被取消 ;

　　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 中文语音识别

　　中文语音识别应符合 GB/T 21023的要求 。

　　6. 1.7 TTSAPI

　　TTSAPI应符合 GB/T 25654—2010中 7. 5. 3 的要求 。

　　6.2 多媒体

　　多媒体 API应符合 GB/T 25654—2010中 7. 5 的要求 。

　　6.3 网络通信

　　6.3. 1 套接字

　　套接字应符合 ISO/IEC/IEEE 9945:2009中 2. 10对 Sockets接口的要求 。

　　包括以下接 口 :创建通信描述符 socket、绑定到本地地址 bind、接受传入连接 listen、等待传入连接accept、连接到远程地址 connect、发送数据 send、接收数据 recv、发送无连接数据 sendto、接收无连接数据 recvfrom、关闭连接 close、设置 Socket参数 setsockopt和获取 Socket参数 getsockopt。

　　6.3.2 安全套接字层

　　应符合 GB/T 25654—2010 中 6. 3. 2 SSL接 口 的 要 求 。包 括 以 下 接 口 : SSL协 议 栈 初 始 化 SSL_ init、创建安全会话 SSL_open、建立安全连接 SSL_ connect、发送数据 SSL_ write、读取数据 SSL_ read、关闭安全连接 SSL_close、获取会话状态 SSL_state和控制会话参数 SSL_ioctl。

　　6.3.3 HTTP客户端

　　HTTP客户端使用 HTTP协议与 Web服务器通信。 HTTP协议由客户端发起通信请求,请求的类型包括 GET 和 POST两种 ,请求包含了资源地址和请求头部参数 , GET 请求的请求数据参数保存在资源地址中 ,POST请求的请求数据参数保存在头部之后附加的请求数据主体中 。 服务器对请求的响应包括状态(请求是否成功)和可选的响应数据主体 。

　　HTTP客户端 API具体内容包括:

　　a) 调用 HTTPClient_Client创建一个连接到给定服务器主机的 HTTP客户端对象,此对象负责在客户端和服务器之间建立底层网络通信 ;

　　b) 调用 HTTPClient_Client_SetHeader设置头部参数;

　　c) 调用 HTTPClient_Get或 HTTPClient_Post创建相应方法的对象,参数为要发送给服务器端的数据 ;

　　d) 调用 HTTPClient_Entity_CreateFromForm或 HTTPClient_Entity_CreateFromStream 分别从表格或数据流创建 ;

　　e) 调用 HTTPClient_Client_Execute将客户端相应的头部和主体发送给服务器,并获得服务器响应 ;

　　f) 调用 HTTPClient_Response_GetStatus获得服务器响应状态;

　　g) 调用 HTTPClient_Response_GetEntity获得服务器返回的数据;

　　h) 调用 HTTPClient_Entity_GetStream或 HTTPClient_Entity_GetString把数据当作输出流或字符串读取 ;

　　i) 调用 HTTPClient_Entity_Destroy结束数据读取,清理相关资源;

　　j) 调用 HTTPClient_Client_Shutdown断开与服务器的网络连接。

　　6.3.4 信息推送服务

　　包括 :

　　a) 调用 PushNotification_Register在消息服务提供者处注册服务 , 以允许接收推送消息 ,并给出信息回调接 口 ;

　　b) 调用回调接 口 PushNotification_OnMessage被调用并传入消息 ;

　　c) 调用 PushNotification_Unregister取消接收推送消息服务 。

　　7 游戏运行 API

　　7. 1 游戏引擎管理

　　包括 :

　　a) 调用 GameEngine_Add向系统添加一个新的游戏引擎 ;

　　b) 调用 GameEngine_Delete移除相应的游戏引擎 ;

　　c) 调用 GameEngine_Search可根据游戏需求 ,搜索系统中已有的游戏引擎 。

　　7.2 游戏内交易

　　7.2. 1 游戏物品、服务购买或充值

　　包括 :

　　a) 调用 InGamePurches_RegisterAccount或 InGamePurches_UnregisterAccount注册或注销用户游戏账号 ;

　　b) 调用 InGamePurches_Transaction发起服务器交易 ,允许用户在特定游戏账户中购买相应的物品或服务 。

　　7.2.2 用户间虚拟资产交易

　　包括 :

　　调用 InGameTrading_TradeItem 发起用户间的虚拟资产交易 。

　　7.3 排行榜

　　包括 :

　　a) 调用 ScoreBoard_Adduser或 ScoreBoard_Deluser,创建或删除一个排行榜的用户名 ;

　　b) 调用 ScoreBoard_ModifyUser修改用户的信息 ,包括在排行榜上显示的昵称 、头像等 ;

　　c) 调用 ScoreBoard_DownUserInfo获取其他用户的信息 ;

　　d) 调用 ScoreBoard_DownInfo获得相应排行榜的榜单 ;

　　e) 调用 ScoreBoard_UpdateInfo将用户的游戏得分上传到相应的排行榜 。

　　7.4 社交

　　7.4. 1 好友系统

　　包括 :

　　a) 调用 SNS_UserRegister注册一个新的社交网络用户 ;

　　b) 调用 SNS_AddFriend、SNS_DelFriend可添加 、删除好友 ;

　　c) 调用 SNS_GetFriendInfo获取好友信息 ;

　　d) 调用 SNS_AddGroup或 SNS_DelGroup,添加或删除好友分组 ;

　　e) 调用 SNS_ModifyGroup修改好友分组名称 ;

　　f) 调用 SNS_SetFriendGroup,设定一个好友所属的好友分组 ;

　　g) 调用 SNS_ListFriend,列出分组中的所有好友 ;

　　h) 调用 SNS_SearchFriend,搜索整个好友列表 ;

　　i) 调用 SNS_SendMsg,向指定好友发送信息 。

　　7.4.2 游戏内聊天

　　包括 :

　　a) 调用 SNS_StartVoiceChat或 SNS_CloseVoiceChat,开启或关闭整个语音聊天功能 ;

　　b) 调用 SNS_CreatVCGroup或 SNS_JoinVCGroup,创建或加入一个语音聊天组 ;

　　c) 调用 SNS_ExitVCGroup,退出语音聊天组 ;

　　d) 调用 SNS_OpenTextMode或 SNS_CloseTextMode,打开或关闭聊天界面 。

　　7.5 广告

　　包括 :

　　a) 调用 AD_AddAd,在游戏中加入候选广告 ;

　　b) 调用 AD_DisplayAd,在指定的位置轮流显示预定广告 。

　　附 录 A (资料性附录)接 口 描 述

　　A. 1 操作系统 API

　　A. 1. 1 系统电源管理 API

　　BatMag_SetBright描述见表 A. 1。

　　表 A. 1

　　BatMag_Suspend描述见表 A. 2 。

　　表 A.2

　　BatMag_Wakeup描述见表 A. 3。

　　表 A.3

　　BatMag_AcquireLock描述见表 A. 4。

　　表 A.4

　　BatMag_ReleaseLock描述见表 A. 5。

　　表 A.5

　　A. 1.2 网络连接状态控制 API

　　NetStat_GetAllNetworkInfo描述见表 A. 6。

　　表 A.6

　　NetStat_GetActiveNetworkInfo描述见表 A. 7。

　　表 A.7

　　NetStat_ IsNetworkValid描述见表 A. 8。

　　表 A. 8

　　NetStat_SwitchToNetwork描述见表 A. 9。

　　表 A.9

　　A. 1.3 外设管理 API

　　A. 1.3. 1 系统能力和配置

　　Sys_GetAllDeviceID描述见表 A. 10。

　　表 A. 10

　　Sys_GetDeviceInfo描述见表 A. 11。

　　表 A. 11

　　A. 1.3.2 设备电源管理

　　Dev_PowerOn描述见表 A. 12。

　　表 A. 12

　　Dev_PowerOff描述见表 A. 13。

　　表 A. 13

　　Dev_SetRunlevel描述见表 A. 14。

　　表 A. 14

　　A. 1.3.3 定位

　　Loc_Locate描述见表 A. 15。

　　表 A. 15

　　Loc_RegisterListener描述见表 A. 16。

　　表 A. 16

　　Loc_UnRegisterListener描述见表 A. 17。

　　表 A. 17

　　A. 1.4 异构计算

　　HC_create_env描述见表 A. 18。

　　表 A. 18

　　HC_execute描述见表 A. 19。

　　表 A. 19

　　HC_wait描述见表 A. 20。

　　表 A.20

　　HC_destroy_env描述见表 A. 21。

　　表 A.21

　　A.2 基础运行 API

　　A.2. 1 用户界面

　　A.2. 1. 1 用户界面异步线程管理

　　UI_AsyncTask_CreateTask描述见表 A. 22。

　　表 A.22

　　UI_AsyncTask_StartTask描述见表 A. 23。

　　表 A.23

　　UI_AsyncTask_CancelTask描述见表 A. 24。

　　表 A.24

　　UI_AsyncTask_GetStatus描述见表 A. 25。

　　表 A.25

　　UI_AsyncTask_IsCancelled描述见表 A. 26。

　　表 A.26

　　UI_AsyncTask_DestroyTask描述见表 A. 27。

　　表 A.27

　　A.2. 1.2 用户通知

　　UI_Notification_Create描述见表 A. 28。

　　表 A.28

　　UI_Notification_SetLights描述见表 A. 29。

　　表 A.29

　　UI_Notification_SetSound描述见表 A. 30。

　　表 A.30

　　UI_Notification_SetVibrator描述见表 A. 31。

　　表 A.31

　　UI_Notification_SetMessage描述见表 A. 32。

　　表 A.32

　　UI_Notification_Show 描述见表 A. 33。

　　表 A.33

　　A.2. 1.3 周期性和定时任务

　　UI_Alarm_CreateTask描述见表 A. 34。

　　表 A.34

　　UI_Alarm_DestroyTask描述见表 A. 35。

　　表 A.35

　　A.2. 1.4 触摸屏输入

　　A.2. 1.4. 1 输入事件

　　UI_Event_CreateListener描述见表 A. 36。

　　表 A.36

　　UI_Event_SetResponse描述见表 A. 37。

　　表 A.37

　　UI_Event_GetAttribute描述见表 A. 38。

　　表 A.38

　　A.2. 1.4.2 屏幕手势

　　UI_Gesture_CreateStroke描述见表 A. 39。

　　表 A.39

　　UI_Gesture_DestroyStroke描述见表 A. 40。

　　表 A.40

　　UI_Gesture_CreateGesture描述见表 A. 41。

　　表 A.41

　　UI_Gesture_DestroyGesture描述见表 A. 42。

　　表 A.42

　　UI_Gesture_GetBounding描述见表 A. 43。

　　表 A.43

　　UI_Gesture_GetStrokes描述见表 A. 44。

　　表 A.44

　　UI_Gesture_Input描述见表 A. 45。

　　表 A.45

　　A.2.2 网络通信

　　A.2.2.1 HTTP客户端

　　HTTPClient_Get描述见表 A.46。

　　表 A.46

　　HTTPClient_Post描述见表 A.47。

　　表 A.47

　　HTTPClient_Client描述见表 A.48。

　　表 A.48

　　HTTPClient_Client_SetHeader描述见表 A.49。

　　表 A.49

　　HTTPClient_Client_Execute描述见表 A.50。

　　表 A.50

　　HTTPClient_Client_Shutdown描述见表 A.51。

　　表 A.51

　　HTTPClient_Response_GetStatus描述见表 A.52。

　　表 A.52

　　HTTPClient_Response_GetEntity描述见表 A.53。

　　表 A.53

　　HTTPClient_Entity_CreateFromForm描述见表 A.54。

　　表 A.54

　　HTTPClient_Entity_CreateFromStream描述见表 A.55。表 A.55

　　HTTPClient_Entity_GetStream描述见表 A.56。

　　表 A.56

　　HTTPClient_Entity_GetString描述见表 A.57。

　　表 A.57

　　HTTPClient_Entity_Destroy描述见表 A.58。

　　表 A.58

　　A.2.2.2 信息推送服务

　　PushNotification_Register描述见表 A. 59。

　　表 A.59

　　PushNotification_Unregister描述见表 A. 60。

　　表 A.60

　　PushNotification_OnMessage描述见表 A. 61。

　　表 A.61

　　A.3 游戏运行 API

　　A.3. 1 游戏引擎管理

　　GameEngine_Add描述见表 A. 62。

　　表 A.62

　　GameEngine_Delete描述见表 A. 63。

　　表 A.63

　　GameEngine_Search描述见表 A. 64。

　　表 A.64

　　A.3.2 游戏内交易

　　A.3.2. 1 游戏物品、服务购买或充值

　　InGamePurches_Transaction描述见表 A. 65。

　　表 A.65

　　InGamePurches_RegisterAccount描述见表 A. 66。

　　表 A.66

　　InGamePurches_UnregisterAccount描述见表 A. 67。

　　表 A.67

　　A.3.2.2 用户间虚拟资产交易

　　InGameTrading_TradeItem 描述见表 A. 68。

　　表 A.68

　　A.3.3 排行榜

　　ScoreBoard_Adduser描述见表 A. 69。

　　表 A.69

　　ScoreBoard_Deluser描述见表 A. 70。

　　表 A.70

　　ScoreBoard_ModifyUser描述见表 A. 71。

　　表 A.71

　　ScoreBoard_DownInfo描述见表 A. 72。

　　表 A.72

　　ScoreBoard_DownUserInfo描述见表 A. 73。

　　表 A.73

　　ScoreBoard_UpdateInfo描述见表 A. 74。

　　表 A.74

　　A.3.4 社交

　　A.3.4. 1 好友系统

　　SNS_UserRegister描述见表 A. 75。

　　表 A.75

　　SNS_AddFriend描述见表 A. 76。

　　表 A.76

　　SNS_DelFriend描述见表 A. 77。

　　表 A.77

　　SNS_AddGroup描述见表 A. 78。

　　表 A.78

　　SNS_DelGroup描述见表 A. 79。

　　表 A.79

　　SNS_SetFriendGroup描述见表 A. 80。

　　表 A. 80

　　SNS_GetFriendInfo描述见表 A. 81。

　　表 A. 81

　　SNS_SendMsg描述见表 A. 82。

　　表 A. 82

　　SNS_ModifyGroup描述见表 A. 83。

　　表 A. 83

　　SNS_SearchFriend描述见表 A. 84。

　　表 A. 84

　　SNS_ListFriend描述见表 A. 85。

　　表 A. 85

　　A.3.4.2 游戏内聊天

　　SNS_StartVoiceChat描述见表 A. 86。

　　表 A. 86

　　SNS_CloseVoiceChat描述见表 A. 87。

　　表 A. 87

　　SNS_SendVoiceChat描述见表 A. 88。

　　表 A. 88

　　SNS_CreatVCGroup描述见表 A. 89。

　　表 A. 89

　　SNS_JoinVCGroup描述见表 A. 90。

　　表 A.90

　　SNS_ExitVCGroup描述见表 A. 91。

　　表 A.91

　　SNS_OpenTextMode描述见表 A. 92。

　　表 A.92

　　SNS_CloseTextMode描述见表 A. 93。

　　表 A.93

　　A.3.5 广告

　　AD_AddAd描述见表 A. 94。

　　表 A.94

　　AD_DisplayAd描述见表 A. 95。

　　表 A.95