1 AdMob广告
1.1 判断是否开启奖励广告
调用方法：
|
1 2 |
boolean isEnable = UWingSDK.AdMob.RewardedAd.isEnable(String adName); |
参数说明：
| 参数名 | 类型 | 说明 | 备注 |
|---|---|---|---|
| adName | String | 广告名称，SDK后台配置的广告名称 | 具体值从运营处获取 |
1.2 展示激励广告
接口效果：
点击“通知发货”，输入奖励物品ID后点击确定，游戏提供的激励广告奖励通知接口将收到通知发货信息，游戏服务端需要按照接入文档要求完成发货
调用方法：
|
1 2 |
UWingSDK.AdMob.RewardedAd.showAd(Activity activity, String adName, String extInfo, UWAdMobAdsCallback callback) |
参数说明：
| 参数名 | 类型 | 说明 | 备注 |
|---|---|---|---|
| activity | Activity | 当前 Activity | |
| adName | String | 广告名称，SDK后台配置的广告名称 | 具体值从运营处获取 |
| extInfo | String | 额外信息，可用作透传，比如透传礼包ID | 该参数随广告奖励通知接口传递给游戏服务端，长度限制为100个字符 |
| callback | UWAdMobAdsCallback | 广告回调 |
UWAdMobAdsCallback广告回调说明：
| 方法 | 说明 |
|---|---|
| onAdShowed() | 广告页面成功显示 |
| onAdDismissed() | 广告页面关闭 |
| onAdFailed(String error_message) | 广告加载失败 |
示例如下：
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 |
UWingSDK.AdMob.RewardedAd.showAd(activity, adName, extInfo, new UWAdMobAdsCallback() { @Override public void onAdShowed() { Log.i("usdk","广告已显示"); } @Override public void onAdFailed(String error_message) { Log.i("usdk","广告加载失败: " + error_message); } @Override public void onAdDismissed() { Log.i("usdk","广告已关闭"); } }); |
测试发货：具体查看《CP接口测试》章节中的 《AdMob激励广告通知接口》
2 订阅功能
2.1 判断是否开启订阅功能
调用方法：
|
1 2 |
boolean isEnable = UWingSDK.User.isOpenSubscription() |
2.2 订阅支付
接口效果：
点击“订阅支付”后，游戏提供的发货通知接口将收到客户端购买的商品信息，接下来按照接入文档要求完成发货
调用方法：
|
1 2 |
UWingSDK.User. paySub(String targetSubProductId, String oldSubProductId, String extInfo, UWCallback<UWPayResult> callback) |
方法参数说明：
| 参数名 | 类型 | 说明 | 备注 |
|---|---|---|---|
| targetSubProductId | String | 目标订阅商品ID，必传，需要发起订阅的订阅商品ID | |
| oldSubProductId | String | 旧的订阅商品ID，需要基于旧的订阅商品进行订阅升级时才需要。比如按月付升级为按年付时，传入原月付订阅商品ID | |
| extInfo | String | 扩展信息，可用于透传，比如：透传订单号或发货接口。 | 该信息会在支付成功后原样通知到 CP 服务器 |
| callback | UWCallback |
支付回调处理 |
支付结果UWPayResult说明：
| 参数名 | 类型 | 说明 | 备注 |
|---|---|---|---|
| platform | String | 支付平台，比如：GOOGLE | |
| sdkProductId | String | SDK 的商品 ID | |
| extInfo | String | 扩展信息 | 支付时CP传入的extInfo字段 |
| orderId | String | SDK订单ID | 部分支付方式没有 |
| currency | String | 货币类型，基准货币 | 由SDK后台定义的 |
| price | long | 商品价格，单位微分，1元=1000000 | 由SDK后台定义的 |
示例如下：
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 |
UWingSDK.User.paySub(“targetSubProductId”, “targetSubProductId”,” extInfo”, new UWCallback<UWPayResult>() { @Override public void onSuccess(int code, String message, UWPayResult result) { showMsg("订阅支付成功. "); } @Override public void onError(int code, String message, UWPayResult result, Throwable throwable) { showMsg("订阅支付失败（" + code + "）：" + message); } @Override public void onCancel() { showMsg("订阅支付取消."); } }); }); |
2.3 获取订阅状态
调用方法：
|
1 2 |
UWingSDK.User.getSubStatus(String subProductId, UWCallback<List<UWSubscriptionStatus>> callback) |
订阅状态UWSubscriptionStatus说明：
| 字段名 | 类型 | 说明 | 备注 |
|---|---|---|---|
| subscribeNo | String | 订阅号 | |
| productId | String | 订阅商品id | |
| subscribeStatus | int | 订阅状态： 1- ACTIVE（生效中） 2- CANCELED（已取消，到期前仍有效） 3- EXPIRED（已过期，权益结束） 4- REVOKED（已撤销，退款 / 渠道撤销） |
|
| expireTime | long | 到期时间（毫秒） | |
| autoRenew | int | 是否自动续费: 0-否 1-是 |
|
| offerPhase | String | 当前优惠阶段：freeTrial = 免费试用期 / introductoryPrice = 优惠价期 / basePrice = 正常价期 | |
| targetSubProductId | String | 目标订阅商品ID，必传，需要发起订阅的订阅商品ID | |
| oldSubProductId | String | 旧的订阅商品ID，需要基于旧的订阅商品进行订阅升级时才需要。比如按月付升级为按年付时，传入原月付订阅商品ID | |
| extInfo | String | 扩展信息，可用于透传，比如：透传订单号或发货接口。 | 该信息会在支付成功后原样通知到 CP 服务器 |
| callback | UWCallback<UWPayResult> | 支付回调处理 |
示例如下：
|
1 2 3 4 5 6 7 8 9 10 11 |
UWingSDK.User.getSubStatus("sub1_week", new UWCallback<List<UWSubscriptionStatus>>() { @Override public void onSuccess(int code, String message, List<UWSubscriptionStatus> result) { if (result == null || result.isEmpty()) { showMsg("订阅状态：无"); return; } showMsg("订阅状态：" + result.get(0).toString()); } }); |