360安卓游戏接入SDK文档以及FAQ

本文档描述安卓手机游戏通过360开放平台接口接入360平台的技术过程. 360开放平台为安卓游戏提供登录服务与支付服务.

本文档面向的读者是安卓应用开发者，包括客户端和服务器工程师。

手机游戏支付SDK接入http://openapi.360.cn/page/sdk_cms

游戏接入SDK FAQ

Q1: 接入过程中遇到问题，如何联系我们？

A1: 请详细阅读下面的FAQ，接入过程中常见的问题我们都给出了解答。
如果仍有问题，可以发邮件到我们的客服邮箱：360box@360.cn，我们会在1-2个工作日内给您答复。

Q2: 如何申请appkey和appsecret?

A2: 请参照本页目录第一项：手机应用提交指南，文档中详细讲解了申请appkey和appsecret的步骤，还有配图说明哦。

Q3: SDK发新版了, 接口没有变动, 如何替换新包

A3: 清除本地缓存，然后把JAR包替换原来的包。

Q4: 使用SSLSocketFactory类时报错

A4: 这个类在 httpclient-4.2.1.jar 里. 遇到错误时, 检查库的导入顺序, android Dependencies的优先级要高于android.jar的优先级, 这样就能找到httpclient的类了

Q5: 使用0.5和0.6版本SDK时, 用充值卡支付时失败, 日志有关于RSA的错误

A5: SDK包里的 open_publicKey.der 文件需要放进ASSET目录下

Q6: 支付时显示 获取订单失败, 找不到错误

A6: 这种错误一般都是因为参数错误而导致

1. 使用360币支付, 看打开的窗口里是否显示错误信息
2. 检查本地日志里有没有错误日志
3. 如果本地没有日志, 如果是SDK 0.7.2以上的版本, 使用SDK里打开日志的JAR包, 在本地就可以打出详细日志.

Q7: 手机号注册时, 发生了崩溃

A7: 查是否漏掉了配置权限

Q8: 按照DEMO包来做登录注册, 我需要修改DEMO里的哪些地方呢?

A8: 1. 配置自己的APP KEY和PRIVATE KEY
2. 登录需要应用服务器端介入. 在getAccessToken 和 getLoginInfo方法里, 使用了360的一个DEMO服务器端实现来与DEMO APK共同完成登录流程演示. 应用方需要替换为自己的服务器端实现来与客户端通信. 通信的数据格式无需拘泥于DEMO. 只要按照SDK文档里服务器接口返回值, 客户端需要什么数据直接做就可以了

Q9: 为毛DEMO运行时, 登录特别慢?

A9: 有可能是所使用的DEMO服务器端慢的缘故.

Q10: TOKEN指的是什么意思？

A10: 开放平台颁发的TOKEN指的是access_token和refresh_token,access_token是调用所有接口的token，refresh_token只有一个作用，就是用来刷新access_token和自身(refresh_token),默认情况下说token，指的是access_token。

Q11: TOKEN的有效期是多久

A11: 目前设定是10小时. 有效期过后, 需要刷新TOKEN才能调用360接口. 刷新token的有效期是14天，刷新后又可顺延。

Q12: 有效期内, 用户再次登录, 获取的TOKEN是一样的么

A12: 不一样. 每次登录都会换TOKEN. 原先的TOKEN立刻失效. 因此, 用户的每次登录, 应用都要更新TOKEN. 以防调用接口(如支付)时失败.

Q13: 应该怎样刷新TOKEN

A13: 通过应用服务器, 调用360接口. 在用户登录时, 应用服务器维护TOKEN. 在获取TOKEN的接口返回的数据项中, 有有效期字段. 应用可以用该数据来自行维护刷新时机, 比如已经过了一半时间或者2/3时间的时候去刷一下. 另外如前所述, 每次登录的TOKEN都会换新的.

Q14: 使用TOKEN调用服务器端接口时失败, 显示TOKEN已失效或者过期

A14: 1. 检查用户是否在线很长时间, 以至于TOKEN失效. 这样的话需要刷新TOKEN或者引导用户再登录一下
2. 检查用户是否在多台设备上用同一账号多次登录. 只有最后一次的TOKEN是可用的.
3. 上述两个都不是, 联系360开放平台手机SDK技术支持

Q15: 要做支付接入了, 有测试币吗. 如何测试支付呢?

A15: 抱歉没有测试环境. 只能用真钱. 建议按照下述方法来测试

1. 使用支付宝, 应用指定1元以下的金额,如10分钱, 来做支付. 这样可以减少测试成本. 虽然1元以下的金额在SDK上的显示是0元, 但支付流程不受影响.

2. 如果要测移动/电信/联通充值卡, 不管是多少钱的卡, 都建议设置充值金额为1元. 这样充值卡里剩下的钱会进到360币帐号里, 于是就顺带有360币可以做测试用了.

Q16: Unity3D进入注册/登录页面，停留较长时间后返回游戏，发现游戏与服务器的Socket通信连接断开

A16: 这是由于手机端游戏与服务器的Socket连接心跳线程优先级过低，Activity进入后台时通信线程被系统杀死所致。可以采用Service作为Socket通信心跳服务，或者将Socket通信线程优先级调高。

Q17: 不用SDK的话, 如何调试AUTH CODE换TOKEN的接口?

A17: 如果想手动测试完整的code换token流程, 需要先获取authorization code. SDK的登录流程里, authorization code是由SDK获取并直接返给客户端的. 如果想自己测试, 可以用下边的链接来直接访问接口, 注意替换[参数]为你自己的参数

1. 获取code, 会显示360帐号登录界面, 最后会跳转到一个成功的白页. 地址里面的code=xxxxxxxx 就是authorization code. 注意code只能被使用一次, 且60秒有效

https://openapi.360.cn/oauth2/authorize?client_id=[appkey]&response_type=code&redirect_uri=oob&scope=basic

2. auth code 换 access token, 注意 code 只能用一次, 且60秒内有效. 同时小心appsecret不要泄露

https://openapi.360.cn/oauth2/ac ... ion_code&client_id=[appkey]&client_secret=[appsecret]&redirect_uri=oob&code=[authcode]

3. refresh token, 注意refresh之后, access token 和 refresh token 都会更新. 原来的token会失效

https://openapi.360.cn/oauth2/ac ... sh_token&client_id=[appkey]&client_secret=[appsecret]&redirect_uri=oob&refresh_token=[refreshtoken]

4. 测试一下获取的token是否正确. 使用下边的链接, 看一下取到的token所对应的用户信息

https://openapi.360.cn/oauth2/get_token_info?access_token=[access_token]

Q18: 如何调试支付通知接口

A18: 支付通知接口在收到支付结果通知后, 要做订单验签, 数据验证(购买商品, 金额, 用户是否吻合), 然后给用户帐户加上要买的东西. 要做的事情多, 第一次很难保证就能完全走通, 建议按照下述步骤操作

1. 先保证支付通知接口是可访问的. 在浏览器上访问一下就知道了. 用IP地址的话注意不要是内网IP

2. 记录完整的请求日志, 把未经处理的请求参数串, 记在日志里.

3. 直接回应ok.

这样, 只要支付一次, 就可以获取到一个完整的通知参数串. 本地在浏览器上用这个参数串来访问接口, 慢慢调试验签, 数据校验, 以后后续的各种功能吧.

Q19: 如果要混淆java代码，如何配置？

A19: 如果要混淆java代码，请不要混淆联编的jar包中的类。可以添加以下类到proguard配置，排除在混淆之外：

-keep class com.qihoopay.insdk.** { *; }
-keep class com.qihoopay.insdk.activity.** { *; }
-keep class com.qihoopay.insdk.interfaces.** { *; }
-keep class com.qihoopay.insdk.matrix.** { *; }
-keep class com.qihoopay.insdk.utils.** { *; }
-keep class com.qihoopay.sdk.protocols.** { *; }

-keep class cn.paypalm.jar.game360.** { *; }
-keep class cn.paypalm.jar.game360.a.** { *; }
-keep class cn.paypalm.jar.game360.global.** { *; }

-keep class com.unionpay.upomp.bypay.** { *; }
-keep class com.unionpay.upomp.bypay.activity.** { *; }
-keep class com.unionpay.upomp.bypay.other.** { *; }
-keep class com.unionpay.upomp.bypay.util.** { *; }
-keep class com.unionpay.upomp.bypay.view.** { *; }

-dontwarn org.apache.http.conn.ssl.SSLSocketFactory

更多内容请访问以下链接
http://wiki.dev.app.360.cn/index.php?title=手机游戏SDK开发指南

热心，接入指导视频，手把手带你接入SDK
http://v.youku.com/v_show/id_XNTkxOTg2NjM2.html

沙发呀。
次帖目测是火帖。。。

没人回复？

我想问下，flash air开发的游戏怎么接入360平台啊

牛牛2050 发表于 2013-9-17 15:31
没人回复？

你这360手机助手里的电影和视频还有动漫怎么不管下载

肯定要支持啊

我的手机不能连接电脑了

{:4_89:}{:4_89:}

是不是都得需要自个弄个服务器呢？这样可是真麻烦，应该提供一个简易版本不需要服务器的方式。

电脑上360手机助手怎么删除？MD，再随便在我电脑安装这些垃圾软件，我们就到国家权威部门投诉你们

那问下，是企业游戏也要自行上传的吗？

请问一下，如果用UNITY 3d编写的游戏，怎么样接入到360手机助手平台上呢？他们开发 语言不一样，组织架构也不一样？求大牛解答

过来支持一下。

连FLASH AIR接入方式都没有，91，UC都有。哎！我的360啊，你敢重视下FLASH AIR游戏开发商么