Unity

hive_config.xml ไฟล์ถูกสร้างขึ้นและรายการภายในไฟล์ถูกกำหนดค่า มีสองวิธีในการสร้างและกำหนดค่าไฟล์ hive_config.xml ใน Hive SDK Unity.

การสร้างไฟล์และการกำหนดค่าทางอัตโนมัติด้วย Unity Hive Config Editor
สร้างและกำหนดค่าไฟล์ด้วยตนเอง

การตั้งค่าแก้ไขการกำหนดค่าของ Unity hive¶

ในสภาพแวดล้อมของ Unity คุณสามารถสร้างไฟล์ hive_config.xml โดยอัตโนมัติและกำหนดค่าใช้ค่าคอนฟิกผ่าน Unity Hive Config Editor

การตั้งค่า OS และเวอร์ชันการตรวจสอบสิทธิ์¶

เลือก Hive > การตั้งค่า Hive (แก้ไขการตั้งค่า) และตั้งค่าค่าที่จำเป็นในหน้าจอ Editor ก่อนอื่นให้ตรวจสอบ OS และ Hive App Id จากนั้นเพื่อใช้การรับรองความถูกต้องของ Google ให้เลือก OS และตั้งค่าในรายการ Google SignIn ภายใต้เมนู Auth.

การตั้งค่าการลงชื่อเข้าใช้ Google¶

ในการใช้การตรวจสอบสิทธิ์ของ Google แบบปกติ ให้ป้อนค่าที่จำเป็นสำหรับรายการ Google SignIn ในเมนู Auth ตามข้อมูลด้านล่าง

ป้อน AppID ที่คุณได้รับในช่อง Google App Id
ป้อนค่าหมายเลขประจำตัวของเว็บแอปพลิเคชันที่คุณได้รับในช่อง Google Server Client ID

Hiveการตั้งค่าคอนฟิก¶

คุณสามารถตั้งค่าค่าต่อไปนี้จากค่าที่กำหนดในไฟล์ hive_config.xml.

<

รายการ	OS	คำอธิบาย	จำเป็น	SDK เริ่มต้น
appId	Android, iOS, Windows	ตัวระบุการสร้างเกม	X	Android: ชื่อแพ็คเกจ iOS: Bundle ID Windows: Application 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 ageGateU13 กับ 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`
market	Android, iOS, Windows	นี่คือตลาดสำหรับการประมวลผลการซื้อในแอป มันถูกใช้สำหรับการเก็บข้อมูลการวิเคราะห์ SDK ของ Hive `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`
unsupportedUAShareType	Android	นี่คือการตั้งค่าสำหรับ Android โดยเฉพาะที่กำหนดว่าแอปแชร์ใดจะไม่แสดงไอคอนเมื่อใช้ฟีเจอร์ การแชร์การได้มาซึ่งผู้ใช้ (UA) ที่ส่งเสริม เป้าหมายที่กำหนดจะไม่แสดงไอคอนใน UI `SMS` `URL` `KAKAO` `LINE` `WHATSAPP` `FACEBOOK` `MESSENGER` `WECHAT`	X	ค่าเว้นว่าง
httpConnectTimeout	Android, iOS, Windows	นี่คือระยะเวลาที่หมดเวลาสำหรับ HTTP Connect (เป็นวินาที) ที่ใช้ภายในโดย Hive client ค่าเริ่มต้นถูกตั้งไว้ที่ 8 วินาที และการเปลี่ยนแปลงค่านี้เป็นสิ่งต้องห้าม เว้นแต่ในกรณีพิเศษ.	X	`8` (หน่วย: วินาที)
httpReadTimeout	Android, iOS, Windows	นี่คือระยะเวลาที่หมดเวลาสำหรับ HTTP Read (เป็นวินาที) ที่ใช้ภายในโดย Hive client ค่าเริ่มต้นถูกตั้งไว้ที่ 8 วินาที และการเปลี่ยนแปลงค่านี้เป็นสิ่งต้องห้าม เว้นแต่ในกรณีพิเศษ.	X	`8` (หน่วย: วินาที)

hive_config.xml การสร้างไฟล์¶

ผู้ตรวจสอบ หลังจากเสร็จสิ้นการตั้งค่า ให้ทำตามขั้นตอนด้านล่างเพื่อสร้างไฟล์ hive_config.xml

Android: คลิกที่ปุ่ม บันทึก & สร้างไฟล์การตั้งค่าใหม่ เพื่อสร้างไฟล์ AndroidManifest.xml และไฟล์ hive_config.xml ไฟล์ hive_config.xml จะถูกสร้างในไดเรกทอรีต่อไปนี้
- Unity 2021 ขึ้นไป: /Assets/HiveSDK/hive.androidlib/src/main/res/raw
- Unity ต่ำกว่า 2021: /Assets/Plugins/Android/res/raw/
iOS: คลิกที่ปุ่ม บันทึก & สร้างไฟล์การตั้งค่าใหม่ เพื่อสร้างไฟล์ Info.plist และไฟล์ hive_config.xml ไฟล์ hive_config.xml จะถูกสร้างในไดเรกทอรีต่อไปนี้
- /Assets/Plugins/iOS/<

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

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

<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 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 Feature Settings: START -->
    <!-- Authentication feature setting: Use 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 Settings: END -->

</properties>

Info

การกำหนดค่า SDK ของ Hive สามารถจัดเก็บค่าในไฟล์การกำหนดค่าก่อนการสร้างแอปหรือเปลี่ยนแปลงค่าการกำหนดค่าในระหว่างการทำงาน (การดำเนินการของแอป) สำหรับรายละเอียดเพิ่มเติม โปรดตรวจสอบที่ Hive SDK configuration.