ทุกเครื่องยนต์
ไม่ว่าจะเป็นเอนจินการพัฒนา (Unity, Unreal, ...) และแพลตฟอร์ม (Android, iOS, ...) การตั้งค่า SDK ของ Hive จะต้องถูกกำหนดในไฟล์ hive_config.xml ที่จุดก่อนที่จะสร้างแอป ดังนั้น ในการใช้ SDK ของ Hive คุณต้องสร้างไฟล์ hive_config.xml ใหม่ ป้อนเนื้อหา และรวมไว้ในโปรเจกต์แอปของคุณ การตั้งค่าในไฟล์นี้จะใช้ที่ จุดเริ่มต้นการใช้งาน SDK ของ Hive แนะนำให้กำหนดรายการคงที่ทั้งหมดที่ไม่เปลี่ยนแปลงในระหว่างการทำงานในไฟล์นี้ ไฟล์ควรอยู่ที่เส้นทางด้านล่าง 
- ยูนิตี้- แอนดรอยด์- ยูนิตี้ 2021 ขึ้นไป: /Assets/HiveSDK/hive.androidlib/src/main/res/raw/hive_config.xml 
- ยูนิตี้ ต่ำกว่า 2021: /Assets/Plugins/Android/res/raw/hive_config.xml 
 
- ยูนิตี้ 2021 ขึ้นไป: 
- 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 การตั้งค่าทั่วไป¶
ไม่ว่าจะใช้ฟีเจอร์ไหนของ SDK Hive มันเป็นสิ่งที่ต้องป้อนใน hive_config.xml สิ่งที่จำเป็นต้องป้อนจะต้องถูกป้อน ขณะที่สิ่งที่ไม่จำเป็นสามารถป้อนได้ตามต้องการ หากไม่ป้อนสิ่งที่ไม่จำเป็น SDK Hive จะทำงานด้วยค่าปริยาย
| รายการ | OS | คำอธิบาย | จำเป็น | ค่าเริ่มต้น SDK | 
|---|---|---|---|---|
| appId | Android, iOS, Windows | ตัวระบุการสร้างเกม | X | 
 | 
| zone | Android, iOS, Windows | เซิร์ฟเวอร์ที่ Hive ไคลเอนต์จะเชื่อมต่อ 
 | X | `real` | 
| useLog | Android, iOS, Windows | เปิดใช้งานการบันทึกสำหรับการดำเนินการภายในของ Hive ไคลเอนต์หรือไม่ เมื่อเปิดใช้งานการบันทึก บันทึกจะถูกส่งออกไปยังหน้าจอเครื่องมือพัฒนา 
 | X | `false` | 
| ageGateU13 | Android, iOS, Windows | สถานะการสมัคร COPPA ageGateU13 เพื่อใช้ COPPA ageGateU13 กับ Hive SDK คุณต้องลงทะเบียนเงื่อนไข COPPA ใน Hive คอนโซลและตั้งค่านี้เป็น trueก่อนที่จะเริ่มต้น Hive SDK หากคุณไม่ต้องการใช้ COPPA ageGateU13 คุณต้องลงทะเบียนเงื่อนไขอื่นที่ไม่ใช่ COPPA ใน Hive คอนโซลและตั้งค่านี้เป็นfalseก่อนที่จะเริ่มต้น Hive SDK
 | X | `false` | 
| hiveOrientation | Android, iOS, Windows | UI ของ Hive SDK จะแสดงตามการตั้งค่าทิศทางของอุปกรณ์ 
 | X | 'undefined' | 
| channel | Android, iOS, Windows | แพลตฟอร์มสำหรับการเข้าสู่ระบบและบริการสนับสนุนในแอปที่ใช้ในแอปเกม หากคุณเข้าสู่ระบบผ่านโซเชียลมีเดียภายนอกหรือใช้การซื้อในแอปผ่าน Hive SDK จะตรงกับ C2S ใช้สำหรับการรวบรวมข้อมูลวิเคราะห์ Hive SDK 
 | O | `C2S` | 
| ตลาด | Android, iOS, Windows | นี่คือ ตลาดสำหรับการประมวลผลการซื้อในแอป มันถูกใช้สำหรับการเก็บข้อมูลการวิเคราะห์ Hive SDK 
 | O | ค่าที่ว่างเปล่า | 
| agreementDetermineBase | Android, iOS | กำหนดเกณฑ์ในการขอความเห็นชอบต่อเงื่อนไข. คุณสามารถเลือกได้ทั้ง `device` หรือ `account` โดยค่าเริ่มต้นคือ `device`. 
 | X | `device` | 
| authV1Agreement | Android, iOS | Hive SDK v1 หรือ Hive SDK C2S การตั้งค่าโมดูลเฉพาะ เลือก UI ของเงื่อนไขที่จะถูกแสดงเป็นการรับรอง v1 หรือ v4 เกมที่ใช้ Hive SDK v4 จะไม่ตั้งค่านี้และจะไม่ได้รับผลกระทบจากค่าเริ่มต้น 
 | X | `true` | 
| unsupportedUAShareType | Android | การตั้งค่าเฉพาะของ Android เมื่อใช้ ฟีเจอร์การแชร์การเข้าซื้อผู้ใช้ (UA) จะตั้งค่าแอปที่แชร์ซึ่งจะไม่แสดงเป็นไอคอน เป้าหมายที่กำหนดจะไม่แสดงไอคอนใน UI 
 | X | ค่าที่ว่างเปล่า | 
| httpConnectTimeout | Android, iOS, Windows | ระยะเวลาที่หมดเวลา (เป็นวินาที) สำหรับการเชื่อมต่อ HTTP ที่ใช้ภายในโดย Hive client 
 | X | `8` (หน่วย: วินาที) | 
| httpReadTimeout | Android, iOS, Windows | ระยะเวลา HTTP Read timeout (วินาที) ที่ใช้ภายในโดย Hive client. 
 | X | `8` (หน่วย: วินาที) | 
| usePrivateBrowsingForAuth | Windows | กำหนดว่าจะใช้โหมดไม่ระบุตัวตนระหว่างการตรวจสอบสิทธิ์การเข้าสู่ระบบ Google หรือไม่ 
 | X | true | 
Note
เมื่อใช้ COPPA ageGateU13 จะสามารถแสดงเฉพาะ ป๊อปอัปการยินยอมตามอุปกรณ์ เท่านั้น.
 เมื่อใช้ COPPA ageGateU13 หากผู้ใช้ตอบว่าตนมีอายุ 13 ปีขึ้นไปในระหว่างกระบวนการยินยอม Hive SDK จะไม่ใช้ COPPA ageGateU13 กับผู้ใช้นั้น อย่างไรก็ตาม ค่าใน hive_config.xml (true) จะไม่เปลี่ยนแปลง
Hive การตั้งค่าฟีเจอร์ SDK¶
การตั้งค่าสำหรับฟีเจอร์ SDK ของ Hive ที่คุณต้องการใช้ เช่น การตรวจสอบสิทธิ์ การเรียกเก็บเงิน และการระบุแหล่งที่มาของการตลาด ป้อนเฉพาะรายการที่ตรงกับฟีเจอร์ SDK ของ Hive ที่คุณจะใช้ใน hive_config.xml สำหรับรายละเอียดเพิ่มเติม โปรดดูที่หน้าการเตรียมการของคู่มือผู้พัฒนาฟีเจอร์ SDK ของ Hive แต่ละรายการตามที่แสดงด้านล่าง
การกำหนดค่าที่ไม่รองรับ¶
hive_config.xml รายการในไฟล์มีดังนี้ ซึ่งไม่สนับสนุนอีกต่อไป
| รายการ | คำอธิบาย | หมายเหตุ | 
|---|---|---|
| usePush | ตั้งค่าว่าจะใช้การแจ้งเตือนหรือไม่ | เลิกใช้ตั้งแต่ v4.16.2 | 
| permissions | Android นี่คือการตั้งค่าที่เฉพาะเจาะจงสำหรับ Android ที่ควบคุมว่าการอนุญาตของ Android ที่จัดการโดย HiveSDK ถูกใช้หรือไม่ การตั้งค่า permissionsช่วยให้ควบคุมการเข้าถึงที่เก็บข้อมูลภายนอกผ่านการตั้งค่าsdwrite | เลิกใช้ตั้งแต่ v4.16.2 | 
| useCrashReport | iOS นี่คือฟีเจอร์เฉพาะสำหรับ iOS ที่ตรวจจับสถานการณ์ก่อนที่แอปจะล่มเนื่องจากข้อผิดพลาดและบันทึกบันทึกการวิเคราะห์ที่รอส่งไปยังเซิร์ฟเวอร์เป็นไฟล์ หากใช้ผู้รายงานข้อผิดพลาดของบุคคลที่สามภายนอกที่มีฟังก์ชันการทำงานที่คล้ายกัน ควรตั้งค่าเป็น false เพื่อปิดการใช้งานเพื่อป้องกันการชนกัน (+v4.16.0) | เลิกใช้ตั้งแต่ v4.16.3 | 
| exitEventEnabled | Android iOS exitEvent ระบุว่าเกมควรออกจากแอปโดยตรงแทนที่จะออกจาก Hive SDK หากค่าดังกล่าวเป็น True เหตุการณ์นี้จะถูกส่ง และในขณะนี้ Hive SDK จะไม่ออกจากแอปเกมโดยตรง หากค่าดังกล่าวเป็น False Hive SDK สามารถออกจากแอปเกมโดยตรงได้ (+v4.9.0). | เลิกใช้ตั้งแต่ v4.16.4 | 
| company | Android iOS Windows ตั้งชื่อบริษัทที่เผยแพร่เกม | เลิกใช้ตั้งแต่ v4.23.0 | 
| gameLanguage | Android iOS นี่คือภาษาของเกมที่ตั้งค่าใน Hive SDK | เลิกใช้ตั้งแต่ v4 25.2.0 | 
hive_config.xml ตัวอย่าง¶
ด้านล่างนี้คือตัวอย่างของไฟล์ hive_config.xml เมื่อใช้การตรวจสอบสิทธิ์ (การตรวจสอบสิทธิ์ของ Google) และการชำระเงิน (Google Play Store) กรุณาเปลี่ยน แก้ไข หรือ ลบค่า ตามคุณสมบัติของ Hive SDK ที่คุณต้องการใช้และสภาพแวดล้อมของแอป แพลตฟอร์ม iOS รองรับการชำระเงินผ่าน Apple AppStore เท่านั้น ดังนั้นในสภาพแวดล้อม Unity iOS ให้ตั้งค่าตลาดเป็น AP
<properties>
    <!-- Hive SDK Common Settings: START -->
    <!-- Set unique game build identifier -->
    <appId>com.sample.your</appId>
    <!-- Select Hive platform server. sandbox for development, real for production
        (sandbox, real) -->
    <zone>real</zone>
    <!-- Set whether to use SDK internal operation logs
        (true, false) -->
    <useLog>false</useLog>
    <!-- Set whether to apply ageGateU13
        (true, false) -->
    <ageGateU13>false</ageGateU13>
    <!-- Hive Orientation setting -->
    <hiveOrientation>landscape</hiveOrientation>
    <!-- Channel setting (login and in-app support service platform)
        (C2S: Hive platform) -->
    <channel>C2S</channel>
    <!-- Payment market setting (GO: Google Play, LE: Com2us Lebi, AP: Apple App Store) -->
    <market>GO</market>
    <!-- Set criteria for receiving agreement to terms
        (device, account) -->
    <agreementDetermineBase>false</agreementDetermineBase>
    <!-- Set terms exposure design (not set for SDK v4)
        (true, false) -->
    <!-- <authV1Agreement>device</authV1Agreement> -->
    <!-- Set sharing apps not to be displayed for Promotion UA Share (Android Only) -->
    <unsupportedUAShareType>
        <value>SMS</value>
        <value>URL</value>
    </unsupportedUAShareType>
    <!-- Set HTTP Connect Timeout used internally by Hive SDK in seconds
        (Do not change unless in special cases) -->
    <httpConnectTimeout>8</httpConnectTimeout>
    <!-- Set HTTP Read Timeout used internally by Hive SDK in seconds
        (Do not change unless in special cases) -->
    <httpReadTimeout>8</httpReadTimeout>
    <!-- Hive SDK Common Settings: END -->
    <!-- Hive SDK Analytics Settings: START -->
        <!-- Analytics settings, refer to Analytics pre-configuration guide -->
    <!-- Hive SDK Analytics Settings: END -->
    <!-- Hive SDK Feature Settings: START -->
    <providers>             
        <!-- Set authentication product, refer to Authentication pre-configuration guide -->
        <!-- Set billing product, refer to Billing pre-configuration guide -->
        <!-- Set marketing attribution product, refer to Marketing Attribution pre-configuration guide -->
    </providers>
    <!-- Hive SDK Feature Settings: END -->
</properties>