Search
提供App定向免流量功能，目前接入了TMSDK定向免流量功能，后续可能会再接其他公司的免流量功能。 以下为免流量业务流程，免流量接口请点此跳转
#TMSDK流量包业务交互功能详解
##应用内业务入口展示 ###功能文案: 由“{功能名称}+{业务状态}”构成，{功能名称}建议采用“专属流量包”， {业务状态}参考如下逻辑说明
###UI位置: 由APP自行选择
a) 可固定放置到活动页面
b) 如有点券充值/商城等，建议放在其一级目录下，且固定展示业务入口
###业务状态显示逻辑
在用户进入该业务入口页面时，依据如下逻辑判断入口页面的业务状态显示信息
<1> 判断用户当前的业务状态:调用API接口文档中的 获取SDK运行状态（[SuperSDK invokeInt:@“fdsdk” funcName:@“TMGetWspxStatus” parameters:nil]）接口判断，根据判断结果，实现如下交互:
a> (1)为已订购 -> 进入(2.1)判断 -> (2.1)为服务状态正常(返回值为 0):业务状态
显示为“已开启”
备注:该状态为用户已开通业务，并且当前正常开启定向流量引导策略
b> (1)为已订购 -> 进入(2.1)判断 -> (2.1)为服务已暂停(返回值为 3):业务状态显
示为“已暂停”
备注:该状态为用户虽已开通业务，但手动暂停了定向流量引导(此为可选功能，默
认不开放，如无此需求，建议不做)
c> (1)为已订购 -> 进入(2.1)判断 -> (2.1)为服务状态异常(返回值为 4 或 5):业 务状态显示为“服务异常”
备注:该状态为用户虽已开通业务，但节点异常或 SDK 开启引导失败，不能正常开 启定向流量引导策略
d> (1)为已订购 -> 进入(2.1)判断 -> (2.1)为设备不兼容(返回值为 6):业务状态显 示为“设备不兼容”
备注:该状态为用户虽已开通业务，但暂不兼容当前使用机型，不能正常开启定向流
量引导策略
e> (1)为已订购 -> 进入(2.1)判断 -> (2.1)为系统不兼容(返回值为 7):业务状态显
示为“系统不兼容”
备注:该状态为用户虽已开通业务，但暂不兼容当前手机系统，不能正常开启定向流
量引导策略
f> (1)为已订购 -> 进入(2.1)判断 -> (2.1)为已更换手机卡(返回值为 8 或 9):业
务状态显示为“已更换手机卡”
备注:该状态为用户虽已开通业务，但当前手机卡已变更，不能正常开启定向流量引
导策略
g> (1)为已订购 -> 进入(2.1)判断 -> (2.1)为正在漫游(返回值为 10):业务状态显
示为“正在漫游”
备注:该状态为用户虽已开通业务，但当前已出省，不能正常开启定向流量引导策略
h> (1)为未订购:显示业务入口，但不显示业务状态
###业务入口跳转逻辑 点击业务入口，直接调用打开订购页面接口即可(网宿判断，客户端不用处理)：
[SuperSDK invoke:@"fdsdk" funcName:@"TMOpenServiceView" parameters:nil];
##支持外渠活动页面自动激活功能 该功能主要用于开展推广活动时，通过APP内广告位进入活动页面的用户订购 实现方式： 调用打开活动页面接口，传入对应的活动页面地址即可。
NSDictionary *parameters = @{
@"url" : @"http://www.xxxxx.com"// 活动页面地址，地址由免流量商家提供
};
[SuperSDK invoke:@"fdsdk" funcName:@"TMOpenActivityView" parameters:parameters];
##非WiFi下业务状态提醒(可选)
该部分交互功能可选，但建议支持，以便用户在非 WiFi 下使用时，能知悉当前 流量包服务是否正常，是否能正常免流，安心使用。
###功能描述
用户在非WiFi下使用时，根据不同的用户属性提示不同的信息，用户属性 包括三类——无业务地区用户、有业务地区未订购用户、有业务地区已订购用户
###UI位置
由APP自行决定，但建议放在进入游戏主页面时触发相关提示，提示优先级
以移动信号图标下固定状态提示优先，闪窗提示次之;详见下方说明。
###主要逻辑
用户在进入游戏主页面时，依据如下优先级判断逻辑:
<1> 判断用户当前网络是否 WiFi:客户端自行判断
<2> 判断用户当前的业务状态:调用 API 接口文档中的 获取SDK运行状态（[SuperSDK invokeInt:@“fdsdk” funcName:@“TMGetWspxStatus” parameters:nil]）接口判断 根据判断结果，实现如下交互:
a> (1)为 WiFi:中断，不作任何交互提醒
b> (1)为非 WiFi -> (2)为已订购用户 -> 进入(3.1)判断 -> (3.1)为服务状态正常(返 回值为 0):
根据不同的流量使用状态，进行不同交互提示(调用 API 接口文档中的 实时流量查询（[SuperSDK invoke:@“fdsdk” funcName:@“TMQueryRealTimeTraffic” parameters:nil]）接口，根据回调结果返回的 flowStatus<流量超标标志> 字段判断流量使用状态)。参考交互如下:
(1) 流量未用完(flowStatus=0 或 1):建议可直接在移动信号图标下方显示
“免流量”提示
(2) 流量已用完(flowStatus=2):移动信号图标下无“免流量”提示，且建议
toast 闪窗提示“定向流量已用完，请留意”
c> (1)为非 WiFi -> (2)为已订购用户 -> 进入(3.1)判断 -> (3.1)为服务已暂停(返回 值为 3):(此为可选功能，默认不开放，如无此需求，建议不做)
移动信号图标下无“免流量”提示，且建议 toast 闪窗提示 “您已手动暂停定向 流量包服务 重新开启”，点击“重新开启”会跳转至应用内已接入的业务中心
d> (1)为非 WiFi -> (2)为已订购用户 -> 进入(3.1)判断 -> (3.1)为服务状态异常(节 点异常返回值为 4，SDK 开启引导失败返回值为 5，设备不兼容返回值为 6，系 统不兼容返回值为 7):
移动信号图标下显示“免流异常”提示，且建议 toast 闪窗提示 “定向流量包服 务异常 联系客服”，点击“联系客服”会跳转至应用内已接入的业务中心
e> (1)为非 WiFi -> (2)为已订购用户 -> 进入(3.1)判断 -> (3.1)为已更换手机卡(返 回值为 8 或 9):
f> (1)为非 WiFi->(2)为已订购用户->进入(3.1)判断->(3.1)为处于漫游状态 (返回值为 10):
移动信号图标下可保持显示“免流量”提示，且建议 toast 闪窗提示 “检测到您 可能处于漫游状态 重新激活验证”，点击“重新激活验证”会跳转至应用内已接 入的业务中心
移动信号图标下可保持显示“免流量”提示，且建议 toast 闪窗提示 “检测到您 可能已更换手机卡 重新激活验证”，点击“重新激活验证”会跳转至应用内已接 入的业务中心
g> (1)为非 WiFi -> (2)为未订购用户 -> 进入(3.2)判断 -> (3.2)为满足开通条件，
即有业务地区用户(返回值为 1): 建议弹窗提示用户当前有流量包可订购，文案参考如下“超大流量包强势来袭， 免流量畅玩[产品名称]”，用户可选择:
◆ 点击立即参与:跳转应用内已接入的业务中心
◆ 关闭:关闭弹窗
##实时服务异常提醒 该交互主要用于，订购用户在使用过程中，若出现免流节点服务异常，SDK 将通 过回调提醒APP当前流量引导状态异常，由APP 接收到回调后对用户进行相关提醒。
提醒时机: 非WiFi网络下，用户进入游戏主页面时，或从结束游戏回到游戏主页面时。
实现方式: 通过 API 接口文档中的 设置SDK状态回调监听（[SuperSDK invoke:@“fdsdk” funcName:@“TMSetTMCPListener” parameters:nil]）接口设置回调监听，当接收到服务异常信息 时可在移动信号图标下显示“免流异常”提示，且建议在当前页面 toast 闪窗提示
“定向流量包服务异常 联系客服”，点击“联系客服”会跳转至应用内已接入的业
务中心
##案例参考
1、业务入口
2、活动页样例:
