Unity

เพิ่มฟีเจอร์ SDK ของ Hive ที่คุณต้องการใช้เป็นไลบรารีภายนอก SDK ของ Hive มีฟีเจอร์หลากหลาย เช่น การตรวจสอบสิทธิ์ การชำระเงิน การแจ้งเตือนแบบพุช และแบนเนอร์โฆษณา นักพัฒนาต้องเลือกและติดตั้งเฉพาะฟีเจอร์ที่ต้องการใช้เท่านั้น ที่นี่เราจะแนะนำวิธีการใช้ฟีเจอร์พื้นฐานที่สุด: การตรวจสอบสิทธิ์ และ การชำระเงิน.

SDK ของ Hive ถูกแจกจ่ายพร้อมกับแพ็คเกจ External-Dependency-Manager for Unity (EDM4U) ที่รวมอยู่ในเวอร์ชัน UnityPackage มันถูกกำหนดค่าให้ติดตั้ง/แจกจ่ายไลบรารีที่จำเป็นสำหรับการสร้างด้วยการตั้งค่า EDM4U โดยอัตโนมัติ หากสภาพแวดล้อมการสร้างที่ EDM4U สามารถทำงานได้ยังไม่ได้เตรียมไว้ จะต้องตั้งค่า ซึ่งสามารถทำได้โดยใช้ GUI ที่จัดเตรียมโดย EDM4U หรือผ่านเชลล์ Unix, Bash, คือ Command Line Interface (CLI).

หมายเหตุสำหรับการติดตั้ง/อัปเดตด้วยตนเอง¶

เริ่มตั้งแต่ Hive SDK v4 24.3.0 เมื่อทำการติดตั้งหรืออัปเดต Hive SDK Unity ผ่าน แพ็คเกจ Unity แทนที่จะใช้ Hive SDK Manager คุณต้องลบไฟล์ทั้งหมด HIVESDK_{library_name}Dependencies.xml ที่ตั้งอยู่ในเส้นทางด้านล่างก่อนที่จะสร้างแอป

Assets/Hive_SDK_v4/Dependencies
Assets/Hive_SDK_v4/Editor

ไฟล์ที่จะถูกลบมีดังต่อไปนี้:

HIVESDK_DefaultDependencies.xml
HIVESDK_HerculesDependencies.xml
HIVESDK_HiveAnalyticsConsentModeDependencies.xml
HIVESDK_HiveDataStoreDependencies.xml
HIVESDK_HiveDeviceManagementDependencies.xml
HIVESDK_HiveGoogleInAppReviewDependencies.xml
HIVESDK_HiveGoogleInAppUpdateDependencies.xml
HIVESDK_HivePromotionDependencies.xml
HIVESDK_HiveRealNameVerificationDependencies.xml
HIVESDK_MarketAmazonDependencies.xml
HIVESDK_MarketAppleDependencies.xml
HIVESDK_MarketGoogleDependencies.xml
HIVESDK_MarketHiveStoreDependencies.xml
HIVESDK_MarketHuaweiDependencies.xml
HIVESDK_MarketLebiDependencies.xml
HIVESDK_MarketOneStoreDependencies.xml
HIVESDK_MarketSamsungDependencies.xml
HIVESDK_ProviderAdjustDependencies.xml
HIVESDK_ProviderAppleDependencies.xml
HIVESDK_ProviderAppleSignInDependencies.xml
HIVESDK_ProviderAppsFlyerDependencies.xml
HIVESDK_ProviderFacebookDependencies.xml
HIVESDK_ProviderFirebaseDependencies.xml
HIVESDK_ProviderGoogleDependencies.xml
HIVESDK_ProviderGooglePlayGamesDependencies.xml
HIVESDK_ProviderHiveMembershipDependencies.xml
HIVESDK_ProviderHuaweiDependencies.xml
HIVESDK_ProviderLineDependencies.xml
HIVESDK_ProviderQQDependencies.xml
HIVESDK_ProviderRecaptchaDependencies.xml
HIVESDK_ProviderSingularDependencies.xml
HIVESDK_ProviderVKDependencies.xml
HIVESDK_ProviderWechatDependencies.xml
HIVESDK_ProviderWeverseDependencies.xml
HIVESDK_PushAmazonAdmDependencies.xml
HIVESDK_PushGoogleFcmDependencies.xml

Android¶

นี่คือคู่มือเกี่ยวกับวิธีการติดตั้งผลิตภัณฑ์แต่ละรายการของ Hive SDK ใน Unity Android.

การตั้งค่า Android resolver¶

เรียกใช้ Unity และคลิกที่เมนู Asset > External Dependency Manager > Android Resolver > Settings

เมื่อหน้าต่างการตั้งค่า Android Resolver ปรากฏขึ้น ให้ตรวจสอบรายการที่ทำเครื่องหมายเป็นสีแดงว่าเป็นการตั้งค่าเริ่มต้น

ตรวจสอบ คัดลอกและตั้งค่า patch Template.gradle จาก 2022.2 รายการเฉพาะหากคุณกำลังใช้ Unity เวอร์ชัน 2022.2 หรือใหม่กว่า ฟีเจอร์ ใช้ Jetifier ได้รับการสนับสนุนโดยอัตโนมัติจาก Hive SDK ดังนั้นจึงแนะนำให้ยกเลิกการเลือกมัน

หากคุณเลือก ใช้ Jetifier ในเวอร์ชันล่าสุดของ Unity คุณต้องสร้าง แม่แบบคุณสมบัติ Gradle แบบกำหนดเอง ตามที่ระบุใน คู่มือ Unity

Hive ข้อกำหนด¶

ใน Hive Dependencies คุณสามารถเปิดหรือปิดการให้บริการที่จัดทำโดย Hive SDK ได้ เลือก Hive > Hive Dependencies (ExternalDependency).

เมื่อหน้าต่างการตั้งค่าแสดงขึ้น ให้เลือกฟีเจอร์ Hive ที่คุณต้องการใช้ ตัวอย่างเช่น หากต้องการใช้ฟีเจอร์การตรวจสอบสิทธิ์ของ Google และฟีเจอร์การชำระเงินใน Google Play Store ให้เลือก Google Signin ใน Auth Settings และ Google PlayStore ใน Market Settings หลังจากเลือกฟีเจอร์ที่คุณต้องการใช้แล้ว ให้คลิก Save เพื่อทำการเลือกของคุณให้เสร็จสิ้น

การตั้งค่าโมดูล Hive

ฟีเจอร์	คำอธิบาย
โปรโมชั่น	ให้ฟีเจอร์ในการเปิดเผยข่าวสารหรือเหตุการณ์ใหม่ ๆ ของเกมอย่างมีประสิทธิภาพ.
Google InAppReview	ให้ความสามารถในการเขียนรีวิวใน Google Play. (Android)
การจัดการอุปกรณ์	บริการนี้อนุญาตให้เข้าถึงเกมเฉพาะสำหรับอุปกรณ์ที่ลงทะเบียนโดยผู้ใช้.
การตรวจสอบชื่อจริง	ให้ฟังก์ชันสำหรับผู้ใช้ที่เข้าถึงจากประเทศจีนในการทำการตรวจสอบชื่อจริง.
เฮอร์คิวลิส	ให้บริการตรวจจับและติดตามการละเมิดเกมที่มุ่งเป้าไปที่เกมบนแพลตฟอร์ม Hive.
reCAPTCHA	ให้ฟังก์ชันในการควบคุมการสร้างบัญชีโดยการกำหนดว่าผู้ใช้เป็นหุ่นยนต์หรือไม่โดยใช้ Google reCAPTCHA.
DataStore	บริการนี้ให้ระบบจัดเก็บข้อมูลที่อนุญาตให้ข้อมูลที่สร้างขึ้นในเกมถูกบันทึกและอ่านได้ง่ายในรูปแบบคีย์-ค่า.
Google InAppUpdate	ให้ความสามารถในการอัปเดตแอปในพื้นหลังโดยไม่ต้องปิดแอป. (Android)
โหมดการยินยอมการวิเคราะห์	ให้ฟังก์ชันในการแสดงแบนเนอร์การยินยอมเพื่อตรวจสอบว่ามีการขอความยินยอมในการเก็บข้อมูลส่วนบุคคลหรือไม่.
การจับคู่	ให้ฟีเจอร์การจับคู่ที่เชื่อมต่อผู้ใช้เกมให้เล่นด้วยกัน.
แชท	ให้ฟีเจอร์แชทสำหรับผู้ใช้ รวมถึงแชทแบบเรียลไทม์, แชทกลุ่ม, และแชท 1:1.

การตั้งค่า Auth

ฟีเจอร์	คำอธิบาย
Hive Membership	ให้บริการ 'เข้าสู่ระบบด้วย Hive' IdP.
Google SignIn	ให้บริการ 'เข้าสู่ระบบด้วย Google' IdP.
Google Play Games	ให้บริการ 'เข้าสู่ระบบด้วย Google Play' IdP. (Android)
Facebook	ให้บริการ 'เข้าสู่ระบบด้วย Facebook' IdP.
Apple GameCenter	ให้บริการ 'เข้าสู่ระบบด้วย Game Center' IdP. (iOS)
Apple SignIn	ให้บริการ 'เข้าสู่ระบบด้วย Apple' IdP.
Line	ให้บริการ 'เข้าสู่ระบบด้วย LINE' IdP.
VK	ให้บริการ 'เข้าสู่ระบบด้วย VK' IdP.
QQ	ให้บริการ 'เข้าสู่ระบบด้วย QQ' IdP.
Wechat	ให้บริการ 'เข้าสู่ระบบด้วย Wechat' IdP.
Weverse	ให้บริการ 'เข้าสู่ระบบด้วย Weverse' IdP.
Steam	ให้บริการ 'เข้าสู่ระบบด้วย Steam' IdP.
X	ให้บริการ 'เข้าสู่ระบบด้วย X' IdP.
Telegram	ให้บริการ 'เข้าสู่ระบบด้วย Telegram' IdP.
Huawei	ให้บริการ 'เข้าสู่ระบบด้วย Huawei' IdP. (Android)

การตั้งค่าการแจ้งเตือน

ฟีเจอร์	คำอธิบาย
Google FCM	ให้ฟังก์ชันการแจ้งเตือน Firebase Cloud Messaging (Android)
Apple APNs	ให้ฟังก์ชันการแจ้งเตือน Apple Push Notification Service (iOS)
Amazon ADM	ให้ฟังก์ชันการแจ้งเตือน Amazon Device Messaging (Android)

การตั้งค่าตลาด

ฟีเจอร์	คำอธิบาย
Google PlayStore	ให้ฟังก์ชันการเรียกเก็บเงินของ Google PlayStore (Android)
Apple AppStore	ให้ฟังก์ชันการเรียกเก็บเงินของ Apple AppStore (iOS)
OneStore	ให้ฟังก์ชันการเรียกเก็บเงินของ OneStore (Android)
Amazon ADM	ให้ฟังก์ชันการเรียกเก็บเงินของ Amazon AppStore (Android)
Lebi	ให้ฟังก์ชันการเรียกเก็บเงินของ Lebi (จีน) (Android)
Hive Store	ให้ฟังก์ชันการชำระเงิน PG (Android)
Samsung GalaxyStore	ให้ฟังก์ชันการเรียกเก็บเงินของ Samsung GalaxyStore (Android)
Huawei AppGallery	ให้ฟังก์ชันการเรียกเก็บเงินของ Huawei AppGallery (Android)

การตั้งค่า Analytics

ฟีเจอร์	คำอธิบาย
Adjust	ให้ฟังก์ชันการระบุแหล่งที่มาของการตลาดผ่าน Adjust.
Airbridge	ให้ฟังก์ชันการระบุแหล่งที่มาของการตลาดผ่าน Airbridge.
AppsFlyer	ให้ฟังก์ชันการระบุแหล่งที่มาของการตลาดผ่าน AppsFlyer.
Singular	ให้ฟังก์ชันการระบุแหล่งที่มาของการตลาดผ่าน Singular.
Firebase	ให้ฟังก์ชันการระบุแหล่งที่มาของการตลาดผ่าน Firebase.

iOS¶

คู่มือนี้อธิบายวิธีการติดตั้งผลิตภัณฑ์ SDK ของแต่ละ Hive บน Unity iOS

ติดตั้ง CocoaPods¶

ก่อนอื่นให้ติดตั้ง CocoaPods เรียกใช้งาน Unity และคลิกที่เมนู Asset > External Dependency Manager > iOS Resolver > Install CocoaPods

คุณยังสามารถติดตั้งมันได้โดยใช้ CLI (Bash-shell)

$sudo gem install cocoapods

หากผลลัพธ์ปรากฏดังด้านล่าง การติดตั้งเสร็จสมบูรณ์แล้ว

การตั้งค่า iOS resolver¶

ถัดไป ให้กำหนดค่า CocoaPods เมื่อให้ไลบรารีภายนอกสำหรับ iOS โดยใช้ CocoaPods นามสกุลไฟล์ .xcodeproj ที่มีอยู่จะถูกเปลี่ยนเป็น .xcworkspace หากคุณไม่สามารถดำเนินการสร้างในรูปแบบ .xcworkspace ได้ ให้ลองเปลี่ยนการตั้งค่าผ่าน GUI วิธีการใช้ CocoaPods ที่ดำเนินการใน Unity บน PC ที่สร้างได้มีการเปลี่ยนแปลงและสามารถดำเนินการได้

เปิด Unity และคลิกที่เมนู Asset > External Dependency Manager > iOS Resolver > Settings
เมื่อหน้าต่างการตั้งค่า iOS Resolver ปรากฏขึ้น ให้ตั้งค่ารายการ Cocoapods Integration เป็น .xcworkspace และยกเลิกการเลือก Link framework statically เพื่อหลีกเลี่ยงการบังคับให้กรอบงานถูกอ้างอิงแบบสถิต

Hive ข้อกำหนด¶

ใน Hive Dependencies คุณสามารถเปิดหรือปิดบริการที่ให้โดย Hive SDK ได้ เลือก Hive > Hive Dependencies (ExternalDependency).

เมื่อหน้าต่างการตั้งค่าแสดงขึ้น ให้เลือกฟีเจอร์ Hive ที่คุณต้องการใช้ ตัวอย่างเช่น หากต้องการใช้ฟีเจอร์การตรวจสอบสิทธิ์ของ Google และฟีเจอร์การชำระเงินของ Apple AppStore ให้เลือก Google Signin ใน Auth Settings และ Apple AppStore ใน Market Settings หลังจากเลือกฟีเจอร์ที่คุณต้องการใช้แล้ว ให้คลิก Save เพื่อทำการเลือกของคุณให้เสร็จสิ้น

การตั้งค่าโมดูล Hive

ฟีเจอร์	คำอธิบาย
โปรโมชั่น	ให้ฟีเจอร์ในการเปิดเผยข่าวสารหรือเหตุการณ์ใหม่ ๆ ของเกมอย่างมีประสิทธิภาพ
Google InAppReview	ให้ความสามารถในการเขียนรีวิวใน Google Play (Android)
การจัดการอุปกรณ์	บริการนี้อนุญาตให้เข้าเกมได้เฉพาะอุปกรณ์ที่ลงทะเบียนโดยผู้ใช้เท่านั้น
การตรวจสอบชื่อจริง	ให้ฟังก์ชันการตรวจสอบชื่อจริงสำหรับผู้ใช้ที่เข้าถึงจากประเทศจีน
เฮอร์คิวลิส	ให้บริการตรวจจับและติดตามการละเมิดเกมที่มุ่งเป้าไปที่เกมบนแพลตฟอร์ม Hive
reCAPTCHA	ให้ฟังก์ชันในการควบคุมการสร้างบัญชีโดยการตรวจสอบว่าผู้ใช้เป็นหุ่นยนต์หรือไม่โดยใช้ Google reCAPTCHA
DataStore	บริการนี้ให้ระบบจัดเก็บข้อมูลที่อนุญาตให้ข้อมูลที่สร้างขึ้นในเกมถูกบันทึกและอ่านได้ง่ายในรูปแบบคีย์-ค่า
Google InAppUpdate	ให้ความสามารถในการอัปเดตแอปในพื้นหลังโดยไม่ต้องปิดแอป (Android)
โหมดการยินยอมการวิเคราะห์	ให้ฟังก์ชันในการแสดงแบนเนอร์การยินยอมเพื่อตรวจสอบว่ามีการขอความยินยอมในการเก็บข้อมูลส่วนบุคคลหรือไม่
การจับคู่	ให้ฟีเจอร์การจับคู่ที่เชื่อมต่อผู้ใช้เกมให้เล่นด้วยกัน
แชท	ให้ฟีเจอร์แชทสำหรับผู้ใช้ รวมถึงแชทแบบเรียลไทม์ แชทกลุ่ม และแชท 1:1

การตั้งค่า Auth

ฟีเจอร์	คำอธิบาย
Hive Membership	ให้บริการ 'เข้าสู่ระบบด้วย Hive' IdP.
Google SignIn	ให้บริการ 'เข้าสู่ระบบด้วย Google' IdP.
Google Play Games	ให้บริการ 'เข้าสู่ระบบด้วย Google Play' IdP. (Android)
Facebook	ให้บริการ 'เข้าสู่ระบบด้วย Facebook' IdP.
Apple GameCenter	ให้บริการ 'เข้าสู่ระบบด้วย Game Center' IdP. (iOS)
Apple SignIn	ให้บริการ 'เข้าสู่ระบบด้วย Apple' IdP.
Line	ให้บริการ 'เข้าสู่ระบบด้วย LINE' IdP.
VK	ให้บริการ 'เข้าสู่ระบบด้วย VK' IdP.
QQ	ให้บริการ 'เข้าสู่ระบบด้วย QQ' IdP.
Wechat	ให้บริการ 'เข้าสู่ระบบด้วย Wechat' IdP.
Weverse	ให้บริการ 'เข้าสู่ระบบด้วย Weverse' IdP.
Steam	ให้บริการ 'เข้าสู่ระบบด้วย Steam' IdP.
X	ให้บริการ 'เข้าสู่ระบบด้วย X' IdP.
Telegram	ให้บริการ 'เข้าสู่ระบบด้วย Telegram' IdP.
Huawei	ให้บริการ 'เข้าสู่ระบบด้วย Huawei' IdP. (Android)

การตั้งค่าการส่งข้อความ

ฟีเจอร์	คำอธิบาย
Google FCM	ให้ฟังก์ชันการแจ้งเตือน Firebase Cloud Messaging (Android)
Apple APNs	ให้ฟังก์ชันการบริการแจ้งเตือนของ Apple (iOS)
Amazon ADM	ให้ฟังก์ชันการแจ้งเตือน Amazon Device Messaging (Android)

การตั้งค่าตลาด

ฟีเจอร์	คำอธิบาย
Google PlayStore	ให้ฟังก์ชันการเรียกเก็บเงินของ Google PlayStore (Android)
Apple AppStore	ให้ฟังก์ชันการเรียกเก็บเงินของ Apple AppStore (iOS)
OneStore	ให้ฟังก์ชันการเรียกเก็บเงินของ OneStore (Android)
Amazon ADM	ให้ฟังก์ชันการเรียกเก็บเงินของ Amazon AppStore (Android)
Lebi	ให้ฟังก์ชันการเรียกเก็บเงินของ Lebi (จีน) (Android)
Hive Store	ให้ฟังก์ชันการชำระเงิน PG (Android)
Samsung GalaxyStore	ให้ฟังก์ชันการเรียกเก็บเงินของ Samsung GalaxyStore (Android)
Huawei AppGallery	ให้ฟังก์ชันการเรียกเก็บเงินของ Huawei AppGallery (Android)

การตั้งค่า Analytics

ฟีเจอร์	คำอธิบาย
Adjust	ให้ฟังก์ชันการติดตามการตลาดผ่าน Adjust.
Airbridge	ให้ฟังก์ชันการติดตามการตลาดผ่าน Airbridge.
AppsFlyer	ให้ฟังก์ชันการติดตามการตลาดผ่าน AppsFlyer.
Singular	ให้ฟังก์ชันการติดตามการตลาดผ่าน Singular.
Firebase	ให้ฟังก์ชันการติดตามการตลาดผ่าน Firebase.

Windows¶

ไม่จำเป็นต้องตั้งค่าเพิ่มเติมหลังจากนำเข้าชุดโปรแกรม Windows

Info

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