การเรียกเนื้อหาเว็บ

การเรียกเนื้อหาเว็บเป็นฟีเจอร์ที่ช่วยให้คุณสามารถดูเนื้อหาเว็บโดยตรงจากเกมโดยการเรียกใช้เบราว์เซอร์ในเกม, เว็บวิว, หรือเบราว์เซอร์ภายนอก

ผู้ใช้สามารถดูเนื้อหาเว็บโดยการเรียกใช้เบราว์เซอร์ในเกมหรือมุมมองเว็บที่เหมาะสมกับสภาพแวดล้อมของแต่ละเกมโดยไม่ต้องออกจากเกม นอกจากนี้ เกมยังสามารถใช้เนื้อหาเว็บต่างๆ ได้อย่างยืดหยุ่น เพิ่มประสบการณ์ผู้ใช้

การเรียกเนื้อหาเว็บสามารถดำเนินการได้ด้วยอินเทอร์เฟซต่อไปนี้ขึ้นอยู่กับสภาพแวดล้อมของเกม:

เปิดด้วยเบราว์เซอร์ในเกม
เปิดด้วยเว็บวิวในเกม
เปิดด้วยเบราว์เซอร์ภายนอก

Note

สำหรับรายละเอียดเพิ่มเติมเกี่ยวกับ 'การเปิดเบราว์เซอร์ภายในเกม' โปรดดูที่เอกสาร Custom tabs สำหรับ Android และเอกสาร SFSafariViewController สำหรับ iOS.

เปิดด้วยเบราว์เซอร์ในเกม¶

เรียกเนื้อหาเว็บภายนอกผ่านเบราว์เซอร์ในเกมโดยไม่ต้องเปิดเบราว์เซอร์แยกต่างหาก。

Note

'เปิดด้วยเบราว์เซอร์ในเกม' รองรับเฉพาะในสภาพแวดล้อมเกมมือถือในขณะนี้

คุณสมบัติการกำหนดค่า¶

ฟีเจอร์การตั้งค่า¶

'เปิดด้วยเบราว์เซอร์ในเกม' ถูกนำไปใช้โดยใช้พารามิเตอร์ 'InAppBrowserParam`

InAppBrowserParam ฟีเจอร์และการตั้งค่าเริ่มต้นของพารามิเตอร์มีดังนี้:

ฟีเจอร์	คำอธิบาย	ค่าเริ่มต้น
NavigationColor	ระบุสีของพื้นที่นำทางด้านบน	สีเริ่มต้นของ OS
ButtonColor (เฉพาะ iOS)	ระบุสีของปุ่มในพื้นที่นำทางด้านบน	สีเริ่มต้นของ OS
UrlBarHiding	ซ่อนพื้นที่แสดง URL ด้านบนเมื่อเกิดเหตุการณ์เลื่อน	true
AutoRedirectToExternalBrowser (เฉพาะ Android)	สนับสนุนการเชื่อมต่อเบราว์เซอร์ภายนอกโดยอัตโนมัติเมื่อแอปเบราว์เซอร์เริ่มต้นของอุปกรณ์ไม่รองรับ	true

ตัวอย่างโค้ด¶

InAppBrowserParam ตัวอย่างโค้ดสำหรับ 'การเปิดด้วยเบราว์เซอร์ในเกม' มีดังนี้:

Unity®Unreal EngineC++JavaKotlinสวิฟต์Objective-C

using hive;

InAppBrowserParam param = new InAppBrowserParam.Builder("https://developers.withhive.com/")
                                                .setNavigationColor("#3891f0")
                                                .setButtonColor("#ffffff")
                                                .setUrlBarHiding(true)
                                                .setAutoRedirectToExternalBrowser(true)
                                                .build();

    PlatformHelper.showInAppBrowser(param, (ResultAPI result) => {
            if (result.isSuccess()) {
                    // API 호출 성공
            }
    });

#include "HivePlatformHelper.h"

FString URL = TEXT("https://developers.withhive.com/");
FHiveInAppBrowserParam Param(URL);
Param.NavigationColor = TEXT("3891f0");
Param.ButtonColor = TEXT("#FFFFFF");
Param.UrlBarHiding = true;
Param.AutoRedirectToExternalBrowser = true;

FHivePlatformHelper::ShowInAppBrowser(Param, FHivePlatformHelperOnShowInAppBrowserDelegate::CreateLambda([this](const FHiveResultAPI& Result) {
        if (Result.IsSuccess()) {
                // API 호출 성공
        }
}));

    #include <HIVE_SDK_Plugin/HIVE_CPP.h>
    using namespace std;
    using namespace hive;

    InAppBrowserParam *param = new InAppBrowserParam("https://developers.withhive.com/");
    param->navigationColor = "3891f0";
    param->buttonColor = "#ffffff";
    param->urlBarHiding = true;
    param->autoRedirectToExternalBrowser = true;

    PlatformHelper::showInAppBrowser(*param, [=](ResultAPI const & result) {
            if (result.isSuccess()) {
                    // API 호출 성공
            }
    });

    import com.hive.PlatformHelper;
    import com.hive.ResultAPI;

    PlatformHelper.InAppBrowserParam param = new PlatformHelper.InAppBrowserParam.Builder("https://developers.withhive.com/")
                                    .setNavigationColor("#3891f0")
                                    .setUrlBarHiding(true)
                                    .setAutoRedirectToExternalBrowser(true)
                                    .build();

    PlatformHelper.showInAppBrowser(param, result -> {
            if (result.isSuccess()) {
            // API call successful

    });

import com.hive.PlatformHelper;
import com.hive.ResultAPI;

val param = PlatformHelper.InAppBrowserParam.Builder("https://developers.withhive.com/")
                                        .setNavigationColor("#3891f0")
                                        .setUrlBarHiding(true)
                                        .setAutoRedirectToExternalBrowser(true)
                                        .build()

PlatformHelper.showInAppBrowser(param, object : PlatformHelper.InAppBrowserListener {
        override fun onInAppBrowser(result: ResultAPI) {
                if (result.isSuccess) {
                        // API เรียกสำเร็จ
                }
        }
})

import HIVEService

let inAppBrowserParam = InAppBrowserParam.Builder(url: "https://developers.withhive.com/")
                                                .setNavigationColor("#3891f0")
                                                .setButtonColor("#ffffff")
                                                .setUrlBarHiding(true)
                                                .setAutoRedirectToExternalBrowserbuild(true)
                                                .build()

PlatformHelperInterface.showInAppBrowser(inAppBrowserParam) { resultAPI in
    if result.isSuccess() {
                // การเรียก API สำเร็จ
        }
};

#import <HIVEService/HIVEService-Swift.h>

HiveInAppBrowserParamBuilder *builder = [[HiveInAppBrowserParamBuilder alloc] initWithUrl: @"https://developers.withhive.com/"];
HiveInAppBrowserParam *inAppBrowserParam = [[[[[builder setNavigationColor: @"#3891f0"]
                                                        setButtonColor: @"#ffffff"]
                                                        setUrlBarHiding: @YES]
                                                        setAutoRedirectToExternalBrowser: @YES]
                                                        build];

[HIVEPlatformHelper showInAppBrowser: inAppBrowserParam handler: ^(HIVEResultAPI *result) {
        if ([result isSuccess]) {
                // API 호출 성공
        }
}];

เปิดด้วยเว็บวิวในเกม¶

เรียกเนื้อหาเว็บโดยการเปิดเว็บวิวในเกม

ฟังก์ชันการตั้งค่า¶

'เปิดด้วยเว็บวิวในเกม' ถูกนำไปใช้โดยใช้พารามิเตอร์ InAppWebViewParam พารามิเตอร์ useUserSession ที่จัดเตรียมโดยวัตถุ InAppWebViewParam สามารถส่งเซสชันการเข้าสู่ระบบในแอปไปยังเว็บวิว และ postData สามารถส่งข้อมูลเพิ่มเติมที่นักพัฒนาแอปต้องการได้

InAppWebViewParam ฟีเจอร์ของพารามิเตอร์, การตั้งค่าเริ่มต้น, และข้อกำหนดมีดังนี้:

ฟีเจอร์	คำอธิบาย	ค่าเริ่มต้น	จำเป็น
postData	ข้อมูลที่มีข้อมูลเพิ่มเติมที่จะถูกส่งโดยนักพัฒนาแอป ใช้เมื่อมีข้อมูลเพิ่มเติมที่จะแสดงในเว็บวิว	null	X
useUserSession	รวมข้อมูลเซสชันการเข้าสู่ระบบ รวม `player_id` และ `player_token` ในรูปแบบ JSON `postData`	false	X
useGameWindow	ฟีเจอร์เฉพาะ Android ที่แสดง WebView ในหน้าต่างปัจจุบัน ไม่หยุดชะงัก และการตั้งค่า `HiveTheme` และ `HiveOrientation` จะถูกละเลย	false	X

Warning

เมื่อใช้ useUserSession ข้อมูล postData จะต้องอยู่ในรูปแบบ JSON.

ตัวอย่างโค้ด¶

InAppWebViewParam ตัวอย่างโค้ดสำหรับ 'เปิดด้วยเว็บวิว' มีดังนี้:

Unity®Unreal EngineC++จาวาKotlinSwiftObjective-C

using hive;

InAppWebViewParam param = new InAppWebViewParam.Builder("https://developers.withhive.com/")
                                                .setUseUserSession(true)
                                                .setUseGameWindow(true)
                                                .build();

    PlatformHelper.showInAppWebView(param, (ResultAPI result) => {
            if (result.isSuccess()) {
                    // API call successful
            }
    });

#include "HivePlatformHelper.h"

FString URL = TEXT("https://developers.withhive.com/");
FHiveInAppWebViewParam Param(URL);
Param.UseUserSession = true;
Param.UseGameWindow = true;

FHivePlatformHelper::ShowInAppWebView(Param, FHivePlatformHelperOnShowInAppWebViewDelegate::CreateLambda([this](const FHiveResultAPI& Result) {
        if (Result.IsSuccess()) {
                // API call successful
        }
}));

#include <HIVE_SDK_Plugin/HIVE_CPP.h>
using namespace std;
using namespace hive;

InAppWebViewParam *param = new InAppWebViewParam("https://developers.withhive.com/");
param->useUserSession = true;
param->useGameWindow = true;

PlatformHelper::showInAppWebView(*param, [=](ResultAPI const & result) {
        if (result.isSuccess()) {
                // API call successful
        }
});

import com.hive.PlatformHelper;
import com.hive.ResultAPI;

PlatformHelper.InAppWebViewParam param = new PlatformHelper.InAppWebViewParam.Builder("https://developers.withhive.com/")
                                .setUseUserSession(true)
                                .setUseGameWindow(true)
                                .build();

PlatformHelper.showInAppWebView(param, result -> {
        if (result.isSuccess()) {
                // API call successful
        }     
});

import com.hive.PlatformHelper;
import com.hive.ResultAPI;

val param = PlatformHelper.InAppWebViewParam.Builder("https://developers.withhive.com/")
                                        .setUseUserSession(true)
                                        .setUseGameWindow(true)
                                        .build()

PlatformHelper.showInAppWebView(param, object : PlatformHelper.InAppWebViewListener {
        override fun onInAppWebView(result: ResultAPI) {
                if (result.isSuccess) {
                        // การเรียก API สำเร็จ
                }
        }
})

import HIVEService

let inAppWebViewParam = InAppWebViewParam.Builder(url: "https://developers.withhive.com/")
                                                .setUseUserSession(true)
                                                .setUseGameWindow(true)
                                                .build()

PlatformHelperInterface.showInAppWebView(inAppWebViewParam) { resultAPI in
    if result.isSuccess() {
                // API call successful
        }
};

#import <HIVEService/HIVEService-Swift.h>

HiveInAppWebViewParamBuilder *builder = [[HiveInAppWebViewParamBuilder alloc] initWithUrl: @"https://developers.withhive.com/"];
HiveInAppWebViewParam *inAppWebViewParam = [[[builder setUseUserSession: @YES]
                                                        setUseGameWindow: @YES]
                                                        build];

[HIVEPlatformHelper showInAppWebView: inAppWebViewParam handler: ^(HIVEResultAPI *result) {
        if ([result isSuccess]) {
                // API call successful
        }
}];

เปิดด้วยเบราว์เซอร์ภายนอก¶

เรียกเนื้อหาเว็บโดยการเชื่อมต่อเบราว์เซอร์ภายนอกที่แยกต่างหากจากเกม

Note

'เปิดด้วยเบราว์เซอร์ภายนอก' รองรับเฉพาะในสภาพแวดล้อมเกม PC และมีให้บริการตั้งแต่ Hive SDK v4 Windows 25.1.0 ขึ้นไป.

ฟีเจอร์การกำหนดค่า¶

OpenBrowserParam ถูกใช้เพื่อเรียกเบราว์เซอร์ภายนอก และคุณสามารถตั้งค่าเพิ่มเติมตัวเลือก useIncognitoMode เพื่อใช้โหมดไม่ระบุตัวตนได้

'เปิดด้วยเบราว์เซอร์ภายนอก' ถูกนำไปใช้โดยใช้พารามิเตอร์ OpenBrowserParam คุณสามารถตั้งค่าตัวเลือกโหมดไม่ระบุตัวตนด้วยพารามิเตอร์ useIncognitoMode

OpenBrowserParam ฟีเจอร์และข้อกำหนดของพารามิเตอร์มีดังนี้:

ฟีเจอร์	คำอธิบาย	จำเป็น
url	ข้อมูล URL ที่ใช้สำหรับการเรียกดูจากเบราว์เซอร์ภายนอก	ใช่
useIncognitoMode	* true: เรียกใช้เบราว์เซอร์โหมดไม่ระบุตัวตน * false: เรียกใช้เบราว์เซอร์โหมดปกติ	ใช่

ตัวอย่างโค้ด¶

OpenBrowserParam ตัวอย่างโค้ดสำหรับ 'เปิดด้วยเบราว์เซอร์ภายนอก' มีดังนี้:

Unity®Unreal EngineC++

using hive;

OpenBrowserParam param = new OpenBrowserParam.Builder("https://developers.withhive.com/")
                                                .setUseIncognito(true)
                                                .build();

PlatformHelper.openBrowser(param);

#include "HivePlatformHelper.h"

FString URL = TEXT("https://developers.withhive.com/");
FHiveOpenBrowserParam Param(URL);
Param.useIncognitoMode = true;

FHivePlatformHelper::openBrowser(Param);

#include <HIVE_SDK_Plugin/HIVE_CPP.h>
using namespace std;
using namespace hive;

OpenBrowserParam *param = new OpenBrowserParam("https://developers.withhive.com/");
param->useIncognitoMode = true;

PlatformHelper::openBrowser(*param);