การสนับสนุนเกมคอนโทรลเลอร์
ภาพรวม¶
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 |
Warning
ฟังก์ชันการแมพปุ่มคอนโทรลเลอร์ไม่สามารถใช้ได้ใน หน้าจอ Webview.
ข้อควรระวัง¶
เมื่อใช้ 'Game Controller' กับ Hive SDK จะต้องคำนึงถึงสิ่งต่อไปนี้
ขอบเขตการทำงานของตัวควบคุมเกม¶
ตัวควบคุมเกมได้รับการสนับสนุน เฉพาะภายใน UI ที่ดำเนินการโดย Hive SDK เท่านั้น ตัวอย่างเช่น สิ่งนี้รวมถึงหน้าจอเข้าสู่ระบบ ข่าวสาร และแบนเนอร์ส่งเสริมการขาย รวมถึง UI เว็บวิวอื่น ๆ ที่เกมแสดงขึ้นโดยใช้ Hive SDK ไม่ได้รับการสนับสนุนใน UI ที่ไม่ได้ดำเนินการโดย Hive SDK เช่น หน้าต่างเบราว์เซอร์ภายนอก การเคลื่อนไหวของตัวชี้เมาส์โดยใช้ตัวควบคุมเกมภายในเกมต้องดำเนินการโดยนักพัฒนาโดยตรง
การรวม Steam¶
เมื่อ "ใช้ Steam Input" ถูกตั้งค่าในระหว่างการรวม Steam ฟังก์ชันการควบคุมเกมที่จัดเตรียมโดย Hive SDK จะไม่สามารถใช้งานได้ อย่างไรก็ตาม ผ่านเมนูการเปลี่ยนเลย์เอาต์ที่จัดเตรียมโดย Steam สามารถจัดเตรียมสภาพแวดล้อมที่คล้ายกับฟังก์ชันการควบคุมเกมที่เสนอโดย Hive SDK สำหรับรายละเอียดเพิ่มเติม โปรดดูที่ Steam Input page ในเอกสารทางการของ Steamworks.
การประมวลผลข้อมูลควบคุมในวิธีที่มีอยู่¶
หากมีการป้อนข้อมูลจากตัวควบคุมเกม (รวมถึงตัวควบคุมของ Steam Deck เอง) ก่อนที่แอปจะได้รับการตอบสนองหลังจากเรียกใช้วิธี Hive SDK แอปไม่ควรจัดการกับการป้อนข้อมูลจากตัวควบคุมเกมด้วยตนเอง การป้อนข้อมูลจากตัวควบคุมเกมที่เกิดขึ้นภายใน UI ที่ดำเนินการโดย Hive SDK จะถูกจัดการโดย Hive SDK.
คีย์บอร์ดบนหน้าจอ Windows¶
เมื่อใช้ฟีเจอร์การสนับสนุนตัวควบคุมเกมที่จัดเตรียมโดย Hive SDK กับแป้นพิมพ์บนหน้าจอของ Windows จะต้องตั้งค่าดังต่อไปนี้ใน "ตัวเลือก" ของแป้นพิมพ์บนหน้าจอของ Windows เพื่อใช้ฟีเจอร์ตัวควบคุมเกม:
- ตรวจสอบ สแกนและป้อน
- ตรวจสอบ ใช้จอยสติ๊ก, เกมแพด, หรืออุปกรณ์เกมอื่นๆ
ปัญหาที่ทราบ¶
หากคุณเชื่อมต่อและตัดการเชื่อมต่อเกมคอนโทรลเลอร์อย่างรวดเร็วและซ้ำ ๆ คอนโทรลเลอร์อาจทำงานผิดปกติ ตัวอย่างเช่น ในกรณีของ Switch Pro Controller หากคุณตัดการเชื่อมต่อและเชื่อมต่อซ้ำภายในระยะเวลาสั้น ๆ เมาส์อาจเคลื่อนที่ในทิศทางใดทิศทางหนึ่งโดยไม่ต้องมีการดำเนินการจากผู้ใช้ นี่เป็นปัญหาของ Switch Pro Controller และหากเกิดปัญหานี้ คุณสามารถแก้ไขได้โดยการกดปุ่มซิงค์ที่อยู่ด้านซ้ายของช่องเชื่อมต่อแบบมีสาย