ข้ามไปที่เนื้อหา

การเริ่มต้น IAP v4

ในการเปิดใช้งาน IAP v4 ให้ขอการเริ่มต้น IAP ก่อนการซื้อ หากคุณขอให้เริ่มต้น IAP เกมไคลเอนต์จะส่งคืนข้อมูลร้านค้าที่มีอยู่ ข้อมูลร้านค้าถูกกำหนดเป็นอีเนัม IAPV4Type และรายละเอียดในฟิลด์มีดังนี้;

ข้อมูลตลาด

ชื่อฟิลด์ คำอธิบาย
APPLE_APPSTORE Apple App Store
GOOGLE_PLAYSTORE Google Play Store
HIVE_LEBI Lebi Store
ONESTORE ONE Store
AMAZON_APPSTORE Amazon App Store (ใช้ได้กับ SDK v4 เท่านั้น)
SAMSUNG_GALAXYSTORE Samsung Galaxy Store
HUAWEI_APPGALLERY Huawei App Gallery
HIVESTORE PG Payment (สำหรับ Windows, Unity เท่านั้น)

ตลาดสกุลเงินอ่อนในเกมควรจะเปิดให้ผู้ใช้ที่สนุกกับการเล่นเกมแม้หลังจากที่เกมหยุดให้บริการดาวน์โหลด ดังนั้น สตูดิโอเกมแต่ละแห่งจึงจำเป็นต้อง เขียนโค้ดตลาดสกุลเงินแข็งและตลาดสกุลเงินอ่อนแยกกัน ค่าผลลัพธ์ที่ส่งโดยการเริ่มต้น IAP v4 ไม่ได้ใช้สำหรับการเข้าถึงตลาดในเกม ดังนั้นอย่าใช้ค่าผลลัพธ์ในวิธีที่แตกต่างกัน Implement marketConnect() ในคลาส IAPV4 เพื่อเริ่มต้น IAP v4.

เริ่มต้น IAPv4

ต่อไปนี้คือตัวอย่างโค้ดเพื่อเริ่มต้น IAP v4.

เอกสาร API: hive.IAPV4.marketConnect

using hive;    
    IAPV4.marketConnect((ResultAPI result, List marketIdList) => {    
         if (result.isSuccess()) {    
            // call successful    
        }    
});

#include "HiveIAPV4.h"

FHiveIAPV4::MarketConnect(FHiveIAPV4OnMarketConnectDelegate::CreateLambda([this](const FHiveResultAPI& Result, const TArray<EHiveIAPV4Type>& MarketIds) {
        if (Result.IsSuccess()) {
                // call successful 
        }
}));

API Reference: IAPV4::marketConnect

#include <HIVE_SDK_Plugin/HIVE_CPP.h>    
    using namespace std;    
    using namespace hive;    
    IAPV4::marketConnect([=](ResultAPI const & result, vector const & marketIdList) {    
         if (result.isSuccess()) {    
            // call successful    
         }    
});

API Reference: IAPV4.marketConnect

import com.hive.IAPV4    
    import com.hive.ResultAPI    
    IAPV4.marketConnect(object : IAPV4.IAPV4MarketInfoListener {    
         override fun onIAPV4MarketInfo(result: ResultAPI, iapV4TypeList: ArrayList<IAPV4.IAPV4Type>?) {    
             if (result.isSuccess) {    
                 // call successful    
             }    
         }    
})

API Reference: com.hive.IAPV4.marketConnect

import com.hive.IAPV4;    
    import com.hive.ResultAPI;    
    IAPV4.INSTANCE.marketConnect((result, iapV4TypeList) -> {    
         if (result.isSuccess()) {    
             // call successful    
         }    
});

API Reference: IAPV4Interface .marketConnect

import HIVEService    
    IAPV4Interface.marketConnect() { result, marketIdList in    
        if result.isSuccess() {    
        // call successful    
        }    
}

API Reference: HIVEIAPV4::marketConnect

#import <HIVEService/HIVEService-Swift.h>    
    [HIVEIAPV4 marketConnect: ^(HIVEResultAPI *result, NSArray<NSNumber *> *marketIdList) {    
         if ([result isSuccess]) {    
            // call successful    
         }    
}];
Warning

หากการเรียก marketConnect() ล้มเหลว คุณจะไม่สามารถดำเนินการดูรายการสินค้าและการซื้อได้ตามปกติ สาเหตุที่พบบ่อยมีดังนี้

  • การล็อกอินบัญชีบนอุปกรณ์ไม่สมบูรณ์
  • การล็อกอินแอปมาร์เก็ต เช่น Google Play Store หรือ Apple App Store ไม่สมบูรณ์
  • การตั้งค่ามาร์เก็ตของ App ID ใน Hive Console ไม่สมบูรณ์

แม้ว่าการเชื่อมต่อบางมาร์เก็ตในหลายมาร์เก็ตจะล้มเหลว marketList ใน callback จะยังคงรวม มาร์เก็ตทั้งหมดที่ตั้งค่าไว้ใน Hive Console อยู่ดี โดยระบบจะส่งรายการที่ลงทะเบียนในคอนโซลกลับมาตามเดิม

ตัวอย่าง: แอปที่ตั้งค่า App Store และ Hive Store ไว้ แล้วล้มเหลวเฉพาะ Hive Store

  • ResultAPI: ส่งคืน error code
  • marketList: [APPLE_APPSTORE, HIVESTORE] (ส่งคืนทุกมาร์เก็ตที่ตั้งค่าไว้)

ดังนั้นแม้ ResultAPI จะล้มเหลว ก็ไม่ได้หมายความว่าทุกมาร์เก็ตใน marketList เชื่อมต่อสำเร็จ คุณต้องจัดการฝั่งไคลเอนต์เอง โดย retry จนกว่าจะได้รับ success callback หรือ แสดงสถานะข้อผิดพลาด (ใช้งานมาร์เก็ตไม่ได้) ให้ผู้ใช้ทราบผ่าน popup.

ตรวจสอบรหัสที่เกี่ยวข้องได้ที่ IAP v4 Result API Guide

หมายเหตุสำหรับการเริ่มต้น

จาก Hive SDK v4 Unity Windows 25.8.0 รองรับแอป Windows สำหรับ Google Play และสามารถใช้ตลาด GOOGLE_PLAYSTORE ได้ ในกรณีนี้ โปรดทราบสิ่งต่อไปนี้ระหว่างการพัฒนา:

  • คุณต้องเข้าสู่ระบบด้วยบัญชี Google ในแอป PC Google Play Games ก่อนที่จะเรียกใช้การเริ่มต้น (IAPV4.marketConnect)
  • คุณต้องเตรียมไฟล์ manifest.xml

สามารถใช้มาร์เก็ต HIVESTORE (PG) ได้ตั้งแต่ Hive SDK v4 iOS เวอร์ชัน 26.3.2 เป็นต้นไป