ป้ายโปรโมชั่น
ป้ายส่งเสริมการขายเป็นตัวบ่งชี้ที่เพิ่มเข้าไปในปุ่มหรือไอคอนในเกมเพื่อแจ้งให้ทราบว่ามีการลงทะเบียนโปรโมชั่นใหม่
ป้ายส่งเสริมการขายทำอะไร?¶
ป้ายส่งเสริมการขายเป็นฟังก์ชันที่แจ้งให้ผู้ใช้ทราบเมื่อมีการลงทะเบียนและเปิดเผยโปรโมชั่นใหม่ โดยการส่งข้อมูลนั้นไปยังไคลเอนต์เกม สามารถนำไปใช้กับฟีเจอร์การส่งเสริมการขาย เช่น แบนเนอร์ระหว่างหน้า, มุมมองที่กำหนดเอง, กระดานที่กำหนดเอง และไอคอนประกาศ
การนำเสนอ UI ป้ายส่งเสริมการขาย¶
SDK ของ Hive จะส่ง "badge ON" หากรายการส่งเสริมการขายเป็นรายการใหม่ และ "badge OFF" หากไม่ใช่รายการใหม่ไปยังเกมไคลเอนต์ การแสดงผลของ badge จะต้องถูกนำไปใช้ในฝั่งเกมโดยใช้ข้อมูล ON/OFF นี้
ตัวอย่างหน้าจอของป้ายส่งเสริมการขาย  
  
รูปแบบข้อมูลแบดจ์¶
Hive SDK คืนค่าอ็อบเจ็กต์ PromotionBadgeInfo ที่ถือข้อมูลของการแสดงโปรโมชั่นเป็นอาเรย์ หากไม่มีการแสดงโปรโมชั่นที่เป็นเป้าหมายซึ่งป้ายควรจะแสดง จะคืนค่าเป็นอาเรย์ว่าง ตารางต่อไปนี้อธิบายองค์ประกอบของอ็อบเจ็กต์ PromotionBadgeInfo ที่ Hive SDK คืนค่า
| ฟิลด์ | ประเภท | คำอธิบาย | 
|---|---|---|
| target | Enumerator | เป้าหมายการโปรโมตที่จะแสดงป้าย PromotionBadgeTarget.NEWS: หน้าข่าวPromotionBadgeTarget.NOTICE: รายการประกาศPromotionBadgeTarget.CUSTOMVIEW: มุมมองที่กำหนดเองPromotionBadgeTarget.CUSTOMBOARD: กระดานที่กำหนดเอง | 
| contentsKey | String | ตัวระบุที่ลงทะเบียนใน Hive Console เมื่อมุมมองการโปรโมตของป้ายเป็นมุมมองเว็บที่กำหนดเองหรือกระดานที่กำหนดเอง หากมุมมองการโปรโมตเป็นรายการข่าวหรือประกาศ จะส่งค่ากลับเป็น null | 
| badgeType | String | ประเภทของป้ายที่จะปรากฏ * "new": ค่าดีฟอลต์ สามารถเปิดเผยป้ายในรูปแบบที่นำไปใช้ในด้านเกมได้. | 
ข้อมูลป้ายค้นหา¶
ในการค้นหาข้อมูลแบดจ์ ให้เรียกใช้วิธี getBadgeInfo() ของคลาส Promotion คุณสามารถรับข้อมูลผ่านฟังก์ชัน callback ที่ส่งมาเป็นพารามิเตอร์ฟังก์ชัน ต่อไปนี้คือตัวอย่างโค้ดในการค้นหาข้อมูลแบดจ์
API Reference: hive.Promotion.getBadgeInfo
#include "HivePromotion.h"
FHivePromotion::GetBadgeInfo(FHivePromotionOnBadgeInfoDelegate::CreateLambda([this](const FHiveResultAPI& Result, const TArray<FHivePromotionBadgeInfo>& PromotionBadgeInfoList) {
        if (!Result.IsSuccess()) {
                return;
        }
        for (const auto& PromotionBadgeInfo : PromotionBadgeInfoList) {
                // TODO: แสดงแบดจ์
        }
}));
API Reference: Promotion::getBadgeInfo
#include <HIVE_SDK_Plugin/HIVE_CPP.h>    
    using namespace std;    
    using namespace hive;    
    Promotion::getBadgeInfo([=](ResultAPI result, vector<PromotionBadgeInfo> badgeInfoList) {    
        if (!result.isSuccess()) {    
          return;    
       }    
       // call successful    
       for_each(badgeInfoList.begin(), badgeInfoList.end(), [=](PromotionBadgeInfo badgeInfo) {    
          //TODO:    
          // Display the badge    
       }    
});
API Reference: Promotion.getBadgeInfo
import com.hive.Promotion    
    import com.hive.ResultAPI    
    Promotion.getBadgeInfo(object : Promotion.PromotionBadgeInfoListener {    
         override fun onReceiveInfo(result: ResultAPI, badgeInfoList: ArrayList<Promotion.PromotionBadge>?) {    
             if (!result.isSuccess) {    
                 return    
             }    
             badgeInfoList?.forEach {    
                 //TODO:    
                 // Display the badge    
             }    
         }    
})
API Reference: Promotion.INSTANCE.getBadgeInfo
API Reference: PromotionInterface.getBadgeInfo
API Reference: HIVEPromotion:getBadgeInfo