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

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

ข้อมูลตลาด¶

• HIVESTORE PG รองรับเพียง การค้นหาและซื้อสินค้า เท่านั้น และการตรวจสอบใบเสร็จที่ใช้บนไคลเอนต์ไม่รองรับ
• DMM ร้านค้าใช้เฉพาะกรณีที่รันผ่าน DMM GAME PLAYER บน Windows เท่านั้น และทำงานบนพื้นฐานแต้ม DMM สำหรับรายละเอียดเพิ่มเติม โปรดดูที่ สิ่งที่ต้องตรวจสอบก่อนใช้งานการชำระเงิน DMM

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

สิ่งที่ต้องตรวจสอบก่อนใช้งานการชำระเงิน DMM¶

การชำระเงิน DMM ใช้เมื่อรันผ่าน DMM GAME PLAYER บน Windows เนื้อหาเกี่ยวกับ DMM ในเอกสารนี้อ้างอิงตามสภาพแวดล้อม Windows สำหรับข้อจำกัดเรื่องการเข้าสู่ระบบ DMM และโทเค็นจัดการ โปรดดูที่ เข้าสู่ระบบด้วย DMM ก่อน

การชำระเงิน DMM เป็นวิธีชำระเงินที่ใช้แต้ม DMM ที่ผู้ใช้เติมไว้ในการซื้อสินค้า ขั้นตอนการขอชำระเงินและการกู้คืนเป็นไปตามขั้นตอนการซื้อทั่วไปของ IAP v4 แต่จะทำงานร่วมกับเงื่อนไขเฉพาะของ DMM เช่น การตรวจสอบยอดแต้ม DMM คงเหลือและการแนะนำให้เติมแต้ม ดังนั้นในสภาพแวดล้อม DMM บน Windows ระบบจะยังคงขั้นตอน IAP v4 เดิมไว้ พร้อมทั้งประมวลผลเงื่อนไขการชำระเงินที่อิงตามแต้ม DMM ไปพร้อมกัน

เตรียมความพร้อม: การลงทะเบียนในคอนโซล¶

หากต้องการใช้การยืนยันตัวตน DMM โปรดดูที่ เข้าสู่ระบบด้วย DMM ก่อน

คุณสมบัติของการชำระเงิน DMM¶

การชำระเงินจะได้รับการยืนยันทันทีหลังเรียก purchase() โดยไม่มี UI หน้าต่างชำระเงินแยกต่างหาก อย่างไรก็ตาม ขึ้นอยู่กับสถานการณ์การประมวลผลของเซิร์ฟเวอร์ ใบเสร็จอาจไม่ถูกส่งคืนทันทีหลังการซื้อ ในกรณีนี้ให้เรียก restore() เพื่อขอรับใบเสร็จอีกครั้ง

การเรียกใช้ API การชำระเงิน DMM ต้องใช้โทเค็นจัดการ onetime_token ที่ยังไม่หมดอายุ สำหรับอายุของโทเค็น การต่ออายุอัตโนมัติ และการจัดการเมื่อหมดอายุ โปรดดูที่ เข้าสู่ระบบด้วย DMM

เริ่มต้น IAPv4¶

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

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 
        }
}));

#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    
         }    
});

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    
             }    
         }    
})

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

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

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

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

จาก 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 เป็นต้นไป

การจัดการความล้มเหลวในการเริ่มต้น Google Play for native PC (Hive SDK v4 Unity Windows 26.4.2 ขึ้นไป)¶

หากจำเป็นต้องปิดแอปเนื่องจากการเริ่มต้น Play Games PC SDK ล้มเหลว ระบบจะส่งผลลัพธ์ผ่าน callback ของ IAPV4.marketConnect แทนการบังคับปิดแอป ทั้งนี้เพื่อให้แอปสามารถควบคุมจังหวะเวลาและวิธีการปิดแอปได้ด้วยตนเอง

เมื่อการเริ่มต้น Play Games PC SDK ล้มเหลว (kActionRequiredShutdownClientProcess) callback ของ IAPV4.marketConnect จะส่งรหัสผลลัพธ์ IAPV4PlayStoreActionRequiredShutdown(-6100706) กลับมา

เมื่อได้รับรหัสผลลัพธ์นี้ ขอแนะนำให้ปิดโปรเซสของแอปโดยเร็วที่สุด เนื่องจาก ResultAPI.needExit() จะคืนค่า true คุณจึงสามารถใช้ needExit() เพื่อตรวจสอบว่าจำเป็นต้องปิดแอปหรือไม่ เมื่อปิดโปรเซสแล้ว ฝั่ง Play Games PC SDK จะพยายามดำเนินการขั้นตอนต่อไปเพื่อสนับสนุนผู้ใช้