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

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

หลังจากการเริ่มต้น 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 ก่อนที่จะสร้างแอป รายการที่จำเป็นต้องกรอก และรายการที่ไม่จำเป็นจะกรอกตามต้องการ หากคุณไม่กรอกรายการที่ไม่จำเป็น 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