360移动开放平台

手机游戏社交SDK

手机游戏社交SDK简介：此sdk包主要面向需要接入社交功能的联网游戏开发者，包括有服务器和客户端两部分。

1、手机社交应用提交指南

接入SDK应用提交发布流程：点击查看

有任何技术问题，欢迎到游戏开发者论坛吐槽，寻求帮助。

2、各版本SDK&接入文档

版本号	发布时间	资源下载	本期更新说明
1.0.4	2014-8-8	SDK和接入文档	1、将普通登录、静默登录、离线登录3个登录接口简化合并成一个登录接口。 2、增加查看好友/可邀请好友个人详细资料的数据接口。

3、APK自检工具下载

接入过程中遇到的绝大多数问题是由于APK包不完整或基本设置错误导致的，该工具可以协助您在开发过程中自行检测。

APK自检工具下载：点击下载

提供功能：用于检查sdk的apk包，检查apk完整性和基本设置。

适用版本：适用于1.0.4及以上所有版本

运行环境：windows + jdk

使用方法：解压后，拖动apk到check_apk.bat即可。apk名请不要包含空格。

4、360手游数据统计分析服务（专享免费！）

360开放平台联合了国内最专业的数据分析服务提供商TalkingData，正式向您提供最专业的手机游戏数据统计分析服务：“TalkingGame 360开发者专属版”。

使用您的360开发者账户授权进入，即可立即获得免费使用特权。点击查看详情

5、接入流程FAQ

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

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

Q2: 如何申请appkey和appsecret?

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

Q3: 为什么成功我申请的app key和app secret，却依然无法使用SDK的全部功能

A3: 出现这种情况，一般是由于没有完全按照360手机游戏开发指南中“2.如何成为手机游戏开发者”的规定走完所有流程。尤其是第四步 申请加入白名单

Q4: app secret可以保存在手机本地吗？

A4: 不要这样来做，建议游戏开发者自己搭建服务器，将app secret保存起来。可以参考手机游戏SDK开发指南中的5.1关于OAuth

Q5: TOKEN指的是什么意思？

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

Q6: TOKEN的有效期是多久

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

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

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

Q8: 应该怎样刷新TOKEN

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

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

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

Q10: 社交功能中，哪些接口是必须要实现的？

A10: 必须实现的接口如下

FUNC_CODE	接口
FUNC_CODE_GET_GAME_FRIENDS	获取游戏中好友列表
FUNC_CODE_INVITE_FRIEND_BATCH	邀请好友
FUNC_CODE_ADD_FRIENDS	接受邀请添加为好友
FUNC_CODE_GET_CONTACT_CONTENT	获取可邀请好友列表
FUNC_CODE_UPLOAD_SCORE	上传积分
FUNC_CODE_SEND_MESSAGE	发送PUSH消息(发送礼物)

 

Q11: 究竟哪些好友是可以邀请的？

A11: 手机游戏SDK会根据用户的本地通讯录、360游戏平台中其他社交游戏中的好友进行计算，返回给用户那些是可以邀请的好友。

Q12: 好友已经收到了我的邀请短信，在游戏中为什么没有成为好友？

A12: 短信发送成功后，SDK会向360的邀请服务发送“邀请短信已经发送成功”的消息；如果这个时候网络状况不佳时，就会出现邀请失败的情况；即使被邀请收到短信，好友关系依然没有建立。建议开发者根据接口返回结果来提示用户邀请是否成功。

FUNC_CODE	接口
FUNC_CODE_INVITE_FRIEND_BATCH	邀请好友

接口返回结果示例

{ 　　errno: 0, 　　errmsg: "ok", 　　time: 1363155828, 　　data: { 　　　status: "1" //0：邀请失败，1：邀请成功 　　} }

 

Q13: 为什么邀请好友成功了，但好友登录后却看不到我

A13: 好友邀请的信息，需要主动获取，出现这种情况时，一般是没有调用接受好友邀请的接口造成的。用户在登录成功后，应该调用一次“接受邀请添加好友接口”。开发者可以根据自己的业务需要，在合适的时机调用该接口，及时的接受好友邀请。

FUNC_CODE	接口
FUNC_CODE_ADD_FRIENDS	接受邀请添加好友接口

 

Q14: 为什么登录是好用的，但是支付功能却无法正常使用

A14: 出现这种情况，请首先检查Mainifest.xml文件中，PRIVATEKEY是否已经正确的配置。

<meta-data 　　android:name="QIHOO_SDK_PRIVATEKEY" 　　android:value="4e04fe9ac8e2a73cbb27ba52ac076eb9" > </meta-data>

具体内容请参考相应版本的“接口说明”

注：更多与支付相关的FAQ，请参考“手机游戏SDK（支付版）”的相关说明