VirtualGameController

ตัวควบคุมเกมเสมือนจริง

ภาพรวม

Virtual Game Controller (VGC) ทำให้ง่ายต่อการสร้างตัวควบคุมที่ใช้ซอฟต์แวร์สำหรับเกมและวัตถุประสงค์อื่น ๆ ช่วยให้คุณสามารถควบคุมอุปกรณ์ iOS หนึ่งตัวได้อย่างง่ายดายด้วยอุปกรณ์อื่น (หรืออุปกรณ์อื่น ๆ อีกหลายตัวเช่นในกรณีของเกม TVOS) เฟรมเวิร์กล้อมรอบ GCCONTROLLER FRAMEWORK API ของ Apple ทำให้ง่ายต่อการสนับสนุนทั้งตัวควบคุมซอฟต์แวร์และคอนโทรลเลอร์ที่ใช้ฮาร์ดแวร์ซึ่งสอดคล้องกับมาตรฐาน MFI ด้วยฐานรหัสเดียว GCCONTROLLER API รองรับทั้งการอ่านค่าขององค์ประกอบตัวควบคุมเกมโดยตรง (การสำรวจ) และการลงทะเบียนที่จะเรียกเมื่อค่าเปลี่ยนค่าโดยใช้ตัวจัดการที่ใช้บล็อก VGC ดำเนินการในลักษณะเดียวกันและรองรับคุณสมบัติทั้งหมดของ GCCONTROLLER API สำหรับตัวควบคุมซอฟต์แวร์และฮาร์ดแวร์

ในขณะที่ VGC มักจะใช้อุปกรณ์ iOS ทำหน้าที่เป็นคอนโทรลเลอร์สำหรับอุปกรณ์ iOS หรือ TVOS อื่น แต่ก็สามารถใช้งานได้โดยที่อุปกรณ์ iOS สองตัวทำหน้าที่เป็นเพื่อนร่วมงานด้วยสภาพแวดล้อมเกมที่ใช้ร่วมกันในแต่ละอุปกรณ์ ในประเภทของการใช้งานนั้นอินพุตผู้ใช้ผ่านการควบคุมการไหลบนหน้าจอผ่านเฟรมเวิร์กและประมวลผลโดยตัวจัดการบนอุปกรณ์ทั้งสอง VGC รองรับการสร้างประเภทองค์ประกอบที่กำหนดเองได้อย่างง่ายดายรวมถึงรูปภาพและประเภทข้อมูลเพื่อให้ตรรกะเกมเช่นสถานะสามารถประสานงานระหว่างอุปกรณ์ทั้งสอง ความสามารถนี้เหมาะสำหรับเกมบนโต๊ะที่มีผู้เล่นสองคนรวมถึงเกม Arkit ที่คุณต้องการให้ผู้เล่นทั้งสองดูและลงมือทำในพื้นที่เกมทั่วไป

สำคัญ : เฟรมเวิร์กมาพร้อมกับชุดแอพตัวอย่างมากมายสำหรับ iOS, TVOS และ MacOS รวมถึงตัวอย่างทั้ง SceneKit และ Sprikekit เอกสารจำนวนมากปรากฏขึ้นเป็นความคิดเห็นในโครงการตัวอย่าง iOS และ iOS Central ตัวอย่างและการใช้โครงการทั้งสองบนอุปกรณ์แยกต่างหากเป็นจุดเริ่มต้นที่ดีที่สุด ถัดไปลองลองใช้ ScenekitshipDemo ซึ่งให้ความรู้สึกจริง ๆ ว่าเฟรมเวิร์กสามารถปรับปรุงเกมได้อย่างไร หากคุณมีปัญหาในการรับตัวอย่างโครงการทำงานหรือคำถามอื่น ๆ โปรดติดต่อฉันที่ [email protected]

คุณสมบัติ

• Wraps GameController Framework API ของ Apple (GCCONTROLLER)
• สร้างคอนโทรลเลอร์ที่ใช้ซอฟต์แวร์
• ประสิทธิภาพสูง
• <5ms Latency (รวมถึงการประมวลผล) เมื่อส่งคู่ (64 บิต) ที่ 60/วินาที
• ทั้งการปิดและการเลือกตั้งสนับสนุนสำหรับการประมวลผลอินพุต
• รองรับโหมดเพียร์
• การส่งต่อคอนโทรลเลอร์
• การสื่อสารแบบสองทิศทางง่าย ๆ ในช่องที่ใช้ร่วมกัน
• รองรับการเคลื่อนไหวของอุปกรณ์
• องค์ประกอบที่กำหนดเอง
• การทำแผนที่องค์ประกอบที่กำหนดเอง
• อิง WiFi
• ความสามารถในการปรับปรุงคอนโทรลเลอร์สไลด์ออน/ฟอร์มปรับราคาไม่แพง
• การรองรับคอนโทรลเลอร์ ICADE
• รองรับสแน็ปช็อตที่เข้ากันได้กับ Gccontroller snapshots
• เฟรมเวิร์กอิงไม่มีการพึ่งพา

ความต้องการ

• iOS 9.0+ / macOS 10.9+
• XCODE 9 / SWIFT 4.2 / Objective C

การสนับสนุนแพลตฟอร์ม

• iOS
• tvos
• แม็กอส
• นาฬิกานาฬิกา

บางกรณีการใช้งาน

VirtualGameController เป็นการแทนที่แบบเลื่อนลงสำหรับเฟรม เวิร์กเกม ของ Apple ดังนั้นจึงสามารถรวมเข้ากับเกมที่ใช้คอนโทรลเลอร์ที่มีอยู่ได้อย่างง่ายดาย

VirtualGameController อาจมีประโยชน์ในกรณีต่อไปนี้:

• การพัฒนาและสนับสนุนคอนโทรลเลอร์ที่ใช้ซอฟต์แวร์ ช่วยให้ผู้ใช้ของคุณใช้ iPhone, iPad หรือ Apple Watch เพื่อควบคุมเกมของคุณใช้ประโยชน์จากอินพุต 3D Touch และ Motion มีประโยชน์อย่างยิ่งกับ Apple TV อินพุตจะไหลผ่าน GCCONTROLLER API (นั่นคือผ่านโปรไฟล์ MFI) และดังนั้นคอนโทรลเลอร์ที่ใช้ซอฟต์แวร์ของคุณจะปรากฏเป็นคอนโทรลเลอร์ที่ใช้ฮาร์ดแวร์ ส่งข้อมูลจากเกมของคุณไปยังตัวควบคุมซอฟต์แวร์ของคุณได้อย่างง่ายดาย (การสื่อสารแบบสองทิศทาง) API สำหรับการสร้างคอนโทรลเลอร์ที่ใช้ซอฟต์แวร์นั้นง่ายและใช้งานง่าย
• ให้ประสบการณ์การเล่นเกมที่ใช้ร่วมกัน (ARKIT) VGC ทำให้ง่ายต่อการใช้สภาพแวดล้อมคอนโทรลเลอร์ที่ใช้ร่วมกันเพื่อให้ผู้ใช้คู่หนึ่งเล่นเกมเดียวกันบนอุปกรณ์ที่เกี่ยวข้องจะได้รับข้อมูลอินพุตคอนโทรลเลอร์จากอุปกรณ์ทั้งสอง (ผู้ใช้) สามารถใช้งานตัวจัดการที่ใช้บล็อกชุดเดียวเพื่อจัดการอินพุตจากทั้งตัวควบคุมบนหน้าจอและข้อมูลคอนโทรลเลอร์ที่ได้รับจากอุปกรณ์ตรงข้าม VGC ยังทำให้ง่ายต่อการจัดการสถานะผ่านอุปกรณ์โดยใช้องค์ประกอบที่กำหนดเอง
• การสร้างตัวควบคุมฮาร์ดแวร์/ซอฟต์แวร์ไฮบริดโดยใช้การส่งต่อคอนโทรลเลอร์
• สนับสนุนคอนโทรลเลอร์จำนวนมากสำหรับเกมโซเชียล ไม่มีข้อ จำกัด ที่กำหนดไว้ในจำนวนฮาร์ดแวร์หรือตัวควบคุมซอฟต์แวร์ที่สามารถใช้กับเกมได้ ขีด จำกัด คอนโทรลเลอร์ของบุคคลที่สามสองตัวบน Apple TV สามารถเกินกว่าการส่งการส่งต่อคอนโทรลเลอร์ (การเชื่อมโยง) คอนโทรลเลอร์ไฮบริดและคอนโทรลเลอร์ที่ใช้ซอฟต์แวร์
• การสร้างเกมที่ขับเคลื่อนด้วยข้อความ การรองรับอินพุตแบบกำหนดเองที่ใช้สตริงทำให้ง่ายต่อการสร้างเกมที่มุ่งเน้นข้อความ การใช้คำบอกทางเสียงแสดงให้เห็นในโครงการตัวอย่าง

คำศัพท์

• อุปกรณ์ต่อพ่วง : ตัวควบคุมเกมที่ใช้ซอฟต์แวร์
• ส่วนกลาง : โดยทั่วไปแล้วเกมที่รองรับฮาร์ดแวร์และตัวควบคุมซอฟต์แวร์ ศูนย์กลางใช้ VirtualGameController แทนการเปลี่ยนกรอบการทำงานของ Apple Game Controller
• บริดจ์ : ทำหน้าที่เป็นรีเลย์ระหว่างอุปกรณ์ต่อพ่วงและศูนย์กลางและแสดงถึงลูกผสมของทั้งสอง กรณีการใช้งานคีย์คือ "การส่งต่อคอนโทรลเลอร์"

การรวมกรอบ

โครงการเฟรมเวิร์กเฉพาะแพลตฟอร์มรวมอยู่ในพื้นที่ทำงาน ไฟล์เฟรมเวิร์กเดียวรองรับทั้งอุปกรณ์ต่อพ่วง (ตัวควบคุมที่ใช้ซอฟต์แวร์) และศูนย์กลาง (นั่นคือเกมของคุณ)

import VirtualGameController

โปรดทราบว่าขณะนี้คุณต้อง import GameController เช่นกัน

ดูคำแนะนำเกี่ยวกับวิกิสำหรับการใช้วัตถุประสงค์ C. ``

โกโก้

มีการสนับสนุนเบื้องต้นสำหรับ cocoapods

ชาวคาร์เธจ

เพื่อรวมการใช้ Carthage ให้เพิ่ม VGC ลงใน CartFile ของคุณ:

 github "robreuss/VirtualGameController"

จากนั้นใช้คำสั่งเฉพาะแพลตฟอร์มเพื่อสร้างผลิตภัณฑ์บิลด์ที่คุณต้องการเพิ่มลงในโครงการของคุณ:

 carthage update --platform iOS
carthage update --platform OSX
carthage update --platform tvOS
carthage update --platform watchOS

แอพอ้างอิง

โครงการนี้มีแอพคู่ที่ใช้คุณสมบัติและการตั้งค่าเฟรมเวิร์กที่มีอยู่ส่วนใหญ่รวมถึงการให้สภาพแวดล้อมการทดสอบที่เป็นประโยชน์โดยทั่วไป

หมายเหตุ: คุณไม่สามารถเรียกใช้แอพมากกว่าหนึ่งแอพโดยใช้เครื่องจำลองในครั้งเดียวเนื่องจากการแชร์ที่อยู่ IP เรียกใช้ศูนย์กลางหรืออุปกรณ์ต่อพ่วงในเครื่องจำลองและใช้อุปกรณ์ฮาร์ดแวร์เพื่อโต้ตอบ

อุปกรณ์ต่อพ่วง _ios

โครงการตัวอย่าง Peripheral_iOS ให้การใช้งานอ้างอิงของตัวควบคุมเกมที่ใช้ซอฟต์แวร์ เมื่อคุณใช้ VGC ในเกม (กลาง) แล้วคุณสามารถใช้แอพ peripheral_ios เพื่อทดสอบ:

central_ios

โครงการตัวอย่าง Central_iOS ให้การอ้างอิงการอ้างอิงของศูนย์กลาง (เกมของคุณซึ่งอุปกรณ์ต่อพ่วงเชื่อมต่อ) มันเป็นวิธีที่ตรงไปตรงมาในการทดสอบการใช้งานอุปกรณ์ต่อพ่วงของคุณ:

เอกสารหลัก

• การรวม VGC เข้ากับเกมของคุณ (กลาง)
• การสร้างคอนโทรลเลอร์ที่ใช้ซอฟต์แวร์ (อุปกรณ์ต่อพ่วง)
• การใช้ความสามารถของเพื่อน/ผู้เล่นหลายคน

เอกสารเพิ่มเติม

• การส่งข้อความจากศูนย์กลางไปยังคอนโทรลเลอร์
• ตั้งค่าอุปกรณ์ต่อพ่วงจากศูนย์กลางที่รันไทม์
• องค์ประกอบที่กำหนดเอง
• การแมปแบบกำหนดเอง
• การใช้วัตถุประสงค์ C
• การรวม Apple Watch
• รองรับคอนโทรลเลอร์ ICADE

ตัวอย่างโครงการ

• สำรวจโครงการตัวอย่าง
• การทดสอบโดยใช้ demobots
• การทดสอบโดยใช้ SceneKit Vehicle
• เฟรมเวิร์กการตั้งค่าในโครงการตัวอย่าง

ติดต่อและสนับสนุน

อย่าลังเลที่จะติดต่อฉันด้วยคำถามใด ๆ ไม่ว่าจะโดยใช้ linkedIn หรือ [email protected]

ทำงานกับตัวควบคุมที่ใช้ฮาร์ดแวร์ MFI

VirtualGameController เป็น wrapper รอบ ๆ เฟรมเวิร์กเกมควบคุมเกมของ Apple และการทำงานกับตัวควบคุมฮาร์ดแวร์ด้วย VGC นั้นเหมือนกับการทำงานกับเฟรมเวิร์กเกมคอนโทรลเลอร์ของ Apple ดูส่วนการรวมเกมด้านล่างและตัวอย่างโครงการสำหรับรายละเอียดเพิ่มเติม

ใบอนุญาต

ใบอนุญาต MIT (MIT)

ลิขสิทธิ์ (c) [2018] [Rob Reuss]

ได้รับอนุญาตโดยไม่เสียค่าใช้จ่ายสำหรับบุคคลใด ๆ ที่ได้รับสำเนาซอฟต์แวร์นี้และไฟล์เอกสารที่เกี่ยวข้อง ("ซอฟต์แวร์") เพื่อจัดการในซอฟต์แวร์โดยไม่มีการ จำกัด รวมถึง แต่ไม่ จำกัด เฉพาะสิทธิ์ในการใช้คัดลอกแก้ไขผสาน เผยแพร่แจกจ่าย sublicense และ/หรือขายสำเนาของซอฟต์แวร์และอนุญาตให้บุคคลที่ซอฟต์แวร์ได้รับการตกแต่งให้ทำเช่นนั้นภายใต้เงื่อนไขดังต่อไปนี้:

ประกาศลิขสิทธิ์ข้างต้นและประกาศการอนุญาตนี้จะรวมอยู่ในสำเนาทั้งหมดหรือส่วนสำคัญของซอฟต์แวร์

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

โลโก้จากที่นี่