ข้ามไปที่เนื้อหา

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

ไม่ว่าจะเป็นเอนจินการพัฒนา (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
    • 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
  • Android: ชื่อแพ็คเกจ
  • iOS: ID แพ็คเกจ
  • Windows: ID แอปพลิเคชัน
zone Android, iOS, Windows เซิร์ฟเวอร์ที่ Hive ไคลเอนต์จะเชื่อมต่อ
  • real: เซิร์ฟเวอร์การผลิต
  • sandbox: เซิร์ฟเวอร์ทดสอบ
X `real`
useLog Android, iOS, Windows เปิดใช้งานการบันทึกสำหรับการดำเนินการภายในของ Hive ไคลเอนต์หรือไม่ เมื่อเปิดใช้งานการบันทึก บันทึกจะถูกส่งออกไปยังหน้าจอเครื่องมือพัฒนา
  • true: เปิดใช้งานการบันทึก
  • false: ปิดการบันทึก
X `false`
ageGateU13 Android, iOS, Windows สถานะการสมัคร COPPA ageGateU13 เพื่อใช้ COPPA ageGateU13 กับ Hive SDK คุณต้องลงทะเบียนเงื่อนไข COPPA ใน Hive คอนโซลและตั้งค่านี้เป็น true ก่อนที่จะเริ่มต้น Hive SDK หากคุณไม่ต้องการใช้ COPPA ageGateU13 คุณต้องลงทะเบียนเงื่อนไขอื่นที่ไม่ใช่ COPPA ใน Hive คอนโซลและตั้งค่านี้เป็น false ก่อนที่จะเริ่มต้น Hive SDK
  • true: ใช้ COPPA ageGateU13 กับ HiveSDK
  • false: ไม่ใช้ COPPA ageGateI13 กับ HiveSDK
X `false`
hiveOrientation Android, iOS, Windows UI ของ Hive SDK จะแสดงตามการตั้งค่าทิศทางของอุปกรณ์
  • all: แสดงตามทิศทางแนวนอนและแนวตั้ง
  • portrait: แสดงในโหมดแนวตั้ง
  • landscape: แสดงในโหมดแนวนอน
  • undefined: ปฏิบัติตามการตั้งค่าแอปเกม
X 'undefined'
channel Android, iOS, Windows แพลตฟอร์มสำหรับการเข้าสู่ระบบและบริการสนับสนุนในแอปที่ใช้ในแอปเกม หากคุณเข้าสู่ระบบผ่านโซเชียลมีเดียภายนอกหรือใช้การซื้อในแอปผ่าน Hive SDK จะตรงกับ C2S ใช้สำหรับการรวบรวมข้อมูลวิเคราะห์ Hive SDK
  • C2S: แพลตฟอร์ม Hive
  • KAK: Kakao
  • LIN: Line
  • STE: Steam
  • EPI: Epic Store
  • FAS: FastSprint
O `C2S`
ตลาด Android, iOS, Windows นี่คือ ตลาดสำหรับการประมวลผลการซื้อในแอป มันถูกใช้สำหรับการเก็บข้อมูลการวิเคราะห์ Hive SDK
  • GO: Google PlayStore
  • AP: Apple AppStore
  • ON: OneStore
  • AM: Amazon AppStore
  • LE: Com2us Lebi
  • HS: Hive Store
  • GA: Samsung GalaxyStore
  • HU: Huawei AppGallery
O ค่าที่ว่างเปล่า
agreementDetermineBase Android, iOS กำหนดเกณฑ์ในการขอความเห็นชอบต่อเงื่อนไข. คุณสามารถเลือกได้ทั้ง `device` หรือ `account` โดยค่าเริ่มต้นคือ `device`.
  • เมื่อเลือก device จะมีการแสดงป๊อปอัพข้อตกลงเงื่อนไขในระหว่างขั้นตอนการเริ่มต้นของ AuthV4.setup() และจะได้รับความยินยอมตามอุปกรณ์เพียงครั้งเดียว เมื่อได้รับความยินยอมตามอุปกรณ์แล้ว ผู้ใช้จะไม่ถูกถามเพื่อขอความยินยอมอีกเมื่อเข้าสู่ระบบด้วยบัญชีอื่นบนอุปกรณ์เดียวกัน คุณสามารถล้างบันทึกข้อตกลงเงื่อนไขด้วย `resetAgreement()`.
  • เมื่อเลือก account จะมีการแสดงป๊อปอัพข้อตกลงเงื่อนไขในระหว่างการเข้าสู่ระบบและจะได้รับความยินยอมเพียงครั้งเดียวต่อ PlayerId นี้สามารถใช้ได้เฉพาะเมื่อ COPPA ageGateU13 ไม่ถูกนำมาใช้ บันทึกข้อตกลงเงื่อนไขไม่สามารถล้างด้วย `resetAgreement()` เครื่องมือการติดตามการตลาดจะทำงานตั้งแต่เวลาที่มีการข้อตกลงเงื่อนไข.
X `device`
authV1Agreement Android, iOS Hive SDK v1 หรือ Hive SDK C2S การตั้งค่าโมดูลเฉพาะ เลือก UI ของเงื่อนไขที่จะถูกแสดงเป็นการรับรอง v1 หรือ v4 เกมที่ใช้ Hive SDK v4 จะไม่ตั้งค่านี้และจะไม่ได้รับผลกระทบจากค่าเริ่มต้น
  • true: เงื่อนไขการรับรอง v1
  • false: เงื่อนไขการรับรอง v4
X `true`
unsupportedUAShareType Android การตั้งค่าเฉพาะของ Android เมื่อใช้ ฟีเจอร์การแชร์การเข้าซื้อผู้ใช้ (UA) จะตั้งค่าแอปที่แชร์ซึ่งจะไม่แสดงเป็นไอคอน เป้าหมายที่กำหนดจะไม่แสดงไอคอนใน UI
  • SMS
  • URL
  • KAKAO
  • LINE
  • WHATSAPP
  • FACEBOOK
  • MESSENGER
  • WECHAT
X ค่าที่ว่างเปล่า
httpConnectTimeout Android, iOS, Windows ระยะเวลาที่หมดเวลา (เป็นวินาที) สำหรับการเชื่อมต่อ HTTP ที่ใช้ภายในโดย Hive client
  • ค่าเริ่มต้นถูกตั้งไว้ที่ 8 วินาที และการเปลี่ยนแปลงค่าถูกห้ามเว้นแต่ในกรณีพิเศษ.
X `8` (หน่วย: วินาที)
httpReadTimeout Android, iOS, Windows ระยะเวลา HTTP Read timeout (วินาที) ที่ใช้ภายในโดย Hive client.
  • ค่าปริยายตั้งไว้ที่ 8 วินาที และการเปลี่ยนแปลงค่านี้ถูกห้ามเว้นแต่ในกรณีพิเศษ.
X `8` (หน่วย: วินาที)
usePrivateBrowsingForAuth Windows กำหนดว่าจะใช้โหมดไม่ระบุตัวตนระหว่างการตรวจสอบสิทธิ์การเข้าสู่ระบบ Google หรือไม่
  • true: ใช้การตรวจสอบสิทธิ์ในโหมดไม่ระบุตัวตน.
  • false: ใช้การตรวจสอบสิทธิ์ในโหมดปกติ.
รองรับเฉพาะใน PC SDK.
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>