MSDK免流服务
MSDK免流 / 说明 /

免流[定向流量]服务

介绍

国内手游一般会部署三套TGW环境：正式TGW（上海） + 灾备TGW（深圳）+ 海外TGW（香港）。
免流（或称定向流量）TGW 集群独立于上述三套TGW环境，提供上海城市的 “ 电信 + 移动 + 联通 ” 运营商，
共32组VIP并共享16G带宽（数据截止于2017/09/04），为IEG所有手游业务提供服务。
在资源有限的情况下，我们推荐各个业务可以共用VIP组，保证资源得到充分的利用。

游戏接入流程（推荐）

示意图：


接入步骤：

  1. 游戏申请接入免流；（联系MSDK产品接口人，或者在飞鹰系统dev.ied.com/MSDK接入管理/特殊权限申请/定向流量 自助发邮件）
  2. MSDK运维会申请一批免流的ip，然后给到MSDK的后台和游戏运维；（联系运维接口人）
  3. 游戏开发人员和通彩联调服务申请页（内嵌到游戏的H5）（联系通彩接入接口人）
  4. 游戏开发人员和MSDK联调玩家免流身份判断接口；（联系接口联调技术接口人）

上述联系人如不清楚可联系MSDK助手对接

线上流程说明

示意图：


流程说明

  1. 玩家登录游戏时候，将个人信息发到游戏后台配置服务器；
  2. 游戏后台拿到客户端数据后请求msdk服务端接口；
  3. msdk接口判断这个玩家是否免流用户，并返回游戏server（包括VIP信息）
  4. 游戏服务端根据玩家是否免流用户，将对应的VIP发给客户端；
  5. 游戏客户端根据VIP访问公司TGW；
  6. TGW转发请求到游戏服务器（RS）；

注意事项

  1. 建议业务专门为定向流量功能专门申请一套域名，作为配置服务器（如图的游戏配置服务），用于在访问游戏主逻辑前作免流用户判断；
  2. 一般游戏配置服务器会保存游戏VIP,流程第三步MSDK接口会返回VIP，这里建议以游戏配置为主；
  3. 建议业务对定向流量功能设置有开关，避免在定向流量TGW有故障无法快速恢复时影响定向流量正常的游戏体验。

服务端接口

免流查询接口

免流的FAQ

  1. 问：使用网络与购买的网络不一样情况，例如：如果当前玩家是电信网络，然后购买的移动免流套餐，那么此时ip应该如何选择？
    答：使用游戏客户端的出口网络与购买的网络不一样的情况，那么是不会免流，面对这种情况，电信，移动和联通是有不同的策略，可能是踢掉用户，可能是扣费用户流量。

  2. 问：tgw上的ip是跨运营商的，那么免流ip是不是跨运营商？
    答：由于运营商策略问题，目前免流ip是独立于每个运营商，不过我们平台正在沟通，争取三网免流使用同一个ip。

  3. 问：是否分配完定向流量VIP组后，就不需要我再到TGW平台上申请规则了？ 答：否！分配完定向流量VIP组后，需要业务运维按照分配至TGW平台上申请对应的TGW规则，定向流量运维接口人不会代为申请规则。如业务TGW规则较多（已有正式TGW）可联系TGW运维对业务规则进行“规则复制”操作。

  4. 问：我已经申请好了定向流量TGW规则了，是否只需要在原有的域名上加上定向流量VIP解析就好了？ 答：否。如果业务采用域名方式进行访问服务，则建议为定向流量专门申请对应的域名，避免非定向流量用户访问到定向流量TGW集群，影响集群上的业务。如果业务采用的是IP方式进行访问，需要业务对应的做出改造。
  5. 问：因为业务特性，我们希望申请独占一个或多个定向流量VIP组，是否可行？ 答：不推荐该方式。因为定向流量VIP资源有限，所以不承诺为业务进行独占VIP的操作，同时也希望业务合理申请并使用资源，避免资源浪费。

  6. 问：业务在什么时期接入定向流量功能比较合适？ 答：推荐业务在PR2测试前开始接入，定向流量项目会在业务不删档前分配测试VIP及端口用于业务的调通。在业务不删档环境部署前再次进行正式定向流量VIP组的分配，保证业务稳定上线。对于已经上线的业务，需要业务运维与定向流量运维接口人进行沟通以便于资源的分配。

  7. 问：后台接口返回中ipList，ltList，dxList和ydList的格式和作用？
    答：ipList的作用是返回该游戏的所有腾讯侧的免流ip和port，该游戏可以通过接入这些ip进行免流（其实游戏在接入腾讯免流功能时，
    腾讯的运维已经将游戏区服的ip：port（tgw的ip和port）都给到了游戏），
    同时游戏可以通过这些ip进行校验，当前下发的ip是否在游戏内配置一样，如果不一样，使用共同存在的ip列表；
    ltList是联通的免流ip：port，开通联通套餐的用户可以通过接入该ip到游戏服务器进行免流；
    dxList是电信的免流ip：port，开通电信套餐的用户可以通过接入该ip到游戏服务器进行免流；
    ydList是移动的免流ip：port，开通移动套餐的用户可以通过接入该ip到游戏服务器进行免流；
    格式：101.226.xxx.xxx:2001;101.226.xxx.xxx:2002;
    IP:port分号（;）分隔但是面对其他的游戏的需求也支持端口连续的列表，
    101.226.xxx.xxx:2001-2010;101.226.xxx.xxx:2022-2042;

  8. 问：接口中ccType和expire的意义？
    答：ccType标识该openid开通的哪一种免流，其中：0表示联通，1表示电信，2表示移动
    expire表示目前免流查询过期缓存时间，（注意：不是用户免流的过期时间）是指游戏可以选择下次什么时候来查询，其中这段时间内用户是免流的，
    可以减少游戏对后台服务的压力，当然也可以选择不信任该值，每次都掉用接口查询该用户是否免流，以上两种方式都可以。

  9. 问：返回的ip是否标识android和ios平台，例如：qq玩家在android购买免流套餐，到ios区服此时是否免流，是否有返回ios的区服ip列表？
    答：同一个qq在不同的平台，其实openid是一样的，那么都会免流，但是接口返回的ip列表没有区分android和ios，需要客户端自己在知道区服的ip情况下判断和区分。