เคอร์เซอร์ที่กำหนดเอง

โครงร่าง¶

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

Note

ฟีเจอร์เคอร์เซอร์แบบกำหนดเอง ใช้งานได้ตั้งแต่ Hive SDK v4 Unity Windows 25.0.0

รูปแบบไฟล์ที่รองรับ{ #supported-file-types }¶

รูปแบบไฟล์ที่รองรับเคอร์เซอร์แบบกำหนดเองมีดังต่อไปนี้

ไฟล์ CUR
ไฟล์ ICO
ไฟล์ PNG

ลำดับความสำคัญของการดำเนินการ¶

ลำดับความสำคัญในการโหลดไฟล์เคอร์เซอร์ใน SDK มีดังนี้:

หากมีไฟล์ CUR, ICO และ PNG ทั้งหมด: แต่ละไฟล์จะถูกอ่านตามลำดับรูปแบบไฟล์ CUR → ICO → PNG และแสดงเป็นเคอร์เซอร์
หากชื่อไฟล์ (เช่น customcursor) เหมือนกัน: ในบรรดาไฟล์ customcursor.cur, customcursor.ico และ customcursor.png จะมีเพียงไฟล์ที่อ่านก่อนตามลำดับความสำคัญเท่านั้นที่จะแสดงเป็นเคอร์เซอร์

การตั้งค่าผู้ใช้¶

หากต้องการใช้เคอร์เซอร์แบบกำหนดเอง คุณต้องตั้งค่าโฟลเดอร์ทรัพยากรเป็นส่วนใหญ่และระบุฮอตสปา

การตั้งค่าโฟลเดอร์ทรัพยากร{ #resources-folder }¶

วางไฟล์ในรูปแบบcustomcursor.extensionใต้โฟลเดอร์ Resources

ระบุฮอตสปอต{ #hotspot }¶

วิธีการกำหนดสปาร้อนตามประเภทไฟล์เคอร์เซอร์มีดังนี้

ไฟล์ CUR: มีข้อมูลฮอตสปอต ดังนั้นเคอร์เซอร์จึงแสดงอย่างถูกต้องตามข้อมูลนี้
ไฟล์ ICO และ PNG: ไม่มีข้อมูลฮอตสปอต ดังนั้นจึงใช้พิกัด(0,0)เป็นฮอตสปอตโดยค่าเริ่มต้น

สังเกต{ #notes }¶

เมื่อใช้ฟีเจอร์ เคอร์เซอร์แบบกำหนดเอง กับ Hive SDK โปรดคำนึงถึงสิ่งต่อไปนี้

ความละเอียดสูงสุดที่รองรับคือ 256x256 พิกเซล หากความละเอียดของไฟล์ CUR, ICO หรือ PNG แต่ละไฟล์เกินขนาดไฟล์ 256x256 เคอร์เซอร์ที่เกี่ยวข้องอาจแสดงไม่ถูกต้อง
ไฟล์ ICO และไฟล์ CUR รองรับขนาดภาพหลายขนาด แต่ SDK จะแสดงเคอร์เซอร์ในขนาดที่กำหนดไว้ล่วงหน้าเริ่มต้นเท่านั้น
ในไฟล์ PNG พื้นที่โปร่งใสจะถือเป็นพื้นที่รูปภาพด้วย ดังนั้น เพื่อหลีกเลี่ยงปัญหาที่เกิดขึ้นเมื่อระบุด้านบนซ้ายเป็นฮอตสปอต (0,0) เราขอแนะนำว่าอย่าใช้พื้นที่โปร่งใสที่ด้านซ้ายบน

การปรับแต่งเคอร์เซอร์สำหรับคอนโทรลเลอร์เกม Android รองรับ{ #android-cursor-custom }¶

Hive SDK v4 หาก Android รองรับตัวควบคุมเกม คุณสามารถแสดงเคอร์เซอร์แบบกำหนดเองแทนเคอร์เซอร์ที่ Hive SDK แสดงตัวเองได้

Hive SDK v4 เมื่อใช้ตัวควบคุมเกมในสภาพแวดล้อม Android คุณสามารถใช้รูปภาพเคอร์เซอร์แบบกำหนดเองที่กำหนดไว้ในแอปได้โดยตรง แทนเคอร์เซอร์เริ่มต้นของ SDK นี่คือวิธีการใช้งาน:

วางไฟล์รูปภาพเคอร์เซอร์ (.png) ใต้ไดเร็กทอรี res/drawable ของโปรเจ็กต์
จุดซ้ายบนของภาพเคอร์เซอร์จะกลายเป็นจุดอ้างอิงการรู้จำคลิกจริง
ไม่ว่าภาพเคอร์เซอร์จะมีความละเอียดดั้งเดิมเท่าใด ระบบจะปรับขนาดของตัวเองให้เป็นขนาดที่เหมาะสมภายใน Hive SDK
เงื่อนไขที่ใช้งานได้: ภาพเคอร์เซอร์จะแสดงเฉพาะเมื่อเชื่อมต่อคอนโทรลเลอร์เกมและ Hive SDK UI ปรากฏบนหน้าจอ

Note

คุณลักษณะเคอร์เซอร์ที่กำหนดเองได้รับการสนับสนุนตั้งแต่ Hive SDK v4 Android 26.7.0 และสูงกว่า