ทุกเครื่องยนต์
ไม่ว่าจะเป็นเอนจินการพัฒนา (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>