คลาสการตั้งค่า¶

คลาส Configuration ช่วยให้คุณ ดึงข้อมูล (get) หรือปรับเปลี่ยน (set) ค่า configuration ขณะที่แอปกำลังทำงานอยู่ ตัวอย่างเช่น คุณสามารถใช้วิธี 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: 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 กับ SDK ของ Hive คุณต้องลงทะเบียนข้อกำหนดและเงื่อนไข COPPA ในคอนโซล Hive และตั้งค่านี้เป็น `true` ก่อนที่จะเริ่มต้น SDK ของ Hive หากไม่ต้องการใช้ COPPA ageGateU13 คุณต้องลงทะเบียนข้อกำหนดและเงื่อนไขอื่นที่ไม่ใช่ข้อกำหนดและเงื่อนไข COPPA ในคอนโซล Hive และตั้งค่านี้เป็น `false` ก่อนที่จะเริ่มต้น SDK ของ Hive `true`: ใช้ COPPA ageGateU13 กับ SDK ของ Hive `false`: ไม่ใช้ COPPA ageGateU13 กับ SDK ของ Hive	X	`false`
agreementDetermineBase	กำหนดเกณฑ์ในการขอความยินยอมต่อข้อกำหนดและเงื่อนไข คุณสามารถเลือก `device` หรือ `account` โดยค่าเริ่มต้นคือ `device` หากคุณเลือก `device` ป๊อปอัพขอความยินยอมต่อข้อกำหนดและเงื่อนไขจะถูกแสดงในระหว่างขั้นตอนการเริ่มต้น `AuthV4.setup()` และจะได้รับความยินยอมเพียงครั้งเดียวตามอุปกรณ์ เมื่อได้รับความยินยอมตามอุปกรณ์แล้ว จะไม่ขอความยินยอมต่อข้อกำหนดและเงื่อนไขอีกแม้ว่าผู้ใช้จะเข้าสู่ระบบด้วยบัญชีอื่นบนอุปกรณ์เดียวกัน คุณสามารถใช้ `resetAgreement()` เพื่อล้างบันทึกความยินยอมต่อข้อกำหนดและเงื่อนไข หากคุณเลือก `account` ป๊อปอัพขอความยินยอมต่อข้อกำหนดและเงื่อนไขจะถูกแสดงในระหว่างการเข้าสู่ระบบ และจะได้รับความยินยอมเพียงครั้งเดียวต่อ PlayerId นี้สามารถใช้ได้เมื่อไม่ใช้ COPPA ageGateU13 คุณไม่สามารถใช้ `resetAgreement()` เพื่อล้างบันทึกความยินยอมต่อข้อกำหนดและเงื่อนไขได้ เครื่องมือการติดตามการตลาดจะทำงานหลังจากได้รับความยินยอมต่อข้อกำหนดและเงื่อนไข	X	`device`
chatConnectionTimeout	ระยะเวลาหมดเวลาสำหรับคำขอการเชื่อมต่อใน Hive chat (เป็นวินาที)	X	`60` (หน่วย: วินาที)

Note

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

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

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

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