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

คลาส 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 console และตั้งค่านี้เป็น `true` ก่อนเริ่มต้น Hive SDK หากไม่ต้องการใช้ COPPA ageGateU13 คุณต้องลงทะเบียนข้อกำหนดและเงื่อนไขอื่นที่ไม่ใช่ข้อกำหนดและเงื่อนไข COPPA ใน Hive console และตั้งค่านี้เป็น `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`

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