Unity

มีสองวิธีในการกำหนดค่า hive_config.xml ในสภาพแวดล้อม Unity.

1. กำหนดเนื้อหาของ hive_config.xml โดยอัตโนมัติกับ Unity Hive Config Editor
2. กำหนดค่า hive_config.xml ด้วยตนเอง

1. การกำหนดค่าทางอัตโนมัติด้วย Unity hive config editor¶

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

การเรียกใช้ Unity hive config editor¶

เลือก Hive > การตั้งค่า Hive (แก้ไขการตั้งค่า) และตั้งค่าค่าที่จำเป็นในหน้าจอ Editor.

เลือกสภาพแวดล้อมการทำงาน¶

ก่อนอื่นให้เลือก สภาพแวดล้อมการทำงานของแอป (Android, iOS, macOS, Windows) .

ทั่วไป (คุณสมบัติทั่วไปของ hive sdk)¶

แท็บทั่วไป ช่วยให้คุณสามารถกำหนดค่าที่ใช้กับฟีเจอร์ทั้งหมดของ SDK Hive คุณสามารถตั้งค่า AppID ของ Hive และเลือกเซิร์ฟเวอร์ (การผลิตหรือแซนด์บ็อกซ์) นอกจากนี้คุณยังสามารถกำหนดทิศทางของหน้าจอที่จะถูกแสดงเมื่อแอปถูกเปิด การตั้งค่าทั้งหมดในแท็บทั่วไปจำเป็นต้องกรอกให้ครบถ้วน

การรับรองความถูกต้อง (authentication)¶

แท็บ Auth คือที่ที่คุณกำหนดค่าการตั้งค่าเพื่อใช้ฟีเจอร์การตรวจสอบสิทธิ์ SDK ของ Hive SDK รองรับการเข้าสู่ระบบ IdP เช่น Facebook, Google และ QQ หลังจากเลือก IdP ที่จะใช้สำหรับการเข้าสู่ระบบ คุณจะต้องดึงและป้อน AppId, ClientId เป็นต้น จากคอนโซลนักพัฒนาของ IdP นี้ (เช่น คอนโซล Google)

ตัวอย่างเช่น เพื่อใช้ Google SignIn คุณต้องได้รับค่าที่จำเป็นสำหรับรายการ Google SignIn จาก Google Console และป้อนค่าดังกล่าวในแท็บ Auth ตามที่แสดงด้านล่าง

• Google App Id: ป้อน AppID ที่ออกโดย Google console
• Google Server Client ID: ป้อนค่า Client ID ของเว็บแอปพลิเคชันที่ออกโดย Google console

ตลาด (การเรียกเก็บเงิน)¶

แท็บตลาด คือที่ที่คุณกำหนดค่าการตั้งเพื่อใช้ฟีเจอร์การเรียกเก็บเงิน Hive SDK. Hive SDK รองรับตลาดแอป เช่น Google Play Store และ Apple App Store และในแท็บนี้คุณต้องตั้งค่าค่าที่จำเป็นสำหรับการซื้อภายในแอป.

ตัวอย่างเช่น หากแอปสนับสนุนการชำระเงินผ่านตลาด Android Lebi และ Wechat Pay คุณต้องป้อน Payment Key ที่ออกโดย Wechat console ในแท็บตลาด

การวิเคราะห์ (การกำหนดการตลาด)¶

แท็บการวิเคราะห์ คือที่ที่คุณกำหนดค่าการตั้งค่าเพื่อใช้ฟีเจอร์การระบุการตลาดของ Hive SDK Hive SDK รองรับการระบุการตลาดผ่าน Adjust, Firebase, ฯลฯ และคุณต้องได้รับค่า key และ event จากคอนโซลนักพัฒนาของบริการที่เกี่ยวข้องและป้อนค่าลงในแท็บนี้.

ตัวอย่างเช่น เพื่อใช้ Adjust ให้ป้อนค่าที่จำเป็นสำหรับรายการ Adjust ในแท็บ Analytics ตามข้อมูลด้านล่าง

• appToken: ป้อน AppToken ที่ออกจาก Adjust console
• Event: ป้อนชื่อและค่าของเหตุการณ์ที่ลงทะเบียนใน Adjust console

ตัวเลือก (ตัวเลือกการสื่อสารเครือข่าย, การบันทึก, และฟีเจอร์อื่น ๆ)¶

ตัวเลือก ในแท็บนี้ คุณสามารถป้อนตัวเลือกการสื่อสารเครือข่าย บันทึก และการตั้งค่าอื่น ๆ เมื่อใช้ Hive SDK.

ตัวอย่างเช่น หากคุณต้องการขยายเวลาหมดอายุของเครือข่ายเมื่อเรียกใช้วิธี Hive SDK ให้เพิ่มค่าของ httpConnectTimeout และ httpReadTimeout เป็นอีกตัวอย่างหนึ่ง เมื่อ ส่งบันทึกระยะไกล คุณสามารถเปลี่ยนรอบการส่งและขนาดของข้อมูลบันทึกที่ส่ง ซึ่งช่วยให้คุณสามารถปรับเปลี่ยน ค่าการตั้งค่าบันทึกการวิเคราะห์ แนะนำให้ใช้ค่าดีฟอลต์สำหรับรายการแท็บที่เลือกได้ เว้นแต่จะจำเป็นจริงๆ

บันทึกการตั้งค่าและสร้างไฟล์ hive_config.xml¶

หลังจากที่ตั้งค่าทุกแท็บใน Unity Hive Config Editor เสร็จสิ้น การคลิกที่ บันทึก & สร้างไฟล์การตั้งค่าใหม่ จะสร้างไฟล์ hive_config.xml โดยอัตโนมัติ

แอนดรอยด์¶

การคลิกที่บันทึกและสร้างไฟล์การตั้งค่าใหม่ จะสร้างไฟล์ AndroidManifest.xml และไฟล์ hive_config.xml ตำแหน่งที่สร้างไฟล์ hive_config.xml จะแตกต่างกันไปขึ้นอยู่กับเวอร์ชันของ Unity.

• Unity 2021 และสูงกว่า: /Assets/HiveSDK/hive.androidlib/src/main/res/raw/hive_config.xml
• Unity ต่ำกว่า 2021: /Assets/Plugins/Android/res/raw/hive_config.xml

iOS¶

การคลิกที่บันทึก & สร้างไฟล์การตั้งค่าใหม่ จะสร้างไฟล์ Info.plist และไฟล์ hive_config.xml ไฟล์ hive_config.xml จะถูกสร้างที่ตำแหน่งด้านล่าง.

• /Assets/Plugins/iOS/hive_config.xml

วินโดวส์¶

การกดปุ่ม Windows จะสร้างไฟล์ hive_config.xml ไฟล์ hive_config.xml จะถูกสร้างในตำแหน่งด้านล่างนี้.

• /Assets/Plugins/Windows/res/hive_config.xml

2. การกำหนดค่าด้วยตนเอง¶

หากคุณไม่ใช้ Unity Hive Config Editor คุณจะต้องสร้างไฟล์ hive_config.xml และตั้งค่าค่าต่างๆ ในไฟล์ด้วยตนเอง

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

สร้างไฟล์ hive_config.xml โดยตรงที่เส้นทางด้านล่างนี้

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

hive_config.xml การปรับเปลี่ยน¶

อ้างอิงไปที่ ถัดไป เพื่อแก้ไขและบันทึกไฟล์ hive_config.xml โดยตรง อย่างไรก็ตาม ค่าบางอย่างในไฟล์ถูกตั้งค่าตามความต้องการของนักพัฒนา

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 game build unique identifier -->
    <appId>com.sample.your</appId>

    <!-- Select server for Hive platform. sandbox is for development, real is for commercial
        (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 standard for receiving terms agreement
        (device, account) -->
    <agreementDetermineBase>false</agreementDetermineBase>

    <!-- Terms exposure design setting (Not set for SDK v4)
        (true, false) -->
    <!-- <authV1Agreement>device</authV1Agreement> -->

    <!-- Set sharing apps to not expose when sharing promotion UA (Android Only) -->
    <unsupportedUAShareType>
        <value>SMS</value>
        <value>URL</value>
    </unsupportedUAShareType>

    <!-- Set HTTP Connect Timeout time in seconds used internally by Hive SDK
        (Do not change unless it is a special case) -->
    <httpConnectTimeout>8</httpConnectTimeout>

    <!-- Set HTTP Read Timeout time in seconds used internally by Hive SDK
        (Do not change unless it is a special case) -->
    <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>