การเริ่มต้น SDK¶

การเริ่มต้นของ SDK ยี่ห้อ Hive หมายถึงการทำให้ฟีเจอร์ส่วนใหญ่ของ SDK อยู่ในสถานะเริ่มต้น ซึ่งพร้อมใช้งาน เมื่อคุณทำการเขียนโค้ด SDK คุณต้องดำเนินการเริ่มต้นก่อนแล้วจึงเรียกใช้วิธีการในการใช้งานฟีเจอร์ Hive

วิธีการเริ่มต้น¶

ในการเริ่มต้น SDK Hive ให้เรียกใช้ AuthV4.setup แนะนำให้ทำการเริ่มต้น หลังจากที่แอปทำงานและโลโก้บริษัท (CI) แสดงผล หาก result.isSuccess ที่ได้รับเป็นผลลัพธ์ของการเรียกกลับเป็น True การเริ่มต้นจะสำเร็จ นี่คือตัวอย่างโค้ด

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16

using hive;

    // ขอเริ่มต้นการใช้งาน Hive SDK
    AuthV4.setup((result, isAutoSignIn, did, providerTypeList) => {
        if (result.isSuccess()) {
            // การเริ่มต้นเสร็จสมบูรณ์แล้ว จัดการการเข้าสู่ระบบตามว่าการเข้าสู่ระบบอัตโนมัติเปิดใช้งานหรือไม่
        } else if (result.needExit()) {
            // TODO: นำไปใช้ในการปิดแอป
            // ผู้ใช้ของเอนจิน Cocos2d-x
            // ex) exit(0);
            // ผู้ใช้เอนจิน Unreal
            // ตัวอย่าง) UKismetSystemLibrary::QuitGame(GetWorld(), nullptr, EQuitPreference::Quit, false);    
        } else {
            // การเริ่มต้นล้มเหลว 
        }
    });

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16

#include <HIVE_SDK_Plugin/HIVE_CPP.h>

    // ขอเริ่มต้นการใช้งาน Hive SDK
    AuthV4::setup([=](ResultAPI const & result, bool isAutoSignIn, std::string did, std::vector<ProviderType> const & providerTypeList) {
        if (result.isSuccess()) {
            // การเริ่มต้นเสร็จสมบูรณ์แล้ว จัดการการเข้าสู่ระบบตามว่าการเข้าสู่ระบบอัตโนมัติเปิดใช้งานหรือไม่
        } else if (result.needExit()) {
            // TODO: นำไปสู่การสิ้นสุดของแอป
            // ผู้ใช้ของเอนจิน Cocos2d-x
            // ex) exit(0);
            // ผู้ใช้เอนจิน Unreal
            // ตัวอย่าง) UKismetSystemLibrary::QuitGame(GetWorld(), nullptr, EQuitPreference::Quit, false);    
        } else {
            // การเริ่มต้นล้มเหลว 
        }
    });

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14

import com.hive.AuthV4;

    // ขอเริ่มต้นการตั้งค่า Hive SDK    
    AuthV4.setup(object: AuthV4.AuthV4SetupListener{    
        override fun onAuthV4Setup(result: ResultAPI, isAutoSignIn: Boolean, did: String?, providerTypeList: ArrayList<AuthV4.ProviderType>?) {        if (result.isSuccess) {    
                // การเริ่มต้นเสร็จสมบูรณ์แล้ว จัดการการเข้าสู่ระบบตามว่าการเข้าสู่ระบบอัตโนมัติเปิดใช้งานหรือไม่    
            } else if (result.needExit()) {    
                // TODO: นำไปใช้ในการปิดแอป    
                // ex) exitProcess(0)    
            } else {    
                // การเริ่มต้นล้มเหลว 
            } 
        } 
    })

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16

import com.hive.AuthV4;  

    // ขอเริ่มต้นการใช้งาน Hive SDK    
    AuthV4.setup(new AuthV4.AuthV4SetupListener() {    
        @Override    
        public void onAuthV4Setup(ResultAPI result, boolean isAutoSignIn, String did, ArrayList<AuthV4.ProviderType> providerTypeList) {    
            if (result.isSuccess()) {    
                // การเริ่มต้นสำเร็จแล้ว จัดการการเข้าสู่ระบบตามว่าการเข้าสู่ระบบอัตโนมัติเปิดใช้งานหรือไม่    
            } else if (result.needExit()) {    
                // TODO: นำไปใช้ในการปิดแอป    
                // ex) System.exit(0);    
            } else {    
                // การเริ่มต้นล้มเหลว 
            } 
        } 
    });

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13

import HIVEService

    // ขอเริ่มต้นการใช้งาน Hive SDK
    AuthV4Interface.setup { (result, isAutoSignIn, did, providerTypeList) in    
        if result.isSuccess() {    
            // การเริ่มต้นเสร็จสมบูรณ์แล้ว จัดการการเข้าสู่ระบบตามว่าการเข้าสู่ระบบอัตโนมัติเปิดใช้งานหรือไม่    
        } else if result.needExit() {    
            // TODO: นำไปใช้ในการปิดแอป    
            // ตัวอย่าง) exit(0)    
        } else {    
            // การเริ่มต้นล้มเหลว    
        }    
    }

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13

#import <HIVEService/HIVEService-Swift.h>

    // ขอ Hive การเริ่มต้น SDK    
    [HIVEAuthV4 setup:^(HIVEResultAPI *result, BOOL isAutoSignIn, NSString *did, NSArray<NSNumber *> *providerTypeList) {    
        if (result.isSuccess) {    
            // การเริ่มต้นเสร็จสมบูรณ์แล้ว จัดการการเข้าสู่ระบบตามว่าเปิดใช้งานการเข้าสู่ระบบอัตโนมัติหรือไม่    
        } else if (result.needExit) {    
            // TODO: นำไปใช้ในการปิดแอป    
            // ex) exit(0);    
        } else {    
            // การเริ่มต้นล้มเหลว    
        }    
    }];

#include "HiveAuthV4.h"

    FHiveAuthV4::Setup(FHiveAuthV4OnSetupDelegate::CreateLambda([this](const FHiveResultAPI& Result,
    bool IsAutoSignIn,
    const FString& Did,
    const TArray<EHiveProviderType>& ProviderTypeArray) 
    {
            if (Result.IsSuccess()) {
                    // การเริ่มต้นสำเร็จ จัดการการเข้าสู่ระบบตามว่าการลงชื่อเข้าใช้โดยอัตโนมัติเป็นไปได้หรือไม่
            } else if (Result.NeedExit()) {
                    // TODO: นำฟังก์ชันการออกจากแอปไปใช้
                    // e.g.) UKismetSystemLibrary::QuitGame(GetWorld(), nullptr, EQuitPreference::Quit, false);
            } else {
                    // การเริ่มต้นล้มเหลว
            }
    }));

ผลลัพธ์ของการเรียกกลับรวมข้อมูลด้านล่างนี้ นักพัฒนาควรจัดเก็บข้อมูลด้านล่างและใช้เมื่อจำเป็น

ผลลัพธ์การเริ่มต้น¶

การเริ่มต้น SDK จะทำสิ่งต่อไปนี้

• เริ่มต้นการตรวจสอบสิทธิ์, โปรโมชั่น, การแจ้งเตือน, และการระบุการตลาด
• แสดง ข้อกำหนด ที่ลงทะเบียนในคอนโซล Hive โดยอัตโนมัติและ ป๊อปอัพการอัปเดต

ขั้นตอนการเริ่มต้น¶

กระบวนการทำงานที่ SDK ดำเนินการภายในเมื่อ AuthV4.setup ถูกเรียกใช้จะแตกต่างกันไปขึ้นอยู่กับภูมิภาคที่คุณวางแผนจะเปิดตัวแอปของคุณ

1. ภูมิภาคอื่นนอกเหนือจากสหรัฐอเมริกาและยุโรป
2. สหรัฐอเมริกา
3. ยุโรป

ขั้นตอนการเริ่มต้น: ขั้นตอนเริ่มต้น¶

ภาพด้านล่างแสดงให้เห็นถึงกระบวนการทำงานเริ่มต้นที่ SDK ดำเนินการภายในเมื่อ AuthV4.setup ถูกเรียกใช้ สิ่งนี้ใช้เมื่อเปิดตัวแอปของคุณในภูมิภาคอื่นนอกเหนือจากสหรัฐอเมริกาและยุโรป

ขั้นตอนการเริ่มต้น: การเปิดตัวในสหรัฐอเมริกา¶

ภาพด้านล่างแสดงให้เห็นถึงกระบวนการทำงานที่ SDK ดำเนินการภายในเมื่อ AuthV4.setup ถูกเรียกใช้ สิ่งนี้ใช้เมื่อคุณต้องปฏิบัติตาม COPPA (Children's Online Privacy Protection Act) เมื่อเปิดตัวแอปของคุณในสหรัฐอเมริกา

ขั้นตอนการเริ่มต้น: การเปิดตัวในสหภาพยุโรป¶

ภาพด้านล่างแสดงให้เห็นถึงกระบวนการทำงานที่ SDK ดำเนินการภายในเมื่อ AuthV4.setup ถูกเรียกใช้ สิ่งนี้ใช้เมื่อคุณต้องปฏิบัติตาม GDPR (General Data Protection Regulation) เมื่อเปิดตัวแอปของคุณในยุโรป