SDK Unity¶

หน้านี้ให้ข้อมูลเวอร์ชันล่าสุดของ SDK v4 สำหรับ Android, iOS และ Windows ในสภาพแวดล้อม Unity Engine พร้อมคู่มือการติดตั้งและอัปเดต รวมถึงการเปลี่ยนแปลงสำคัญในแต่ละเวอร์ชันของ SDK

SDK เวอร์ชันล่าสุด¶

โปรดใช้ SDK เวอร์ชันล่าสุดของแต่ละ Target OS กับโปรเจกต์ Unity Engine ของคุณ

※ เมื่อติดตั้งไฟล์แพ็กเกจแจกจ่าย SDK ของแต่ละ Target OS ต้องติดตั้ง Unity Interface ร่วมด้วยเสมอ

ตรวจสอบสภาพแวดล้อมการพัฒนาและ Dependency ของไลบรารีตามเวอร์ชันได้ที่ สภาพแวดล้อมการพัฒนา

ข้อกำหนดที่ต้องทราบ¶

• Hive SDK v4 Unity 25.0.0 ขึ้นไป ต้อง ออก Security Key
  • เนื่องจากมีการเปลี่ยนแปลงโปรโตคอลความปลอดภัยของการยืนยันตัวตน เมื่อใช้ Hive SDK v4 Unity 25.0.0 ขึ้นไป ต้อง ออก Security Key ใน Hive Console > Security Key Settings หากไม่ออก Security Key จะไม่สามารถล็อกอินในแอปได้
• Hive SDK v4 Unity 25.1.3 ขึ้นไป ต้องปรับการติดตั้งใช้งานการชำระเงิน PG
  • หากต้องการติดตั้งใช้งานการชำระเงิน PG บน Android&iOS 25.1.3 ขึ้นไป หรือ Windows 25.1.0 ขึ้นไป ให้ดู ขั้นตอนการทำงานของการชำระเงิน PG และแก้ไขโค้ดการติดตั้งใช้งานการชำระเงิน PG
• ใน Hive SDK v4 Unity Windows 25.8.1 ขึ้นไป มีปัญหาที่เมื่อคลิกแบนเนอร์โปรโมชันแบบเต็มหน้าจอแล้วลิงก์ไม่ทำงานตามปกติ หากต้องการแก้ไข ให้เปลี่ยนไฟล์ HTML สำหรับแบนเนอร์เต็มหน้าจอตามวิธีด้านล่าง
  1. ดาวน์โหลดและแตกไฟล์ ไฟล์บีบอัดโฟลเดอร์ที่มีไฟล์ HTML ที่แก้ไขแล้ว
  2. คัดลอกทั้งโฟลเดอร์แล้ววางทับใน Hive_SDK_UnityPlugin\Assets\Hive_SDK_v4\Plugins\Windows\additional
  3. สร้างแอปใหม่อีกครั้ง
• หากใช้ SDK Manager กับ Hive SDK v4 Unity 25.4.0 ขึ้นไป ให้ อัปเดตเป็น SDK Manager v2.0.0 ขึ้นไป

คู่มือการติดตั้งและอัปเดต SDK¶

ตั้งแต่ SDK v4 Unity 25.5.1 เป็นต้นไป แพ็กเกจแจกจ่าย SDK ถูก แยกเป็นแพ็กเกจ Interface และแพ็กเกจ Platform OS และให้บริการเป็นไฟล์ทั้งหมด 4 ไฟล์ดังนี้

• Hive SDK v4 Unity Interface 25.5.x
• Hive SDK v4 Unity Android 25.5.x
• Hive SDK v4 Unity iOS 25.5.x
• Hive SDK v4 Unity Windows 25.5.x

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

ลำดับการติดตั้งแพ็กเกจแจกจ่าย SDK มีดังนี้

1) ดู กฎการใช้งานแพ็กเกจ แล้วตรวจสอบความเข้ากันได้ระหว่างไฟล์ Hive SDK v4 Unity Interface 25.5.x ที่จะดาวน์โหลด กับไฟล์ SDK ของ Target OS (เช่น Hive SDK v4 Unity Windows 25.5.x)
2) ดาวน์โหลดไฟล์ Hive SDK v4 Unity Interface 25.5.x ที่ต้องการใช้งาน แล้ว Import เข้าโปรเจกต์ ในสภาพแวดล้อมการพัฒนา Unity Engine ต้องใช้งานไฟล์ Hive SDK v4 Unity Interface 25.5.x เสมอ ไม่ว่าจะเป็น Target OS ประเภทใดก็ตาม
3) ดาวน์โหลดไฟล์ SDK ที่เข้ากันได้กับไฟล์ Hive SDK v4 Unity Interface 25.5.x ที่ดาวน์โหลดไว้ แล้ว Import เข้าโปรเจกต์

หากใช้ SDK Manager จะทำขั้นตอน 1) ~ 3) ข้างต้นได้รวดเร็วและสะดวกยิ่งขึ้น โปรดดู อัปเกรด SDK ด้วย SDK Manager เพื่ออัปเดตเป็น SDK เวอร์ชันล่าสุด

การอัปเดตเวอร์ชัน Hotfix¶

ในกรณีที่มีการอัปเดตเฉพาะบางไฟล์ของแพ็กเกจแจกจ่าย SDK เป็นเวอร์ชัน Hotfix เช่น v4.25.5.x หน้า SDK เวอร์ชันล่าสุด จะให้ทั้งไฟล์ SDK เวอร์ชัน Hotfix ที่อัปเดตแล้ว (เช่น Hive SDK v4 Unity iOS 25.5.2) พร้อมกับไฟล์ SDK เดิมที่ยังไม่ได้อัปเดต

ในกรณีนี้ หากอัปเดตแพ็กเกจแจกจ่าย SDK แบบติดตั้งด้วยตนเองแทนการใช้ SDK Manager สามารถอ้างอิงคู่มือ SDK Unity Update ได้

เมื่อใช้ SDK Manager ไฟล์ SDK ที่เป็นเป้าหมายการอัปเดตทั้งหมดจะถูกอัปเดตเป็นเวอร์ชัน Hotfix ล่าสุดโดยอัตโนมัติ

การเปลี่ยนแปลงสำคัญ¶

ตรวจสอบการเปลี่ยนแปลงสำคัญตั้งแต่เวอร์ชันล่าสุดของ Hive SDK Unity ย้อนหลังไปยังเวอร์ชันที่เผยแพร่ก่อนหน้า