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

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

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

Note

หลังจากที่คุณทำการตั้งค่า พื้นฐาน เสร็จแล้ว คุณต้องทำการเริ่มต้น Hive SDK

Note

แตกต่างจากฟีเจอร์อื่น ๆ ของ Hive SDK, การเรียกเก็บเงินต้องการการเริ่มต้นของตัวเอง.

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

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

API Reference: AuthV4.setup

 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 {
            // การเริ่มต้นล้มเหลว 
        }
    });

API Reference: AuthV4::setup

 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 {
            // การเริ่มต้นล้มเหลว 
        }
    });

API Reference: com.hive.AuthV4.setup

 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 {    
                // การเริ่มต้นล้มเหลว 
            } 
        } 
    })

API Reference: com.hive.AuthV4.setup

 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 {    
                // การเริ่มต้นล้มเหลว 
            } 
        } 
    });

API Reference: HIVEAuthV4:setup

 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 {    
            // การเริ่มต้นล้มเหลว    
        }    
    }

API Reference: HIVEAuthV4:setup

 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 {
                    // การเริ่มต้นล้มเหลว
            }
    }));


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

ชื่อฟิลด์ คำอธิบาย ตัวอย่าง
isAutoSignIn ว่าการเข้าสู่ระบบอัตโนมัติเป็นไปได้หรือไม่ true
did รหัสประจำตัวแอปที่สร้างขึ้นเมื่อทำการติดตั้งแอป ใช้เพื่อระบุแอปที่มีประเภทเดียวกัน 123456789
providerTypeList รายการของ IdP ที่แอปปัจจุบันจัดเตรียมไว้ จำเป็นต้องใช้เมื่อกำหนดค่า การปรับแต่งการเข้าสู่ระบบแบบชัดเจน หรือ ข้อมูลสถานะการเชื่อมต่อ IdP ProviderType.FACEBOOK
ProviderType.HIVE
Note

Hive Console > App Center > Project Management เมื่อสถานะของโครงการเป็น บริการสิ้นสุด การเรียกใช้ AuthV4.setup จะส่งคืนรหัสข้อผิดพลาด.

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

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

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


ภาพด้านล่างแสดงให้เห็นถึงกระบวนการทำงานที่ SDK ดำเนินการภายในเมื่อ AuthV4.setup ถูกเรียกใช้.

Note

ป๊อปอัปการติดตามความโปร่งใสของแอป iOS จะแสดงขึ้นหลังจากที่แสดงป๊อปอัปการตกลงเงื่อนไขและผู้ใช้ได้ทำการตกลงเงื่อนไขแล้ว