การสนับสนุนเกมคอนโทรลเลอร์
ภาพรวม¶
UI ที่จัดเตรียมโดย Hive SDK ช่วยให้คุณสามารถเคลื่อนที่เคอร์เซอร์เมาส์และคลิกปุ่มด้วย 'เกมคอนโทรลเลอร์' แทนที่จะใช้เมาส์ทั่วไป ตัวอย่างเช่น ในพื้นที่เว็บวิวที่เปิดเผยโดย Hive SDK ผู้ใช้สามารถเคลื่อนที่เคอร์เซอร์เมาส์ด้วยเกมคอนโทรลเลอร์และคลิกปุ่มภายในพื้นที่เว็บวิว
Note
'Game controller' support in Hive SDK is provided starting from Hive SDK v4 Unity Windows 24.1.0.
คอนโทรลเลอร์เกมที่รองรับ¶
ประเภทของตัวควบคุมเกมที่รองรับโดย Hive SDK มีดังต่อไปนี้ และจำนวนสูงสุดของตัวควบคุมที่สามารถใช้ต่อ SDK คือ 1.
- คอนโทรลเลอร์ Microsoft Xbox
- คอนโทรลเลอร์ Sony PlayStation DualSense, DualShock
- คอนโทรลเลอร์ Nintendo Switch Pro
การแมพปุ่มควบคุม¶
เริ่มต้นด้วย Hive SDK v4 Unity Windows 25.0.0, บาง Hive UI รองรับ การแมพปุ่มคอนโทรลเลอร์ เมื่อใช้คอนโทรลเลอร์เกม
Warning
โปรดทราบว่าใน UI ที่รองรับการแมพปุ่มของคอนโทรลเลอร์ วิธีการทำงานของปุ่ม key operation method จะแตกต่างจากวิธีการทำงานของปุ่มใน UI ที่มีอยู่เดิม
วิธีการดำเนินการหลัก¶
| อุปกรณ์นำเข้า | วิธีการทำงานของปุ่ม UI ที่มีอยู่ | วิธีการทำงานของปุ่ม UI ที่รองรับการแมพปุ่มคอนโทรลเลอร์ | 
| จอยสติ๊กอนาล็อกซ้าย | เคลื่อนที่เคอร์เซอร์เมาส์ | เคลื่อนที่โฟกัส | 
| จอยสติ๊กอนาล็อกขวา | เลื่อนล้อแนวตั้งและแนวนอนของเมาส์ | เลื่อนล้อแนวตั้งและแนวนอนของเมาส์ | 
| ปุ่ม A | คลิกปุ่มเมาส์ซ้าย | ยืนยัน (ปุ่ม X สำหรับ DualSense, DualShock) | 
| ปุ่ม B | ไม่รองรับ | ยกเลิก (ปุ่ม O สำหรับ DualSense, DualShock) | 
| ปุ่ม D-pad | ไม่รองรับ | เคลื่อนที่โฟกัส | 
รายชื่อ UI ที่รองรับการแมพปุ่มคอนโทรลเลอร์¶
นี่คือรายการของ Hive UI ที่รองรับฟังก์ชันการแมพปุ่มควบคุม:
| การสนับสนุน UI | |
| 1 | การอัปเดตแอป | 
| 2 | การจำกัดการเข้าถึง | 
| 3 | การบำรุงรักษาเซิร์ฟเวอร์ | 
| 4 | รอการเข้าสู่ระบบ | 
| 5 | รายการ IdP | 
| 6 | โปรโมชั่น | 
| 7 | การตรวจสอบบัญชีการชำระเงินของ Google | 
| 8 | การยืนยันการชำระเงิน | 
| 9 | ข้อผิดพลาดในการชำระเงิน | 
| 10 | การเข้าสู่ระบบ Steam Deck | 
| 11 | เข้าสู่ระบบ | 
| 12 | ค้นหารหัสผ่าน | 
| 13 | กรอกรหัสยืนยัน | 
| 14 | ค้นหาอีเมล | 
| 15 | ประกาศบัญชีที่ไม่เคลื่อนไหว | 
ข้อควรระวัง¶
เมื่อใช้ 'Game Controller' กับ Hive SDK จะต้องคำนึงถึงสิ่งต่อไปนี้
ขอบเขตการทำงานของตัวควบคุมเกม¶
ตัวควบคุมเกมได้รับการสนับสนุน เฉพาะภายใน UI ที่ดำเนินการโดย Hive SDK เท่านั้น ตัวอย่างเช่น รวมถึงหน้าจอเข้าสู่ระบบ ข่าวสาร และแบนเนอร์โปรโมชั่น รวมถึง UI เว็บวิวอื่น ๆ ที่เกมเรียกขึ้นโดยใช้ Hive SDK ไม่ได้รับการสนับสนุนใน UI ที่ไม่ได้ดำเนินการโดย Hive SDK เช่น หน้าต่างเบราว์เซอร์ภายนอก การเคลื่อนไหวของเคอร์เซอร์เมาส์โดยใช้ตัวควบคุมเกมภายในเกมจะต้องดำเนินการโดยนักพัฒนาโดยตรง
การรวม Steam¶
เมื่อ "ใช้ Steam Input" ถูกตั้งค่าในระหว่างการรวม Steam ฟังก์ชันการควบคุมเกมที่จัดเตรียมโดย Hive SDK จะไม่สามารถใช้งานได้ อย่างไรก็ตาม ผ่านเมนูการเปลี่ยนแปลงเลย์เอาต์ที่จัดเตรียมโดย Steam สามารถจัดเตรียมสภาพแวดล้อมที่คล้ายกับฟังก์ชันการควบคุมเกมที่เสนอโดย Hive SDK สำหรับรายละเอียดเพิ่มเติม โปรดดูที่ หน้า Steam Input ในเอกสารทางการของ Steamworks.
การประมวลผลข้อมูลควบคุมในวิธีที่มีอยู่¶
หากมีการป้อนข้อมูลจากตัวควบคุมเกม (รวมถึงตัวควบคุมของ Steam Deck เอง) ก่อนที่แอปจะได้รับการตอบสนองหลังจากเรียกใช้วิธี Hive SDK แอปไม่ควรจัดการกับการป้อนข้อมูลจากตัวควบคุมเกมด้วยตนเอง การป้อนข้อมูลจากตัวควบคุมเกมที่เกิดขึ้นภายใน UI ที่ดำเนินการโดย Hive SDK จะถูกจัดการโดย Hive SDK
คีย์บอร์ดบนหน้าจอ Windows¶
เมื่อใช้ฟีเจอร์การสนับสนุนตัวควบคุมเกมที่จัดเตรียมโดย Hive SDK กับแป้นพิมพ์บนหน้าจอของ Windows จะต้องตั้งค่าดังต่อไปนี้ใน "ตัวเลือก" ของแป้นพิมพ์บนหน้าจอของ Windows เพื่อใช้ฟีเจอร์ตัวควบคุมเกม:
- ตรวจสอบ สแกนและป้อน
- ตรวจสอบ ใช้จอยสติ๊ก, เกมแพด, หรืออุปกรณ์เกมอื่น ๆ
ปัญหาที่ทราบ¶
หากคุณเชื่อมต่อและตัดการเชื่อมต่อจอยเกมอย่างรวดเร็วและบ่อยครั้ง จอยเกมอาจทำงานผิดปกติ ตัวอย่างเช่น ในกรณีของ Switch Pro Controller หากคุณตัดการเชื่อมต่อและเชื่อมต่อซ้ำภายในระยะเวลาสั้นๆ เมาส์อาจเคลื่อนที่ไปในทิศทางหนึ่งโดยไม่ต้องมีการดำเนินการจากผู้ใช้ นี่เป็นปัญหาของ Switch Pro Controller และหากเกิดปัญหาขึ้น คุณสามารถแก้ไขได้โดยการกดปุ่มซิงค์ที่อยู่ด้านซ้ายของขั้วต่อการเชื่อมต่อแบบมีสาย