การสนับสนุนเกมคอนโทรลเลอร์

ภาพรวม¶

จาก Hive SDK v4 Unity Windows 24.1.0 ผู้ใช้สามารถเคลื่อนเมาส์และคลิกปุ่มโดยใช้เกมคอนโทรลเลอร์ภายใน UI ที่ดำเนินการโดย Hive SDK ตัวอย่างเช่น ในพื้นที่เว็บวิวที่เปิดเผยโดย Hive SDK ผู้ใช้สามารถเคลื่อนเมาส์ด้วยเกมคอนโทรลเลอร์เพื่อคลิกปุ่มภายในพื้นที่เว็บวิว

ช่วงที่รองรับ¶

ตัวควบคุมเกมที่รองรับโดย Hive SDK มีดังต่อไปนี้:

• คอนโทรลเลอร์ Microsoft Xbox
• คอนโทรลเลอร์ Sony PlayStation DualSense, DualShock
• คอนโทรลเลอร์ Nintendo Switch Pro

จำนวนสูงสุดของจอยสติ๊กเกมที่รองรับโดย Hive SDK คือ หนึ่ง.

วิธีการดำเนินการหลัก¶

• การเคลื่อนที่ของเคอร์เซอร์เมาส์: จอยสติ๊กอนาล็อก (ซ้าย)
• การเลื่อนล้อแนวตั้ง/แนวนอนของเมาส์: จอยสติ๊กอนาล็อก (ขวา)
• คลิกปุ่มเมาส์ซ้าย: ปุ่ม A (สำหรับ DualSense, ปุ่ม DualPro X)
• คลิกปุ่มเมาส์ขวา: ไม่รองรับ

ข้อควรระวัง¶

เมื่อพัฒนาโดยใช้ 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 เพื่อใช้ฟีเจอร์ตัวควบคุมเกม:

1. ตรวจสอบ "สแกนผ่านคีย์"
2. ตรวจสอบเฉพาะ "ใช้จอยสติ๊ก, เกมแพด หรืออุปกรณ์เกมอื่น ๆ"

ปัญหาที่ทราบ¶

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