คลาสการกำหนดค่า¶

คลาส Configuration ช่วยให้คุณสามารถ ดึงข้อมูล (get) หรือปรับเปลี่ยน (set) ค่าคอนฟิกูเรชันในขณะที่แอปกำลังทำงานอยู่ ตัวอย่างเช่น คุณสามารถใช้เมธอด getServerId() เพื่อดึงข้อมูลเซิร์ฟเวอร์แอป และเมธอด setServerId() เพื่อปรับเปลี่ยนข้อมูลนั้น

เป็นตัวอย่างของการใช้คลาส Configuration คุณสามารถเปลี่ยนการตั้งค่า zone ของผู้ใช้ไปยังคลาส Configuration ในขณะที่แอปกำลังทำงานอยู่

UnityC++KotlinJavaSwiftObjective-C

API Reference: hive.Configuration.setZone

using hive;  

Configuration.setZone(ZoneType.REAL);

API Reference: hive::Configuration::setZone

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

Configuration::setZone(ZoneType::REAL);

API Reference: Configuration.setZone

import com.hive.Configuration    

Configuration.zone = Configuration.ZoneType.REAL

API Reference: Configuration.setZone

import com.hive.Configuration;    

Configuration.INSTANCE.setZone(Configuration.ZoneType.REAL);

API Reference: ConfigurationInterface.setZone

import HIVEService    

ConfigurationInterface.setZone(.real)

API Reference: HIVEConfiguration:setZone

#import <HIVEService/HIVEService-Swift.h>    

[HIVEConfiguration setZone: HIVEZoneTypeReal];

Note

เมธอด setZone ของคลาส Configuration จะต้องถูกเรียกก่อนที่จะเรียกฟังก์ชัน setup เพื่อให้ทำงานได้อย่างถูกต้อง.

สถานการณ์การใช้งานคลาสการกำหนดค่า¶

คุณต้องเปลี่ยนการตั้งค่า SDK ของ Hive ระหว่างการทำงานของแอปในกรณีต่อไปนี้

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

สะท้อนการตั้งค่าเซิร์ฟเวอร์เกมหรือการตั้งค่าภาษาเกมก่อนที่จะเริ่มต้น SDK Hive

หลังจากการเริ่มต้น Hive SDK ~ ก่อนการตรวจสอบเซิร์ฟเวอร์ป๊อปอัพ¶

นี่คือกรณีเมื่อผู้ใช้เลือกเซิร์ฟเวอร์เกมก่อนที่จะแสดงป๊อปอัพตรวจสอบเซิร์ฟเวอร์หลังจากการเริ่มต้น SDK Hive หลังจากการเริ่มต้น SDK Hive ให้แสดง UI การเลือกเซิร์ฟเวอร์เกมและสะท้อนเซิร์ฟเวอร์เกมที่ผู้ใช้เลือกในการตั้งค่า หลังจากดำเนินการกระบวนการนี้แล้ว ให้แสดงป๊อปอัพตรวจสอบเซิร์ฟเวอร์.

ตัวอย่าง: UI การเลือกเซิร์ฟเวอร์เกม

หลังจากเข้าสู่เกม¶

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

ตัวอย่าง: UI การเลือกภาษาเกม

สถานการณ์อื่น ๆ¶

เปลี่ยนค่าการตั้งค่าที่มีอยู่ในสถานการณ์ต่างๆ เช่น เมื่อข้อมูลเกมเปลี่ยนแปลงเนื่องจากการวางแผนเกมหรือสถานการณ์อื่นๆ

Note

คุณสามารถเปลี่ยนค่าได้ แต่มีบาง รายการที่ไม่สามารถเรียกคืนได้

ตัวอย่างการใช้งานคลาสการกำหนดค่า¶

นี่คือตัวอย่างเพิ่มเติมในการใช้คลาส Configuration

Hive การตั้งค่าธีม¶

คุณสามารถเปิดเผยธีมมืดโดยใช้ Configuration.setHiveTheme

UnityC++KotlinJavaObjective-CSwift

API Reference: hive.Configuration.setHiveTheme

using hive;

Configuration.setHiveTheme(HiveThemeType.hiveLight);
Configuration.setHiveTheme(HiveThemeType.hiveDark);

API Reference: hive::Configuration::setHiveTheme

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

Configuration::setHiveTheme(HiveThemeType::hiveLight);
Configuration::setHiveTheme(HiveThemeType::hiveDark);

API Reference: hiveTheme

import com.hive.Configuration

Configuration.hiveTheme = HiveTheme.hiveLight
Configuration.hiveTheme = HiveTheme.hiveDark

API Reference: Configuration.setHiveTheme

import com.hive.Configuration;

Configuration.INSTANCE.setHiveTheme(Configuration.HiveTheme.HiveLight);
Configuration.INSTANCE.setHiveTheme(Configuration.HiveTheme.HiveDark);

API Reference: HIVEConfiguration:setHiveTheme

#import <HIVEService/HIVEService-Swift.h>

[HIVEConfiguration setHiveTheme: HIVEThemeTypeHiveLight];
[HIVEConfiguration setHiveTheme: HIVEThemeTypeHiveDark];

API Reference: HIVEConfiguration:setHiveTheme

import HIVEService

ConfigurationInterface.setHiveTheme(.hiveLight)
ConfigurationInterface.setHiveTheme(.hiveDark)

คลาสการกำหนดค่าและ hive_config.xml ไฟล์¶

การเปลี่ยนแปลงการตั้งค่าผ่านวิธีการในคลาส Configuration จะเขียนทับค่าที่ตั้งไว้ใน hive_config.xml กล่าวอีกนัยหนึ่ง ค่าที่ตั้งโดยคลาส Configuration จะมีความสำคัญสูงกว่า อย่างไรก็ตาม SDK Hive ใช้ค่าที่ตั้งโดยคลาส Configuration ภายใน และค่าที่มีอยู่ในไฟล์ hive_config.xml จะไม่ถูกเปลี่ยนแปลง

ตัวอย่างเช่น แม้ว่าคุณจะตั้งค่า zone เป็น sandbox ใน hive_config.xml ในการตั้งค่า zone ข้างต้น หากคุณเปลี่ยนค่าดังกล่าวเป็น real โดยใช้คลาส Configuration และเริ่มต้น SDK Hive SDK จะทำงานตาม real อย่างไรก็ตาม zone ใน hive_config.xml จะยังคงเป็น sandbox

คลาสการกำหนดค่าที่ดึงข้อมูลได้เฉพาะการตั้งค่า¶

รายการการกำหนดค่าที่สามารถ เพียง ดึงข้อมูล (get) โดยใช้วิธีการของคลาส Configuration มีดังต่อไปนี้

รายการ	คำอธิบาย
hiveSDKVersion	นี่คือเวอร์ชัน SDK ของ Hive。
referenceSDKVersion	นี่คือเวอร์ชัน SDK ที่ Hive SDK อ้างอิงถึง。
hiveCountry	นี่คือรหัสประเทศที่กำหนดโดยเซิร์ฟเวอร์ Hive SDK。

การตั้งค่าที่สามารถปรับแต่งได้ของคลาสการกำหนดค่า¶

รายการที่สามารถปรับเปลี่ยน (set) โดยใช้วิธีการของคลาส Configuration มีดังนี้ รายการเหล่านี้เป็นรายการเดียวกับ Hive SDK Common Setting Items ที่ถูกตั้งค่าไว้ล่วงหน้าใน hive_config.xml ก่อนที่จะสร้างแอป รายการที่จำเป็นต้องกรอก และรายการที่ไม่จำเป็นจะกรอกตามความต้องการ หากคุณไม่กรอกรายการที่ไม่จำเป็น SDK Hive จะทำงานด้วยค่าตั้งต้น

รายการ	คำอธิบาย	จำเป็น	ค่าเริ่มต้น SDK
appId	นี่คือรหัสประจำตัวการสร้างเกม	X	- Android: ชื่อแพ็คเกจเริ่มต้นของแอป - iOS: Bundle ID
serverId	นี่คือรหัสประจำตัวของแต่ละเซิร์ฟเวอร์เกมที่สามารถตรวจสอบได้เมื่อเกมดำเนินการเซิร์ฟเวอร์ตามภูมิภาค ต้องเขียนตามนโยบายรหัสประจำตัว Hive	O	ว่างเปล่า
zone	นี่คือเซิร์ฟเวอร์ที่ลูกค้า Hive เชื่อมต่อ `real`: เซิร์ฟเวอร์ที่ใช้งาน `sandbox`: เซิร์ฟเวอร์ทดสอบ	X	`REAL`
useLog	นี่คือการเปิดใช้งานการบันทึกสำหรับการดำเนินการภายในของลูกค้า Hive หากคุณเปิดใช้งานการบันทึก จะมีการส่งออกบันทึกไปยังหน้าจอเครื่องมือพัฒนา `true`: เปิดใช้งานการบันทึก `false`: ปิดการบันทึก	X	`false`
company	นี่คือบริษัทเผยแพร่เกม `C2S`: Com2uS Games `GVI`: Com2uS Holdings Games	O	ว่างเปล่า
channel	นี่คือแพลตฟอร์มบริการเข้าสู่ระบบที่ใช้โดยแอปเกม C2S: แพลตฟอร์ม Hive (ค่าเริ่มต้น)	O	`C2S`
market	นี่คือตลาดที่การซื้อในแอปจะถูกชำระเงิน `GO`: Google Play Store `LE`: Com2uS Lebi `AP`: Apple App Store	O	ว่างเปล่า
httpConnectTimeout	นี่คือเวลาหมดเวลา (เป็นวินาที) สำหรับการเชื่อมต่อ HTTP ที่ใช้ภายในลูกค้า Hive ค่าเริ่มต้นถูกตั้งไว้ที่ 8 วินาที และการเปลี่ยนแปลงค่านี้จะถูกห้ามเว้นแต่จะมีสถานการณ์พิเศษ	X	`8`(หน่วย: วินาที)
httpReadTimeout	นี่คือเวลาหมดเวลา (เป็นวินาที) สำหรับการอ่าน HTTP ที่ใช้ภายในลูกค้า Hive ค่าเริ่มต้นถูกตั้งไว้ที่ 8 วินาที และการเปลี่ยนแปลงค่านี้จะถูกห้ามเว้นแต่จะมีสถานการณ์พิเศษ	X	`8`(หน่วย: วินาที)
gameLanguage	นี่คือภาษาของเกมที่ตั้งค่าใน SDK ของ Hive	X	`en`
ageGateU13	นี่คือการใช้ COPPA ageGateU13 หรือไม่ หากต้องการใช้ COPPA ageGateU13 กับ Hive SDK คุณต้องลงทะเบียนข้อกำหนดและเงื่อนไขของ COPPA ใน Hive คอนโซลและตั้งค่านี้เป็น `true` ก่อนที่จะเริ่มต้น Hive SDK หากไม่ต้องการใช้ COPPA ageGateU13 คุณต้องลงทะเบียนข้อกำหนดและเงื่อนไขอื่นที่ไม่ใช่ข้อกำหนดและเงื่อนไขของ COPPA ใน Hive คอนโซลและตั้งค่านี้เป็น `false` ก่อนที่จะเริ่มต้น Hive SDK. `true`: ใช้ COPPA ageGateU13 กับ Hive SDK `false`: ไม่ใช้ COPPA ageGateU13 กับ Hive SDK	X	`false`
agreementDetermineBase	กำหนดเกณฑ์ในการรับความยินยอมต่อข้อกำหนดและเงื่อนไข คุณสามารถเลือก `device` หรือ `account` โดยค่าเริ่มต้นคือ `device`. หากคุณเลือก `device` จะมีการแสดงป๊อปอัพความยินยอมต่อข้อกำหนดและเงื่อนไขในระหว่างขั้นตอนการเริ่มต้น `AuthV4.setup()` และจะได้รับความยินยอมเพียงครั้งเดียวตามอุปกรณ์ เมื่อได้รับความยินยอมตามอุปกรณ์แล้ว จะไม่มีการขอความยินยอมต่อข้อกำหนดและเงื่อนไขแม้ว่าผู้ใช้จะเข้าสู่ระบบด้วยบัญชีอื่นบนอุปกรณ์เดียวกัน คุณสามารถใช้ `resetAgreement()` เพื่อลบบันทึกความยินยอมต่อข้อกำหนดและเงื่อนไขได้ หากคุณเลือก `account` จะมีการแสดงป๊อปอัพความยินยอมต่อข้อกำหนดและเงื่อนไขในระหว่างการเข้าสู่ระบบ และจะได้รับความยินยอมเพียงครั้งเดียวต่อ PlayerId นี้สามารถใช้ได้เมื่อไม่ใช้ COPPA ageGateU13 คุณไม่สามารถใช้ `resetAgreement()` เพื่อลบบันทึกความยินยอมต่อข้อกำหนดและเงื่อนไขได้ เครื่องมือการติดตามการตลาดจะทำงานหลังจากความยินยอมต่อข้อกำหนดและเงื่อนไข	X	`device`
gameControllerEnable	ฟังก์ชันนี้กำหนดว่าจะเปิดใช้งาน 'Game Controller' ใน UI ที่ให้โดย Hive SDK หรือไม่ `true`: เปิดใช้งานฟังก์ชันเกมคอนโทรลเลอร์ `false`: ปิดใช้งานฟังก์ชันเกมคอนโทรลเลอร์ ค่าล่าสุดจะถูกจดจำในไฟล์การตั้งค่า และค่าปัจจุบันสามารถตรวจสอบได้ผ่านฟังก์ชัน `get`.	X	`true`
usePrivateBrowsingForAuth	กำหนดว่าจะใช้โหมดลับเมื่อทำการตรวจสอบสิทธิ์การเข้าสู่ระบบ Google หรือไม่ `true`: ใช้การตรวจสอบสิทธิ์โหมดลับ `false`: ใช้การตรวจสอบสิทธิ์โหมดปกติ มันทำงานกับค่าตั้งต้นของ hive_config.xml และรองรับเฉพาะ PC SDK เท่านั้น	X	`true`

Note

เมื่อใช้ COPPA ageGateU13 จะสามารถแสดงเฉพาะ ป๊อปอัพความยินยอมต่อข้อกำหนดและเงื่อนไขที่อิงตาม device เท่านั้น หากผู้ใช้ตอบว่าพวกเขาอายุ 13 ปีขึ้นไปในระหว่างกระบวนการขอความยินยอมต่อข้อกำหนดและเงื่อนไข Hive SDK จะไม่ใช้ COPPA ageGateU13 กับผู้ใช้คนนั้น อย่างไรก็ตาม ค่าที่ตั้งไว้ใน hive_config.xml (true) จะไม่เปลี่ยนแปลง

รายการที่ไม่รองรับ¶

ต่อไปนี้คือวิธีการในคลาส Configuration ที่ไม่สนับสนุนอีกต่อไป

รายการ	คำอธิบาย	หมายเหตุ
permissions	นี่คือการขออนุญาตตามประเภทอนุญาตหรือไม่ นี่คือฟีเจอร์เฉพาะ Android อนุญาตการเข้าถึงหน่วยความจำภายนอก true: แสดงหน้าต่างขออนุญาต false : ไม่แสดงหน้าต่างขออนุญาต ชื่อแท็ก: sdwrite	เลิกใช้ตั้งแต่ v4.16.3
hivePermissionViewOn	นี่คือการแสดงหรือไม่แสดงป๊อปอัพประกาศอนุญาต SDK Hive `true`: แสดง `false`: ไม่แสดง	เลิกใช้ตั้งแต่ v4.16.2