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

คลาส 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

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

นี่คือกรณีเมื่อผู้ใช้เลือกเซิร์ฟเวอร์เกมก่อนที่จะแสดงป๊อปอัปตรวจสอบเซิร์ฟเวอร์หลังจากการเริ่มต้น 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 ก่อนที่จะสร้างแอป รายการที่จำเป็นต้องกรอกต้องถูกกรอกเข้าไป และรายการที่ไม่จำเป็นจะถูกกรอกตามความต้องการ หากคุณไม่กรอกรายการที่ไม่จำเป็น Hive SDK จะทำงานด้วยค่าปริยาย

รายการ	คำอธิบาย	จำเป็น	ค่าเริ่มต้นของ 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`

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