360 网游SDK安卓版Eclipse接入文档
注:此为通用版接入文档,详细内容请看SDK资源包里的word文档
目录
1. 重要提醒........................................................................................................................................ - 1 -
1.1 【重要】必接API说明......................................................................................................... - 1 -
1.2 应用服务器........................................................................................................................... - 1 -
1.3 编译版本要求........................................................................................................................ - 1 -
1.4 PrivateKey计算方法.......................................................................................................... - 1 -
1.5 主Activity设置................................................................................................................. - 2 -
1.6 Unity相关问题.................................................................................................................... - 2 -
1.7 测试须知............................................................................................................................... - 2 -
1.8 apk签名............................................................................................................................... - 2 -
1.9 apk包名............................................................................................................................... - 2 -
2. 接入流程........................................................................................................................................ - 3 -
2.1 申请APPID、APPKEY和APPSECRET...................................................................................... - 3 -
2.2导入资源包............................................................................................................................ - 3 -
2.2.1 导入jar包................................................................................................................ - 3 -
2.2.2 添加assets、res目录下的文件............................................................................... - 3 -
2.3 配置应用工程的AndroidManifest.xml............................................................................... - 3 -
2.4 编码接入............................................................................................................................... - 6 -
2.5 混淆编译............................................................................................................................... - 6 -
2.6 测试...................................................................................................................................... - 7 -
2.7 提交...................................................................................................................................... - 8 -
2.8 审核...................................................................................................................................... - 8 -
2.9 上线...................................................................................................................................... - 8 -
3. 编码接入详细介绍.......................................................................................................................... - 8 -
3.0隐私合规................................................................................................................................ - 8 -
3.1 初始化接口【客户端调用】(必接)...................................................................................... - 8 -
3.2 登录授权流程...................................................................................................................... - 10 -
3.2.1 登录接口【客户端调用】(必接)............................................................................ - 10 -
3.2.2 切换帐号接口【客户端调用】(必接)..................................................................... - 12 -
3.2.3 获取用户信息【服务端调用】(选接)..................................................................... - 12 -
3.3 支付流程............................................................................................................................. - 14 -
3.3.1 下单接口【服务端调用】(选接)............................................................................ - 14 -
3.3.2支付接口【客户端调用】(必接)............................................................................ - 15 -
3.3.3支付结果通知接口【服务端收取】(必接).............................................................. - 19 -
3.3.4订单核实接口【服务端调用】(选接)..................................................................... - 21 -
3.4 销毁接口【客户端调用】(必接)........................................................................................ - 22 -
3.5 退出接口【客户端调用】(必接)........................................................................................ - 23 -
3.6 游戏角色信息上传 (必接).................................................................................................. - 24 -
3.6.1 游戏角色信息上传接口【客户端调用】..................................................................... - 24 -
3.6.2 游戏角色信息上传接口【服务端调用】..................................................................... - 28 -
3.6.3 角色信息上传自测接口【有浏览器就能测】(必测!)............................................ - 28 -
3.7 游戏activity生命周期接口【客户端调用】(必接).......................................................... - 28 -
3.8 其他接口............................................................................................................................. - 29 -
3.8.1实名状态查询接口【客户端\服务端调用】(选接).................................................. - 29 -
3.8.2打开实名认证界面接口【客户端调用】(选接)....................................................... - 31 -
3.8.3分享接口【客户端调用】(选接)............................................................................ - 32 -
3.8.4打开论坛接口【客户端调用】(选接)..................................................................... - 34 -
3.8.5打开客服接口【客户端调用】(选接)..................................................................... - 34 -
3.8.6使用Matrix的get方法,获取基本信息【客户端调用】(选接)............................ - 35 -
3.8.7游戏退出时设置杀死应用进程标志位【客户端调用】(选接).................................. - 36 -
3.8.8初始化前修改浮球默认位置【客户端调用】(选接)................................................ - 36 -
3.8.9打开浮球里的浮窗【客户端调用】(选接).............................................................. - 36 -
4. 附录............................................................................................................................................. - 37 -
4.1 签名算法............................................................................................................................. - 37 -
4.2 Demo工程简介.................................................................................................................... - 38 -
4.3 服务端SDK参考程序........................................................................................................... - 38 -
4.4 常见问题............................................................................................................................. - 38 -
4.5 联系我们............................................................................................................................. - 38 -
1. 重要提醒
本文档面向安卓开发者。
本文档用于指导开发者快速接入360手游SDK,本SDK为安卓应用提供登录、注册、社交、支付等功能。
SDK接入请以SDK包内相应版本文档为准。
1.1 【重要】必接API说明
游戏提交审核时,若文档中的必接接口未接入或接入错误,均会导致审核不通过!!请务必给予重视,以免延误游戏上线时间!!
文档中每一个小节标题上写明【必接】二字的,为必接API,不接则无法过审。未写明【必接】二字的可根据实际需求选择接入。
角色信息接口为必接接口,不接入、接入之后不上传数据、上传过多空数据或上传字段不符合文档要求,均无法通过平台上线审核。请务必接入之后调试调用此接口,然后调用角色信息自测接口,确认data中有数据且数据正确,再上传游戏包。上传游戏包时,请提供至少3个测试使用的360帐号及密码,其中至少1个高级别帐号。
浮球-福利页面内的切换帐号功能为必接功能,如未接入、接入错误,均会导致审核不通过;游戏内部的切换帐号为选接功能,可根据游戏需求自行接入。
游戏若不需要支付功能,须先接入支付相关API,但不调用支付模块即可。其他功能亦是。
游戏方必须使用自己搭建的应用服务器,不可使用DEMO服务器,url(http://sdbxapp.msdk.mobilem.360.cn) 仅限DEMO示范使用,禁止正式上线游戏把DEMO应用服务器当做正式应用服务器使用。
1.3 编译版本要求
target版本需设置为小于或等于28。
编译时建议选择Android 4.2或以上的版本。
1.4 PrivateKey计算方法
必须把APPID、APPKEY、PRIVATEKEY三个值填写在AndroidManifest文件中,不能使用@string引用;禁止把AppSecret保存在手机客户端,AndroidManifest中存放的是Private Key,而非App-Secret。
Private Key的算法为:QHOPENSDK_PRIVATEKEY = MD5(appSecret + "#" + appKey),格式为32位小写。
利用自检工具计算privatekey:打开压缩包目录:\05-自检工具及测试用例\Check_Tools,双击cal_private_key.bat文件,输入游戏应用在开平申请到的appkey和secret参数,工具将自动计算privatekey,将计算得出的32位小写字符串直接黏贴到代码中即可。
1.5 主Activity设置
游戏(无论横竖屏,参照demo示例)必须在主Activity设置成@android:style/Theme.Translucent.NoTitleBar.Fullscreen
请参看unity接入SDK
- 自检工具(check tools)用来检验SDK接入是否正确,在SDK包的“05-自检工具及测试用例”文件夹内。自检时请不要将代码混淆或者加固,请用未加固、未混淆的代码自检。
自检常见问题及解决方法:
(1) 不应把代码混淆或加固。
(2) 没有把assets下的文件拷贝到工程下。
(3) 编译版本未达到最低要求。
(4) 缺少文件,请对比demo检查是否缺少部分文件夹
(5) 使用Unity或者其他引擎出的apk包,请先将工程导入eclipse然后导出apk包。
(1) 不应把代码混淆或加固。
(2) 因工程方法太多,需要进行拆分造成的。把sdk放到第一个dex里面即可。
- 测试用例是用来帮助CP遍历测试SDK接入之后功能否正常使用,在SDK包的“05-自检工具及测试用例”文件夹内。
接入360sdk后,apk出包时请务必使用V1签名,360平台暂不支持V2签名和V1V2双签名。
签名错误,将导致游戏在Android 7.0设备上无法运行!请务必重视!
游戏包名请务必使用.qihoo结尾。
游戏一旦在开平提交过apk包之后,包名不能修改!!第一次传包包名错误,必须重新新建游戏!请务必保证游戏包名不能变动,一旦包名和第一次提交的apk包名不一致将影响登录、支付、角色信息上传等功能!!
2. 接入流程
2.1 申请APPID、APPKEY和APPSECRET
企业开发者需要在360开放平台http://dev.360.cn/申请APPID、APPKEY及APPSECRET(一个应用只能申请一个appkey)。
本SDK目前支持Android4.4及以上的系统版本,为兼容Android 4.4及以上系统手机,编译时请使用Android4.4 或以上版本。
将SDK包内的Eclipse\libs\目录下的文件(夹)放到应用工程的libs目录下。
2.2.2 添加assets、res目录下的文件
将SDK包内的Eclipse\assets\目录下的文件(夹)复制到应用工程assets目录下。
将SDK包内的Eclipse\res\目录下的文件(夹)复制到应用工程res目录下。
2.3 配置应用工程的AndroidManifest.xml
分两步配置:
第一步,把Eclipse目录下的AndroidMainfext.xml中的内容不做任何修改的复制到游戏的AndroidMainfext.xml中,其中已包含SDK所需要的权限。
第二步:由于需要配置一些参数,所以以下配置需要游戏自行申请参数配置(具体可参看demo下的AndroidMainfext.xml):
<application>
<!--1、【必选接入】添加360SDK必需的meta-data:QHOPENSDK_APPKEY。此处value为APPKEY。请在360应用开放平台注册申请-->
<meta-data
android:name="QHOPENSDK_APPKEY"
android:value="08158bf9f09b919790a63f10c381be52" >
</meta-data>
<!--2、【必选接入】添加360SDK必需的meta-data:QHOPENSDK_APPID。此处value为APPID。请在360应用开放平台注册申请-->
<meta-data
android:name="QHOPENSDK_APPID"
android:value="201696301" >
</meta-data>
<!--3、【必选接入】必需的meta-data:QHOPENSDK_PRIVATEKEY。此处value为PRIVATEKEY不是APPSECRET,
而是md5(app_secret +”#”+ app_key),全小写,APPSECRET不允许保存在客户端!详见1.4 PrivateKey计算方法-->
<meta-data
android:name="QHOPENSDK_PRIVATEKEY"
android:value="dd09f2d209a268973d55a29d7f7961a4" >
</meta-data>
<!-- 4、【必选接入】添加360SDK必需的activity:其中${applicationId}必须为你的游戏包名 -->
<activity
android:name="com.qihoo.gamecenter.sdk.activity.ContainerActivity"
android:configChanges="fontScale|orientation|keyboardHidden|locale|navigation|screenSize|uiMode|layoutDirection"
android:exported="true"
android:theme="@android:style/Theme.Translucent.NoTitleBar.Fullscreen">
<!-- 支付宝签约后自动跳转到sdk配置 -->
<intent-filter>
<action android:name="android.intent.action.MAIN" />
<action android:name="android.intent.action.VIEW" />
<category android:name="android.intent.category.DEFAULT" />
<category android:name="android.intent.category.BROWSABLE" />
<!-- android host的值必须为游戏的包名 -->
<data android:host="${applicationId}" />
<!-- android scheme的值必须不能变-->
<data android:scheme="qihooonlinepay" />
</intent-filter>
</activity>
<!-- 5、【可选接入】微信登录功能的activity和微信APPID。
WXEntryActivity:如果游戏接入微信分享需要在游戏工程内实现这个activity,请直接使用demo中的代码实现,必须放在游戏的包名路径下;
QHOPENSDK_WEIXIN_APPID:微信的必须参数,用于微信登录和分享功能,在微信官网申请。
如果使用微信登录功能,在Manifest中配置QHOPENSDK_WEIXIN_APPID字段,同时需发送邮件至shouyou360@qq.com,
邮件需提供:游戏名称、游戏在360平台申请的appkey、游戏在微信申请的AppId和AppSecret。
微信登录WXEntryActivity请务必按照demo示例来进行接入。-->
<activity
android:name=".wxapi.WXEntryActivity"
android:exported="true"
android:theme="@android:style/Theme.Translucent.NoTitleBar" />
<meta-data
android:name="QHOPENSDK_WEIXIN_APPID"
android:value="wx38c06d349170365c" >
</meta-data>
<!-- 6、【可选接入】QQ登录功能。包括QQ登录的授权activity和QQAPPID:
QQAPPID:QQ登录的Activity,其中tencent101434511必须替换为QQ开放平台的APPID;
如果使用qq登录功能,在Manifest中配置QHOPENSDK_QQAPPID字段,同时需发送邮件至shouyou360@qq.com,
邮件需提供:游戏名称、游戏在360平台申请的appkey、游戏在QQ开放平台申请的AppId。
AuthActivity:QQ登录的Activity,其中tencent101434511中的101434511必须替换为上面申请的QQ APPID-->
<activity
android:name="com.tencent.tauth.AuthActivity"
android:launchMode="singleTask"
android:noHistory="true">
<intent-filter>
<action android:name="android.intent.action.VIEW" />
<category android:name="android.intent.category.DEFAULT" />
<category android:name="android.intent.category.BROWSABLE" />
<data android:scheme="tencent101434511" />
</intent-filter>
</activity>
<meta-data
android:name="QHOPENSDK_QQAPPID"
android:value="101434511" >
</meta-data>
<!-- 7、【可选接入】文件操作需要的代码,如果不接入可能会影响下载,保存图片、QQ等功能,其中${applicationId}必须为你的游戏包名 -->
<provider
android:name="com.qihoo.gamecenter.sdk.common.utils.QGameFileProvider"
android:authorities="${applicationId}.QGameFileProvider"
android:exported="false"
android:grantUriPermissions="true"
tools:replace="android:authorities">
<meta-data
android:name="android.support.FILE_PROVIDER_PATHS"
android:resource="@xml/f_file_paths"
tools:replace="android:resource" />
</provider>
</application>
详见【章节3】编码接入详细介绍
如果要混淆java代码,请不要混淆联编的jar包中的类。可以添加以下类到proguard配置,排除在混淆之外:
-keep class cn.pp.** { *; }
-keep class cn.pp.** { *; }
-keep class org.json.alipay.** { *; }
-keep class com.alipay.** {*;}
-keep class com.nearme.atlas.** {*;}
-keep class com.qihoo.** {*;}
-keep class com.qihoo360.** { *; }
-keep class com.qihoopp.** { *; }
-keep class com.qihoosdk.** {*;}
-keep class qihoohttp.** {*;}
-keepnames class qihoohttp.** {*;}
-keep class com.heepay.plugin.**{*;}
-keepnames class com.heepay.plugin.**{*;}
-keep class com.yeepay.safekeyboard.** { *; }
-keep class com.ipaynow.** {*;}
-keep class com.ta.utdid2.** {*;}
-keep class com.ut.device.** {*;}
-keep class com.tencent.** {*;}
-keepnames class okhttp3.internal.publicsuffix.PublicSuffixDatabase
-keep class okhttp3.** {*;}
-keepnames class okhttp3.** {*;}
-keep class com.cloudplay.**{*;}
-keep class com.qihoo.antispam.holmes.**{*;}
-keep class com.qihoo360.qos.**{ *;}
-keep class com.qihoo.gamecenter.sdk.common.stat.qos.**{*;}
-keep class com.qihoo360.qos.staticmsa.** {*;}
-keep class com.bun.miitmdid.core.** {*;}
-keep class com.bun.supplier.** {*;}
-dontwarn com.cmic.sso.sdk.**
-keep class com.cmic.** {*;}
-keep class com.cmic.sso.sdk.** {*;}
-keep class cn.com.chinatelecom.**{*;}
-keep class cn.com.chinatelecom.account.api.**{*;}
-keep class com.unicom.sdklibrary.** {*;}
-keep interface com.unicom.sdklibrary.ResultListener {*;}
-keep class com.qihoo.gamecenter.sdk.common.isp.**{*;}
-keep class com.qihoo.gamecenter.sdk.common.view.PrivacyModel { *;}
-keep class com.qihoo.gamecenter.sdk.common.view.PrivacyName { *;}
<!—重要: webview兼容5.0以上 -->
-keepclassmembers class * extends android.webkit.WebChromeClient {
public void openFileChooser(...);
public boolean onShowFileChooser(...);
}
-dontwarn com.unicom.xiaowo.account.shield.**
-keep class com.unicom.xiaowo.** {*;}}
-keep class android.net.http.** {*;}
-keep class com.android.internal.http.multipart.** {*;}
-keep class org.apache.commons.logging.** {*;}
-keep class org.apache.commons.codec.** {*;}
-keep class org.apache.http.** {*;}
# 以下为360自研OAID SDK的混淆配置
# sdk
-keep class com.bun.miitmdid.** { *; }
-keep interface com.bun.supplier.** { *; }
# asus
-keep class com.asus.msa.SupplementaryDID.** { *; }
-keep class com.asus.msa.sdid.** { *; }
# freeme
-keep class com.android.creator.** { *; }
-keep class com.android.msasdk.** { *; }
# huawei
-keep class com.huawei.hms.ads.** { *; }
-keep interface com.huawei.hms.ads.** {*; }
# lenovo
-keep class com.zui.deviceidservice.** { *; }
-keep class com.zui.opendeviceidlibrary.** { *; }
# meizu
-keep class com.meizu.flyme.openidsdk.** { *; }
# nubia
-keep class com.bun.miitmdid.provider.nubia.NubiaIdentityImpl { *; }
# oppo
-keep class com.heytap.openid.** { *; }
# samsung
-keep class com.samsung.android.deviceidservice.** { *; }
# vivo
-keep class com.vivo.identifier.** { *; }
# xiaomi
-keep class com.bun.miitmdid.provider.xiaomi.IdentifierManager { *; }
# zte
-keep class com.bun.lib.** { *; }
# coolpad
-keep class com.coolpad.deviceidsupport.** { *; }
-keepnames class * implements android.os.Parcelable
-keepclassmembers class * implements android.os.Parcelable {
public final static *** CREATOR;
}
-keepnames class * implements android.os.Parcelable
-keepclassmembers class * implements android.os.Parcelable {
public final static *** CREATOR;
}
关闭混淆警告可以使用-ignorewarnings参数,或者使用如下配置只关闭SDK类的混淆警告:
-dontwarn cn.pp.**
-dontwarn com.qihoo.**
-dontwarn com.qihoo360.**
-dontwarn com.qihoopp.**
-dontwarn com.qihoosdk.**
-dontwarn qihoohttp.**
-dontwarn com.alipay.**
-dontwarn com.alipay.android.app.**
-dontwarn com.yeepay.safekeyboard.**
-dontwarn com.heepay.plugin.**
-dontwarn okhttp3.**
-dontwarn okio.**
-dontwarn javax.annotation.**
-dontwarn org.conscrypt.**
-dontwarn android.**
-dontwarn java.net.**
-dontwarn com.qihoo.antispam.holmes.**
-dontwarn com.bun.miitmdid.core.**
-dontwarn com.bun.supplier.**
- 请使用自测工具检查接入完整性;
- 在SDK 包中提供了测试用例,用于功能点测试。
经过测试后的app,请在360移动开放平台http://dev.360.cn/提交apk 文件
应用提交审核后,360平台会将审批结果以邮件形式进行反馈。
客服电话:010-58781044
客服邮箱:360box@360.cn
应用通过审核后将在1个小时后发布上线。
3. 编码接入详细介绍
3.0隐私合规
隐私合规相关优化参考:https://easydoc.soft.360.cn/doc?project=2c42fb457343dd30ef727135425573aa&doc=b40020aac65eee78ebee22c813b50cb8&config=title
3.1 初始化接口【客户端调用】(必接)
- 在Application中的OnCreate中初始化SDK
游戏在Application中的OnCreate中必须调用360手游SDK的初始化,否则360手游SDK将无法正常工作,请参见Demo,如下图:
- 在应用主Activity中,使用Matrix的setActivity方法(注:一定要在主线程调用)
public static void setActivity (final Activity activity, MatrixCallBack matrixCallBack, boolean debugMode)用于加载360SDK功能,在应用主Activity的onCreate()函数中必须调用1次该方法,否则360SDK处于未初始化状态,无法使用其他接口。
当360SDK处于未初始化状态时,调用其任何接口都会返回错误,错误码为-101。
参数:
activity:activity对象
matrixCallBack:开发者实现该回调接口,达到切换帐号功能,请务必接入。(详见demo源码)
debugMode:360SDK内部提供了自动检测SDK接入是否完整的功能和输出调试LOG的功能,默认为 false,这两项功能关闭,true则打开这两个功能,上线前请务必设置为 false。(570版本添加的参数,详见demo源码)
使用示例:
protected MatrixCallBack mSDKCallback = new MatrixCallBack() {
@Override
public void execute(Context context, int functionCode, String functionParams) {
if (functionCode == ProtocolConfigs.FUNC_CODE_SWITCH_ACCOUNT) {
doSdkSwitchAccount(getLandscape(context));
}else if (functionCode == ProtocolConfigs.FUNC_CODE_INITSUCCESS) {
//这里返回成功之后才能调用SDK 登录接口
}else if (functionCode == ProtocolConfigs.FUNC_CODE_LOGIN){
// sdk 浮窗内登录的回调,具体参见demo示
}else if (functionCode == ProtocolConfigs.FUNC_CODE_LOGINAFTER_REALNAME_CALLBACK){
// 当收到此回调后才可调用SDK提供的实名状态查询接口、打开实名认证界面接口。具体的返回内容是functionParams,数据格式如下。
} else if (functionCode == ProtocolConfigs.FUNC_CODE_PRIVACY_AGREED){
// 用户点击了同意隐私协议按钮
}
}
};
Matrix.setActivity(this, mSDKCallback, false);
备注:实名认证回调数据格式说明
(1)正确的数据格式,会返回实名状态 0是未实名、1是已实名未成年、2是已实名已成年
{
"error_code": "0",
"error_msg": "请求成功",
"content": {
"ret": [{
"qid": "3190816167",
"status": "2"
}]
}
}
(2)错误的数据格式,当遇到以下两个错误码的时候,如果游戏需要实名状态信息,请主动调用SDK提供的接口查询用户实名状态。 {
"error_code": -3001,
"error_msg": "实名查询关闭,请手动调用查询接口查询"
}
{
"error_code": -3002,
"error_msg": "实名查询异常,请手动调用查询接口查询"
}
3.2 登录授权流程
360开放平台的登录流程使用Oauth2协议标准授权流程。
登录流程
- 应用客户端调用SDK进行登录 (见本章的接口介绍);
- 360SDK与360 服务器通信进行用户登录,返回登录结果及用户信息;
- 360SDK把登录结果返给应用客户端,登录完成。
注意事项
- 360SDK登录接口返回的用户信息中没有qid。如果游戏想要获取qid,需要通过应用服务器端向360服务器端发起请求,用access token换取qid,具体调用方式见『获取用户信息接口』。
- 如果用户重新登陆,会获取到新的token,原token即失效。用户若用同样帐号在不同设备上登录同一游戏, 只有最后一次登录获取的token是最终有效的。
- 调用任何其他需要登录后才能调用的接口时,如果360SDK未处于登录状态,会直接返回错误,错误码为-100。
- 调用注销接口或销毁接口会让360SDK回到未登录的状态。
3.2.1 登录接口【客户端调用】(必接)
功能说明:
展示登录界面, 让用户登录。若登录成功,返回errno为0并带有用户信息。
登录成功SDK会返回结果,登录失败会停留在登录界面,除非用户按返回键取消登录尝试。
注意:1)调用登录接口必须在初始化接口callback返回值后调用(详见初始化接口调用示例);
2)游戏方获取用户信息后,需要保存自身帐号与360帐号的绑定关系。
接口示例:
/**
* 使用360SDK的登录接口, 生成intent参数
*
* @param isLandScape 是否横屏显示登录界面
*/
private Intent getLoginIntent(boolean isLandScape) {
Intent intent = new Intent(this, ContainerActivity.class);
// 必需参数,使用360SDK的登录模块
intent.putExtra(ProtocolKeys.FUNCTION_CODE, ProtocolConfigs.FUNC_CODE_LOGIN);
// 可选参数,360SDK界面是否以横屏显示,默认为true,横屏
intent.putExtra(ProtocolKeys.IS_SCREEN_ORIENTATION_LANDSCAPE,isLandScape);
//-- 以下参数仅仅针对自动登录过程的控制
// 可选参数,自动登录过程中是否不展示任何UI,默认展示。
intent.putExtra(ProtocolKeys.IS_AUTOLOGIN_NOUI,
getCheckBoxBoolean(R.id.isAutoLoginHideUI));
return intent;
}
// 调用接口
Protected void doSdkLogin(boolean isLandScape) {
mIsInOffline = false;
Intent intent = getLoginIntent(isLandScape);
IDispatcherCallback callback = mLoginCallback;
if (getCheckBoxBoolean(R.id.isSupportOffline)) {
callback = mLoginCallbackSupportOffline;
}
Matrix.execute(this, intent, callback);
}
返回数据格式:
{
"data": {
"expires_in": "36000",
"scope": "",
"refresh_token": "",
"access_token": "6461171100c3bfa3cba24cc332d7d78b311d2bf590f4877c9" // token
},
"errno": 0
}
callback示例:
// 登录、注册的回调
privateIDispatcherCallback mLoginCallback = newIDispatcherCallback() {
@Override
publicvoid onFinished(String data) {
// press back
if (isCancelLogin(data)) {
return;
}
// 显示一下登录结果
Toast.makeText(SdkUserBaseActivity.this, data, Toast.LENGTH_LONG).show();
mIsInOffline = false;
mQihooUserInfo = null;
// 解析access_token
mAccessToken = parseAccessTokenFromLoginResult(data);
if (!TextUtils.isEmpty(mAccessToken)) {
// 需要去应用的服务器获取用access_token获取一下用户信息
getUserInfo();
} else {
Toast.makeText(SdkUserBaseActivity.this, "get access_token failed!",
Toast.LENGTH_LONG).show();
}
}
};
3.2.2 切换帐号接口【客户端调用】(必接)
功能说明:
浮球-福利页面内的切换帐号功能为必接功能,如未接入、接入错误,均会导致审核不通过;
游戏内部的切换帐号为选接功能,可根据游戏需求,自行在游戏的菜单中添加“切换帐号”的入口,方便用户切换帐号。
应用调用360SDK切换帐号接口, 360SDK显示登录页面,用户可更换帐号进行登录。之后的登录流程和返回结果与登录接口一样。
示例代码:
/**
* 使用360SDK的切换帐号接口
*
* @param isLandScape 是否横屏显示登录界面
*/
protected void doSdkSwitchAccount(boolean isLandScape) {
Intent intent = getSwitchAccountIntent(isLandScape);
Matrix.invokeActivity(this, intent, mAccountSwitchCallback);
}
intent参数说明:
除FUNCTION_CODE外,其他同登录接口
intent.putExtra(ProtocolKeys.FUNCTION_CODE, ProtocolConfigs.FUNC_CODE_SWITCH_ACCOUNT);
callback的 json格式说明:
同登录接口
3.2.3 获取用户信息【服务端调用】(选接)
应用服务端获取access token后,可调用360开放平台服务器端接口/user/me,获取360用户id以及其它用户信息。
获取用户信息后,应用需要保存自身帐号与360帐号的绑定关系,请务必使用360用户ID作为绑定关系的标示。并且妥善保存用户信息留待以后使用。请求该接口时,请务必设置超时时间,建议超时时间设置在5秒以下,游戏方可根据自身需求合理设置超时时间。
接口地址为:https://openapi.360.cn/user/me.json
参数说明:
参数 |
必选 |
参数说明 |
access_token |
Y |
授权的access token |
fields |
N |
允许应用自定义返回字段,多个属性之间用英文半角逗号作为分隔符。不传递此参数则缺省返回id,name,avatar |
返回参数:
参数 |
必选 |
参数说明 |
id |
Y |
360用户ID, 缺省返回 |
name |
Y |
360用户名, 缺省返回 |
avatar |
Y |
360用户头像, 缺省返回 |
sex |
N |
360用户性别,仅在fields中包含时候才返回,返回值为:男,女或者未知 |
area |
N |
360用户地区,仅在fields中包含时候才返回 |
nick |
N |
用户昵称,无值时候返回空 |
请求示例:
https://openapi.360.cn/user/me.json?access_token=12345678983b38aabcdef387453ac8133ac3263987654321&fields=id,name,avatar,sex,area
返回示例:
HTTP/1.1 200 OK
Content-Type: application/json
Cache-Control: no-store
{
"id": "201459001",
"name": "360U201459001",
"avatar": "http://u1.qhimg.com/qhimg/quc/...ed6e9c53543903b",
"sex": "未知"
"area": ""
}
- 应用客户端调用应用服务端进行下单(此部分视游戏自身实际情况,应用服务端可选择调用360SDK服务端3.3.1下单接口发起下单,以提升支付安全性。);
- 应用客户端调用360SDK客户端3.3.2支付接口发起支付;
- 360SDK客户端调用相应支付方式引导用户完成支付;
- 支付完成或失败、终止后,360SDK客户端会返回支付结果给应用客户端的支付模块;
- 支付成功后,360SDK服务端通过3.3.3支付结果通知接口将支付结果发送至应用客户端下单时所填写的应用服务端支付结果通知地址;
- 应用服务端调用360SDK服务端3.3.4订单核实接口,验证支付通知的合法性(可选)。
3.3.1 下单接口【服务端调用】(选接)
功能说明:
从应用服务端直接提交订单参数到360服务端,避免客户端发生篡改,提升支付安全性。
注意:
- 本接口仅在应用服务端调用,不能在客户端调用,无服务端可忽略本接口。
- 在调用本接口前,请务必验证订单参数的正确性。
- 本接口成功返回的token_id和order_token用于在3.3.1 支付接口【客户端调用】中发起支付使用。
接口示例:
https://mgame.360.cn/srvorder/get_token.json?参数列表
参数列表:
参数 |
必选 |
参数类型 |
最大长度 |
参数说明 |
是否参与签名 |
app_key |
Y |
varchar |
32 |
应用app key |
Y |
product_id |
Y |
varchar |
36 |
应用自定义的商品id |
Y |
product_name |
Y |
varchar |
32 |
应用自定义的商品名称 |
Y |
amount |
Y |
int unsigned |
11 |
商品金额,以分为单位 |
Y |
app_uid |
Y |
varchar |
50 |
应用分配给用户的id |
Y |
app_uname |
Y |
varcahr |
50 |
应用内的用户名 |
Y |
app_ext1 |
N |
varchar |
255 |
应用扩展信息1原样返回 |
Y |
app_ext2 |
N |
varchar |
255 |
应用扩展信息2原样返回 |
Y |
user_id |
Y |
varchar |
64 |
360帐号id |
Y |
sign_type |
Y |
varchar |
8 |
定值 md5 |
Y |
app_order_id |
N |
varchar |
64 |
应用订单号
支付请求时传递,原样返回 |
Y |
sign |
Y |
varchar |
32 |
签名 |
N |
接口返回值:
成功返回
{"token_id":1706196451765971159, "order_token": "nPKJTXUJiG40SZdY3yFMXcIiIuiCXmOaZFuHcW6F2cWvzDweLtZlvlSszY0PsjYmkkhGAJRsNd18B3B5UpxszI1NT+CfFWR6Y/Nbf5yGTbHOfeftY9623KjoiU3N3H0UI0p9PQODxpq2cIWyNXEBZZmvXMCOCfpVI9cTbzmVwcLd8lTL5jVzS/PNLS4dHZ4L4CS9tKwQCodbwKdxxbczvY5UfravRwNv3o2qoeas0gWNChgw6nbOoeaHeftxktDeGZp0zevHYwhRPGZkz6bdYQ=="}
参数 |
必选 |
参数类型 |
最大长度 |
参数说明 |
说明 |
token_id |
Y |
string |
20 |
下单参数的token_id |
需下发给应用客户端 |
order_token |
Y |
string |
512 |
下单参数token |
需下发给应用客户端 |
失败返回
{"error_code": 400, "error": "获取失败"}
access_token失效
{error_code: 4010201, error_msg: " token已失效"}
QT失效
{error_code: 4009911, error_msg: " 登录已失效"}
3.3.2支付接口【客户端调用】(必接)
功能说明:
应用调用360SDK支付接口时,360SDK根据应用下单信息通过360聚合收银台或应用所选支付方式发起支付。
360SDK通知用方发放道具时,会返回应用订单号,同时提供360订单号。
接口示例:
注意:
- 必选参数不能为空, 不能为0,否则支付失败。
- 参数名,以ProtocolKeys中定义的常量为准。
- 请务必对case 0、1、-1加入处理语句,如果为空会导致游戏崩溃。
protected void doSdkPay(QihooUserInfo usrinfo, boolean isLandScape,int functionCode) {
if (!checkLoginInfo(usrinfo)) {
return;
}
if(!isAccessTokenValid) {
Toast.makeText(SdkUserBaseActivity.this, R.string.access_token_invalid, Toast.LENGTH_SHORT).show();
return;
}
if(!isQTValid) {
Toast.makeText(SdkUserBaseActivity.this, R.string.qt_invalid, Toast.LENGTH_SHORT).show();
return;
}
// 支付基础参数
QihooPayInfo payInfo = getQihooPayInfo(functionCode);
Intent intent = getPayIntent(isLandScape, payInfo, functionCode);
// 必需参数,使用360SDK的支付模块:CP可以根据需求选择使用带有收银台的支付模块或者直接调用微信支付模块或者直接调用支付宝支付模块。
//functionCode 对应三种类型的支付模块:
//ProtocolConfigs.FUNC_CODE_PAY;// 360聚合支付模块。(首次支付有收银台,基于各类因素推荐用户使用每笔订单支付最便捷的支付方式,常规手游可以此方式接入支付,以最小开发成本快速接入上线)
//ProtocolConfigs.FUNC_CODE_WEIXIN_PAY;//微信支付模块。(无收银台,直接调用微信发起支付,用户设备中需安装微信客户端)
//ProtocolConfigs.FUNC_CODE_ALI_PAY;//支付宝支付模块。(无收银台,直接调用支付宝发起支付,用户设备中可不安装支付宝客户端)
intent.putExtra(ProtocolKeys.FUNCTION_CODE, functionCode);
Matrix.invokeActivity(this, intent, mPayCallback);
}
protected Intent getPayIntent(boolean isLandScape, QihooPayInfo pay,int functionCode) {
Bundle bundle = new Bundle();
// 界面相关参数,360SDK界面是否以横屏显示。
bundle.putBoolean(ProtocolKeys.IS_SCREEN_ORIENTATION_LANDSCAPE, isLandScape);
// *** 以下非界面相关参数 ***
// 设置QihooPay中的参数。
// 必需参数,360帐号id。
bundle.putString(ProtocolKeys.QIHOO_USER_ID, pay.getQihooUserId());
// 必需参数,所购买商品金额,以分为单位,最小金额1分
bundle.putString(ProtocolKeys.AMOUNT, pay.getMoneyAmount());
// 必需参数,所购买商品名称,应用指定,建议中文,最大10个中文字。
bundle.putString(ProtocolKeys.PRODUCT_NAME, pay.getProductName());
// 必需参数,购买商品的商品id,应用指定,最大36中文字。
bundle.putString(ProtocolKeys.PRODUCT_ID, pay.getProductId());
// 必需参数,应用方提供的支付结果通知uri,最大255字符。360服务器将把支付接口回调给该uri,具体协议请查看文档中,支付结果通知接口–应用服务器提供接口。
bundle.putString(ProtocolKeys.NOTIFY_URI, pay.getNotifyUri());
// 必需参数,游戏或应用名称,最大16中文字。
bundle.putString(ProtocolKeys.APP_NAME, pay.getAppName());
// 必需参数,应用内的用户名,如游戏角色名。若应用内绑定360帐号和应用帐号,则可用360用户名,最大16中文字。(充值不分区服,充到统一的用户账户,各区服角色均可使用)。
bundle.putString(ProtocolKeys.APP_USER_NAME, pay.getAppUserName());
//必需参数,应用内的用户id。
// 若应用内绑定360帐号和应用帐号,充值不分区服,充到统一的用户账户,各区服角色均可使用,则可用360用户ID最大32字符。
bundle.putString(ProtocolKeys.APP_USER_ID, pay.getAppUserId());
//若接入3.3.1下单接口【服务端调用】,则以下两个参数必需传递,由此服务端接口返回值获得;若未接入此服务端接口,则以下两个参数无需传递。
intent.putExtra(ProtocolKeys.TOKEN_ID, tokenIdS);
intent.putExtra(ProtocolKeys.ORDER_TOKEN, orderIdS);
// 可选参数,应用扩展信息1,原样返回,最大255字符。
bundle.putString(ProtocolKeys.APP_EXT_1, pay.getAppExt1());
// 可选参数,应用扩展信息2,原样返回,最大255字符。
bundle.putString(ProtocolKeys.APP_EXT_2, pay.getAppExt2());
// 必需参数,应用订单号,应用内必须唯一,最大32字符。。应用方需要生成自己的订单号app_order_id,应用订单号不能重复提交,并且一个应用订单不管是否支付成功,都仅可支付一次,以避免重复支付。若游戏无服务端,此订单号可通过年月日时分秒+设备号等随机数生成即可。
bundle.putString(ProtocolKeys.APP_ORDER_ID, pay.getAppOrderId());
// 必需参数,使用360SDK的支付模块:CP可以根据需求选择使用带有收银台的支付模块或者直接调用微信支付模块或者直接调用支付宝支付模块。
//functionCode 对应三种支付模块:
//ProtocolConfigs.FUNC_CODE_PAY;//表示带有360收银台的支付模块。
//ProtocolConfigs.FUNC_CODE_WEIXIN_PAY;//表示微信支付模块。
//ProtocolConfigs.FUNC_CODE_ALI_PAY;//表示支付宝支付模块。
bundle.putInt(ProtocolKeys.FUNCTION_CODE,functionCode);
Intent intent = new Intent(this, ContainerActivity.class);
intent.putExtras(bundle);
return intent;
}
callback的 json数据格式:
成功返回
{error_code: 0, error_msg: "支付成功", content:""}
失败返回
{error_code: 1, error_msg: "支付失败", content:""}
取消返回
{error_code: -1, error_msg: "支付取消", content:""}
支付正在进行
{error_code: -2, error_msg: "正在进行", content:""}
access_token失效
{error_code: 4010201, error_msg: " token已失效", content:""}
QT失效
{error_code: 4009911, error_msg: " 登录已失效", content:""}
callback示例:
/**
* 支付的回调
*/
protected IDispatcherCallback mPayCallback = new IDispatcherCallback() {
@Override
public void onFinished(String data) {
Log.d(TAG, "mPayCallback, data is " + data);
if(TextUtils.isEmpty(data)) {
return;
}
boolean isCallbackParseOk = false;
JSONObject jsonRes;
try {
jsonRes = new JSONObject(data);
// error_code 状态码: 0 支付成功, -1 支付取消, 1 支付失败, -2 支付进行中。
// 请务必对case 0、1、-1、-2加入处理语句,如果为空会导致游戏崩溃。若应用有支付服务端,则需以360服务端通知给应用服务端的结果进行道具发放;若应用无服务端,则0、-2需发放道具;-1、1无需发放道具。
// error_msg 状态描述
int errorCode = jsonRes.optInt("error_code");
isCallbackParseOk = true;
switch (errorCode) {
case 0:
case 1:
case -1:
case -2: {
isAccessTokenValid = true;
String errorMsg = jsonRes.optString("error_msg");
String text = getString(R.string.pay_callback_toast, errorCode, errorMsg);
Toast.makeText(SdkUserBaseActivity.this, text, Toast.LENGTH_SHORT).show();
}
break;
case 4010201:
isAccessTokenValid = false;
Toast.makeText(SdkUserBaseActivity.this, R.string.access_token_invalid, Toast.LENGTH_SHORT).show();
break;
case 4009911:
//QT失效
isQTValid = false;
Toast.makeText(SdkUserBaseActivity.this, R.string.qt_invalid, Toast.LENGTH_SHORT).show();
break;
default:
break;
}
} catch (JSONException e) {
e.printStackTrace();
}
// 用于测试数据格式是否异常。
if (!isCallbackParseOk) {
Toast.makeText(SdkUserBaseActivity.this, getString(R.string.data_format_error),
Toast.LENGTH_LONG).show();
}
}
};
3.3.3支付结果通知接口【服务端收取】(必接)
以下服务端调整兼容接入各版本SDK的游戏包,除单机SDK所产生的免登录支付订单外,各版本游戏产生的订单均请按以下方式修改。
- 应用客户端调用支付接口时,需指定支付结果的通知回调地址notify_uri。支付完成后,360服务器会把支付结果以GET方式通知到此地址(建议应用服务端接口同时支持GET和POST)。
- 应用接收验证参数后,必须检查360SDK服务端支付结果通知接口中的以下参数与下单时游戏方记录的参数一致性,防止出现篡改。
- app key;360帐号id;应用分配给用户的id;应用自定义的商品id;商品金额;应用扩展信息1;应用扩展信息2
- 如果出现不一致,则可能出现交易信息篡改,需要停止发货。
支付结果通知的参数如下:
参数 |
必选 |
参数类型 |
最大长度 |
参数说明 |
是否参与签名 |
app_key |
Y |
varchar |
32 |
应用app key |
Y |
product_id |
Y |
varchar |
36 |
应用自定义的商品id |
Y |
amount |
Y |
int unsigned |
11 |
商品金额,以分为单位 |
Y |
app_uid |
Y |
varchar |
50 |
应用分配给用户的id |
Y |
app_ext1 |
N |
varchar |
255 |
应用扩展信息1原样返回 |
Y |
app_ext2 |
N |
varchar |
255 |
应用扩展信息2原样返回 |
Y |
user_id |
Y |
varchar |
64 |
360帐号id |
Y |
order_id |
Y |
varchar |
32 |
360返回的支付订单号 |
Y |
gateway_flag |
Y |
varchar |
16 |
如果支付返回成功,返回success
应用需要确认是success才给用户加钱 |
Y |
sign_type |
Y |
varchar |
8 |
定值 md5 |
Y |
app_order_id |
N |
varchar |
64 |
应用订单号
支付请求时传递,原样返回 |
Y |
sign_return |
Y |
varchar |
32 |
应用回传给订单核实接口的参数
不加入签名校验计算 |
N |
sign |
Y |
varchar |
32 |
签名 |
N |
应用接收到支付平台回调的请求,参见附录的签名算法对参数进行签名,然后和平台传递的签名sign比较,从而校验平台请求的合法性.
通知消息样例:
order_id=1211090012345678901&app_key=1234567890abcdefghijklmnopqrstuv&product_id=p1&amount=101&app_uid=123456789&app_ext1=XXX201211091985&app_order_id=order1234&user_id=987654321&sign_type=md5&gateway_flag=success&sign=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx&sign_return=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
样例的签名字段排列 (列出来仅供参考, 请根据实际参数情况用程序排序产生, 不要写死在程序里)
amount, app_ext1, app_key, app_order_id, app_uid, gateway_flag, order_id, product_id, sign_type, user_id
样例的签名串
101#XXX201211091985#1234567890abcdefghijklmnopqrstuv#order1234#123456789#success#1211090012345678901#p1#md5#987654321#应用app_secret
- 应用服务端在接收到通知消息并校验后, 需将通知接收状态、商品/道具最终发货结果状态及未发货原因回应给360服务端:
- utf8 编码 json格式应答;
- {"status":"ok","delivery":"success","msg":""}
- key值,且必须为小写)
参数 |
必选 |
参数类型 |
最大长度 |
参数说明 |
取值范围 |
status |
Y |
string |
16 |
接收通知状态,status应答"ok"表示通知已经接收,360通知不再重发。如果该字段回应其他值或者不回应,则被认为通知失败,360会尝试多次通知.以避免掉单。 |
ok,error |
delivery |
Y |
string |
32 |
商品/道具最终发货结果状态,其中“mismatch”表示通知中360用户id或游戏用户id与游戏方下单时记录的值不同 |
success,mismatch,other |
msg |
Y |
string |
64 |
当发货状态为非success时说明原因,用于用户向360咨询时进行说明 |
自定义 |
注:应用应做好接收到多次通知的准备,防止多次加钱。对于重复的通知,应用可能发现订单已经成功处理完毕,无需继续处理,也应返回应答。否则,360会认为未成功通知,会继续发送通知。
3.3.4订单核实接口【服务端调用】(选接)
- 验证接口地址为:https://mgame.360.cn/pay/order_verify.json
- 为了安全起见,验证参数不需要传client_id,client_secret参数,如果传了服务端会报错
- 需要计算签名
为了防止伪造的支付成功通知, 应用可以使用本接口做通知数据的校验.把支付结果通知接口(3.3.3节)收到的通知消息里的参数, 计算签名后调用接口, 即可校验数据是否正确.
接口地址:https://mgame.360.cn/pay/order_verify.json?参数
参数说明:
参数 |
必选 |
参数说明 |
app_key |
Y |
应用app key |
product_id |
Y |
应用自定义的商品id |
amount |
Y |
总价,单位:分 |
app_uid |
Y |
应用分配给用户的id |
order_id |
Y |
360支付订单号 |
app_order_id |
N |
应用订单号下单时若指定验证时也要指定 |
app_ext1 |
N |
应用扩展信息1 |
app_ext2 |
N |
应用扩展信息2 |
is_sms |
N |
是否短信支付 |
bank_code |
N |
支付方式 |
pay_ext |
N |
扩展信息 |
sign_type |
Y |
当前仅支持md5 |
sign_return |
Y |
应用传给订单核实接口的参数sign_return |
sign |
Y |
签名(计算方法参考附录4.1节,本表格中除sign以外的所有参数均参与签名) |
参数均来自应用加钱接口收到的支付通知消息, 原样提供即可。
如果参数提供正确, 订单核实接口返回为json格式数据.
验证成功返回
{"ret":"verified"}
验证不成功返回
{"ret":"{错误信息}"}
返回结果中的错误信息包括包括但不限于
错误信息 |
错误说明 |
order not exists |
订单不存在 |
product_id not match |
订单验证传入的product_id和下单时传入的product_id不一致 |
amount not match |
验证金额与下单时金额不一致 |
user_id not match |
验证360用户id和下单时360用户id不一致 |
bank_code not match |
验证支付方式和下单时支付方式不一致 |
3.4 销毁接口【客户端调用】(必接)
在应用主Activity中,使用Matrix的destroy方法
public static void destroy(Contextcontext)
在应用主Activity的onDestroy()函数中调用,以退出登录状态并释放资源。调用完该接口后,360SDK又回到未初始化状态。
参数:
context上下文
使用例子:
@Override
protected void onDestroy() {
super.onDestroy();
Matrix.destroy(this);
}
3.5 退出接口【客户端调用】(必接)
功能说明:
用户点击back及其他方式退出游戏时,需调用此接口。
接口示例及参数说明:
/**
* 使用360SDK的退出接口
*
* @param isLandScape 是否横屏显示支付界面
*/
protected void doSdkQuit(boolean isLandScape) {
Bundle bundle = new Bundle();
// 界面相关参数,360SDK界面是否以横屏显示。
bundle.putBoolean(ProtocolKeys.IS_SCREEN_ORIENTATION_LANDSCAPE, isLandScape);
// 可选参数,登录界面的背景图片路径,必须是本地图片路径
bundle.putString(ProtocolKeys.UI_BACKGROUND_PICTRUE, "");
// 必需参数,使用360SDK的退出模块。
bundle.putInt(ProtocolKeys.FUNCTION_CODE, ProtocolConfigs.FUNC_CODE_QUIT);
Intent intent = new Intent(this, ContainerActivity.class);
intent.putExtras(bundle);
Matrix.invokeActivity(this, intent, mQuitCallback);
}
callback的 json数据格式:
退出游戏
{"which": 2,"label": "退出游戏"}
返回按键/右上角X图标
{"which": 0,"label": "返回键/X关闭"}
callback示例:
// 退出的回调
private IDispatcherCallback mQuitCallback = new IDispatcherCallback() {
@Override
public void onFinished(String data) {
// TODO your job
}
};
3.6 游戏角色信息上传 (必接)
功能说明:
采集游戏内相关数据,用于等级礼包等深度运营功能,未接入或必传字段传值不满足要求将无法通过上线审核。
如果不接入、接入错误、没有严格按照文档调用时机调用接口,无法申请悬赏任务!请务必保证角色信息没有漏传现象!
该功能支持客户端调用及服务端调用两种方式,游戏任选其中一种接入即可。
接入3.6.1游戏角色信息上传接口【客户端调用】或3.6.2游戏角色信息上传接口【服务端调用】后,请务必调用3.6.3角色信息上传自测接口自测是否上传成功,并是否上传
3.6.1 游戏角色信息上传接口【客户端调用】
调用时机(以下四个时机均需调用,漏传不传将导致审核不通过!):
1、玩家进入游戏区服时调用该接口。
2、角色创建时调用该接口。
3、角色升级时调用该接口。
4、角色退出游戏时调用该接口。(包括用户退出游戏、用户注销角色帐号)
上传参数说明:
注:上传游戏包的时候,如果文档里面的必传参数,您们没传(例如角色性别、帮派等),需要说明一下“由于游戏确实没有xxx参数,所以角色信息接口中传了无或0” 。审核同学会亲自测试游戏,检测是否真的没有这些参数,请务必将游戏里有的必传参数上传。
大类 |
子类 |
字段说明 |
对应字段 |
是否必填 |
类型 |
传参说明 |
上传场景 |
上传角色数据场景 |
上传数据时角色状态更新 |
type |
必填 |
string |
数据可根据场景定义随时上传,以下场景必传:
enterServer(登录),levelUp(升级),createRole(创建角色),exitServer(退出) |
角色 |
所在区服 |
当前登录的游戏区服ID |
zoneid |
必填 |
Int |
不能为空,必须为数字,若无,传入“0” |
当前登录的游戏区服名称 |
zonename |
必填 |
string |
不能为空,区服名称,要求与游戏界面展示的服务器名保持一致,长度不超过50,不能为null,若无,传入“无” |
角色信息 |
当前登录的玩家角色ID |
roleid |
必填 |
BigInt |
角色ID,一个角色同一个服ID保持唯一,长度不超过50 |
当前登录的玩家角色名 |
rolename |
必填 |
string |
不能为空,角色昵称,长度不超过50,不能为null,若无,传入“无” |
角色职业 |
当前登录玩家的职业ID |
professionid |
必填 |
String |
不能为空,必须为数字,若无,传入“0” |
当前登录玩家的职业名称 |
profession |
必填 |
string |
不能为空,不能为null,若无,传入“无” |
角色性别 |
当前登录玩家的性别 |
gender |
必填 |
string |
不能为空,不能为null,可传入参数“男、女、无” |
角色职业称号 |
职业称号ID |
professionroleid |
选填 |
Int |
不能为空,不能为null,若无,传入 “0” |
职业称号 |
professionrolename |
选填 |
string |
不能为空,不能为null,若无,传入“无” |
角色等级 |
当前登录的玩家角色等级 |
rolelevel |
必填 |
Int |
不能为空,必须为数字,且不能为null,若无,传入“0”,如游戏存在转生,转职等,等级需累加,长度不超过10 |
战力值 |
数值 |
power |
必填 |
Int |
不能为空,必须为数字,不能为null,若无,传入 “0” |
VIP等级 |
当前用户VIP等级 |
vip |
必填 |
Int |
不能为空,必须为数字,若无,传入“0” |
帐号余额 |
货币ID(balanceid) |
balance |
必填 |
Int |
分组传递和“好友关系”方式相同。
指充值现金货币,即用现金直接购买的货币,不能为空,不能为null,若无,传入 “0”,货币ID的传参必须为数字
示例: [{“balanceid”:”1”,”balancename":"\u91d1\u5e01","balancenum":"600"},{"balanceid":"1","balancename":"\u91d1\u5e01","balancenum":"600"}] |
货币名称(balancename) |
必填 |
string |
货币数额(balancenum) |
必填 |
Int |
关系 |
所在帮派 |
当前用户所属帮派帮派ID |
partyid |
必填 |
Int |
不能为空,必须为数字,不能为null,若无,传入 “0” |
当前用户所属帮派名称 |
partyname |
必填 |
string |
不能为空,不能为null,若无,传入“无” |
帮派职称 |
帮派称号ID |
partyroleid |
必填 |
Int |
帮派会长/帮主必传1,其他可自定义,不能为空,不能为null,若无,传入 “0” |
帮派称号名称 |
partyrolename |
必填 |
string |
不能为空,不能为null,若无,传入“无” |
好友关系 |
关系角色ID(roleid) |
friendlist |
选填 |
BigInt |
传入用户的所有好友角色关系列表,不能为空,【角色ID亲密度关系ID 关系名】为一组传递多个好友传递多组。其中角色ID 亲密度关系ID必须为数字不能为空,不能为null。
若无好友则传入“无”
示例:
[{“roleid”:”1”,"intimacy":"0","nexusid":"600","nexusname":"情侣"},{"roleid":"2","intimacy":"0","nexusid":"200","nexusname":"仇人"}]
关系预定义字段:
以下对应方式为nexusid:nexusnam:
1:夫妻,2:结拜,3:情侣,4:师徒,5:仇人;其余关系从6开始自定义编号 |
亲密度(intimacy) |
选填 |
Int |
关系ID(nexusid) |
选填 |
Int |
关系名称(nexusname) |
选填 |
string |
其他 |
排行榜列表 |
榜单ID(listid) |
ranking |
选填 |
Int |
分组传递和“好友关系”方式相同。
不能为空,榜单ID必须为数字,不能为null,若无,传入“无”
示例:
[{“listid”:”1”,"listname":"\u91d1\u5e01","num":"600","coin":"XX","cost":"XX"},{"listid":"1","listname":"\u91d1\u5e01","num":"600","coin":"XX","cost":"XX"}] |
榜单名称(listname) |
选填 |
string |
传入角色当前排名(num) |
选填 |
Int |
排名指标ID (coin) |
选填 |
Int |
排名指标名称Value(cost) |
选填 |
string |
接口调用示例:
Matrix调用下面函数
/**
角色信息采集接口
*/
Protected void doSdkGetUserInfoByCP() {
//----------------------------模拟数据------------------------------
//帐号余额
JSONArray balancelist = new JSONArray();
JSONObject balance1 = new JSONObject();
JSONObject balance2 = new JSONObject();
//好友关系
JSONArray friendlist = new JSONArray();
JSONObject friend1 = new JSONObject();
JSONObject friend2 = new JSONObject();
//排行榜列表
JSONArray ranklist = new JSONArray();
JSONObject rank1 = new JSONObject();
JSONObject rank2 = new JSONObject();
try {
balance1.put("balanceid","1");
balance1.put("balancename","bname1");
balance1.put("balancenum","200");
balance2.put("balanceid","2");
balance2.put("balancename","bname2");
balance2.put("balancenum","300");
balancelist.put(balance1).put(balance2);
friend1.put("roleid","1");
friend1.put("intimacy","0");
friend1.put("nexusid","300");
friend1.put("nexusname","情侣");
friend2.put("roleid","2");
friend2.put("intimacy","0");
friend2.put("nexusid","600");
friend2.put("nexusname","情侣");
friendlist.put(friend1).put(friend2);
rank1.put("listid","1");
rank1.put("listname","listname1");
rank1.put("num","num1");
rank1.put("coin","coin1");
rank1.put("cost","cost1");
rank2.put("listid","2");
rank2.put("listname","listname2");
rank2.put("num","num2");
rank2.put("coin","coin2");
rank2.put("cost","cost2");
ranklist.put(rank1).put(rank2);
} catch (JSONException e) {
e.printStackTrace();
}
HashMap<String, String> eventParams=new HashMap<String, String>();
eventParams.put("type","enterServer"); //(必填)角色状态(enterServer(登录),levelUp(升级),createRole(创建角色),exitServer(退出))
eventParams.put("zoneid","2"); //(必填)游戏区服ID
eventParams.put("zonename","测试服"); //(必填)游戏区服名称
eventParams.put("roleid","123456"); //(必填)玩家角色ID
eventParams.put("rolename","冷雨夜风"); //(必填)玩家角色名
eventParams.put("professionid","1"); //(必填)职业ID
eventParams.put("profession","战士"); //(必填)职业名称
eventParams.put("gender","男"); //(必填)性别
eventParams.put("professionroleid","0"); //(选填)职业称号ID
eventParams.put("professionrolename","无"); //(选填)职业称号
eventParams.put("rolelevel","30"); //(必填)玩家角色等级
eventParams.put("power","120000"); //(必填)战力数值
eventParams.put("vip","5"); //(必填)当前用户VIP等级
eventParams.put("balance",balancelist.toString()); //(必填)帐号余额
eventParams.put("partyid","100"); //(必填)所属帮派帮派ID
eventParams.put("partyname","王者依旧"); //(必填)所属帮派名称
eventParams.put("partyroleid","1"); //(必填)帮派称号ID
eventParams.put("partyrolename","会长"); //(必填)帮派称号名称
eventParams.put("friendlist",friendlist.toString()); //(必填)好友关系
eventParams.put("ranking",ranklist.toString()); //(选填)排行榜列表
//参数eventParams相关的 key、value键值对相关具体使用说明,请参考文档。
//----------------------------模拟数据------------------------------
Matrix.statEventInfo(getApplicationContext(), eventParams);
}
3.6.2 游戏角色信息上传接口【服务端调用】
详情参见压缩包内的:角色信息上传接口【服务端调用】.zip
压缩包内仅为服务端php方法以及java方法demo,其他方式接入请自行开发
3.6.3 角色信息上传自测接口【有浏览器就能测】(必测!)
该页面供开发者测试使用,用于验证角色信息上传接口。
请务必接入并调用角色信息接口,并使用自测接口测试!游戏提审时,必须提供3个有角色数据的360账号,分别为刚创角、刚通过新手任务、超过20级3个账号。请务必确认提审的3个账号中有数据,且数据与游戏内真实数据完全一致,再上传游戏包。否则,审核人员将拒审游戏包,或审核不通过游戏包,将严重影响游戏上线发布!
- 能从接口查询到测试用户数据且各字段值符合3.6.1或3.6.2游戏角色信息上传接口要求,则接入成功;
- 能从接口查询到测试用户数据,则说明数据上传成功,请校验各角色信息字段值是否符合3.6.1或3.6.2游戏角色信息上传接口要求,若不符合请修改;
- 若不能从接口查询到测试用户数据,则说明数据上传失败,接入有误,请根据3.6.1或3.6.2游戏角色信息上传接口要求进行修改。
自测页面:http://guact.u.360.cn/roletool/so
3.7 游戏activity生命周期接口【客户端调用】(必接)
Matrix调用下面生命周期函数
接口示例:
//游戏Activity必接生命周期接口
public static void onStart(Activity activity)
//游戏Activity必接生命周期接口
public static void onResume(Activity activity)
//游戏Activity必接生命周期接口
public static void onPause(Activity activity)
//游戏Activity必接生命周期接口
public static void onStop(Activity activity)
//游戏Activity必接生命周期接口
public static void onReStart(Activity activity)
//游戏Activity必接生命周期接口
public static void onActivityResult (Activity activity,int requestCode, int resultCode, Intent data)
//游戏Activity必接生命周期接口
public static void onNewIntent (Activity activity,Intent intent)
3.8.1实名状态查询接口【客户端\服务端调用】(选接)
功能说明:
360sdk已包含实名注册功能及未成年防沉迷功能,在登录、支付流程中针对未实名用户展示实名认证窗口,并在实名成功后对未成年用户限制游戏时长和充值金额。同时,游戏可根据自身实际情况决定对游戏内不同实名状态用户的防沉迷逻辑进一步处理。
使用方法:请在初始化接口成功后再调用该查询接口,具体调用方法参见【3.1 初始化接口】
服务端接口示例:
https://mpay.mgame.360.cn/user/check_authentication.json?qids=xxxx&access_token=xxxx
客户端接口示例及参数说明:
/**
* 本方法中的callback实现仅用于测试, 实际使用由游戏开发者自己处理
*
* @param accessToken
* @param qihooUserId 奇虎360用户ID
*/
protected void doSdkAntiAddictionQuery(String accessToken, String qihooUserId) {
Bundle bundle = new Bundle();
// 必需参数,用户access token,要使用注意过期和刷新问题,最大64字符。
bundle.putString(ProtocolKeys.ACCESS_TOKEN, accessToken);
// 必需参数,360帐号id。
bundle.putString(ProtocolKeys.QIHOO_USER_ID, qihooUserId);
// 必需参数,使用360SDK的防沉迷查询模块。
bundle.putInt(ProtocolKeys.FUNCTION_CODE, ProtocolConfigs.FUNC_CODE_ANTI_ADDICTION_QUERY);
Intent intent = new Intent(this, ContainerActivity.class);
intent.putExtras(bundle);
Matrix.execute(this, intent, new IDispatcherCallback() {
@Override
public void onFinished(String data) {
}
}
}
callback的 json数据格式:
结果返回
{"ret":[{"qid":"199062142","status":"2"}]}
字段 |
说明 |
error_code |
0 查询成功其他值查询失败 |
error_msg |
错误消息 |
content |
json对象,包含ret数组 |
ret |
json对象的数组 |
qid |
奇虎UserId |
status |
0,此用户未进行实名注册;1,未成年;2,已成年。 |
callback示例:
new IDispatcherCallback() {
@Override
public void onFinished(String data) {
if (!TextUtils.isEmpty(data)) {
try {
JSONObject resultJson = new JSONObject(data);
int errorCode = resultJson.optInt("error_code");
if (errorCode == 0) {
JSONObject contentData = resultJson.getJSONObject("content");
if(contentData != null) {
// 保存登录成功的用户名及密码
JSONArray retData = contentData.getJSONArray("ret");
if(retData != null && retData.length() > 0) {
int status = retData.getJSONObject(0).optInt("status");
switch (status) {
case 0: // 查询结果:此用户未进行实名注册
Toast.makeText(SdkUserBaseActivity.this, getString(R.string.anti_addiction_query_result_0), Toast.LENGTH_LONG).show();
break;
case 1: // 查询结果:未成年
Toast.makeText(SdkUserBaseActivity.this, getString(R.string.anti_addiction_query_result_1), Toast.LENGTH_LONG).show();
break;
case 2: // 查询结果:已成年
Toast.makeText(SdkUserBaseActivity.this, getString(R.string.anti_addiction_query_result_2), Toast.LENGTH_LONG).show();
break;
default:
break;
}
return;
}
}
} else {
Toast.makeText(SdkUserBaseActivity.this, resultJson.optString("error_msg"), Toast.LENGTH_SHORT).show();
return;
}
} catch (JSONException e) {
e.printStackTrace();
}
Toast.makeText(SdkUserBaseActivity.this, getString(R.string.anti_addiction_query_exception), Toast.LENGTH_LONG).show();
}
}
}
3.8.2打开实名认证界面接口【客户端调用】(选接)
功能说明:
360sdk已包含实名状态注册功能,在登录、支付流程中针对未实名用户展示实名认证窗口,若游戏方有个性化定制实名认证窗口展示时机的需求,可自行在游戏中调用此接口。
注意:一定要先行调用实名状态查询接口,用户未实名才能调用此接口!已实名用户请使用其他逻辑处理!
接口示例及参数说明:
/**
* 使用360SDK实名注册接口
*
* @param isLandScape 是否横屏显示登录界面
* @param qihooUserId 奇虎360用户ID
*/
protected void doOpenSdkRealName(QihooUserInfo usrinfo, boolean isLandScape) {
if (!checkLoginInfo(usrinfo)) {
return;
}
Intent intent = getRealNameRegisterIntent(isLandScape, (usrinfo != null) ? usrinfo.getId() : null);
Matrix.invokeActivity(this, intent, new IDispatcherCallback() {
@Override
public void onFinished(String data) {
//具体见返回值说明
}
});
}
private Intent getRealNameRegisterIntent(boolean isLandScape, String qihooUserId) {
Bundle bundle = new Bundle();
// 界面相关参数,360SDK界面是否以横屏显示。
bundle.putBoolean(ProtocolKeys.IS_SCREEN_ORIENTATION_LANDSCAPE, isLandScape);
// 必需参数,360账号id,整数。
bundle.putString(ProtocolKeys.QIHOO_USER_ID, qihooUserId);
// 可选参数,登录界面的背景图片路径,必须是本地图片路径
bundle.putString(ProtocolKeys.UI_BACKGROUND_PICTRUE, "");
// 必需参数,使用360SDK的实名注册模块。
bundle.putInt(ProtocolKeys.FUNCTION_CODE, ProtocolConfigs.FUNC_CODE_REAL_NAME_REGISTER);
Intent intent = new Intent(this, ContainerActivity.class);
intent.putExtras(bundle);
return intent;
}
实名制提交接口返回结果说明(从720版本开始数据格式为以下):
从720版本开始数据格式为以下格式,如果error_code不为0,或者content没有实名数据,则可以认为实名制页面关闭或者异常。该结果仅供参考,如果游戏接入方需要准确结果建议提交实名制后再次调用3.8.1查询接口
{
"error_code": "0",
"error_msg": "请求成功",
"content": {
"ret": [{
"qid": "xxxxxx",
"status": "2"//0是未知,1是未成年,2是成年
}]
}
}
3.8.3分享接口【客户端调用】(选接)
功能说明:
分享接口,支持分享链接或图片形式内容,支持5种分享方式:微信好友、微信朋友圈、QQ好友、QQ空间、复制链接。
调用此接口可在游戏内调起分享聚合界面,或直接调起指定一种分享方式。
接口示例及参数说明:
参数说明:
1、ProtocolKeys.SHARE_TYPE:分享类型(必须参数),其值如下:
ProtocolKeys.SHARE_DEFAULT_STRING//分享方式聚合页
ProtocolKeys.SHARE_2_WX_FRIENDS//微信好友
ProtocolKeys.SHARE_2_WX_TIMELINE//微信朋友圈
ProtocolKeys.SHARE_2_QQ_FRIENDS//QQ好友
ProtocolKeys.SHARE_2_QQ_SPACE//QQ空间
ProtocolKeys.SHARE_2_CLIP_BOARD//复制链接
2、ProtocolKeys.SHARE_METHOD :分享方式(必须参数),其值如下:
ProtocolConfigs.SHARE_TYPE_URL: 链接分享
ProtocolConfigs.SHARE_TYPE_IMG:网络图片分享
ProtocolConfigs.SHARE_TYPE_LOCAL_IMG:本地图片分享
3、ProtocolKeys.FUNCTION_CODE:标识通知SDK要执行的功能(必须参数),其值如下:
ProtocolKeys.share_title :分享的标题,若分享方式为链接分享,此参数为必选参数
ProtocolKeys.share_desc :分享的描述,若分享方式为链接分享,此参数为必选参数
ProtocolKeys.share_icon :分享的icon链接,若分享方式为链接分享,此参数为必选参数
ProtocolKeys.share_url :分享的URL链接,若分享方式为链接分享,此参数为必选参数
ProtocolKeys.share_pic:分享的图片链接,若分享方式为图片分享,此参数为必选参数
链接分享方式:
Intent intent = new Intent();
intent.putExtra(ProtocolKeys.FUNCTION_CODE, ProtocolConfigs.FUNC_CODE_SHARE);
intent.putExtra(ProtocolKeys.SHARE_TYPE, shareType);
intent.putExtra(ProtocolKeys.SHARE_METHOD, ProtocolConfigs.SHARE_TYPE_URL);
intent.putExtra(ProtocolKeys.SHARE_TITLE, title);
intent.putExtra(ProtocolKeys.SHARE_DESC, desc);
intent.putExtra(ProtocolKeys.SHARE_ICON, icon);
intent.putExtra(ProtocolKeys.SHARE_URL, url);
网络图片分享方式:
Intent intent = new Intent();
intent.putExtra(ProtocolKeys.FUNCTION_CODE, ProtocolConfigs.FUNC_CODE_SHARE);
intent.putExtra(ProtocolKeys.SHARE_TYPE, shareType);
intent.putExtra(ProtocolKeys.SHARE_METHOD, ProtocolConfigs.SHARE_TYPE_IMG);
intent.putExtra(ProtocolKeys.SHARE_PIC, pic);
本地图片分享方式:
Intent intent = new Intent();
intent.putExtra(ProtocolKeys.FUNCTION_CODE, ProtocolConfigs.FUNC_CODE_SHARE);
intent.putExtra(ProtocolKeys.SHARE_TYPE, shareType);
intent.putExtra(ProtocolKeys.SHARE_METHOD, ProtocolConfigs.SHARE_TYPE_LOCAL_IMG);
intent.putExtra(ProtocolKeys.SHARE_PIC, pic);
//最后调用:
Matrix.invokeActivity(context,intent,new IDispatcherCallback() {
@Override
public void onFinished (String data){
if (null == data) {
return;
}
Toast.makeText((context, data, Toast.LENGTH_SHORT).show();
}
});
callback的 json数据格式:
分享成功
{"errno":1,"share_way":"weixin_friends","errmsg":"shared","shared":true}
分享失败
{"errno":-1,"share_way":"weixin_friends","errmsg":"failed","shared":false}
errno: 1 分享成功;-1 分享失败;-2 取消分享; 0未收到第三方分享结果,建议视为成功处理
3.8.4打开论坛接口【客户端调用】(选接)
功能说明:
打开论坛接口,调用此接口可直接在游戏内调起webview页面,展示游戏专属论坛(若游戏暂未开通论坛,则默认展示论坛首页),为游戏用户提供分享、吐槽的地方,提高游戏用户的粘性。
接口示例及参数说明:
/**
* 使用360SDK的论坛接口
*
* @param isLandScape 是否横屏显示支付界面
*/
protected void doSdkBBS(boolean isLandScape) {
Bundle bundle = new Bundle();
// 界面相关参数,360SDK界面是否以横屏显示。
bundle.putBoolean(ProtocolKeys.IS_SCREEN_ORIENTATION_LANDSCAPE, isLandScape);
// 必需参数,使用360SDK的论坛模块。
bundle.putInt(ProtocolKeys.FUNCTION_CODE, ProtocolConfigs.FUNC_CODE_BBS);
Intent intent = new Intent(this, ContainerActivity.class);
intent.putExtras(bundle);
Matrix.invokeActivity(this, intent, null);
}
3.8.5打开客服接口【客户端调用】(选接)
功能说明:
打开客服接口,调用此接口可直接在游戏内调起webview页面,展示游戏客服界面,为游戏用户提供快捷的问题反馈通道。
接口示例及参数说明:
/***
* 调用360SDK客服接口
*
* @param isLandScape是否横屏显示支付界面
* @return Intent
*/
private void openKefu(boolean isLandScape) {
Bundle bundle = new Bundle();
// 界面相关参数,360SDK界面是否以横屏显示。
bundle.putBoolean(ProtocolKeys.IS_SCREEN_ORIENTATION_LANDSCAPE, isLandScape);
// 必需参数,使用360SDK的客服模块。
bundle.putInt(ProtocolKeys.FUNCTION_CODE, ProtocolConfigs.FUNC_CODE_KEFU);
Intent intent = new Intent(this, ContainerActivity.class);
intent.putExtras(bundle);
Matrix.invokeActivity(this, intent, null);;
}
3.8.6使用Matrix的get方法,获取基本信息【客户端调用】(选接)
参数:
context上下文
// 获取AndroidManifest.xml中的meta-data QHOPENSDK_APPID
public staticString getAppId(Context context)
// 获取AndroidManifest.xml中的meta-data QHOPENSDK_APPKEY
public staticString getAppKey(Context context)
// 获取AndroidManifest.xml中的meta-data QHOPENSDK_PRIVATEKEY
public staticString getPrivateKey(Context context)
// 获取sdk的VersionName
public staticString getVersionName(Context context)
3.8.7游戏退出时设置杀死应用进程标志位【客户端调用】(选接)
功能说明:
游戏CP设置退出游戏时是否会杀死应用进程标志
接口示例及参数说明:
参数值:如果传入false:表示SDK内部将在退出游戏时杀死应用进程,则游戏无需手动杀死进程。
如果传入true:表示游戏退出时自己会杀死应用进程,则SDK内部不做任何处理。
默认值是false。
/**
* 提供给游戏CP设置退出游戏时是否会退出应用进程标志
* @param isKillApp
* @return
*/
publicstatic void setKillAppTag(boolean isKillApp)
3.8.8初始化前修改浮球默认位置【客户端调用】(选接)
功能说明:
游戏CP在调用初始化接口前可设置悬浮球默认悬停的位置,一共有四个位置:左上(值为:1)、左下(值为:2)、右上(值为:3)、右下(值为:4),如果此时用户已有操作浮球位置记录,则以用户记录为准。
接口示例及参数说明:
参数值:左上(值为:1)、左下(值为:2)、右上(值为:3)、右下(值为:4)。默认值是0和1效果一致,显示在左上角位置。
/**
* 设置悬浮球默认悬停的位置
* @param position :左上(值为:1)、左下(值为:2)、右上(值为:3)、右下(值为:4)
*可以使用下面的常量:
* public static final int FLOAT_WND_POSITION_LEFT_TOP = 1;
* public static final int FLOAT_WND_POSITION_LEFT_BOTTOM = 2;
* public static final int FLOAT_WND_POSITION_RIGHT_TOP = 3;
* public static final int FLOAT_WND_POSITION_RIGHT_BOTTOM = 4;
**/
Matrix.setFloatWindowPosition(int position);
3.8.9打开浮球里的浮窗【客户端调用】(选接)
功能说明:
游戏CP可调用该方法打开浮球里的浮窗内容,注意该方法不要跟登录同时调用。
接口示例及参数说明:
参数值:传入Activity,与初始化方法中的activity保持一致。
/**
* 打开插件中悬浮球内容
* @param 跟setActivity中的Activity保持一致
* 适用于悬浮球被隐藏时接入方主动调起浮球内容,浮球未被隐藏时也可以使用
**/
Matrix.openFloatWindow(Activity activity)
3.8.10自定义是否展示360隐私协议弹框以及其内容(选接)
在assets下添加一个文件名为privacy_style.json的文本文件,内容如下:
{
"privacy_hide":"0",
"privacy_title": "用户协议和隐私政策",
"privacy_desc": "请认真阅读《用户协议》和《隐私政策》的全部内容。\n点击“同意”即表示您已阅读并同意全部条款。\n若您不同意本条款相关内容,很遗憾我们将无法为您继续提供服务。\n 我们将可能申请并使用以下权限:\n ·存储权限(日志文件内容缓存和文件内容下载管理)\n ·电话权限(适配设备和支付安全使用)",
"content": [{
"privacy_url": "http://sqhd.u.360.cn/prod_use_agreement.html",
"privacy_title": "《用户协议》"
},
{
"privacy_url": "http://sqhd.u.360.cn/ue_plan.html",
"privacy_title": "《隐私政策》"
}
]
}
其中,privacy_hide 为1表示关闭360隐私协议弹窗,0表示打开。详细文档请见:
https://easydoc.soft.360.cn/doc?project=2c42fb457343dd30ef727135425573aa&doc=b40020aac65eee78ebee22c813b50cb8&config=title
签名算法不区分前后端,只要在需要签名的地方,均采用如下的算法
- 必选参数必须有值, 而且参数值必须不为空,不为0. 字符集为utf-8
- 所有不为空,不为0的参数都需要加入签名,参数必须为做urlencode之前的原始数值. 如中文金币, 作为参数传输时编码为%E9%87%91%E5%B8%81, 做签名时则要用其原始中文值金币(注意字符集必须是UTF-8)
- 对所有不为空的参数按照参数名字母升序排列(如php的ksort函数)
- 使用符号#拼装排序后的参数值, 最后用#连接应用的app_secret,整体用md5计算签名, 就是sign参数的值. 注意有些语言的md5计算结果里字母为大写, 需要转化为小写.
- 拼装url进行WEB传递, 这时参数值要做urlencode
php范例如下:
// 准备签名参数
$input = array(…);
/* 去掉为空的字段 */
foreach($input as $k=>$v)
{
if(empty($v)){
unset($input[$k]);
}
}
ksort($input);//对参数按照key进行排序
$sign_str = implode('#',$input);//第四步
$sign_str = $sign_str.'#'.$sign_key;//拼装密钥(如果是签名,密钥为约定处理后的密钥)
$sign = md5($sign_str);
$input['sign'] = $sign;//得到签名
/* 第五步得到url传递即可*/
//这里地址就是一个演示的接口地址
$url = 'http://testapp.com/notify?'.http_build_query($input);
…
Demo工程主要的包和类介绍:
com.qihoo.gamecenter.sdk.demosp.activity下的类演示SDK各个接口的调用。游戏接入SDK联调时,请着重参考类:SdkUserBaseActivity:
LandscapeSdkUserActivity.java横屏状态下演示SDK各个接口的调用
PortraitSdkUserActivity.java竖屏状态下掩饰SDK各个接口的调用
SdkUserBaseActivity.java 是LandscapeSdkUserActivity和PortraitSdkUserActivity的基类,是SDK各个接口的调用实现.
com.qihoo.gamecenter.sdk.demosp.payment下是支付相关的基本数据结构和常量。
QihooPayInfo.java , 请求360SDK支付接口时的参数信息类。
com.qihoo.gamecenter.sdk.demosp.utils,demo里面定义的一些工具类。
QihooUserInfo,360用户信息数据。
Utils.java, 一些工具函数。
4.3 服务端SDK参考程序
应用在接入360平台时,需要在应用服务端搭建用户授权接口和支付回调接口。具体参考程序可以从http://dev.360.cn/wiki/index/id/73下载。
接入相关问题可以先参SDK_DOC.zip里面的『常见问题』文档,仍不能解决时,请联系下方人员。
接入中遇到问题请先查看“常见问题”文档并用自检工具自检,自检通过后依然查不出问题请联系对接运营协调处理。
平台加固相关问题请加Q群
360加固保客服:198501978