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¶

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

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

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

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

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

การรับรอง (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

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

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

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

การวิเคราะห์ (การกำหนดแหล่งที่มาของการตลาด)¶

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

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

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

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

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

ตัวอย่างเช่น หากคุณต้องการขยายเวลาเชื่อมต่อเครือข่ายเมื่อเรียกใช้วิธีการ SDK ของ Hive ให้เพิ่มค่าของ 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

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

แม้ว่าเมื่อใช้ Unity Hive Config Editor ค่าบางอย่างด้านล่างในไฟล์ hive_config.xml จะต้องตั้งค่าโดยมือ

2. การกำหนดค่าแบบแมนนวล¶

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

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

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

• Android
  • Unity 2021 หรือเวอร์ชันที่ใหม่กว่า: /Assets/HiveSDK/hive.androidlib/src/main/res/raw/hive_config.xml
  • Unity ก่อนปี 2021: /Assets/Plugins/Android/res/raw/hive_config.xml
• iOS
  • /Assets/Plugins/iOS/hive_config.xml
• Windows
  • /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) โปรดแก้ไข เพิ่ม หรือ ลบค่าให้ตรงตามคุณสมบัติของ Hive SDK ที่คุณต้องการใช้และสภาพแวดล้อมของแอป เนื่องจาก iOS รองรับการชำระเงินผ่าน Apple AppStore เท่านั้น ให้ตั้งค่าตลาดเป็น AP ในสภาพแวดล้อม Unity iOS

``` xml

<!-- Hive SDK common: START -->
<appId>com.sample.your</appId>

<gameLanguage>en</gameLanguage>

<!--* Select Hive platform's server. sandbox for development, real for live
    (sandbox, real) -->
<zone>real</zone>

<!--* Set whether to use internal SDK operation logs
    (true, false) -->
<useLog>false</useLog>

<!--* Company settings
    (C2S: Com2uS, GVI: Com2us Holdings) -->
<company>C2S</company>

<!--* Channel settings
    (C2S: Hive platform) -->
<channel>C2S</channel>

<!--* Payment market settings
    (GO: Google Play, LE: Com2us Lebi, AP: Apple App Store) -->
<market>GO</market>

<!--* Set HTTP Connect Timeout duration used internally in the Hive SDK in seconds
    (do not change unless in special cases) -->
<httpConnectTimeout>8</httpConnectTimeout>

<!--* Set HTTP Read Timeout duration used internally in the Hive SDK in seconds
    (do not change unless in special cases) -->
<httpReadTimeout>8</httpReadTimeout>

<agreementDetermineBase>device</agreementDetermineBase>
<!-- Hive SDK common settings: END -->

<!-- Hive SDK feature-specific settings: START -->
<!--* Authentication product settings: 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-specific settings: END -->