Interstitial banners

Hive SDK 提供了一个插页式横幅来

• 有效地向游戏用户展示事件
• 鼓励用户更多参与游戏
• 利用交叉推广来宣传其他游戏并给予奖励

由 Hive 定义的横幅意味着由单个图像组成的无字促销视图。如果用户点击横幅，它将根据在 Hive 控制台中配置的内容将用户带到详细信息页面、外部页面或所宣传游戏的下载页面。我们建议您在用户登录后进入游戏大厅时展示插页式横幅，该横幅以全屏显示横幅图像。

在 Hive 控制台上注册插页横幅¶

根据以下横向和纵向模式设计横幅图像，并在 Hive 控制台上注册它。有关横幅注册的更多信息，请参阅 Hive 控制台促销指南。

• 促销横幅图像尺寸
  • 横屏模式：1080x720 像素
  • 竖屏模式：720x1080 像素
• 如果您想在PC环境中显示高分辨率横幅，请上传2160x1440 像素的图像。

显示插页横幅¶

• 插页横幅的示例

要显示插页式横幅，请从Promotion类调用showPromotion()方法，并传入PromotionType.BANNER参数。从Hive SDK v4.12.1开始，PromotionType.BANNER显示网页类型的横幅，而其他参数显示图像视图类型的横幅。当您调用PromotionType.BANNERLEGACY时，webview类型的横幅将照常显示。

当显示类型为 PromotionType.BANNER 的完整横幅时，在 Hive SDK 初始化过程中异步存储在应用程序本地存储中的图像将被显示。如果没有缓存的图像，将立即下载图像以进行显示。

从 Hive SDK v4 24.2.0 开始，插页横幅底部的“今天不显示”功能将更改为“n天内不显示”。在 Hive 控制台注册插页横幅时，您可以设置不显示的持续时间为 1 到 7 天。未显示的标准是在日期变化时各自区域的当地时间午夜。有关更多详细信息，请参考 Hive 控制台促销指南。

以下是显示插页式横幅的示例代码。

using hive;    
    PromotionType promotionViewType = PromotionType.BANNER;    

    // 如果为真，则“今天不再观看”按钮将不会显示。即使用户已经设置为今天不再看到，它也会被忽略，并显示一个插页横幅。    
    Boolean isForced = false;    

    // 显示插页式横幅    
    Promotion.showPromotion(promotionViewType, isForced, (ResultAPI result, PromotionEventType viewEventType) => {    
         if (result.isSuccess()) {    
             // 调用成功    
         }    
});

#include "HivePromotion.h"

EHivePromotionType PromotionType = EHivePromotionType::BANNER;

 // 如果为真，‘今天不再观看’按钮将不会显示。即使用户已经设置为今天不再看到，它也会被忽略，并显示一个插页式横幅。
bool bIsForced = false;

FHivePromotion::ShowPromotion(PromotionType, bIsForced, FHivePromotionViewDelegate::CreateLambda([this](const FHiveResultAPI& Result, const EHivePromotionEventType& PromotionEventType) {
        if (Result.IsSuccess()) {
                // API call success
        }
}));

#include <HIVE_SDK_Plugin/HIVE_CPP.h>    
    using namespace std;    
    using namespace hive;    
    PromotionType promotionViewType = PromotionType::BANNER;    

    // 如果为真，则“今天不再观看”按钮将不会显示。即使用户已经设置为今天不再看到，它也会被忽略，并显示一个插页广告横幅。    
    bool isForced = false;    

    Promotion::showPromotion(promotionViewType, isForced, [=](ResultAPI result, PromotionEventType viewEventType) {    
        if (result.isSuccess()) {    
            // call successful    
         }    
});

import com.hive.Promotion    
    import com.hive.ResultAPI    
    val promotionViewType = Promotion.PromotionViewType.BANNER    
    // 如果为真，则“今天不再观看”按钮将不会显示。即使用户已经设置为今天不再看到，它也会被忽略，并显示插页式横幅。    
    val isForced = false    
    Promotion.showPromotion(promotionViewType, isForced, object : Promotion.PromotionViewListener {    
         override fun onPromotionView(result: ResultAPI, promotionEventType: Promotion.PromotionViewResultType) {    
             if (result.isSuccess) {    
                 // 调用成功    
             }    
         }    
})

import com.hive.Promotion;    
    import com.hive.ResultAPI;    
    Promotion.PromotionViewType promotionViewType = Promotion.PromotionViewType.BANNER;    
    // 如果为真，则“今天不再观看”按钮将不会显示。即使用户已经设置为今天不再看到，它也会被忽略，并显示插页式横幅。    
    boolean isForced = false;    
    Promotion.INSTANCE.showPromotion(promotionViewType, isForced, (result, promotionEventType) -> {    
         if (result.isSuccess()) {    
             // 调用成功    
         }    
});

import HIVEService    
    let promotion: PromotionViewType = .banner    
    // 如果为真，“今天不再观看”按钮将不会显示。即使用户已经设置为今天不再看到，它也会被忽略，并显示插页式横幅。    
    let isForced = false    
    PromotionInterface.showPromotion(promotionViewType, isForced: isForced) { result, viewResultType in    
    if result.isSuccess() {    
    // 调用成功    
    }    
}

#import <HIVEService/HIVEService-Swift.h>    
    HIVEPromotionViewType promotionViewType = HIVEPromotionViewTypeBANNER;    

    // 如果为真，则“今天不再观看”按钮将不会显示。即使用户已经设置为今天不再显示，它也会被忽略，并显示一个插页横幅。    
    BOOL isForced = NO;    

    [HIVEPromotion showPromotion: promotionViewType isForced: isForced handler: ^(HIVEResultAPI *result, HIVEPromotionViewResultType viewResultType) {    
         if ([result isSuccess]) {    
              // call successful    
         }    
}];

控制交叉推广的插页横幅¶

当您调用showPromotion()方法时，所有先前注册的插页式广告都会显示。从Hive SDK v4 24.2.0开始，您可以选择是否显示交叉推广插页式广告。

如果在调用 showPromotion() 方法之前调用 Configuration.setCrossPromotionBannerShowing(false)，则在应用启动时不会显示交叉推广插页式横幅。如果将其设置为 true，则会显示横幅。此方法在应用保持活动状态时继续影响应用，因此只需在 Hive SDK 初始化后并在调用 showPromotion() 方法之前调用一次即可。您可以在应用活动时通过再次调用此方法并传入不同的值（true 或 false）来更改横幅的可见性。

using hive;

// 设置交叉推广插页式横幅不显示（假）
Configuration.setCrossPromotionBannerShowing(false);

// 返回交叉推广插页广告显示的状态
Boolean crossPromotionBannerShowing = Configuration.getCrossPromotionBannerShowing();

#include <HIVE_SDK_Plugin/HIVE_CPP.h>
using namespace std;
using namespace hive;

// 设置交叉推广插页式横幅不显示（假）
Configuration::setCrossPromotionBannerShowing(false);

// 返回跨推广插页广告显示的状态
bool crossPromotionBannerShowing = Configuration::getCrossPromotionBannerShowing();

import com.hive.Configuration

// 设置交叉推广插页广告不显示（假）
Configuration.setCrossPromotionBannerShowing(false)

// 返回跨推广插页广告显示的状态
val crossPromotionBannerShowing = Configuration.getCrossPromotionBannerShowing()

import com.hive.Configuration;

// 设置交叉推广插页广告不显示 (false)
Configuration.INSTANCE.setCrossPromotionBannerShowing(false);

// 返回跨推广插页广告显示的状态
boolean crossPromotionBannerShowing = Configuration.INSTANCE.getCrossPromotionBannerShowing();

import HIVEService

// 设置交叉推广插页式横幅不显示（假）
ConfigurationInterface.setCrossPromotionBannerShowing(false)

// 返回交叉推广插页广告显示的状态
var crossPromotionBannerShowing: Bool = ConfigurationInterface.getCrossPromotionBannerShowing()

#import <HIVEService/HIVEService-Swift.h>

// 设置交叉推广插页广告不显示（假）
[HIVEConfiguration setCrossPromotionBannerShowing:false];

// 返回交叉推广插页广告显示的状态
BOOL crossPromotionBannerShowing = [HIVEConfiguration getCrossPromotionBannerShowing];
#import <HIVEService/HIVEService-Swift.h>

// 设置交叉推广插页式横幅不显示（假）
[HIVEConfiguration setCrossPromotionBannerShowing:false];

// 返回交叉推广插页广告显示的状态
BOOL crossPromotionBannerShowing = [HIVEConfiguration getCrossPromotionBannerShowing];