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

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

国家标准 GB/T324182015 信息技术手持设备游戏软件接口要求 nformationtechnology一Interflaesrequirementofsamesoftware forhandhelddevices 2015-12-31发布 2016-07-01实施 中毕人民共和国国家质量监督检验检疫总局 发布 中 国国家标准化管厘委员会国家标准
GB/T32418一2015 目 次 前言 范围 规范性引用文件 术语、定义和缩略语 概述 操作系统API 基础运行API 游戏运行AP 附录A资料性附录接口描述
GB/T32418一2015 前 言 本标准按照GB/T1.1一2009给出的规则起草 请注意本文件的某些内容可能涉及专利 本文件的发布机构不承担识别这些专利的责任 本标准由全国信息技术标准化技术委员会(SAC/TC28)提出并归口 本标准起草单位:浙江大学、电子技术标准化研究院、浙江大学城市学院 本标准主要起草人;陈天洲、吴剑钟,俞立呈、潘练武、张雨松,赵毅、吴明晖,颜晖、王硕苹、彭彬、 蔡建平、郭鸣、霍梅梅、孙霖、沈虹、谢斌、叶敏娇、章铁飞、马建良、傅唯威、樊星、赵菁华
GB/T32418一2015 信息技术手持设备游戏软件接口要求 范围 本标准规定了手持设备游戏软件接口 本标准适用于手持设备游戏软件接口的开发与设计 规范性引用文件 下列文件对于本文件的应用是必不可少的 凡是注日期的引用文件,仅注日期的版本适用于本文 件 凡是不注日期的引用文件,其最新版本(包括所有的修改单)适用于本文件 GB/T16264.8一2005信息技术开放系统互连目录第8部分:公钥和属性证书框架 GB/T21023中文语音识别系统通用技术规范 手持电子产品嵌人式软件APm GB/T256542010 ISO/IEC/IEEE9945:2009信息技术可移植操作系统接口POsIX)操作系统接口 InformationtechnologyPortableoperatingsystenminterface(POsIXOperatingsysteminterface POSIX 术语、定义和缩略语 3.1术语和定义 下列术语和定义适用于本文件 3.1.1 手持设备游戏handheddevieegame 应用于手持终端设备的游戏软件 3.2缩略语 下列缩略语适用于本文件 API 应用编程接口(ApplietionPrograminglInterface) HTTP 超文本传输协议(HypertextTransferProtocol) 安全套接层(SecuritySoeketLayer) SSL TTS 文语转换(TextToSpeech 概述 手持设备游戏软件可以分为操作系统AP1,基础运行API和游戏运行API三类,如图1所示 注:这三类AP都直接由游戏开发者调用,在本标准范围内不存在层次
GB/T32418一2015 装饰件 游双引华臂果 游戏内交易 排行榜 社交 广告 游戏运行AP 用户界面 多媒体 网络通信 数据库 基础运行AP 外设管理 安全认证 异构计算 网络连按状态控制 系统电源管理 操作系统AP 图1手持设备游戏软件接口结构 操作系统AP描述了手持设备操作系统接口,提供了系统底层向上层软件的API接口,包括外设 管理,安全认证、异构计算、系统电源管理、网络连接状态控制 基础运行AP使得在上层软件开发过程中,可以无需调用操作系统类的AP,而在基础运行API 上进行软件设计 基础运行API规定了用于手持设备游戏软件中基础运行平台部分所应提供的应用 编程接口,包括用户界面,多媒体和网络通信 游戏运行API规定了游戏软件专用的编程接口,包括装饰件、游戏引擎管理,游戏内交易、排行榜、 社交和广告等方面的AP1 接口描述参见附录A 操作系统API 5.1系统电源管理API 包括 a)调用BatMag_SetBright设置屏幕亮度; b) 调用BatMag_Suspend和BatMag_wakeup分别实现系统休眠和唤醒 调用BatMag_AcquireL.ock,阻止系统进人休眠,并可以指定永久保持系统处于唤醒状态或设 定保持唤醒时间,超过设定时间后系统自动进人休眠状态; d)调用BatMag_ReleaseL.ock允许系统自动进人休眠状态 5.2网络连接状态控制AP1 包括 a)调用NetStat_GetAIINetworklnfo获取所有网络的状态信息,状态信息包括网络的类型和连
GB/T32418一2015 接速度 b)调用NetStat_GetAetiveNetworklnfo获取当前活动网络的状态信息 c 调用NetStatSwitchToNetwork切换至某一类型网络 5.3外设管理AI 5.3.1系统能力和配置 包括: 调用Sys_GetAlDevieel获取设备与设备ID的对应列表; a b)调用Sys_GetDevieelnfo获取对应设备的具体参数,获取的参数为字符串键值对集合,表明设 备的能力或配置情况 5.3.2设备电源管理 包括 a)调用DevPowerOn开启指定设备的电源,并由系统对设备进行必要的初始化,使设备进人可 用的默认运行级别 b调用Dev_PowerO关闭设备电源; 调用Dev_SetRunlevel设置设备的运行级别,不同级别表示该设备不同能耗和性能等级,由不 c 同设备定义 5.4异构计算API 包括: a) 调用HC 创建运行所需的设备上下文环境; createenV 使用指定的可执行文件进行计算,此时计算将在后台异步地进行 b)调用HC_execute e)调用Hc_wait可等待直到异步计算结束并获得相应的计算结果; 调用HC_destroy_env清理相关资源 d 5.5安全认证 操作系统AP安全认证应符合GB/T256542o10中6.3的要求和GB/T16264.8-2005第8章 的要求 基础运行AP 6.1用户界面 6.1.1画布和屏幕基础组件 画布和屏幕基础组件要求应符合GB/T25654一2010中6.1的要求 6.1.2用户界面异步线程管理 包括 a)调用UIAsyncTaskCreateTask创建一个异步线程 b)调用UIAsyncTaskStartTask让异步线程开始执行; e)调用UI_AsyncTask_GetStatus获取线程是否执行完毕 d 调用UI_AsyncTask_lsCanceled检查异步线程是否被取消;
GB/T32418一2015 调用UI_AsyncTask_DestroyTask结束线程执行,清理相关资源 e 6.1.3用户通知 包括 a)调用UINotification_Create创建相应类型的用户通知,通知展示完毕后会被自动销毁 b调用UINoifcationSetLights或Uotification_SetVibrato分别设置LED点亮的方式或 震动的模式 SetMessage分别设置是否播放提示音或 调用UuNotifieation_setsound或U1_Notifeation_ 显示消息文字 d)调用UI_Notifieation_Show向用户显示相应的通知信息 6.1.4周期性和定时任务 包括: 调用U_Alarm_CreateTask指定要执行的任务执行的延迟时间或周期后系统会在指定的时 a 刻自动调用相应的任务; b)调用UI_Alarm_DestroyTask取消任务的执行并清理相关资源 6.1.5触摸屏输入 6.1.5.1触点要求 触摸屏支持至少两点的多点触摸操作,在支持的范围内能够正确识别各个触点的位置,不出现位置 干扰 6.1.5.2输入事件 包括 a)调用UIEventCreateListener创建一个对应的事件监听器; 调用U_Event_GetAttribute获得时间的属性,如事件类型等 b 6.1.5.3屏幕手势 包括 a 调用ucGesture.Creatsiroke可从量数据创建一个笔画 b 钢用cwe.caadc可从给定的它嘴创建一个手势 c)调用UI_Gesture_Input可在给定屏幕区域内注册需要识别的手势,当用户给出相应手势时系 统会出发相应的输人事件; d)调用UI_Ges sture_GetBounding可获得包围手势的边框坐标; 调用UI_Gest ture_DestroyStroke或U_Gesture_DestroyGestun re结束不再使用的笔画或手 e 势,清理相关资源 6.1.6中文语音识别 中文语音识别应符合GB/T21023的要求 6.1.7TTsAP1 TTsAPI应符合GB/T25654一2010中7.5.3的要求
GB/T32418一2015 6.2多媒体 多媒体AP应符合GB/T25654一2010中7.5的要求 6.3网络通信 6.3.1套接字 套接字应符合Is/IEc/IEEE9945;2009中2.10对Sockets接口的要求 包括以下接口;创建通信描述符soeket、绑定到本地地址bind接受传人连接listen,等待传人连接 ,发送数据send,接收数据recv,发送无连接数据sendto,接收无连接数 accept、连接到远程地址connect 据recvfrom、关闭连接close、设置Socket参数setsockopt和获取Socket参数getsockopt 6.3.2安全套接字层 应符合GB/T25654一2010中6.3.2sSL接口的要求 包括以下接口SSL协议栈初始化SSL init,创建安全会话SsL_open,建立安全连接sSL._connect,发送数据SSL_write、读取数据SSL_read、 关闭安全连接SSL_close,获取会话状态SSL_state和控制会话参数SSL_ioetl. 6.3.3IHIP客户端 HTTP客户端使用HTTP协议与web服务器通信 HTTP协议由客户端发起通信请求,请求的 类型包括GET和POST两种,请求包含了资源地址和请求头部参数,GET请求的请求数据参数保存 在资源地址中,POST请求的请求数据参数保存在头部之后附加的请求数据主体中 服务器对请求的 响应包括状态(请求是否成功)和可选的响应数据主体 HTTP客户端API具体内容包括: a)调用HTTPClient.Client创建一个连接到给定服务器主机的HTTP客户端对象,此对象负责 在客户端和服务器之间建立底层网络通信 b)调用HTTPChientChientSetHeader设置头部参数; 调用HTTPClient_Get或HTTPCient_Post创建相应方法的对象,参数为要发送给服务器端 的数据 调用HTTPCient_Entity_CreateFromForm或HTTPCient_Entity_CreateFrom.Stream分别 从表格或数据流创建 调用HTTPCient_CientExeeute将客户端相应的头部和主体发送给服务器,并获得服务器 e 响应; f _GetStatus获得服务器响应状态; 调用HTTPClient_Response 调用HrTPClient_ResponseGetEantity获得服务器返回的数据; g h)调用HTTPClie ient_Entity_GetStream或HTTPClient_Entity_GetString把数据当作输出流或 字符串读取; iD 调用HTTPClien_Eaty_Destroy结束数据读取,清理相关资源 调用HTTPClient_ClienL_shrdown断开与服务器的网络连接 j 6.3.4信息推送服务 包括: a)调用PushNotificeation_Register在消息服务提供者处注册服务,以允许接收推送消息,并给出 信息回调接口;
GB/T32418一2015 b)调用回调接口PushNotification_OnMessage被调用并传人消息; e)调用PushNotification_Unregister取消接收推送消息服务 游戏运行AP 7.1游戏引擎管理 包括: a)调用GameEngine_Add向系统添加一个新的游戏引擎; b)调用GameEngine_Delete移除相应的游戏引擎; 调用Gamm nmeEngime-Sseatrth可根据游戏需求,搜索系统中已有的游戏引擎 c 7.2游戏内交易 7.2.1游戏物品、服务购买或充值 包括 a)调用lnGamePurches_RegisterAccount或InGamePurehes_UnregisterAceount注册或注销用 户游戏账号， b) 调用lnGamePurches_Transaction发起服务器交易,允许用户在特定游戏账户中购买相应的 物品或服务 7.2.2用户间虚拟资产交易 包括 调用InGameTrading_Tradeltem发起用户间的虚拟资产交易 7.3排行榜 包括 a)调用ScorelBoardAdduser或ScoreBoard_Deluser,创建或删除一个排行榜的用户名; b) 调用sScoreBoard_ModifyUser修改用户的信息,包括在排行榜上显示的昵称,头像等; e)调用ScoreBoard_DownUserlnfo获取其他用户的信息; d 调用ScoreBoardDownlnfo获得相应排行榜的榜单; 调用ScoreBoard_Updatelnfo将用户的游戏得分上传到相应的排行榜 e 7.4社交 7.4.1好友系统 包括 a)调用SNS_UserRegister注册一个新的社交网络用户; b)调用SNS_AddFriend,SNs_DeIFriend可添加,删除好友 c)调用SNS_GetFriendlnfo获取好友信息; 调用sNs_AddGrop或sNs_DeGrp,漆加或鹏除好友分组 d 调用sNs_ModifyGroup修改好友分组名称; e 调用sNssetFriendGroup,设定一个好友所属的好友分组; f g)调用sNs_ListFriend,列出分组中的所有好友; h 调用sNs_SearchFriend.搜索整个好友列表;
GB/T32418一2015 调用sNsSendMsg,向指定好友发送信息 i 7.4.2游戏内聊天 包括: a)调用SNs_StartVoiceChat或SNs_CloseVoiceChat,开启或关闭整个语音聊天功能 b) 调用SNsCreatVcGroup或SNsJoinVCGroup,创建或加人一个语音聊天组; e)调用SNS_ExitVCGroup,退出语音聊天组; 调用SNs_OpenTextMode或SNsCloseTextMode,打开或关闭聊天界面 d) 7.5广告 包括: a)调用AD_AddAd,在游戏中加人候选广告; b)调用AD_DisplayAd,在指定的位置轮流显示预定广告
GB/T32418一2015 录 附 A 资料性附录 接口描述 A.1操作系统AP A.1.1系统电源管理API BatMag_SetBright描述见表A.1 表A.1 丽数名 BatMagSetBright 说明 设置屏幕亮度等级 参数 亮度等级 返回值 成功/出错代码 BatMag_Suspend描述见表A.2 表A.2 丽数名 BatMagSuspend 说明 使系统进人休眠状态 无 参数 返回值 成功/出错代码 BatMeg_wakeup描述见表A.3 表A.3 丽数名 BatMag_wakeup 说明 从休眠状态中唤醒系统 无 参数 返回值 成功/出错代码 BaMag_Acequireloek描述见表A.4 表A.4 丽数名 BatMag_Aequirelock 说明 获得休眠锁,该锁能阻止系统进人休眠状态 锁类型,永久锁或超时锁 参数 超时时间,锁为超时锁需指定超时时间 b 返回值 成功/出错代码
GB/T32418一2015 BatMagReleaseL.oek描述见表A.5 表A.5 函数名 BatMag_Releasel.ock 说明 释放休眼锁 参数 心 返回值 成功/出错代码 A.1.2网络连接状态控制API NetStatGetAIlNetworklnfo描述见表A.6 表A.6 丽数名 NetStatGetAIINetworklnfo 说明 获得所有网络的状态信息 参数 无 成功,返回所有网络的状态信息集合 返回值 错误,返回出错代码 NetStatGetActiveNetworklnfo描述见表A.7 表A.7 丽数名 NetStat_GetActiveNetworkInfo 说明 获得当前活动网络的状态信息 参数 无 成功,返回当前活动网络的状态信息 返回值 错误,返回出错代码 NetStatINetworkValid描述见表A.8. 表A.8 函数名 NetStat_INetworkValid 说明 判断某一类型的网络当前是否可用 参数 网络类型 返回值 是/否 NetStat_SwitehToNetwork描述见表A.9
GB/T32418一2015 表A.9 swichToNetwork Net e 函数名 Stat_S 切换至某一类型的网络 说明 网络类型 参数 返回值 成功/出错代码 A.1.3外设管理API A.1.3.1系统能力和配置 Sys_GetAIDevicelD描述见表A.10. 表A.10 函数名 Sys_GetAIDevieelD 获取所有设备名字及其D 说明 参数 心 成功,返回设备名称和D列表 返回值 错误,返回出错代码 Sys_GetDevicelnfo描述见表A.11 表A.11 丽数名 Sys_GetDevicelnfo 说明 获取指定设备的详细信息 参数 设备ID 成功,返回设备名称详细信息 返回值 错误,返回出错代码 A.1.3.2设备电源管理 Dev_PowerOn描述见表A.12 表A.12 丽数名 DevPowerOn 说明 对指定的设备供电 参数 设备D 返回值 成功/出错代码 Dev_PowerO描述见表A.13 l0
GB/T32418一2015 表A.13 函数名 Dev_PowerOff 说明 对指定的设备断电 参数 设备D 返回值 成功/出错代码 DevSetRunlevel描述见表A.14 表A.14 丽数名 DevSetRunlevel 说明 设置指定设备的运行级别 设备ID 参数 运行级别 返回值 成功/出错代码 A.1.3.3定位 LocLocate描述见表A.15 表A.15 丽数名 Loe_Locate 说明 获取定位信息 参数 定位方式,全球定位系统或移动通信终端网络 成功,返回定位信息 返回值 错误,返回出错代码 Loe_Registerlistener r描述见表A.16. 表A.16 丽数名 L.oe_Registerlistener 注册定位监听器 说明 定位器方式 参数 监听频率 返回值 成功返回定位监听器描述符/出错代码 terListener -UnRegist oc 描述见表A.17 1l1
GB/T32418一2015 表A.17 函数名 l.oc_UnRegisterlistener 说明 注销定位监听器 参数 定位监听器描述符 返回值 成功/出错代码 异构计算 A.1.4 HCcreateenv描述见表A.18. 表A.18 丽数名 HC_create_env 说明 创建异构计算需要的运行上下文环境 参数 进行异构计算的设备ID 返回值 返回指向异构计算的运行上下文环境的指针,为NULL表示失败 HC 描述见表A.19. eXecute 表A.19 丽数名 HCexecute 说明 在异构核上执行指定的运算 指向异构计算的上下文环境的指针 参数 可执行文件 b 运行参数 返回值 成功/出错代码 HC_wait描述见表A.20. 表A.20 丽数名 HC_wait 说明 等待异构计算结束 参数 指向异构计算的上下文环境的指针 无 返回值 Hc_destroy_env描述见表A.21 12
GB/T32418一2015 表A.21 函数名 HcC_destroy_env 说明 销毁异构计算的运行上下文环境 参数 指向异构计算的上下文环境的指针 返回值 成功/出错代码 A.2基础运行API 用户界面 A.2.1 A.2.1.1用户界面异步线程管理 UAsyncTask_CreateTask描述见表A.22 表A.22 函数名 UIAsyneTask_CreateTask 说明 创建异步线程 参数 创建线程所需要的相关参数,包括线程所属类,线程属性参数等 返回值 创建的异步线程的描述符 UAsyncTaskStartTask描述见表A.23 表A.23 函数名 U1_AsyneTask_StartTask 说明 开始执行异步线程 参数 异步线程描述符 返回值 成功/出错代码 uLAsyncTask_CaneelITask描述见表A.24 表A.24 丽数名 U1_AsyncTask_CancelTask 说朋 取消正在执行异步线程 参数 异步线程描述符 返回值 成功/出错代码 U1_AsyncTask_GetStatus描述见表A.25 13
GB/T32418一2015 表A.25 U_AsyncTask_GetStatus 丽数名 说明 获得异步线程的执行状态 参数 异步线程描述符 该线程的状态 FINISHED线程执行完成 返回值 PENDING;:线程还未执行 RUNNING;线程正在运行 UIAsyncTask_IsCancelled描述见表A.26 表A.26 丽数名 U1_AsyncTask_ICancelledl 说明 判断异步线程是否被取消 参数 异步线程描述符 True;线程在运行完之前被取消 返回值 False;线程在运行完之前未被取消 UIAsyncTask_DestroyTask描述见表A.27 表A.27 函数名 ULAsyncTask_DestroyTask 说明 销毁异步线程 参数 异步线程描述符 返回值 成功/出错代码 A.2.1.2用户通知 UNotificationCreate描述见表A.28 表A.28 函数名 UNotification_Create 说明 创建一个用户通知 用户通知的类型 参数 用户通知的触发方式 返回值 用户通知的描述符 U几Notifieation_SetLights描述见表A.29 14
GB/T32418一2015 表A.29 ULNotftatonSetLghs 函数名 说明 设置LED提示的参数 用户通知的描述符 LED的颜色 参数 LED闪烁的频率 LED亮的持续时间 返回值 无 UINotification_SetSound描述见表A.30 表A.30 UI 函数名 L_Notification_SetSound 说明 设置声音提示的参数 用户通知的描述符 声音提示的音乐 参数 是否重复提示 重复提示的时间间隔 声音提示的持绩时间 返回值 无 U1NotificationSetVibrator描述见表A.31 表A.31 丽数名 U1_Notification_SetVibrator 说明 设置震动提示的参数 用户通知的描述符 震动提示的方式 参数 震动提示的持续时间 返回值 无 UINotification_SetMessage描述见表A.32 表A.32 丽数名 U1_Notifieation_SetMessage 说朋 设置信息提示的参数 用户通知的描述符 信息提示的内容 参数 信息提示的显示方式 返回俏 15
GB/T32418一2015 UINotification_Show描述见表A.33 表A.33 丽数名 UNotification_Show 说明 显示用户通知 参数 用户通知的描述符 无 返回值 A.2.1.3周期性和定时任务 UI_Alarm_CreateTask描述见表A.34 表A.34 丽数名 U1_Alarm_CreateTask 说明 创建需要提醒的任务 提醒的触发时刻 参数 提醒的类型 需要执行的任务描述符 返回值 提醒任务的描述符 UIAlarmDestroyTask描述见表A.35 表A.35 丽数名 UAlarm_DestroyTask 说朋 取消需要提醒的任务 参数 提醒任务的描述符 返回值 无 A.2.1.4触摸屏输入 A.2.1.4.1输入事件 U1_Event_CreateListener描述见表A.36. 表A.36 U1_Event_CreateListener 丽数名 创建输人事件监听器 说明 参数 要监听事件的相关参数,例如时间戳,类型内容和事件来源等 返回值 事件描述符 UIEvent_SetResponse描述见表A.37 l6
GB/T32418一2015 表A.37 函数名 ULEvent_SetResponse 设置事件的相应操作 说明 事件描述符 参数 操作的标识符 返回值 无 U_Event_GetAttribute描述见表A.38 表A.38 函数名 ULEvent_GetAttribute 说明 获得事件的属性值 事件描述符 参数 属性描述符 返回值 属性值 A.2.1.4.2屏幕手势 U1GestureCreateStroke描述见表A.39 表A.39 丽数名 U_Gesture_CreateStroke 说明 创建一个笔划 参数 描述笔画的有向矢量(有向的弧线或直线等参数 返回值 笔划标识符 UGesture_DestroyStroke描述见表A.40. 表A.40 U1_Gesture_DestroyStroke 明数名 说明 销毁一个笔划 参数 笔划标识符 无 返回值 U1_Gesture_CreateGesture描述见表A.41 17
GB/T32418一2015 表A.41 函数名 UL_Gesture_CreateGesture 说明 创建一个手势 参数 组成手势的所有笔划标识符 返回值 手势标识符 UIGestureDestroyGesture描述见表A.42 表A.42 函数名 UGestureDestroyGesture 说明 销毁一个手势 手势标识符 参数 返回俏 UIGesture._GetBounding描述见表A.43 表A.43 丽数名 U1_Gesture_GetBounding 说明 获得手势的边界框 参数 手势标识符 返回值 手势边界框的各点坐标 U1Gesture_GetStro )kes描述见表A.44 表A.44 丽数名 U1_GestureGetStrokes 说明 获得手势中的所有笔划 参数 手势标识符 返回值 存储手势中的所有笔划标识符的链表 UGestureInput描述见表A.45 表A.45 明数名 U1Gesture_Input 说明 增加给定手势的识别 手势标识符 a 参数 识别区域 返回俏 事件标识符 18
GB/T32418一2015 A.2.2网络通信 A.2.2.1IrP客户端 HTTPClient_Get描述见表A.46 表A.46 HTTcien_Ge 函数名 说明 创建HTTPGET方法描述符 参数 查询参数集合(参数名字符串,值;字符串) 返回值 HTTPGET方法描述符 HTTPCient_Post描述见表A.47 表A.47 HTTPCIi 函数名 lient_Post 说明 创建HTTPP(OST方法描述符 参数 Entity集合(参数名:字符串,值;Entity) 返回值 HTTPPOsT方法描述符 HTTPClientClient描述见表A.48 表A.48 丽数名 HTTPClient_Client 创建客户端对象 说明 参数 主机URL(不包括查询 返回值 HTTPClient描述符 HTTPClient _Cien_setHleader描述见表A.49 表A.49 HTTPc 函数名 Client_Client_SetHeader 说明 添加,修改或删除HTTP请求的He Ieader Header名称 参数 值(若值为空则删除对应的Header) Header 返回值 无 HTTPClient_Client_Execute描述见表A.50. 19
GB/T32418一2015 表A.50 丽数名 HTTPClientClient_Execute 执行指定的HTTP请求,执行后可能会保持与服务器的连接直到超时或HTTPClient_Client 说明 被调用 Shutdown HTTPClient描述符 参数 HTTPGET或HTTPPOST方法描述符 返回值 HTTP响应描述符 HTTPClient_Client_Shutdown描述见表A.51. 表A.51 丽数名 HTTPClient_ClientShutdown 关闭H 说朋 PClient与服务器的连接 参数 HTTPClient措述符 无 返回值 HTCiteL_Reponse_Getsiats描述见表A.52 表A.52 函数名 HTTPClientResponse_GetStatus 说明 获取HTTP响应状态 HTTP相应描述符 参数 返回值 HTTP响应状态号 HTTPClient_Response._GetEntity描述见表A.53. 表A.53 丽数名 HTTienLRepne_GEmtity 说明 获取HTTP响应内容 参数 HTTP相应描述符 返回值 HITTP响应内容 HTTPCientEntity._CreateFromForm描述见表A.5！ 表A.54 HTTPCient_Eantity_CreateFromForm" 函数名 说明 通过HTML.表格创建Entity,用于表格提交 参数 表格参数集合(参数名;字符串,值:字符串 返回值 创建的Entity描述符 20
GB/T32418一2015 HTTPClient_Entity_CreateFromStream描述见表A.55 表A.55 明数名 HTTPClient_Entity_CreateFromStream 说明 通过流创建Entity,可用于上传文件或其他数据 参数 要发送的流 返回值 创建的Entitry描述符 HITTPClient GetStreatm _Emtity 描述见表A.56 表A.56 函数名 HTTPClienEntity_GetStream 说明 从Entity获取输人流(用于文件下载等 参数 Entitry描述符 返回值 输人流/出错代码 HTTPClient_Entity_GetString描述见表A.57 表A.57 HrTClienL_Emtiy_Getsirimg 函数名 说明 从Entitry获取字符串(用于字符串形式消息返回,如网页 参数 Entity描述符 返回值 结果字符串/出错代码 HTTPClient_Entity_Destroy描述见表A.58 表A.58 丽数名 HTTPClient_Entity_Destroy 说明 销毁指定的Entity描述符并释放资源 参数 Entity描述符 返回值 无 A.2.2.2信息推送服务 PushNotifeation_Register描述见表A.59. 21
GB/T32418一2015 表A.59 PushNotificeation_Register 丽数名 说明 注册推送通知,注册后应用程序能够接收到相应的推送通知 服务ID,表明应用程序所要注册的推送服务ID,由推送服务提供商分配 Key,由推送服务提供商分配 参数 信息回调接口 返回值 成功/出错代码 PushNotification_Unregister描述见表A.60 表A.60 PushNotification_Unregister 丽数名 说明 取消注册,取消后将不再接收到推送信息 参数 服务ID 返回值 无 PushNotifieation_OnMessage描述见表A.61 表A.61 丽数名 PushNotification_OnMessage 信息回调接口函数,注册后若收到推送消息则系统会调用此函数 说明 服务ID,发出推送的服务 参数 消息正文 返回值 无 A.3游戏运行APl A.3.1游戏引擎管理 ameEngine_Add描述见表A.62. 表A.62 丽数名 GameEngine_Add 说明 添加一个游戏引擎 游戏引擎的位置 a 参数 游戏引擎运行所需的参数 返回值 游戏引擎的描述符 GameEngine_Delete描述见表A.63 222
GB/T32418一2015 表A.63 GameEngine_Delete 丽数名 说明 删除一个游戏引擎 参数 游戏引擎的描述符 返回值 无 GameEngine_Search描述见表A.64 表A.64 丽数名 GameEngine_Search 说明 查找一个游戏引擎 参数 游戏引擎的描述符 返回值 游戏引擎的相关信息,例如运行状态,运行参数等 A.3.2 游戏内交易 A.3.2.1游戏物品,服务购买或充值 InGamePurchesTransaction n描述见表A.65 表A.65 函数名 lnGamePurches_Transaction 说明 用户购买物品 用户名 a) 参数 b购买服务的D 游戏账户名 返回值 成功/出错代码 rAccount InGamePurches_Register 描述见表A.66. 表A.66 函数名 lnGamePureches_registerAccount 说明 用户游戏账户注册 用户名 参数 游戏账户名 b 用户账户类型 返回值 成功/出错代码 lnGamePurches_UnregisterAccount 描述见表A.67 23
GB/T32418一2015 表A.67 InGamePurehes_unregisterAccount 丽数名 说明 用户账户注销 a 用户名 参数 游戏账户名 返回值 成功/出错代码 A.3.2.2用户间虚拟资产交易 InGameTrading_Tradelte描述见表A.68. 表A.68 丽数名 InGameTrading_Tradeltem 游戏中用户之间进行虚拟资产交易的操作 说明 用户1的用户名 用户2的用户省 参数 指向用户1交易的物品数组的指针 指向用户2交易的物品数组的指针 返回值 成功/出错代码 A.3.3排行榜 ScoreBoardAdduser描述见表A.69 表A.69 丽数名 SeoreBoard_Adduser 说明 添加一个新的用户 添加用户的用户名 a 参数 b用户的信息 返回值 成功/出错代码 ScoreBoard_Deluser描述见表A.70 表A.70 ScoreBoardDeluser 丽数名 说明 删除一个指定的用户 参数 要删除的用户名 返回值 成功/出错代码 24
GB/T32418一2015 ScoreBoardModifyUser描述见表A.71 表A.71 丽数名 SeoreBoardModifyUser 说明 修改一个用户的信息 修改用户的用户名 a 参数 b用户的信息 返回值 成功/出错代码 ScoreBoard_Downlnfo描述见表A.72 表A.72 丽数名 SeoreBoardDownlnfo 从服务器获取排行榜信息 说明 参数 排行榜ID 返回值 成功/出错代码 SeorelBoardDownUserlnfo描述见表A.73. 表A.73 丽数名 ScoreBoard_DownUserlnfo 说明 从服务器获取用户信息 参数 用户名 返回值 成功/出错代码 ScorelBoard_Updatelnfo描述见表A.74 表A.74 函数名 ScoreBoard_Updatelnto 说明 将用户本地得分上传到服务器上 用户名称 a 参数 排行榜ID b 得分信息 返回值 成功/出错代码 A.3.4社交 A.3.4.1好友系统 SNS_UserRegister描述见表A.75 25
GB/T32418一2015 表A.75 函数名 SNs_UserRegister 说明 注册用户 参数 指向用户信息的指针 返回值 成功/出错代码 sNsAddFriend描述见表A.76 表A.76 丽数名 SNS_AddFriend 说明 添加好友 参数 指定好友名字 返回值 成功/出错代码 SNs_DelFriend描述见表A.77 表A.77 SNs_DelFriend 函数名 说明 删除指定好友 参数 指定好友名字 返回值 成功/出错代码 sNsAddGroup描述见表A.78 表A.78 函数名 SNS_AddGiroup 说明 漆加一个好友分组 -个分组名称 参数 返回值 成功/出错代码 SNs_DelGroup描述见表A.79 表A.79 SNS_DeGroup 丽数名 说明 删除一个好友分组 参数 好友分组名称 返回值 成功/出错代码 SNsSetFriendGroup描述见表A.80. 26
GB/T32418一2015 表A.80 丽数名 SNs_SetFriendGroup 说明 设定好友分组 好友名字 a 参数 好友分组名称集合 返回值 成功/出错代码 sNs.GetFriendlnfo描述见表A.81 表A.81 丽数名 SNS_GetFriendlnfo 说明 获取一个好友的详细信息 参数 指定好友名字 返回值 返回指向好友信息的指针,返回NULl,表示失败 SNS_SendMsg描述见表A.82 表A.82 丽数名 SNSSendMsg 向一个好友发送消息 说明 参数 指定一个好友名字 返回值 成功/出错代码 SNs_ModifyGroup描述见表A.83 表A.83 丽数名 SNs_ModifyGroup 说明 修改一个好友分组的名称 要修政的好友分组名称 参数 修改后的好友分组名称 返回值 成功/出错代码 sNsSearchFriend描述见表A.8！ 表A.84 SNS 函数名 SearchFriend 说明 按名字搜索好友 参数 指定好友名字 返回值 返回指向好友信息的指针,返回NUL儿表示失败 27

关于信息技术手持设备游戏软件接口要求GB/T32418-2015的探讨

随着移动互联网的快速发展和智能手机的广泛应用，移动游戏市场正在迅速壮大。因此，游戏软件的质量和用户体验变得越来越重要。其中一个关键因素就是游戏软件的接口要求。

游戏软件的接口要求指的是不同游戏软件之间数据交换、互通的规范要求。如果每个游戏软件都有自己的接口规范，那么不同游戏软件之间的交互就会非常困难，甚至无法实现。因此，制定一套统一的游戏软件接口要求标准非常必要。

2015年，国家标准化管理委员会制定了《信息技术 手持设备游戏软件接口要求》（GB/T32418-2015）标准。该标准涵盖了移动设备上的各种类型游戏软件，包括单机游戏、网络游戏、手游等，并规定了它们之间数据传递的格式、协议和方法。

根据该标准，游戏软件应该具备以下特点：

• 遵循国际通用的XML文档格式，便于不同平台之间的兼容性；
• 使用HTTP或HTTPS协议进行数据传递，确保数据传输的安全可靠性；
• 接口的参数和返回值应该使用JSON格式，以提高数据传输效率和解析速度；
• 接口应该具有良好的扩展性和兼容性，方便后期维护和更新。

通过制定GB/T32418-2015标准，游戏软件之间的数据交换变得更加简单、直观和高效。同时，游戏开发者也可以更加专注于游戏的内容和用户体验，而无需过多考虑数据交换等技术细节。

总之，GB/T32418-2015标准的制定对于提高移动游戏软件的质量和用户体验具有重要意义。未来，游戏行业将会在这个基础上不断创新和发展，为用户带来更好的游戏体验。

信息技术手持设备游戏软件接口要求的相关资料

和信息技术手持设备游戏软件接口要求类似的标准