ป้ายโปรโมชั่น
ป้ายส่งเสริมการขายเป็นตัวบ่งชี้ที่เพิ่มเข้าไปในปุ่มหรือไอคอนในเกมเพื่อแจ้งให้ทราบว่ามีการลงทะเบียนโปรโมชั่นใหม่
ป้ายส่งเสริมการขายทำอะไร?¶
ป้ายส่งเสริมการขายเป็นฟังก์ชันที่แจ้งให้ผู้ใช้ทราบเมื่อมีการลงทะเบียนและเปิดเผยโปรโมชั่นใหม่ โดยการส่งข้อมูลนั้นไปยังไคลเอนต์เกม สามารถนำไปใช้กับฟีเจอร์การส่งเสริมการขาย เช่น แบนเนอร์ระหว่างหน้า, มุมมองที่กำหนดเอง, กระดานที่กำหนดเอง และไอคอนประกาศ
การนำเสนอ 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