指导文档_腾讯单机手机游戏动态JAD指导文档.100816

腾讯单机手机游戏动态JAD指导文档1.5腾讯科技(深圳)有限公司版权所有不得复制版本历史日期版本号备注2008-05-27 1.0 编写文档2008-5-29 1.01 修改计费类型位数和积分上传规范内免费指令的获取方式,更新QQSMS和内置APP包2008-08-19 1.01 更新默认的2元计费指令.2008-10-06 1.01 更新积分上传指令的获取方式2009-9-8 1.1 1，增加计费类型是短代还是DO模式2，增加DO计费指令和接入号配置2009-11-24 1.2 1，增加对统一包中文件命名的描述2，增加对统一包中免费指令的描述3，增加对DO包指令完整格式的描述。

2009-11-27 1.3 1，修改示例中的免费指令和接入号。

2，修改示例中的DO指令和接入号。

2009-12-2 1.4 1，更新加解密游戏包1.032，补充对指令加密描述。

2010-6-21 1..5 1，增加QQ游戏中心名称和对应的UIRL获取接口；2，修改动态JAD指令示例；3，去除短代积分规范的说明。

2010-8-18 1.6 更新QQSMS包目录腾讯单机手机游戏动态JAD指导文档1.5 (1)1.概述 (4)1.1.目的 (4)1.2.范围 (4)2.开发规范 (4)2.1.合作流程 (4)2.2.外部合作代码 (5)2.3.JAD文件配置 (12)2.4.计费说明 (13)2.5.积分上传说明............................................................................. 错误！未定义书签。

3.附录 (14)1.概述1.1.目的目前越来越多的合作伙伴与腾讯公司进行单机手机游戏的合作。

该规范文档使各合作伙伴能够顺利完成计费短信代码、渠道、手机终端类型的获取等工作，这些为以后进行短信计费代码的替换，用户行为分析，营销效果统计带来很大的方便，为后面用户行为的分析提供更详细的数据，方便合作伙伴分析用户行为开发更完美的软件。

使双方的合作流程更加规范，项目进展顺利。

1.2.范围与所有合作伙伴在KJA V A平台关于单机游戏合作的开发。

2.开发规范2.1.合作流程目前单机游戏的合作的步骤如下：1、合作伙伴按照规范开发单机软件2、合作伙伴提交移植后的单机软件开发包3、腾讯根据合作伙伴提供的单机软件包进行测试。

4、如果测试没通过，返回步骤25、如果测试通过，直接进行发布TencentCP按照规范开发单机软件提交测试通过测试是否发布2.2. 外部合作代码腾讯公司提供源代码开发包和Demo 程序。

各合作伙伴通过开发包获取扣费指令、积分上传指令、一级渠道、二级渠道、内部渠道、用户的QQ 号、终端类型。

Demo 如下：QQSMS1.04.zip 为开发包，QQSMS-src.zip 为Demo 程序（可在此文档中双击打开） 接口类为QQSms ，接口说明：/***QQSms 的构造函数*入参： MIDlet mMMIDlet ,MIDlet 用于读取JAD 文件 *返回值：voidpublic QQSMS(MIDlet mMMIDlet)/***获取计费短信代码*入参： int money ,用于获取多少钱的短信代码*返回值：String[] ，字符串数组。

0为短信指令内容，1位发送目的号码*/public String[] requestSMS(int money)/***获取一级渠道*入参：无*返回值：String ，返回一级渠道*/public String getChannelFirst()/***获取二级渠道*入参：无*返回值：String ，返回二级渠道*/public String getChannelSecond()/***获取终端类型*入参：无*返回值：String ，返回终端机型*/public String getTerm()/***获取免费短信指令内容,上传积分使用*入参：无*返回值：String[] ，字符串数组。

0为短信指令内容，1位发送目的号码*/public String [] getFreeCode()/***获取内部渠道*入参：无*返回值：String ，返回内部渠道*/public String getInterChannel()/***获取内部渠道*入参：无*返回值：String ，返回下载用户的QQ号*/public String getQQ()说明：1，在计费点判断时，先调用getFeeMode 获取计费点 ，如果是短代模式，按照原有流程进行计费下行， 如果是DO 模式，则继续根据计费点序号调用getDoFeeCode 方法，获取计费指令和目的号。

计费流程如下图：触发某计费点判断计费点类型获取DO 指令和接入号获取短代指令和接入号DO短代2，如果是DO 模式，获取对应指令和接入号失败时，请注意控制程序逻辑，视同收费失败。

*获取计费模式*入参：无*返回值：int, 0 : 短代模式， 1 ： DO 模式 2:其它 （暂未使用，扩展备用） */public int getFeeMode() /*** 获取计费指令和目的号*入参：index : 计费点序号 从1开始。

*入参：cpId : cp 编号， 此字段正常情况下无用，但是在获取指令和目的号失败时会根据cpId 使用默认值的计费指令和目的号（暂未使用，扩展备用）*返回值：String[] ，字符串数组。

0为短信指令内容，1位发送目的号码 */public String[] getDoFeeCode(int index ， int cpId) /***获取“QQ 游戏中心”在游戏中的显示名称 (动态配置，可变化)*入参：无*返回值：QQ 游戏中心显示名称 */public String getGameCenterName() /***获取“QQ 游戏中心”在游戏中的URL 连接地址 (动态配置，可变化，带有游戏特有属性)*入参：无*返回值：用户点击 QQ 游戏中心 后的链接地址（URL ） */public String getGameCenterUrl()3，请CP严格按照提交的计费点序号来获取对应的计费积分指令和目的号！如下图：计费点从1开始编号，切不可违规使用，否则由于计费点异常导致的金额错误用户投诉等问题，由CP自行承担责任！4，由于DO指令金额不限于1-2元，请注意同一个计费点，短代和DO的不同处理方式，包括短信的条数，界面提示语言等。

例如遇到一个为6元计费点，示例如下：界面提示语示例图片如下：（DO界面图）（短代界面图）5，开发测试时，请同时测试短代和DO两种模式，可通过配置文件修改来实现FeeMode: 0 // 短代模式FeeMode: 1 // DO 模式使用DO指令时，注意指令的加密方法和配置。

将产生的指令和接入号配置到游戏的配置文件中对应DoCode， DoDest。

加密网站：注意事项：1.加密时的原始指令必须与DO平台分配的一致（而不是CP使用时的顺序）；2.多个指令请严格按照原始顺序依次合并成一行,中间用分号(";")分隔，示例：疯狂祖玛-经典四合一购买道具模式开通10658035100416 YX,834,1,e926,30501购买道具模式开通10658035100416 YX,834,2,da76,30501购买道具模式开通10658035100416 YX,834,3,ef01,30501购买道具模式开通10658035100416 YX,834,4,9444,30501原始DoCode:YX,834,1,e926,30501;YX,834,2,da76,30501;YX,834,3,ef01,30501;YX,834,4,9444 ,30501原始DoDest:10658035100416;10658035100416;10658035100416;106580351004163，上传统一包时请按照新的命名规范对游戏包进行命名（参见：手机游戏资源管理（CMS）CP用户手册.doc）。

4，特别说明，目前短代指令需附加统计字段，DO指令暂不支持附加字段，必须保持原始指令，举例如下：短代指令内容：1 42 023 Z600 WAP CS IC E258 0 11 02 Z600DO指令内容：YX,118037,1,54a9,30501以上示例是用户上行的最终指令内容，我们在开发过程中，加密时只加密分配的原始指令即可（上文中蓝色字体内容），而不是全部指令加密，获取时也是获取分配的原始指令，后面附加内容请CP按照规范另行处理。

具体内容请参见本文档2.4章节计费说明部分。

============================================应用代码示例：class MCanvas extends Canvas {private MMIDlet iMIDlet;private QQSMS mQQSms;private String text = "";MCanvas(MMIDlet aMIDlet) {super();iMIDlet = aMIDlet;mQQSms = new QQSMS(aMIDlet,"12345"); //初始化mQQSms}protected void keyPressed(int aKeyCode) {//获取计费短信代码if(aKeyCode == KEY_NUM1 || aKeyCode == KEY_NUM2) {String[] sms = mQQSms.requestSMS(aKeyCode == KEY_NUM1 ? 1 : 2);//if(sms != null) {text = "code:" + sms[0] + ",dest:" + sms[1] + ".";}repaint();}//获取一级渠道if(aKeyCode == KEY_NUM3){text = "result: "+ mQQSms.getChannelFirst();repaint();}//获取二级渠道if(aKeyCode == KEY_NUM4){text = "result: "+ mQQSms.getChannelSecond();repaint();}//获取内部渠道if(aKeyCode == KEY_NUM5){text = "result: "+ mQQSms.getInterChannel();repaint();}//获取终端类型if(aKeyCode == KEY_NUM6){String[] freeSms = mQQSms.gettext = "result: "+ mQQSms.getTerm();repaint();}//获取免费短信代码if(aKeyCode == KEY_NUM7){String[] freeSms = mQQSms.getFreeCode();if(freeSms != null) {text = "code:" + freeSms[0] + ",dest:" + freeSms[1] + ".";}repaint();}//退出游戏if(aKeyCode == KEY_NUM0) {iMIDlet.end();}}//画在屏幕上protected void paint(Graphics g) {g.setColor(0xFFFFFF);g.fillRect(0, 0, getWidth(), getHeight());g.setColor(0);g.drawString("1:Sms1 2:Sms2 3: Channel1 4:Channle2 ", 10, 50, Graphics.LEFT | Graphics.TOP);g.drawString("5:InterChannle 6:Term 7:FreeCode ", 10, 65, Graphics.LEFT | Graphics.TOP);g.drawString(text, 10, 90, Graphics.LEFT | Graphics.TOP);}}2.3.JAD文件配置JAD文件中必需配置下面属性，其中Term这个属性在发布游戏包的时候必须写正确。