2010年手机游戏腾讯渠道指导文档.doc

腾讯单机手机游戏动态JAD指导文档1.5腾讯科技(深圳)有限公司版权所有 不得复制版本历史日期版本号备注2008-05-271.0编写文档2008-5-291.01修改计费类型位数和积分上传规范内免费指令的获取方式,更新QQSMS和内置APP包2008-08-191.01更新默认的2元计费指令.2008-10-061.01更新积分上传指令的获取方式2009-9-81.11，增加计费类型是短代还是DO模式2，增加DO计费指令和接入号配置2009-11-241.21，增加对统一包中文件命名的描述2，增加对统一包中免费指令的描述3，增加对DO包指令完整格式的描述。2009-11-271.31，修改示例中的免费指令和接入号。2，修改示例中的DO指令和接入号。2009-12-21.41，更新加解密游戏包1.032，补充对指令加密描述。2010-6-211.51，增加QQ游戏中心名称和对应的UIRL获取接口；2，修改动态JAD指令示例；3，去除短代积分规范的说明。2010-8-181.6更新QQSMS包目录腾讯单机手机游戏动态JAD指导文档1.511.概述41.1.目的41.2.范围42.开发规范42.1.合作流程42.2.外部合作代码52.3.JAD文件配置122.4.计费说明132.5.积分上传说明143.附录141. 概述1.1. 目的目前越来越多的合作伙伴与腾讯公司进行单机手机游戏的合作。该规范文档使各合作伙伴能够顺利完成计费短信代码、渠道、手机终端类型的获取等工作，这些为以后进行短信计费代码的替换，用户行为分析，营销效果统计带来很大的方便，为后面用户行为的分析提供更详细的数据，方便合作伙伴分析用户行为开发更完美的软件。使双方的合作流程更加规范，项目进展顺利。1.2. 范围与所有合作伙伴在KJAVA平台关于单机游戏合作的开发。2. 开发规范2.1. 合作流程目前单机游戏的合作的步骤如下：1、 合作伙伴按照规范开发单机软件2、 合作伙伴提交移植后的单机软件开发包3、 腾讯根据合作伙伴提供的单机软件包进行测试。4、 如果测试没通过，返回步骤25、 如果测试通过，直接进行发布2.2. 外部合作代码腾讯公司提供源代码开发包和Demo程序。各合作伙伴通过开发包获取扣费指令、积分上传指令、一级渠道、二级渠道、内部渠道、用户的QQ号、终端类型。Demo如下：QQSMS1.04.zip为开发包，QQSMS-src.zip为Demo程序（可在此文档中双击打开）接口类为QQSms，接口说明：/*QQSms的构造函数*入参： MIDlet mMMIDlet ,MIDlet用于读取JAD文件*返回值：void*/public 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()/*获取计费模式*入参：无*返回值：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()说明：1，在计费点判断时，先调用getFeeMode获取计费点 ，如果是短代模式，按照原有流程进行计费下行， 如果是DO模式，则继续根据计费点序号调用getDoFeeCode方法，获取计费指令和目的号。 计费流程如下图：2，如果是DO模式，获取对应指令和接入号失败时，请注意控制程序逻辑，视同收费失败。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;106580351004166， 上传游戏包以原来的短代命名规范为准，包含“_S”，不可上传名称中包含“_D”字符的游戏包。7，免费上传积分指令获取方式保持不变，仍然使用getFreeCode()接口函数获取，默认指令从66变更到299，默认目的号从1066170046 变更到10661700299。 （详情见本文档中附件：QQ游戏积分上传技术指导书）8， 上传统一包时请按照新的命名规范对游戏包进行命名（参见：手机游戏命名与上传规则（CP）.doc）。9， 特别说明，目前短代指令需附加统计字段，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); /初始化mQQSmsprotected 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: + sms0 + ,dest: + sms1 + .;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: + freeSms0 + ,dest: + freeSms1 + .;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这个属性在发布游戏包的时候必须写正确。其他属性, SmsCode1, SmsCode2, SmsDest1, SmsDest2, ChannelFirst, ChannelSecond, InterChannel, QQ由腾讯公司动态修改。下面的配置供测试使用，测试时将这些属性加载JAD文件里面。测试的默认配置如下：SmsCode1: 1782A5B9ECE9820Ec81e728d9d4c2f636f067f89cc14862cSmsCode2: 62A9BB7A09BB9FC5c4ca4238a0b923820dcc509a6f75849bSmsDest1: ADB0FFA03412F5D869AE2EA173E23FBEd8b18e27d15de593890d5441cecfb259SmsDest2: ADB0FFA03412F5D869AE2EA173E23FBEd8b18e27d15de593890d5441cecfb259FreeCode: 5E477C897F925939ef0d3930a7b6c95bd2b32ed45989c61fFreeDest: 06818C025AF3AF5F5E477C897F9259397a1fa43673750e5a9f1a6b14c5f1a27eTerm: N7610ChannelFirst: FRChannelSecond: SECInterChannel: ICIDQQ: 0GameCenterName: QQ游戏中心GameCenterUrl: /g/s?aid=g_cp_adver&series=N73FeeMode: 1DoCode: 93F1C209F9880CA80C6F7243A49C0DDA273292BEBCB264A481B043CD94F372B8046634A6DBF635AA9A6E3A2631EF7EFFB75DE15EC12771F5273292BEBCB264A49539E55A29220D94073599C85DD922971d3ea0e275b54c15d9fa63388af0e6caDoDest: 4C8275A93ECDA86EE731C730E522C4618F6FB0566094046FEC048DC82F788636B80D3DBE354DBDA3C3BD1E07BFE604FBCDB0031092F9BE8D5F7F4FD7CBE2CEB5db8fa0f380066d23fe873cca52ad5645解密后对应明文如下SmsCode1: 2/1元短信指令代码SmsCode2: 1/2元短信指令代码SmsDest1: 1066622603/1元短信指令接入号SmsDest2: 1066622603/2元短信指令接入号FreeCode: 299 /免费指令代码FreeDest: 10661700299 /免费指令接入号Term: N7610/终端类型ChannelFirst: FR/一级渠道ChannelSecond: SEC/二级渠道InterChannel: ICID/内部渠道QQ: 0/下载用户的QQ号GameCenterName: QQ游戏中心/目前显示为：QQ游戏中心，后续可能会改名GameCenterUrl: /g/s?aid=g_cp_adver&series=N73/URL示例，实际内容会动态替换生成FeeMode:1/0 : 短代模式， 1 ： DO模式DoCode: YX,834,1,e926,30501;YX,834,2,da76,30501;YX,834,3,ef01,30501;YX,834,4,9444,30501/Do指令列表（分号分隔，示例数据是一个整体）DoDest: 10658035100416;10658035100416;10658035100416;10658035100416/Do接入列表（分号分隔，示例数据是一个整体）2.4. 计费说明游戏中在计