ทุกเครื่องยนต์

ไม่ว่าจะเป็นเอนจินการพัฒนา (Unity, Unreal, ...) และแพลตฟอร์ม (Android, iOS, ...) การตั้งค่า Hive SDK จะถูกกำหนดในไฟล์ hive_config.xml ก่อนที่จะสร้างแอป ดังนั้น ในการใช้ Hive SDK คุณต้องสร้างไฟล์ hive_config.xml ใหม่ ป้อนเนื้อหา และรวมไว้ในโปรเจกต์แอปของคุณ การตั้งค่าในไฟล์นี้จะถูกนำไปใช้เมื่อ Hive SDK ถูกเริ่มต้น แนะนำให้กำหนดรายการสถิติต่างๆ ที่ไม่เปลี่ยนแปลงในระหว่างการทำงานไว้ในไฟล์นี้ ไฟล์ควรตั้งอยู่ที่ตำแหน่งต่อไปนี้: <br

ยูนิตี้
- แอนดรอยด์
  - ยูนิตี้ 2021 หรือใหม่กว่า: /Assets/HiveSDK/hive.androidlib/src/main/res/raw/hive_config.xml
  - ยูนิตี้ 2021 หรือก่อนหน้า: /Assets/Plugins/Android/res/raw/hive_config.xml
- iOS
  - /Assets/Plugins/iOS/hive_config.xml
- วินโดว์
  - /Assets/Plugins/Windows/res/hive_config.xml
Unreal Engine
- แอนดรอยด์
  - /HIVESDK/Source/HIVESDK/ThirdParty/android/resource/res/raw/hive_config.xml
- iOS
  - /HIVESDK/Source/HIVESDK/ThirdParty/iOS/resource/hive_config.xml
- วินโดว์
  - /HIVESDK/Source/HIVESDK/ThirdParty/Windows/config/hive_config.xml
แอนดรอยด์เนทีฟ
- /app/res/raw/hive_config.xml
iOS เนทีฟ
- สร้างไฟล์ hive_config.xml ที่ตำแหน่งที่คุณต้องการและเชื่อมต่อโดยตรงกับโปรเจ็กต์ Xcode ของคุณ.

Hive SDK การตั้งค่าทั่วไป¶

นี่คือรายการที่ต้องป้อนใน hive_config.xml ไม่ว่าจะใช้ฟีเจอร์ SDK ของแบรนด์ Hive ใดก็ตาม รายการที่จำเป็นต้องป้อน และรายการที่เลือกได้จะป้อนตามความจำเป็น หากคุณไม่ป้อนรายการที่เลือกได้ SDK ของ Hive จะทำงานด้วยค่าพื้นฐาน

รายการ	คำอธิบาย	จำเป็น	ค่าเริ่มต้น SDK
appId	รหัสประจำตัวสำหรับการสร้างเกม	X	Android: ชื่อแพ็คเกจเริ่มต้นของแอป, iOS: Bundle ID
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	ภาษาของเกมที่ตั้งค่าใน Hive SDK.	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`
usePrivateBrowsingForAuth	กำหนดว่าจะใช้โหมดลับเมื่อทำการตรวจสอบการเข้าสู่ระบบ Google หรือไม่. `true`: ใช้การตรวจสอบโหมดลับ. `false`: ใช้การตรวจสอบโหมดปกติ. มันทำงานร่วมกับค่าเริ่มต้นของ hive_config.xml และรองรับเฉพาะ PC SDK.	X	`true`

Note

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

Hive การตั้งค่าฟีเจอร์เฉพาะ SDK¶

นี่คือรายการที่ต้องป้อนใน hive_config.xml สำหรับแต่ละฟีเจอร์ SDK ของ Hive ที่คุณจะใช้ ป้อนเฉพาะรายการที่ตรงกับฟีเจอร์ SDK ของ Hive ที่คุณจะใช้ ที่นี่เราจะแนะนำคุณเกี่ยวกับรายการที่ต้องตั้งค่าเมื่อใช้ผลิตภัณฑ์การตรวจสอบสิทธิ์ (การเข้าสู่ระบบด้วย Google) เป็นตัวอย่าง โปรดดูที่หน้า "เริ่มต้นใช้งาน" สำหรับแต่ละฟีเจอร์ SDK ของ Hive เพื่อค้นหาว่ารายการใดที่จำเป็นสำหรับแต่ละฟีเจอร์ SDK ของ Hive

รายการ

คำอธิบาย

ผู้ให้บริการ

ระบุค่าคุณลักษณะสำหรับไลบรารีของบุคคลที่สาม

google

เป็นองค์ประกอบลูกขององค์ประกอบ ผู้ให้บริการ ซึ่งเพิ่มการตั้งค่าที่เกี่ยวข้องกับ Google ที่ใช้เมื่อทำการตรวจสอบสิทธิ์ด้วยการตรวจสอบสิทธิ์ v4 เพื่อดำเนินการเข้าสู่ระบบ Google บนเดสก์ท็อป คุณต้องเพิ่มคุณลักษณะ `clientId` ภายในองค์ประกอบนี้และป้อน Client ID ที่ออกโดย Google Cloud Console เป็นค่าคุณลักษณะ เพื่อดำเนินการเข้าสู่ระบบ Google บน Steam Deck (Hive SDK v4 Unity Windows 22.0.0 หรือใหม่กว่า) คุณต้องเพิ่มคุณลักษณะ `deviceFlowClientId` ภายในองค์ประกอบนี้และป้อน Client ID ที่ออกโดย Google Cloud Console เป็นค่าคุณลักษณะ

การตั้งค่าที่ไม่รองรับ¶

รายการต่อไปนี้คือรายการในไฟล์ hive_config.xml ที่ไม่รองรับอีกต่อไป:

รายการ	คำอธิบาย	หมายเหตุ
exitEventEnabled	exitEvent เป็นเหตุการณ์ที่แจ้งให้ Hive SDK ทราบว่าต้องการให้แอปถูกปิดโดยตรงโดยเกม ไม่ใช่โดย Hive SDK หากค่าของมันเป็น True จะได้รับเหตุการณ์นี้และ Hive SDK จะไม่ปิดแอปเกมโดยตรง หากค่าของมันเป็น False Hive SDK สามารถปิดแอปเกมโดยตรงได้ (+v4.9.0).	เลิกใช้ตั้งแต่ v4.16.4
useCrashReport	ฟีเจอร์เฉพาะสำหรับ iOS ที่ตรวจจับสถานการณ์ทันทีที่แอปจะล่มเนื่องจากข้อผิดพลาดและบันทึกบันทึกการวิเคราะห์ที่รอส่งไปยังเซิร์ฟเวอร์ลงในไฟล์ หากคุณใช้เครื่องมือรายงานข้อผิดพลาดของบุคคลที่สามภายนอกที่มีฟังก์ชันการทำงานที่คล้ายกัน คุณควรปิดการใช้งานโดยตั้งค่าเป็น false เพื่อป้องกันความขัดแย้ง (+v4.16.0).	เลิกใช้ตั้งแต่ v4.16.3

hive_config.xml ตัวอย่าง¶

ด้านล่างนี้คือตัวอย่างของไฟล์ hive_config.xml เมื่อใช้การตรวจสอบสิทธิ์ (การตรวจสอบสิทธิ์ของ Google) และการชำระเงิน (Google Play Store) เปลี่ยน แก้ไข หรือ ลบค่า ตามที่จำเป็นสำหรับฟีเจอร์ Hive SDK ที่คุณต้องการใช้และสภาพแวดล้อมของแอป เนื่องจากแพลตฟอร์ม iOS รองรับการชำระเงินผ่าน Apple AppStore เท่านั้น ให้ตั้งค่าตลาดเป็น AP ในสภาพแวดล้อม Unity iOS

<properties>

    <!-- Hive SDK Common Settings: START -->
    <appId>com.sample.your</appId>

    <gameLanguage>en</gameLanguage>

    <!-- Hive platform server selection. Sandbox is for development, real is for commercial use
        (sandbox, real) -->
    <zone>real</zone>

    <!-- SDK internal operation log usage setting
        (true, false) -->
    <useLog>false</useLog>

    <!-- Company setting
        (C2S: Com2uS, GVI: Com2uS Holdings) -->
    <company>C2S</company>

    <!-- Channel setting
        (C2S: Hive platform) -->
    <channel>C2S</channel>

    <!-- Payment market setting
        (GO: Google Play, LE: Com2us Lebi, AP: Apple App Store) -->
    <market>GO</market>

    <!-- HTTP Connect Timeout time in seconds used internally by Hive SDK
        (Do not change unless there are special circumstances) -->
    <httpConnectTimeout>8</httpConnectTimeout>

    <!-- HTTP Read Timeout time in seconds used internally by Hive SDK
        (Do not change unless there are special circumstances) -->
    <httpReadTimeout>8</httpReadTimeout>

    <agreementDetermineBase>device</agreementDetermineBase>
    <!-- Hive SDK Common Settings: END -->

    <!-- Hive SDK Feature-Specific Settings: START -->
    <!-- Authentication product setting: Using Google authentication -->
    <providers>             
        <google playAppId="123456789012"  clientId="123456789012-abc.apps.googleusercontent.com"  serverClientId="123456789012-abc.apps.googleusercontent.com"  reversedClientId="com.googleusercontent.apps.123456789012-abc"  deviceFlowClientId="331526026701-gn1abq1ev23nqj7rdvvlaamf7ii4f3u9.apps.googleusercontent.com" />
    </providers>
    <!-- Hive SDK Feature-Specific Settings: END -->

</properties>