Hive การพัฒนา SDK¶

สรุปของกระบวนการทั้งหมดตั้งแต่การติดตั้ง Hive SDK ไปจนถึงการแจกจ่ายแอปมีดังนี้

1. การติดตั้ง
2. การกำหนดค่า
3. การพัฒนา
4. การสร้าง
5. การปรับใช้

1. การติดตั้ง¶

ในการนำฟีเจอร์เช่นการตรวจสอบสิทธิ์และการชำระเงินมาใช้ในแอปของคุณโดยใช้ SDK ของ Hive ให้ลงทะเบียนสำหรับคอนโซล Hive และสร้าง AppID ก่อน จากนั้นติดตั้ง SDK ของ Hive ที่เหมาะสมกับสภาพแวดล้อมการพัฒนาของคุณ

การเตรียมตัวก่อนการติดตั้ง¶

ฟีเจอร์ส่วนใหญ่ของ SDK Hive ต้องการข้อมูลที่ป้อนในคอนโซล Hive ดังนั้น เพื่อใช้ SDK คุณต้องลงทะเบียนสำหรับ คอนโซล Hive และสร้าง AppID ก่อน

การติดตั้ง SDK¶

หลังจากสร้าง AppID ในคอนโซลแล้ว ให้ติดตั้ง SDK SDK ของ Hive อาจมีวิธีการ ติดตั้ง ที่แตกต่างกันขึ้นอยู่กับเอนจินการพัฒนา (Unity, Unreal Engine, ฯลฯ) และ OS (Android, iOS) ตัวอย่างเช่น หากคุณกำลังพัฒนาแอปด้วยเอนจิน Unity คุณสามารถติดตั้งเวอร์ชัน SDK ล่าสุดได้อย่างสะดวกโดยใช้ SDK Manager แต่หากคุณกำลังพัฒนาแอปในสภาพแวดล้อม Native Android คุณจะต้องติดตั้ง SDK โดยใช้ Gradle

ติดตั้งฟีเจอร์¶

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

2. การตั้งค่าสภาพแวดล้อม¶

หากการติดตั้ง SDK เสร็จสมบูรณ์ คุณจะต้องกำหนดค่าบริการ SDK มีการตั้งค่าที่จำเป็นและการตั้งค่าที่ไม่จำเป็น

(จำเป็น) การตั้งค่าพื้นฐาน: hive_config.xml¶

hive_config.xml เป็นไฟล์ที่มีค่าคอนฟิกที่จำเป็นสำหรับ SDK ในการทำงานและรวมอยู่ในการสร้างแอป เพื่อใช้ SDK คุณต้องป้อน AppID ที่สร้างในคอนโซล Hive และ IdP ที่คุณจะใช้ในไฟล์นี้ SDK จะรวม hive_config.xml ในการสร้างแอปในขณะ initialization.

เช่นเดียวกับการติดตั้ง SDK วิธีการกำหนดค่าของ hive_config.xml อาจแตกต่างกันไปขึ้นอยู่กับเอนจินการพัฒนา (Unity, Unreal Engine, ฯลฯ) และระบบปฏิบัติการ (Android, iOS) ตัวอย่างเช่น เมื่อพัฒนาแอปด้วยเอนจิน Unity คุณสามารถสร้าง hive_config.xml โดยใช้ Unity Inspector โดยไม่ต้องป้อนค่าการกำหนดค่าโดยตรงใน hive_config.xml ในขณะที่ในสภาพแวดล้อม Native คุณต้องสร้างไฟล์นี้ด้วยตนเองและป้อนค่าโดยตรงลงไปในนั้น

(ตัวเลือก) การตั้งค่าเฉพาะตลาด¶

หากคุณต้องการใช้ตลาดแอปเฉพาะเช่น Google Play Games บน PC, Amazon, Steam (Windows) จะต้องมีการกำหนดค่าที่เพิ่มเติม การตั้งค่าเพิ่มเติม จำเป็นต้องใช้

(ตัวเลือก) การตั้งค่าเวลาทำงาน¶

การตั้งค่า SDK บางอย่าง ควรทำในระหว่างการทำงานของแอปพลิเคชันแทนที่จะทำในระหว่างการเริ่มต้น SDK (เวลาสร้าง) อย่างไรก็ตาม การเปลี่ยนแปลงการตั้งค่าในระหว่างการให้บริการจริงไม่แนะนำ

3. การพัฒนา¶

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

การเริ่มต้น SDK¶

SDK Initialization เป็นขั้นตอนการเตรียมการแรกในการดำเนินการฟังก์ชันของ SDK ในกระบวนการทำงานของ SDK การเริ่มต้นจะถูกดำเนินการก่อน และเมื่อการเริ่มต้นเสร็จสิ้น ฟีเจอร์ต่าง ๆ ของ SDK เช่น การตรวจสอบสิทธิ์ การชำระเงิน และโปรโมชั่น สามารถใช้งานได้

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

เมื่อการเริ่มต้นเสร็จสมบูรณ์ คุณสามารถตรวจสอบข้อมูลการระบุอุปกรณ์และรายการของ IdP ที่รองรับระหว่างการเข้าสู่ระบบในคอนโซล Hive

เข้าสู่ระบบ¶

เมื่อผู้ใช้แอปเข้าสู่ระบบด้วย IdP ที่ตั้งค่าไว้ก่อนหน้านี้ SDK จะได้รับข้อมูลการระบุผู้ใช้ คุณสามารถใช้ข้อมูลนี้เพื่อระบุผู้ใช้และให้บริการ

เมื่อทำการ implement การเข้าสู่ระบบ จะต้องมีการจัดการข้อยกเว้นด้วย การจัดการข้อยกเว้นเป็นสิ่งจำเป็นสำหรับปัญหาที่เกิดจากข้อผิดพลาดในการกำหนดค่า SDK หรือผู้ใช้ที่เข้าสู่ระบบสำเร็จแล้ว ตัวอย่างของผู้ใช้ที่ต้องจัดการเป็นข้อยกเว้นรวมถึง การเข้าสู่ระบบของผู้ใช้ที่ถูกระงับ และ กระบวนการแก้ไขความขัดแย้งของบัญชี

หากผู้ใช้แอปได้เข้าสู่ระบบสำเร็จแล้ว โทเค็นการเข้าสู่ระบบจะต้องได้รับการตรวจสอบ SDK จะออกโทเค็นที่สามารถตรวจสอบได้เพื่อกำหนดว่าผู้ใช้ไม่เหมาะสมหรือไม่ และ โทเค็นนี้สามารถตรวจสอบได้ เพื่อกำหนดว่าโทเค็นไม่ได้ถูกปลอมแปลง

การชำระเงิน¶

ฟีเจอร์ การเรียกเก็บเงิน แสดงรายการผลิตภัณฑ์ที่ขายในแอปให้กับผู้ใช้แอปและอนุญาตให้พวกเขาซื้อผลิตภัณฑ์เหล่านี้ เมื่อมีการนำเสนอร้านค้าในแอปและขายผลิตภัณฑ์ในแอป รายการผลิตภัณฑ์จะถูกเปิดเผย และข้อมูลผลิตภัณฑ์ที่ขายจะถูกจัดเตรียมแตกต่างกันตามประเทศ ประเภทสกุลเงิน และภาษา ผลิตภัณฑ์แต่ละรายการมีรหัสระบุผลิตภัณฑ์ ซึ่งแยกแยะข้อมูลของแต่ละผลิตภัณฑ์

เมื่อคุณ ขายผลิตภัณฑ์ ในร้านค้าในแอป SDK จะออกใบเสร็จ แอปของคุณต้องรับข้อมูลใบเสร็จนี้และเรียกใช้ API การตรวจสอบใบเสร็จ เพื่อตรวจสอบใบเสร็จ หากใบเสร็จถูกต้อง แอปจะมอบผลิตภัณฑ์ให้กับผู้ใช้ที่ซื้อผลิตภัณฑ์นั้น เมื่อการส่งมอบผลิตภัณฑ์เสร็จสิ้น SDK จะประกาศสิ้นสุดการทำธุรกรรมการชำระเงิน

เมื่อการยกเลิกการทำธุรกรรมการชำระเงินถูกประกาศ ใบเสร็จสำหรับการซื้อไม่สามารถใช้สำหรับ การกู้คืนผลิตภัณฑ์ ได้ หากผู้ใช้แอปได้ทำการซื้อผลิตภัณฑ์จากร้านค้าในแอป แต่ผลิตภัณฑ์ยังไม่ได้ถูกส่งมอบให้กับผู้ใช้ด้วยเหตุผลใดก็ตาม ใบเสร็จที่ออกสามารถใช้เพื่อพยายามส่งมอบผลิตภัณฑ์อีกครั้งได้

การดีบัก¶

การเปิดใช้งาน logging จะช่วยให้คุณตรวจสอบปัญหาการพัฒนาและทำการดีบัก หากเครื่องมือพัฒนาคือ Unity จะรองรับการดีบักแบบเรียลไทม์ด้วย RTT4U

4. สร้าง¶

รายการที่ต้องตรวจสอบก่อนการสร้าง ขึ้นอยู่กับเครื่องมือพัฒนา ระบบปฏิบัติการ หรือสายการสร้าง ตัวอย่างเช่น ในสภาพแวดล้อม Android (Native Android และ Unity Android) สิทธิ์จะถูกเพิ่มโดยอัตโนมัติใน SDK ดังนั้นจึงไม่ต้องมีการกำหนดค่าเพิ่มเติม ในทางตรงกันข้าม ในสภาพแวดล้อม Native iOS สิทธิ์จะต้องถูกประกาศตามฟีเจอร์ที่แอปตั้งใจจะใช้ก่อนการสร้าง ในสภาพแวดล้อม Unity iOS สิทธิ์ที่จำเป็นเท่านั้นที่สามารถเพิ่มโดยอัตโนมัติได้โดยใช้ HivePostProcess Editor

5. การปรับใช้¶

ก่อนที่จะเผยแพร่แอปไปยังตลาดแอป (Google Play Store, App Store, ฯลฯ) คุณต้องมั่นใจว่าแอปได้รับการพัฒนาอย่างถูกต้องตาม Hive แพลตฟอร์ม นโยบาย และคุณต้องส่ง ประเภทและวัตถุประสงค์ของข้อมูลส่วนบุคคลที่เก็บโดยแอป ไปยังตลาดแอป กรุณาอ้างอิงไปยังคู่มือข้อมูลส่วนบุคคลที่ใช้โดย Hive SDK หรือไลบรารีของบุคคลที่สามสำหรับการส่งข้อมูล