HIVE_Promotion.h

Go to the documentation of this file.

 
#ifndef __HIVE_PROMOTIONVIEW_H__
#define  __HIVE_PROMOTIONVIEW_H__
 
 
#include "HIVE_ResultAPI.h"
 
 
NS_HIVE_BEGIN
 
 
class ResultAPI;
 
enum class PromotionType;
enum class PromotionCustomType;
enum class PromotionEventType;
enum class PromotionBadgeTarget;
enum class PromotionCampaignType;
enum class PromotionBannerType;
enum class OfferwallState;
enum class EngagementEventType;
enum class EngagementEventState;
 
class PromotionViewInfo;
class PromotionBadgeInfo;
class PromotionBannerInfo;
//class OfferwallReward;
class AppInvitationData;
class AppInvitationCampaign;
class AppInvitationCampaignStage;
class AppInvitationSenderInfo;
 
 
class HIVESDK_DLLEXPORT Promotion {
 
public:
 
    typedef std::function<void(ResultAPI const & result, PromotionEventType promotionEventType)> onPromotionView;
 
 
    typedef std::function<void(ResultAPI const & result, std::vector<PromotionViewInfo> const & promotionViewInfo)> onPromotionViewInfo;
 
 
    typedef std::function<void(ResultAPI const & result, std::vector<PromotionBadgeInfo> const & badgeInfoList)> onPromotionBadgeInfo;
 
 
    typedef std::function<void(ResultAPI const & result, std::vector<PromotionBannerInfo> const & bannerInfoList)> onPromotionBannerInfo;
 
 
    typedef std::function<void(ResultAPI const & result, AppInvitationData const & appInvitationData)> onAppInvitationData;
 
    typedef std::function<void(ResultAPI const & result, EngagementEventType engagementEventType, EngagementEventState engagementEventState, picojson::value const & param)> onEngagement;
    typedef std::function<void(ResultAPI const& result, EngagementEventType engagementEventType, EngagementEventState engagementEventState, std::string const& param)> onEngagementString;
 
    typedef std::function<void(ResultAPI const & result)> onPromotionUAShare;
 
    typedef std::function<void(ResultAPI const & result, AppInvitationSenderInfo const & senderInfo)> onAppInvitationSenderInfo;
 
 
    static void showPromotion(PromotionType promotionType, bool isForced, onPromotionView listener);
 
 
    static void showCustomContents(PromotionCustomType customType, std::string contentsKey, onPromotionView listener);
 
    static void showCustomContentsOnGameWindow(PromotionCustomType customType, std::string contentsKey, onPromotionView listener);
 
    static OfferwallState getOfferwallState();
 
 
    static void showOfferwall(onPromotionView listener);
 
    static void showNews(std::string menu, std::vector<int> giftPidList, onPromotionView listener);
 
    static void showNativeReview(onPromotionView listener);
 
    static void showReview(onPromotionView listener);
 
 
    static void showExit(onPromotionView listener);
 
 
    static void getViewInfo(PromotionCustomType customType, std::string contentsKey, onPromotionViewInfo listener);
 
 
    static void getBadgeInfo(onPromotionBadgeInfo listener);
 
 
    static void getBannerInfo(PromotionCampaignType campaignType, PromotionBannerType bannerType, onPromotionBannerInfo listener);
 
 
    static void getBannerInfoString(std::string campaignString, std::string bannerString, onPromotionBannerInfo listener);
 
 
    static void getAppInvitationData(onAppInvitationData listener);
 
 
    static void setAdditionalInfo(std::string additionalInfo);
 
 
    static ResultAPI setEngagementReady(bool isReady);
 
 
    static bool processURI(std::string URI);
 
    static void setEngagementHandler(onEngagement engagementHandler);
    // Unreal CrossPlay Version
    static void setEngagementHandler(onEngagementString engagementHandler);
 
 
 
    static void showUAShare(std::string inviteMessage, std::string inviteLink, onPromotionUAShare uaShareHandler);
    
    static void  updatePromotionData();
 
    static void getAppInvitationSenderInfo(onAppInvitationSenderInfo appInvitationSenderInfoHandler);
 
    // Native 영역에서 호출된 요청을 처리하기 위한 플러그인 내부 코드
    static void executeEngine(picojson::value jsonParam);
    
};
 
 
 
enum class PromotionType
{
    BANNERLegacy = -1   
    , BANNER            
    , NEWS              
    , NOTICE            
 
};
 
 
enum class PromotionCustomType
{
    VIEW            
    , BOARD         
    , SPOT          
    , DIRECT        
    
};
 
 
enum class PromotionEventType
{
    OPEN              
    , CLOSE           
    , START_PLAYBACK  
    , FINISH_PLAYBACK 
    , EXIT            
    , GOBACK          
};
 
 
enum class PromotionBadgeTarget
{
    NEWS
    , NOTICE
    , CUSTOMVIEW
    , CUSTOMBOARD
    
};
 
 
enum class OfferwallState
{
    ENABLED          
 
    , DISABLED       
 
    , UNKNOWN        
    
};
 
enum class EngagementEventType
{
    EVENT_TYPE              
    
    , PROMOTION_VIEW        
    , OFFERWALL_VIEW
    , USER_ACQUISITION
    , COUPON                
    
    , AUTH_LOGIN_VIEW       
 
    , SOCIAL_INQUIRY_VIEW
    
    , EVENT                 
    
    , IAP_UPDATED           
    
    , IAP_PURCHASE          
    , IAP_PROMOTE           
    , COMPANION             
    , SOCIAL_MYINQUIRY_VIEW 
    , SOCIAL_PROFILE_VIEW   
    , COMMUNITY_VIEW        
 
};
 
enum class EngagementEventState
{
    BEGIN           
    , FINISH           
    , EVENT_START           
    , EVENT_END           
};
 
enum class PromotionCampaignType
{
    EVENT
    , NOTICE
    , ALL
    , CROSS
};
 
enum class PromotionBannerType
{
    GREAT
    , SMALL
    , ROLLING
};
 
 
class HIVESDK_DLLEXPORT PromotionViewInfo
{
public:
    std::string postString;
    std::string url;
    
    PromotionViewInfo();
    
    bool parse(picojson::value jsonParam);
    
    picojson::object toJson() const;
    
    std::string toString() const;
};
 
 
class HIVESDK_DLLEXPORT PromotionBadgeInfo
{
public:
    
    PromotionBadgeTarget target;
    std::string contentsKey;    
    std::string badgeType;      
    
    PromotionBadgeInfo();
    
    bool parse(picojson::value jsonParam);
    
    picojson::object toJson() const;
    
    std::string toString() const;
};
 
class HIVESDK_DLLEXPORT PromotionBannerInfo
{
public:
    int pid;
    std::string imageUrl;
    std::string linkUrl;
    std::string displayStartDate;
    std::string displayEndDate;
    long utcStartDate;
    long utcEndDate;
    std::string typeLink;
    std::string typeBanner;
    std::string typeCampaign;
 
    std::string interworkData;
    
    PromotionBannerInfo();
 
    bool parse(picojson::value jsonParam);
 
    picojson::object toJson() const;
 
    std::string toString() const;
};
 
 
// * @brief 보상 지급 요청에 대한 정보 정의<br/>
// * (showOfferwall() 호출 시, 보상 지급 요청을 보내고 응답을 받은 후, 화면에 wall을 표시해주는 구조임)
// *
// * @ingroup Promotion
// * @author ryuvsken
// */
//class HIVESDK_DLLEXPORT OfferwallReward
//{
//public:
//    int errorNo;
//    std::string errorMessage;
//    int result;
//    std::string eventID;
//    std::string assetCode;
//    int assetAmount;
//
//    OfferwallReward();
//
//    bool parse(picojson::value jsonParam);
//
//    picojson::object toJson() const;
//
//    std::string toString() const;
//};
 
 
class HIVESDK_DLLEXPORT AppInvitationData
{
public:
    std::vector<char> qrCode;                           
    std::string inviteCommonLink;                           
            std::string inviteHivemsgLink;                      
            std::string inviteFacebookLink;                     
    std::vector<AppInvitationCampaign> eachCampaignList;        
    std::vector<AppInvitationCampaignStage> stageCampaignList;    
    std::string inviteMessage;
    
    AppInvitationData();
    
    bool parse(picojson::value jsonParam);
    
    picojson::object toJson() const;
    
    std::string toString() const;
};
 
 
class HIVESDK_DLLEXPORT AppInvitationCampaign
{
public:
    
    std::string title;              
    std::string description;        
    std::string imageUrl;           
    int order;                      
    picojson::value item;           
    std::string itemJsonString;     
    int count;                      
    int limit;                      
    
    AppInvitationCampaign();
    
    virtual ~AppInvitationCampaign(){}
    virtual bool parse(picojson::value jsonParam);
    
    picojson::object toJson() const;
    
    std::string toString() const;
};
 
class HIVESDK_DLLEXPORT AppInvitationCampaignStage: public AppInvitationCampaign
{
public:
    int goalCount;
    int goalTotal;
    
    AppInvitationCampaignStage();
    
    bool parse(picojson::value jsonParam) override;
};
 
class HIVESDK_DLLEXPORT AppInvitationSenderInfo
{
public:
    std::string vid;
 
    AppInvitationSenderInfo();
 
    bool parse(picojson::value jsonParam);
 
    picojson::object toJson() const;
 
    std::string toString() const;
};
 
NS_HIVE_END     // namespace hive
 
// C-Style
extern "C"
{
    HIVESDK_DLLEXPORT const char* PromotionSetEngagementReady(bool isReady);
    HIVESDK_DLLEXPORT bool PromotionHIVEProcessURI(const char* URI);
}
 
 
#endif      // __HIVE_PROMOTIONVIEW_H__