更新时间:2017-6-19

SDK初始化


初始化时序图

typeSDK流程_初始化.png

注意事项

  1. 虽然初始化过程速度很快,但原则上游戏客户端在接收到初始化完成回调前不可进行后续流程,但因为不存在初始化失败回调,游戏应该在初始化后20-30后未接收到完成回调,应该提示用户重启游戏。
  2. 原则上初始化操作应该在应用启动后立即执行。

登录


登录时序图

typeSDK流程_登录.png

注意事项

  1. 用户登录的渠道窗口应该再进入登录流程后自动弹出。
  2. 用户登录的渠道窗口可能被关闭,或验证结果失败。所以需要游戏在登录界面设置一个登录按钮,以手动再次调出登录窗口。
  3. 客户端登录成功后,客户端将显示浮标。
  4. 客户端登录成功后,客户端回调应渠道差异关系可能不会包含user_id。不能用以进行游戏登录逻辑。需通过服务点验证接口获取可靠user_id。
  5. 请客户端务必要求服务端将会话验证结果中的user_id、token(如果不为空字符传)传回,并使用UpdatePlayerInfo方法提交。否则不份渠道将无法进行支付。
  6. 建议在登录完成后再进行选服逻辑。
  7. 最终返回的user_id是渠道提供的用户唯一编号,可能多渠道混服情况下会出现user_id相同,需要使用channel_id、user_id同时使用来确定用户唯一ID。

支付


支付时序图

typeSDK流程_支付.png

注意事项

  1. 客户端支付回调仅用以处理界面逻辑,如刷新用户余额等。最总支付成功信息以服务端为准。
  2. 游戏服务器SaveOrder提交订单信息时,需要包含自身的支付成功回调地址和订单信息查询地址。
  3. 因渠道原因同一个支付成功通知可能发送多次,游戏服务器需要判断是否重复,如果重复则必须返回发货成功,不进行实际发货。
  4. 需要将聚合服务器支付回调地址填写至渠道后台才能成功接收到渠道回调。
  5. 部分渠道下单需要提供渠给出的道商品ID,该映射ID操作由聚合服务器完成,这些渠道需要在打包工具配置渠道商品ID表。其他大部分渠道只使用金额,不关心商品,无需在打包工具后台配置商品ID。
  6. 部分渠道需要在服务端进行订单签名,支付签名密钥禁止保存于客户端内。
  7. 聚合SDK以分为金额单位,建议游戏也使用分为单位支付,海外苹果支付存在类似0.99美元支付金额。

切换账号、退出账号登录


注意事项

  1. 渠道SDK已经在自身界面集结成了切换账号或登出按钮。游戏只需监听TypeEventType.EVENT_RELOGIN和TypeEventType.EVENT_LOGOUT并做出相响应。
  2. 渠道SDK管理用户注册、登录、退出、切换账号,游戏管理用户选服、建角。强烈建议不要在游戏内设置按钮进行切换账号或退出当前账号等想要操控渠道SDK行为的操作。并非所有渠道SDK都开放切换账号、退出登录调用。
  3. 虽然TypeSDK提供了Logout方法,但同上所述。只有在您确定所发布渠道都支持Logout方法后才能使用。

退出游戏


退出流程图

TypeSDK退出应用流程vsd.png