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

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

ยูนิตี้
- แอนดรอยด์
  - ยูนิตี้ 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`

Note

เมื่อใช้ COPPA ageGateU13 จะสามารถแสดงเฉพาะ ป๊อปอัพขอความยินยอมต่อข้อกำหนดในการให้บริการแบบ device เท่านั้น เมื่อใช้ COPPA ageGateU13 หากผู้ใช้ตอบว่าตนมีอายุ 13 ปีขึ้นไปในระหว่างกระบวนการขอความยินยอมต่อข้อกำหนดในการให้บริการ Hive SDK จะไม่ใช้ 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>