分享到 :

SDK游戏应用接入F&Q文档

一:申请QQ登陆相关问题

1:申请QQ登录需不需要审核?申请处理的时间一般为多长?
A:需要通过审核。创建应用后便可以立即获取QQ登录相关的appkey和appid。审核过程大约5个工作日,未审核通过的 appid只能使用注册的QQ号码进行测试登录,审核通过的可以全量使用。

2:申请QQ登录时提示“网站域名验证失败”?
A:验证失败可能由于以下原因导致:
①验证代码未添加成功,请查看验证代码是否已成功添加到网站的HEAD标签中。
②添加的验证代码与当前登录QQ号不匹配,不同QQ号进行验证时生成的验证码不同,请确认当前进行验证的QQ号生成的验证码与添加到网页源代码里的相同。

3:同一个开发者帐号的android/iOS应用创建appid不一致?
A:进入腾讯开放平台官网:http://open.qq.com/ 点击管理中心,找到您的android/iOS应用点击进去,点击右上角的平台信  息,点击平台信息创建相关的iOS/android应用,应用名称和 appid即为一致的。

4:如何添加应用调试者帐号?
A:进入腾讯开放平台官网:http://open.qq.com/ 点击管理中心,找到您的android应用点击进去,点击下面的QQ登录图标,在添加调试者下面添加您需要测试的QQ号(必须为开发者帐号的QQ好友帐号)。

5:与其它网站的登录接入是否有冲突?
A:QQ登录使用国际通用的的OAuth2.0协议进行验证与授权,第三方网站访问腾讯的用户信息时,使用的是腾讯公司为网 站分配的access token,因此第三方网站与其它网站的登录接入并不受影响。

6:没开空间的QQ号码登录的时候不能自动跳转到网站?有别的解决方案吗?
A:目前只能建议用户开通QQ空间。后续腾讯会优化这里的体验,非开通用户也能够正常使用QQ登录来登录网站。

7:为什么用户用QQ帐号登录部分网站不能一键登录,还需要再输入用户名和邮箱?
A:这个与网站自身逻辑有关。一般来说用户第一次使用QQ帐号登录网站时,网站需要用户输入用户名和密码来实现QQ  帐号和网站自身帐号的绑定。

8:登录分享图标不正确如何处理?
A:请您确认以下两点信息:
(1)确定用户应用代码中的appid是否配置正确(应用图标是根据appid来拉取后台的图标数据的);
(2)确定用户本地QQ缓存是否清理(QQ客户端会存储图标缓存,并不是实时拉取,更换手机设备或清除QQ缓存测试一下)。

9:用户是否可以解除网站使用QQ登录的绑定?
A:用户可在QQ空间中的个人设置选项“授权管理”中管理与第三方网站的连接。建议第三方在自己的网站中设置同样的 授权管理功能。

10;通过使用QQ登录第三方能获取QQ用户什么样的信息?
A:1:网站可以通过用户资料接口获取用户的空间昵称和头像,来丰富用户注册资料;
2:已登录用户可以将在网站上发布、分享  的信息即时同步到QQ空间;
3:此外,还可以通过说说、相册、日志等开放接口使用户直接在网站上访问或修改他们在QQ空间上的数据,与QQ空间实现更以进一步的互联互通。

11:通过使用QQ登录能否获取用户的QQ号码?
A: 不能。用户登录成功后跳转回网站时,URL中传递的是openid      而非QQ帐号,openid是经过转换的字符串。此外,QQ帐     号涉及用户隐私,接入QQ登录的网站应该遵守开发者协议,  不允许以任何理由获取和用户QQ帐号相关的信息。

12:基于phpwind的网站能否使用QQ登录?
A:QQ登录团队已提供全面支持Discuz!,PHPWind等平台的集   成插件,即将支持CMS,shopEX等平台。请选择适合您网站    的插件包下载安装。

13:网站允许使用QQ登录后是否会暴露本网站的隐私数据?
A:网站可通过用户的授权向QQ空间推送用户的动态更新,以及其它优质内容或定向广告,腾讯方面不主动拉取第三方网 站的任何数据内容。

14:用户的登录信息存放在腾讯服务器还是本网站的服务器?
A:为了保证用户QQ号码的安全,其登录信息放在腾讯服务器上。

15:网站使用QQ登录时,需要实现哪些接口?腾讯提供了哪些OpenAPI?
A:需要实现两种接口:

  1. OAuth登录相关接口,用来获取用户的access token和openid,详见OAuth2.0开发文档
  2. OpenAPI,用来访问和修改Qzone受保护的资源,详见API列表

二:access token、openAPI、appKEY、appID相关问题

1:为什么有的OpenAPI必须申请才能使用?如何申请?处理时间多长?
A:出于信息安全的考虑,部分OpenAPI仅对可信赖的合作网站开放。需要申请的接口,我们在API列表中进行了标注。
* * 申请方式、处理时间及审核标准详见:OpenAPI权限申请

2:我们的appID 和appKEY 和支付时要用到的的参数使用那些? 需要重新申请吗?
A:原来申请过钱包业务的,继续沿用之前的appID和appKEY即可,若未申请过互联或开平业务,则需重新申请appID和    appKEY。

3:查询帮会绑定接口checkBindGroup,能通过角色id,区服id和帮会id能查到Q群号码,是否openid也能通过角色id和区服id查询到?
A:第三方应用需要记录用户信息的,需要增加存储下第三方登录的信息、存储角色id及区服id。

4:游戏SDK内加好友的接口,现在想用这个接口加好友,但是需要知道对方openid才能加。现在我想问的是 怎么获取对方的openid?
A:目前流程应该是这样的:
1、用户通过第三方APP跳转手机QQ登录,返回openID和token,第三方APP在后台记录用户ID和openID、昵称、头像等信息;
2、用户通过第三方APP加手Q好友,第三方APP需要通过后台查询好友对应的openID,然后通过手机QQ完成加好友;在好友登录搜权的时候,肯定要你们存一下openId的,然后显示出这些人给要加好友的人去选。

5:手Q有一个appkey,而支付之前只有gameBindGroup 绑群API要求传了,这个appkey是要求放在客户端还是服务端存储的?
A:这个是游戏客户端自行存储的。

6:access token有效期为多久?
A:access token有效期为90天。

7:如果用户删除了对网站的授权(即access_token失效)怎么办?
A:如果用户删除了对网站的授权,则下次用户再次使用QQ登录时,需要重新进行授权操作。
在代码实现中,即表示access_token失效,需要重新获取access_token
网站获取到的access_token有效期为90天,和某一个openid对应。此外,用户也有权限在Qzone这边删除对第三方的授权,此时该access_token会失效,需要重新走整个流程让用户授权。

三、具体功能问题

1:客户端的登录,服务端需要进行登录校验么?
A:能获取到用户信息证明登录成功,不需校验登录态。

2:获取用户信息接口(get_simple_userinfo)不稳定怎么办?
A:此接口不是归属互联管理,不稳定,可使用is_login接口测试登录态,参考文档

3:游戏客户端登录成功后,再给游戏服务器发登录成功的通知,我想问下,游戏服务器是否有验证用户登录态的接口?
A:我们这边的接口都是调用即验证,没有提供单独的验证cgi。

4:是否一定要设计游客模式?
A:一般android的游客登录是厂商自己研发的,可以有可以没有;ios的游客登录是appstore必须要求的,我们后续会考虑把这块也封装在sdk中,不过目前没有。

5:如果mTencent.isSessionValid()返回true的情况下,我调用login,是不是不会拉起qq,而是直接有登录成功的回调?
A:调用login会拉起手Q的授权登录页面的。

6:如果已经登录成功了,然后关掉游戏,再运行游戏,此时最好能直接获得登录态,游戏不显示登录界面。这种情况下游戏侧如何知道已经有有效的登录态了?
A:这个opensdk目前没有像msdk存token。游戏侧也可以自己存。

7:游戏里点击其他玩家弹出菜单里显示的“添加QQ好友”按钮,需不需要在添加QQ好友成功后隐藏?如果需要,SDK貌似没有提供查询QQ好友相关的接口;添加QQ好友的接口又没有是否添加成功的回调,所以游戏这边不太好确定对方是否是自己的QQ好友
A:需要,SDK内暂缺相关功能。

8:若用户A创建群B后,进行公会绑定群操作,绑定成功后,解散群B,此时查询公会绑定状态仍然是已绑定状态,只有当进行加群操作,并点击加入时,提示该公会未绑定群,此时查询公会绑定状态才会变成未绑定。这个逻辑是正确的吗?
A:目前逻辑是一致的。

9:支付过程中跳转到支付页面黑屏大概会是什么原因呢?
A:1.appkey配置错误;
2.加密的时候,末尾没加 &;
3.安卓侧SHA1指纹配置错误。

10:接口调用量一般是多少?
A:卡牌游戏一般100左右即可。系统默认的是200次/分钟,如果不够可以后期扩容。

11:应用提示非应用宝官方应用应如何解决?

A:出现该提示是因为登录时,后台会校验互联官网的包名及签名信息是否和应用一致,如果出现100044的报错,前往http://connect.qq.com修改应用的包名和签名信息即可。

12:手Q游戏的包名确认没有命名规范吗?
A:没有,可自定义包名。

13:安卓应用的指纹签名应该如何填写?

A:SHA1换包后会变更,每次换包后都需及时更新SHA1指纹信息,获取指纹信息可参考附件文档。

14:发帖时点击“一键登录”提示手Q版本过低是什么问题?
A:网页不支持一键登录,只支持帐号、密码登陆。

15:添加第三方地址卡死问题。

A:平台上校验域名的规则很复杂,可尝试换填APP介绍的那个页面的网址(就是有下载链接的那个页面)

16:下载安装包内有渠道号吗?
A:腾讯的安装包是有内部渠道号的,但这个渠道号是对内的,外部应用使用安装包时可等同于无渠道号进行数据分析。

17:支持QQ登录的手Q最低版可本为?
A:手Q4.0版本

18:接入最新的SDK功能要求的手Q最低版本为?
A:手Q7.20版本

19:使用QQ钱包支付,返回错误码-7000,这是什么原因?
A:在程序中使用的bundle id都需要提前到qpay.qq.com上进行配置

20:在ios上绑定一个公会群后,再在安卓系统上用同一个公会进行绑群,可以成功么?
A:不会成功。请尽量避免在不同系统上绑定同一个工会群。

21:IOS处理分享回调的接口代码中,未找到取消分享的状态定义?
A:处理返回结果时可取出result的值,值为-4则是取消分享。

22:在6P和6SP的机器上,测试图片分享到QQ功能,若图片为拍照获得,会提示参数错误?
A:分享图片时,注意图片文件大小不能超过5M

23:使用QQ钱包支付完毕后不返回商户而直接返回游戏客户端,手Q终端无回调过程
A:目前产品逻辑为,支付完毕后点击返回按钮才有回调过程

24:QQ登录token失效有方法判断么?

A:用TencentOAuth 对象来调用这个方法, 第一次授权登录后要保存下token,expirationdate, 下次初始化TencentOAuth的时候要把这些值再赋值给对应的实例。

25:返回码说明
A:详见:公共返回码说明

26:签名参数总是生成错误,怎么测试是否正确?
A:详见:签名参数oauth_signature的说明,根据步骤来检查哪一步生成错误。
此外,上述文档中也给出了测试签名生成是否正确的推荐测试地址。

27:获取到的QQ昵称写入数据库后变成乱码,怎么解决?
A:我们返回的昵称格式是U8的,网站拿到之后可以按照需要自己转码。

28:如果我服务器系统是英文语言,生成时间戳是否会有影响?
A:理论上不会。请将你的服务器时间设置为北京时间,与腾讯服务器时间戳相差不要超过5分钟。

29:为什么直接取session值可以取到,但跳转到QQ登录授权页面再跳转回网站时,就取不到了呢?
A:这是子域名不能共享session的问题导致。解决方案详见:关于session的使用限制以及解决方案的说明

返回顶部